Sign in

v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Gateway

Get Contract Transactions

Retrieves transactions for a specific smart contract address on a specific blockchain network. This endpoint provides comprehensive transaction data including block information, gas details, transaction status, and function calls. Results can be filtered, paginated, and sorted to meet specific requirements.

Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.

get/v1/contracts/{chainId}/{address}/transactions

Path parameters

chainIdinteger required

The blockchain network identifier where the contract is deployed.

Example:1

The blockchain network identifier where the contract is deployed.

addressstring required

The smart contract address or ENS name.

The smart contract address or ENS name.

Query parameters

filterFromAddressstring

Filter by transaction sender address

Filter by transaction sender address

filterToAddressstring

Filter by transaction recipient address

Filter by transaction recipient address

filterBlockTimestampGteinteger nullable

Filter by block timestamp (Unix timestamp) greater than or equal to this value

Filter by block timestamp (Unix timestamp) greater than or equal to this value

filterBlockTimestampLteinteger nullable

Filter by block timestamp (Unix timestamp) less than or equal to this value

Filter by block timestamp (Unix timestamp) less than or equal to this value

filterBlockNumberGteinteger nullable

Filter by block number greater than or equal to this value

Filter by block number greater than or equal to this value

filterBlockNumberLteinteger nullable

Filter by block number less than or equal to this value

Filter by block number less than or equal to this value

filterValueGtstring

Filter by transaction value (in wei) greater than this value

Filter by transaction value (in wei) greater than this value

filterFunctionSelectorstring

Filter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer

Filter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer

pagenumber nullable

Current page number

Current page number

limitnumber nullable

Number of items per page

Number of items per page

sortOrder'asc' | 'desc'

Sort order: 'asc' for ascending, 'desc' for descending

Sort order: 'asc' for ascending, 'desc' for descending

Response

Contract transactions retrieved successfully. Returns transaction data with metadata including pagination information. Includes decoded function calls when ABI is available.