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-interestcobre 13+ exchanges, com a soma emtotal, o detalhamento emexchangese 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.
| Medida | O que mostra | A armadilha |
|---|---|---|
| OI em moedas | Quantas posições estão abertas | O tamanho do contrato varia por exchange |
| OI em dólares | Quanto dinheiro está em posições | Se move com o preço |
| OI total | Posições em todo o mercado | Depende de quais exchanges são somadas |
| OI por exchange | Onde as posições estão sendo montadas | Os 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:
| Exchange | OI atual | Histórico de OI | Atenção |
|---|---|---|---|
| Binance | GET /fapi/v1/openInterest, um symbol por requisição | GET /futures/data/openInterestHist | O histórico cobre apenas o último mês |
| Bybit | GET /v5/market/tickers, todos os símbolos em uma requisição | GET /v5/market/open-interest, passos de 5min a 1d | openInterest conta os dois lados, singleOpenInterest um |
| OKX | GET /api/v5/public/open-interest | GET /api/v5/rubik/stat/contracts/open-interest-history | oi em contratos, oiCcy em moedas, oiUsd em dólares |
| Hyperliquid | POST /info, tipo metaAndAssetCtxs | Não consta na documentação | OI 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",
…
}
}
}
| Campo | Significado |
|---|---|
total.oi_usd / total.oi_tokens | OI total em dólares e em moedas |
total.avg_price | Preço médio da moeda entre as exchanges |
total.volume_24h | Volume de 24 h, USD |
total.oi_change_5m/15m/30m/1h | Variação do OI em 5, 15 e 30 minutos e 1 hora, % |
total.price_change_5m/15m/30m/1h | Variaçã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ço | OI | Leitura usual | O que verificar |
|---|---|---|---|
| Sobe | Sobe | Posições novas na direção do movimento, a alta tem dinheiro por trás | Funding: muito positivo significa excesso de longs |
| Cai | Sobe | Shorts se acumulam, ou longs compram durante a queda | Funding: muito negativo significa risco de short squeeze |
| Sobe | Cai | A alta se sustenta no fechamento de shorts, sem dinheiro novo | Se o OI cai em todas as exchanges |
| Cai | Cai | Longs estão sendo fechados, por escolha ou à força | OI 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.
| Exchange | Fatia do OI | OI 1 h | Preço 1 h |
|---|---|---|---|
| Binance | 46,2% | +8,0% | +3,0% |
| ByBit | 27,0% | +5,0% | +3,1% |
| OKX | 17,5% | +2,0% | +2,9% |
| Bitget | 9,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
- Os métodos das exchanges diferem. A Bybit tem dois campos de OI que diferem por um fator de dois, a OKX conta
oiem contratos cujo tamanho a exchange define, e o ticker de uma mesma moeda pode variar: PEPE em uma exchange, 1000PEPE em outra. Variações percentuais são a comparação mais segura entre exchanges: não dependem das unidades enquanto cada exchange contar do mesmo jeito de uma leitura para a seguinte. - Os dólares dependem do preço. O
oi_usdde cada exchange é o OI dela em moedas vezes o preço dela, então, em um movimento brusco, o OI em dólares muda mesmo com as posições paradas. - Liquidações causam picos. Em uma cascata de liquidações, as exchanges fecham posições à força: o OI cai vários pontos percentuais em minutos enquanto o preço se move com força. Um colapso de
oi_change_5mjunto com umprice_change_5mbrusco é a assinatura de liquidações. - OI pequeno gera porcentagens grandes. Em uma moeda com algumas centenas de milhares de dólares de OI, uma posição o move em dezenas de pontos percentuais, e um limite em
total.oi_usdfiltra esse ruído. - O total depende de quais exchanges ele inclui. Se uma moeda ganha futuros em mais uma exchange, o OI total cresce graças à nova plataforma, enquanto nas demais nada mudou. Confira o crescimento do total com o detalhamento de
exchanges.
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.