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.

GEThttps://api.genesisarbitrage.com/v1/predictions/trades?period=live
Try it
GET/v1/predictions/trades?period=live

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
periodstringlive (default), today or 7d
walletstringWallet address
categorystringFilter by category
sidestringbuy or sell
min_usdnumberMinimum amount, USD
insiderbooleantrue — 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

FieldTypeDescription
id / tsstring / numberTrade id and time
wallet / name / tagsmixedWallet, name and labels (whale, smart, etc.)
market / title / outcome / outcome_index / categorymixedMarket, title, outcome and its index, category
side / price / shares / usdmixedSide, price, shares and USD amount
role / first_in_marketstring / booleantaker — the trade's initiator, maker; whether it is the wallet's first trade in the market
insiderbooleanInsider pattern label
urlstringEvent link on the platform
bid_now / ask_nownumber | nullCurrent bid and ask of the outcome