GET
/
v1
/
portfolios
/
{portfolio_id}
/
wallets
/
{wallet_id}
/
web3_balances
List Onchain Wallet Balances
curl --request GET \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/web3_balances
{
  "balances": [
    {
      "asset": {
        "network": "<string>",
        "contract_address": "<string>",
        "symbol": "<string>",
        "token_id": "<string>",
        "name": "<string>"
      },
      "amount": "109.42",
      "visibility_status": "UNKNOWN_VISIBILITY_STATUS"
    }
  ],
  "pagination": {
    "next_cursor": "<string>",
    "sort_direction": "DESC",
    "has_next": true
  },
  "defi_balances": [
    {
      "network": "<string>",
      "protocol": "<string>",
      "net_usd_value": "<string>"
    }
  ]
}

Path Parameters

​
portfolio_id
string
required

Portfolio to retrieve balances for.

​
wallet_id
string
required

Onchain wallet to retrieve balances for.

Query Parameters

​
visibility_statuses
enum<string>[]

Visibility statuses to filter balances on. Leaving this field empty will return only VISIBLE balances.

  • UNKNOWN_VISIBILITY_STATUS: nil
  • VISIBLE: Visible
  • HIDDEN: Hidden
  • SPAM: Spam
​
cursor
string

Id to retrieve additional results strictly after

​
limit
integer

Number of items to retrieve. Defaults to 100 with a max size of 500.

Response

A successful response.

​
balances
List of balances in the onchain wallet · object[]
​
pagination
object
​
defi_balances
object[]

DeFi balances only return for the initial request. No pagination support.