Volume 24h—Contratos em aberto—Liquidações 24h$1.36BLong/Short 24h—Dominância BTC—Dominância ETH—
App
Idioma ▾
R$ BRL ▾
/api/etf/fund/:ticker
GETDisponível

Detalhe de um ETF

Detalhe de um ETF (perfil e histórico de fluxos)

GET/api/etf/fund/:ticker

Requisição

Parâmetros de consulta

NomeTipoObrigatórioPadrãoValores aceitosDescrição
ticker pathstringObrigatório——Ticker do fundo (somente letras, convertido para maiúsculas); 404 se desconhecido. Exemplo: IBIT

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

Exemplo de requisição

curl -s "https://www.coinboss.com/api/etf/fund/IBIT"

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 }`.
tickerstring—Ticker do fundo.
assetstring—Símbolo do ativo.
issuerstring—Emissor do fundo.
priceobject—Último preço na moeda de cotação (USD ou USDT, salvo indicação em contrário).
price.currencystring—Símbolo da moeda / do ativo.
price.latestobject—Registro mais recente.
price.latest.datestring—Data do calendário (UTC).
price.latest.closenumber—Preço de fechamento do período.
price.latest.opennumber—Preço de abertura do período.
price.latest.highnumber—Máxima do período.
price.latest.lownumber—Mínima do período.
price.latest.volumenumber—Volume.
price.change_absnumberUSDFechamento diário mais recente da cota do fundo menos o fechamento do dia de negociação anterior.
price.change_pctnumber%Variação percentual.
price.week52_highnumberUSDMaior máxima diária da cota do fundo nos 365 dias corridos até a data de preço mais recente.
price.week52_lownumberUSDMenor mínima diária da cota do fundo nos 365 dias corridos até a data de preço mais recente.
price.avg_volume_10dnumbersharesVolume médio diário de negociação do fundo nos últimos 10 dias de negociação, em cotas.
price.countnumber—Número de itens.
price.dataarray—Conteúdo da resposta.
price.data[]object—Conteúdo da resposta.
price.data[].datestring—Data do calendário (UTC).
price.data[].opennumber—Preço de abertura do período.
price.data[].highnumber—Máxima do período.
price.data[].lownumber—Mínima do período.
price.data[].closenumber—Preço de fechamento do período.
price.data[].volumenumber—Volume.
fundobject—Valores de snapshot no nível do fundo; cada um é o último valor conhecido e pode ser de dias diferentes (veja `aum_as_of`).
fund.aum_usd_millionnumbermillion USDValor mais recente, não nulo, dos ativos sob gestão do fundo, válido em `aum_as_of`.
fund.aum_as_ofstring—Dia de negociação (YYYY-MM-DD) a que `aum_usd_million` se refere.
fund.estimated_holdingsnumbercoinEstimativa de moedas detidas pelo fundo: último AUM conhecido ÷ preço spot atual do ativo; uma estimativa, e não uma participação reportada pelo emissor.
fund.fee_pctnumber%Taxa de administração anual do fundo, em percentual (0.25 = 0.25 % ao ano); último valor conhecido de uma fonte terceira.
fund.mkt_share_pctnumber%AUM do fundo como percentual da capitalização de mercado total da moeda subjacente (e não a sua participação entre os ETFs); último valor conhecido da fonte terceira.
fund.volume_usd_millionnumbermillion USDVolume de negociação do fundo no último dia em que uma fonte terceira o reportou.
fund.cum_inflow_official_millionnumbermillion USDEntrada líquida acumulada desde o lançamento, conforme publicada por uma fonte terceira (último valor conhecido); pode diferir da soma em `flows.latest.cum_total`.
flowsobject—Histórico diário de fluxo líquido do fundo com total acumulado; os montantes estão em milhões de USD (`unit`).
flows.unitstring—Unidade dos valores deste objeto.
flows.latestobject—Registro mais recente.
flows.latest.datestring—Data do calendário (UTC).
flows.latest.flownumber—Fluxo líquido de criação / resgate do dia.
flows.latest.cum_totalnumber—Total acumulado.
flows.latest.sum_7dnumber—Soma de 7 dias.
flows.countnumber—Número de itens.
flows.dataarray—Conteúdo da resposta.
flows.data[]object—Conteúdo da resposta.
flows.data[].datestring—Data do calendário (UTC).
flows.data[].flownumber—Fluxo líquido de criação / resgate do dia.
flows.data[].cumnumber—Fluxo líquido acumulado desde a listagem.
premiumobject—Ágio (+) ou deságio (−) do preço de mercado em relação ao NAV.
premium.unitstring—Unidade dos valores deste objeto.
premium.notestring—Observação.
premium.countnumber—Número de itens.
premium.dataarray—Conteúdo da resposta.
premium.data[]object—Conteúdo da resposta.
premium.data[].datestring—Data do calendário (UTC).
premium.data[].premiumnumber—Ágio (+) ou deságio (−) do preço de mercado em relação ao NAV.

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

Exemplo de resposta

/api/etf/fund/IBIT · Resposta real capturada 2026-11-13 04:02:51 UTC. Arrays e mapas longos são encurtados para exibição: flows.data tinha 712 itens; price.data tinha 713 itens; premium.data tinha 64 itens.

  • {
    • "success": true,
    • "ticker": "IBIT",
    • "asset": "BTC",
    • "issuer": "BlackRock",
    • "price": {
      • "currency": "USD",
      • "latest": { … 6 },
      • "change_abs": -1.88,
      • "change_pct": -4.4508,
      • "week52_high": 59.56,
      • "week52_low": 32.84,
      • "avg_volume_10d": 52099530,
      • "count": 713,
      • "data": [ … 2 ]
      },
    • "fund": {
      • "aum_usd_million": 62297.756,
      • "aum_as_of": "2026-11-11",
      • "estimated_holdings": 905689.4173,
      • "fee_pct": 0.25,
      • "mkt_share_pct": 3.995,
      • "volume_usd_million": 2604.817,
      • "cum_inflow_official_million": 65711.051
      },
    • "flows": {
      • "unit": "million_usd",
      • "latest": { … 4 },
      • "count": 712,
      • "data": [ … 2 ]
      },
    • "premium": {
      • "unit": "pct",
      • "note": "sparse_snapshot",
      • "count": 64,
      • "data": [ … 2 ]
      }
    }

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 (preços no minuto 20, fluxos no minuto 15); barras diárias
Janela
histórico diário armazenado de preços e fluxos; máxima/mínima de 52 semanas e volume médio de 10 dias
Fontes de dados
Dados da página de um único fundo: preços diários do fundo de um site público de dados de mercado, fluxos de um rastreador público de fluxos de ETF.
Cobertura de corretoras
36 tickers rastreados de ETFs à vista dos EUA (404 para tickers desconhecidos).
Ordenação
data em ordem crescente
Unidades
USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
Método
estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
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:51 UTCHTTP 2001 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ó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/etf/fund/:tickerDisponível
Parâmetros

string — Fund ticker (letters only, upper-cased); 404 if unknown.

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