Skip to main content

​
Historical list REST success envelope

Historical list envelopes are used by the partner feed, events, messages, position history, and generated summary reads.

​
Open positions REST success envelope

Open positions use the same outer envelope, but data.meta only contains:
  • hasMore
  • nextCursor

​
Stats REST success envelope

Stats responses use the same outer envelope and return:
  • filtersApplied
  • results
  • meta.requestedTraderIds and meta.missingTraderIds for trader stats
  • meta.requestedAssetIds and meta.missingAssetIds for asset stats
The applied time bounds for stats reads are returned in data.filtersApplied.appliedTimeRange.

​
REST error envelope

​
MCP mapping

  • MCP list tools return structured content with the same results and meta shape as the matching REST reads.
  • MCP stats tools return the same filtersApplied, results, and meta shape as the matching REST reads.
  • MCP errors are returned through the MCP response model instead of the REST envelope.
  • Preserve the REST requestId when debugging HTTP failures with Centaur support.

​
Current-price freshness

Open-position rows include current mark fields when pricing is available. They do not currently include a separate priceAsOf timestamp. Treat current marks as best-effort live marks for the request, not as audited settlement prices.

​
Price denomination

Prices are denominated in the quote currency of the asset’s preferred market, exposed as a nullable quoteSymbol field (for example USDT, USDC, or CAD) on position and event payloads. Do not assume every price is in US dollars: assets on non-USD markets, such as TSX equities quoted in CAD, report prices in their native quote currency. quoteSymbol reflects the asset’s current preferred market rather than the market the trade originally executed on, so treat it as the display denomination for the row’s price fields.
Last modified on August 3, 2026