Genesis Arbitrage

Genesis Arbitrage · · 15 min de leitura

API de open interest: OI de futuros por exchange e como interpretá-lo

Em resumo

  • Open interest é o volume de posições em futuros que continuam abertas. Contado em moedas, mostra a entrada de posições; contado em dólares, também se move com o preço.
  • Cada exchange publica o OI em seu próprio formato e com suas próprias unidades. Na Genesis API, uma única chamada a /market/open-interest cobre 13+ exchanges, com a soma em total, o detalhamento em exchanges e as variações de OI e de preço em 5, 15 e 30 minutos e em 1 hora, em todos os planos.
  • Lido junto com o preço e o funding, o OI mostra quem está montando posições e quem paga para mantê-las. Ele não prevê o preço; a decisão e a operação na exchange continuam com você.

Uma API de open interest retorna, para cada moeda, o volume de posições abertas em futuros, em moedas e em dólares, por exchange e no total, junto com sua variação nos últimos minutos e horas. As exchanges publicam o OI de seus contratos por meio de suas próprias APIs, e os formatos mudam de uma exchange para outra. Na Genesis API, todo o snapshot vem de uma chamada a /market/open-interest: 13+ exchanges de futuros, entre elas Binance, Bybit, OKX, Bitget e Gate, com variações de OI e de preço em 5, 15 e 30 minutos e em 1 hora, em todos os planos, a partir do Trial, por US$ 20 por mês.

O que é open interest

O open interest (OI, ou interesse em aberto) é o total de posições de um contrato futuro que estão abertas e ainda não foram encerradas. Todo contrato tem dois lados, um comprado (long) e um vendido (short), e o OI conta apenas um deles: um trader compra 1 BTC em long, outro vende 1 BTC em short, e o open interest sobe 1 BTC.

O OI sobe quando os dois lados de uma operação abrem posições, cai quando os dois encerram, e fica estável quando uma posição passa de um trader para outro. Assim, OI em alta significa que entram posições novas, e OI em queda significa que posições estão sendo fechadas, por vontade própria ou à força.

OI em moedas e em dólares

As exchanges informam o OI em contratos, em moedas ou diretamente em dólares, e as moedas são convertidas em dólares pelo preço. Na resposta de exemplo da Genesis API, o oi_usd da ByBit para GRAM é igual a oi_tokens vezes price: 16.159.003,8 × 1,6609 = 26.838.489,41.

O valor em dólares é prático para comparar moedas e exchanges, mas se move com o preço. Exemplo ilustrativo: uma exchange tem 2.000.000 de moedas em posições abertas a US$ 1,50, então o OI é 2.000.000 × US$ 1,50 = US$ 3.000.000. Uma hora depois, as posições não mudaram, o preço é US$ 1,65 e o OI em dólares já é 2.000.000 × US$ 1,65 = US$ 3.300.000, 10% a mais sem uma única posição nova.

OI total e detalhamento por exchange

O OI total de uma moeda soma o OI das exchanges que listam seus futuros e mostra quanto dinheiro o mercado mantém em posições. O detalhamento mostra onde esse dinheiro está: na mesma resposta, a ByBit detém 26.838.489,41 / 96.544.685,3 × 100 = 27,8% do OI em dólares de GRAM.

MedidaO que mostraA armadilha
OI em moedasQuantas posições estão abertasO tamanho do contrato varia por exchange
OI em dólaresQuanto dinheiro está em posiçõesSe move com o preço
OI totalPosições em todo o mercadoDepende de quais exchanges são somadas
OI por exchangeOnde as posições estão sendo montadasOs métodos das exchanges diferem

O que as APIs da Binance, Bybit, OKX e Hyperliquid retornam

Cada exchange publica o OI de seus contratos por meio da própria API. Veja o que diz a documentação oficial:

ExchangeOI atualHistórico de OIAtenção
BinanceGET /fapi/v1/openInterest, um symbol por requisiçãoGET /futures/data/openInterestHistO histórico cobre apenas o último mês
BybitGET /v5/market/tickers, todos os símbolos em uma requisiçãoGET /v5/market/open-interest, passos de 5min a 1dopenInterest conta os dois lados, singleOpenInterest um
OKXGET /api/v5/public/open-interestGET /api/v5/rubik/stat/contracts/open-interest-historyoi em contratos, oiCcy em moedas, oiUsd em dólares
HyperliquidPOST /info, tipo metaAndAssetCtxsNão consta na documentaçãoOI de futuros perpétuos em uma única requisição

Os detalhes estão na documentação da Binance, da Bybit, da OKX e da Hyperliquid. O histórico da Binance vem como sumOpenInterest e sumOpenInterestValue, enquanto a OKX retorna as últimas 1.440 entradas em passos a partir de 5 minutos. A Hyperliquid aceita uma requisição a https://api.hyperliquid.xyz/info com o corpo {"type": "metaAndAssetCtxs"} e retorna openInterest de cada perpétuo ao lado de markPx e funding.

A diferença de método pode ser de duas vezes. No exemplo de resposta de /v5/market/open-interest da Bybit, openInterest é 63.910.691 e singleOpenInterest é 31.955.346, exatamente a metade: o primeiro conta os dois lados, o segundo conta um, como na definição de OI acima.

Montar um snapshot por conta própria significa consultar cada exchange pelas regras dela, converter contratos em moedas e moedas em dólares, e respeitar os limites de cada plataforma. Na Binance isso exige uma requisição separada para cada contrato.

Open interest na Genesis API: /market/open-interest

O endpoint /market/open-interest retorna os mesmos dados da tabela OI Tracking do site: o OI total de cada moeda em total e o detalhamento por exchange em exchanges. Sem parâmetros, você recebe todas as moedas; coin mantém uma só moeda, e exchange mantém as exchanges escolhidas, separadas por vírgula quando forem várias.

curl -G "https://api.genesisarbitrage.com/v1/market/open-interest" \
  -d coin=GRAM \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

A resposta é um array data. Abaixo, um de seus elementos, tirado da documentação, com alguns campos cortados:

{
  "coin": "GRAM",
  "total": {
    "oi_usd": 96544685.3,
    "oi_tokens": 58105803.3,
    "avg_price": 1.661224,
    "volume_24h": 47010004.63,
    "oi_change_5m": 0.0196,
    "oi_change_1h": 0.3185,
    "price_change_5m": -0.0228,
    "price_change_1h": -0.1929,
    …
  },
  "exchanges": {
    "ByBit": {
      "price": 1.6609,
      "oi_usd": 26838489.41,
      "oi_tokens": 16159003.8,
      "oi_change_1h": -0.097,
      "price_change_1h": -0.1683,
      "trade_url": "https://www.bybit.com/trade/usdt/GRAMUSDT",
      …
    }
  }
}
CampoSignificado
total.oi_usd / total.oi_tokensOI total em dólares e em moedas
total.avg_pricePreço médio da moeda entre as exchanges
total.volume_24hVolume de 24 h, USD
total.oi_change_5m/15m/30m/1hVariação do OI em 5, 15 e 30 minutos e 1 hora, %
total.price_change_5m/15m/30m/1hVariação do preço nos mesmos intervalos, %
exchanges{}As mesmas métricas por exchange: price no lugar de avg_price, mais trade_url

As variações são porcentagens: 0.3185 significa 0,3185%. Valores vazios chegam como null, então ignore-os. A atualidade depende do plano: 60 s no Trial, 30 s no Start, 10 s no Pro e 5 s no Max, portanto consultar com mais frequência que meta.freshness_sec não traz nada.

Uma resposta sem filtros traz o cabeçalho ETag. Devolva-o em If-None-Match, e um snapshot inalterado volta como 304, que não consome sua cota; o mecanismo é explicado em ETag e If-None-Match. O filtro exchange reduz apenas exchanges: total continua sendo calculado com todas as exchanges.

Os campos, os parâmetros e o formulário «Testar» estão na seção da documentação "OI Tracking". Todos os endpoints de mercado são percorridos com exemplos no guia Dados de mercado da Genesis API.

Lendo o OI com o preço: quatro cenários

OI em alta mostra que posições estão sendo abertas, mas não qual lado conduz. O preço no mesmo intervalo dá a pista.

PreçoOILeitura usualO que verificar
SobeSobePosições novas na direção do movimento, a alta tem dinheiro por trásFunding: muito positivo significa excesso de longs
CaiSobeShorts se acumulam, ou longs compram durante a quedaFunding: muito negativo significa risco de short squeeze
SobeCaiA alta se sustenta no fechamento de shorts, sem dinheiro novoSe o OI cai em todas as exchanges
CaiCaiLongs estão sendo fechados, por escolha ou à forçaOI despencando em 5 minutos aponta para liquidações

No exemplo da documentação, o OI total de GRAM subiu 0,32% em uma hora enquanto o preço caiu 0,19%, o que formalmente o coloca na segunda linha. Frações de ponto percentual por hora, porém, são ruído comum: leia os cenários em movimentos claros e em moedas com OI grande.

OI e funding: quem mantém posições e quem paga por elas

A taxa de financiamento (funding) mostra qual lado dos futuros perpétuos paga ao outro, e o OI mostra quantas posições estão abertas. Juntos, mostram tanto para onde o mercado se inclina quanto o quanto ele está alavancado.

OI e preço em alta com uma taxa muito positiva significam que os longs estão adicionando posições e pagando aos shorts para mantê-las. Se o preço virar, as liquidações deles aceleram a queda. OI e preço em alta com taxa negativa significam que os shorts estão se montando contra o movimento, e uma alta forte pode fechá-los à força.

Todas as combinações de funding, OI e preço estão em A taxa de funding como indicador de mercado. Na Genesis API, /funding/rates retorna a taxa de cada exchange, também em todos os planos: a taxa por intervalo de funding (funding_pct) e a taxa normalizada para 8 horas (funding_8h_pct). Os endpoints de funding e o histórico de funding liquidado estão em API de taxas de funding, e os campos na documentação.

Python: OI com mais de 5% de alta em uma hora enquanto o preço sobe

O script puxa todo o snapshot em uma chamada e mantém as moedas cujo OI total cresceu mais de 5% em uma hora enquanto o preço subia, com OI de US$ 5 M ou mais. Para cada uma, imprime o detalhamento por exchange: a fatia da exchange no OI e suas variações de OI e de preço na hora. A chave vem da variável de ambiente GENESIS_API_KEY; em 429 e 503, o script espera Retry-After segundos e tenta de novo.

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  # com OI pequeno, uma posição só já o move bastante

def get(path, **params):
    while True:
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):  # rate limit ou reconstrução dos dados
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]

def passes(t):
    oi, px = t.get("oi_change_1h"), t.get("price_change_1h")
    if oi is None or px is None:
        return False
    return (t.get("oi_usd") or 0) >= MIN_OI_USD and oi > 5 and px > 0

def pct(v):
    return "n/d" if v is None else f"{v:+.1f}%"

hits = [r for r in get("/market/open-interest") if passes(r["total"])]
for row in hits:
    t = row["total"]
    print(f"{row['coin']}: OI {pct(t['oi_change_1h'])} em 1 h, "
          f"preço {pct(t['price_change_1h'])}, "
          f"total ${t['oi_usd'] / 1e6:.1f}M")
    exs = sorted(row["exchanges"].items(), reverse=True,
                 key=lambda kv: kv[1].get("oi_usd") or 0)
    for name, m in exs:
        share = (m.get("oi_usd") or 0) / t["oi_usd"] * 100
        print(f"  {name:<8} fatia {share:4.1f}%, "
              f"OI {pct(m.get('oi_change_1h'))}, "
              f"preço {pct(m.get('price_change_1h'))}")

Saída ilustrativa para a moeda XYZ: OI +6,2% em uma hora, preço +3,0%, OI total US$ 48,1 M.

ExchangeFatia do OIOI 1 hPreço 1 h
Binance46,2%+8,0%+3,0%
ByBit27,0%+5,0%+3,1%
OKX17,5%+2,0%+2,9%
Bitget9,3%+9,0%+3,2%

O crescimento é amplo: o OI subiu nas quatro exchanges, e 5% ou mais em três delas. Se os mesmos +6,2% tivessem vindo de uma só exchange que tinha 10% do OI da moeda uma hora antes, o OI dela teria de crescer 62%: 0,10 × 62 = 6,2. Um pico em uma única plataforma costuma indicar um grande jogador isolado, e é cedo para tirar conclusões sobre o mercado a partir dele.

A segunda parte acrescenta o funding: uma chamada a /funding/rates para todas as moedas e, para cada moeda encontrada, a menor e a maior taxa de 8 horas entre as exchanges e em quantas exchanges a taxa é positiva.

# taxas de funding de todas as exchanges: uma chamada cobre todas as moedas
rates = {row["coin"]: row["exchanges"]
         for row in get("/funding/rates")}

for row in hits:
    fr = sorted((e["funding_8h_pct"], e["exchange"])
                for e in rates.get(row["coin"], [])
                if e.get("funding_8h_pct") is not None)
    if not fr:
        print(f"{row['coin']}: sem taxas de funding")
        continue
    (lo, lo_ex), (hi, hi_ex) = fr[0], fr[-1]
    plus = sum(1 for rate, _ in fr if rate > 0)
    print(f"{row['coin']}: funding de 8 h de {lo:+.4f}% ({lo_ex}) "
          f"a {hi:+.4f}% ({hi_ex}), positivo em {plus} de {len(fr)}")

O script faz duas chamadas. Executado uma vez por minuto, são 2 × 60 × 24 × 30 = 86.400 chamadas a cada 30 dias, menos de um quinto da cota de 500K do plano Trial. Para consultar em loop sem gastar cota com dados inalterados, adicione ETag e If-None-Match: as técnicas estão em Como consultar uma API sem bater nos limites, e as cotas e requisições por segundo no guia de limites da Genesis API.

Ressalvas: o que distorce o open interest

Sem código, os mesmos dados estão na tabela OI Tracking do site; suas colunas, filtros e gráficos estão descritos no guia. As cotas e os preços dos planos da API estão na página de preços da Genesis API.

Perguntas e respostas

Qual a diferença entre open interest e volume de negociação?

Volume é a soma das negociações em um período; open interest são as posições que continuam abertas agora. Toda negociação conta para o volume, mas só altera o OI quando os dois lados abrem ou os dois fecham posições. Volume alto com OI estável significa que as posições estão principalmente trocando de mãos. A resposta de /market/open-interest traz os dois números: volume_24h e oi_usd.

Onde obter o histórico de open interest?

A Genesis API não tem histórico: o endpoint retorna o snapshot atual e as variações em 5, 15 e 30 minutos e em 1 hora, então uma série longa é algo que você monta salvando respostas. As exchanges oferecem histórico em suas próprias APIs: a Binance, do último mês; a Bybit, em passos de 5 minutos a um dia; a OKX, as últimas 1.440 entradas. No site, o botão Gráfico do OI Tracking abre um gráfico de OI no plano Pro do site.

Com que frequência os dados de OI são atualizados na Genesis API?

A atualidade depende do plano da API: 60 segundos no Trial, 30 no Start, 10 no Pro e 5 no Max. O horário de montagem do snapshot está em meta.updated_at, e o atraso do seu plano em meta.freshness_sec. Consultar mais rápido que esse atraso não traz nada, e com If-None-Match um snapshot inalterado volta como 304, que não consome sua cota.

O que significa open interest em alta com o preço em queda?

Normalmente novos shorts estão sendo abertos, ou alguém está comprando longs contra o movimento. Se ao mesmo tempo o funding ficar negativo, os shorts também estão pagando aos longs para manter suas posições. Uma reversão brusca para cima nesse momento pode forçar os shorts a fechar e acelerar a alta.