Skip to main content
GET
Reference example

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.012
  • Cost contract: fixed_success
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50

Max number of positions to return per outcome token

Required range: 0 <= x <= 500
market
string
required

The condition ID of the market to query positions for 0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$
Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

offset
integer
default:0

Pagination offset per outcome token

Required range: 0 <= x <= 10000
sortBy
enum<string>
default:TOTAL_PNL

Sort positions by:

  • TOKENS — Position size (number of tokens)
  • CASH_PNL — Unrealized cash PnL
  • REALIZED_PNL — Realized PnL
  • TOTAL_PNL — Total PnL (cash_pnl + realized_pnl)
Available options:
TOKENS,
CASH_PNL,
REALIZED_PNL,
TOTAL_PNL
sortDirection
enum<string>
default:DESC
Available options:
ASC,
DESC
status
enum<string>
default:ALL

Filter positions by status.

  • OPEN — Only positions with size > 0.01
  • CLOSED — Only positions with size <= 0.01
  • ALL — All positions regardless of size
Available options:
OPEN,
CLOSED,
ALL
user
string

Filter to a single user by proxy wallet address User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

Response

Success

token
string

The outcome token asset ID

positions
object[]