Documentação da Genesis API

Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.

DocumentaçãoGrandes negociações

Grandes negociações

TrialStartProMax

Fluxo de negociações da Polymarket: live — negociações a partir de $1000 e carteiras smart a partir de $100, today e 7d — takers a partir de $5000. As linhas vão da mais recente para a mais antiga.

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

A chave fica só no seu navegador e não é enviada a lugar nenhum além da API.

Cole sua chave e envie uma requisição — mostraremos uma resposta resumida.

Parâmetros da requisição

Todos os parâmetros são opcionais: sem filtros o endpoint retorna o conjunto completo de dados.

ParâmetroTipoDescrição
periodstringlive (padrão), today ou 7d
walletstringEndereço da carteira
categorystringFiltro por categoria
sidestringbuy ou sell
min_usdnumberValor mínimo, USD
insiderbooleantrue — apenas negociações com rótulo insider

Exemplo de requisição

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

Exemplo de resposta

Exemplo de resposta — um elemento de dados, valores longos abreviados:

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
}

Campos da resposta

CampoTipoDescrição
id / tsstring / numberId e hora da negociação
wallet / name / tagsmixedCarteira, nome e rótulos (whale, smart, etc.)
market / title / outcome / outcome_index / categorymixedMercado, título, resultado e seu índice, categoria
side / price / shares / usdmixedLado, preço, shares e valor em USD
role / first_in_marketstring / booleantaker — o iniciador da negociação, maker; se é a primeira negociação da carteira no mercado
insiderbooleanRótulo de padrão insider
urlstringLink do evento na plataforma
bid_now / ask_nownumber | nullBid e ask atuais do resultado