API Reference
Access live market data, platform statistics, explorer feeds, and casino winner data. All public endpoints return JSON and require no authentication.
https://prediction-market-five-black.vercel.appRate 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.
/api/explore/feedLive 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 | settlementsinceISO 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": "Crash", "multiplier": 2.5 }
}
]
}/api/explore/statsPlatform-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
}/api/explore/address/[addr]Activity and balance history for a specific Quine identity address. Returns the user's public profile, event feed, and stats.
Parameters
addrstring (path)Quine 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 }
}/api/marketsList 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"
}
]
}/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"
}
}/api/casino/recent-winnersRecent 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": "Crash",
"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.