API Reference
Positions
Read your running position per market. Returns 200 today with sample positions for layout; real position tracking lands when settlement does.
Heads up
Position tracking is currently STUB — the endpoint responds 200 with deterministic sample data so the UI can render. Real positions land in Phase B once settlement is wired to the on-chainTaifoonReactor./book/v1/positionsSTUB
Returns the position list for an attribution string.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| attribution | string | yes | Identity to query. |
Response
| Field | Type | Required | Description |
|---|---|---|---|
| positions | array | no | One entry per market with non-zero size. |
| positions[].market | string | no | e.g. "BTC-PERP". |
| positions[].side | string | no | "long" | "short". |
| positions[].size | string | no | Decimal string in base units. |
| positions[].avg_entry | string | no | VWAP across opening fills. |
| positions[].unrealised_pnl | string | no | Marked at current book mid. |
Code
curl -s 'https://api.taifoon.dev/book/v1/positions?attribution=bot-demo' | jq