Aggregate transaction totals grouped by (method, type, status).
Single GROUP BY query against the same UNION used by search, but skips
the outer entity / ledger / solana enrichment — aggregation only needs
(method, type, status, amount). Use this instead of paging through
search when you only need bucketed sums (e.g. the home-page money-
movement widget).
OptionalcreatedAt?: DbTimestampCriteriaOptionalmethods?: (Optionalstatuses?: ("FAILED" | "PROCESSING" | "COMPLETED" | "RETURNED")[]Optionalsubtypes?: ("RETURN" | "FEE" | undefined)[] | nullPass values to include only those subtypes; pass null to exclude transactions with a subtype
Optionaltoken?: TokenBust both transaction caches for a customer. Public seam for in-process
readers/writers (e.g. the dashboard's transfer server action) and the
cross-service TransactionCacheBuster. Tags are the external string
customerId — the same value search / aggregateTotalsByMethod write.
Optionalamount?: { operator: "EQ" | "LTE" | "GTE"; value: BigNumber }OptionalbankIds?: (string | undefined)[]OptionalbankTransactionIds?: (string | undefined)[]OptionalcardIds?: string[]OptionalcreatedAt?: DbTimestampCriteriaOptionalentityIds?: string[]OptionalentityTypes?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>[]Optionalids?: string[]Optionalmethods?: (OptionalorderBy?: { direction: "ASC" | "DESC"; field: "createdAt" | "updatedAt" }[]Defaults to createdAt DESC
Optionalpage?: numberDefaults to 1
OptionalpageSize?: numberDefaults to 10
OptionalpaymentInstrumentIds?: (string | undefined)[]Optionalsignatures?: string[]Optionalstatuses?: ("FAILED" | "PROCESSING" | "COMPLETED" | "RETURNED")[]Optionalsubtypes?: ("RETURN" | "FEE" | undefined)[] | nullPass values to include only those subtypes; pass null to exclude transactions with a subtype
Optionaltoken?: TokenToken name to resolve to a mint address. Defaults to MOVEUSD
Optionaltypes?: ("CREDIT" | "DEBIT")[]OptionalupdatedAt?: DbTimestampCriteriaOptionalwalletAddresses?: (Address | null)[]Entity external ids the customer has transacted with, ordered by recency
(most recently transacted first). Mirrors the uncached
TransactionAdminService.searchEntities (same enriched CTE via
outerEnrichmentSelectSql to resolve entity_external_id /
entity_type) but scopes to a single customerId, optionally filters by
entityType, and ranks distinct entities by MAX(created_at) instead of
returning an unordered DISTINCT set.
No caching (mirrors the admin method).
Payment-instrument external ids the customer has transacted with, ranked by
usage (most-used first). Mirrors the uncached
TransactionAdminService.searchPaymentInstrumentIds but scopes to a
single customerId and ranks by COUNT(*) instead of returning a flat
DISTINCT set. Skips the outer entity / ledger / solana enrichment —
ranking only needs (payment_instrument_external_id, method, created_at).
No caching (mirrors the admin method).
Read-only query services to fetch normalized transactions across all products
If you need more info about a transaction, fetch it using its specific service. Transaction Service will remain generic and high-level.