Endpoints
| Method | Endpoint | Description |
|---|
GET | /v1/valuations/positions | List position valuations (mark-to-market) |
GET | /v1/valuations/positions/download | Download position valuations as CSV |
GET | /v1/valuations/accounts | Get account-level MTM summary |
GET | /v1/valuations/accounts/download | Download account summary as CSV |
POST | /v1/valuations/accounts:batchGet | Batch get multi-account summaries |
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 |
| Single account book-close (totals only) | GET /v1/valuations/accounts |
| Multi-account book-close | POST /v1/valuations/accounts:batchGet |
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.
Single Account:
GET /v1/valuations/accounts - Returns account summary onlyGET /v1/valuations/accounts/download - CSV with single summary row
Multi-Account (Batch):
POST /v1/valuations/accounts:batchGet - Query multiple accounts in one callPOST /v1/valuations/accounts/download - CSV with one row per account
Batch Operations
The batch endpoints support partial success. If some accounts are valid and others are not:
- Valid accounts return their summaries in the
summaries array
- Invalid accounts return errors in the
errors array with account name, error code, and message
This allows you to process results for valid accounts without failing the entire request.
