Status do serviço
Status geral, instâncias da API e armazenamentos, endpoints com falha, percentis de latência, disponibilidade em 30 dias, saúde dos coletores por família de dados e incidentes abertos.
/api/meta/statusRequisição
Este endpoint não recebe parâmetros.
Exemplo de requisição
curl -s "https://www.coinboss.com/api/meta/status"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 }`. |
| schema | string | — | ID do esquema desta resposta (`coinboss.meta.status/1`). |
| now | number | ms | Horário do servidor em que a resposta foi montada. |
| overall | string | — | Status geral do serviço: `operational`, `degraded`, `partial_outage`, `major_outage` ou `unknown`; veja `legend`. |
| api_version | string | — | Versão da API pública (`v1`). |
| catalog_version | string | — | Versão do catálogo de endpoints, uma data de lançamento como `2026.11.11`. |
| components | array | — | Componentes do serviço com seu status: API REST, stream WebSocket, banco de dados, cache, armazenamento de séries temporais, sonda de endpoints e coleta de dados. |
| components[] | object | — | Um componente: `id`, `title`, `status` e um objeto `detail` cujos campos dependem do componente. |
| components[].id | string | — | Identificador. |
| components[].title | string | — | Nome de exibição do componente. |
| components[].status | string | — | Status. |
| components[].detail | object | — | Detalhe. |
| components[].detail.instances_healthy | number | count | Instâncias do servidor da API que responderam à verificação de saúde agora há pouco. pode estar ausente |
| components[].detail.instances_total | number | count | Instâncias do servidor da API que foram verificadas. pode estar ausente |
| components[].detail.health_latency_ms | number | ms | Resposta mais lenta da verificação de saúde entre as instâncias da API. pode estar ausente |
| components[].detail.last_check_at | number | ms | Timestamp. pode estar ausente |
| components[].detail.first_frame_ms | number | ms | Tempo entre a conexão ao stream WebSocket e a chegada do primeiro frame na última sondagem; null quando não sondado. pode estar ausente |
| components[].detail.ping_ms | number | ms | Tempo de ida e volta de uma consulta trivial ao componente (banco de dados, cache ou armazenamento de séries temporais), medido a partir do host da API. pode estar ausente |
| components[].detail.note | null | — | Observação. pode estar ausente |
| components[].detail.last_run_at | number | ms | Timestamp. pode estar ausente |
| components[].detail.age_s | number | s | Segundos desde a última atualização desta linha. pode estar ausente |
| components[].detail.interval_s | number | s | Intervalo planejado entre duas execuções da sonda (300). pode estar ausente |
| components[].detail.took_ms | number | ms | Duração da última execução completa da sonda; null quando não registrada. pode estar ausente |
| components[].detail.families_total | number | count | Número de famílias de dados avaliadas na coleta de dados. pode estar ausente |
| components[].detail.families_degraded | number | count | Número de famílias de dados cujo status de coleta é `degraded` ou `outage`. pode estar ausente |
| components[].detail.judged_by | string | — | A partir de qual timestamp o status foi avaliado. pode estar ausente |
| endpoints | object | — | Número de endpoints documentados em cada status ao vivo, além da lista dos que estão falhando. |
| endpoints.total | number | — | Total. |
| endpoints.available | number | — | Indica se há dados disponíveis. |
| endpoints.partial | number | — | true quando apenas parte dos dados esperados está presente. |
| endpoints.degraded | number | count | Número de endpoints cujo status ao vivo é `degraded`. |
| endpoints.down | number | count | Número de endpoints cujo status ao vivo é `down`. |
| endpoints.unavailable | number | — | Itens para os quais não há dados disponíveis, com os motivos. Nunca são reportados como 0. |
| endpoints.unknown | number | count | Número de endpoints cujo status ao vivo é `unknown` (sem resultado de sondagem recente). |
| endpoints.failing | array | — | Endpoints atualmente `down` ou `degraded`, cada um com `id`, `path`, `status`, `reason`, último status HTTP, horário do último sucesso e sequência de falhas. |
| endpoints.failing[] | object | — | Um endpoint que está atualmente fora do ar ou degradado. |
| endpoints.failing[].id | string | — | Identificador. |
| endpoints.failing[].path | string | — | Caminho do endpoint. |
| endpoints.failing[].status | string | — | Status. |
| endpoints.failing[].reason | string | — | Código do motivo. |
| endpoints.failing[].http | number | — | Status HTTP da última sondagem; `null` quando nunca foi sondado. |
| endpoints.failing[].last_ok_at | number | ms | Timestamp. |
| endpoints.failing[].fail_streak | number | count | Número de sondagens com falha consecutivas. |
| latency_ms | object | — | Distribuição do tempo de resposta da chamada de sondagem bem-sucedida mais recente de cada endpoint, medida no host da API. |
| latency_ms.p50 | number | ms | Tempo de resposta mediano entre os endpoints; null quando não há amostra atualizada. |
| latency_ms.p95 | number | ms | Tempo de resposta do 95º percentil entre os endpoints; null quando não há amostra atualizada. |
| latency_ms.max | number | — | Máximo. |
| latency_ms.sample | number | count | Número de endpoints incluídos nos valores de latência. |
| latency_ms.measured | string | — | Nota em texto simples sobre onde a latência é medida: no lado do servidor, excluído o trânsito de rede. |
| uptime | object | — | Verificações de sondagem de todos os endpoints em conjunto ao longo da janela: totais, percentual de sucesso e um detalhamento por dia. |
| uptime.window_days | number | days | Duração da janela de disponibilidade (30). |
| uptime.checks | number | count | Número de verificações de sondagem na janela, todos os endpoints em conjunto. |
| uptime.ok | number | count | Número dessas verificações que tiveram sucesso. |
| uptime.pct | number | % | Percentual. |
| uptime.tracking_since | string | — | Primeiro dia com dados de sondagem dentro da janela, `YYYY-MM-DD`; null quando ainda não há dados. |
| uptime.days | array | — | Valores diários ou número de dias. |
| uptime.days[] | object | — | Valores diários ou número de dias. |
| uptime.days[].day | string | — | Dia de calendário (UTC). |
| uptime.days[].checks | number | count | Número de requisições de sondagem nesse dia. |
| uptime.days[].ok | number | count | Número de requisições de sondagem bem-sucedidas nesse dia. |
| uptime.days[].pct | number | % | Percentual. |
| uptime.days[].schema_pct | number | % | Parcela das respostas sondadas nesse dia que corresponderam à tabela de campos documentada. |
| uptime.days[].avg_ms | number | ms | Tempo médio de resposta nesse dia. |
| collectors | object | — | Estado da coleta de dados das corretoras, avaliado a partir dos timestamps dos dados armazenados: contagens por família, verificações de conjuntos de dados e saúde da ronda; null quando não é possível avaliar. |
| collectors.families | array | — | Status de coleta por família de dados. |
| collectors.families[] | object | — | Uma família: `family`, `title`, número de corretoras em cada estado e o `status` resultante. |
| collectors.families[].family | string | — | ID da família, por exemplo, `ticker`, `oi`, `funding`, `liquidation`, `options`. |
| collectors.families[].title | string | — | Título de exibição da família. |
| collectors.families[].exchanges_collected | number | count | Corretoras para as quais a família é coletada: fresh + partial + stale + broken. |
| collectors.families[].fresh | number | count | Corretoras cujo dado mais recente da família está dentro da janela de atualidade. |
| collectors.families[].partial | number | — | true quando apenas parte dos dados esperados está presente. |
| collectors.families[].stale | number | — | Linhas ou indicador referentes a dados mais antigos que a janela de atualidade. |
| collectors.families[].broken | number | count | Corretoras cuja origem continua falhando ou cujas linhas, em sua maioria, falham nas verificações de consistência da família. |
| collectors.families[].unavailable | number | — | Itens para os quais não há dados disponíveis, com os motivos. Nunca são reportados como 0. |
| collectors.families[].status | string | — | Status. |
| collectors.datasets | array | — | Verificações de qualidade dos conjuntos de dados que não são por corretora (por exemplo, dados diários de ETFs spot e da CME), cada uma com status, defasagem, cobertura e motivo. |
| collectors.datasets[] | object | — | Um conjunto de dados de todo o mercado que não está vinculado a uma única corretora (opções, ETFs spot, CME, livros de ofertas, base). |
| collectors.datasets[].family | string | — | ID do conjunto de dados, por exemplo, `etf` ou `cme`. |
| collectors.datasets[].id | string | — | Identificador. |
| collectors.datasets[].title | string | — | Nome de exibição do conjunto de dados. |
| collectors.datasets[].source | string | — | De onde vem o valor. |
| collectors.datasets[].endpoint | string | — | Endpoint público que serve o conjunto de dados. |
| collectors.datasets[].status | string | — | Status. |
| collectors.datasets[].lag_s | number | s | Idade do ponto de dados mais recente quando a resposta foi montada. |
| collectors.datasets[].source_at | number | ms | Timestamp. |
| collectors.datasets[].fetched_at | number | ms | Quando a CoinBoss obteve os dados da fonte. |
| collectors.datasets[].fresh_within_s | number | s | Janela de atualidade: dados mais recentes que isso contam como atualizados. |
| collectors.datasets[].coverage | object | — | O que está incluído e o que está faltando. |
| collectors.datasets[].coverage.funds_total | number | count | Número de fundos acompanhados. pode estar ausente |
| collectors.datasets[].coverage.funds_covered | number | count | Número de fundos com uma divulgação utilizável. pode estar ausente |
| collectors.datasets[].coverage.funds_unavailable | number | count | Número de fundos cujo emissor não publica divulgação legível por máquina. pode estar ausente |
| collectors.datasets[].coverage.funds_failing | number | count | Número de fundos cuja divulgação não pôde ser lida na última rodada de coleta. pode estar ausente |
| collectors.datasets[].coverage.as_of | string | — | Data de divulgação mais recente entre os fundos cobertos (YYYY-MM-DD). pode estar ausente |
| collectors.datasets[].coverage.as_of_min | string | — | Data de divulgação mais antiga entre os fundos cobertos (YYYY-MM-DD). pode estar ausente |
| collectors.datasets[].reason | string|null | — | Código do motivo. |
| collectors.datasets[].coverage.contracts | number | — | Linhas por contrato. pode estar ausente |
| collectors.datasets[].coverage.report_date | string | — | Data do relatório Commitments of Traders mais recente da CFTC (YYYY-MM-DD). pode estar ausente |
| collectors.datasets[].coverage.products | number | count | Número de produtos da CME cobertos. pode estar ausente |
| collectors.datasets[].coverage.trade_date | string | — | Data de negociação do relatório diário mais recente da CME (YYYY-MM-DD). pode estar ausente |
| collectors.patrol_ok | boolean | — | true quando a ronda de qualidade dos dados foi executada nos últimos 15 minutos. |
| collectors.patrol_age_s | number | s | Segundos desde o evento. |
| collectors.evaluated_at | number | ms | Timestamp. |
| incidents | object | — | Alertas de qualidade dos dados que estão abertos ou foram resolvidos nos últimos 7 dias: contagem `open` e `items` (no máximo 100). |
| incidents.open | number | — | Preço de abertura do período. |
| incidents.items | array | — | Itens do resultado. |
| incidents.items[] | object | — | Itens do resultado. |
| incidents.items[].level | string | — | Nível. |
| incidents.items[].exchange | string | — | ID da corretora, em minúsculas (por exemplo, `binance`). |
| incidents.items[].family | string | — | Família de dados a que o alerta se refere. |
| incidents.items[].code | string | — | Código. |
| incidents.items[].detail | string | — | Detalhe. |
| incidents.items[].opened_at | number | ms | Timestamp. |
| incidents.items[].last_seen_at | number | ms | Timestamp. |
| incidents.items[].resolved_at | number|null | ms | Timestamp. |
| incidents.items[].hits | number | count | Número de execuções da ronda (uma a cada 5 minutos) que observaram a condição desde a abertura do alerta. |
| incidents.items[].open | boolean | — | Preço de abertura do período. |
| probe | object | — | Estado da sonda de endpoints por trás dos status ao vivo: horário da última execução, sua idade, o intervalo e se ela está atualizada. |
| probe.last_run_at | number | ms | Timestamp. |
| probe.age_s | number | s | Segundos desde a última atualização desta linha. |
| probe.interval_s | number | s | Intervalo planejado entre duas execuções da sonda (300). |
| probe.fresh | boolean | — | true quando a última execução da sonda tem menos de 20 minutos; quando false, os status dos endpoints são reportados como `unknown`. |
| probe.error | null | — | Mensagem de erro (presente apenas em caso de falha). |
| probe.endpoints_checked | number | count | Número de endpoints verificados na última rodada de sondagem. |
| probe.ok | number | count | Número de endpoints que responderam corretamente na última rodada de sondagem. |
| probe.failed | number | count | Número de endpoints que falharam na última rodada de sondagem. |
| probe.schema_mismatch | number | count | Número de endpoints cuja resposta não correspondeu à tabela de campos documentada. |
| probe.alt_samples_failed | null | count | Número de requisições de amostra adicionais que falharam; `null` quando a última rodada não as executou. |
| legend | object | — | Definição em texto simples de cada valor de `overall`. |
| legend.operational | string | — | Definição de `operational`. |
| legend.degraded | string | — | Definição de `degraded`. |
| legend.partial_outage | string | — | Definição de `partial_outage`. |
| legend.major_outage | string | — | Definição de `major_outage`. |
| legend.unknown | string | — | Definição de `unknown`. |
| meta | object | — | Envelope desta resposta: ID do esquema, sistema produtor, timestamps, tempo de vida do cache e atualidade. |
| meta.schema | string | — | ID do esquema desta resposta; mesmo valor do `schema` de nível superior. |
| meta.source | array | — | De onde vem o valor. |
| meta.source[] | object | — | De onde vem o valor. |
| meta.source[].system | string | — | Sistema que produziu os dados; sempre `coinboss` nos endpoints do centro de desenvolvedores. |
| meta.source[].component | string | — | Componente por trás dos dados: a sonda de endpoints e a ronda de qualidade dos dados. |
| meta.observed_at | null | — | Timestamp. |
| meta.received_at | number | ms | Timestamp. |
| meta.fetched_at | number | ms | Quando a CoinBoss obteve os dados da fonte. |
| meta.window | string | — | Janela. |
| meta.cache_ttl_s | number | s | Tempo de vida do cache do servidor para esta resposta. |
| meta.quality | string | — | `FRESH` quando a sonda de endpoints reportou nos últimos 20 minutos; caso contrário, `STALE`. |
| meta.is_stale | boolean | — | true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais. |
| meta.fallback | string | — | Nota em texto simples sobre o que este endpoint retorna quando suas entradas estão desatualizadas ou ausentes. |
Gerada 2026-11-11 23:01 UTC a partir de 1 respostas reais.
Exemplo de resposta
/api/meta/status · Resposta real capturada 2026-11-13 03:53:47 UTC. Arrays e mapas longos são encurtados para exibição: components tinha 7 itens; uptime.days tinha 3 itens; incidents.items tinha 11 itens; endpoints.failing tinha 25 itens; collectors.datasets tinha 12 itens; collectors.families tinha 12 itens.
- "success"true
- "schema""coinboss.meta.status/1"
- "now"1794542027137
- "overall""partial_outage"
- "api_version""v1"
- "catalog_version""2026.11.12"
- "components"
- "endpoints"
- "total"299
- "available"256
- "partial"17
- "degraded"17
- "down"8
- "unavailable"1
- "unknown"0
- "failing"
- "latency_ms"
- "p50"7
- "p95"839
- "max"10047
- "sample"289
- "measured""server-side, from the probe on the API host (excludes network transit)"
- "uptime"
- "window_days"30
- "checks"119504
- "ok"118277
- "pct"98.97
- "tracking_since""2026-11-11"
- "days"
- "collectors"
- "families"
- "datasets"
- "patrol_ok"true
- "patrol_age_s"282
- "evaluated_at"1794542027976
- "incidents"
- "open"2
- "items"
- "probe"
- "last_run_at"1794541726312
- "age_s"301
- "interval_s"300
- "fresh"true
- "error"null
- "endpoints_checked"290
- "ok"289
- "failed"1
- "schema_mismatch"0
- "alt_samples_failed"null
- "legend"
- "operational""all checks pass"
- "degraded""serving, with stale data, schema drift or reduced redundancy"
- "partial_outage""at least one endpoint or API instance is failing"
- "major_outage""database down, no API instance healthy, or 20%+ of endpoints failing"
- "unknown""the probe has not reported within 20 minutes — status cannot be asserted"
- "meta"
- "schema""coinboss.meta.status/1"
- "source"
- "observed_at"null
- "received_at"1794541726312
- "fetched_at"1794542027137
- "window""latest"
- "cache_ttl_s"15
- "quality""FRESH"
- "is_stale"false
- "fallback""status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
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
- Avaliado a cada requisição; os resultados dos endpoints vêm da sonda da API de 5 minutos, e a saúde dos coletores, dos timestamps dos dados.
- Fontes de dados
- Resultados da sonda da API, verificações de saúde por instância, matriz de qualidade dos dados, log de alertas.
- 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
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/meta/statusDisponívelSem parâmetros.
https://www.coinboss.com/api/meta/statusMais 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