> Feedback: If these docs are stale, missing, or confusing, post sanitized feedback to `https://docs.tempo.xyz/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`](/api/activities#getaddressactivities): List address activities

### Balances

How much of each token an account holds.

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

### Blocks

The ordered batches of transactions making up the chain.

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

### Exchange

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

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

### Fee AMM

Pools that convert stablecoins to pay fees.

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

### Receipts

The outcome of a transaction: status, gas, logs.

- [`GET /v1/receipts`](/api/receipts#getreceipts): List transaction receipts
- [`GET /v1/receipts/{transaction}`](/api/receipts#getreceipt): Get a transaction receipt

### Tokens

TIP-20 token details, supply, and holders.

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

### Transactions

Signed instructions that move value or call contracts.

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

### Transfers

Token movements between accounts, with optional payment memos.

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

### Verified Tokens

A curated, trusted list of TIP-20 tokens.

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

### Indexer

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

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

### RPC

Direct access to the chain over Ethereum JSON-RPC.

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

### CoinGecko

Exchange data in CoinGecko's GeckoTerminal format.

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