API Documentation

Public endpoints for traders, markets, wallets, and trades. All responses are JSON.

Base URL: https://www.alphaboard.xyz

Authentication: none — all endpoints are public and read-only.

Fair use: responses are edge-cached (typically 1–2 minutes); please keep polling intervals ≥ 30s. Heavy or abusive usage may be rate-limited.

Errors: non-200 responses return { "error": "message" } with an appropriate HTTP status.

Data source: aggregated from Polymarket public APIs; schemas may evolve with upstream changes.

GET/api/leaderboard

Top traders leaderboard with optional time window. Returns an array of trader entries.

window=allTime|1d|1w|1mlimit=1..50

Example: /api/leaderboard?window=allTime&limit=20

[
  {
    "rank": "1",
    "proxyWallet": "0xabc…",
    "userName": "trader",
    "xUsername": "trader",
    "verifiedBadge": true,
    "vol": 1250000.5,
    "pnl": 84210.42,
    "profileImage": "https://…"
  }
]

GET/api/markets/list

List active prediction markets, slimmed to the fields shown below. Cached ~2 minutes.

sort=vol24h|volume|liquidity|ending|newestlimit=1..200

Example: /api/markets/list?sort=vol24h&limit=20

[
  {
    "id": "0x…",
    "question": "Will …?",
    "slug": "will-…",
    "eventSlug": "event-…",
    "volume24hrNum": 51234.1,
    "volumeNum": 812345.0,
    "liquidityNum": 25000.0,
    "outcomes": "[\"Yes\",\"No\"]",
    "outcomePrices": "[\"0.55\",\"0.45\"]",
    "image": "https://…",
    "endDate": "2026-07-19T00:00:00Z",
    "category": "World Cup"
  }
]

GET/api/wallet/[address]

Wallet analytics: lifetime positions (including closed) and current portfolio value. Wallets with more than 3,000 positions are truncated (flagged in the response).

address (Ethereum, 0x…)

Example: /api/wallet/0x1234…

{
  "positions": [ { "…": "Polymarket data-api position object" } ],
  "totalValue": 10423.55,
  "truncated": false
}

GET/api/trades/recent

Recent large trades (≥ $1,000) across Polymarket, sorted by size. Falls back to the top 20 trades when nothing clears the threshold.

Example: /api/trades/recent

{
  "trades": [ { "…": "Polymarket data-api trade object" } ],
  "belowThreshold": false
}