Skip to main content
GET
Get historical portfolio snapshot data with normalized coin balances and portfolio metrics
500 credits per request

  • Historical coin quantities and balances over time
  • Total portfolio balance tracking with changes
  • Price changes and quantity changes between snapshots
  • Filterable by date range and specific coins
  • shareToken OR portfolioId: Provide one of these to identify the portfolio.
    • shareToken: Get this from your CoinStats portfolio page by clicking “Share”
    • portfolioId: Use a portfolio connected via POST /portfolio/wallet or POST /portfolio/exchange
  • If neither is provided, returns snapshot data for all API-connected portfolios
  • from & to: Date range filter (YYYY-MM-DD format)
  • coinIds: Comma-separated list of coin IDs to filter by
  • page & limit: Pagination controls
  • passcode: Passcode for accessing protected portfolio data (can be passed in header or query parameter)

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.

Headers

sharetoken
string
passcode
string

Passcode for accessing protected portfolio data

Example:

"123456"

Query Parameters

page
number

Page number to retrieve (1-based indexing)

Example:

1

limit
number

Number of items to return per page

Example:

20

portfolioId
string

Portfolio ID for accessing a specific API-connected portfolio. Required if shareToken is not provided.

Example:

"abc123def456"

from
string

Start date for snapshot data (YYYY-MM-DD format)

Example:

"2024-01-01"

to
string

End date for snapshot data (YYYY-MM-DD format)

Example:

"2024-12-31"

coinIds
string

Comma-separated list of coin IDs to filter by

Example:

"bitcoin,ethereum,cardano"

Response

Portfolio Snapshot Items

result
object[]
required

Array of portfolio snapshots ordered chronologically