Logo
Covalent API Documentation

getTokenBalancesForWalletAddress

GET https://api.covalenthq.com/v1/:chainName/address/:walletAddress/balances_v2/?quote-currency=&nft=&no-nft-fetch=&no-spam=&no-nft-asset-metadata=

Returns: BalancesResponse

{
  "address" : "{{STRING}}",
  "chain_id" : "{{INTEGER}}",
  "chain_name" : "{{STRING}}",
  "quote_currency" : "{{STRING}}",
  "updated_at" : "{{DATETIME}}",
  "next_update_at" : "{{DATETIME}}",
  "items" : [ {
    "contract_decimals" : "{{INTEGER}}",
    "contract_name" : "{{STRING}}",
    "contract_ticker_symbol" : "{{STRING}}",
    "contract_address" : "{{STRING}}",
    "contract_display_name" : "{{STRING}}",
    "supports_erc" : [ "{{STRING}}" ],
    "logo_url" : "{{STRING}}",
    "logo_urls" : {
      "token_logo_url" : "{{STRING}}",
      "protocol_logo_url" : "{{STRING}}",
      "chain_logo_url" : "{{STRING}}"
    },
    "last_transferred_at" : "{{DATETIME}}",
    "native_token" : "{{BOOLEAN}}",
    "type" : "{{STRING}}",
    "is_spam" : "{{BOOLEAN}}",
    "balance" : "{{STRING}}",
    "balance24h" : "{{STRING}}",
    "quote_rate" : "{{DOUBLE}}",
    "quote_rate24h" : "{{DOUBLE}}",
    "quote" : "{{DOUBLE}}",
    "quote24h" : "{{DOUBLE}}",
    "pretty_quote" : "{{STRING}}",
    "pretty_quote24h" : "{{STRING}}",
    "protocol_metadata" : {
      "protocol_name" : "{{STRING}}"
    },
    "nft_data" : [ {
      "token_id" : "{{STRING}}",
      "token_url" : "{{STRING}}",
      "original_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}}",
        "image256" : "{{STRING}}",
        "image512" : "{{STRING}}",
        "image1024" : "{{STRING}}",
        "animation_url" : "{{STRING}}",
        "external_url" : "{{STRING}}",
        "attributes" : [ {
          "trait_type" : "{{STRING}}",
          "value" : "{{STRING}}"
        } ]
      },
      "asset_cached" : "{{BOOLEAN}}",
      "image_cached" : "{{BOOLEAN}}"
    } ]
  } ]
}

 

Body PARAM

Key Datatype Required Description 
quote-currency
null
nft
null
no-nft-fetch
null
no-spam
null
no-nft-asset-metadata
null


Curl
curl -X GET 'https://api.covalenthq.com/v1/:chainName/address/:walletAddress/balances_v2/?quote-currency=&nft=&no-nft-fetch=&no-spam=&no-nft-asset-metadata=?quote-currency=&nft=&no-nft-fetch=&no-spam=&no-nft-asset-metadata=' -H 'Content-Type: application/json'

ENDPOINTS