Skip to main content
GET
/
portfolio
/
snapshot
/
items
Get historical portfolio snapshot data with normalized coin balances and portfolio metrics
curl --request GET \
  --url https://openapiv1.coinstats.app/portfolio/snapshot/items \
  --header 'X-API-KEY: <api-key>'
{
  "result": [
    {
      "date": "2025-08-29T10:00:00.000Z",
      "coinBalances": [
        {
          "symbol": "KMNO",
          "icon": "https://static.coinstats.app/coins/kaminobx1.png",
          "quantity": 282.85,
          "balance": 15.7021349,
          "quantityChange": 0,
          "balanceChange": -0.2110061,
          "pricePerUnit": 0,
          "pricePercentChange": 0
        }
      ],
      "totalBalance": 74.137019959,
      "totalBalanceChange": -0.43391738,
      "totalBalancePercentChange": -0.58188537
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

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

Get Share Token

​
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