Fee AMM
Pools that convert stablecoins to pay fees.
List pools
/v1/fee-amm/poolsLists Fee AMM pools, most active first, so you can see which stablecoin fee conversions have the most liquidity activity.
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 metadata.
tokeninteger·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[]Fee AMM pools ordered by mint count, most active first.
string <date-time>Timestamp when liquidity was first minted into this pool.
stringStable resource id for the pool; this is the same value as poolId.
string <date-time>Timestamp when liquidity was most recently minted into this pool.
integer·min 0·max 9007199254740991Number of liquidity mints into this pool.
stringPool id computed as keccak256(abi.encode(userToken, validatorToken)), matching FeeManager.getPoolId.
objectToken users pay fees with in this pool, including its current reserve when available.
stringTIP-20 token contract address used by this fee pool.
integer·min 0·max 9007199254740991Number of decimal places the token uses.
stringURL for the token logo SVG, when available.
stringCurrent onchain reserve for this token, in base units, from FeeManager.getPool. Omitted if the read fails.
objectToken validators receive from this pool, including its current reserve when available.
stringTIP-20 token contract address used by this fee pool.
integer·min 0·max 9007199254740991Number of decimal places the token uses.
stringURL for the token logo SVG, when available.
stringCurrent onchain reserve for this token, in base units, from FeeManager.getPool. Omitted if the read fails.
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).
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.
stringOnly include mints for pools where users paid fees with this token.
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[]Liquidity mints returned on this page.
stringAmount of the user-side token deposited, in base units. Only present on legacy-signature mints.
stringAmount of the validator-side token deposited, in base units.
integer·min 0·max 9007199254740991Block number where the mint occurred.
stringStable mint id built from the transaction hash and log index (${transactionHash}-${logIndex}).
integer·min 0·max 9007199254740991Log index of this mint within the block.
stringAddress that deposited tokens into the pool.
stringAddress that received the minted liquidity. Only present on current-signature mints.
string <date-time>Block timestamp when the mint occurred.
stringHash of the transaction that emitted this mint.
objectToken users pay fees with in this pool.
stringTIP-20 token contract address used by this fee pool.
integer·min 0·max 9007199254740991Number of decimal places the token uses.
stringURL for the token logo SVG, when available.
objectToken validators receive from this pool.
stringTIP-20 token contract address used by this fee pool.
integer·min 0·max 9007199254740991Number of decimal places the token uses.
stringURL for the token logo SVG, when available.
objectResponse-wide metadata 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).
Was this helpful?