Skip to main content

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.

Prediction Market data is currently in beta. It is actively being worked on and improved, but may be unreliable. Polymarket and Kalshi data are live.At least for the time being, this endpoint requires a Growth or Enterprise plan. Learn more.
Kalshi does not provide trader data. These endpoints only work with Polymarket data. Kalshi’s API does not expose individual trader information due to privacy considerations on their regulated exchange.
This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
PredictionTraderFilterConnection
PredictionTraderFilterConnection
See PredictionTraderFilterConnection

​
Arguments

​
filters
PredictionTraderFilters
A set of filters to apply. See PredictionTraderFilters
​
phrase
String
A phrase to search for. Can match trader alias, address, or venue ID.
​
traderIds
[String!]
A list of trader IDs to filter by.
​
excludeTraderIds
[String!]
A list of trader IDs to exclude from results.
​
rankings
[PredictionTraderRanking!]
A list of ranking attributes to apply. See PredictionTraderRanking
​
limit
Int
The maximum number of results to return.
​
offset
Int
Where in the list the server should start when returning items.

​
Query Example

Top traders by 24h profit: 
{
  filterPredictionTraders(
    rankings: [
      { attribute: REALIZED_PNL_USD_24H, direction: DESC }
    ]
    filters: {
      trades24h: { gt: 5 }
    }
    limit: 10
  ) {
    count
    page
    results {
      id
      trader {
        alias
        primaryAddress
        profileImageUrl
      }
      realizedPnlUsd24h
      volumeUsd24h
      trades24h
      uniqueMarkets24h
      winRate24h
      averageProfitUsdPerTrade24h
      totalVolumeUsdAll
      totalProfitUsdAll
      activeMarketsCount
    }
  }
}
Example Response (truncated)
{
  "data": {
    "filterPredictionTraders": {
      "count": 10,
      "page": 0,
      "results": [
        {
          "id": "0x02227b8f5a9636e895607edd3185ed6ee5598ff7:Polymarket",
          "trader": {
            "alias": "HorizonSplendidView",
            "primaryAddress": null,
            "profileImageUrl": null
          },
          "realizedPnlUsd24h": "1959316",
          "volumeUsd24h": "6060346",
          "trades24h": 652,
          "uniqueMarkets24h": 1,
          "winRate24h": 1,
          "averageProfitUsdPerTrade24h": "3005.085439",
          "totalVolumeUsdAll": "21346770",
          "totalProfitUsdAll": "1710755",
          "activeMarketsCount": 3
        },
        // .. 9 more traders
      ]
    }
  }
}

​
Usage Guidelines

  • Trader ID format: <address>:<protocol> (e.g., 0x02227b8f5a9636e895607edd3185ed6ee5598ff7:Polymarket)
  • Response limit: 100 traders per request (configurable with limit parameter)
  • Use time-based metrics (12h, 24h, 1w, 1m) to analyze recent activity and trends
  • Use all-time metrics (totalProfitUsdAll, totalVolumeUsdAll) for historical performance
  • Filter by activeMarketsCount to find traders with current positions
  • Use phrase parameter to search by trader alias, address, or venue ID
  • Combine winRate and minimum trade filters to find consistently successful traders
  • Time windows: 12h (short-term), 24h (daily), 1w (weekly), 1m (monthly), All (lifetime)

​
Win Rate Interpretation

winRate fields show the percentage of profitable closed positions:
  • 0.0 - 0.3 - Struggling or learning traders
  • 0.3 - 0.5 - Below-average performance
  • 0.5 - 0.6 - Average to good performance
  • 0.6 - 0.8 - Strong performance (above market average)
  • 0.8 - 1.0 - Exceptional (but verify sample size with trades filter)
Note: High win rates with low trade counts may be statistical noise. Always filter by minimum trades.

​
Troubleshooting Tips

totalProfitUsdAll is lifetime cumulative profit across all markets and all time. realizedPnlUsd24h is profit earned only in the last 24 hours. Use all-time for track records, use time-windowed for recent performance.
Look for combination of: (1) High win rate (winRate1w > 0.6), (2) Significant volume (volumeUsd1w > 10000), (3) Many trades (trades1w > 50), (4) Good efficiency (pnlPerVolumeAll > 0.1). Single metrics can be misleading.
winRate counts the percentage of profitable positions (win/loss ratio). realizedProfitPercentage measures ROI (profit/capital ratio). You can have 90% win rate but low ROI if your losses are much larger than your wins.
This is profit efficiency - how much profit a trader extracts per dollar of volume traded. A value of 0.05 means 0.05profitper0.05 profit per 1 traded (5% efficiency). Higher values indicate better market timing or edge. Values above 0.1 are exceptional.
Not all traders set public aliases. Use primaryAddress as the unique identifier. Some traders prefer to remain pseudonymous. Filter by isVerified: true to find traders with platform verification.