Séries

Cotações ajustadas por proventos

Preços de um ativo da B3 ajustados por dividendos, JCP, desdobramentos e grupamentos, prontos para calcular retorno total.

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

Só ativos com histórico de preços conferido têm preço ajustado. Para os demais, a rota responde 422 com "histórico de preços em revisão"; se houver um buraco de mais de 7 dias no período, responde 422 com "lacuna no histórico".

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 do ativo.

Parâmetros de consulta

date_fromstring · date

Data inicial, inclusiva.

date_tostring · date

Data final, inclusiva.

limitintegerpadrão: 2000mín. 1 · máx. 10000

Máximo de pontos.

Resposta

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

reference_datestring

Exemplo: 2026-10-07

valuenumber

Exemplo: 55.12

GETCotações ajustadas por proventos

curl "https://api.fintay.com.br/v1/series/34f27cc6-1076-46c0-aeb7-b5e85499b799/adjusted-quotes?date_from=2026-10-01&limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
    "price_basis": "source_adjusted",
    "points": [
      {
        "reference_date": "2026-10-07",
        "value": 55.12
      },
      {
        "reference_date": "2026-10-08",
        "value": 55.48
      },
      {
        "reference_date": "2026-10-09",
        "value": 56
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}