v1

latestOpenAPI 3.1.0UNLICENSED2026-07-26216788.0 KB
Positions

GetOpenPositions

Returns all currently open positions for one wallet, across all markets. address is required (matched trimmed and case-insensitively). Results are ordered by timestamp descending, most recent first.

Unlike the portfolio path, associated orders are loaded as lightweight references only — see associatedOrderIds on the Position schema, not associatedOrders.

post/position_service.v1.PositionService/GetOpenPositions

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol. If omitted, use 1.

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

addressstring required

Wallet address to fetch open positions for. Trimmed and matched case-insensitively.

Response

Success

Example response

{
  "positions": [
    {
      "timestamp": "2023-01-15T01:30:15.01Z",
      "associatedOrders": [
        {
          "timestamp": "2023-01-15T01:30:15.01Z"
        }
      ]
    }
  ]
}