/api/meta/status
GETDisponívelFRESH

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.

GET/api/meta/status

Requisiçã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.

CampoTipoUnidadeDescrição
successboolean—true quando a requisição foi bem-sucedida. Em caso de falha, o corpo é `{ success: false, code, error, request_id }`.
schemastring—ID do esquema desta resposta (`coinboss.meta.status/1`).
nownumbermsHorário do servidor em que a resposta foi montada.
overallstring—Status geral do serviço: `operational`, `degraded`, `partial_outage`, `major_outage` ou `unknown`; veja `legend`.
api_versionstring—Versão da API pública (`v1`).
catalog_versionstring—Versão do catálogo de endpoints, uma data de lançamento como `2026.11.11`.
componentsarray—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[].idstring—Identificador.
components[].titlestring—Nome de exibição do componente.
components[].statusstring—Status.
components[].detailobject—Detalhe.
components[].detail.instances_healthynumbercountInstâncias do servidor da API que responderam à verificação de saúde agora há pouco. pode estar ausente
components[].detail.instances_totalnumbercountInstâncias do servidor da API que foram verificadas. pode estar ausente
components[].detail.health_latency_msnumbermsResposta mais lenta da verificação de saúde entre as instâncias da API. pode estar ausente
components[].detail.last_check_atnumbermsTimestamp. pode estar ausente
components[].detail.first_frame_msnumbermsTempo 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_msnumbermsTempo 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.notenull—Observação. pode estar ausente
components[].detail.last_run_atnumbermsTimestamp. pode estar ausente
components[].detail.age_snumbersSegundos desde a última atualização desta linha. pode estar ausente
components[].detail.interval_snumbersIntervalo planejado entre duas execuções da sonda (300). pode estar ausente
components[].detail.took_msnumbermsDuração da última execução completa da sonda; null quando não registrada. pode estar ausente
components[].detail.families_totalnumbercountNúmero de famílias de dados avaliadas na coleta de dados. pode estar ausente
components[].detail.families_degradednumbercountNúmero de famílias de dados cujo status de coleta é `degraded` ou `outage`. pode estar ausente
components[].detail.judged_bystring—A partir de qual timestamp o status foi avaliado. pode estar ausente
endpointsobject—Número de endpoints documentados em cada status ao vivo, além da lista dos que estão falhando.
endpoints.totalnumber—Total.
endpoints.availablenumber—Indica se há dados disponíveis.
endpoints.partialnumber—true quando apenas parte dos dados esperados está presente.
endpoints.degradednumbercountNúmero de endpoints cujo status ao vivo é `degraded`.
endpoints.downnumbercountNúmero de endpoints cujo status ao vivo é `down`.
endpoints.unavailablenumber—Itens para os quais não há dados disponíveis, com os motivos. Nunca são reportados como 0.
endpoints.unknownnumbercountNúmero de endpoints cujo status ao vivo é `unknown` (sem resultado de sondagem recente).
endpoints.failingarray—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[].idstring—Identificador.
endpoints.failing[].pathstring—Caminho do endpoint.
endpoints.failing[].statusstring—Status.
endpoints.failing[].reasonstring—Código do motivo.
endpoints.failing[].httpnumber—Status HTTP da última sondagem; `null` quando nunca foi sondado.
endpoints.failing[].last_ok_atnumbermsTimestamp.
endpoints.failing[].fail_streaknumbercountNúmero de sondagens com falha consecutivas.
latency_msobject—Distribuição do tempo de resposta da chamada de sondagem bem-sucedida mais recente de cada endpoint, medida no host da API.
latency_ms.p50numbermsTempo de resposta mediano entre os endpoints; null quando não há amostra atualizada.
latency_ms.p95numbermsTempo de resposta do 95º percentil entre os endpoints; null quando não há amostra atualizada.
latency_ms.maxnumber—Máximo.
latency_ms.samplenumbercountNúmero de endpoints incluídos nos valores de latência.
latency_ms.measuredstring—Nota em texto simples sobre onde a latência é medida: no lado do servidor, excluído o trânsito de rede.
uptimeobject—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_daysnumberdaysDuração da janela de disponibilidade (30).
uptime.checksnumbercountNúmero de verificações de sondagem na janela, todos os endpoints em conjunto.
uptime.oknumbercountNúmero dessas verificações que tiveram sucesso.
uptime.pctnumber%Percentual.
uptime.tracking_sincestring—Primeiro dia com dados de sondagem dentro da janela, `YYYY-MM-DD`; null quando ainda não há dados.
uptime.daysarray—Valores diários ou número de dias.
uptime.days[]object—Valores diários ou número de dias.
uptime.days[].daystring—Dia de calendário (UTC).
uptime.days[].checksnumbercountNúmero de requisições de sondagem nesse dia.
uptime.days[].oknumbercountNúmero de requisições de sondagem bem-sucedidas nesse dia.
uptime.days[].pctnumber%Percentual.
uptime.days[].schema_pctnumber%Parcela das respostas sondadas nesse dia que corresponderam à tabela de campos documentada.
uptime.days[].avg_msnumbermsTempo médio de resposta nesse dia.
collectorsobject—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.familiesarray—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[].familystring—ID da família, por exemplo, `ticker`, `oi`, `funding`, `liquidation`, `options`.
collectors.families[].titlestring—Título de exibição da família.
collectors.families[].exchanges_collectednumbercountCorretoras para as quais a família é coletada: fresh + partial + stale + broken.
collectors.families[].freshnumbercountCorretoras cujo dado mais recente da família está dentro da janela de atualidade.
collectors.families[].partialnumber—true quando apenas parte dos dados esperados está presente.
collectors.families[].stalenumber—Linhas ou indicador referentes a dados mais antigos que a janela de atualidade.
collectors.families[].brokennumbercountCorretoras cuja origem continua falhando ou cujas linhas, em sua maioria, falham nas verificações de consistência da família.
collectors.families[].unavailablenumber—Itens para os quais não há dados disponíveis, com os motivos. Nunca são reportados como 0.
collectors.families[].statusstring—Status.
collectors.datasetsarray—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[].familystring—ID do conjunto de dados, por exemplo, `etf` ou `cme`.
collectors.datasets[].idstring—Identificador.
collectors.datasets[].titlestring—Nome de exibição do conjunto de dados.
collectors.datasets[].sourcestring—De onde vem o valor.
collectors.datasets[].endpointstring—Endpoint público que serve o conjunto de dados.
collectors.datasets[].statusstring—Status.
collectors.datasets[].lag_snumbersIdade do ponto de dados mais recente quando a resposta foi montada.
collectors.datasets[].source_atnumbermsTimestamp.
collectors.datasets[].fetched_atnumbermsQuando a CoinBoss obteve os dados da fonte.
collectors.datasets[].fresh_within_snumbersJanela de atualidade: dados mais recentes que isso contam como atualizados.
collectors.datasets[].coverageobject—O que está incluído e o que está faltando.
collectors.datasets[].coverage.funds_totalnumbercountNúmero de fundos acompanhados. pode estar ausente
collectors.datasets[].coverage.funds_coverednumbercountNúmero de fundos com uma divulgação utilizável. pode estar ausente
collectors.datasets[].coverage.funds_unavailablenumbercountNúmero de fundos cujo emissor não publica divulgação legível por máquina. pode estar ausente
collectors.datasets[].coverage.funds_failingnumbercountNúmero de fundos cuja divulgação não pôde ser lida na última rodada de coleta. pode estar ausente
collectors.datasets[].coverage.as_ofstring—Data de divulgação mais recente entre os fundos cobertos (YYYY-MM-DD). pode estar ausente
collectors.datasets[].coverage.as_of_minstring—Data de divulgação mais antiga entre os fundos cobertos (YYYY-MM-DD). pode estar ausente
collectors.datasets[].reasonstring|null—Código do motivo.
collectors.datasets[].coverage.contractsnumber—Linhas por contrato. pode estar ausente
collectors.datasets[].coverage.report_datestring—Data do relatório Commitments of Traders mais recente da CFTC (YYYY-MM-DD). pode estar ausente
collectors.datasets[].coverage.productsnumbercountNúmero de produtos da CME cobertos. pode estar ausente
collectors.datasets[].coverage.trade_datestring—Data de negociação do relatório diário mais recente da CME (YYYY-MM-DD). pode estar ausente
collectors.patrol_okboolean—true quando a ronda de qualidade dos dados foi executada nos últimos 15 minutos.
collectors.patrol_age_snumbersSegundos desde o evento.
collectors.evaluated_atnumbermsTimestamp.
incidentsobject—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.opennumber—Preço de abertura do período.
incidents.itemsarray—Itens do resultado.
incidents.items[]object—Itens do resultado.
incidents.items[].levelstring—Nível.
incidents.items[].exchangestring—ID da corretora, em minúsculas (por exemplo, `binance`).
incidents.items[].familystring—Família de dados a que o alerta se refere.
incidents.items[].codestring—Código.
incidents.items[].detailstring—Detalhe.
incidents.items[].opened_atnumbermsTimestamp.
incidents.items[].last_seen_atnumbermsTimestamp.
incidents.items[].resolved_atnumber|nullmsTimestamp.
incidents.items[].hitsnumbercountNúmero de execuções da ronda (uma a cada 5 minutos) que observaram a condição desde a abertura do alerta.
incidents.items[].openboolean—Preço de abertura do período.
probeobject—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_atnumbermsTimestamp.
probe.age_snumbersSegundos desde a última atualização desta linha.
probe.interval_snumbersIntervalo planejado entre duas execuções da sonda (300).
probe.freshboolean—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.errornull—Mensagem de erro (presente apenas em caso de falha).
probe.endpoints_checkednumbercountNúmero de endpoints verificados na última rodada de sondagem.
probe.oknumbercountNúmero de endpoints que responderam corretamente na última rodada de sondagem.
probe.failednumbercountNúmero de endpoints que falharam na última rodada de sondagem.
probe.schema_mismatchnumbercountNúmero de endpoints cuja resposta não correspondeu à tabela de campos documentada.
probe.alt_samples_failednullcountNúmero de requisições de amostra adicionais que falharam; `null` quando a última rodada não as executou.
legendobject—Definição em texto simples de cada valor de `overall`.
legend.operationalstring—Definição de `operational`.
legend.degradedstring—Definição de `degraded`.
legend.partial_outagestring—Definição de `partial_outage`.
legend.major_outagestring—Definição de `major_outage`.
legend.unknownstring—Definição de `unknown`.
metaobject—Envelope desta resposta: ID do esquema, sistema produtor, timestamps, tempo de vida do cache e atualidade.
meta.schemastring—ID do esquema desta resposta; mesmo valor do `schema` de nível superior.
meta.sourcearray—De onde vem o valor.
meta.source[]object—De onde vem o valor.
meta.source[].systemstring—Sistema que produziu os dados; sempre `coinboss` nos endpoints do centro de desenvolvedores.
meta.source[].componentstring—Componente por trás dos dados: a sonda de endpoints e a ronda de qualidade dos dados.
meta.observed_atnull—Timestamp.
meta.received_atnumbermsTimestamp.
meta.fetched_atnumbermsQuando a CoinBoss obteve os dados da fonte.
meta.windowstring—Janela.
meta.cache_ttl_snumbersTempo de vida do cache do servidor para esta resposta.
meta.qualitystring—`FRESH` quando a sonda de endpoints reportou nos últimos 20 minutos; caso contrário, `STALE`.
meta.is_staleboolean—true quando a linha é mais antiga que a janela de atualidade; linhas desatualizadas não entram nos totais.
meta.fallbackstring—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": [
      • { … 4 },
      • { … 4 }
      ],
    • "endpoints": {
      • "total": 299,
      • "available": 256,
      • "partial": 17,
      • "degraded": 17,
      • "down": 8,
      • "unavailable": 1,
      • "unknown": 0,
      • "failing": [ … 2 ]
      },
    • "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": [ … 2 ]
      },
    • "collectors": {
      • "families": [ … 2 ],
      • "datasets": [ … 2 ],
      • "patrol_ok": true,
      • "patrol_age_s": 282,
      • "evaluated_at": 1794542027976
      },
    • "incidents": {
      • "open": 2,
      • "items": [ … 2 ]
      },
    • "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": [ … 1 ],
      • "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

DisponívelVerificado 2026-11-13 03:53:47 UTCHTTP 200872 msEsquema confereDado mais recente: há 5m

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/meta/statusDisponível
Parâmetros

Sem parâmetros.

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