Fluxos líquidos diários de ETFs à vista por fundo
Fluxos líquidos diários de ETFs à vista por fundo
/api/etf/detailRequisição
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Padrão | Valores aceitos | Descrição |
|---|---|---|---|---|---|
| asset | string | Opcional | BTC | BTC, ETH, SOL, HYPE | Ativo subjacente. Qualquer outro valor retorna 400 `INVALID_PARAM`. Exemplo: BTC |
| days | integer | Opcional | 30 | ≥ 1 · ≤ 120 | Janela retrospectiva em dias. Exemplo: 30 |
Exemplo de requisição
curl -s "https://www.coinboss.com/api/etf/detail?asset=BTC&days=30"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 }`. |
| asset | string | — | Símbolo do ativo. |
| days | number | — | Valores diários ou número de dias. |
| unit | string | — | Unidade dos valores deste objeto. |
| tickers | array | — | Tickers dos fundos que aparecem como colunas da matriz `data`, em ordem alfabética, com `TOTAL` por último. |
| tickers[] | object | — | Uma coluna: `ticker` e o respectivo `issuer` (null para `TOTAL` e quando o emissor é desconhecido). |
| tickers[].ticker | string | — | Ticker do fundo. |
| tickers[].issuer | string|null | — | Emissor do fundo. |
| dates | array | — | Datas de calendário (UTC). |
| dates[] | string | — | Datas de calendário (UTC). |
| data | object | — | Conteúdo da resposta. chaves dinâmicas: 2026-10-01,2026-10-02,2026-10-05,2026-10-06,2026-10-07,2026-10-08 |
| data.{*} | object | — | Conteúdo da resposta. chaves dinâmicas: ARKB,BITB,BRRR,BTC,BTCO,BTCW |
| data.{*}.{*} | number | — | Conteúdo da resposta. |
| data.{*}.TOTAL | number | million USD | Fluxo líquido de todos os ETFs spot do ativo somados nesse dia de negociação (as chaves de `data` são datas, YYYY-MM-DD); negativo = saída líquida. pode estar ausente |
Gerada 2026-11-11 23:00 UTC a partir de 1 respostas reais.
Exemplo de resposta
/api/etf/detail?asset=BTC&days=30 · Resposta real capturada 2026-11-13 03:58:18 UTC. Arrays e mapas longos são encurtados para exibição: data tinha 30 itens; dates tinha 30 itens; tickers tinha 13 itens; data.{*} tinha 13 itens.
- "success"true
- "asset""BTC"
- "days"30
- "unit""million_usd"
- "tickers"
- "dates"
- "2026-10-02"
- "2026-10-05"
- "2026-10-06"
- "2026-10-07"
- "2026-10-08"
- "2026-10-09"
- "2026-10-12"
- "2026-10-13"
- "data"
- "2026-10-02"
- "2026-10-05"
Detalhes
- Autenticação
- Nenhuma. Endpoint público.
- Limite de requisições
- 1200 requisições por minuto por IP
- Cache do servidor
- 5m
- Microcache de borda
- 10s
- Frequência de atualização
- a cada hora (minuto 15); a fonte publica uma vez por dia de negociação dos EUA
- Janela
- últimos 30 dias de negociação por padrão (`days` 1-120)
- Fontes de dados
- Fluxos líquidos diários por fundo dos ETFs à vista de cripto dos EUA, a partir de um rastreador público de fluxos de ETF.
- Cobertura de corretoras
- ETFs à vista dos EUA de BTC, ETH, SOL e HYPE; matriz de data x ticker, incluindo a coluna TOTAL; valores ausentes são null.
- Ordenação
- datas em ordem crescente; tickers em ordem alfabética, com TOTAL por último
- Unidades
- million USD
- 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
Disponibilidade, últimos 30 dias
100% de 410 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/etf/detailDisponívelstring · padrão BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.
integer · padrão 30 · mín. 1 · máx. 120 — Look-back window in days.
https://www.coinboss.com/api/etf/detail?asset=BTC&days=30Mais nesta categoria
- Fundos de ETF à vista /api/sd/etf/funds
- Histórico de ETFs à vista /api/sd/etf/history
- Visão geral de ETFs à vista (divulgações dos emissores) /api/sd/etf/overview
- Fluxos líquidos diários de ETFs à vista por fundo /api/etf/detail
- Histórico do fluxo líquido diário de ETFs à vista /api/etf/flows
- Detalhe de um ETF /api/etf/fund/:ticker
- Lista de fundos de ETF /api/etf/funds
- Participações em moedas dos ETFs por fundo /api/etf/holdings
- Produtos de ETF / trust de um emissor /api/etf/issuer
- Visão geral de ETFs /api/etf/overview
- Ágio / deságio dos trusts da Grayscale /api/grayscale/premium
- Volumes de ETFs baseados em futuros /api/indicators/futures-etf-volumes