Wallet Historical Positions

Get perp positions history for a wallet

get

Retrieve perpetual positions for a specific wallet address with optional token filtering. Defaults to last 7 days of position history. Supports cursor-based pagination.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

addressstringRequired

Wallet address

tokenany ofOptional

Token to filter by (e.g., BTC, ETH)

stringOptional

or

nullOptional

start_timestampany ofOptional

Start timestamp in Unix milliseconds

integerOptional

or

nullOptional

end_timestampany ofOptional

End timestamp in Unix milliseconds

integerOptional

or

nullOptional

limitinteger · min: 1 · max: 1000Optional

Number of records per page

Default: 100

cursorany ofOptional

Pagination cursor from previous response

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/wallets/perp/positions/history

HTTPcURLJavaScriptPython

GET /v1/wallets/perp/positions/history?address=text HTTP/1.1
Host: data.blockliquidity.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "timestamp": 1,
      "address": "text",
      "token": "text",
      "szi": 1,
      "entry_px": 1,
      "position_value": 1,
      "unrealized_pnl": 1,
      "liquidation_px": 1,
      "margin_used": 1,
      "cum_funding_since_open": 1,
      "leverage": 1
    }
  ],
  "pagination": {
    "next_cursor": "text",
    "has_more": true,
    "limit": 1,
    "start_timestamp": 1,
    "end_timestamp": 1
  }
}