---
title: "Get Contract Transactions"
method: GET
path: "/v1/contracts/{chainId}/{address}/transactions"
tags: ["Gateway"]
---

# Get Contract Transactions

`GET /v1/contracts/{chainId}/{address}/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.

## Path parameters

- `chainId` integer, required — The blockchain network identifier where the contract is deployed.
- `address` string, required — The smart contract address or ENS name.

## Query parameters

- `filterFromAddress` string — Filter by transaction sender address
- `filterToAddress` string — Filter by transaction recipient address
- `filterBlockTimestampGte` integer, nullable — Filter by block timestamp (Unix timestamp) greater than or equal to this value
- `filterBlockTimestampLte` integer, nullable — Filter by block timestamp (Unix timestamp) less than or equal to this value
- `filterBlockNumberGte` integer, nullable — Filter by block number greater than or equal to this value
- `filterBlockNumberLte` integer, nullable — Filter by block number less than or equal to this value
- `filterValueGt` string — Filter by transaction value (in wei) greater than this value
- `filterFunctionSelector` string — Filter by function selector (4-byte method ID), e.g., '0xa9059cbb' for ERC-20 transfer
- `page` number, nullable — Current page number
- `limit` number, nullable — Number of items per page
- `sortOrder` 'asc' | 'desc' — Sort order: 'asc' for ascending, 'desc' for descending

## Response `200`

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

- object
  - `result` object, required
    - `data` object[], required — Array of contract transactions.
      - `blockHash` string, required — The hash of the block containing this transaction.
      - `blockNumber` number, required — The block number containing this transaction.
      - `blockTimestamp` number, required — The timestamp of the block (Unix timestamp).
      - `chainId` string, required — The chain ID where the transaction occurred.
      - `contractAddress` string — Contract address created if this was a contract creation transaction.
      - `cumulativeGasUsed` number — Total gas used by all transactions in this block up to and including this one.
      - `data` string, required — The transaction input data.
      - `decoded` object — Decoded transaction data (included when ABI is available).
        - `inputs` object, required — Object containing decoded function parameters.
        - `name` string, required — The function name.
        - `signature` string, required — The function signature.
      - `effectiveGasPrice` string — The effective gas price paid (in wei as string).
      - `fromAddress` string, required — The address that initiated the transaction.
      - `functionSelector` string, required — The function selector (first 4 bytes of the transaction data).
      - `gas` number, required — The gas limit for the transaction.
      - `gasPrice` string, required — The gas price used for the transaction (in wei as string).
      - `gasUsed` number — The amount of gas used by the transaction.
      - `hash` string, required — The transaction hash.
      - `maxFeePerGas` string — Maximum fee per gas (EIP-1559).
      - `maxPriorityFeePerGas` string — Maximum priority fee per gas (EIP-1559).
      - `nonce` number, required — The transaction nonce.
      - `status` number, required — The transaction status (1 for success, 0 for failure).
      - `toAddress` string, required — The address that received the transaction.
      - `transactionIndex` number, required — The index of the transaction within the block.
      - `transactionType` number — The transaction type (0=legacy, 1=EIP-2930, 2=EIP-1559).
      - `value` string, required — The value transferred in the transaction (in wei as string).
    - `pagination` object, required
      - `hasMore` boolean — Whether there are more items available
      - `limit` number, nullable — Number of items per page
      - `page` number, nullable — Current page number
      - `totalCount` number, nullable — Total number of items available

## Other responses

- `400` — Invalid request parameters. This occurs when the contract address or chainId format is invalid, or pagination parameters are out of range.
- `401` — Authentication required. The request must include a valid `x-client-id` header for frontend usage or `x-secret-key` for backend usage.
- `404` — Contract not found or no transactions available for the specified contract address on the given blockchain network.
- `500` — Internal server error. This may occur due to network connectivity issues, external service unavailability, or unexpected server errors.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)