/api/content/summary
GETDisponívelBeta

Resumo das seções de todo o site

Resumo das seções de todo o site (para páginas de conteúdo)

GET/api/content/summary

Requisição

Este endpoint não recebe parâmetros.

Exemplo de requisição

curl -s "https://www.coinboss.com/api/content/summary"

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.
exchangesobject—Corretoras.
exchanges.countnumber—Número de itens.
exchanges.total_volnumberUSDVolume de futuros de 24h somado em todas as corretoras, excluídos os contratos vinculados a ações.
exchanges.total_oinumber—Total de contratos em aberto.
exchanges.total_contractsnumbercountNúmero de tickers de contratos futuros em todas as corretoras, excluídos os contratos vinculados a ações.
exchanges.top3array—Os três primeiros registros.
exchanges.top3[]object—Os três primeiros registros.
exchanges.top3[].namestring—Nome.
exchanges.top3[].volnumber—Volume.
exchanges.top3[].share_pctnumber%Participação no total.
exchanges.dex_share_vol_pctnumber%Parcela de `total_vol` negociada em corretoras descentralizadas de perpétuos.
exchanges.dex_share_oi_pctnumber%Parcela de `total_oi` mantida em corretoras descentralizadas de perpétuos.
exchanges.stock_vol_excludednumberUSDVolume de 24h dos contratos vinculados a ações que ficou fora de `total_vol`.
fundingobject—Bloco ou valor da taxa de financiamento.
funding.weighted_pctnumber%Taxa de financiamento atual dos perpétuos USDT de cripto ponderada pelos contratos em aberto, em percentual por intervalo de financiamento (as taxas não são normalizadas para 8 horas).
funding.top_posarray—As três taxas de financiamento atuais mais altas entre os perpétuos USDT com pelo menos 300,000 USD de contratos em aberto.
funding.top_pos[]object—Um contrato: `base` (moeda), `ex` (nome de exibição da corretora) e `rate_pct`.
funding.top_pos[].basestring—Símbolo do ativo base.
funding.top_pos[].exstring—ID da corretora, em minúsculas.
funding.top_pos[].rate_pctnumber%Taxa de financiamento atual do contrato em percentual, pelo seu próprio intervalo de financiamento.
funding.top_negarray—As três taxas de financiamento atuais mais baixas (mais negativas) entre os perpétuos USDT com pelo menos 300,000 USD de contratos em aberto.
funding.top_neg[]object—Um contrato: `base` (moeda), `ex` (nome de exibição da corretora) e `rate_pct`.
funding.top_neg[].basestring—Símbolo do ativo base.
funding.top_neg[].exstring—ID da corretora, em minúsculas.
funding.top_neg[].rate_pctnumber%Taxa de financiamento atual do contrato em percentual, pelo seu próprio intervalo de financiamento.
funding.intervalsobject—Intervalos.
funding.intervals.h1_pctnumber%Parcela dos contratos que liquidaram financiamento 16 vezes ou mais nas últimas 24 horas (classificados como de 1 hora).
funding.intervals.h4_pctnumber%Parcela dos contratos que liquidaram financiamento de 5 a 15 vezes nas últimas 24 horas (classificados como de 4 horas).
funding.intervals.h8_pctnumber%Parcela dos contratos que liquidaram financiamento menos de 5 vezes nas últimas 24 horas (classificados como de 8 horas).
oiobject—Contratos em aberto.
oi.totalnumber—Total.
oi.chg24_pctnumber%Variação dos contratos em aberto somados em relação ao snapshot horário de cerca de 24 horas antes, considerando os contratos presentes em ambos; null quando não existe snapshot.
oi.gainersarray—Maiores altas.
oi.gainers[]object—Maiores altas.
oi.gainers[].basestring—Símbolo do ativo base.
oi.gainers[].oinumber—Contratos em aberto.
oi.gainers[].chg_pctnumber%Variação percentual.
oi.losersarray—Maiores baixas.
oi.losers[]object—Maiores baixas.
oi.losers[].basestring—Símbolo do ativo base.
oi.losers[].oinumber—Contratos em aberto.
oi.losers[].chg_pctnumber%Variação percentual.
oi.top_exarray—As três corretoras com os maiores contratos em aberto.
oi.top_ex[]object—Uma corretora: `name`, `oi` (USD) e `share_pct` (% de `oi.total`).
oi.top_ex[].namestring—Nome.
oi.top_ex[].oinumber—Contratos em aberto.
oi.top_ex[].share_pctnumber%Participação no total.
marketobject—Mercado.
market.total_oinumber—Total de contratos em aberto.
market.liq_totalnumberUSDLiquidações de longs mais as de shorts nas últimas 24 horas, excluídos os contratos vinculados a ações.
market.liq_longnumber—Longs liquidados.
market.liq_shortnumber—Shorts liquidados.
market.up_cntnumbercountNúmero das 500 maiores moedas por capitalização de mercado cuja variação de preço em 24h é positiva.
market.down_cntnumbercountNúmero das 500 maiores moedas por capitalização de mercado cuja variação de preço em 24h é negativa.
market.btc_dom_pctnumber%Capitalização de mercado do BTC ÷ capitalização de mercado total das moedas acompanhadas × 100; null quando o snapshot de capitalização de mercado está indisponível.
stocksobject—Contratos perpétuos vinculados a ações com um ticker das últimas 12 horas: número de ativos subjacentes, de contratos e de corretoras, volume de 24h e os 3 principais ativos subjacentes.
stocks.underlyingsnumber—Símbolos dos subjacentes.
stocks.contractsnumber—Linhas por contrato.
stocks.volnumber—Volume.
stocks.exchangesnumber—Corretoras.
stocks.top3array—Os três primeiros registros.
stocks.top3[]object—Os três primeiros registros.
stocks.top3[].ustring—Ticker da ação ou do ETF subjacente.
stocks.top3[].volnumber—Volume.
preipoobject—Ativos subjacentes pré-IPO (sintéticos) entre os contratos vinculados a ações: contagem, volume de 24h, preço mais alto e maior diferença de preço.
preipo.underlyingsnumber—Símbolos dos subjacentes.
preipo.volnumber—Volume.
preipo.top_priceobject—O ativo subjacente pré-IPO com o maior preço de contrato ponderado por volume (`u`, `price`); null quando nenhum é negociado.
preipo.top_price.ustring—Nome desse ativo subjacente.
preipo.top_price.pricenumber—Último preço na moeda de cotação (USD ou USDT, salvo indicação em contrário).
preipo.max_spreadobject—O ativo subjacente pré-IPO com a maior diferença de preço entre seus contratos (`u`, `spread_pct`, `pmin`, `pmax`); null quando nenhum tem dois contratos.
preipo.max_spread.ustring—Nome desse ativo subjacente.
preipo.max_spread.spread_pctnumber%(`pmax` − `pmin`) ÷ `pmin` × 100.
preipo.max_spread.pminnumberUSDMenor preço de contrato atual do ativo subjacente entre as corretoras.
preipo.max_spread.pmaxnumberUSDMaior preço de contrato atual do ativo subjacente entre as corretoras.

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

Exemplo de resposta

/api/content/summary · Resposta real capturada 2026-11-13 03:53:48 UTC. Arrays e mapas longos são encurtados para exibição: oi.losers tinha 3 itens; oi.top_ex tinha 3 itens; oi.gainers tinha 3 itens; stocks.top3 tinha 3 itens; exchanges.top3 tinha 3 itens; funding.top_neg tinha 3 itens.

  • {
    • "success": true,
    • "now": 1794541766928,
    • "exchanges": {
      • "count": 25,
      • "total_vol": 169675954910.26993,
      • "total_oi": 107737040199.58,
      • "total_contracts": 10843,
      • "top3": [ … 2 ],
      • "dex_share_vol_pct": 8.3,
      • "dex_share_oi_pct": 11.3,
      • "stock_vol_excluded": 41319457587.51
      },
    • "funding": {
      • "weighted_pct": 0.0047,
      • "top_pos": [ … 2 ],
      • "top_neg": [ … 2 ],
      • "intervals": { … 3 }
      },
    • "oi": {
      • "total": 107737040199.58,
      • "chg24_pct": -3.33,
      • "gainers": [ … 2 ],
      • "losers": [ … 2 ],
      • "top_ex": [ … 2 ]
      },
    • "market": {
      • "total_oi": 107737040199.58,
      • "liq_total": 1197925242.48,
      • "liq_long": 1104557190,
      • "liq_short": 93368052.48,
      • "up_cnt": 150,
      • "down_cnt": 327,
      • "btc_dom_pct": 57.4
      },
    • "stocks": {
      • "underlyings": 648,
      • "contracts": 2338,
      • "vol": 41225031460.52995,
      • "exchanges": 18,
      • "top3": [ … 2 ]
      },
    • "preipo": {
      • "underlyings": 3,
      • "vol": 2214168764.27,
      • "top_price": { … 2 },
      • "max_spread": { … 4 }
      }
    }

Detalhes

Autenticação
Nenhuma. Endpoint público.
Limite de requisições
1200 requisições por minuto por IP
Cache do servidor
10m
Microcache de borda
10s
Frequência de atualização
tickers a cada 1 min; OI/financiamento a cada 5 min; cache da API de 600 s
Janela
24h
Fontes de dados
Números-resumo de todo o site (participações das corretoras em volume e OI, extremos de financiamento, maiores variações de OI, liquidações, estatísticas de contratos de ações tokenizadas e pré-IPO) agregados internamente a partir de dados das corretoras; a dominância do BTC e as contagens de altas/baixas vêm de um agregador terceiro de dados de mercado.
Cobertura de corretoras
Todas as corretoras de derivativos coletadas; contratos de ações tokenizadas excluídos dos totais de cripto
Paginação
nenhuma
Unidades
USD; percentages
Método
funding.weighted_pct = SUM(rate * oi) / SUM(oi) * 100 over USDT perpetuals refreshed within 3h (not normalized to 8h); oi.chg24_pct compares contracts present both now and 24h ago
Timestamps
Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
Formato da resposta
json
Estabilidade
Beta

Status ao vivo

DisponívelVerificado 2026-11-13 03:53:48 UTCHTTP 2001 msEsquema confere

Disponibilidade, últimos 30 dias

99.75% de 407 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/content/summaryDisponível
Parâmetros

Sem parâmetros.

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