---
title: "GET /v1/{chainName}/address/{walletAddress}/portfolio_v2/"
method: GET
path: "/v1/{chainName}/address/{walletAddress}/portfolio_v2/"
tags: ["get-historical-portfolio-value-over-time"]
---

# GET /v1/{chainName}/address/{walletAddress}/portfolio_v2/

`GET /v1/{chainName}/address/{walletAddress}/portfolio_v2/`

## Request

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

Returns a daily portfolio balance for an address, broken down by token. The timeframe is user-configurable and defaults to 30 days.

## Path parameters

- `chainName` string, required
- `walletAddress` string, required

## Query parameters

- `quote-currency` string
- `days` integer

## Response `200`

Successful response

- object
  - `address` string: The requested address.
  - `updated_at` string, date-time: The timestamp when the response was generated. Useful to show data staleness to users.
  - `quote_currency` string: The requested quote currency eg: `USD`.
  - `chain_id` integer: The requested chain ID eg: `1`.
  - `chain_name` string: The requested chain name eg: `eth-mainnet`.
  - `items` object[]: List of response items.
    - `contract_address` string: Use the relevant `contract_address` to lookup prices, logos, token transfers, etc.
    - `contract_decimals` integer: Use contract decimals to format the token 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.
    - `logo_url` string: The contract logo URL.
    - `holdings` object[]
      - `quote_rate` number, double: The exchange rate for the requested quote currency.
      - `timestamp` string, date-time
      - `close` object
        - `balance` string: b;The asset balance. Use `contract_decimals` to scale this balance for display purposes.
        - `quote` number, double: The current balance converted to fiat in `quote-currency`.
        - `pretty_quote` string: A prettier version of the quote for rendering purposes.
      - `high` object
      - `low` object
      - `open` object

---

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