GETDisponível
Produtos de ETF / trust de um emissor
Produtos de ETF / trust de um emissor
GET
/api/etf/issuerRequisição
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Padrão | Valores aceitos | Descrição |
|---|---|---|---|---|---|
| issuer | string | Opcional | Grayscale | — | Nome do emissor (máx. 64 caracteres). Exemplo: Grayscale |
Exemplo de requisição
curl -s "https://www.coinboss.com/api/etf/issuer?issuer=Grayscale"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 }`. |
| issuer | string | — | Emissor do fundo. |
| unit | string | — | Unidade dos valores deste objeto. |
| products | array | — | Produtos de ETF do emissor com seu histórico completo de fluxos; primeiro os produtos de BTC, depois por ticker. |
| products[] | object | — | Um produto: `ticker`, `asset` subjacente, `count` de linhas, resumo `latest` e `data` diários. |
| products[].ticker | string | — | Ticker do fundo. |
| products[].asset | string | — | Símbolo do ativo. |
| products[].count | number | — | Número de itens. |
| products[].latest | object | — | Registro mais recente. |
| products[].latest.date | string | — | Data do calendário (UTC). |
| products[].latest.flow | number | — | Fluxo líquido de criação / resgate do dia. |
| products[].latest.cum_total | number | — | Total acumulado. |
| products[].latest.aum | number|null | — | Ativos sob gestão. |
| products[].latest.aum_date | string|null | — | Dia de negociação (YYYY-MM-DD) da linha da qual `latest.aum` foi obtido; pode ser anterior a `latest.date`, null quando não existe AUM. |
| products[].latest.sum_7d | number | — | Soma de 7 dias. |
| products[].data | array | — | Conteúdo da resposta. |
| products[].data[] | object | — | Conteúdo da resposta. |
| products[].data[].date | string | — | Data do calendário (UTC). |
| products[].data[].flow | number | — | Fluxo líquido de criação / resgate do dia. |
| products[].data[].aum | number|null | — | Ativos sob gestão. |
| products[].data[].premium | number|null | — | Ágio (+) ou deságio (−) do preço de mercado em relação ao NAV. |
| products[].data[].cum | number | — | Fluxo líquido acumulado desde a listagem. |
Gerada 2026-11-11 23:00 UTC a partir de 1 respostas reais.
Exemplo de resposta
/api/etf/issuer?issuer=Grayscale · Resposta real capturada 2026-11-13 04:02:52 UTC. Arrays e mapas longos são encurtados para exibição: products tinha 6 itens; products[].data tinha 713 itens.
- "success"true
- "issuer""Grayscale"
- "unit""million_usd"
- "products"
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
- histórico completo por produto
- Fontes de dados
- Histórico de fluxos por produto de um emissor de ETF, a partir de um rastreador público de fluxos de ETF; AUM de um site público de dados de mercado.
- Cobertura de corretoras
- Produtos do emissor informado (padrão Grayscale) em BTC/ETH/SOL/HYPE; o nome do emissor deve corresponder exatamente ao rótulo armazenado.
- Ordenação
- produtos: BTC primeiro, depois por ticker; dados por data crescente
- Unidades
- million USD (flow, cum, aum); premium in percent
- Método
- cum is the running sum of daily flows per product; sum_7d sums the last 7 trading days.
- 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
DisponívelVerificado 2026-11-13 04:02:52 UTCHTTP 2002 msEsquema confereDado mais recente: há 28h
Disponibilidade, últimos 30 dias
100% de 411 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
GET
/api/etf/issuerDisponívelParâmetros
string · padrão Grayscale — Issuer name (max 64 chars).
URL da requisição
https://www.coinboss.com/api/etf/issuer?issuer=GrayscaleEscolha um endpoint e clique em “Enviar requisição”. A resposta, os cabeçalhos e o tempo de resposta aparecerão aqui.
Mais 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