List Portfolio Balances - Coinbase Developer Documentation

List Portfolio Balances

curl --request GET \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/balances

{
  "balances": [
    {
      "symbol": "BTC",
      "amount": "109.42",
      "holds": "2",
      "bonded_amount": "109.42",
      "reserved_amount": "109.42",
      "unbonding_amount": "109.42",
      "unvested_amount": "109.42",
      "pending_rewards_amount": "109.42",
      "past_rewards_amount": "109.42",
      "bondable_amount": "109.42",
      "withdrawable_amount": "109.42",
      "fiat_amount": "109.42",
      "unbondable_amount": "109.42",
      "claimable_rewards_amount": "0.241437903"
    }
  ],
  "trading_balances": {
    "total": "<string>",
    "holds": "<string>"
  },
  "vault_balances": {
    "total": "<string>",
    "holds": "<string>"
  },
  "prime_custody_balances": {
    "total": "<string>",
    "holds": "<string>"
  }
}

GET

portfolios

{portfolio_id}

balances

List Portfolio Balances

curl --request GET \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/balances

{
  "balances": [
    {
      "symbol": "BTC",
      "amount": "109.42",
      "holds": "2",
      "bonded_amount": "109.42",
      "reserved_amount": "109.42",
      "unbonding_amount": "109.42",
      "unvested_amount": "109.42",
      "pending_rewards_amount": "109.42",
      "past_rewards_amount": "109.42",
      "bondable_amount": "109.42",
      "withdrawable_amount": "109.42",
      "fiat_amount": "109.42",
      "unbondable_amount": "109.42",
      "claimable_rewards_amount": "0.241437903"
    }
  ],
  "trading_balances": {
    "total": "<string>",
    "holds": "<string>"
  },
  "vault_balances": {
    "total": "<string>",
    "holds": "<string>"
  },
  "prime_custody_balances": {
    "total": "<string>",
    "holds": "<string>"
  }
}

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

BalancesService balancesService = PrimeServiceFactory.createBalancesService(client);

ListPortfolioBalancesRequest request = new ListPortfolioBalancesRequest.Builder("PORTFOLIO_ID_HERE").build();

ListPortfolioBalancesResponse response = balancesService.listPortfolioBalances(request);

For more information, please visit the Prime Java SDK.

var balancesService = new BalancesService(client);

var request = new ListPortfolioBalancesRequest("PORTFOLIO_ID_HERE");
var response = balancesService.ListPortfolioBalances(request);

For more information, please visit the Prime .NET SDK.

balancesService := balances.NewBalancesService(client)

request := &balances.ListPortfolioBalancesRequest{
    PortfolioId: "PORTFOLIO_ID_HERE",
}

response, err := balancesService.ListPortfolioBalances(context.Background(), request)

For more information, please visit the Prime Go SDK.

prime_client = PrimeClient(credentials)

request = ListPortfolioBalancesRequest(
        portfolio_id="PORTFOLIO_ID_HERE",
)

response = prime_client.list_portfolio_balances(request)

For more information, please visit the Prime Python SDK.

primectl list-portfolio-balances --help

For more information, please visit the Prime CLI.

const balancesService = new BalancesService(client);

balancesService.listPortfolioBalances({
    portfolioId: 'PORTFOLIO_ID_HERE',
    symbols: 'ETH'
}).then(async (response) => {
    console.log('Balances: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id

string

required

The portfolio ID

Query Parameters

symbols

string

A list of symbols by which to filter the response

balance_type

enum<string>

A type by which to filter balances

UNKNOWN_BALANCE_TYPE: nil
TRADING_BALANCES: Trading balances
VAULT_BALANCES: Vault balances
TOTAL_BALANCES: Total balances (The sum of vault and trading + prime custody)
PRIME_CUSTODY_BALANCES: Prime custody balances
UNIFIED_TOTAL_BALANCES: Unified total balance across networks and wallet types (vault + trading + prime custody)

Available options:

TRADING_BALANCES,

VAULT_BALANCES,

TOTAL_BALANCES,

PRIME_CUSTODY_BALANCES,

UNIFIED_TOTAL_BALANCES

Response

200 - application/json

A successful response.

balances

object[]

A list of balances.

Show child attributes

type

enum<string>

Available options:

TRADING_BALANCES,

VAULT_BALANCES,

TOTAL_BALANCES,

PRIME_CUSTODY_BALANCES,

UNIFIED_TOTAL_BALANCES

trading_balances

object

Show child attributes

vault_balances

object

Show child attributes

prime_custody_balances

object

Show child attributes

List Onchain Wallet Balances

Get Portfolio Commission

⌘I