Portfolios
Get Portfolio Breakdown
REST API
- Introduction
- Accounts
- Convert
- Data API
- Fees
- Futures
- Orders
- Payment Methods
- Perpetuals
- Portfolios
- Products
- Public
Portfolios
Get Portfolio Breakdown
Get the breakdown of a portfolio.
GET
/
api
/
v3
/
brokerage
/
portfolios
/
{portfolio_uuid}
Copy
Ask AI
curl --request GET \
--url https://api.coinbase.com/api/v3/brokerage/portfolios/{portfolio_uuid}
Copy
Ask AI
{
"breakdown": {
"portfolio": {
"name": "<string>",
"uuid": "<string>",
"type": "<any>",
"deleted": true
},
"portfolio_balances": {
"total_balance": {
"value": "<string>",
"currency": "<string>"
},
"total_futures_balance": {
"value": "<string>",
"currency": "<string>"
},
"total_cash_equivalent_balance": {
"value": "<string>",
"currency": "<string>"
},
"total_crypto_balance": {
"value": "<string>",
"currency": "<string>"
},
"futures_unrealized_pnl": {
"value": "<string>",
"currency": "<string>"
},
"perp_unrealized_pnl": {
"value": "<string>",
"currency": "<string>"
}
},
"spot_positions": [
{
"asset": "<string>",
"account_uuid": "<string>",
"total_balance_fiat": 123,
"total_balance_crypto": 123,
"available_to_trade_fiat": 123,
"allocation": 123,
"cost_basis": {
"value": "<string>",
"currency": "<string>"
},
"asset_img_url": "<string>",
"is_cash": true,
"average_entry_price": {
"value": "<string>",
"currency": "<string>"
},
"asset_uuid": "<string>",
"available_to_trade_crypto": 123,
"unrealized_pnl": 123,
"available_to_transfer_fiat": 123,
"available_to_transfer_crypto": 123,
"asset_color": "<string>",
"account_type": "<any>"
}
],
"perp_positions": [
{
"product_id": "<string>",
"product_uuid": "<string>",
"symbol": "<string>",
"asset_image_url": "<string>",
"vwap": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"position_side": "<any>",
"net_size": "<string>",
"buy_order_size": "<string>",
"sell_order_size": "<string>",
"im_contribution": "<string>",
"unrealized_pnl": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"mark_price": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"liquidation_price": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"leverage": "<string>",
"im_notional": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"mm_notional": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"position_notional": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"margin_type": "<any>",
"liquidation_buffer": "<string>",
"liquidation_percentage": "<string>",
"asset_color": "<string>"
}
],
"futures_positions": [
{
"product_id": "<string>",
"contract_size": "<string>",
"side": "<any>",
"amount": "<string>",
"avg_entry_price": "<string>",
"current_price": "<string>",
"unrealized_pnl": "<string>",
"expiry": "<string>",
"underlying_asset": "<string>",
"asset_img_url": "<string>",
"product_name": "<string>",
"venue": "<string>",
"notional_value": "<string>",
"asset_color": "<string>",
"last_traded_at": "<string>"
}
]
}
}
Path Parameters
The portfolio UUID.
Query Parameters
The currency symbol (e.g. USD).
Response
200
application/json
A successful response.
The response is of type object
.
Was this page helpful?
Copy
Ask AI
curl --request GET \
--url https://api.coinbase.com/api/v3/brokerage/portfolios/{portfolio_uuid}
Copy
Ask AI
{
"breakdown": {
"portfolio": {
"name": "<string>",
"uuid": "<string>",
"type": "<any>",
"deleted": true
},
"portfolio_balances": {
"total_balance": {
"value": "<string>",
"currency": "<string>"
},
"total_futures_balance": {
"value": "<string>",
"currency": "<string>"
},
"total_cash_equivalent_balance": {
"value": "<string>",
"currency": "<string>"
},
"total_crypto_balance": {
"value": "<string>",
"currency": "<string>"
},
"futures_unrealized_pnl": {
"value": "<string>",
"currency": "<string>"
},
"perp_unrealized_pnl": {
"value": "<string>",
"currency": "<string>"
}
},
"spot_positions": [
{
"asset": "<string>",
"account_uuid": "<string>",
"total_balance_fiat": 123,
"total_balance_crypto": 123,
"available_to_trade_fiat": 123,
"allocation": 123,
"cost_basis": {
"value": "<string>",
"currency": "<string>"
},
"asset_img_url": "<string>",
"is_cash": true,
"average_entry_price": {
"value": "<string>",
"currency": "<string>"
},
"asset_uuid": "<string>",
"available_to_trade_crypto": 123,
"unrealized_pnl": 123,
"available_to_transfer_fiat": 123,
"available_to_transfer_crypto": 123,
"asset_color": "<string>",
"account_type": "<any>"
}
],
"perp_positions": [
{
"product_id": "<string>",
"product_uuid": "<string>",
"symbol": "<string>",
"asset_image_url": "<string>",
"vwap": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"position_side": "<any>",
"net_size": "<string>",
"buy_order_size": "<string>",
"sell_order_size": "<string>",
"im_contribution": "<string>",
"unrealized_pnl": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"mark_price": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"liquidation_price": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"leverage": "<string>",
"im_notional": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"mm_notional": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"position_notional": {
"userNativeCurrency": {
"value": "<string>",
"currency": "<string>"
},
"rawCurrency": {
"value": "<string>",
"currency": "<string>"
}
},
"margin_type": "<any>",
"liquidation_buffer": "<string>",
"liquidation_percentage": "<string>",
"asset_color": "<string>"
}
],
"futures_positions": [
{
"product_id": "<string>",
"contract_size": "<string>",
"side": "<any>",
"amount": "<string>",
"avg_entry_price": "<string>",
"current_price": "<string>",
"unrealized_pnl": "<string>",
"expiry": "<string>",
"underlying_asset": "<string>",
"asset_img_url": "<string>",
"product_name": "<string>",
"venue": "<string>",
"notional_value": "<string>",
"asset_color": "<string>",
"last_traded_at": "<string>"
}
]
}
}
Assistant
Responses are generated using AI and may contain mistakes.