search_transactions Production Read only
Production (https://mcp.tuyo.com/mcp) serves an earlier version of this tool. This page shows the early-access version.

Description

The model reads this text to decide when and how to call the tool.
Find individual activity records, not period totals or reconciled statements. Omit accountId for the main account; use a pod accountId returned by list_pods or holdings.pods.items[].pod. A username is not an accountId. Date-only boundaries include the whole end date in UTC; datetime ends are exclusive. Default sort date_desc. first defaults to 25, maximum 100. Continue with page.endCursor as after, keeping account scope, filters, includes, time and sort unchanged.

Input

string
Omit accountId for the main account; use a pod accountId returned by list_pods or holdings.pods.items[].pod. A username is not an accountId.
string
string
Inclusive start. A calendar date starts at midnight in UTC.
string
Exclusive datetime end; a calendar date includes the entire end day in UTC.
enum[]
enum[]
string[]
Concrete token ID from a returned token.id, identifying a token on a numeric chain; nullable IDs stay unresolved.
string[]
Exact vault.id values returned by search_vaults or an investment holding.vault.id; filters positions/activity linked to those vaults.
string[]
Exact cardTransaction.merchant.id values returned by transaction search/detail; not merchant names or raw MCCs.
string[]
Stable category codes returned by list_transaction_categories or cardTransaction.category.code.
string[]
Stable group codes returned by list_transaction_categories or cardTransaction.category.groupCode.
string[]
Four-digit merchant category codes from cardTransaction.rawMerchant.mcc; distinct from reviewed budgeting category codes.
string[]
Exact cardTransaction.card.id values returned by transaction search/detail; not last4 or purchase IDs.
enum
Native amount selector. Required when currency, tokenId, minAmount, maxAmount or amount sorting is supplied. Money fields require currency and forbid tokenId; action.amount, action.amountOut and deposit.amount require tokenId and forbid currency. No historical USD conversion. One of: cardTransaction.amount, cardTransaction.coverage.customerShare, action.amount, action.amountOut, action.fiatCurrencyAmountOut, deposit.amount, virtualBankAccountTransaction.sentAmount.
string
Three-letter uppercase currency for money amountField filters. Required for money fields, forbidden for token fields.
string
Amount unit selector: Concrete token ID from a returned token.id, identifying a token on a numeric chain; nullable IDs stay unresolved. Required for token amount fields; forbidden with currency.
string
Inclusive decimal lower bound; requires amountField and its currency or tokenId. Must not exceed maxAmount.
string
Inclusive decimal upper bound; requires amountField and its currency or tokenId. Must be at least minAmount.
enum[]
Optional operations/legs enrichment. [] requests neither optional enrichment; card settlements are already included by default.
enum
Default date_desc; amount sorting requires amountField and its explicit currency or tokenId. Keep sort unchanged during pagination. One of: date_desc, date_asc, amount_desc, amount_asc.
integer
Page size, default 25; maximum 100.
string
Continue with page.endCursor as after, keeping account scope, filters, includes, time and sort unchanged.
string[]
Cross-network asset ID from search_assets items[].id, holding.asset.id or token.assetId; never infer from a symbol.
enum[]
Supported network slugs from returned supportedNetworks[].id or network.id. Mutually exclusive with chainIds where both are offered.
integer[]
Numeric chain references from returned token.chainId or operations[].chainId, including external/historical chains. Mutually exclusive with networkIds.
string
Optional short explanation of the user goal. Do not include secrets or full addresses.

Output

The structured result is { data, meta }. meta has the requestId and the asOf time. These are the fields of data. An error returns { error, meta }; see Errors.
object[]
required
object
required
object
required
object
required
string[]
required
object[]
required