Genesis Arbitrage

Genesis Arbitrage · · 12 min de leitura

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

EndpointO que retornaPlanos da API
/market/fair-pricePreço mark e última negociaçãoTrial, Start, Pro, Max
/market/pumpsPumps e dumps em CEXTrial, Start, Pro, Max
/market/dex-dumpsQuedas de tokens em DEXPro, Max
/market/open-interestOpen interest por exchangeTrial, Start, Pro, Max
/ai/signalsSinais do Genesis AI+Trial, Start, Pro, Max
/coins/searchFicha de uma moeda em todas as exchangesTrial, 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âmetroTipoO que faz
exchangestringExchange; várias separadas por vírgula
coinstringTicker da moeda, p. ex. BTC
min_spreadnumberSpread absoluto mínimo, %
CampoTipoSignificado
fair_price / last_pricenumberPreço mark e preço da última negociação
spread_pctnumberSpread entre eles, %
fair_changes / last_changesobjectVariaçã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âmetroTipoO que faz
exchangestringExchange; várias separadas por vírgula
coinstringTicker da moeda
min_changenumberLimite absoluto de variação de preço, %
CampoTipoSignificado
pricenumberPreço atual
change_5s … change_1hnumberVariação de preço no intervalo, %
volume_24hnumberVolume de 24 h, USD
funding_pctnumber ou nullTaxa de financiamento (funding) por período de liquidação, %
contract / networkstring ou nullEndereç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âmetroTipoO que faz
chainstringRede, p. ex. bsc
min_liquiditynumberLiquidez mínima do pool, USD
CampoTipoSignificado
tsintHora do evento, segundos unix
price / liquidity_usdnumberPreço e liquidez do pool, USD
market_capnumber ou nullCapitalização de mercado, USD
price_changesobjectVariação de preço, %: m5, h1, h6 e h24
listed_on_cexbooleanSe a moeda é negociada em CEX
cex_spot / cex_futuresstring[]Exchanges com o spot e os futuros da moeda
pool_urlstringLink 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âmetroTipoO que faz
coinstringTicker da moeda
exchangestringExchange; várias separadas por vírgula
CampoTipoSignificado
total.oi_usd / total.oi_tokensnumberOpen interest em dólares e em moedas
total.avg_pricenumberPreço médio ponderado por volume entre as exchanges
total.volume_24hnumberVolume de 24 h, USD
total.oi_change_5m/15m/30m/1hnumberVariação do OI no intervalo, %
total.price_change_5m/15m/30m/1hnumberVariação do preço no intervalo, %
exchanges{}objectAs 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.

MoedaOI, 1 hPreço, 1 hResultado
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.

  1. Peça o snapshot completo

    Uma chamada sem filtros retorna todas as moedas.

  2. 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.

  3. Aplique a condição

    oi_change_1h acima de 5, price_change_1h acima de 0.

  4. Verifique a amplitude do movimento

    Conte as exchanges em exchanges em 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âmetroTipoO que faz
categorystringNota: alpha, high, middle, risky ou noise
coinstringTicker da moeda
CampoTipoSignificado
idstringIdentificador: seu bot o usa para pular repetições
ts / timeint / stringHora: segundos unix e ISO 8601
pipelinestringFonte do sinal
message_ru / message_enstring ou nullTexto do sinal em russo e inglês
linksarrayLinks 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.

CampoTipoSignificado
contracts[]arrayContratos: endereço, rede e exchanges que o usam
exchanges{}.spot_price / futures_pricenumber ou nullPreço spot e de futuros; null significa que não há mercado
exchanges{}.deposit / withdrawboolean ou nullSe depósitos e saques estão abertos
fundingobject ou nullResumo 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.