Volume 24h—Contratos em aberto—Liquidações 24h$1.36BLong/Short 24h—Dominância BTC—Dominância ETH—
App
Idioma ▾
R$ BRL ▾
/api/hl/tier/:slug
GETParcial

Detalhe de uma faixa da Hyperliquid

Detalhe de uma faixa da Hyperliquid (resumo, posições por moeda, risco de liquidação, aberturas recentes)

GET/api/hl/tier/:slug
Cobertura parcial. `liqRisk` e `actions` podem ser arrays vazios nas faixas com pouquíssimas carteiras.

Requisição

Parâmetros de consulta

NomeTipoObrigatórioPadrãoValores aceitosDescrição
slug pathstringObrigatório—stardust, meteor, asteroid, comet, planet, star, supernova, galaxySlug do nível; 404 se desconhecido. Exemplo: galaxy

Os parâmetros marcados como “path” fazem parte da URL.

Exemplo de requisição

curl -s "https://www.coinboss.com/api/hl/tier/galaxy"

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 }`.
updatednumbermsQuando os dados foram atualizados pela última vez.
tierobject—Faixa de tamanho da carteira.
tier.bucketnumbermsInício do bucket de tempo.
tier.slugstring—ID da faixa.
tier.minnumber—Mínimo.
tier.maxnull—Máximo.
networkobject—Contagens de carteiras com lucro / prejuízo deste nível entre todos os endereços do leaderboard da Hyperliquid, por janela de PnL; null quando não existe snapshot.
network.tsnumbermsTimestamp.
network.windowsobject—Valores por janela. chaves dinâmicas: allTime,day,month,week
network.windows.{*}object—Valores por janela.
network.windows.{*}.walletsnumber—Número de carteiras.
network.windows.{*}.profitnumber—Lucro.
network.windows.{*}.lossnumber—Prejuízo.
network.windows.{*}.flatnumber—Contagem ou valor estável (sem alteração).
network.windows.{*}.profitUsdnumberUSDSoma dos lucros.
network.windows.{*}.lossUsdnumberUSDSoma dos prejuízos.
poolobject—Números restritos aos endereços de baleias rastreadas cujo valor da conta se enquadra neste nível, e não à rede inteira.
pool.trackednumbercountEndereços de baleias rastreadas cujo valor da conta se enquadra neste nível.
pool.holdersnumbercountDesses, os endereços com pelo menos uma posição aberta.
pool.longUsdnumberUSDValor nocional long.
pool.shortUsdnumberUSDValor nocional short.
pool.upnlWinAddrsnumbercountEndereços com pelo menos uma posição com lucro não realizado; um endereço também pode ser contado em `upnlLoseAddrs`.
pool.upnlLoseAddrsnumbercountEndereços com pelo menos uma posição com prejuízo não realizado; um endereço também pode ser contado em `upnlWinAddrs`.
coinRankarray—As 20 principais moedas por valor total das posições mantidas pelos endereços rastreados deste nível.
coinRank[]object—Uma moeda com o valor das suas posições long, short e total, em USD.
coinRank[].coinstring—Símbolo da moeda, em maiúsculas (por exemplo, BTC).
coinRank[].longUsdnumberUSDValor nocional long.
coinRank[].shortUsdnumberUSDValor nocional short.
coinRank[].totalUsdnumberUSDTotal.
liqRiskarray—Até 15 moedas, ordenadas por valor da posição, cujo preço de marcação está a menos de 10 % do preço de liquidação; vazio quando não há nenhuma. vazio nas amostras usadas para gerar esta tabela
actionsarray—As 40 execuções de abertura de posição mais recentes (`open_long` / `open_short`) de endereços rastreados deste nível, da mais recente para a mais antiga. vazio nas amostras usadas para gerar esta tabela

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

Exemplo de resposta

/api/hl/tier/galaxy · Resposta real capturada 2026-11-13 03:58:38 UTC. Arrays e mapas longos são encurtados para exibição: coinRank tinha 20 itens; network.windows tinha 4 itens.

  • {
    • "success": true,
    • "updated": 1794542318268,
    • "tier": {
      • "bucket": 7,
      • "slug": "galaxy",
      • "min": 100000000,
      • "max": null
      },
    • "network": {
      • "ts": 1794541537300,
      • "windows": { … 2 }
      },
    • "pool": {
      • "tracked": 1,
      • "holders": 1,
      • "longUsd": 844581.06,
      • "shortUsd": 273471757.4,
      • "upnlWinAddrs": 1,
      • "upnlLoseAddrs": 1
      },
    • "coinRank": [
      • { … 4 },
      • { … 4 }
      ],
    • "liqRisk": [],
    • "actions": []
    }

Detalhes

Autenticação
Nenhuma. Endpoint público.
Limite de requisições
1200 requisições por minuto por IP
Cache do servidor
60s
Microcache de borda
10s
Frequência de atualização
buckets do leaderboard a cada 15 min; posições a cada 5 min; ações a cada 15 s; cache da API de 60 s
Janela
snapshots mais recentes; últimas 40 ações de abertura
Fontes de dados
Perfil de uma faixa de tamanho de conta na Hyperliquid: contagem de carteiras e PnL do leaderboard oficial, além das posições, do risco de liquidação e das aberturas recentes dos endereços de baleias rastreados nessa faixa.
Cobertura de corretoras
slug = stardust | meteor | asteroid | comet | planet | star | supernova | galaxy; bloco network = carteiras do leaderboard, blocos pool = somente o conjunto de baleias rastreadas
Paginação
nenhuma
Unidades
USD; counts
Método
liqRisk = notional of positions with |mark - liquidation price| / mark <= 10%
Timestamps
Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
Formato da resposta
json
Estabilidade
Estável

Status ao vivo

ParcialVerificado 2026-11-13 03:58:38 UTCHTTP 200220 msEsquema confereDado mais recente: há 0s

`liqRisk` e `actions` podem ser arrays vazios nas faixas com pouquíssimas carteiras.

Disponibilidade, últimos 30 dias

100% de 409 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/hl/tier/:slugParcial
Parâmetros

string — Tier slug; 404 if unknown.

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