GET
/
v1
/
{chainName}
/
address
/
{walletAddress}
/
balances_nft
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",
  "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",
      "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
        }
      ]
    }
  ]
}

Credit Cost

1 per call

Processing

Realtime

Path Parameters

​
chainName
string
required

The chain name eg: eth-mainnet.

​
walletAddress
string
required

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

Query Parameters

​
no-spam
boolean

If true, the suspected spam tokens are removed. Supports eth-mainnet and matic-mainnet.

​
no-nft-asset-metadata
boolean

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.

​
with-uncached
boolean

By default, this endpoint only works on chains where we've cached the assets and the metadata. When set to true, the API will fetch metadata from upstream servers even if it's not cached - the downside being that the upstream server can block or rate limit the call and therefore resulting in time outs or slow response times on the Covalent side.

Response

200 - application/json
Successful response
​
address
string

The requested address.

​
updated_at
string

The timestamp when the response was generated. Useful to show data staleness to users.

​
items
object[]

List of response items.