Volume 24h—Contratos em aberto—Liquidações 24h$1.36BLong/Short 24h—Dominância BTC—Dominância ETH—
App
Idioma ▾
R$ BRL ▾
/api/derivatives/coins
GETDisponível

Screener de moedas em derivativos

Screener de moedas em derivativos (preço, OI, financiamento, RSI, long/short, liquidações; filtrável)

GET/api/derivatives/coins

Requisição

Parâmetros de consulta

NomeTipoObrigatórioPadrãoValores aceitosDescrição
limitintegerOpcional50≤ 500Número de linhas a retornar. Exemplo: 50
offsetintegerOpcional0—Deslocamento da paginação.
onlyWatchliststringOpcional—1=1 restringe à lista de favoritos de quem faz a chamada (exige JWT, sem cache).
exchangesstringOpcional——Lista de permissões de corretoras separadas por vírgula (27 corretoras); 400 se nenhuma for válida.
minMarketCapnumberOpcional——Filtro: capitalização de mercado mínima (USD).
maxMarketCapnumberOpcional——Filtro: capitalização de mercado máxima (USD).
minOinumberOpcional——Filtro: contratos em aberto mínimos (USD).
maxOinumberOpcional——Filtro: contratos em aberto máximos (USD).
minFundingnumberOpcional——Filtro: taxa de financiamento mínima.
maxFundingnumberOpcional——Filtro: taxa de financiamento máxima.
minRsi1hnumberOpcional——Filtro: RSI de 1h mínimo.
maxRsi1hnumberOpcional——Filtro: RSI de 1h máximo.
minRsi4hnumberOpcional——Filtro: RSI de 4h mínimo.
maxRsi4hnumberOpcional——Filtro: RSI de 4h máximo.
minRsi1dnumberOpcional——Filtro: RSI de 1d mínimo.
maxRsi1dnumberOpcional——Filtro: RSI de 1d máximo.
minChangePctnumberOpcional——Filtro: variação mínima em 24h (%).
maxChangePctnumberOpcional——Filtro: variação máxima em 24h (%).
minVolumenumberOpcional——Filtro: volume mínimo de 24h (USD).
maxVolumenumberOpcional——Filtro: volume máximo de 24h (USD).
minLiq24hnumberOpcional——Filtro: liquidações mínimas em 24h (USD).
maxLiq24hnumberOpcional——Filtro: liquidações máximas em 24h (USD).
minLsAccountnumberOpcional——Filtro: razão long/short de contas mínima.
maxLsAccountnumberOpcional——Filtro: razão long/short de contas máxima.
minOiChg1hnumberOpcional——Filtro: variação mínima do OI em 1h (%).
maxOiChg1hnumberOpcional——Filtro: variação máxima do OI em 1h (%).
minOiChg24hnumberOpcional——Filtro: variação mínima do OI em 24h (%).
maxOiChg24hnumberOpcional——Filtro: variação máxima do OI em 24h (%).

Exemplo de requisição

curl -s "https://www.coinboss.com/api/derivatives/coins?limit=50"

Campos da resposta

A tabela de campos é gerada a partir de respostas reais, portanto lista exatamente o que o endpoint retorna. Os caminhos usam a[] para itens de array e {*} para objetos indexados por um nome dinâmico, como uma moeda ou uma corretora.

CampoTipoUnidadeDescrição
successboolean—true quando a requisição foi bem-sucedida. Em caso de falha, o corpo é `{ success: false, code, error, request_id }`.
nownumbermsHorário do servidor em que a resposta foi montada.
totalnumber—Total.
dataarray—Conteúdo da resposta.
data[]object—Conteúdo da resposta.
data[].coinstring—Símbolo da moeda, em maiúsculas (por exemplo, BTC).
data[].namestring—Nome.
data[].image_urlstring—Caminho do ícone, de mesma origem, servido pela CoinBoss; null quando não existe ícone verificado.
data[].market_capnumber—Capitalização de mercado.
data[].pricenumber—Último preço na moeda de cotação (USD ou USDT, salvo indicação em contrário).
data[].change_pctnumber%Variação percentual.
data[].volume_usdnumberUSDVolume em valor nocional em USD.
data[].rsi_1hnumber—RSI(14) em candles de 1h.
data[].rsi_4hnumber—RSI(14) em candles de 4h.
data[].rsi_1dnumber—RSI(14) em candles diários.
data[].basis_pctnumber|null%(futuros − spot) / spot × 100.
data[].basis_annual_pctnull% per yearBase anualizada pelos dias até o vencimento.
data[].oi_usdnumberUSDContratos em aberto em valor nocional em USD.
data[].funding_avgnumber—Taxa de financiamento média entre corretoras.
data[].ls_accountnumber|null—Razão long/short por contas.
data[].ls_takernumber|null—Razão compra/venda taker.
data[].liq_24h_usdnumberUSDLiquidações em 24h.
data[].oi_chg_1h_pctnumber%Variação dos contratos em aberto em 1h.
data[].oi_chg_24h_pctnumber%Variação dos contratos em aberto em 24h.
data[].vol_chg_24h_pctnumber%Variação do volume em 24h.
data[].updated_atnumbermsQuando esta linha foi atualizada pela última vez.

Gerada 2026-11-11 23:00 UTC a partir de 1 respostas reais.

Exemplo de resposta

/api/derivatives/coins?limit=50 · Resposta real capturada 2026-11-13 03:57:37 UTC. Arrays e mapas longos são encurtados para exibição: data tinha 50 itens.

  • {
    • "success": true,
    • "now": 1794542257654,
    • "total": 800,
    • "data": [
      • { … 21 },
      • { … 21 }
      ]
    }

Detalhes

Autenticação
Nenhuma. Endpoint público.
Limite de requisições
1200 requisições por minuto por IP
Cache do servidor
5s
Microcache de borda
10s
Frequência de atualização
métricas derivadas: as 100 principais moedas a cada 5 min, posições 101-400 a cada 15 min, posições 401-980 a cada 30 min; tickers a cada 60 s; preço ao vivo enviado por WebSocket
Janela
snapshot mais recente (tickers de até 1 h)
Fontes de dados
Métricas de derivativos por moeda pré-calculadas internamente a partir dos coletores próprios da CoinBoss nas corretoras (25 fontes, p. ex., binance, okx, bybit, bitget, gate, hyperliquid); nomes, ícones e capitalização de mercado das moedas vêm do agregador terceiro de dados de mercado.
Cobertura de corretoras
até 980 moedas ranqueadas pelos contratos em aberto agregados (801 linhas no momento da auditoria); o parâmetro `exchanges` é restrito a uma lista de permissões de 27 corretoras
Paginação
limit (padrão 50, máx. 500)
Ordenação
oi_usd decrescente
Unidades
oi / volume / liquidations in USD; change and RSI fields as percent / index values; funding as raw fraction; market_cap in USD
Método
oi_usd = cross-exchange open interest (all contract types, multiplier contracts folded); RSI(14) on 1 h / 4 h (aggregated from 1 h) / 1 d klines; oi_chg = change vs hourly archive; liq_24h_usd = 24 h SUM(value_usd); with the `exchanges` param metrics are recomputed at request time for the selected venues
Timestamps
Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
Formato da resposta
json
Estabilidade
Estável

Status ao vivo

DisponívelVerificado 2026-11-13 03:57:37 UTCHTTP 20025 msEsquema confereDado mais recente: há 4m

Disponibilidade, últimos 30 dias

100% de 411 verificações aprovadas

Erros

As chamadas com falha têm o mesmo formato em todos os endpoints. A lista completa está na página de erros. Erros e limites de requisições →

CódigoHTTPSignificadoO que fazer
INVALID_PARAM400Falta um parâmetro obrigatório ou um valor não é aceito. `param` indica o nome do parâmetro quando ele é conhecido.Não repita a requisição sem alterações; corrija-a.
UNAUTHORIZED401O cabeçalho `CB-API-KEY` foi enviado, mas a chave é desconhecida ou foi revogada. Dados públicos não exigem chave — remova o cabeçalho ou use uma chave válida.Não repita a requisição sem alterações.
FORBIDDEN403A rota não faz parte da API pública (é interna ou exclusiva de conta).Não tente novamente.
NOT_FOUND404Rota desconhecida, ou a moeda / corretora / fundo solicitado não existe.Não tente novamente; confira o caminho e os identificadores no catálogo.
RATE_LIMITED429Mais requisições do que o limite por minuto. `Retry-After` informa os segundos a aguardar.Aguarde `Retry-After` e então tente novamente com backoff.
INTERNAL500Erro inesperado do servidor. A mensagem é genérica de propósito; cite `request_id` ao reportá-lo.Tente novamente uma vez após alguns segundos; se persistir, reporte-o com o ID da requisição.
UPSTREAM_FAILED503A fonte de dados por trás deste endpoint não respondeu a tempo. Nenhum número desatualizado ou substituto é retornado em seu lugar.Tente novamente com backoff; consulte a página de status.
UNAVAILABLE501 / 503O conjunto de dados ainda não está pronto temporariamente (aquecimento do cache) ou o endpoint ainda não tem uma fonte pública lícita.Tente novamente mais tarde; o catálogo marca os endpoints que são indisponíveis por design.
REQUEST_FAILED200Alguns endpoints mais antigos respondem HTTP 200 com `success: false`. Verifique sempre `success`, não apenas o status HTTP.Depende da mensagem; trate como uma requisição com falha.

Experimente

GET/api/derivatives/coinsDisponível
Parâmetros

integer · padrão 50 · máx. 500 — Number of rows to return.

integer · padrão 0 — Pagination offset.

string — =1 restricts to the caller watchlist (JWT required, uncached).

string — Comma-separated exchange whitelist (27 venues); 400 if none valid.

number — Filter: minimum market cap (USD).

number — Filter: maximum market cap (USD).

number — Filter: minimum open interest (USD).

number — Filter: maximum open interest (USD).

number — Filter: minimum funding rate.

number — Filter: maximum funding rate.

number — Filter: minimum 1h RSI.

number — Filter: maximum 1h RSI.

number — Filter: minimum 4h RSI.

number — Filter: maximum 4h RSI.

number — Filter: minimum 1d RSI.

number — Filter: maximum 1d RSI.

number — Filter: minimum 24h change (%).

number — Filter: maximum 24h change (%).

number — Filter: minimum 24h volume (USD).

number — Filter: maximum 24h volume (USD).

number — Filter: minimum 24h liquidations (USD).

number — Filter: maximum 24h liquidations (USD).

number — Filter: minimum account long/short ratio.

number — Filter: maximum account long/short ratio.

number — Filter: minimum 1h OI change (%).

number — Filter: maximum 1h OI change (%).

number — Filter: minimum 24h OI change (%).

number — Filter: maximum 24h OI change (%).

URL da requisiçãohttps://www.coinboss.com/api/derivatives/coins?limit=50
Escolha um endpoint e clique em “Enviar requisição”. A resposta, os cabeçalhos e o tempo de resposta aparecerão aqui.