Webhooks
Get signed callbacks when onchain events happen.
Query Parameters
stringOpaque 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).
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[]Webhook subscriptions on this page.
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When the subscription was created, as an ISO 8601 timestamp.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
stringEvent type you can subscribe to.
block:createdlog:emittedtoken:transfertransaction:includedstring <date-time>When the subscription expires, as an ISO 8601 timestamp. Only MPP-paid subscriptions expire.
integer·min 0·max 9007199254740991Number of delivery failures in a row for this subscription.
objectFilters applied to this event type.
string <date-time>When Tempo last delivered an event successfully, as an ISO 8601 timestamp.
stringCurrent state of the webhook subscription.
activedisabledpausedobjectExtra response metadata requested with include.
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).
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).
Create webhook
/v1/webhooksCreate a webhook subscription so Tempo can POST signed onchain events to your URL. The signing secret is shown only once, and each call creates a separate subscription.
Request Body
application/jsonWhich Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
stringmainnettestnetnumberobjectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
string·const token:transferEvent type you want Tempo to send to your webhook URL.
objectFilters that narrow which TIP-20 transfer events trigger this webhook.
stringMatch transfers where this account is either the sender or the recipient.
stringMatch transfers sent to this recipient address (to).
stringMatch transfers sent from this sender address (from).
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
stringmainnettestnetnumberobjectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
string·const transaction:includedEvent type you want Tempo to send to your webhook URL.
objectFilters that narrow which included transactions trigger this webhook.
Match this exact transaction hash (or any of several).
stringA 32-byte hash, 0x-prefixed and returned in lowercase — for example a transaction or block hash.
Match transactions where this address is the sender or recipient.
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
Match transactions whose sender (from) is this.
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
Match transactions sent to this address (root to; see includeCalls).
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
booleanWhen true (default), to/address also match an inner account-abstraction call target (calls[].to).
booleanWhen true, embed the transaction receipt (execution status, gasUsed, logs, …) in the delivered payload under meta.receipt. Default false (the receipt is an extra fetch). Mirrors the read endpoint’s include=receipt.
Match the transaction value (wei) bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match top-level calldata by 4-byte selector, hex startsWith, or exact.
objectMatch if ANY inner account-abstraction call targets this address (calls[].to).
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
Match the number of inner calls (call_count).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the transaction type (e.g. 0x76 for Tempo AA).
stringRaw binary data as a 0x-prefixed lowercase hex string (may be empty, just 0x).
Match the fee token address.
stringA TIP-20 token contract address — the 0x-prefixed 20-byte identifier for the token, returned in lowercase.
Match the fee payer address.
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
Match the gas limit bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the gas used bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the max fee per gas bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the max priority fee per gas bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the nonce bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the nonce key (Tempo AA).
stringRaw binary data as a 0x-prefixed lowercase hex string (may be empty, just 0x).
Match the validBefore bounds (unix s).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the validAfter bounds (unix s).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the block-number bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Match the block timestamp bounds (unix s).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
stringmainnettestnetnumberobjectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
string·const log:emittedEvent type you want Tempo to send to your webhook URL.
objectFilters that narrow which contract event logs trigger this webhook.
Only match logs emitted by this contract address (or any of several).
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
stringHuman-readable ABI event signature used to derive topic0 and decode args, e.g. event Transfer(address indexed from, address indexed to, uint256 value).
Event signature hash (topic 0). Mutually exclusive with signature.
stringA 32-byte hash, 0x-prefixed and returned in lowercase — for example a transaction or block hash.
Raw indexed argument 1 (topic 1).
stringA 32-byte hash, 0x-prefixed and returned in lowercase — for example a transaction or block hash.
Raw indexed argument 2 (topic 2).
stringA 32-byte hash, 0x-prefixed and returned in lowercase — for example a transaction or block hash.
Raw indexed argument 3 (topic 3).
stringA 32-byte hash, 0x-prefixed and returned in lowercase — for example a transaction or block hash.
objectMatch decoded event arguments by name (indexed or non-indexed). Requires signature. Each value is an exact value or an operator object.
Only match logs within these block-number bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
stringmainnettestnetnumberobjectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
string·const block:createdEvent type you want Tempo to send to your webhook URL.
objectFilters that narrow which new blocks trigger this webhook.
Only match blocks within these block-number bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Only match blocks produced by this address (the miner/producer).
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
Only match blocks proposed by this consensus proposer (when available).
stringAn account address — the 0x-prefixed 20-byte identifier for a wallet or contract, returned in lowercase.
Only match blocks whose total gas used is within these bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Only match blocks whose gas limit is within these bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
Only match blocks whose unix timestamp (seconds) is within these bounds.
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
stringA whole number encoded as a 0x-prefixed hexadecimal string (e.g. 0x1a is 26).
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.
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When the subscription was created, as an ISO 8601 timestamp.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
stringEvent type you can subscribe to.
block:createdlog:emittedtoken:transfertransaction:includedstring <date-time>When the subscription expires, as an ISO 8601 timestamp. Only MPP-paid subscriptions expire.
integer·min 0·max 9007199254740991Number of delivery failures in a row for this subscription.
objectFilters applied to this event type.
string <date-time>When Tempo last delivered an event successfully, as an ISO 8601 timestamp.
stringCurrent state of the webhook subscription.
activedisabledpausedstring <date-time>When the subscription was last changed, as an ISO 8601 timestamp.
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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
api_key_forbiddenlimit_exceededobject[]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).
Path 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.
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When the subscription was created, as an ISO 8601 timestamp.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
stringEvent type you can subscribe to.
block:createdlog:emittedtoken:transfertransaction:includedstring <date-time>When the subscription expires, as an ISO 8601 timestamp. Only MPP-paid subscriptions expire.
integer·min 0·max 9007199254740991Number of delivery failures in a row for this subscription.
objectFilters applied to this event type.
string <date-time>When Tempo last delivered an event successfully, as an ISO 8601 timestamp.
stringCurrent state of the webhook subscription.
activedisabledpausedobjectWhat 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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
webhook_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).
Path Parameters
Request Body
application/jsonobjectNew human context, or null to clear it.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
New delivery destination for future events (URL or Slack channel).
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
objectNew filters to apply to future webhook events.
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.
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When the subscription was created, as an ISO 8601 timestamp.
Delivery destination: an HTTPS URL, a Slack incoming-webhook URL, or a Better Stack source.
string·min 1Your Better Stack source token (sent as Authorization: Bearer …).
stringEvent type you can subscribe to.
block:createdlog:emittedtoken:transfertransaction:includedstring <date-time>When the subscription expires, as an ISO 8601 timestamp. Only MPP-paid subscriptions expire.
integer·min 0·max 9007199254740991Number of delivery failures in a row for this subscription.
objectFilters applied to this event type.
string <date-time>When Tempo last delivered an event successfully, as an ISO 8601 timestamp.
stringCurrent state of the webhook subscription.
activedisabledpausedobjectWhat 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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
webhook_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).
Delete webhook
/v1/webhooks/{id}Delete a webhook subscription and stop future deliveries immediately.
Path 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.
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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
webhook_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).
List webhook event types
/v1/webhooks/event-typesSee which onchain event types Tempo can POST to your webhook URL.
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[]Webhook event types available for subscription.
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).
List webhook deliveries
/v1/webhooks/{id}/deliveriesList delivery attempts for a webhook subscription.
Path Parameters
Query Parameters
stringOpaque 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).
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[]Webhook delivery attempts on this page.
integer·max 9007199254740991Retry attempt number for this delivery, starting at 1.
string <date-time>When this delivery attempt was created, as an ISO 8601 timestamp.
stringStable event ID (evt_…) you can use to dedupe webhook deliveries.
stringYour callback URL that Tempo attempted to deliver to.
integer·min 0·max 9007199254740991How long the delivery attempt took in milliseconds, when Tempo made a request.
integer·min -9007199254740991·max 9007199254740991HTTP status your endpoint returned, when Tempo received a response.
stringOutcome of a webhook delivery attempt.
failedpendingsucceededobjectExtra response metadata requested with include.
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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
webhook_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).
Ping webhook
/v1/webhooks/{id}/pingSend a signed ping event to your webhook URL to test delivery and signature verification.
Path 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.
integer·min 0·max 9007199254740991Round-trip delivery time in milliseconds, when the request completed.
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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
webhook_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).
Retry webhook delivery
/v1/webhooks/{id}/deliveries/{deliveryId}/retryReplay a previous webhook delivery and update the delivery result.
Path 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.
integer·min 0·max 9007199254740991Round-trip delivery time in milliseconds, when the request completed.
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).
objectWhat went wrong.
stringA short, stable code you can branch on in your code (e.g. token_not_found).
webhook_not_founddelivery_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).
Webhook event delivery
eventWhen an event you subscribed to happens, Tempo sends this signed message to your webhook URL as an HTTP POST (the same shape is used by POST /webhooks/:id/ping so you can test your endpoint). Always verify the tempo-signature header before trusting the body, then reply with any 2xx status to confirm you received it. If your endpoint returns a non-2xx status, times out, or redirects, Tempo retries with increasing delays; an endpoint that keeps failing is eventually disabled.
Header Parameters
stringSignature proving the message really came from Tempo. An HMAC-SHA256 of the body using your webhook secret, formatted t=<unix>,v1=<hex>. Verify this before trusting the payload.
stringA unique, stable id for this event (evt_…). The same event may be delivered more than once, so use this id to skip duplicates.
Request Body
application/jsoninteger·max 9007199254740991Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When Tempo built this delivery envelope, as an ISO 8601 timestamp.
stringStable event ID (evt_…) for this delivery. Store it and ignore duplicates.
objectPayload for a token:transfer event, decoded from a TIP-20 Transfer log.
unknownTIP-20 token contract address.
stringAmount transferred, as a decimal integer string in the token base unit.
integer·min 0·max 9007199254740991Block number where this transfer was included.
unknownAddress that received the transfer.
unknownAddress that sent the transfer.
string <date-time>Block timestamp as an ISO 8601 string.
objectBest-effort token metadata (symbol/decimals) resolved by the poller so amount can render as a human amount. Omitted when the lookup is unavailable.
integer·max 9007199254740991Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When Tempo built this delivery envelope, as an ISO 8601 timestamp.
stringStable event ID (evt_…) for this delivery. Store it and ignore duplicates.
objectA transaction formatted for API clients, with decoded fields and the original JSON-RPC payload under meta.rpc.
unknownThe block hash once included, or null while the transaction is pending.
integer·min 0·max 9007199254740991The block number once included, or null while the transaction is pending.
object[]Decoded calls for Tempo account-abstraction transactions.
integer·min 0·max 9007199254740991The chain ID that this transaction belongs to.
unknownThe fee token requested by the transaction; Tempo fees are paid in USD stablecoins such as pathUSD.
integer·min 0·max 9007199254740991Maximum gas the transaction is allowed to use.
stringGas price for legacy-style transactions, expressed as a decimal string when humanized.
unknownA 32-byte hash, 0x-prefixed and returned in lowercase, that identifies this transaction.
unknownCall data for non-Tempo transaction formats, as 0x-prefixed bytes.
stringMaximum priority fee per gas for EIP-1559-style transactions.
objectThe original JSON-RPC payload plus any resources requested with include.
objectFee-token details included only when you request include=feeToken.
unknownToken admin from the onchain TokenCreated event, present when requested via include=admin and indexed data is available.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
string <date-time>Token creation timestamp, present when requested via include=createdAt and indexed data is available.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
integer·min 0·max 9007199254740991The number of accounts that currently hold a positive balance of this token, when indexed holder data is available.
stringA stable resource ID for this token, equal to its contract address.
stringA URL for the token’s logo image, when one is available.
unknownQuote token from the onchain TokenCreated event, present when requested via include=quoteToken and indexed data is available.
stringThe short ticker symbol wallets and apps show for this token.
stringThe token’s total supply as a decimal string in the smallest unit, so large values keep full precision.
objectLifetime Transfer event statistics, present when requested via include=transferStats and indexed data is available.
integer·min 0·max 9007199254740991The total number of Transfer events emitted by this token.
string <date-time>The time of this token’s first Transfer event, or null if no transfers exist.
objectThe transaction outcome included only when you request include=receipt.
unknownThe block hash, or null when the receipt was reconstructed from indexed data.
integer·min 0·max 9007199254740991The block number that included this receipt.
unknownThe created contract address, or null if the transaction did not create a contract.
integer·min 0·max 9007199254740991Total gas used in the block up to and including this transaction.
stringEffective gas price paid for this transaction, in attodollars per gas.
stringFee charged to the fee payer, as a decimal integer string in the fee token’s base units.
unknownThe token used to pay the fee; on Tempo this is a USD stablecoin such as pathUSD.
integer·min 0·max 9007199254740991Gas actually used to execute the transaction.
unknownStable resource ID for this API response; it is the transaction hash.
object[]Event logs emitted by this transaction, returned in JSON-RPC log format.
unknownThe block hash once included, or null while pending.
stringThe block number once included, or null while pending.
stringTempo-provided block timestamp for this log.
unknownABI-encoded data for the event parameters that are not indexed.
stringThe log position within the block, or null while pending.
booleanWhether this log was removed by a chain reorganization; Tempo finality means finalized logs do not reorg.
unknown[]Indexed event topics, including the event signature hash as the first topic.
unknownThe transaction hash for this log, or null while pending.
objectThe original JSON-RPC payload plus any resources requested with include.
objectFee-token details included only when you request include=feeToken.
unknownToken admin from the onchain TokenCreated event, present when requested via include=admin and indexed data is available.
stringThe currency label for this token, such as USD for USD-denominated stablecoins.
string <date-time>Token creation timestamp, present when requested via include=createdAt and indexed data is available.
integer·min 0·max 9007199254740991The number of decimal places the token uses; Tempo stablecoins typically use 6.
integer·min 0·max 9007199254740991The number of accounts that currently hold a positive balance of this token, when indexed holder data is available.
stringA stable resource ID for this token, equal to its contract address.
stringA URL for the token’s logo image, when one is available.
unknownQuote token from the onchain TokenCreated event, present when requested via include=quoteToken and indexed data is available.
stringThe short ticker symbol wallets and apps show for this token.
stringThe token’s total supply as a decimal string in the smallest unit, so large values keep full precision.
objectLifetime Transfer event statistics, present when requested via include=transferStats and indexed data is available.
integer·min 0·max 9007199254740991The total number of Transfer events emitted by this token.
string <date-time>The time of this token’s first Transfer event, or null if no transfers exist.
objectThe original JSON-RPC receipt payload.
unknownThe block hash, or null for receipts reconstructed from the index.
stringThe block number that included this receipt.
stringBlock timestamp added when this receipt is reconstructed from indexed data.
unknownThe created contract address, or null if the transaction did not create a contract.
stringTotal gas used in the block up to and including this transaction.
stringEffective gas price paid for this transaction.
unknownThe token used to pay the fee; on Tempo this is a USD stablecoin such as pathUSD.
stringGas actually used to execute the transaction.
object[]Event logs emitted by contracts while this transaction executed.
unknownThe contract address that emitted this event log.
unknownThe block hash once included, or null while pending.
stringThe block number once included, or null while pending.
stringTempo-provided block timestamp for this log.
unknownABI-encoded data for the event parameters that are not indexed.
stringThe log position within the block, or null while pending.
booleanWhether this log was removed by a chain reorganization; Tempo finality means finalized logs do not reorg.
unknown[]Indexed event topics, including the event signature hash as the first topic.
unknownThe transaction hash for this log, or null while pending.
unknownBloom filter summarizing the logs in this receipt.
unknownPost-transaction state root used by pre-Byzantium Ethereum receipts.
stringExecution status as a hex quantity: 0x1 means success and 0x0 means reverted.
unknownThe recipient address, or null when the transaction created a contract.
unknownA 32-byte hash, 0x-prefixed and returned in lowercase, that identifies the transaction.
stringThe transaction position within its block.
unknownThe recipient address, or null when the transaction created a contract.
stringWhether the transaction succeeded or reverted.
successrevertedstring <date-time>The block timestamp as ISO 8601, or null when it is unavailable.
unknownA 32-byte hash, 0x-prefixed and returned in lowercase, that identifies the transaction.
integer·min 0·max 9007199254740991The transaction position within its block.
objectThe original JSON-RPC transaction payload.
object[]EIP-2930 access list that predeclares accounts and storage slots for the transaction.
unknownThe block hash once included, or null while the transaction is pending.
stringThe block number once included, or null while the transaction is pending.
stringThe block timestamp for the block that included this transaction.
object[]Decoded calls for Tempo account-abstraction transactions.
unknownCall data for this call; this is the same bytes as input when both are present.
unknownCall data sent to the contract, as 0x-prefixed bytes.
unknownThe address this call targets, or null when the call creates a contract.
stringThe chain ID that the transaction is valid on; legacy transactions may omit it.
objectSignature from the account that paid the transaction fee.
unknownThe fee token requested by the transaction; Tempo fees are paid in USD stablecoins such as pathUSD.
stringGas price for legacy-style transactions, expressed as a decimal string when humanized.
unknownA 32-byte hash, 0x-prefixed and returned in lowercase, that identifies this transaction.
unknownCall data for non-Tempo transaction formats, as 0x-prefixed bytes.
stringMaximum priority fee per gas for EIP-1559-style transactions.
stringNonce from the sender account that orders and de-duplicates transactions.
stringTempo two-dimensional nonce key used to group nonce sequences.
objectSignature from the sender authorizing this transaction.
stringThe transaction position within its block, or null while pending.
unknownRaw transaction type byte, such as 0x2 for EIP-1559 or 0x76 for Tempo.
stringEarliest Unix timestamp when this Tempo transaction may be included.
stringLatest Unix timestamp when this Tempo transaction may be included.
integer·min 0·max 9007199254740991Nonce from the sender account that orders and de-duplicates transactions.
unknownThe recipient address, or null when the transaction creates a contract.
string <date-time>The block timestamp as ISO 8601, or null while the transaction is pending.
integer·min 0·max 9007199254740991The transaction position within its block, or null while pending.
stringHuman-readable transaction type decoded from the raw JSON-RPC type byte.
legacyeip2930eip1559eip4844eip7702string <date-time>Earliest ISO 8601 time when this Tempo transaction may be included.
integer·max 9007199254740991Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When Tempo built this delivery envelope, as an ISO 8601 timestamp.
stringStable event ID (evt_…) for this delivery. Store it and ignore duplicates.
objectPayload for a log:emitted event (a raw contract event log).
unknownContract that emitted the log.
objectDecoded event arguments, present only when a signature filter was supplied and decoding succeeded.
integer·min 0·max 9007199254740991Block number the log was included in.
unknownUnindexed log data (ABI-encoded).
objectDecoded event identity, present only when a signature filter was supplied.
stringHuman-readable event signature used to decode the log.
string <date-time>When the block was produced, as an ISO 8601 timestamp.
unknown[]Log topics, starting with the event signature hash (topic 0).
unknownHash of the transaction that emitted the log.
integer·max 9007199254740991Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When Tempo built this delivery envelope, as an ISO 8601 timestamp.
stringStable event ID (evt_…) for this delivery. Store it and ignore duplicates.
objectPayload for a block:created event (a new block header).
integer·min 0·max 9007199254740991Block height, starting from genesis block 0.
unknownHash that identifies this block.
unknownHash of the previous block in the chain.
unknownAddress of the block producer (miner/proposer).
unknownConsensus proposer of the block, when the chain records one.
integer·min 0·max 9007199254740991Total gas used by every transaction in this block.
integer·min 0·max 9007199254740991Maximum gas available for all transactions in this block.
integer·min 0·max 9007199254740991Number of transactions included in this block.
integer·max 9007199254740991Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id (mainnet is 4217).
objectHuman context describing what this webhook subscription is for.
string·max 500Longer description of what this subscription is for.
objectArbitrary key/value labels echoed on every delivered event and rendered by destinations (Slack fields, Better Stack log fields). Keys are 1–64 chars, values ≤500 chars, ≤20 entries.
string <date-time>When Tempo built this delivery envelope, as an ISO 8601 timestamp.
stringStable event ID (evt_…) for this delivery. Store it and ignore duplicates.
objectPayload for a webhook ping test delivery.
Responses
Was this helpful?