Resumo das seções de todo o site
Resumo das seções de todo o site (para páginas de conteúdo)
/api/content/summaryRequisiçã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.
| 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 }`. |
| now | number | ms | Horário do servidor em que a resposta foi montada. |
| exchanges | object | — | Corretoras. |
| exchanges.count | number | — | Número de itens. |
| exchanges.total_vol | number | USD | Volume de futuros de 24h somado em todas as corretoras, excluídos os contratos vinculados a ações. |
| exchanges.total_oi | number | — | Total de contratos em aberto. |
| exchanges.total_contracts | number | count | Número de tickers de contratos futuros em todas as corretoras, excluídos os contratos vinculados a ações. |
| exchanges.top3 | array | — | Os três primeiros registros. |
| exchanges.top3[] | object | — | Os três primeiros registros. |
| exchanges.top3[].name | string | — | Nome. |
| exchanges.top3[].vol | number | — | Volume. |
| exchanges.top3[].share_pct | number | % | Participação no total. |
| exchanges.dex_share_vol_pct | number | % | Parcela de `total_vol` negociada em corretoras descentralizadas de perpétuos. |
| exchanges.dex_share_oi_pct | number | % | Parcela de `total_oi` mantida em corretoras descentralizadas de perpétuos. |
| exchanges.stock_vol_excluded | number | USD | Volume de 24h dos contratos vinculados a ações que ficou fora de `total_vol`. |
| funding | object | — | Bloco ou valor da taxa de financiamento. |
| funding.weighted_pct | number | % | 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_pos | array | — | 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[].base | string | — | Símbolo do ativo base. |
| funding.top_pos[].ex | string | — | ID da corretora, em minúsculas. |
| funding.top_pos[].rate_pct | number | % | Taxa de financiamento atual do contrato em percentual, pelo seu próprio intervalo de financiamento. |
| funding.top_neg | array | — | 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[].base | string | — | Símbolo do ativo base. |
| funding.top_neg[].ex | string | — | ID da corretora, em minúsculas. |
| funding.top_neg[].rate_pct | number | % | Taxa de financiamento atual do contrato em percentual, pelo seu próprio intervalo de financiamento. |
| funding.intervals | object | — | Intervalos. |
| funding.intervals.h1_pct | number | % | Parcela dos contratos que liquidaram financiamento 16 vezes ou mais nas últimas 24 horas (classificados como de 1 hora). |
| funding.intervals.h4_pct | number | % | Parcela dos contratos que liquidaram financiamento de 5 a 15 vezes nas últimas 24 horas (classificados como de 4 horas). |
| funding.intervals.h8_pct | number | % | Parcela dos contratos que liquidaram financiamento menos de 5 vezes nas últimas 24 horas (classificados como de 8 horas). |
| oi | object | — | Contratos em aberto. |
| oi.total | number | — | Total. |
| oi.chg24_pct | number | % | 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.gainers | array | — | Maiores altas. |
| oi.gainers[] | object | — | Maiores altas. |
| oi.gainers[].base | string | — | Símbolo do ativo base. |
| oi.gainers[].oi | number | — | Contratos em aberto. |
| oi.gainers[].chg_pct | number | % | Variação percentual. |
| oi.losers | array | — | Maiores baixas. |
| oi.losers[] | object | — | Maiores baixas. |
| oi.losers[].base | string | — | Símbolo do ativo base. |
| oi.losers[].oi | number | — | Contratos em aberto. |
| oi.losers[].chg_pct | number | % | Variação percentual. |
| oi.top_ex | array | — | 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[].name | string | — | Nome. |
| oi.top_ex[].oi | number | — | Contratos em aberto. |
| oi.top_ex[].share_pct | number | % | Participação no total. |
| market | object | — | Mercado. |
| market.total_oi | number | — | Total de contratos em aberto. |
| market.liq_total | number | USD | Liquidações de longs mais as de shorts nas últimas 24 horas, excluídos os contratos vinculados a ações. |
| market.liq_long | number | — | Longs liquidados. |
| market.liq_short | number | — | Shorts liquidados. |
| market.up_cnt | number | count | Número das 500 maiores moedas por capitalização de mercado cuja variação de preço em 24h é positiva. |
| market.down_cnt | number | count | Número das 500 maiores moedas por capitalização de mercado cuja variação de preço em 24h é negativa. |
| market.btc_dom_pct | number | % | 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. |
| stocks | object | — | 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.underlyings | number | — | Símbolos dos subjacentes. |
| stocks.contracts | number | — | Linhas por contrato. |
| stocks.vol | number | — | Volume. |
| stocks.exchanges | number | — | Corretoras. |
| stocks.top3 | array | — | Os três primeiros registros. |
| stocks.top3[] | object | — | Os três primeiros registros. |
| stocks.top3[].u | string | — | Ticker da ação ou do ETF subjacente. |
| stocks.top3[].vol | number | — | Volume. |
| preipo | object | — | 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.underlyings | number | — | Símbolos dos subjacentes. |
| preipo.vol | number | — | Volume. |
| preipo.top_price | object | — | O ativo subjacente pré-IPO com o maior preço de contrato ponderado por volume (`u`, `price`); null quando nenhum é negociado. |
| preipo.top_price.u | string | — | Nome desse ativo subjacente. |
| preipo.top_price.price | number | — | Último preço na moeda de cotação (USD ou USDT, salvo indicação em contrário). |
| preipo.max_spread | object | — | 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.u | string | — | Nome desse ativo subjacente. |
| preipo.max_spread.spread_pct | number | % | (`pmax` − `pmin`) ÷ `pmin` × 100. |
| preipo.max_spread.pmin | number | USD | Menor preço de contrato atual do ativo subjacente entre as corretoras. |
| preipo.max_spread.pmax | number | USD | Maior 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"
- "dex_share_vol_pct"8.3
- "dex_share_oi_pct"11.3
- "stock_vol_excluded"41319457587.51
- "funding"
- "weighted_pct"0.0047
- "top_pos"
- "top_neg"
- "intervals"
- "oi"
- "total"107737040199.58
- "chg24_pct"-3.33
- "gainers"
- "losers"
- "top_ex"
- "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"
- "preipo"
- "underlyings"3
- "vol"2214168764.27
- "top_price"
- "max_spread"
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
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ó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
/api/content/summaryDisponívelSem parâmetros.
https://www.coinboss.com/api/content/summaryMais nesta categoria
- Matriz de qualidade dos dados (visão do coletor) /api/sd/quality
- Catálogo da API /api/meta/catalog
- Registro de alterações e política de versionamento /api/meta/changelog
- Documentação do endpoint /api/meta/endpoint
- Documento OpenAPI /api/meta/openapi
- Matriz de qualidade dos dados /api/meta/quality
- Status do serviço /api/meta/status
- Verifica se o símbolo de uma moeda é conhecido pela plataforma /api/coin-exists
- Mapa de símbolo de moeda para o caminho do ícone hospedado localmente /api/coin-icons
- Resumo agregado da página da moeda /api/content/coin
- Resumo das seções de todo o site /api/content/summary
- Tabela de taxas de câmbio fiduciárias /api/currency/fx
- Mapa de ID de corretora para o caminho do ícone hospedado localmente /api/exchange-icons
- Verificação de atividade /api/health
- Estatísticas da página de pesquisa /api/research/stats