Introdução

URL base

Todas as rotas ficam sob a mesma origem, com o prefixo da versão:

Autenticação

Envie a sua chave no cabeçalho X-API-Key em toda chamada. Crie a chave em API Keys; o valor completo aparece uma vez só, na criação. Detalhes em Chaves e limites.

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

Formato das respostas

As respostas JSON vêm num envelope com o resultado em data e o identificador da chamada em meta.request_id (informe-o ao suporte se algo der errado):

{
  "success": true,
  "data": {
    "series_id": "22306924-aab6-4286-8ce0-217a1efead9c",
    "points": [
      {
        "reference_date": "2026-09-01",
        "value": 0.82
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "8e8e6799-19ee-4e1d-b869-9c1adbac1b98",
    "format": "json"
  }
}

• Datas em ISO 8601 (AAAA-MM-DD); horários em UTC com fuso explícito.
• Números como número JSON, sem formatação. Percentuais seguem a unidade da série (ex.: 13,75 para 13,75% a.a.); razões como dividend_yield vêm em fração (0,07 = 7%).
• Ausência de dado é null, nunca zero.
• CSV e Excel: as rotas de cotações aceitam format=csv ou format=xlsx e devolvem o arquivo, sem envelope.

Paginação

As listas usam um de dois estilos, indicado nos parâmetros de cada rota:

• page e per_page: a resposta traz items, total, page e per_page.
• limit e offset: a resposta traz items e, quando há mais, has_more: true.

Históricos de séries usam limit contado a partir do ponto mais recente e o recorte por date_from e date_to.

Como identificar uma série

Cada série tem um series_id (UUID) e um ou mais códigos na fonte. As rotas de cotações aceitam qualquer um:

Rotas por assunto

Sem escrever código

Os mesmos dados chegam ao Excel por funções como =Fintay_Serie(), ao terminal por comandos e à sua IA pelo conector MCP, todos com a mesma conta e a mesma cota.