Séries

Cotações por fonte e código

Histórico de uma série pelo código na fonte, sem precisar do series_id. É a forma mais curta: bacen/433 é o IPCA, b3/PETR4 é a ação da Petrobras.

GEThttps://api.fintay.com.br/v1/series/{source}/{code}/quotes

Para outras fontes ou tipos de identificador, use o caminho com o tipo explícito: /v1/series/{source}/{type1}/{code}/quotes.

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

sourcestringobrigatório

Fonte com tipo de identificador padrão: bacen (código SGS), b3 (ticker), anbima (código do índice) ou fred.

codestringobrigatório

Código da série na fonte.

Parâmetros de consulta

date_fromstring · date

Data inicial, inclusiva (AAAA-MM-DD).

date_tostring · date

Data final, inclusiva (AAAA-MM-DD).

limitintegerpadrão: 2000

Máximo de pontos, contados a partir do mais recente.

formatstringpadrão: json

json (padrão), csv ou xlsx. CSV e XLSX devolvem o arquivo, sem o envelope.

Resposta

Envelope { success, data, meta }. Campos de data.points[]:

reference_datestring

Exemplo: 2026-01-01

valuenumber

Exemplo: 0.33

open_pricenull

high_pricenull

low_pricenull

close_pricenull

volumenull

GETCotações por fonte e código

curl "https://api.fintay.com.br/v1/series/bacen/433/quotes?date_from=2026-01-01" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "series_id": "22306924-aab6-4286-8ce0-217a1efead9c",
    "points": [
      {
        "reference_date": "2026-01-01",
        "value": 0.33,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-03-01",
        "value": 0.88,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-04-01",
        "value": 0.67,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}