Genesis API Documentation

Everything you need to integrate: authentication, limits, endpoints and response schemas.

DocumentationTrader leaderboard

Trader leaderboard

TrialStartProMax

Top 300 Polymarket traders by PnL for the period: PnL, ROI, won positions, volume, categories and a PnL sparkline.

GEThttps://api.genesisarbitrage.com/v1/predictions/traders?period=30d
Try it
GET/v1/predictions/traders?period=30d

The key is stored only in your browser and is sent nowhere except the API.

Paste your key and send a request — we'll show a truncated response.

Query parameters

All parameters are optional: without filters the endpoint returns the full dataset.

ParameterTypeDescription
periodstring30d (default), 7d or all

Example request

bash
curl "https://api.genesisarbitrage.com/v1/predictions/traders?period=30d" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Example response

Response example — one data entry, long values shortened:

json
{
  "wallet": "0x3a1c…f09e",
  "name": "Domer",
  "created_at": 1652000000,
  "tags": ["whale", "smart"],
  "score": 87.4,
  "pnl_usd": { "all": 2845123.5, "d30": 184220.1, "d7": 40912.7 },
  "roi_pct": 21.4,
  "won": 412,
  "resolved": 590,
  "volume_usd": 13560000,
  "trades": 9821,
  "avg_trade_usd": 1380.6,
  "value_usd": 512400,
  "categories": ["Politics", "Crypto"],
  "ranks": { … },
  "pnl_series": [2510000.4, 2534000.9, …],
  "open_positions": 64,
  "last_trade_at": 1794675812,
  "updated_at": 1794675800
}

Response fields

FieldTypeDescription
wallet / name / created_at / tagsmixedWallet, name, creation date and labels
scorenumberTrader score
pnl_usd.all / d30 / d7numberPnL all time, 30 and 7 days, USD
roi_pctnumberROI, %
won / resolvednumberPositions won out of resolved
volume_usd / trades / avg_trade_usd / value_usdnumberVolume, number of trades, average trade and positions value, USD
categories / ranksmixedCategories and leaderboard ranks
pnl_seriesnumber[]PnL sparkline (up to 30 points)
open_positions / last_trade_at / updated_atnumberOpen positions, last trade and update time