Skip to main content
GET
Get a list of your own portfolios
5 credits per request

  • Your own portfolios (personal and API-created); watchlist portfolios are excluded
  • Each item includes portfolioId, portfolioName and portfolioType (manual, exchange, wallet, …)
  • Use the returned portfolioId on any portfolio endpoint (value, coins, chart, transactions, snapshot, transaction)
  • Transactions can be added only to portfolios with portfolioType manual
  • No pagination: returns all portfolios in a single response
  • By default only top-level portfolios are listed. Pass includeChildren=true to nest each portfolio’s child portfolios in children, to every level (for example the exchange or per-chain portfolios under a connection)
  • Child portfolioIds work on the value, coins, chart and transactions endpoints; snapshots cover top-level portfolios and their direct children. Other endpoints, such as perpetual positions and trades, can return child portfolioIds; includeChildren=true shows which listed portfolio each belongs to

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

includeChildren
boolean
default:false

When true, each portfolio includes its child portfolios in children, nested to every level (for example the exchange or per-chain portfolios under a connection). Hierarchies deeper than 32 levels return an error. Accepted values: true, false, 1, 0. Defaults to false.

Example:

true

Response

Your own portfolios (personal and API-created); watchlist portfolios are excluded

result
object[]
required

Your own portfolios (personal and API-created); watchlist portfolios are excluded.