Transaction Endpoints

Transaction API

Operation Identity:

Operation ID: getTransaction
GET /v1/{chainName}/transaction_v2/{txHash}/
SDK: TransactionService.getTransaction()

Role: primary | Credit Cost: 0.1 per call | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`txHash`	string	Yes	The transaction hash.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`with-internal`	boolean	No	-	Whether to include internal transfers/transactions.
`with-input-data`	boolean	No	-	Whether to include the transaction’s input data, which is returned as `input_data.method_id`. Supported on a narrower set of chains than `with-internal`; returns a `501` where unsupported. Costs an extra `0.05` credits/item.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of the transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.
`account-address`	string	No	-	The address to classify the transaction for, when `with-classification=true`. If omitted, the transaction’s `from_address` is used.

Response Fields

Field	Type	Description
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`items`	`array`	List of response items.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`input_data`	`object`	The transaction’s input data. Only present when `with-input-data=true` is passed and the chain supports it.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per call Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Base cost is 0.1 credits (e.g. requests that return with status 200 but no items).

Calls with no-logs cost 0.05 credits/item. Internal transactions are included in the response by using with-internal and cost 0.05 credits/item.

Note: with-internal is supported on select EVM chains only. See Traces Support for the current list of supported chains.

Comparing GoldRush’s Transactions API to RPC Providers How to Get Transaction History for an Address on Ethereum

Block Transactions API by Page

Operation Identity:

Operation ID: getTransactionsForBlockByPage
GET /v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/

Role: specialized | Credit Cost: 0.1 per item | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`blockHeight`	integer	Yes	The requested block height. Also accepts `latest` to get latest block.
`page`	integer	Yes	The requested 0-indexed page number.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.

Response Fields

Field	Type	Description
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`links`	`object`
`items`	`array`	List of response items.

Link Fields

Field	Type	Description
`prev`	`string`	URL link to the next page.
`next`	`string`	URL link to the previous page.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 credits/item.

Block Transactions API

Operation Identity:

Operation ID: getTransactionsForBlockHash
GET /v1/{chainName}/block_hash/{blockHash}/transactions_v3/

Role: specialized | Credit Cost: 0.1 per item | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`blockHash`	string	Yes	The requested block hash.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.

Response Fields

Field	Type	Description
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`items`	`array`	List of response items.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 credits/item. Introducing Transactions V3 APIs Comparing GoldRush’s Transactions API to RPC Providers How to Track Wallets or Transactions with the GoldRush API How to Get the Number of Transactions in a Block How to Get All Historical Transactions in a Block

Earliest Wallet Transactions API

Operation Identity:

Operation ID: getEarliestTimeBucketTransactionsForAddress
GET /v1/{chainName}/bulk/transactions/{walletAddress}/

Role: specialized | Credit Cost: 0.1 per item | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`walletAddress`	string	Yes	The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`with-internal`	boolean	No	-	Whether to include internal transfers/transactions.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.

Response Fields

Field	Type	Description
`address`	`string`	The requested address.
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`quote_currency`	`string`	The requested quote currency eg: `USD`.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`complete`	`boolean`
`current_bucket`	`integer`	The current bucket of the response.
`links`	`object`
`items`	`array`	List of response items.

Link Fields

Field	Type	Description
`prev`	`string`	URL link to the next page.
`next`	`string`	URL link to the previous page.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Returns the same results as the first timebucket for an address in the Get recent transactions endpoint.

Requests that return status 200 and no data cost 0.1 credits. Calls with no-logs cost 0.05 credits/item. Internal transactions are included in the response by using with-internal and cost 0.05 credits/item.

Note: with-internal is supported on select EVM chains only. See Traces Support for the current list of supported chains.

Introducing Transactions V3 APIs Comparing GoldRush’s Transactions API to RPC Providers How to Get Transaction History for an Address on Ethereum

Paginated Wallet Transactions API

Operation Identity:

Operation ID: getTransactionsForAddressV3
GET /v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/

Role: primary | Credit Cost: 0.1 per item | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`walletAddress`	string	Yes	The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
`page`	integer	Yes	The requested page, 0-indexed.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`block-signed-at-asc`	boolean	No	-	Sort the transactions in ascending chronological order. By default, it’s set to `false` and returns transactions in descending chronological order.
`with-internal`	boolean	No	-	Whether to include internal transfers/transactions.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.

Response Fields

Field	Type	Description
`address`	`string`	The requested address.
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`quote_currency`	`string`	The requested quote currency eg: `USD`.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`current_page`	`integer`	The current page of the response.
`links`	`object`
`items`	`array`	List of response items.

Link Fields

Field	Type	Description
`prev`	`string`	URL link to the next page.
`next`	`string`	URL link to the previous page.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: This endpoint returns paginated transactions, starting with the earliest transactions on page 0. For the most recent transactions, refer to the Get recent transactions for address (v3) endpoint.

Requests that return status 200 and no data cost 0.1 credits. Enabling no-logs reduces request cost to 0.05 credits/item. Internal transactions are included in the response by using with-internal and cost 0.05 credits/item.

Note: with-internal is supported on select EVM chains only. See Traces Support for the current list of supported chains.

Introducing Transactions V3 APIs Comparing GoldRush’s Transactions API to RPC Providers How to Get Transaction History for an Address on Ethereum

Wallet Transaction History API

Operation Identity:

Operation ID: getRecentTransactionsForAddress
GET /v1/{chainName}/address/{walletAddress}/transactions_v3/

Role: primary | Credit Cost: 0.1 per item | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`walletAddress`	string	Yes	The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`block-signed-at-asc`	boolean	No	-	Sort the transactions in ascending chronological order. By default, it’s set to `false` and returns transactions in descending chronological order.
`with-internal`	boolean	No	-	Whether to include internal transfers/transactions.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.

Response Fields

Field	Type	Description
`address`	`string`	The requested address.
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`quote_currency`	`string`	The requested quote currency eg: `USD`.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`current_page`	`integer`	The current page of the response.
`links`	`object`
`items`	`array`	List of response items.

Link Fields

Field	Type	Description
`prev`	`string`	URL link to the next page.
`next`	`string`	URL link to the previous page.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 credits/item. Internal transactions are included in the response by using with-internal and cost 0.05 credits/item.

Note: with-internal is supported on select EVM chains only. See Traces Support for the current list of supported chains.

Introducing Transactions V3 APIs Comparing GoldRush’s Transactions API to RPC Providers

Time Bucket Transactions API

Operation Identity:

Operation ID: getTimeBucketTransactionsForAddress
GET /v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/
SDK: TransactionService.getTimeBucketTransactionsForAddress()

Role: specialized | Credit Cost: 0.1 per item | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`walletAddress`	string	Yes	The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
`timeBucket`	integer	Yes	The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`no-logs`	boolean	No	-	Omit log events.
`with-classification`	boolean	No	-	Whether to include a human-readable classification of each transaction, such as a swap or a token transfer. Supported on the same chains as `with-internal`. Costs an extra `0.05` credits/item.

Response Fields

Field	Type	Description
`address`	`string`	The requested address.
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`quote_currency`	`string`	The requested quote currency eg: `USD`.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`chain_tip_height`	`integer`	The latest block height of the blockchain at the time this response was provided.
`chain_tip_signed_at`	`string`	The timestamp of the latest signed block at the time this response was provided.
`complete`	`boolean`
`current_bucket`	`integer`	The current bucket of the response.
`links`	`object`
`items`	`array`	List of response items.

Link Fields

Field	Type	Description
`prev`	`string`	URL link to the next page.
`next`	`string`	URL link to the previous page.

Item Fields

Field	Type	Description
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block. Use it to remove transactions from re-org-ed blocks.
`tx_hash`	`string`	The requested transaction hash.
`tx_offset`	`integer`	The offset is the position of the tx in the block.
`successful`	`boolean`	Indicates whether a transaction failed or succeeded.
`from_address`	`string`	The sender’s wallet address.
`miner_address`	`string`	The address of the miner.
`to_address`	`string`	The receiver’s wallet address.
`value`	`string`	b;The value attached to this tx.
`value_quote`	`number`	The value attached in `quote-currency` to this tx.
`pretty_value_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_metadata`	`object`	The requested chain native gas token metadata.
`gas_offered`	`integer`
`gas_spent`	`integer`	The gas spent for this tx.
`gas_price`	`integer`	The gas price at the time of this tx.
`fees_paid`	`string`	b;The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei.
`gas_quote`	`number`	The gas spent in `quote-currency` denomination.
`pretty_gas_quote`	`string`	A prettier version of the quote for rendering purposes.
`gas_quote_rate`	`number`	The native gas exchange rate for the requested `quote-currency`.
`explorers`	`array<object>`	The explorer links for this transaction.
`log_events`	`array<object>`	The log events.
`internal_transfers`	`array<object>`	List of internal transfers/transactions associated with the wallet address.
`classification`	`object`	A human-readable classification of the transaction. Only present when `with-classification=true`.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 credits/item. Scaling Transactions API with Time Buckets Introducing Transactions V3 APIs Comparing GoldRush’s Transactions API to RPC Providers

Wallet Transaction Summary API

Operation Identity:

Operation ID: getTransactionSummary
GET /v1/{chainName}/address/{walletAddress}/transactions_summary/
SDK: TransactionService.getTransactionSummary()

Role: primary | Credit Cost: 1 per call | API Type: REST Chains: All supported chains

Path Parameters

Parameter	Type	Required	Description
`chainName`	string	Yes	The chain name eg: `eth-mainnet`.
`walletAddress`	string	Yes	The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.

Query Parameters

Parameter	Type	Required	Default	Description
`quote-currency`	string	No	-	The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
`with-gas`	boolean	No	-	Include gas summary details. Response times may be impacted for wallets with large number of transactions.
`with-transfer-count`	boolean	No	-	Represents the total count of ERC-20 token movement events, including `Transfer`, `Deposit` and `Withdraw`. Response times may be impacted for wallets with large number of transactions.

Response Fields

Field	Type	Description
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`address`	`string`	The requested address.
`chain_id`	`integer`	The requested chain ID eg: `1`.
`chain_name`	`string`	The requested chain name eg: `eth-mainnet`.
`items`	`array`	List of response items.

Item Fields

Field	Type	Description
`total_count`	`integer`	The total number of transactions.
`transfer_count`	`integer`	Represents the total count of ERC-20 token movement events, including `Transfer`, `Deposit` and `Withdraw`.
`earliest_transaction`	`object`	The earliest transaction detected.
`latest_transaction`	`object`	The latest transaction detected.
`gas_summary`	`object`	The gas summary for the transactions.

Credit Cost: 1 per call Processing: Batch

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: - Base cost is 1 credit.

Using with-gas is an additional 1 credit.
Using with-transfer-count is an additional 3 credits.

Building Web3 Wallets (Part 7) - Multi-Chain Wallet Activity Summary Comparing GoldRush’s Transactions API to RPC Providers How to Get Transaction History for an Address on Ethereum

Bitcoin Transaction History API

Operation Identity:

Operation ID: getTransactionsForBtcAddress
GET /v1/cq/covalent/app/bitcoin/transactions/
SDK: BitcoinService.getTransactionsForBtcAddress()

Role: primary | Credit Cost: 0.1 per item | API Type: REST Chains: btc-mainnet

Query Parameters

Parameter	Type	Required	Default	Description
`address`	string	No	-	The bitcoin address to query.
`page-size`	integer	No	100	Number of items per page. Omitting this parameter defaults to 100.
`page-number`	integer	No	-	0-indexed page number to begin pagination.

Response Fields

Field	Type	Description
`updated_at`	`string`	The timestamp when the response was generated. Useful to show data staleness to users.
`items`	`array`	List of response items.
`pagination`	`object`	Pagination metadata.

Item Fields

Field	Type	Description
`chain_id`	`integer`	The requested chain ID eg: `20090103`.
`chain_name`	`string`	The requested chain name eg: `btc-mainnet`.
`contract_decimals`	`integer`	Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`.
`block_signed_at`	`string`	The block signed timestamp in UTC.
`block_height`	`integer`	The height of the block.
`block_hash`	`string`	The hash of the block.
`tx_hash`	`string`	The requested transaction hash.
`tx_idx`	`integer`	The position index of the tx in the block.
`type`	`string`	Either ‘input’ as the sender or ‘output’ as the receiver of btc.
`address`	`string`	The wallet address.
`value`	`string`	b;The value attached to this tx in satoshi.
`quote`	`number`	The value attached to this tx in USD.
`quote_rate`	`number`	The value token exchange rate in USD.
`fees_paid`	`string`	b;The total transaction fees denoted in satoshi.
`gas_quote`	`number`	The gas spent in USD.
`gas_quote_rate`	`number`	The native gas token exchange rate in USD.
`coinbase`	`boolean`	Indicates if this is a coinbase tx where btc is rewarded to a miner for validating the block.
`locktime`	`integer`	The earliest Unix timestamp or block height at which the tx is valid and can be included. Is `0` if no restriction.
`weight`	`integer`	A measure that reflects impact on the block size limit. Used to determine fees.

Pagination Fields

Field	Type	Description
`has_more`	`boolean`	True if there is another page.
`page_number`	`integer`	The requested page number.
`page_size`	`integer`	The requested number of items on the current page.
`total_count`	`integer`	The total number of items across all pages for this request.

Credit Cost: 0.1 per item Processing: Realtime

Tip: Estimate your monthly cost for this API using the Pricing Calculator.

Note: Only supports non-HD bitcoin addresses.

Transaction Classification (`with-classification`)

Pass with-classification=true to identify the action behind each transaction - a swap, a token transfer, a liquidity deposit - instead of reconstructing intent from raw logs and transfers. It costs an extra 0.05 credits per transaction returned, on top of the endpoint’s own cost. It is available on these endpoints, documented above:

Transaction API
Wallet Transaction History API
Paginated Wallet Transactions API
Time Bucket Transactions API
Earliest Wallet Transactions API
Block Transactions API by Page
Block Transactions API

Perspective: which wallet the transaction is classified for

The same transaction reads differently depending on whose side you are on. On the wallet endpoints, each transaction is classified for the wallet address in the path. On the single-transaction endpoint there is no wallet in the path, so it takes an account-address parameter to choose the perspective. If you omit account-address, the transaction is classified from the sender’s point of view (from_address), which is often not the wallet you care about.

# Wallet endpoints: classified for the address in the path
curl "https://api.covalenthq.com/v1/base-mainnet/address/<WALLET_ADDRESS>/transactions_v3/?with-classification=true&key=<GOLDRUSH_API_KEY>"

# Single transaction: pass account-address to pick the perspective
curl "https://api.covalenthq.com/v1/base-mainnet/transaction_v2/<TX_HASH>/?with-classification=true&account-address=<WALLET_ADDRESS>&key=<GOLDRUSH_API_KEY>"

The `classification` object

Returned per transaction, only when with-classification=true.

Field	Description
`type`	The transaction type, eg: `swap`, `send_token`, `receive_token`, `add_liquidity`. Returns `unclassified` when no rule applies.
`category`	The category the `type` belongs to. See the table below.
`description`	A summary ready to display, eg: `Swapped 872.59 AERO for 0.279091760280112109 WETH.`
`sent`	The assets that left the wallet, including gas fees.
`received`	The assets that arrived at the wallet.
`account_abstraction`	Bundler, sender and paymaster details for ERC-4337 transactions.

Note: type and category values are lower snake_case (eg: send_token, not sendToken).

Category	What it covers
`defi`	Swaps, adding and removing liquidity, rebalancing positions, and placing, filling or cancelling DEX orders
`lending`	Borrowing, repaying, depositing and withdrawing collateral, and liquidations
`staking`	Staking, unstaking, locking, and claiming rewards
`nft`	Minting, buying, selling, sending, receiving and burning NFTs, NFT approvals, listing cancellations, airdrops and royalties
`transfer`	Sending and receiving tokens, token airdrops and burns
`bridge`	Sending tokens to a bridge and receiving them from one
`governance`	Voting and delegating
`spam`	Spam tokens and address poisoning
`system`	Contract deployments, admin calls, ERC-4337 bundle submissions and system transactions
`other`	Everything else, such as token approvals, wraps and unwraps, exchange deposits and withdrawals, domain registrations, and failed transactions

Supported chains (23)

Classification is supported on the same chains as with-internal:

Chain	`chainName`
ADI Chain	`adi-mainnet`
ApeChain	`apechain-mainnet`
Arbitrum	`arbitrum-mainnet`
Arc	`arc-mainnet`
Avalanche C-Chain	`avalanche-mainnet`
Base	`base-mainnet`
Berachain	`berachain-mainnet`
BNB Smart Chain (BSC)	`bsc-mainnet`
Ethereum	`eth-mainnet`
Gnosis	`gnosis-mainnet`
HyperEVM	`hyperevm-mainnet`
Linea	`linea-mainnet`
Mantle	`mantle-mainnet`
MegaETH	`megaeth-mainnet`
Monad	`monad-mainnet`
Optimism	`optimism-mainnet`
Plasma	`plasma-mainnet`
Polygon	`matic-mainnet`
Robinhood Chain	`robinhood-mainnet`
Sonic	`sonic-mainnet`
Taiko	`taiko-mainnet`
Unichain	`unichain-mainnet`
World Chain	`world-mainnet`

Chain support changes over time. Check is_tx_classification_supported on https://api.covalenthq.com/v1/chains/ for the current list rather than relying on this table.

​Transaction Endpoints

​Transaction API

​Path Parameters

​Query Parameters

​Response Fields

​Item Fields

​Related guides

​Block Transactions API by Page

​Path Parameters

​Query Parameters

​Response Fields

​Link Fields

​Item Fields

​Block Transactions API

​Path Parameters

​Query Parameters

​Response Fields

​Item Fields

​Related guides

​Earliest Wallet Transactions API

​Path Parameters

​Query Parameters

​Response Fields

​Link Fields

​Item Fields

​Related guides

​Paginated Wallet Transactions API

​Path Parameters

​Query Parameters

​Response Fields

​Link Fields

​Item Fields

​Related guides

​Wallet Transaction History API

​Path Parameters

​Query Parameters

​Response Fields

​Link Fields

​Item Fields

​Related guides

​Time Bucket Transactions API

​Path Parameters

​Query Parameters

​Response Fields

​Link Fields

​Item Fields

​Related guides

​Wallet Transaction Summary API

​Path Parameters

​Query Parameters

​Response Fields

​Item Fields

​Related guides

​Bitcoin Transaction History API

​Query Parameters

​Response Fields

​Item Fields

​Pagination Fields

​Transaction Classification (with-classification)

​Perspective: which wallet the transaction is classified for

​The classification object

​Categories

​Supported chains (23)

Transaction Endpoints

Transaction API

Path Parameters

Query Parameters

Response Fields

Item Fields

Related guides

Block Transactions API by Page

Path Parameters

Query Parameters

Response Fields

Link Fields

Item Fields

Block Transactions API

Path Parameters

Query Parameters

Response Fields

Item Fields

Related guides

Earliest Wallet Transactions API

Path Parameters

Query Parameters

Response Fields

Link Fields

Item Fields

Related guides

Paginated Wallet Transactions API

Path Parameters

Query Parameters

Response Fields

Link Fields

Item Fields

Related guides

Wallet Transaction History API

Path Parameters

Query Parameters

Response Fields

Link Fields

Item Fields

Related guides

Time Bucket Transactions API

Path Parameters

Query Parameters

Response Fields

Link Fields

Item Fields

Related guides

Wallet Transaction Summary API

Path Parameters

Query Parameters

Response Fields

Item Fields

Related guides

Bitcoin Transaction History API

Query Parameters

Response Fields

Item Fields

Pagination Fields

Transaction Classification (`with-classification`)

Perspective: which wallet the transaction is classified for

The `classification` object

Categories

Supported chains (23)