Tokens
TIP-20 token details, supply, and holders.
List tokens
/v1/tokensLists TIP-20 tokens on Tempo. TIP-20 is Tempo’s payments-focused token standard and a superset of ERC-20.
Query Parameters
string[]·max 50Comma-separated token contract addresses to fetch (max 50). Returns a single page in input order (unresolvable addresses omitted); cursor, page, and order are inapplicable. Combines with include; currency and verified further filter the resolved set.
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.
stringmainnettestnetnumberstringOnly include tokens denominated in this currency (e.g. USD). Case-insensitive. Matched against the currency field of the onchain TokenCreated event, so any string a token deployer wrote is acceptable; the listed examples are the well-known curated currencies.
stringOpaque 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 extra token details to include, such as admin,createdAt,holderCount,quoteToken,transferStats.
admincreatedAtholderCountquoteTokentransferStatsinteger·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.
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 tokens in this page.
stringThe TIP-20 token contract address on Tempo.
stringToken admin from the onchain TokenCreated event, present when requested via include=admin and indexed data is available.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
string <date-time>Token creation timestamp, present when requested via include=createdAt and indexed data is available.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
integer·min 0·max 9007199254740991The number of accounts that currently hold a positive balance of this token, when indexed holder data is available.
stringA stable resource ID for this token, equal to its contract address.
stringA URL for the token’s logo image, when one is available.
stringQuote token from the onchain TokenCreated event, present when requested via include=quoteToken and indexed data is available.
stringThe token’s total supply as a decimal string in the smallest unit, so large values keep full precision.
objectLifetime Transfer event statistics, present when requested via include=transferStats and indexed data is available.
integer·min 0·max 9007199254740991The total number of Transfer events emitted by this token.
string <date-time>The time of this token’s first Transfer event, or null if no transfers exist.
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).
List token holders
/v1/tokens/{token}/holdersLists the accounts that hold a TIP-20 token, ordered from largest to smallest balance.
Path Parameters
Query Parameters
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,totalCount.
tokentotalCountinteger·min 5·max 200·default 10How many items to return per page (5–200, default 10).
integer·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.
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 holders in this page, ordered by balance from highest to lowest.
stringThe account address that holds this token.
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.
objectExtra resources you requested with include.
booleanWhether totalCount reached the API count cap; holder counts are exact here.
objectA compact token reference, returned when you request include=token.
stringThe TIP-20 token contract address on Tempo.
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 stable resource ID for this token, equal to its contract address.
stringA URL for the token’s logo image, when one is available.
stringThe short ticker symbol wallets and apps show for this token.
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).
Get token by symbol
/v1/tokens/{symbol}Returns token metadata for a verified TIP-20 token using its symbol, such as USDC.
Path Parameters
Query Parameters
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.
stringmainnettestnetnumberResponses
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.
stringThe TIP-20 token contract address on Tempo.
stringToken admin from the onchain TokenCreated event, present when requested via include=admin and indexed data is available.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
string <date-time>Token creation timestamp, present when requested via include=createdAt and indexed data is available.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
integer·min 0·max 9007199254740991The number of accounts that currently hold a positive balance of this token, when indexed holder data is available.
stringA stable resource ID for this token, equal to its contract address.
stringA URL for the token’s logo image, when one is available.
stringQuote token from the onchain TokenCreated event, present when requested via include=quoteToken and indexed data is available.
stringThe token’s total supply as a decimal string in the smallest unit, so large values keep full precision.
objectLifetime Transfer event statistics, present when requested via include=transferStats and indexed data is available.
integer·min 0·max 9007199254740991The total number of Transfer events emitted by this token.
string <date-time>The time of this token’s first Transfer event, or null if no transfers exist.
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.
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
token_not_foundobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
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).
Get token by address
/v1/tokens/{token}Returns token metadata for a TIP-20 contract address, whether or not the token is in the verified list.
Path Parameters
Query Parameters
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.
stringmainnettestnetnumberResponses
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.
stringThe TIP-20 token contract address on Tempo.
stringToken admin from the onchain TokenCreated event, present when requested via include=admin and indexed data is available.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
string <date-time>Token creation timestamp, present when requested via include=createdAt and indexed data is available.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
integer·min 0·max 9007199254740991The number of accounts that currently hold a positive balance of this token, when indexed holder data is available.
stringA stable resource ID for this token, equal to its contract address.
stringA URL for the token’s logo image, when one is available.
stringQuote token from the onchain TokenCreated event, present when requested via include=quoteToken and indexed data is available.
stringThe token’s total supply as a decimal string in the smallest unit, so large values keep full precision.
objectLifetime Transfer event statistics, present when requested via include=transferStats and indexed data is available.
integer·min 0·max 9007199254740991The total number of Transfer events emitted by this token.
string <date-time>The time of this token’s first Transfer event, or null if no transfers exist.
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.
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
token_not_foundobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
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).
Get token logo
/v1/tokens/{token}/logoReturns the logo image for a TIP-20 token, using Tempo’s curated asset when available.
Path Parameters
Query Parameters
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.
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.
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
token_logo_not_foundobject[]A list of specific problems, when the error is about your request (e.g. invalid fields).
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?