Volume 24h—Contratos em aberto—Liquidações 24h$1.36B Long/Short 24h—Dominância BTC—Dominância ETH—

App

Idioma ▾

R$ BRL ▾

/api/sd/coin

GETDisponível

Pacote completo da moeda (OI, financiamento, liquidações, volume, long/short)

Camada de dados própria: pacote completo da moeda em uma só chamada (OI / financiamento / liquidações / volume / long-short, com isolamento de falhas por bloco)

GET/api/sd/coin

Requisição

Parâmetros de consulta

Nome	Tipo	Obrigatório	Padrão	Valores aceitos	Descrição
coin	string	Obrigatório	—	—	Símbolo da moeda; 400 quando ausente. Alias: `base`. Exemplo: BTC

Exemplo de requisição

curl -s "https://www.coinboss.com/api/sd/coin?coin=BTC"

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.

Campo	Tipo	Unidade	Descrição
success	boolean	—	true quando a requisição foi bem-sucedida. Em caso de falha, o corpo é `{ success: false, code, error, request_id }`.
coin	string	—	Símbolo da moeda, em maiúsculas (por exemplo, BTC).
now	number	ms	Horário do servidor em que a resposta foi montada.
oi	object	—	O mesmo objeto que `/api/sd/oi` retorna para esta moeda.
oi.coin	string	—	Símbolo da moeda, em maiúsculas (por exemplo, BTC).
oi.now	number	ms	Horário do servidor em que a resposta foi montada.
oi.total_usd	number	USD	Contratos em aberto em todas as corretoras e contratos incluídos, conforme cada corretora os reporta (valor nocional em USD).
oi.n_exchanges	number	—	Número de corretoras no total.
oi.n_contracts	number	—	Número de contratos no total.
oi.asof	number	ms	Horário de atualização mais recente entre as linhas incluídas.
oi.total_usd_single_adjusted	number	USD	`total_usd` com os números das corretoras que reportam os dois lados (`double_sided.exchanges`) divididos por dois, de modo que cada corretora conte um só lado.
oi.double_sided	object	—	Corretoras que sabidamente publicam os contratos em aberto long + short como um único número.
oi.double_sided.exchanges	array	—	Corretoras.
oi.double_sided.exchanges[]	string	—	Corretoras.
oi.double_sided.oi_usd	number	USD	Contratos em aberto reportados por essas corretoras antes da divisão por dois.
oi.by_kind	object	—	Divisão entre linear / inverso.
oi.by_kind.linear_usd	number	USD	Contratos em aberto dos contratos lineares (com margem e liquidação em stablecoin ou USD).
oi.by_kind.inverse_usd	number	USD	Contratos em aberto dos contratos inversos (com margem em cripto), convertidos para USD pelo preço do contrato.
oi.by_margin	object	—	Divisão por moeda de margem.
oi.by_margin.other	number	USD	Outras moedas de margem (por exemplo, corretoras com liquidação em USD, como a CME).
oi.by_margin.usdt	number	USD	Contratos com margem em USDT.
oi.by_margin.usdc	number	USD	Contratos com margem em USDC. pode estar ausente
oi.by_margin.coin	number	USD	Contratos com margem em cripto. pode estar ausente
oi.by_contract_type	object	—	Divisão entre perpétuo / com vencimento.
oi.by_contract_type.perpetual_usd	number	USD	Contratos perpétuos.
oi.by_contract_type.delivery_usd	number	USD	Futuros datados (contratos com vencimento).
oi.change	object	—	Variação dos contratos em aberto em 1h / 4h / 24h, calculada sobre o mesmo conjunto de contratos nas duas pontas. chaves dinâmicas: h1,h4,h24
oi.change.{*}	object	—	Variação no período indicado.
oi.change.{*}.pct	number	%	Variação percentual entre `prev` e `cur`.
oi.change.{*}.cur	number	USD	Soma atual sobre os contratos pareados.
oi.change.{*}.prev	number	USD	Soma sobre os mesmos contratos em `prev_ts`.
oi.change.{*}.n_matched	number	—	Contratos (ou corretoras) presentes nas duas pontas.
oi.change.{*}.n_total	number	—	Contratos (ou corretoras) presentes agora.
oi.change.{*}.matched_share_pct	number	%	Parcela dos contratos em aberto atuais coberta pelo conjunto pareado. pode estar ausente
oi.change.{*}.prev_ts	number	ms	Horário do snapshot de base.
oi.change.{*}.span_min	number	min	Distância real entre a base e o momento atual.
oi.change.{*}.basis	string	—	De qual série de snapshots vem a base.
oi.change.{*}.frozen_excluded	object	—	Linhas deixadas de fora da variação porque seu valor não se moveu entre os dois snapshots (a fonte não está atualizando). pode estar ausente
oi.change.{*}.frozen_excluded.n_baseline	number	—	Itens no snapshot de base. pode estar ausente
oi.change.{*}.frozen_excluded.n_current	number	—	Itens no snapshot atual. pode estar ausente
oi.change.{*}.frozen_excluded.cur_usd	number	USD	Valor atual. pode estar ausente
oi.change.{*}.frozen_excluded.prev_usd	number	USD	Valor de base. pode estar ausente
oi.by_exchange	array	—	Detalhamento por corretora.
oi.by_exchange[]	object	—	Detalhamento por corretora.
oi.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
oi.by_exchange[].oi_usd	number	USD	Contratos em aberto em valor nocional em USD.
oi.by_exchange[].share_pct	number	%	Participação no total.
oi.by_exchange[].n_contracts	number	—	Número de contratos.
oi.by_exchange[].linear_usd	number	USD	Contratos lineares.
oi.by_exchange[].inverse_usd	number	USD	Contratos inversos (com margem em cripto).
oi.by_exchange[].perpetual_usd	number	USD	Contratos perpétuos.
oi.by_exchange[].delivery_usd	number	USD	Contratos com vencimento.
oi.by_exchange[].oi_side	string	—	`double` quando a corretora reporta os dois lados em um único número, `single` quando reporta um lado, `unstated` quando a corretora não documenta isso.
oi.by_exchange[].oi_usd_single_adjusted	number\|null	USD	Equivalente unilateral; null quando a convenção de lado não é declarada.
oi.by_exchange[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
oi.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
oi.by_exchange[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
oi.contracts	array	—	Linhas por contrato.
oi.contracts[]	object	—	Linhas por contrato.
oi.contracts[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
oi.contracts[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
oi.contracts[].native_symbol	string\|null	—	Símbolo exatamente como a corretora o escreve.
oi.contracts[].oi_usd	number	USD	Contratos em aberto em valor nocional em USD.
oi.contracts[].oi_side	string	—	`double`, `single` ou `unstated`: se a corretora reporta os dois lados dos contratos em aberto em um único número.
oi.contracts[].oi_usd_single	number\|null	USD	Equivalente unilateral de `oi_usd`; null quando a convenção de lado não é declarada.
oi.contracts[].margin	string	—	Classe da moeda de margem: `usdt`, `usdc`, `coin` ou `other`.
oi.contracts[].kind	string	—	`linear` ou `inverse`.
oi.contracts[].contract_type	string	—	`perpetual` ou `delivery`.
oi.contracts[].expiry_ts	number\|null	ms	Vencimento de um contrato com vencimento; null para perpétuos ou quando não é publicado.
oi.contracts[].margin_basis	string	—	Como a classe de margem foi determinada (pela especificação do contrato ou pelo padrão da corretora).
oi.contracts[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
oi.contracts[].age_s	number	s	Segundos desde a última atualização desta linha.
oi.contracts[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
oi.contracts[].collector	string	—	Coletor interno que produziu a linha.
oi.contracts[].included_since	number\|null	ms	Quando este contrato entrou nos totais; null para o conjunto base.
oi.coverage	object	—	O que está e o que não está incluído nos números acima. Compare isto antes de comparar os totais com outra fonte.
oi.coverage.included_exchanges	array	—	Corretoras cujos dados estão incluídos nos totais.
oi.coverage.included_exchanges[]	string	—	Corretoras incluídas nos totais.
oi.coverage.pending	array	—	Contratos que são coletados, mas ainda não estão incluídos nos totais (por exemplo, enquanto seu próprio histórico de 25 horas ainda está sendo formado). São listados com o valor atual para que a lacuna fique visível.
oi.coverage.pending[]	object	—	Itens coletados, mas ainda não incluídos.
oi.coverage.pending[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
oi.coverage.pending[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
oi.coverage.pending[].native_symbol	string	—	Símbolo exatamente como a corretora o escreve.
oi.coverage.pending[].margin	string	—	Classe da moeda de margem.
oi.coverage.pending[].contract_type	string	—	`perpetual` ou `delivery`.
oi.coverage.pending[].oi_usd	number	USD	Contratos em aberto em valor nocional em USD.
oi.coverage.pending[].age_s	number	s	Segundos desde a última atualização desta linha.
oi.coverage.pending[].reason	string	—	Código do motivo.
oi.coverage.pending[].detail	string\|null	—	Detalhe.
oi.coverage.pending_usd	number\|null	USD	Soma dos contratos pendentes, que não faz parte de `total_usd`.
oi.coverage.stale_excluded	array	—	Linhas deixadas de fora porque sua última atualização está fora da janela de uso. vazio nas amostras usadas para gerar esta tabela
oi.coverage.unavailable	array	—	Pares corretora / contrato que não puderam ser incluídos, cada um com o motivo. Nunca são contados como 0.
oi.coverage.unavailable[]	object	—	Itens para os quais não há dados disponíveis, com os motivos. Nunca são reportados como 0.
oi.coverage.unavailable[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
oi.coverage.unavailable[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
oi.coverage.unavailable[].native_symbol	string	—	Símbolo exatamente como a corretora o escreve.
oi.coverage.unavailable[].margin	string	—	Classe da moeda de margem.
oi.coverage.unavailable[].contract_type	string	—	`perpetual` ou `delivery`.
oi.coverage.unavailable[].reason	string	—	Código do motivo.
oi.coverage.unavailable[].detail	string	—	Detalhe.
oi.method	object	—	Descrição em texto simples das fórmulas usadas nesta resposta.
oi.method.total	string	—	Total.
oi.method.usd	string	USD	Valor.
oi.method.change_h1_h4	string	—	Definição em texto simples das variações de 1h e 4h dos contratos em aberto: cada contrato é comparado com o seu próprio snapshot mais próximo do início da janela.
oi.method.change_h24	string	—	Definição em texto simples da variação de 24h dos contratos em aberto: pareamento dentro da mesma corretora com o snapshot horário mais próximo de 24 horas atrás, excluídas as linhas de base congeladas.
oi.method.oi_side	string	—	`double`, `single` ou `unstated`: se a corretora reporta os dois lados dos contratos em aberto em um único número.
funding	object	—	O mesmo objeto que `/api/sd/funding` retorna para esta moeda.
funding.coin	string	—	Símbolo da moeda, em maiúsculas (por exemplo, BTC).
funding.now	number	ms	Horário do servidor em que a resposta foi montada.
funding.unit	string	—	Unidade de todos os campos de taxa desta resposta: `fraction` (0.0001 = 0.01 %).
funding.avg_8h	number	fraction per 8h	Média simples das taxas normalizadas para 8h, um contrato por corretora.
funding.oi_weighted_8h	number	fraction per 8h	Média das taxas normalizadas para 8h, ponderada pelos contratos em aberto.
funding.apr_pct	number	% per year	Anualização simples: taxa de 8h × 3 × 365 × 100.
funding.apr_basis	string	—	Em qual agregado se baseia o `apr_pct` de destaque.
funding.n_exchanges	number	—	Número de corretoras que contribuem.
funding.n_normalized	number	—	Corretoras cujo intervalo de financiamento é conhecido e pôde ser normalizado para 8h.
funding.n_unknown_interval	number	—	Corretoras deixadas de fora dos agregados porque seu intervalo de financiamento é desconhecido.
funding.settled_cum_7d	object	—	Soma das taxas de financiamento efetivamente liquidadas nos últimos 7 dias, em média entre as corretoras com histórico de liquidações de financiamento.
funding.settled_cum_7d.avg	number	fraction	Média simples entre corretoras.
funding.settled_cum_7d.oi_weighted	number	fraction	Média ponderada pelos contratos em aberto.
funding.settled_cum_7d.n	number	—	Corretoras com a janela completa.
funding.settled_cum_30d	object	—	O mesmo, em 30 dias.
funding.settled_cum_30d.avg	number	fraction	Média simples entre corretoras.
funding.settled_cum_30d.oi_weighted	number	fraction	Média ponderada pelos contratos em aberto.
funding.settled_cum_30d.n	number	—	Corretoras com a janela completa.
funding.by_exchange	array	—	Uma linha por corretora: seu contrato principal para esta moeda (o de maior volume de contratos em aberto).
funding.by_exchange[]	object	—	Detalhamento por corretora.
funding.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
funding.by_exchange[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
funding.by_exchange[].margin	string	—	Classe da moeda de margem.
funding.by_exchange[].kind	string	—	Tipo.
funding.by_exchange[].primary	boolean	—	True para o contrato que representa a sua corretora nos agregados (o de maior volume de contratos em aberto); sempre true nesta lista.
funding.by_exchange[].rate	number	—	Taxa.
funding.by_exchange[].interval_h	number	h	Intervalo.
funding.by_exchange[].rate_8h	number	—	Taxa normalizada para um período de 8 horas.
funding.by_exchange[].apr_pct	number	% per year	Percentual anualizado.
funding.by_exchange[].next_funding_time	number\|null	ms	Timestamp.
funding.by_exchange[].next_derived	boolean	—	True quando `next_funding_time` não foi publicado pela corretora e é inferido como a próxima hora cheia em UTC (somente corretoras com liquidação horária).
funding.by_exchange[].predicted_rate	null	—	Taxa indicativa do próximo período; null quando não é publicada.
funding.by_exchange[].oi_usd	number\|null	USD	Contratos em aberto em valor nocional em USD.
funding.by_exchange[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
funding.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
funding.by_exchange[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
funding.by_exchange[].settled	object\|null	—	Registros efetivos de liquidação de financiamento; null quando não existe histórico público.
funding.by_exchange[].settled.last_rate	number	fraction	Taxa de financiamento efetivamente cobrada na liquidação mais recente (`last_time`), obtida do histórico de financiamento da corretora (0.0001 = 0.01 %). pode estar ausente
funding.by_exchange[].settled.last_time	number	ms	Timestamp. pode estar ausente
funding.by_exchange[].settled.interval_h	number	h	Intervalo. pode estar ausente
funding.by_exchange[].settled.cum_7d	number	fraction	Soma das taxas de financiamento liquidadas neste contrato nos últimos 7 dias (0.0015 = 0.15 %); null quando nenhuma liquidação de financiamento foi registrada. pode estar ausente
funding.by_exchange[].settled.n_7d	number	count	Número de registros de liquidação de financiamento coletados nos últimos 7 dias. pode estar ausente
funding.by_exchange[].settled.n_7d_expected	number	count	Liquidações de financiamento que uma janela completa de 7 dias deveria conter: 168 ÷ intervalo de liquidação em horas; null quando o intervalo é desconhecido. pode estar ausente
funding.by_exchange[].settled.cum_7d_complete	boolean	—	True quando o histórico cobre o início da janela de 7 dias e contém pelo menos 90 % das liquidações de financiamento esperadas. pode estar ausente
funding.by_exchange[].settled.cum_30d	number	fraction	Soma das taxas de financiamento liquidadas neste contrato nos últimos 30 dias (0.006 = 0.6 %). pode estar ausente
funding.by_exchange[].settled.n_30d	number	count	Número de registros de liquidação de financiamento coletados nos últimos 30 dias. pode estar ausente
funding.by_exchange[].settled.n_30d_expected	number	count	Liquidações de financiamento que uma janela completa de 30 dias deveria conter: 720 ÷ intervalo de liquidação em horas; null quando o intervalo é desconhecido. pode estar ausente
funding.by_exchange[].settled.cum_30d_complete	boolean	—	True quando o histórico cobre o início da janela de 30 dias e contém pelo menos 90 % das liquidações de financiamento esperadas. pode estar ausente
funding.by_exchange[].settled.history_from	number	ms	Registro mais antigo mantido. pode estar ausente
funding.other_contracts	array	—	Outros contratos da mesma moeda (USDC, com margem em cripto, …). Não fazem parte dos agregados.
funding.other_contracts[]	object	—	Um contrato de financiamento adicional de uma corretora (com margem em cripto, USDC, …) que não é o seu contrato principal e é excluído dos agregados.
funding.other_contracts[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
funding.other_contracts[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
funding.other_contracts[].margin	string	—	Classe da moeda de margem.
funding.other_contracts[].kind	string	—	Tipo.
funding.other_contracts[].primary	boolean	—	False em todas as linhas desta lista: o contrato não é o que representa a sua corretora nos agregados.
funding.other_contracts[].rate	number	—	Taxa.
funding.other_contracts[].interval_h	number\|null	h	Intervalo.
funding.other_contracts[].rate_8h	number\|null	—	Taxa normalizada para um período de 8 horas.
funding.other_contracts[].apr_pct	number\|null	% per year	Percentual anualizado.
funding.other_contracts[].next_funding_time	number\|null	ms	Timestamp.
funding.other_contracts[].next_derived	boolean	—	True quando `next_funding_time` não foi publicado pela corretora e é inferido como a próxima hora cheia em UTC (somente corretoras com liquidação horária).
funding.other_contracts[].predicted_rate	number\|null	—	Taxa indicativa do próximo período; null quando não é publicada.
funding.other_contracts[].oi_usd	number\|null	USD	Contratos em aberto em valor nocional em USD.
funding.other_contracts[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
funding.other_contracts[].age_s	number	s	Segundos desde a última atualização desta linha.
funding.other_contracts[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
funding.other_contracts[].settled	object\|null	—	Registros efetivos de liquidação de financiamento; null quando não existe histórico público.
funding.other_contracts[].settled.last_rate	number	fraction	Taxa de financiamento efetivamente cobrada na liquidação mais recente (`last_time`), obtida do histórico de financiamento da corretora (0.0001 = 0.01 %). pode estar ausente
funding.other_contracts[].settled.last_time	number	ms	Timestamp. pode estar ausente
funding.other_contracts[].settled.interval_h	number	h	Intervalo. pode estar ausente
funding.other_contracts[].settled.cum_7d	number	fraction	Soma das taxas de financiamento liquidadas neste contrato nos últimos 7 dias (0.0015 = 0.15 %); null quando nenhuma liquidação de financiamento foi registrada. pode estar ausente
funding.other_contracts[].settled.n_7d	number	count	Número de registros de liquidação de financiamento coletados nos últimos 7 dias. pode estar ausente
funding.other_contracts[].settled.n_7d_expected	number	count	Liquidações de financiamento que uma janela completa de 7 dias deveria conter: 168 ÷ intervalo de liquidação em horas; null quando o intervalo é desconhecido. pode estar ausente
funding.other_contracts[].settled.cum_7d_complete	boolean	—	True quando o histórico cobre o início da janela de 7 dias e contém pelo menos 90 % das liquidações de financiamento esperadas. pode estar ausente
funding.other_contracts[].settled.cum_30d	number	fraction	Soma das taxas de financiamento liquidadas neste contrato nos últimos 30 dias (0.006 = 0.6 %). pode estar ausente
funding.other_contracts[].settled.n_30d	number	count	Número de registros de liquidação de financiamento coletados nos últimos 30 dias. pode estar ausente
funding.other_contracts[].settled.n_30d_expected	number	count	Liquidações de financiamento que uma janela completa de 30 dias deveria conter: 720 ÷ intervalo de liquidação em horas; null quando o intervalo é desconhecido. pode estar ausente
funding.other_contracts[].settled.cum_30d_complete	boolean	—	True quando o histórico cobre o início da janela de 30 dias e contém pelo menos 90 % das liquidações de financiamento esperadas. pode estar ausente
funding.other_contracts[].settled.history_from	number	ms	Registro mais antigo mantido. pode estar ausente
funding.coverage	object	—	O que está e o que não está incluído nos números acima. Compare isto antes de comparar os totais com outra fonte.
funding.coverage.settle_history_exchanges	array	—	Corretoras para as quais são coletados registros efetivos de liquidação de financiamento.
funding.coverage.settle_history_exchanges[]	string	—	ID de corretora para a qual são coletados registros efetivos de liquidação de financiamento desta moeda.
funding.coverage.no_settle_history	array	—	Corretoras sem fonte pública de histórico de liquidações de financiamento; seu `settled` é null.
funding.coverage.no_settle_history[]	string	—	ID de corretora de um contrato principal sem histórico de liquidações de financiamento coletado, de modo que seu bloco `settled` é null.
funding.coverage.unknown_interval	array	—	Linhas cujo intervalo de financiamento não pôde ser determinado. vazio nas amostras usadas para gerar esta tabela
funding.coverage.no_liveness_excluded	array	—	Linhas excluídas porque o contrato não mostra sinal de negociação (sem ticker, contratos em aberto ou cotação recentes). vazio nas amostras usadas para gerar esta tabela
funding.method	object	—	Descrição em texto simples das fórmulas usadas nesta resposta.
funding.method.rate	string	—	Taxa.
funding.method.rate_8h	string	—	Taxa normalizada para um período de 8 horas.
funding.method.apr_pct	string	% per year	Percentual anualizado.
funding.method.aggregate	string	—	Agregado entre corretoras.
funding.method.settled	string	—	Registros efetivos de liquidação de financiamento; null quando não existe histórico público.
funding.method.predicted_rate	string	—	Taxa indicativa do próximo período; null quando não é publicada.
funding.method.liveness	string	—	Regra em texto simples para descartar contratos mortos: uma linha de financiamento só conta se tiver ticker de até 1h, contratos em aberto de até 3h ou cotação própria de até 3h.
liquidations	object	—	O mesmo objeto que `/api/sd/liquidations` retorna para esta moeda.
liquidations.coin	string	—	Símbolo da moeda, em maiúsculas (por exemplo, BTC).
liquidations.now	number	ms	Horário do servidor em que a resposta foi montada.
liquidations.windows	object	—	Totais de cada janela (chaves como `1h`, `4h`, `12h`, `24h`). chaves dinâmicas: 1h,4h,12h,24h
liquidations.windows.{*}	object	—	Valores por janela.
liquidations.windows.{*}.long_usd	number	USD	Posições long liquidadas; null quando nenhuma fonte cobriu a janela.
liquidations.windows.{*}.short_usd	number	USD	Posições short liquidadas; null quando nenhuma fonte cobriu a janela.
liquidations.windows.{*}.total_usd	number	USD	Long + short.
liquidations.windows.{*}.count	number	—	Número de ordens de liquidação.
liquidations.windows.{*}.long_pct	number	%	Participação dos longs no total.
liquidations.windows.{*}.max_order	object	—	Maior liquidação individual na janela.
liquidations.windows.{*}.max_order.exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
liquidations.windows.{*}.max_order.symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
liquidations.windows.{*}.max_order.side	string	—	`long` / `short` ou `buy` / `sell`.
liquidations.windows.{*}.max_order.price	number	—	Último preço na moeda de cotação (USD ou USDT, salvo indicação em contrário).
liquidations.windows.{*}.max_order.qty	number	—	Quantidade.
liquidations.windows.{*}.max_order.contract_multiplier	number	x	Moedas por unidade cotada do contrato da maior ordem (1000 para contratos do tipo 1000PEPE); `price` e `qty` já estão convertidos para moedas unitárias.
liquidations.windows.{*}.max_order.value_usd	number	USD	Valor.
liquidations.windows.{*}.max_order.timestamp	number	ms	Timestamp.
liquidations.by_exchange	object	—	Divisão por corretora em cada janela. chaves dinâmicas: 1h,4h,12h,24h
liquidations.by_exchange.{*}	array	—	Detalhamento por corretora.
liquidations.by_exchange.{*}[]	object	—	Detalhamento por corretora.
liquidations.by_exchange.{*}[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
liquidations.by_exchange.{*}[].long_usd	number	USD	Lado long.
liquidations.by_exchange.{*}[].short_usd	number	USD	Lado short.
liquidations.by_exchange.{*}[].total_usd	number	USD	Total.
liquidations.by_exchange.{*}[].count	number	—	Número de itens.
liquidations.by_exchange.{*}[].share_pct	number	%	Participação no total.
liquidations.last_event_at	number	ms	Horário da liquidação mais recente desta moeda.
liquidations.last_event_age_s	number	s	Segundos desde esse evento.
liquidations.sources	array	—	Estado de cada feed de liquidações: como é coletado e quando entregou dados pela última vez.
liquidations.sources[]	object	—	Fontes de dados.
liquidations.sources[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
liquidations.sources[].via	string	—	Método de coleta (`ws`, `rest`, …).
liquidations.sources[].status	string	—	Estado do feed, avaliado pelos horários dos seus próprios eventos e pelos heartbeats.
liquidations.sources[].feed_last_event_age_s	number\|null	s	Segundos desde o evento.
liquidations.sources[].ws_heartbeat_age_s	number\|null	s	Segundos desde o evento.
liquidations.sources[].judged_by	string	—	A partir de qual timestamp o status foi avaliado.
liquidations.sources[].coin_last_event_age_s	number\|null	s	Segundos desde o evento.
liquidations.sources[].min_event_usd	number	USD	Menor tamanho de ordem que o feed publica; liquidações menores não são visíveis nesta corretora.
liquidations.sources[].note	string\|null	—	Observação.
liquidations.sources[].node_heartbeat_age_s	number	s	Segundos desde o evento. pode estar ausente
liquidations.sources[].pipeline_last_event_age_s	number	s	Segundos desde o evento. pode estar ausente
liquidations.coverage	object	—	O que está e o que não está incluído nos números acima. Compare isto antes de comparar os totais com outra fonte.
liquidations.coverage.collected_exchanges	array	—	Corretoras com feed público de liquidações que a CoinBoss coleta.
liquidations.coverage.collected_exchanges[]	string	—	Corretoras coletadas.
liquidations.coverage.unavailable	array	—	Pares corretora / contrato que não puderam ser incluídos, cada um com o motivo. Nunca são contados como 0.
liquidations.coverage.unavailable[]	object	—	Itens para os quais não há dados disponíveis, com os motivos. Nunca são reportados como 0.
liquidations.coverage.unavailable[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
liquidations.coverage.unavailable[].reason	string	—	Código do motivo.
liquidations.method	object	—	Descrição em texto simples das fórmulas usadas nesta resposta.
liquidations.method.event	string	—	Nota em texto simples sobre o que é um evento de liquidação: uma ordem de liquidação enviada pelo fluxo da corretora ou retornada pela sua API REST pública.
liquidations.method.side	string	—	`long` / `short` ou `buy` / `sell`.
liquidations.method.value_usd	string	USD	Valor.
liquidations.method.dedupe	string	—	Nota em texto simples sobre a deduplicação: os eventos são únicos por corretora, símbolo, lado, preço, valor e timestamp, além do ID da ordem na corretora, quando fornecido.
liquidations.method.null_rule	string	—	Nota em texto simples informando que uma janela sem nenhum evento coletado retorna null, e não 0, e onde são listadas as corretoras sem feed público.
liquidations.method.binance_note	string	—	Ressalva em texto simples de que a Binance envia no máximo uma liquidação por símbolo por segundo, de modo que os totais da Binance são um limite inferior.
liquidations.method.min_event_usd	string	USD	Menor ordem que o feed publica.
volume	object	—	O mesmo objeto que `/api/sd/volume` retorna para esta moeda.
volume.coin	string	—	Símbolo da moeda, em maiúsculas (por exemplo, BTC).
volume.now	number	ms	Horário do servidor em que a resposta foi montada.
volume.futures	object	—	Bloco ou valor do mercado de futuros.
volume.futures.total_usd	number	USD	Volume de futuros de 24h entre corretoras (valor nocional em USD).
volume.futures.n_exchanges	number	—	Número de corretoras que contribuem.
volume.futures.by_exchange	array	—	Detalhamento por corretora.
volume.futures.by_exchange[]	object	—	Detalhamento por corretora.
volume.futures.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
volume.futures.by_exchange[].vol_usd	number	USD	Volume em valor nocional em USD.
volume.futures.by_exchange[].legacy_usd	number	USD	Parte do volume que vem do conjunto de tickers de perpétuos USDT.
volume.futures.by_exchange[].sd_usd	number	USD	Parte que vem de contratos adicionais (USDC, com margem em cripto, com vencimento) já incluídos.
volume.futures.by_exchange[].share_pct	number	%	Participação no total.
volume.futures.change_24h	object	—	Variação em 24h.
volume.futures.change_24h.pct	number	%	Percentual.
volume.futures.change_24h.cur	number	—	Valor atual.
volume.futures.change_24h.prev	number	—	Valor anterior (linha de base).
volume.futures.change_24h.n_matched	number	—	Itens presentes nas duas pontas da comparação.
volume.futures.change_24h.n_total	number	—	Itens presentes agora.
volume.futures.change_24h.prev_ts	number	ms	Horário do snapshot de base.
volume.futures.change_24h.basis	string	—	Preço dos futuros menos o preço spot, ou o bloco de base.
volume.futures.selfdata_contracts	object	—	Contratos adicionais: o que já está incluído e o que ainda está pendente.
volume.futures.selfdata_contracts.included_usd	null	USD	Volume de 24h dos contratos coletados adicionalmente (com margem em cripto, USDC, com vencimento) já contabilizados no total de futuros; null quando nenhum foi contabilizado ainda.
volume.futures.selfdata_contracts.n_included	number	count	Número de contratos coletados adicionalmente contabilizados no total de futuros (os que têm o seu próprio snapshot de cerca de 24 horas atrás).
volume.futures.selfdata_contracts.pending_usd	number\|null	USD	Soma dos itens pendentes, fora do total.
volume.futures.selfdata_contracts.n_pending	number	count	Número de contratos coletados adicionalmente ainda não contabilizados por não terem a sua própria linha de base de 24h atrás; os maiores são listados em `pending`.
volume.futures.selfdata_contracts.pending	array	—	Itens coletados, mas ainda não incluídos.
volume.futures.selfdata_contracts.pending[]	object	—	Itens coletados, mas ainda não incluídos.
volume.futures.selfdata_contracts.pending[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
volume.futures.selfdata_contracts.pending[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
volume.futures.selfdata_contracts.pending[].margin	string	—	Classe da moeda de margem.
volume.futures.selfdata_contracts.pending[].contract_type	string	—	`perpetual` ou `delivery`.
volume.futures.selfdata_contracts.pending[].vol_usd	number	USD	Volume em valor nocional em USD.
volume.futures.selfdata_contracts.pending[].reason	string	—	Código do motivo.
volume.spot	object	—	Bloco ou valor do mercado spot.
volume.spot.total_usd	number	USD	Volume spot de 24h entre corretoras.
volume.spot.n_exchanges	number	—	Número de corretoras que contribuem.
volume.spot.asof	number	ms	Horário do dado mais recente utilizado.
volume.spot.by_exchange	array	—	Detalhamento por corretora.
volume.spot.by_exchange[]	object	—	Detalhamento por corretora.
volume.spot.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
volume.spot.by_exchange[].vol_usd	number	USD	Volume em valor nocional em USD.
volume.spot.by_exchange[].quote	string	—	Moedas de cotação incluídas para esta corretora.
volume.spot.by_exchange[].ts	number	ms	Timestamp.
volume.spot.by_exchange[].price	number	—	Último preço na moeda de cotação (USD ou USDT, salvo indicação em contrário).
volume.spot.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
volume.spot.by_exchange[].share_pct	number	%	Participação no total.
volume.spot.change_24h	object	—	Variação em 24h.
volume.spot.change_24h.pct	number	%	Percentual.
volume.spot.change_24h.cur	number	—	Valor atual.
volume.spot.change_24h.prev	number	—	Valor anterior (linha de base).
volume.spot.change_24h.n_matched	number	—	Itens presentes nas duas pontas da comparação.
volume.spot.change_24h.n_total	number	—	Itens presentes agora.
volume.spot.change_24h.prev_ts	number	ms	Horário do snapshot de base.
volume.spot.change_24h.basis	string	—	Preço dos futuros menos o preço spot, ou o bloco de base.
volume.ratios	object	—	Razões de volume: `futures_to_spot` (volume de futuros de 24h ÷ volume spot de 24h) e `oi_to_futures_volume`; cada uma é null quando falta uma entrada.
volume.ratios.futures_to_spot	number	—	Volume de futuros dividido pelo volume spot.
volume.ratios.oi_to_futures_volume	number	—	Contratos em aberto divididos pelo volume de futuros de 24h.
volume.method	object	—	Descrição em texto simples das fórmulas usadas nesta resposta.
volume.method.futures	string	—	Bloco ou valor do mercado de futuros.
volume.method.spot	string	—	Bloco ou valor do mercado spot.
volume.method.change	string	—	Variação no período indicado.
volume.method.oi_to_futures_volume	string	—	Definição em texto simples de `ratios.oi_to_futures_volume`: total de contratos em aberto em USD ÷ volume de futuros de 24h em USD.
ls	object	—	O mesmo objeto que `/api/sd/ls` retorna para esta moeda.
ls.coin	string	—	Símbolo da moeda, em maiúsculas (por exemplo, BTC).
ls.now	number	ms	Horário do servidor em que a resposta foi montada.
ls.account	object	—	Parcela de todas as contas que estão net long vs. net short.
ls.account.long_pct	number	%	Participação long.
ls.account.short_pct	number	%	Participação short.
ls.account.ratio	number	—	Razão.
ls.account.n_exchanges	number	—	Número de corretoras que contribuem.
ls.account.by_exchange	array	—	Detalhamento por corretora.
ls.account.by_exchange[]	object	—	Detalhamento por corretora.
ls.account.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
ls.account.by_exchange[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
ls.account.by_exchange[].long_pct	number	%	Participação long.
ls.account.by_exchange[].short_pct	number	%	Participação short.
ls.account.by_exchange[].ratio	number	—	Razão.
ls.account.by_exchange[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
ls.account.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
ls.account.by_exchange[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
ls.account.by_exchange[].source	string	—	De onde vem o valor.
ls.account.by_exchange[].period	string	—	Período.
ls.top_account	object	—	O mesmo, restrito aos top traders definidos pela corretora.
ls.top_account.long_pct	number\|null	%	Participação long.
ls.top_account.short_pct	number\|null	%	Participação short.
ls.top_account.ratio	number\|null	—	Razão.
ls.top_account.n_exchanges	number	—	Número de corretoras que contribuem.
ls.top_account.by_exchange	array	—	Detalhamento por corretora.
ls.top_account.by_exchange[]	object	—	Detalhamento por corretora.
ls.top_account.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
ls.top_account.by_exchange[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
ls.top_account.by_exchange[].long_pct	number	%	Participação long.
ls.top_account.by_exchange[].short_pct	number	%	Participação short.
ls.top_account.by_exchange[].ratio	number	—	Razão.
ls.top_account.by_exchange[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
ls.top_account.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
ls.top_account.by_exchange[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
ls.top_account.by_exchange[].source	string	—	De onde vem o valor.
ls.top_account.by_exchange[].period	string	—	Período.
ls.top_position	object	—	Participação long vs. short das posições mantidas pelos top traders.
ls.top_position.long_pct	number\|null	%	Participação long.
ls.top_position.short_pct	number\|null	%	Participação short.
ls.top_position.ratio	number\|null	—	Razão.
ls.top_position.n_exchanges	number	—	Número de corretoras que contribuem.
ls.top_position.by_exchange	array	—	Detalhamento por corretora.
ls.top_position.by_exchange[]	object	—	Detalhamento por corretora.
ls.top_position.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
ls.top_position.by_exchange[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
ls.top_position.by_exchange[].long_pct	number	%	Participação long.
ls.top_position.by_exchange[].short_pct	number	%	Participação short.
ls.top_position.by_exchange[].ratio	number	—	Razão.
ls.top_position.by_exchange[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
ls.top_position.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
ls.top_position.by_exchange[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
ls.top_position.by_exchange[].source	string	—	De onde vem o valor.
ls.top_position.by_exchange[].period	string	—	Período.
ls.position_all	object	—	Participação long vs. short de todas as posições (corretoras que a publicam).
ls.position_all.long_pct	number\|null	%	Participação long.
ls.position_all.short_pct	number\|null	%	Participação short.
ls.position_all.ratio	number\|null	—	Razão.
ls.position_all.n_exchanges	number	—	Número de corretoras que contribuem.
ls.position_all.by_exchange	array	—	Detalhamento por corretora.
ls.position_all.by_exchange[]	object	—	Detalhamento por corretora.
ls.position_all.by_exchange[].exchange	string	—	ID da corretora, em minúsculas (por exemplo, `binance`).
ls.position_all.by_exchange[].symbol	string	—	Símbolo do instrumento conforme normalizado pela CoinBoss (por exemplo, BTCUSDT).
ls.position_all.by_exchange[].long_pct	number	%	Participação long.
ls.position_all.by_exchange[].short_pct	number	%	Participação short.
ls.position_all.by_exchange[].ratio	number	—	Razão.
ls.position_all.by_exchange[].updated_at	number	ms	Quando esta linha foi atualizada pela última vez.
ls.position_all.by_exchange[].age_s	number	s	Segundos desde a última atualização desta linha.
ls.position_all.by_exchange[].is_stale	boolean	—	true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
ls.position_all.by_exchange[].source	string	—	De onde vem o valor.
ls.position_all.by_exchange[].period	string	—	Período.
ls.taker	object	—	Participação do volume de compra taker vs. venda taker.
ls.taker.long_pct	number\|null	%	Participação long.
ls.taker.short_pct	number\|null	%	Participação short.
ls.taker.ratio	number\|null	—	Razão.
ls.taker.n_exchanges	number	—	Número de corretoras que contribuem.
ls.taker.by_exchange	array	—	Detalhamento por corretora.
ls.definitions	object	—	Definição de cada medida. As cinco medidas respondem a perguntas diferentes e nunca são misturadas. pode estar ausente
ls.definitions.account	string	—	Medida baseada em contas. pode estar ausente
ls.definitions.top_account	string	—	Medida por contas dos top traders. pode estar ausente
ls.definitions.top_position	string	—	Medida por posições dos top traders. pode estar ausente
ls.definitions.position_all	string	—	Medida de todas as posições. pode estar ausente
ls.definitions.taker	string	—	Medida de compra / venda taker. pode estar ausente
ls.method	object	—	Descrição em texto simples das fórmulas usadas nesta resposta. pode estar ausente
ls.method.normalize	string	—	Nota em texto simples sobre a normalização: o valor de cada corretora é reescalado para que % long + % short = 100, e razão = % long ÷ % short. pode estar ausente
ls.method.aggregate	string	—	Agregado entre corretoras. pode estar ausente
ls.method.freshness	string	—	Regra de atualidade em texto simples: as linhas atualizadas nas últimas 24 horas são exibidas, e `is_stale` marca as linhas com mais de 2 horas. pode estar ausente
errors	object	—	Partes do pacote que não puderam ser montadas, indexadas pelo nome da parte; vazio quando todas as partes estão presentes. pode estar ausente

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

Exemplo de resposta

Nenhum exemplo está armazenado porque a última resposta bem-sucedida era grande demais para exibir. Chame o endpoint no Playground.

Amostras verificadas

Além do exemplo acima, a sonda chama este endpoint com estes parâmetros e verifica o esquema a cada vez.

Parâmetros	HTTP	Latência	Resultado
coin=ETH	200	73 ms	Aprovado
coin=SOL	200	59 ms	Aprovado
coin=ARKM	200	59 ms	Aprovado
—	400	2 ms	Aprovado retorna o erro esperado

Verificado 2026-11-13 03:57:35 UTC

Detalhes

Autenticação: Nenhuma. Endpoint público.
Limite de requisições: 1200 requisições por minuto por IP
Cache do servidor: 15s
Microcache de borda: 10s
Frequência de atualização: veja /api/sd/oi, /api/sd/funding, /api/sd/liquidations, /api/sd/volume, /api/sd/ls (consulta a cada 60 s a 5 min; liquidações em tempo real; spot a cada 10 min)
Janela: snapshot mais recente por bloco, mais as janelas móveis próprias de cada bloco
Fontes de dados: Blocos combinados de contratos em aberto, financiamento, liquidações, volume e long/short de uma moeda, todos construídos a partir dos coletores próprios da CoinBoss, que consultam as APIs públicas de cerca de 30 corretoras (p. ex., binance, okx, bybit, bitget, gate, hyperliquid).
Cobertura de corretoras: igual à dos cinco endpoints de bloco único; a lista de contratos é truncada em 60 linhas
Unidades: USD notional for OI / volume / liquidations; funding as fraction; long/short in percent
Método: same builders as the five single-block endpoints
Timestamps: Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
Formato da resposta: json
Estabilidade: Estável
Disponível desde: 2026-11-11

Status ao vivo

DisponívelVerificado 2026-11-13 03:57:35 UTCHTTP 200875 msEsquema confereDado mais recente: há 0s

Disponibilidade, últimos 30 dias

100% de 411 verificações aprovadas

Divergência de esquema detectada pela última sondagem

Retornado, mas não documentado: oi.coverage.stale_excluded[], oi.coverage.stale_excluded[].exchange, oi.coverage.stale_excluded[].symbol, oi.coverage.stale_excluded[].oi_usd, oi.coverage.stale_excluded[].age_s, oi.coverage.stale_excluded[].reason, ls.taker.by_exchange[], ls.taker.by_exchange[].exchange, ls.taker.by_exchange[].symbol, ls.taker.by_exchange[].long_pct

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ódigo	HTTP	Significado	O que fazer
INVALID_PARAM	400	Falta 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.
UNAUTHORIZED	401	O 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.
FORBIDDEN	403	A rota não faz parte da API pública (é interna ou exclusiva de conta).	Não tente novamente.
NOT_FOUND	404	Rota desconhecida, ou a moeda / corretora / fundo solicitado não existe.	Não tente novamente; confira o caminho e os identificadores no catálogo.
RATE_LIMITED	429	Mais 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.
INTERNAL	500	Erro 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_FAILED	503	A 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.
UNAVAILABLE	501 / 503	O 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_FAILED	200	Alguns 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/sd/coinDisponível

Parâmetros

coin Obrigatório

string — Coin symbol; 400 when missing. Alias: `base`.

URL da requisiçãohttps://www.coinboss.com/api/sd/coin?coin=BTC

Escolha um endpoint e clique em “Enviar requisição”. A resposta, os cabeçalhos e o tempo de resposta aparecerão aqui.

Pacote completo da moeda (OI, financiamento, liquidações, volume, long/short) /api/sd/coin
Volume de futuros de uma moeda /api/sd/volume
Screener de moedas em derivativos /api/derivatives/coins
Tabela completa de moedas em derivativos /api/derivatives/coins-full
Candles de derivativos de uma moeda /api/derivatives/kline
Lista de RSI por moeda /api/derivatives/rsi
Série de MACD de uma moeda /api/indicators/ta/macd/:coin
Séries históricas de uma moeda /api/market/history
Tickers de derivativos agregados por moeda /api/market/tickers
Ranking de volume de derivativos /api/market/volume-rank