Skip to main content
GET
Position events
A position-activity feed of opened, closed, increased, reduced, and flipped events. Filter by type, instrument, min_notional, address, liquidation, and after. Responses are newest first and include has_more plus an opaque next_cursor. Send that value as cursor with the same filters to continue through the fixed traversal:
Cursors expire after 24 hours and cannot be reused on the liquidations route. A malformed cursor returns HTTP 400 with {"error":"invalid cursor"}. An expired cursor returns {"error":"cursor has expired"}. Changing a filter returns HTTP 400 with a clean cursor-mismatch message. Start again without the cursor in each case.

Authorizations

x-api-key
string
header
required

Query Parameters

type
string

opened | closed | increased | reduced | flipped

instrument
string

Instrument id/symbol/asset.

min_notional
number

Only events >= this USD size.

address
string

One account.

liquidation
boolean

true | false

after
string

Only rows after this time (Unix s or ms).

limit
integer

Max rows.

cursor
string

Opaque next_cursor from the preceding page. Reuse the same route and filters within 24 hours.

Response

Success