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