Transfers
A transfer is an effect of executing a transaction: a TIP-20 token moved from one account to another, optionally with a payment memo. Multiple transfers can come from one transaction, and some transactions produce none; each transfer links back to its transaction via transactionHash.
Query Parameters
stringOnly include transfers where this account is the sender or recipient. Use this shortcut by itself, not with sender or recipient.
stringMatch transfers sent to this recipient address (to).
stringMatch transfers sent from this sender address (from).
stringMatch transfers for this TIP-20 token contract address.
integer·min 0·max 9007199254740991Only include transfers at or after this block number.
integer·min 0·max 9007199254740991Only include transfers at or before this block number.
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.
stringmainnettestnetnumberstringOpaque keyset cursor from a previous response (nextCursor); pass it back verbatim to fetch the next page. Omit for the first (head) page.
string[]Comma-separated related resources to include, such as token,memo,crossToken,totalCount.
crossTokenmemotokentotalCountinteger·min 5·max 200·default 10How many items to return per page (5–200, default 10).
string·default descSort order: desc for descending (the default), or asc for ascending.
ascdescinteger·min 1·max 9007199254740991Page number, 1-indexed (positional pagination for page-numbered access; page=1 is the head page). Mutually exclusive with cursor, and page × limit must be at most 10000 rows — use cursor pagination for deeper traversal. Pages are positional, so rows arriving at the head of a live feed can shift page contents.
string <date-time>Only include transfers at or after this ISO 8601 timestamp.
Responses
integerHow many requests you may make in the current time window. Not sent on cached responses or 402 payment challenges.
integerHow many requests you have left in the current window before you are rate-limited. Not sent on cached responses or 402 payment challenges.
integerWhen the current window resets, as a Unix timestamp in seconds. Not sent on cached responses or 402 payment challenges.
stringWhich quota this request counted against (e.g. data:read). Not sent on cached responses or 402 payment challenges.
stringA unique id for this request, returned on every response (and as requestId in error bodies). Include it when contacting support so we can find your request.
object[]The transfers in this page.
stringThe resolved MPP service name, when the transfer memo matches a known service fingerprint. Returned when you request include=memo.
integer·min 0·max 9007199254740991The block number where this transfer was recorded.
objectThe token and amount delivered to the recipient when it differs from sourceToken — a cross-token transfer routed through the DEX, where sourceToken is the token swapped in. Omitted for same-token transfers, and only returned when you request include=crossToken.
stringThe TIP-20 token contract address on Tempo.
stringA non-negative whole number, given as a decimal string so very large token amounts keep full precision. Expressed in the smallest unit of the token.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
stringA URL for the token’s logo image, when one is available.
stringThe short ticker symbol wallets and apps show for this token.
stringA stable resource ID for this transfer, built from ${transactionHash}-${logIndex}.
integer·min 0·max 9007199254740991The transfer event’s log index within the block.
stringThe decoded text memo from the matching TransferWithMemo event, when one is present. Returned when you request include=memo.
stringThe account address that received the tokens.
stringThe account address that sent the tokens.
objectThe token and amount that moved.
stringThe TIP-20 token contract address on Tempo.
stringA non-negative whole number, given as a decimal string so very large token amounts keep full precision. Expressed in the smallest unit of the token.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
stringA URL for the token’s logo image, when one is available.
stringThe short ticker symbol wallets and apps show for this token.
string <date-time>The block timestamp when this transfer was recorded.
objectPage-level resources you requested with include.
booleanWhether totalCount hit the count cap. When true, totalCount is a lower bound rather than an exact total.
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
query_invalidparam_invalidbody_invalidaddress_invalidtoken_invalidobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
api_key_missingapi_key_invalidunauthorizedobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
stringOn a 402 response, the payment challenge to satisfy. Use it to build the Authorization: Payment credential and retry the request.
integerHow many requests you may make in the current time window. Not sent on cached responses or 402 payment challenges.
integerHow many requests you have left in the current window before you are rate-limited. Not sent on cached responses or 402 payment challenges.
integerWhen the current window resets, as a Unix timestamp in seconds. Not sent on cached responses or 402 payment challenges.
stringWhich quota this request counted against (e.g. data:read). Not sent on cached responses or 402 payment challenges.
stringA unique id for this request, returned on every response (and as requestId in error bodies). Include it when contacting support so we can find your request.
integerHow many seconds to wait before trying again. Sent with 429 (rate-limited) responses.
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
rate_limit_exceededpayment_requiredobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
internal_errorobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
upstream_errorobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
Was this helpful?