Sign in
positions

Get a shareable position with cursor-paginated transactions

Fills are complete grouped transactions, oldest first, ordered by execution time and fill ID. Pass nextCursor for subsequent pages. Total counts all grouped transactions; fees and funding remain lifecycle totals. Open positions may gain transactions between requests. Uses the same public-position access rules as v1.

get/v2/positions/{positionId}

Path parameters

positionIdstring uuid required

Query parameters

limitinteger
cursorstring

Response

Successful response

idstring required
isOpenboolean required
symbolstring required
side'LONG' | 'SHORT' required
sizenumber required
entryPricenumber required
closedPricenumber nullable required
walletAddressstring required
leverageValueinteger required
unrealizedPnlnumber required
realizedPnlnumber required
openedAtstring required
closedAtstring nullable required
totalFeesnumber required
totalFundingnumber required
totalinteger required
nextCursorstring
previousCursorstring
hasMoreboolean required

Changes

Changed in 1 of the 46 revisions of this API.1