Cross Chain
Balances
Transactions
- GETGet a transaction
- GETGet transaction summary for address
- GETGet earliest transactions for address (v3)
- GETGet recent transactions for address (v3)
- GETGet paginated transactions for address (v3)
- GETGet bulk time bucket transactions for address (v3)
- GETGet all transactions in a block by page (v3)
- GETGet all transactions in a block (v3)
NFT
- Core Rendering
- Market Data
- Ownership & Token Gating
Bitcoin
Get paginated transactions for address (v3)
Commonly used to fetch the transactions involving an address including the decoded log events in a paginated fashion.
import { GoldRushClient } from "@covalenthq/client-sdk";
const ApiServices = async () => {
const client = new GoldRushClient("YOUR_API_KEY");
const resp = await client.TransactionService.getTransactionsForAddressV3({chainName: "chainName", walletAddress: "walletAddress"});
console.log(resp.data);
};
ApiServices();{
"address": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"quote_currency": "<string>",
"chain_id": 123,
"chain_name": "<string>",
"current_page": 123,
"links": {
"prev": "<string>",
"next": "<string>"
},
"items": [
{
"block_signed_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"block_hash": "<string>",
"tx_hash": "<string>",
"tx_offset": 123,
"successful": true,
"from_address": "<string>",
"miner_address": "<string>",
"from_address_label": "<string>",
"to_address": "<string>",
"to_address_label": "<string>",
"value": "<string>",
"value_quote": 123,
"pretty_value_quote": "<string>",
"gas_metadata": {
"contract_decimals": 123,
"contract_name": "<string>",
"contract_ticker_symbol": "<string>",
"contract_address": "<string>",
"supports_erc": [
"<string>"
],
"logo_url": "<string>"
},
"gas_offered": 123,
"gas_spent": 123,
"gas_price": 123,
"fees_paid": "<string>",
"gas_quote": 123,
"pretty_gas_quote": "<string>",
"gas_quote_rate": 123,
"explorers": [
{
"label": "<string>",
"url": "<string>"
}
],
"log_events": [
{
"block_signed_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"tx_offset": 123,
"log_offset": 123,
"tx_hash": "<string>",
"raw_log_topics": [
"<string>"
],
"sender_contract_decimals": 123,
"sender_name": "<string>",
"sender_contract_ticker_symbol": "<string>",
"sender_address": "<string>",
"sender_address_label": "<string>",
"sender_logo_url": "<string>",
"supports_erc": [
"<string>"
],
"sender_factory_address": "<string>",
"raw_log_data": "<string>",
"decoded": {
"name": "<string>",
"signature": "<string>",
"params": [
{
"name": "<string>",
"type": "<string>",
"indexed": true,
"decoded": true,
"value": "<string>"
}
]
}
}
]
}
]
}Processing: Realtime
This endpoint returns paginated transactions, starting with the earliest transactions on page 0. For the most recent transactions, refer to the endpoint.
Requests that return status 200 and no data cost 0.1 credits.
Enabling no-logs reduces request cost to 0.05 per item.
How Token Gating and Membership dApps Use the GoldRush API
Comparing GoldRush’s Transactions API to RPC Providers
How to Get Transaction History for an Address on Ethereum
Getting Started with the GoldRush SDK
Discover Your Ethereum Gas Consumption with the GoldRush API
Calculate Crypto Cost Basis and Capital Gains with GoldRush
Introducing Transactions V3 APIs
How to Use Covalent’s Wallet Transaction Analysis Tool
Path Parameters
The chain name eg: eth-mainnet.
The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.
The requested page, 0-indexed.
Query Parameters
The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP.
Omit log events.
Sort the transactions in ascending chronological order. By default, it's set to false and returns transactions in descending chronological order.
Response
The requested address.
The timestamp when the response was generated. Useful to show data staleness to users.
The requested quote currency eg: USD.
The requested chain ID eg: 1.
The requested chain name eg: eth-mainnet.
The current page of the response.
List of response items.
The block signed timestamp in UTC.
The height of the block.
The hash of the block. Use it to remove transactions from re-org-ed blocks.
The requested transaction hash.
The offset is the position of the tx in the block.
Indicates whether a transaction failed or succeeded.
The sender's wallet address.
The address of the miner.
The label of from address.
The receiver's wallet address.
The label of to address.
b;The value attached to this tx.
The value attached in quote-currency to this tx.
A prettier version of the quote for rendering purposes.
The requested chain native gas token metadata.
Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.
The string returned by the name() method.
The ticker symbol for this contract. This field is set by a developer and non-unique across a network.
Use the relevant contract_address to lookup prices, logos, token transfers, etc.
A list of supported standard ERC interfaces, eg: ERC20 and ERC721.
The contract logo URL.
The gas spent for this tx.
The gas price at the time of this tx.
b;The total transaction fees (gas_price * gas_spent) paid for this tx, denoted in wei.
The gas spent in quote-currency denomination.
A prettier version of the quote for rendering purposes.
The native gas exchange rate for the requested quote-currency.
The log events.
The block signed timestamp in UTC.
The height of the block.
The offset is the position of the tx in the block.
The offset is the position of the log entry within an event log.
The requested transaction hash.
The log topics in raw data.
Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.
The name of the sender.
The address of the sender.
The label of the sender address.
The contract logo URL.
A list of supported standard ERC interfaces, eg: ERC20 and ERC721.
The address of the deployed UniswapV2 like factory contract for this DEX.
The log events in raw.
The decoded item.
import { GoldRushClient } from "@covalenthq/client-sdk";
const ApiServices = async () => {
const client = new GoldRushClient("YOUR_API_KEY");
const resp = await client.TransactionService.getTransactionsForAddressV3({chainName: "chainName", walletAddress: "walletAddress"});
console.log(resp.data);
};
ApiServices();{
"address": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"quote_currency": "<string>",
"chain_id": 123,
"chain_name": "<string>",
"current_page": 123,
"links": {
"prev": "<string>",
"next": "<string>"
},
"items": [
{
"block_signed_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"block_hash": "<string>",
"tx_hash": "<string>",
"tx_offset": 123,
"successful": true,
"from_address": "<string>",
"miner_address": "<string>",
"from_address_label": "<string>",
"to_address": "<string>",
"to_address_label": "<string>",
"value": "<string>",
"value_quote": 123,
"pretty_value_quote": "<string>",
"gas_metadata": {
"contract_decimals": 123,
"contract_name": "<string>",
"contract_ticker_symbol": "<string>",
"contract_address": "<string>",
"supports_erc": [
"<string>"
],
"logo_url": "<string>"
},
"gas_offered": 123,
"gas_spent": 123,
"gas_price": 123,
"fees_paid": "<string>",
"gas_quote": 123,
"pretty_gas_quote": "<string>",
"gas_quote_rate": 123,
"explorers": [
{
"label": "<string>",
"url": "<string>"
}
],
"log_events": [
{
"block_signed_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"tx_offset": 123,
"log_offset": 123,
"tx_hash": "<string>",
"raw_log_topics": [
"<string>"
],
"sender_contract_decimals": 123,
"sender_name": "<string>",
"sender_contract_ticker_symbol": "<string>",
"sender_address": "<string>",
"sender_address_label": "<string>",
"sender_logo_url": "<string>",
"supports_erc": [
"<string>"
],
"sender_factory_address": "<string>",
"raw_log_data": "<string>",
"decoded": {
"name": "<string>",
"signature": "<string>",
"params": [
{
"name": "<string>",
"type": "<string>",
"indexed": true,
"decoded": true,
"value": "<string>"
}
]
}
}
]
}
]
}