PerformanceBlog
Tempo MCP serverGive agents search and read tools for Tempo docs
Skip to content
LogoLogo

Transactions

A transaction is what a user submits to Tempo: a signed envelope that moves value or calls a contract. One transaction can produce zero, one, or many token transfers. Query /v1/transfers to list the token movements it caused.

List transactions

GET/v1/transactions

List transactions across Tempo, with filters for addresses, blocks, timestamps, fees, and status.

Query Parameters

address
string

Filter to transactions where this address is either the sender or recipient.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
blockNumber.from
integer·min 0·max 9007199254740991

Only include transactions at or after this block number.

Example23456789
blockNumber.to
integer·min 0·max 9007199254740991

Only include transactions at or before this block number.

Example23456999
chainId

Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.

cursor
string

Opaque keyset cursor from a previous response (nextCursor); pass it back verbatim to fetch the next page. Omit for the first (head) page.

ExampleWzIzNDU2Nzg5LDBd
feePayer
string

Filter to transactions whose fee payer is this address.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
feeToken
string

Filter to transactions whose fee was paid in this token address.

Example0x20c0000000000000000000000000000000000000
include
string[]

Comma-separated related resources to include, such as feeToken,receipt,totalCount.

Values
feeTokenreceipttotalCount
Example["feeToken","receipt","totalCount"]
limit
integer·min 5·max 200·default 10

How many items to return per page (5–200, default 10).

Example10
order
string·default desc

Sort order: desc for descending (the default), or asc for ascending.

Values
ascdesc
Exampledesc
page
integer·min 1·max 9007199254740991

Page 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.

Example1
recipient
string

Filter to transactions sent to this recipient address.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
sender
string

Filter to transactions sent by this sender address.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
status
string

Filter to transactions whose receipt shows this execution status.

Values
successreverted
Examplesuccess
timestamp.from
string <date-time>

Only include transactions at or after this ISO 8601 timestamp.

Example2024-01-01T00:00:00Z
timestamp.to
string <date-time>

Only include transactions at or before this ISO 8601 timestamp.

Example2024-12-31T23:59:59Z

Responses

List transaction receipts

GET/v1/transactions/receipts

List transaction receipts across Tempo, with filters for addresses, blocks, timestamps, fees, and status.

Query Parameters

address
string

Filter to receipts whose transaction has this address as sender or recipient.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
blockNumber.from
integer·min 0·max 9007199254740991

Only include receipts at or after this block number.

Example23456789
blockNumber.to
integer·min 0·max 9007199254740991

Only include receipts at or before this block number.

Example23456999
chainId

Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.

cursor
string

Opaque keyset cursor from a previous response (nextCursor); pass it back verbatim to fetch the next page. Omit for the first (head) page.

ExampleWzIzNDU2Nzg5LDBd
feePayer
string

Filter to receipts whose transaction fee was paid by this address.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
feeToken
string

Filter to receipts whose transaction fee was paid in this token address.

Example0x20c0000000000000000000000000000000000000
include
string[]

Comma-separated related resources to include, such as feeToken,totalCount.

Values
feeTokentotalCount
Example["feeToken","totalCount"]
limit
integer·min 5·max 200·default 10

How many items to return per page (5–200, default 10).

Example10
order
string·default desc

Sort order: desc for descending (the default), or asc for ascending.

Values
ascdesc
Exampledesc
page
integer·min 1·max 9007199254740991

Page 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.

Example1
recipient
string

Filter to receipts for transactions sent to this recipient address.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
sender
string

Filter to receipts for transactions sent by this sender address.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
status
string

Filter to receipts with this execution status.

Values
successreverted
Examplesuccess
timestamp.from
string <date-time>

Only include receipts at or after this ISO 8601 timestamp.

Example2024-01-01T00:00:00Z
timestamp.to
string <date-time>

Only include receipts at or before this ISO 8601 timestamp.

Example2024-12-31T23:59:59Z

Responses

List token transactions

GET/v1/tokens/{token}/transactions

Lists transactions that interacted with this token contract.

Path Parameters

tokenRequired
string

The TIP-20 token contract address on Tempo.

Example0x20c0000000000000000000000000000000000000

Query Parameters

blockNumber.from
integer·min 0·max 9007199254740991

Only include transactions at or after this block number.

Example23456789
blockNumber.to
integer·min 0·max 9007199254740991

Only include transactions at or before this block number.

Example23456999
chainId

Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.

cursor
string

Opaque keyset cursor from a previous response (nextCursor); pass it back verbatim to fetch the next page. Omit for the first (head) page.

ExampleWzIzNDU2Nzg5LDBd
feePayer
string

Only include transactions where this account paid the fee.

Example0xbe058e1c4df8a4366a387bf595b284246a93039e
feeToken
string

Only include transactions whose fee was paid in this token. On Tempo, fees are paid in USD stablecoins instead of a separate volatile gas token.

Example0x20c0000000000000000000000000000000000000
include
string[]

Comma-separated related resources to include, such as feeToken,token,totalCount.

Values
feeTokentokentotalCount
Example["feeToken","token","totalCount"]
limit
integer·min 5·max 200·default 10

How many items to return per page (5–200, default 10).

Example10
order
string·default desc

Sort order: desc for descending (the default), or asc for ascending.

Values
ascdesc
Exampledesc
page
integer·min 1·max 9007199254740991

Page 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.

Example1
timestamp.from
string <date-time>

Only include transactions at or after this ISO 8601 timestamp.

Example2024-01-01T00:00:00Z
timestamp.to
string <date-time>

Only include transactions at or before this ISO 8601 timestamp.

Example2024-12-31T23:59:59Z

Responses

Get a transaction by hash

GET/v1/transactions/{transactionHash}

Get one transaction by its 32-byte transaction hash.

Path Parameters

transactionHashRequired
string

A 32-byte hash, 0x-prefixed and returned in lowercase, that identifies this transaction.

Example0x515801d7f9a5ac705e793e85904c9c69b3f1694b465cc8fb6ba3f0298dc82665

Query Parameters

chainId

Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.

include
string[]

Comma-separated related resources to include, such as feeToken,receipt.

Values
feeTokenreceipt
Example["feeToken","receipt"]

Responses

Get a transaction receipt

GET/v1/transactions/{transactionHash}/receipt

Get the outcome of one transaction by its transaction hash.

Path Parameters

transactionHashRequired
string

A 32-byte hash, 0x-prefixed and returned in lowercase, that identifies the transaction.

Example0x515801d7f9a5ac705e793e85904c9c69b3f1694b465cc8fb6ba3f0298dc82665

Query Parameters

chainId

Which Tempo network to query. Use the alias mainnet or testnet, or a numeric chain id. Defaults to mainnet when omitted.

include
string[]

Comma-separated related resources to include, such as feeToken.

Values
feeToken
Example["feeToken"]

Responses