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

COMECE AQUI

Primeiros passos

Da criação da chave à primeira consulta, em poucos minutos.

Este guia leva você da conta recém-criada até a primeira série consultada pela API. Se preferir não programar, o terminal, o Excel e a IA usam os mesmos dados sem nenhuma linha de código.

Veja um dado real agora

Antes de criar qualquer coisa, consulte a meta da Selic direto da base:

Experimente · dado real
Meta da taxa Selic

Clique em Executar para buscar o valor mais recente direto da base.

Crie uma chave

  1. Crie sua conta e confirme o e-mail.
  2. No painel, abra Conta e API → API Keys e clique em criar chave.
  3. Copie a chave na hora: ela só aparece completa no momento da criação.
Dica

Guarde a chave em uma variável de ambiente ou em um cofre de segredos. Se ela vazar, revogue em API Keys e crie outra.

Faça a primeira consulta

Toda chamada usa a origem https://api.fintay.com.br e envia a chave no cabeçalho X-API-Key. O exemplo abaixo traz os dois pontos mais recentes da meta da Selic (código 432 do Banco Central):

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

Leia a resposta

As respostas em JSON seguem sempre o mesmo envelope:

JSON
{
  "success": true,
  "data": {
    "series_id": "d1e42164-fa05-422f-8f81-66ebe24b3be1",
    "points": [
      { "reference_date": "2026-09-25", "value": 13.75 },
      { "reference_date": "2026-09-26", "value": 13.75 }
    ]
  },
  "meta": { "request_id": "…", "format": "json" }
}
  • data.points traz a série em ordem de data: reference_date é o dia (ou mês) a que o valor se refere e value, o valor. Em ativos da B3 vêm também open_price, high_price, low_price, close_price e volume.
  • meta.request_id identifica a chamada. Informe esse código ao falar com o suporte.
Nota

Uma resposta 202 significa que a série está sendo carregada pela primeira vez. Espere o tempo indicado em retry_after e repita a consulta.

Próximos passos