Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationLarge trades
Large trades
TrialStartProMax
Polymarket trade tape: live — trades from $1000 and smart wallets from $100, today and 7d — takers from $5000. Rows go from newest to oldest.
GET
https://api.genesisarbitrage.com/v1/predictions/trades?period=liveTry it
GET
/v1/predictions/trades?period=liveThe 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 | live (default), today or 7d |
wallet | string | Wallet address |
category | string | Filter by category |
side | string | buy or sell |
min_usd | number | Minimum amount, USD |
insider | boolean | true — insider-labelled trades only |
Example request
bash
curl "https://api.genesisarbitrage.com/v1/predictions/trades?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Example response
Response example — one data entry, long values shortened:
json
{
"id": "0x9f…:7134…:0x3a…",
"ts": 1794675812,
"wallet": "0x3a1c…f09e",
"name": "Domer",
"tags": ["whale", "smart"],
"market": "polymarket:0x6d2b…",
"title": "Will Bitcoin reach $150k in 2026?",
"outcome": "No",
"outcome_index": 1,
"category": "Crypto",
"side": "buy",
"price": 0.82,
"shares": 30487.8,
"usd": 25000,
"role": "taker",
"first_in_market": false,
"insider": false,
"url": "https://polymarket.com/event/…",
"bid_now": 0.81,
"ask_now": 0.83
}Response fields
| Field | Type | Description |
|---|---|---|
id / ts | string / number | Trade id and time |
wallet / name / tags | mixed | Wallet, name and labels (whale, smart, etc.) |
market / title / outcome / outcome_index / category | mixed | Market, title, outcome and its index, category |
side / price / shares / usd | mixed | Side, price, shares and USD amount |
role / first_in_market | string / boolean | taker — the trade's initiator, maker; whether it is the wallet's first trade in the market |
insider | boolean | Insider pattern label |
url | string | Event link on the platform |
bid_now / ask_now | number | null | Current bid and ask of the outcome |