Séries

Cotações por series_id

Histórico completo ou recortado de qualquer série do catálogo pelo series_id.

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

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de rota

series_idstringobrigatório

Identificador da série (UUID).

Parâmetros de consulta

date_fromstring · date

Data inicial, inclusiva.

date_tostring · date

Data final, inclusiva.

limitintegerpadrão: 2000

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

formatstringpadrão: json

json, csv ou xlsx.

Resposta

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

reference_datestring

Exemplo: 2026-09-24

valuenumber

Exemplo: 13.75

open_pricenull

high_pricenull

low_pricenull

close_pricenull

volumenull

GETCotações por series_id

curl "https://api.fintay.com.br/v1/series/d1e42164-fa05-422f-8f81-66ebe24b3be1/quotes?limit=5" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "series_id": "d1e42164-fa05-422f-8f81-66ebe24b3be1",
    "points": [
      {
        "reference_date": "2026-09-24",
        "value": 13.75,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-09-25",
        "value": 13.75,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-09-26",
        "value": 13.75,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}