Portfolios

Get position history

Retrieve history of closed positions including entry/exit prices, realized PnL, and fees.

Requires authentication.

GET
/positions/history

Authorization

ApiKeyAuth ApiSignatureAuth ApiTimestampAuth
x-api-key<token>

API key for authentication

In: header

x-api-signature<token>

HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))

In: header

x-api-timestamp<token>

Unix timestamp in seconds

In: header

Query Parameters

mkt_id?string

Filter by market ID (optional).

start_ts?string

Start timestamp in nanoseconds for filtering positions by close time (updated_at), inclusive. If omitted, no lower bound is applied.

Formatint64
end_ts?string

End timestamp in nanoseconds for filtering positions by close time (updated_at), exclusive. If omitted, no upper bound is applied.

Formatint64
lmt?integer

Maximum results to return (default: 100, max: 1000).

Formatint32
sorted_by?string

Sort by field. Prefix with "-" for descending. Accepts API field names or DB column names: crt_ts/created_at, upd_ts/updated_at. Default: unsorted.

Response Body

application/json