Dados de mercado da Genesis API: Fair – Last, pumps, OI, sinais de IA, busca
Em resumo
- Seis endpoints de mercado espelham o site: Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking, sinais do Genesis AI+ e busca de moedas. Todos, exceto DEX Dumps, estão disponíveis desde o plano Trial.
- As variações de preço e de open interest chegam como percentuais já calculados em intervalos de 5 segundos a uma hora, então você não precisa guardar um histórico próprio para obtê-las.
- A Genesis API apenas lê dados. Ela mostra movimentos e anomalias, enquanto a decisão de operar e a operação na exchange continuam com você.
Os endpoints de mercado da Genesis API retornam os mesmos dados das seções Fair – Last, CEX Pumps – Dumps, DEX Dumps e OI Tracking do site, além do feed de sinais do Genesis AI+ e de uma ficha de moeda em todas as exchanges. Cada chamada é um HTTP GET com a chave no cabeçalho X-API-Key e a resposta no envelope data e meta. Desenvolvedores usam esses dados para alertas de movimentos bruscos, monitores de open interest e verificações de uma moeda antes de operar.
Endpoints e planos
| Endpoint | O que retorna | Planos da API |
|---|---|---|
/market/fair-price | Preço mark e última negociação | Trial, Start, Pro, Max |
/market/pumps | Pumps e dumps em CEX | Trial, Start, Pro, Max |
/market/dex-dumps | Quedas de tokens em DEX | Pro, Max |
/market/open-interest | Open interest por exchange | Trial, Start, Pro, Max |
/ai/signals | Sinais do Genesis AI+ | Trial, Start, Pro, Max |
/coins/search | Ficha de uma moeda em todas as exchanges | Trial, Start, Pro, Max |
A URL base é https://api.genesisarbitrage.com/v1, e um endpoint fora do seu plano retorna 403 plan_restricted. O plano também define a atualidade dos dados: 60 s no Trial, 30 s no Start, 10 s no Pro e 5 s no Max. A chave e a primeira requisição estão no início rápido, as cotas nos limites da Genesis API e os códigos de erro em respostas e erros da Genesis API.
Fair – Last: /market/fair-price
Cada linha é o contrato futuro de uma moeda em uma exchange: o preço mark (Fair), o preço da última negociação (Last) e o spread entre eles. O preço mark é calculado, e na Binance Futures a liquidação é acionada por ele. Uma diferença grande significa que negociações em uma exchange empurraram o Last, ou que o livro de ofertas ficou sem ordens. Como analisar essas linhas está no guia de Fair – Last, e os campos na documentação.
| Parâmetro | Tipo | O que faz |
|---|---|---|
exchange | string | Exchange; várias separadas por vírgula |
coin | string | Ticker da moeda, p. ex. BTC |
min_spread | number | Spread absoluto mínimo, % |
| Campo | Tipo | Significado |
|---|---|---|
fair_price / last_price | number | Preço mark e preço da última negociação |
spread_pct | number | Spread entre eles, % |
fair_changes / last_changes | object | Variação de cada preço, %: s5, s10, s30 e m1, em 5, 10 e 30 segundos e um minuto |
curl -G "https://api.genesisarbitrage.com/v1/market/fair-price" \
-d exchange=ByBit \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
A opção -G move os parâmetros -d para a URL da requisição. A resposta é um array data; aqui e adiante mostramos um dos seus itens:
{
"exchange": "ByBit",
"coin": "0G",
"fair_price": 0.192,
"last_price": 0.192,
"spread_pct": 0.0,
"trade_url": "https://www.bybit.com/trade/usdt/0GUSDT",
"fair_changes": { "s5": 0.0, "s10": 0.052, "s30": 0.052, "m1": 0.0 },
"last_changes": { "s5": 0.052, "s10": 0.052, "s30": 0.052, "m1": 0.0 }
}
CEX Pumps – Dumps: /market/pumps
O endpoint espelha a tabela CEX Pumps – Dumps: o preço de uma moeda nos futuros de uma exchange e sua variação em oito intervalos, nos campos change_5s, change_10s, change_30s, change_60s, change_5m, change_15m, change_30m e change_1h. Uma requisição com min_change=5 mantém as moedas que se moveram 5% ou mais, em qualquer direção, em pelo menos um intervalo. Todos os campos estão na documentação do endpoint.
| Parâmetro | Tipo | O que faz |
|---|---|---|
exchange | string | Exchange; várias separadas por vírgula |
coin | string | Ticker da moeda |
min_change | number | Limite absoluto de variação de preço, % |
| Campo | Tipo | Significado |
|---|---|---|
price | number | Preço atual |
change_5s … change_1h | number | Variação de preço no intervalo, % |
volume_24h | number | Volume de 24 h, USD |
funding_pct | number ou null | Taxa de financiamento (funding) por período de liquidação, % |
contract / network | string ou null | Endereço do contrato e rede do token |
curl -G "https://api.genesisarbitrage.com/v1/market/pumps" \
-d coin=BTC -d exchange=MEXC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"exchange": "MEXC",
"coin": "BTC",
"price": 64267.9,
"change_5s": 0.0,
"change_10s": 0.0,
"change_30s": 0.02,
"change_60s": 0.06,
"change_5m": 0.08,
"change_15m": -0.06,
"change_30m": -0.09,
"change_1h": -0.2,
"volume_24h": 2243246205,
"funding_pct": 0.01,
"network": "BNB Smart Chain(BEP20)",
"trade_url": "https://futures.mexc.com/exchange/BTC_USDT"
}
DEX Dumps: /market/dex-dumps
Planos Pro e Max. O endpoint retorna quedas de tokens em DEX, como a seção DEX Dumps, com a liquidez do pool e um indicador de se o token é negociado em CEX. O esquema da resposta está na documentação.
| Parâmetro | Tipo | O que faz |
|---|---|---|
chain | string | Rede, p. ex. bsc |
min_liquidity | number | Liquidez mínima do pool, USD |
| Campo | Tipo | Significado |
|---|---|---|
ts | int | Hora do evento, segundos unix |
price / liquidity_usd | number | Preço e liquidez do pool, USD |
market_cap | number ou null | Capitalização de mercado, USD |
price_changes | object | Variação de preço, %: m5, h1, h6 e h24 |
listed_on_cex | boolean | Se a moeda é negociada em CEX |
cex_spot / cex_futures | string[] | Exchanges com o spot e os futuros da moeda |
pool_url | string | Link do pool |
curl -G "https://api.genesisarbitrage.com/v1/market/dex-dumps" \
-d chain=bsc -d min_liquidity=20000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"ts": 1783203653,
"coin": "ONLY",
"chain": "bsc",
"price": 0.00009884,
"liquidity_usd": 30477.58,
"market_cap": 98840,
"price_changes": {
"m5": -58.03, "h1": 31.83, "h6": 31.83, "h24": 31.83
},
"pool_url": "https://dexscreener.com/bsc/0x2a18…",
"listed_on_cex": false,
"cex_spot": [],
"cex_futures": []
}
OI Tracking: /market/open-interest
O open interest (OI) é o volume de posições de futuros abertas e ainda não encerradas. O endpoint o retorna como a tabela OI Tracking: o total da moeda em total e o detalhamento por exchange em exchanges. Os dados cobrem mais de 13 exchanges de futuros, incluindo Binance, Bybit, OKX, Bitget e Gate. Há uma visão geral no artigo sobre a API de open interest e os campos na documentação.
| Parâmetro | Tipo | O que faz |
|---|---|---|
coin | string | Ticker da moeda |
exchange | string | Exchange; várias separadas por vírgula |
| Campo | Tipo | Significado |
|---|---|---|
total.oi_usd / total.oi_tokens | number | Open interest em dólares e em moedas |
total.avg_price | number | Preço médio ponderado por volume entre as exchanges |
total.volume_24h | number | Volume de 24 h, USD |
total.oi_change_5m/15m/30m/1h | number | Variação do OI no intervalo, % |
total.price_change_5m/15m/30m/1h | number | Variação do preço no intervalo, % |
exchanges{} | object | As mesmas métricas por exchange: price no lugar de avg_price, mais trade_url |
curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
-d coin=GRAM \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "GRAM",
"total": {
"oi_usd": 96544685.3,
"oi_tokens": 58105803.3,
"avg_price": 1.661224,
"volume_24h": 47010004.63,
"oi_change_1h": 0.3185,
"price_change_1h": -0.1929,
…
},
"exchanges": {
"ByBit": {
"price": 1.6609,
"oi_usd": 26838489.41,
"oi_change_1h": -0.097,
"trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
…
}
}
}
Exemplo hipotético: OI subindo mais de 5% em uma hora, junto com o preço
Você quer moedas que atraíram novas posições na última hora enquanto o preço subia: total.oi_change_1h acima de 5 e total.price_change_1h acima de 0. Os dois campos já vêm em porcentagem.
Há uma hora a moeda A tinha US$ 40.000.000 de OI e agora tem US$ 42.600.000: (42.600.000 − 40.000.000) / 40.000.000 × 100 = 6,5%. Na mesma hora o preço subiu de US$ 2,00 para US$ 2,056: (2,056 − 2,00) / 2,00 × 100 = 2,8%. Na resposta isso aparece como oi_change_1h: 6.5 e price_change_1h: 2.8.
| Moeda | OI, 1 h | Preço, 1 h | Resultado |
|---|---|---|---|
| A | +6,5% | +2,8% | Passa |
| B | +7,2% | −1,9% | Não: o OI sobe contra o preço |
| C | +3,1% | +4,0% | Não: OI abaixo do limite |
Na moeda B o OI sobe com o preço em queda, o que costuma significar que posições vendidas estão sendo abertas. OI subindo junto com o preço não promete continuidade: um mercado superaquecido pode reverter em uma cascata de liquidações.
Peça o snapshot completo
Uma chamada sem filtros retorna todas as moedas.
Descarte as moedas pequenas
Defina um limite para
total.oi_usd, p. ex. US$ 5.000.000: com um OI pequeno, duas ou três posições grandes geram uma porcentagem enorme.Aplique a condição
oi_change_1hacima de 5,price_change_1hacima de 0.Verifique a amplitude do movimento
Conte as exchanges em
exchangesem que o OI também cresceu mais de 5%: crescimento em várias exchanges pesa mais.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
MIN_OI_USD = 5_000_000 # ignorar moedas pequenas
def get(path, **params):
while True:
r = requests.get(API + path, headers=HEADERS,
params=params, timeout=15)
if r.status_code in (429, 503): # limite ou reconstrução
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
for row in get("/market/open-interest"):
t = row["total"]
oi, price = t.get("oi_change_1h"), t.get("price_change_1h")
if oi is None or price is None:
continue
if (t.get("oi_usd") or 0) < MIN_OI_USD:
continue
if oi > 5 and price > 0:
wide = [ex for ex, m in row["exchanges"].items()
if (m.get("oi_change_1h") or 0) > 5]
print(f"{row['coin']}: OI {oi:+.1f}%, preço {price:+.1f}%, "
f"exchanges com alta de OI: {len(wide)}")
Sinais do Genesis AI+: /ai/signals
O Genesis AI+ verifica sinais de arbitragem e dá a cada um uma nota de alpha a noise. O endpoint retorna esse feed com o texto em russo e inglês e links para as exchanges. category aceita um único valor: para alpha e high, faça duas requisições ou filtre a resposta do seu lado. As descrições dos campos estão na documentação.
| Parâmetro | Tipo | O que faz |
|---|---|---|
category | string | Nota: alpha, high, middle, risky ou noise |
coin | string | Ticker da moeda |
| Campo | Tipo | Significado |
|---|---|---|
id | string | Identificador: seu bot o usa para pular repetições |
ts / time | int / string | Hora: segundos unix e ISO 8601 |
pipeline | string | Fonte do sinal |
message_ru / message_en | string ou null | Texto do sinal em russo e inglês |
links | array | Links prontos: texto + url |
curl -G "https://api.genesisarbitrage.com/v1/ai/signals" \
-d coin=UTYA \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"id": "1783198680493",
"ts": 1783198680,
"time": "2026-07-04T20:58:00Z",
"coin": "UTYA",
"pipeline": "public",
"category": "noise",
"message_ru": "Глянул на UTYA — DEX против MEXC Futures…",
"message_en": "Checked UTYA — DEX against MEXC Futures…",
"links": [
{
"text": "MEXC Futures",
"url": "https://futures.mexc.com/exchange/UTYA_USDT"
}
]
}
Busca de moedas: /coins/search
O endpoint retorna uma ficha de moeda, como o Coin Search do site: contratos por rede, preços spot e de futuros, status de depósito e saque em cada exchange e um resumo de funding. O ticker vai no parâmetro obrigatório query, e uma moeda desconhecida retorna 404 not_found. Aqui data é um único objeto. Os campos estão na documentação.
| Campo | Tipo | Significado |
|---|---|---|
contracts[] | array | Contratos: endereço, rede e exchanges que o usam |
exchanges{}.spot_price / futures_price | number ou null | Preço spot e de futuros; null significa que não há mercado |
exchanges{}.deposit / withdraw | boolean ou null | Se depósitos e saques estão abertos |
funding | object ou null | Resumo de funding; null significa que não há futuros |
Um mesmo ticker pode ser tokens diferentes em exchanges diferentes: antes de uma transferência, compare o endereço de contracts[] com o contrato na página de depósito da exchange.
curl -G "https://api.genesisarbitrage.com/v1/coins/search" \
-d query=IRYS \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "IRYS",
"contracts": [
{
"address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
"network": "BNB Smart Chain(BEP20)",
"exchanges": ["MEXC", "Ourbit"]
}
],
"exchanges": {
"MEXC": {
"spot_price": 0.01329,
"futures_price": 0.0133,
"deposit": true,
"withdraw": true,
"spot_url": "https://www.mexc.com/exchange/IRYS_USDT",
…
}
},
"funding": {
"spread_pct": 0.0,
"best": { "exchange_1": "Bitget", "exchange_2": "OKX", … }
}
}
Perguntas e respostas
Quais endpoints de mercado estão no plano Trial?
Todos, exceto DEX Dumps: esse endpoint está aberto no Pro e no Max e retorna 403 plan_restricted no Trial e no Start.
A API tem histórico de open interest?
Não: o endpoint retorna o snapshot atual com variações em 5, 15 e 30 minutos e uma hora, e a Genesis API não tem candles históricos. Monte o histórico você mesmo guardando as respostas.
Posso abrir operações por esses endpoints?
Não. A Genesis API apenas lê dados e não envia ordens: você abre a operação na exchange por conta própria.
Com que frequência devo consultar os endpoints de mercado?
Não mais que meta.freshness_sec: de 60 s no Trial a 5 s no Max. Uma resposta sem filtros traz o cabeçalho ETag. Envie-o de volta em If-None-Match e, enquanto os dados não mudarem, o servidor responde 304, que não consome sua cota.