Headers

• PRE-ACCESS-KEY string Required

  Broker access key identifier.

  Format should match the following pattern: ^[A-Za-z0-9._~-]{1,64}$.

• PRE-ACCESS-SIGNATURE string Required

  Keyed BLAKE2b-256 signature (hex lowercase, 64 characters).

  Format should match the following pattern: ^[0-9a-f]{64}$.

• PRE-ACCESS-TIMESTAMP string(date-time) Required

  RFC3339 timestamp with milliseconds (e.g., 2025-10-30T06:00:34.075Z). Must be within clock_skew_tolerance (default 5m) of server time.

Path parameters

• account_id string Required

  Broker-supplied account identifier; length 1..128; charset [A-Za-z0-9._~-].

  Maximum length is 128. Format should match the following pattern: ^[A-Za-z0-9._~-]{1,128}$.

Query parameters

• market_id string
• event_id string
• status string

  Filter by position status. OPEN (default) returns only non-zero qty; ALL returns settled/closed positions as well.

  Values are OPEN or ALL. Default value is OPEN.

• presentation string

  Presentation mode for positions.

  • dual: returns separate yes_qty and no_qty.
  • net: returns a single net quantity (yes_qty - no_qty).

  Values are dual or net. Default value is net.

• cursor string
• limit integer

  Minimum value is 1, maximum value is 100. Default value is 50.

Responses

• 200 application/json

  Position list

  One of:

  DualPositionList object NetPositionList object

  Hide attributes Show attributes

  • items array[object] Required
    Hide items attributes Show items attributes object

    • account_id string Required
    • market_id string Required
    • yes_qty object Required

      Balance in YES contracts

      Hide yes_qty attributes Show yes_qty attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • no_qty object Required

      Balance in NO contracts

      Hide no_qty attributes Show no_qty attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • yes_reserved object Required

      YES contracts reserved in active limit orders

      Hide yes_reserved attributes Show yes_reserved attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • no_reserved object Required

      NO contracts reserved in active limit orders

      Hide no_reserved attributes Show no_reserved attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • realized_pnl object Required

      Realized profit/loss from closed trades, merges AND settlement payouts

      Hide realized_pnl attributes Show realized_pnl attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • fees_paid object Required

      Total fees paid on this market

      Hide fees_paid attributes Show fees_paid attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • last_update_wall_time_ns integer(int64) Required
    • last_update_engine_seq integer(int64)
  • next_cursor string | null

  Hide attributes Show attributes

  • items array[object] Required
    Hide items attributes Show items attributes object

    • account_id string Required
    • market_id string Required
    • qty object Required

      Net position (yes_qty - no_qty).

      Hide qty attributes Show qty attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • yes_reserved object Required

      YES contracts reserved in active limit orders

      Hide yes_reserved attributes Show yes_reserved attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • no_reserved object Required

      NO contracts reserved in active limit orders

      Hide no_reserved attributes Show no_reserved attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • realized_pnl object Required

      Realized profit/loss from closed trades, merges AND settlement payouts

      Hide realized_pnl attributes Show realized_pnl attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • fees_paid object Required

      Total fees paid on this market

      Hide fees_paid attributes Show fees_paid attributes object

      • units integer(int64) Required
      • nanos integer(int32) Required

        Minimum value is -999999999, maximum value is 999999999.

    • last_update_wall_time_ns integer(int64) Required
    • last_update_engine_seq integer(int64)
  • next_cursor string | null
• 400 application/json

  Validation / semantic error

  Hide response attributes Show response attributes object

  • error_code string Required
  • message string Required
  • details object

    Additional properties are allowed.

• 503 application/json

  Backpressure / temporary unavailability

  Hide response attributes Show response attributes object

  • error_code string Required
  • message string Required
  • details object

    Additional properties are allowed.