Positions across all markets

GET/api/v1/positionsBearer

Trading APIprice E4 · size E2 · amount E6 (integers)YES | NO

Returned in one call, with each row carrying its own marketId. A cross-partition read, so `minCursor` is not supported (passing it returns 400; only single-market endpoints accept it).

Send Authorization: Bearer <token>. The token is issued by POST /api/v1/auth/verify, and expires after 24h idle or 7d after issuance.

Response

200List of positions

The response is an array; the fields below describe each element:

marketIdstring
The market this order belongs to
Example"mkt-0001"
traderstring
The session address, echoed back
Example"0x3f1a9c2e7b4…a7b8c9d0e1f"
balanceE6int64
Margin (1e-6 USD)
Example250000000
yesE2int64
YES shares (1e-2)
Example1000
noE2int64
NO shares (1e-2)
Example1000
chainStateSETTLING | CONFIRMED
SETTLING = there are unconfirmed settlement jobs; CONFIRMED = everything is confirmed
Example"SETTLING"

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X GET "$BASE_URL/api/v1/positions" \
  -H "Authorization: Bearer $TOKEN"

Response

List of positions

[
  {
    "marketId": "mkt-0001",
    "trader": "0x3f1a9c2e7b4d5e6f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f",
    "balanceE6": 250000000,
    "yesE2": 1000,
    "noE2": 1000,
    "chainState": "SETTLING"
  }
]