> Feedback: If these docs are stale, missing, or confusing, post sanitized feedback to `https://tempo.xyz/developers/api/feedback` with `source: "mcp"`, a short `message`, and any relevant `toolName`, `relatedResource`, or `client`.
# Tempo API

Version: `1.0.0`

REST API for reading and interacting with Tempo

## Servers

- `https://api.tempo.xyz`: Relative to the host serving this document.

## Endpoints

### Activities

A readable feed of what an account did onchain.

- [`GET /v1/addresses/{address}/activities`](/docs/api/activities#getaddressactivities): List address activities
- [`GET /v1/transactions/{transactionHash}/activities`](/docs/api/activities#gettransactionactivities): List transaction activities

### Balances

How much of each token an account holds.

- [`GET /v1/addresses/{address}/balances`](/docs/api/balances#getaddressbalances): List address balances

### Blocks

The ordered batches of transactions making up the chain.

- [`GET /v1/blocks`](/docs/api/blocks#getblocks): List blocks
- [`GET /v1/blocks/{block}`](/docs/api/blocks#getblock): Get a block by selector

### Exchange

Tempo's built-in stablecoin exchange: pairs, swaps, orders, prices.

- [`GET /v1/exchange/swaps`](/docs/api/exchange#getswaps): List swaps
- [`GET /v1/exchange/pairs`](/docs/api/exchange#getpairs): List pairs
- [`GET /v1/exchange/orders`](/docs/api/exchange#getorders): List orders
- [`GET /v1/exchange/orders/{orderId}/fills`](/docs/api/exchange#getorderfills): List order fills
- [`GET /v1/exchange/pairs/{base}`](/docs/api/exchange#getpair): Get pair
- [`GET /v1/exchange/orders/{orderId}`](/docs/api/exchange#getorder): Get order
- [`GET /v1/exchange/pairs/{base}/ohlc`](/docs/api/exchange#getpairohlc): Get pair OHLC
- [`GET /v1/exchange/pairs/{base}/depth`](/docs/api/exchange#getpairdepth): Get pair depth

### Fee AMM

Pools that convert stablecoins to pay fees.

- [`GET /v1/fee-amm/pools`](/docs/api/fee-amm#getfeeammpools): List pools
- [`GET /v1/fee-amm/mints`](/docs/api/fee-amm#getfeeammmints): List mints

### Tokens

TIP-20 token details, supply, and holders.

- [`GET /v1/tokens`](/docs/api/tokens#gettokens): List tokens
- [`GET /v1/tokens/{token}/holders`](/docs/api/tokens#gettokenholders): List token holders
- [`GET /v1/tokens/{symbol}`](/docs/api/tokens#gettokenbysymbol): Get token by symbol
- [`GET /v1/tokens/{token}`](/docs/api/tokens#gettoken): Get token by address
- [`GET /v1/tokens/{token}/logo`](/docs/api/tokens#gettokenlogo): Get token logo

### Transactions

Transactions submitted to Tempo, and their receipts.

- [`GET /v1/transactions`](/docs/api/transactions#gettransactions): List transactions
- [`GET /v1/transactions/receipts`](/docs/api/transactions#getreceipts): List transaction receipts
- [`GET /v1/tokens/{token}/transactions`](/docs/api/transactions#gettokentransactions): List token transactions
- [`GET /v1/transactions/{transactionHash}`](/docs/api/transactions#gettransaction): Get a transaction by hash
- [`GET /v1/transactions/{transactionHash}/receipt`](/docs/api/transactions#getreceipt): Get a transaction receipt

### Transfers

Token movements from executing transactions.

- [`GET /v1/transfers`](/docs/api/transfers#gettransfers): List transfers

### Verified Tokens

A curated, trusted list of TIP-20 tokens.

- [`GET /v1/tokenlist`](/docs/api/verified-tokens#gettokenlist): Get token list

### Indexer

Run read-only SQL queries against Tempo's indexed data.

- [`GET /v1/indexer/query`](/docs/api/indexer#indexerquery): Query indexed chain data

### RPC

Direct access to the chain over Ethereum JSON-RPC. Not part of the stable API contract; best-effort support only. No compatibility, latency, availability, or data-freshness guarantees. Breaking changes may happen with limited notice.

- [`POST /rpc/{chain}`](/docs/api/rpc#admin_validatorkey): admin_validatorKey
- [`POST /rpc/{chain}`](/docs/api/rpc#consensus_getfinalization): consensus_getFinalization
- [`POST /rpc/{chain}`](/docs/api/rpc#consensus_getidentitytransitionproof): consensus_getIdentityTransitionProof
- [`POST /rpc/{chain}`](/docs/api/rpc#consensus_getlatest): consensus_getLatest
- [`POST /rpc/{chain}`](/docs/api/rpc#consensus_subscribe): consensus_subscribe
- [`POST /rpc/{chain}`](/docs/api/rpc#consensus_unsubscribe): consensus_unsubscribe
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_blocknumber): eth_blockNumber
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_call): eth_call
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_chainid): eth_chainId
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_createaccesslist): eth_createAccessList
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_estimategas): eth_estimateGas
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_feehistory): eth_feeHistory
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_filltransaction): eth_fillTransaction
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_gasprice): eth_gasPrice
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getblockaccesslist): eth_getBlockAccessList
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getblockbyhash): eth_getBlockByHash
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getblockbynumber): eth_getBlockByNumber
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getblockreceipts): eth_getBlockReceipts
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getblocktransactioncountbyhash): eth_getBlockTransactionCountByHash
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getblocktransactioncountbynumber): eth_getBlockTransactionCountByNumber
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getcode): eth_getCode
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getfilterchanges): eth_getFilterChanges
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getfilterlogs): eth_getFilterLogs
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getlogs): eth_getLogs
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getproof): eth_getProof
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getstorageat): eth_getStorageAt
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_getstoragevalues): eth_getStorageValues
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_gettransactionbyblockhashandindex): eth_getTransactionByBlockHashAndIndex
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_gettransactionbyblocknumberandindex): eth_getTransactionByBlockNumberAndIndex
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_gettransactionbyhash): eth_getTransactionByHash
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_gettransactioncount): eth_getTransactionCount
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_gettransactionreceipt): eth_getTransactionReceipt
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_maxpriorityfeepergas): eth_maxPriorityFeePerGas
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_newblockfilter): eth_newBlockFilter
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_newfilter): eth_newFilter
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_newpendingtransactionfilter): eth_newPendingTransactionFilter
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_sendrawtransaction): eth_sendRawTransaction
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_sendrawtransactionsync): eth_sendRawTransactionSync
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_simulatev1): eth_simulateV1
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_syncing): eth_syncing
- [`POST /rpc/{chain}`](/docs/api/rpc#eth_uninstallfilter): eth_uninstallFilter
- [`POST /rpc/{chain}`](/docs/api/rpc#tempo_forkschedule): tempo_forkSchedule
- [`POST /rpc/{chain}`](/docs/api/rpc#tempo_fundaddress): tempo_fundAddress

### CoinGecko

Exchange data in CoinGecko's GeckoTerminal format.

- [`GET /gecko/{chainId}/pairs`](/docs/api/coingecko#coingeckopairs): List trading pairs
- [`GET /gecko/{chainId}/events`](/docs/api/coingecko#coingeckoevents): List swap events
- [`GET /gecko/{chainId}/latest-block`](/docs/api/coingecko#coingeckolatestblock): Get latest indexed block
- [`GET /gecko/{chainId}/assets/{address}`](/docs/api/coingecko#coingeckoasset): Get asset
- [`GET /gecko/{chainId}/pairs/{pairId}`](/docs/api/coingecko#coingeckopair): Get trading pair