Skip to main content
GET
Get wallet portfolio snapshots

Authorizations

Authorization
string
header
required

Cognito JWT token for regular user authentication

Query Parameters

range
enum<string>
Available options:
1d,
7d,
30d,
90d,
1y,
all

Response

Portfolio snapshot history for the authenticated user's wallets. changeUsd and changePercent are simple balance deltas, not P&L. New users with no history return latest/baseline as null and points empty.

Portfolio snapshot history for the authenticated user's wallets. changeUsd and changePercent are simple balance deltas, not P&L. New users with no history return latest/baseline as null and points empty.

range
enum<string>
required
Available options:
1d,
7d,
30d,
90d,
1y,
all
latest
object | null
required

Newest snapshot inside the requested range, or null when no snapshots exist.

baseline
object | null
required

Oldest snapshot inside the requested range, or null when no snapshots exist.

changeUsd
string | null
required

Simple USD balance delta between baseline and latest, formatted to two decimal places. Not P&L. Null when history is empty.

Example:

"12.34"

changePercent
string | null
required

Simple percentage change between baseline and latest balance, formatted to two decimal places. Not P&L. Null when history is empty or baseline balance is zero.

Example:

"1.23"

points
object[]
required

Snapshot points inside the requested range, ordered by bucketStart. Empty when no history exists.