GET /api/v3/brokerage/portfolios — List Portfolios

GET /api/v3/brokerage/portfolios — retrieve all portfolios for the authenticated user, including portfolio UUIDs needed for breakdown requests.

The List Portfolios endpoint returns all portfolios associated with your Coinbase Advanced Trade account. Each portfolio record includes its UUID, display name, type, and deletion status. The uuid field is the key piece of data you’ll need when calling other portfolio endpoints — such as fetching a detailed breakdown of holdings. You can optionally filter the results to a specific portfolio type if your account has multiple portfolio types configured. This endpoint requires authentication.

Endpoint

GET https://api.coinbase.com/api/v3/brokerage/portfolios

Authentication

Required. Include a valid JWT in the Authorization header:

Authorization: Bearer $JWT

Query Parameters

portfolio_type · string

Filter the response to a specific portfolio type. Accepted values:

• DEFAULT — the standard default trading portfolio
• CONSUMER — a consumer-facing portfolio
• INTX — an international exchange portfolio

When omitted, all portfolio types are returned.

Response

portfolios · array

Array of portfolio objects belonging to the authenticated user.

Show Portfolio object fields

uuid · string

Unique identifier for the portfolio. Use this value as the portfolio_uuid path parameter in the Portfolio Breakdown endpoint.

name · string

Display name of the portfolio as set by the user, e.g. "My Trading Portfolio".

type · string

Portfolio type: DEFAULT, CONSUMER, or INTX.

deleted · boolean

true if the portfolio has been deleted. Deleted portfolios may still appear in historical records.

Examples

cURL

curl https://api.coinbase.com/api/v3/brokerage/portfolios \
  -H "Authorization: Bearer $JWT"

Response

{
  "portfolios": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Default Portfolio",
      "type": "DEFAULT",
      "deleted": false
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Altcoin Strategy",
      "type": "CONSUMER",
      "deleted": false
    },
    {
      "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "name": "Old Portfolio",
      "type": "DEFAULT",
      "deleted": true
    }
  ]
}