import { GoldRushClient } from "@covalenthq/client-sdk";
const ApiServices = async () => {
const client = new GoldRushClient("YOUR_API_KEY");
const resp = await client.NftService.getNftsForAddress({chainName: "chainName", walletAddress: "walletAddress"});
console.log(resp.data);
};
ApiServices();{
"address": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"chain_tip_height": 123,
"chain_tip_signed_at": "2023-11-07T05:31:56Z",
"items": [
{
"contract_name": "<string>",
"contract_ticker_symbol": "<string>",
"contract_address": "<string>",
"supports_erc": [
"<string>"
],
"is_spam": true,
"last_transfered_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"balance": "<string>",
"balance_24h": "<string>",
"type": "<string>",
"floor_price_quote": 123,
"pretty_floor_price_quote": "<string>",
"floor_price_native_quote": 123,
"nft_data": [
{
"token_id": "<string>",
"token_url": "<string>",
"original_owner": "<string>",
"current_owner": "<string>",
"external_data": {
"name": "<string>",
"description": "<string>",
"asset_url": "<string>",
"asset_file_extension": "<string>",
"asset_mime_type": "<string>",
"asset_size_bytes": "<string>",
"image": "<string>",
"image_256": "<string>",
"image_512": "<string>",
"image_1024": "<string>",
"animation_url": "<string>",
"external_url": "<string>",
"attributes": [
{
"trait_type": "<string>",
"value": "<string>"
}
],
"thumbnails": {
"image_256": "<string>",
"image_512": "<string>",
"image_1024": "<string>",
"image_opengraph_url": "<string>",
"thumbhash": "<string>"
},
"image_preview": "<string>",
"asset_properties": {
"asset_width": 123,
"asset_height": 123,
"dominant_color": "<string>"
}
},
"asset_cached": true,
"image_cached": true
}
]
}
]
}Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.
import { GoldRushClient } from "@covalenthq/client-sdk";
const ApiServices = async () => {
const client = new GoldRushClient("YOUR_API_KEY");
const resp = await client.NftService.getNftsForAddress({chainName: "chainName", walletAddress: "walletAddress"});
console.log(resp.data);
};
ApiServices();{
"address": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"chain_tip_height": 123,
"chain_tip_signed_at": "2023-11-07T05:31:56Z",
"items": [
{
"contract_name": "<string>",
"contract_ticker_symbol": "<string>",
"contract_address": "<string>",
"supports_erc": [
"<string>"
],
"is_spam": true,
"last_transfered_at": "2023-11-07T05:31:56Z",
"block_height": 123,
"balance": "<string>",
"balance_24h": "<string>",
"type": "<string>",
"floor_price_quote": 123,
"pretty_floor_price_quote": "<string>",
"floor_price_native_quote": 123,
"nft_data": [
{
"token_id": "<string>",
"token_url": "<string>",
"original_owner": "<string>",
"current_owner": "<string>",
"external_data": {
"name": "<string>",
"description": "<string>",
"asset_url": "<string>",
"asset_file_extension": "<string>",
"asset_mime_type": "<string>",
"asset_size_bytes": "<string>",
"image": "<string>",
"image_256": "<string>",
"image_512": "<string>",
"image_1024": "<string>",
"animation_url": "<string>",
"external_url": "<string>",
"attributes": [
{
"trait_type": "<string>",
"value": "<string>"
}
],
"thumbnails": {
"image_256": "<string>",
"image_512": "<string>",
"image_1024": "<string>",
"image_opengraph_url": "<string>",
"thumbhash": "<string>"
},
"image_preview": "<string>",
"asset_properties": {
"asset_width": 123,
"asset_height": 123,
"dominant_color": "<string>"
}
},
"asset_cached": true,
"image_cached": true
}
]
}
]
}Related guides
Bearer authentication header of the form: Bearer <token>, where <token> is your GoldRush API Key.
The chain name eg: eth-mainnet.
The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.
If true, the suspected spam tokens are removed. Supported on all Foundational Chains.
If true, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs.
Successful response
The requested address.
The timestamp when the response was generated. Useful to show data staleness to users.
The latest block height of the blockchain at the time this response was provided.
The timestamp of the latest signed block at the time this response was provided.
List of response items.
Show child attributes
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.
Denotes whether the token is suspected spam. Supported on all Foundational Chains.
The timestamp when the token was transferred.
The height of the block.
b;The asset balance. Use contract_decimals to scale this balance for display purposes.
b;The 24h asset balance. Use contract_decimals to scale this balance for display purposes.
The current floor price converted to fiat in quote-currency. The floor price is determined by the last minimum sale price within the last 30 days across all the supported markets where the collection is sold on.
A prettier version of the floor price quote for rendering purposes.
The current floor price in native currency. The floor price is determined by the last minimum sale price within the last 30 days across all the supported markets where the collection is sold on.
Show child attributes
b;The token's id.
The original minter.
The current holder of this NFT.
Show child attributes
Various thumbnails of the asset.
Show child attributes
Resized 256x256 image of the asset.
Resized 512x512 image of the asset.
Resized 1024x1024 image of the asset.
Resized image of the asset for OpenGraph.
Base64 encoded hash of the thumbnail.
The image preview URL.
The asset properties.
If true, the asset data is available from the Covalent CDN.
If true, the image data is available from the Covalent CDN.