DEV · local workspace

Post-fill records

A fill updates the desk's order progress and position and creates the trade-fee record shown by the statement routes. These records preserve exact prices and amounts.

Execution record

GET /api/v1/fills reports each execution from the selected desk's side. Spot fills carry integer size_tokens; forward fills carry decimal-string size_mft. price and notional_usd are exact decimal strings.

GET /api/v1/positions reports the net product position and optional average price after those fills. Keep instrument symbols intact when aggregating so unlike model, provider, bundle, or term products are not combined.

Fee record

A fee line names the trade, instrument, desk order, liquidity role, product, applied rate, notional, contract count, signed fee, and accrual time. The applied-rate object retains the basis and any minimum or maximum used for that line.

A negative fee is a rebate. A null applied rate is unpriced and should not be displayed as free.

Period statement

GET /api/v1/statements?period_start={time}&period_end={time} returns exact totals and itemized trade and listing lines for the selected desk. net_due_usd is the cent-rounded presentation amount; net_usd retains full accrual precision.

When lines_truncated is true, totals still cover the whole requested period even though the trade-line itemization reached its response ceiling.