Blocks
The ordered batches of transactions making up the chain.
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.
integer·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[]Blocks on this page.
stringA 32-byte hash, 0x-prefixed and returned in lowercase, that identifies this block.
stringStable resource ID for this API response; it is the block hash.
integer·min 0·max 9007199254740991The block height, starting from genesis block 0.
string <date-time>Block timestamp formatted as ISO 8601.
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 a block by selector
/v1/blocks/{block}Get one block by tag, number, hash, or timestamp selector.
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.
stringBase fee per gas for EIP-1559-style fee markets, or null when unsupported.
integer·min 0·max 9007199254740991Maximum gas available for all transactions in this block.
integer·min 0·max 9007199254740991Total gas used by transactions in this block.
stringA 32-byte hash, 0x-prefixed and returned in lowercase, that identifies this block.
stringStable resource ID for this API response; it is the block hash.
objectThe original JSON-RPC payload plus any resources requested with include.
objectThe original JSON-RPC block payload.
stringBlock difficulty value from legacy proof-of-work fields, when present.
stringThe block hash, or null for a pending block.
stringBloom filter summarizing logs in the block, or null while pending.
stringThe address of the block producer, also called the proposer or miner.
stringConsensus mix hash carried in the JSON-RPC block payload.
stringThe hash of the previous block in the chain.
stringRoot hash of the receipts trie for this block.
stringKeccak-256 hash of the uncle blocks list.
stringRoot hash of the world-state trie after this block.
stringTotal cumulative difficulty through this block, when present.
stringRoot hash of the transactions trie for this block.
stringThe address of the block producer, also called the proposer or miner.
integer·min 0·max 9007199254740991The block height, starting from genesis block 0.
stringThe hash of the previous block in the chain.
string <date-time>Block timestamp formatted as ISO 8601.
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).
block_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?