Exchange
Tempo's built-in stablecoin exchange: pairs, swaps, orders, prices.
List swaps
/v1/exchange/swapsList recent swaps on Tempo’s built-in stablecoin exchange. A swap trades one token for another and may contain multiple maker-order fills.
Query Parameters
integer·min 0·max 9007199254740991Only include swaps at or after this block number.
integer·min 0·max 9007199254740991Only include swaps 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 optional resources to embed, e.g. tokens.
tokensinteger·min 5·max 200·default 10How many items to return per page (5–200, default 10).
stringOnly include swaps that filled against an order owned by this maker address.
string·default descSort order: desc for descending (the default), or asc for ascending.
ascdescstringOnly include swaps where this address participated as the taker or as a maker whose order was filled.
stringOnly include swaps initiated by this taker address.
string <date-time>Only include swaps at or after this ISO 8601 timestamp.
string <date-time>Only include swaps at or before 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[]Swaps returned on this page.
integer·min 0·max 9007199254740991Block number where the swap was included.
objectDestination side of the swap: what the taker received, summed across the final hop.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
stringHuman-readable currency code for the token, when known.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
string <date-time>Block timestamp when the swap was filled onchain.
object[]Maker-order fills that make up this swap, ordered by execution logIndex. Exact-destination swaps can execute hops in reverse, so use route for the source-to-destination path.
objectToken and amount the taker received in this fill, with token metadata when requested via include=tokens.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
stringHuman-readable currency code for the token, when known.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
stringHuman-readable token name, such as USD Coin.
booleanWhether Tempo has verified this token metadata.
integer·min 0·max 9007199254740991Log index of this fill within its block.
stringMaker address whose resting order was filled.
stringOn-chain maker order id, returned as a decimal string.
booleanWhether this fill used only part of the maker order.
stringQuote-per-base price at fill time, returned as a fixed-decimal string with 5 decimal places. This value is direction-independent and works well for charts.
objectToken and amount the taker sent in this fill, with token metadata when requested via include=tokens.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
stringHuman-readable currency code for the token, when known.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
booleanWhether Tempo has verified this token metadata.
stringStable API id built from the lowercase transaction hash and the first fill log index.
integer·min 0·max 9007199254740991Block-wide log index for the swap, taken from its first fill.
stringThe amount type fixed by the swap call: exactSource for swapExactAmountIn or exactDestination for swapExactAmountOut. This is recovered from transaction calldata and is null when the swap did not come from a decodable swap call.
exactSourceexactDestinationstringSwap-level effective rate, calculated as destination amount divided by source amount from the taker’s perspective and returned with 5 decimal places. Compare it with 1 to see distance from peg.
string[]Token path for the swap, from source through any intermediate tokens to destination. route.length - 1 is the hop count; two entries means a direct swap.
objectSource side of the swap: what the taker sent, summed across the first hop.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
stringTaker address that initiated the swap.
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 pairs
/v1/exchange/pairsList trading pairs available on Tempo’s built-in stablecoin exchange.
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 optional resources to embed, e.g. tokens,totalCount.
tokenstotalCountinteger·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[]Trading pairs returned on this page.
objectBase token — the asset whose price is quoted in the pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
integer·min 0·max 9007199254740991Block number where the pair was created.
stringStable API id for this pair; it is the same value as the onchain pair key.
stringStable onchain pair identifier returned by the DEX precompile as pairKey.
stringLiquidity signal for the pair, present only when you request sort=liquidity.
objectQuote token — the asset used to price the base token.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
string <date-time>Block timestamp when the pair was created.
objectResponse-level resources requested with include, such as totalCount.
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).
List orders
/v1/exchange/ordersList resting maker orders on Tempo’s built-in stablecoin exchange. These are open orders waiting in the orderbook.
Query Parameters
stringOnly include orders for the pair with this base token. The quote token is determined onchain from the base token, so base alone selects the pair; returns 404 if no pair exists.
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 optional resources to embed, e.g. tokens,totalCount.
tokenstotalCountinteger·min 5·max 200·default 10How many items to return per page (5–200, default 10).
stringOnly include orders placed by this maker address.
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.
stringLimit results to one side of the orderbook: bid orders pay quote for base, while ask orders sell base for quote.
bidaskResponses
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[]Resting orders returned on this page.
stringOriginal placed amount, returned as a decimal integer string in base-token smallest units.
integer·min 0·max 9007199254740991Block number where the order was placed.
stringStable API id for this order; it is the same value as the onchain order id.
integer·min 0·max 9007199254740991Log index of the order placement within its block.
stringMaker address that owns the order.
string <date-time>Block timestamp when the order was placed.
stringQuote-per-base limit price implied by tick, returned with 5 decimal places. This value is direction-independent; use rate for the taker-perspective ratio.
stringOrder limit price as a destination/source ratio from the taker’s perspective, returned with 5 decimal places. Use price for orderbook displays.
stringUnfilled remainder of amount, returned as a decimal integer string in base-token smallest units. This is always positive for rows in this response.
stringOrderbook side: bid pays quote for base, and ask sells base for quote.
bidaskinteger·min -9007199254740991·max 9007199254740991Order tick as a signed offset from peg; one tick equals 1/priceScale.
stringTransaction hash for the transaction that placed the order.
objectThe trading pair the order belongs to.
objectBase side of the pair; the order trades this token.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
stringOn-chain key for this (base, quote) trading pair.
objectQuote side of the trading pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
objectResponse-level resources requested with include, such as totalCount.
booleanWhether totalCount hit the count cap. When true, totalCount is a lower bound rather than an exact total.
stringPass this back as the cursor query parameter to fetch the next page. null once you have reached the end of the list.
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).
pair_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).
List order fills
/v1/exchange/orders/{orderId}/fillsList fills for one order. A fill records an execution against the maker order.
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 optional resources to embed, e.g. totalCount.
totalCountinteger·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[]Fills returned on this page.
stringBase-side amount filled by this event, returned as a decimal integer string in base-token smallest units.
integer·min 0·max 9007199254740991Block number where the fill was included.
string <date-time>Block timestamp when the fill landed onchain.
stringStable API id built from the lowercase transaction hash and log index.
integer·min 0·max 9007199254740991Log index of this fill within its block.
stringTaker address that submitted the incoming order.
objectResponse-level resources 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).
Get pair
/v1/exchange/pairs/{base}Get one trading pair by its base token address. On Tempo, the quote token for a pair is determined from the base token onchain.
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.
objectBase token — the asset whose price is quoted in the pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
integer·min 0·max 9007199254740991Block number where the pair was created.
stringStable API id for this pair; it is the same value as the onchain pair key.
stringStable onchain pair identifier returned by the DEX precompile as pairKey.
stringLiquidity signal for the pair, present only when you request sort=liquidity.
objectQuote token — the asset used to price the base token.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
string <date-time>Block timestamp when the pair was created.
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).
pair_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 order
/v1/exchange/orders/{orderId}Get one order by id, using live onchain state for fields such as the remaining amount.
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.
stringInitial order size, returned as a decimal integer string in base-token smallest units.
integer·min -9007199254740991·max 9007199254740991Replacement tick used if this order auto-flips into a counter-order after filling.
stringStable API id for this order; it is the same value as the onchain order id.
booleanOrder side as a boolean: true means the maker buys base, and false means the maker sells base.
booleanWhether this order automatically becomes a counter-order after it fills.
stringMaker address that owns the order.
stringTaker-perspective mode for the order. exactSource applies to maker bids where the taker sells base; exactDestination applies to maker asks where the taker buys base.
exactSourceexactDestinationobjectThe trading pair the order belongs to.
objectBase side of the pair; the order trades this token.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
stringOn-chain key for this (base, quote) trading pair.
objectQuote side of the trading pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
stringQuote-per-base price implied by tick, returned as a fixed-decimal string with 5 decimal places.
stringDestination-to-source price ratio, returned as a fixed-decimal string with 5 decimal places.
stringUnfilled base-side amount still resting on the orderbook, returned as a decimal integer string.
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).
order_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 pair OHLC
/v1/exchange/pairs/{base}/ohlcGet OHLC price candles for one trading pair. OHLC means open, high, low, and close over each time bucket for charting.
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.
stringmainnettestnetnumberstring[]Comma-separated optional resources to embed, e.g. tokens.
tokensResponses
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.
objectBase side of the trading pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
object[]OHLC candle buckets ordered oldest to newest; empty buckets are omitted.
stringClose price for the bucket: the latest fill rate, returned with 5 decimal places.
integer·min 0·max 9007199254740991Number of fills included in this bucket.
stringHigh price for the bucket: the highest fill rate, returned with 5 decimal places.
stringStable API id built from the pair key, candle interval, and bucket start time in Unix seconds.
stringLow price for the bucket: the lowest fill rate, returned with 5 decimal places.
stringOpen price for the bucket: the earliest fill rate, returned with 5 decimal places.
string <date-time>ISO 8601 timestamp for the start of this candle bucket.
objectTotal filled volume in this bucket, split by pair side.
objectQuote side of the trading pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
booleantrue when the fill scan hit its hard cap, meaning OHLC values were computed from only the most recent fills.
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).
pair_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 pair depth
/v1/exchange/pairs/{base}/depthGet orderbook depth for one trading pair. Depth shows resting liquidity at price ticks on both sides of the book.
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.
stringmainnettestnetnumberstring[]Comma-separated optional resources to embed, e.g. tokens.
tokensResponses
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[]Ask-side levels, where makers sell base and takers buy it, ordered from best lowest ask outward.
stringRunning sum of size from the best populated tick outward to this level, in base-token smallest units.
stringStable API id built from the pair key, orderbook side, and tick.
stringResting liquidity at this tick level, in base-token smallest units.
objectBase side of the trading pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
object[]Bid-side levels, where makers buy base and takers sell it, ordered from best highest bid outward.
stringRunning sum of size from the best populated tick outward to this level, in base-token smallest units.
stringStable API id built from the pair key, orderbook side, and tick.
stringResting liquidity at this tick level, in base-token smallest units.
objectQuote side of the trading pair.
stringTIP-20 token contract address — the 0x-prefixed 20-byte identifier for this token.
integer·min 0·max 9007199254740991Number of decimal places the token uses; stablecoins on Tempo typically use 6.
stringURL for the token logo SVG, when one is available.
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).
pair_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?