Trades API
Trades are user-owned fill history and analytics. Every operation requires a
user-owned key with read.
Operations
| Method | Path | Required scope | Purpose |
|---|---|---|---|
GET | /v1/trades | read | List matching fills |
GET | /v1/trades/analytics | read | Compute aggregate trade performance |
GET | /v1/trades/positions | read | Compute one strategy's open positions from fills |
GET | /v1/trades/strategies | read | List strategy IDs present in the user's fills |
Fill pagination
GET /v1/trades returns a JSON array directly. Filter by exchange, symbol,
account, strategy, and ISO date bounds. Pagination uses limit and offset;
read X-Total-Count and the RFC 5988 Link header for next/previous pages.
Do not expect a {trades,total} wrapper.
When account_id is supplied, ownership is checked before reading fills.
Analytics and positions
analytics supports a bounded period or explicit from/to dates plus
exchange, account, and strategy filters. Its metrics describe persisted fills,
not current venue positions.
positions requires strategy_id and calculates the strategy's current net
position with FIFO matching. It is not an account-wide broker position feed.
Use the Accounts or Portfolio API for current venue-owned positions.
strategies returns typed {strategy_id,label} rows under the strategies
field. Use those IDs as filters; do not infer them from display labels.