v1

latestOpenAPI 3.1.0UNLICENSED2026-07-26216788.0 KB

Positions

GetOpenPositionsStreaming

Server-streaming endpoint. Opens a long-lived Connect/gRPC-Web stream and sends a GetOpenPositionsStreamingResponse message immediately, then again on a fixed interval, until the client disconnects. Each message is a full snapshot of the wallet's currently open positions, not a diff.

update_interval_ms defaults to 250ms when omitted, and is clamped to the 100–60000ms range rather than rejected.

NOTE: Mintlify's request-based API explorer cannot exercise a real streaming response.

post/position_service.v1.PositionService/GetOpenPositionsStreaming

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 stream open positions for. Trimmed and matched case-insensitively.

updateIntervalMsinteger nullable

Interval between stream updates, in milliseconds. Defaults to 250 when omitted or zero, and is clamped to the 100–60000 range.

Response

One streamed message (the server sends a sequence of these, not a single response).

Example response

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