API Reference

Prediity Public API

Access live market data, platform statistics, explorer feeds, and casino winner data. All public endpoints return JSON and require no authentication.

BASE URLhttps://prediity.com
⚡

Rate Limits

Public endpoints: 60 requests/minute per IP. Authenticated: 300 req/min. Authenticate by adding Authorization: Bearer <token> to your request headers. Tokens are available on the API access page after verification.

ℹ️

All responses are JSON with Content-Type: application/json. Errors return a { "error": "..." } object with an appropriate HTTP status code. All amounts are in USD unless otherwise noted.

Explorer

GET/api/explore/feed

Live feed of all platform events — deposits, withdrawals, trades, bets, and settlements. Use for real-time dashboards or data pipelines.

Parameters

limitnumberMax results (default 50, max 300)
typestringFilter: payment | trade | bet | settlement
sinceISO datetimeOnly return events after this timestamp (pagination cursor)

Example response

{
  "events": [
    {
      "id": "bet:abc123",
      "source": "bet",
      "type": "Win",
      "amountUsd": 12.50,
      "timestamp": "2026-06-15T12:00:00Z",
      "status": "WON",
      "user": { "username": "alice", "identityAddr": "0x..." },
      "meta": { "game": "Limbo", "multiplier": 2.5 }
    }
  ]
}
GET/api/explore/stats

Platform-wide statistics: user count, wallet count, 24h transaction volume, total supply.

Example response

{
  "totalUsers": 145000,
  "totalWallets": 132000,
  "totalSupplyUsd": 2840000,
  "txCount24h": 8620,
  "totalDepositsUsd": 15000000,
  "activeMarkets": 512
}
GET/api/explore/address/[addr]

Activity and balance history for a specific identity address. Returns the user's public profile, event feed, and stats.

Parameters

addrstring (path)Identity address (0x…)
limitnumberMax events (default 50, max 200)

Example response

{
  "user": { "username": "alice", "identityAddr": "0x...", "createdAt": "..." },
  "events": [...],
  "stats": { "totalDeposits": 1200, "totalWithdrawals": 400, "netPosition": 800 }
}

Markets

GET/api/markets

List open prediction markets with current prices, volume, and metadata.

Parameters

categorystringFilter by category slug (e.g. politics, sports, crypto)
limitnumberMax results (default 20, max 100)
sortstringSort: volume | createdAt | closeTime (default: volume)

Example response

{
  "markets": [
    {
      "id": "clxyz...",
      "ticker": "BTCUSD-100K",
      "title": "Will BTC hit $100K in 2026?",
      "category": "crypto",
      "yesPrice": 0.62,
      "noPrice": 0.38,
      "volume": 142000,
      "closeTime": "2026-12-31T23:59:59Z"
    }
  ]
}
GET/api/markets/[ticker]

Full detail for a single market: prices, order book, trade history, pool sizes.

Parameters

tickerstring (path)Market ticker (e.g. BTCUSD-100K)

Example response

{
  "market": {
    "id": "...",
    "ticker": "BTCUSD-100K",
    "title": "...",
    "yesPrice": 0.62,
    "noPrice": 0.38,
    "yesPool": 58000,
    "noPool": 36000,
    "volume": 142000,
    "status": "OPEN"
  }
}

Casino

GET/api/casino/recent-winners

Recent casino game winners for the public winners ticker. Returns the last N payouts across all games.

Parameters

limitnumberMax results (default 20, max 100)

Example response

{
  "winners": [
    {
      "username": "bob",
      "game": "Limbo",
      "payout": 45.00,
      "multiplier": 3.2,
      "agoMs": 12000
    }
  ]
}

Authentication & Private API

The public endpoints above require no API key. For private endpoints (placing trades, accessing account data, institutional data feeds, and WebSocket streams), contact us for an API token. Private API users get 300 req/min and access to real-time order book WebSockets.

Request API access →api@prediity.com