API Reference

Markets

Each market is a single binary question tied to one settlement event. Markets are rounds within a series.

List Markets

GET /v1/markets?status=open&limit=20

Response:

{
  "data": [
    {
      "id": "8166597e-...",
      "symbol": "WILDUSDT",
      "exchange": "kucoin",
      "question": "Will WILDUSDT funding rate on kucoin at 2026-03-18 04:00 UTC be POSITIVE?",
      "settlement_ts": "2026-03-18T04:00:00Z",
      "open_ts": "2026-03-18T03:00:00Z",
      "close_ts": "2026-03-18T03:55:00Z",
      "status": "pending",
      "tier": 3,
      "yes_price": "0.489000",
      "no_price": "0.511000",
      "total_volume": "0.000000",
      "trade_count": 0,
      "ou_prior": "0.4890",
      "ou_confidence": "0.7244"
    }
  ]
}

Market Status Lifecycle

pending → open → closed → resolving → settled
                                    → voided

• pending — created by scheduler, not yet tradeable
• open — trading is live
• closed — trading stops 5 min before settlement
• resolving — oracle is fetching rates
• settled — outcome confirmed, winners paid
• voided — insufficient data, all positions refunded

Get Market

GET /v1/markets/{id}

Returns the same shape as a single item from List Markets, plus resolution fields when settled:

{
  "outcome": "yes",
  "actual_rate": "0.00041339",
  "settled_at": "2026-03-17T16:00:17Z"
}

Get Market Trades

GET /v1/markets/{id}/trades

Returns recent trades for a specific market.

{
  "data": [
    {
      "trade_id": "f1a2b3c4-...",
      "side": "yes",
      "shares": "13.698630",
      "price_usdc": "0.730000",
      "fee_usdc": "0.100000",
      "created_at": "2026-03-18T09:15:32Z"
    }
  ]
}