Documentation Index
Fetch the complete documentation index at: https://docs.codex.io/llms.txt
Use this file to discover all available pages before exploring further.
Open trader positions are fully accurate and updated as trades settle on-chain (Polymarket) or via the Kalshi websocket. Both sources are backfilled on reconnect.
Usage Guidelines
- Use this endpoint to display a trader’s open positions and market details.
- Pair with predictionMarketPrice to compute live unrealized PnL on open positions.
- Works across both Polymarket and Kalshi markets supported by Codex.
- For historical performance beyond open positions, combine with predictionTraderMarketsStats (data available from ~Feb 2026, when Codex began indexing).
Troubleshooting Tips
How accurate is this data?
How accurate is this data?
Open trader positions are expected to be fully accurate. Polymarket data is derived from Polygon transaction processing. Kalshi data is sourced via Kalshi’s websocket.
Does this include closed positions or trade history?
Does this include closed positions or trade history?
No. This endpoint returns current holdings only. For historical trade activity, use the predictionTraderMarketsStats endpoint.
Why is a trader's holdings list empty?
Why is a trader's holdings list empty?
Either the trader has no open positions, or the trader address is from a market we don’t index. Confirm the address is active on a supported venue (Polymarket or Kalshi).
Can I compute live unrealized PnL from this response?
Can I compute live unrealized PnL from this response?
Yes. Combine holdings quantities with the latest predictionMarketPrice result for each market.
Related Recipes
- Prediction Traders: Learn how to build trader leaderboards, profiles, and portfolio analytics for prediction market traders