Prediction Markets

​

What you get

• Markets & events — list, filter, and sort live and resolved markets; events group related markets (e.g. every candidate in an election).
• Prices & history — current order-book prices and Yes-price time series.
• Traders — a leaderboard plus deep per-trader analytics: positions, trade history, daily PnL history, category stats, and a composite score.
• Platform analytics — overview stats and composite market signals (whale + smart-money) with a buy/sell recommendation.
• Search — search across events, markets, and traders.

​

Conventions

• Success: { "success": true, ...payload, "timestamp": "<ISO 8601>" }. List endpoints add a meta object for pagination (total, limit, offset, hasMore).
• Error: { "success": false, "error": { "message": "...", "status": <code> } }.
• Prices are probabilities in 0..1. Money is USD. Dates are ISO 8601 strings.
• Identifiers: use the domain keys — slug (markets/events), conditionId (markets), walletAddress (traders), tagId (tags). Mongo internals (_id, __v) are stripped.

​

Authentication

# Trending markets
curl "https://api.polystats.ai/api/markets/trending?limit=5" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "source": "polymarket",
      "slug": "will-btc-hit-100k-2025",
      "question": "Will BTC hit $100k in 2025?",
      "outcomes": ["Yes", "No"],
      "outcomePrices": [0.62, 0.38],
      "volume24hr": 45000,
      "liquidity": 230000,
      "endDate": "2025-12-31T23:59:59.000Z"
    }
  ],
  "timestamp": "2025-06-19T12:00:00.000Z"
}

​

Credits

​

Explore the endpoints