fintay
ExplorarSoluçõesModelosPara quem éPreçosAjuda
EntrarComeçar grátis

DADOS

Séries e cotações

Encontre a série certa no catálogo e consulte o histórico com filtros de data e formato.

O catálogo lista as séries com fonte, identificador, frequência e unidade. Busque por nome e filtre pela fonte:

curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.fintay.com.br/v1/series/catalog?search=selic&per_page=10"
Troque SUA_CHAVE pela sua chave. Crie uma conta grátis para gerar a sua.

Cada item informa series_id, source, id_type, id_value, frequency e unit. A lista de fontes disponíveis sai de GET /v1/series/sources.

Três formas de identificar uma série

FormaExemploQuando usar
UUID/v1/series/{series_id}/quotesA mais estável; prefira em integrações
Fonte e código/v1/series/bacen/432/quotesCódigos do Banco Central, ANBIMA, B3 e FRED
Fonte, tipo e código/v1/series/cvm/cnpj_fundo_classe/{cnpj}/quotesFontes com mais de um tipo de identificador, como a cota de um fundo
Atenção

Não presuma que um ticker exista em todas as fontes. Confirme no catálogo antes de montar a integração.

Filtre o período

  • date_from e date_to, no formato AAAA-MM-DD, limitam o período.
  • limit devolve só os pontos mais recentes depois do filtro.
curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.fintay.com.br/v1/series/bacen/11/quotes?date_from=2025-01-01&limit=30"
Troque SUA_CHAVE pela sua chave. Crie uma conta grátis para gerar a sua.

Escolha o formato

O padrão é JSON. Para levar direto para uma planilha, peça CSV ou Excel com o parâmetro format:

curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.fintay.com.br/v1/series/bacen/432/quotes?format=csv&limit=100"
Troque SUA_CHAVE pela sua chave. Crie uma conta grátis para gerar a sua.

Respostas que pedem atenção

  • 202 com status discovering ou ingesting: a série está sendo carregada. Espere retry_after segundos e repita.
  • 200 com points vazio: a série existe, mas não há dados no período pedido. Amplie as datas.
  • 404: o identificador não foi encontrado. Volte ao catálogo.

Fundamentos de empresas

Ações e outras séries com dados de balanço trazem fundamentos em /fundamentals:

curl -H "X-API-Key: SUA_CHAVE" \
  "https://api.fintay.com.br/v1/series/b3/PETR4/fundamentals"
Troque SUA_CHAVE pela sua chave. Crie uma conta grátis para gerar a sua.

A cobertura e a data de referência variam por empresa. Campo ausente não significa zero; veja como interpretar em Qualidade dos dados.