Skip to main content
GET
Get portfolio chart data

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

account
string
required

User account address (user query alias is also accepted)

range
enum<string>
required

Time range for chart data

Available options:
24h,
7d,
30d,
90d,
all
data_type
enum<string>
required

Data type: pnl or account_value

Available options:
pnl,
account_value

Response

Portfolio chart data retrieved successfully

data_points
number<double>
required
timestamp
integer<int64>
required
spot_pnl
number<double> | null

Spot PnL (unrealized + realized) at this snapshot. A sidecar like spot_value, so data_points stays perp-only and the caller composes the combined cut. 0 for snapshots predating the columns (NULL in ClickHouse); None for the account_value data_type.

spot_value
number<double> | null

Spot holdings value (USD) at this snapshot, from spot_value_snapshots. NOT included in data_points: data_points stays the canonical perp Portfolio Value (perp equity + free vault equity) because vault NAV, the leaderboard, and the DLP oracle bind to that meaning. The "Perps + Spot" cut is data_points + spot_value, composed by the caller under a distinct name. 0 when no spot value is recorded at this timestamp (including all history before the spot recorder deployed — same JOIN-miss semantics as vault_equity); None for the PnL data_type.

vault_equity
number<double> | null

Vault equity: user's proportional share of vault NAV(s). None for users with no vault deposits, or for PnL data_type.