API Documentation — HYPERFLEX

🔑 Authentication

Pass your API key in the Authorization header:

Authorization: Bearer hfx_your_api_key_here

Generate a key in your Dashboard → Settings → API Access.

/api/stats is the only endpoint that doesn't require auth.

Don't have an API key yet?

v1 Data API NEW

Normalized market data from Polymarket, Kalshi, and sports books in a single unified schema. Cross-platform price comparison and arbitrage detection included.

No auth required during Early Access. Rate limits apply.

GET /api/v1/markets?source=polymarket&category=crypto&limit=50

All active markets from every platform, normalized to one schema. Filter by source (polymarket, kalshi, sportsbook), category (crypto, politics, sports, tech, entertainment, science), search, sort, limit, offset.

Example Response
{
  "markets": [{
    "hfx_id": "polymarket:will-bitcoin-exceed-100k",
    "source": "polymarket",
    "title": "Will Bitcoin exceed $100,000 in 2026?",
    "category": "crypto",
    "outcomes": [
      { "name": "Yes", "price": 0.6500 },
      { "name": "No", "price": 0.3500 }
    ],
    "volume_24h": 248500,
    "volume_total": 12500000,
    "liquidity": 890000,
    "url": "https://polymarket.com/event/..."
  }],
  "total": 342,
  "sources": { "polymarket": 200, "kalshi": 95, "sportsbook": 47 }
}

GET /api/v1/arbitrage?min_spread=0.03&category=politics

Cross-platform arbitrage opportunities. Finds the same event on different platforms and shows price discrepancies. Filter by min_spread (default 0.02), category, source.

Example Response
{
  "opportunities": [{
    "title_a": "Will Bitcoin exceed $100K in 2026?",
    "source_a": "polymarket", "price_a": 0.65,
    "source_b": "kalshi", "price_b": 0.58,
    "spread_pct": 7,
    "buy_on": "kalshi",
    "arb_roi": 12,
    "confidence": 0.87
  }],
  "total": 8,
  "avg_spread": 0.045
}

GET /api/v1/markets/{hfx_id}/prices?hours=48

Historical price data for any market. Returns timestamped snapshots. hours param controls lookback (default 24, max 720).

GET /api/v1/stats

Platform-wide statistics: total markets tracked, breakdown by source and category, active arbitrage opportunities, data freshness.

GET /api/v1/sources

Available data sources with status, update frequency, and data types. Useful for checking which platforms are currently live.

Legacy Endpoints

The endpoints below predate the v1 API and remain available. We recommend migrating to /api/v1/ for normalized cross-platform data.

GET /api/whale-watch

Top 50 Polymarket traders' live positions. Updated every 10 minutes. Returns ranked whale data with position sizes, P&L, and market links.

Example Response
{
  "total_whales": 50,
  "total_positions": 847,
  "updated_at": "2026-03-20T14:30:00.000Z",
  "whales": [
    {
      "trader": "Theo4",
      "trader_rank": 1,
      "trader_pnl": 2841920.50,
      "market": "Will Bitcoin hit $100K by June 2026?",
      "side": "Yes",
      "size": 485200,
      "current_price": 0.72
    }
  ]
}

GET /api/leaderboard?period=30d

Trader leaderboard ranked by Sharp Score. Supports period filtering: 7d, 30d, all.

Example Response
{
  "period": "30d",
  "traders": [
    {
      "username": "Theo4",
      "sharp_score": 92.4,
      "win_rate": 0.74,
      "pnl": 184500.00,
      "total_trades": 312
    }
  ]
}

GET /api/markets/search?q=bitcoin

Search prediction market odds across platforms. Returns matching markets from Polymarket and Kalshi with live probabilities.

Example Response
{
  "query": "bitcoin",
  "results": [
    {
      "title": "Bitcoin above $100K on June 30?",
      "platform": "polymarket",
      "probability": 0.72,
      "volume": 12450000,
      "url": "https://polymarket.com/event/..."
    }
  ]
}

GET /api/trader-profile/:username

Public trader profile data including cross-platform stats, win rate, calibration score, and recent positions.

Example Response
{
  "username": "Theo4",
  "platforms": ["polymarket", "kalshi"],
  "win_rate": 0.74,
  "sharp_score": 92.4,
  "total_pnl": 2841920.50,
  "open_positions": 18,
  "calibration": 0.89
}

GET /api/stats

Platform-wide statistics including total markets, predictions, communities, and predictors tracked. Cached for 5 minutes.

Example Response
{
  "markets": 1842,
  "predictions": 24510,
  "communities": 156,
  "predictors": 3200
}

GET /api/whale-flow

Whale flow index with category breakdown, concentration analysis, and smart money sentiment. Aggregated from top 50 Polymarket trader positions. Cached for 10 minutes.

Example Response
{
  "category_breakdown": [
    {
      "category": "sports",
      "capital": 134831583,
      "positions": 89,
      "pct": 59
    }
  ],
  "concentration": [
    {
      "market": "Trail Blazers vs. Timberwolves",
      "whale_count": 17,
      "total_capital": 1450629,
      "consensus_side": "YES",
      "consensus_pct": 82
    }
  ],
  "sentiment": {
    "yes_pct": 61,
    "no_pct": 39,
    "total_positions": 234
  },
  "largest_moves": [],
  "updated_at": "2026-03-20T14:30:00.000Z"
}

GET /api/market-movers

Top 10 markets with the biggest price changes in the last 24 hours. Sorted by absolute price change. Cached for 15 minutes.

Example Response
{
  "movers": [
    {
      "market_id": "0x1234...abcd",
      "question": "Will Bitcoin hit $100K by June 2026?",
      "current_price": 72,
      "change_pct": 15.3
    },
    {
      "market_id": "0x5678...efgh",
      "question": "Trump wins 2028 Republican primary?",
      "current_price": 45,
      "change_pct": -8.2
    }
  ],
  "updated_at": "2026-03-20T14:30:00.000Z"
}

Public API