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 time in nanoseconds (optional).

Formatint64
end_ts?string

End time in nanoseconds (optional).

Formatint64
lmt?integer

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

Formatint32
sorted_by?string

Sort by field. Prefix with "-" for descending. Valid values: "created_at", "-created_at", "updated_at", "-updated_at". Default: unsorted.

Response Body

application/json