Endpoints
| Method | Endpoint | Description |
|---|
GET | /v1/valuations/positions | List position valuations (mark-to-market) |
GET | /v1/valuations/positions/download | Download position valuations as CSV |
POST | /v1/valuations/accounts/download | Batch download multi-account CSV |
Mark Price Types
| Type | Description |
|---|
MARK_PRICE_TYPE_LAST | Last traded price (default) |
MARK_PRICE_TYPE_VWAP | Volume-weighted average price (notional / volume) |
MARK_PRICE_TYPE_MID | Mid price ((high + low) / 2) |
Valuation Data
Each position valuation includes:
| Field | Description |
|---|
netPosition | Current net position quantity |
cost | Total cost basis (scaled integer) |
markPrice | Mark price used for valuation |
marketValue | Position market value = net_position x mark_price |
unrealizedPnl | Unrealized P&L = market_value - cost |
realized | Realized profit/loss |
valuationTime | Time of valuation |
Account Summary
The response includes an account-level summary with:
| Field | Description |
|---|
totalCost | Sum of all position costs |
totalMarketValue | Sum of all position market values |
totalUnrealizedPnl | Sum of all unrealized P&L |
totalRealizedPnl | Sum of all realized P&L |
positionCount | Number of positions |
Historical Valuations
Query valuations as they existed at a specific point in time:
| Parameter | Type | Description |
|---|
as_of_time | RFC3339 timestamp | Exact point-in-time (e.g., 2026-01-02T17:00:00Z) |
as_of_date | Date object | End-of-trading-day snapshot (year, month, day) |
Mutually Exclusive: Use as_of_time OR as_of_date, not both.
Position-Level vs Account-Level
| Use Case | Endpoint |
|---|
| Full position detail with MTM | GET /v1/valuations/positions |
| Export all positions to spreadsheet | GET /v1/valuations/positions/download |
| Multi-account book-close export | POST /v1/valuations/accounts/download |
Account-Level Valuations
Account-level endpoints return MTM totals without individual position rows. Use these for book-close accounting and balance reporting when you don’t need per-position detail.
POST /v1/valuations/accounts/download - CSV with one row per account
