Contracts
Contract Transactions
Query all transactions for any deployed contract on any EVM chain.
fetch( "https://api.thirdweb.com/v1/contracts/{chainId}/{address}/transactions?page=1&limit=20&sortOrder=desc", { method: "GET", headers: { "x-secret-key": "<your-project-secret-key>", }, },);
x-secret-key
backendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-id
frontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-id
optionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-id
optionalEcosystem partner ID - for ecosystem wallets.
chainId
integerRequiredThe blockchain network identifier where the contract is deployed.
address
stringRequiredThe smart contract address or ENS name.
filterFromAddress
stringFilter by transaction sender address
filterToAddress
stringFilter by transaction recipient address
filterBlockTimestampGte
integerFilter by block timestamp (Unix timestamp) greater than or equal to this value
filterBlockTimestampLte
integerFilter by block timestamp (Unix timestamp) less than or equal to this value
filterBlockNumberGte
integerFilter by block number greater than or equal to this value
filterBlockNumberLte
integerFilter by block number less than or equal to this value
filterValueGt
stringFilter by transaction value (in wei) greater than this value
filterFunctionSelector
stringFilter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer
page
numberCurrent page number
Example:
1
limit
numberNumber of items per page
Example:
20
sortOrder
stringSort order: 'asc' for ascending, 'desc' for descending
Example:
desc
{ "result": { "data": [ { "blockHash": "string", "blockNumber": 0, "blockTimestamp": 0, "chainId": "string", "data": "string", "fromAddress": "string", "functionSelector": "string", "gas": 0, "gasPrice": "string", "hash": "string", "nonce": 0, "status": 0, "toAddress": "string", "transactionIndex": 0, "value": "string", "contractAddress": "string", "cumulativeGasUsed": 0, "decoded": { "inputs": { "property": "value" }, "name": "string", "signature": "string" } } ], "pagination": { "hasMore": true, "limit": 20, "page": 1 } }}