Indexer
Run read-only SQL queries against Tempo's indexed data.
Query indexed chain data
/v1/indexer/queryRuns a read-only SQL-style query against Tempo’s indexed chain data, with optional live streaming as new blocks arrive.
Query Parameters
stringRead-only SQL query to run against Tempo’s indexed chain data. Use SELECT statements only.
integer·min 1Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
string[]ABI event signature to expose as a named SQL CTE, so you can query decoded event fields directly. Repeat this parameter to add multiple signatures.
stringChoose the indexer engine yourself. By default the indexer routes automatically; clickhouse cannot be used with live=true.
postgresclickhouseboolean·default falseStream results as Server-Sent Events and re-run the query on every new block. This cannot be combined with engine=clickhouse.
integer·min 1·max 10000·default 10000Maximum number of rows to return. The server clamps this to the range 1 through 10,000.
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.
integer·min 0·max 9007199254740991Number of rows returned in this response.
integer·min 0·max 9007199254740991Number of rows returned in this response.
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?