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.
GET
https://api.genesisarbitrage.com/v1/predictions/traders?period=30dTry it
GET
/v1/predictions/traders?period=30dThe 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.
| Parameter | Type | Description |
|---|---|---|
period | string | 30d (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
| Field | Type | Description |
|---|---|---|
wallet / name / created_at / tags | mixed | Wallet, name, creation date and labels |
score | number | Trader score |
pnl_usd.all / d30 / d7 | number | PnL all time, 30 and 7 days, USD |
roi_pct | number | ROI, % |
won / resolved | number | Positions won out of resolved |
volume_usd / trades / avg_trade_usd / value_usd | number | Volume, number of trades, average trade and positions value, USD |
categories / ranks | mixed | Categories and leaderboard ranks |
pnl_series | number[] | PnL sparkline (up to 30 points) |
open_positions / last_trade_at / updated_at | number | Open positions, last trade and update time |