---
title: "GET /v1/allchains/address/{walletAddress}/balances/"
method: GET
path: "/v1/allchains/address/{walletAddress}/balances/"
tags: ["get-allchains-balances"]
---

# GET /v1/allchains/address/{walletAddress}/balances/

`GET /v1/allchains/address/{walletAddress}/balances/`

## Request

- Base URL: `https://api.covalenthq.com`
- URL: `https://api.covalenthq.com/v1/allchains/address/{walletAddress}/balances/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/docs/v1/allchains/address/:walletAddress/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.

## Path parameters

- `walletAddress` string, required

## Query parameters

- `chains` string
- `limit` integer
- `before` string
- `cutoff-timestamp` integer
- `quote-currency` string

## Response `200`

Successful response

- object
  - `updated_at` string, date-time: Timestamp for when the data was last updated.
  - `cursor_before` string: Pagination cursor pointing to the previous page.
  - `quote_currency` string: The requested quote currency eg: `USD`.
  - `items` object[]: List of token balances returned by the API.
    - `contract_decimals` integer: Use contract decimals to format the balance for display purposes - divide the balance by `10^{contract_decimals}`.
    - `contract_name` string: The string returned by the `name()` method.
    - `contract_ticker_symbol` string: The ticker symbol for this contract. This field is set by a developer and non-unique across a network.
    - `contract_address` string: Use the relevant `contract_address` to lookup prices, logos, token transfers, etc.
    - `contract_display_name` string: A display-friendly name for the contract.
    - `supports_erc` string[]: A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`.
    - `logo_urls` object: The contract logo URLs.
      - `token_logo_url` string: The token logo URL.
      - `protocol_logo_url` string: The protocol logo URL.
      - `chain_logo_url` string: The chain logo URL.
    - `last_transferred_at` string, date-time: The timestamp when the token was transferred.
    - `is_native_token` boolean: Indicates if a token is the chain's native gas token, eg: ETH on Ethereum.
    - `type` string: One of `cryptocurrency`, `stablecoin`, `nft` or `dust`.
    - `is_spam` boolean: Denotes whether the token is suspected spam.
    - `balance` string: b;The asset balance. Use `contract_decimals` to scale this balance for display purposes.
    - `balance_24h` string: b;The 24h asset balance. Use `contract_decimals` to scale this balance for display purposes.
    - `quote_rate` number, double: The exchange rate for the requested quote currency.
    - `quote_rate_24h` number, double: The 24h exchange rate for the requested quote currency.
    - `quote` number, double: The current balance converted to fiat in `quote-currency`.
    - `quote_24h` number, double: The 24h balance converted to fiat in `quote-currency`.
    - `pretty_quote` string: A prettier version of the quote for rendering purposes.
    - `pretty_quote_24h` string: A prettier version of the 24h quote for rendering purposes.
    - `chain_id` integer: The chain ID that this balance is on. eg: `1`.
    - `chain_name` string: The chain name that this balance is on. eg: `eth-mainnet`.
    - `chain_display_name` string: A display-friendly name for the chain.

---

[API](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis.md) - [All operations](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/revisions/31713d2c30bc?raw)