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 NFT transactions for contract
Commonly used to get all transactions of an NFT token. Useful for building a transaction history table or price chart.
import { GoldRushClient } from "@covalenthq/client-sdk";
const ApiServices = async () => {
const client = new GoldRushClient("YOUR_API_KEY");
const resp = await client.NftService.getNftTransactionsForContractTokenId({chainName: "chainName", walletAddress: "walletAddress"});
console.log(resp.data);
};
ApiServices();{
"updated_at": "2023-11-07T05:31:56Z",
"chain_id": 123,
"chain_name": "<string>",
"items": [
{
"contract_decimals": 123,
"contract_name": "<string>",
"contract_ticker_symbol": "<string>",
"logo_url": "<string>",
"contract_address": "<string>",
"supports_erc": [
"<string>"
],
"nft_transactions": [
{
"block_signed_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"tx_hash": "<string>",
"tx_offset": 123,
"successful": true,
"from_address": "<string>",
"from_address_label": "<string>",
"to_address": "<string>",
"to_address_label": "<string>",
"value": "<string>",
"value_quote": 123,
"pretty_value_quote": "<string>",
"gas_offered": 123,
"gas_spent": 123,
"gas_price": 123,
"fees_paid": "<string>",
"gas_quote": 123,
"pretty_gas_quote": "<string>",
"gas_quote_rate": 123,
"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>"
}
]
}
}
]
}
],
"is_spam": true
}
]
}Processing: Realtime
Path Parameters
The chain name eg: eth-mainnet.
The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.
The requested token ID.
Query Parameters
If true, the suspected spam tokens are removed. Supports eth-mainnet and matic-mainnet.
Response
The timestamp when the response was generated. Useful to show data staleness to users.
The requested chain ID eg: 1.
The requested chain name eg: eth-mainnet.
List of response items.
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.
The contract logo URL.
Use the relevant contract_address to lookup prices, logos, token transfers, etc.
A list of supported standard ERC interfaces, eg: ERC20 and ERC721.
The block signed timestamp in UTC.
The height of the block.
The requested transaction hash.
The offset is the position of the tx in the block.
Whether or not transaction is successful.
The sender's wallet address.
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 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 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.
Denotes whether the token is suspected spam. Supports eth-mainnet and matic-mainnet.
import { GoldRushClient } from "@covalenthq/client-sdk";
const ApiServices = async () => {
const client = new GoldRushClient("YOUR_API_KEY");
const resp = await client.NftService.getNftTransactionsForContractTokenId({chainName: "chainName", walletAddress: "walletAddress"});
console.log(resp.data);
};
ApiServices();{
"updated_at": "2023-11-07T05:31:56Z",
"chain_id": 123,
"chain_name": "<string>",
"items": [
{
"contract_decimals": 123,
"contract_name": "<string>",
"contract_ticker_symbol": "<string>",
"logo_url": "<string>",
"contract_address": "<string>",
"supports_erc": [
"<string>"
],
"nft_transactions": [
{
"block_signed_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"tx_hash": "<string>",
"tx_offset": 123,
"successful": true,
"from_address": "<string>",
"from_address_label": "<string>",
"to_address": "<string>",
"to_address_label": "<string>",
"value": "<string>",
"value_quote": 123,
"pretty_value_quote": "<string>",
"gas_offered": 123,
"gas_spent": 123,
"gas_price": 123,
"fees_paid": "<string>",
"gas_quote": 123,
"pretty_gas_quote": "<string>",
"gas_quote_rate": 123,
"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>"
}
]
}
}
]
}
],
"is_spam": true
}
]
}