Séries

Buscar séries

Busca no catálogo de séries por nome ou código, com filtro de fonte. Use o series_id devolvido nas rotas de cotações.

GEThttps://api.fintay.com.br/v1/series/catalog

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de consulta

sourcestring

Fonte da série, como devolvida em /v1/series/sources (ex.: bacen, b3, cvm, anbima, fred).

searchstring

Texto buscado no nome e no código da série.

pageintegerpadrão: 1mín. 1

Página, a partir de 1.

per_pageintegerpadrão: 50mín. 1 · máx. 200

Itens por página.

include_inactivebooleanpadrão: false

Inclui séries descontinuadas.

Resposta

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

series_idstring

Exemplo: 22306924-aab6-4286-8ce0-217a1efead9c

namestring

Exemplo: Índice nacional de preços ao consumidor-amplo (IPCA)

sourcestring

Exemplo: bacen

id_typestring

Exemplo: sgs_code

id_valuestring

Exemplo: 433

frequencystring

Exemplo: M

unitstring

Exemplo: Var. % mensal

GETBuscar séries

curl "https://api.fintay.com.br/v1/series/catalog?source=bacen&search=ipca&per_page=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "series_id": "22306924-aab6-4286-8ce0-217a1efead9c",
        "name": "Índice nacional de preços ao consumidor-amplo (IPCA)",
        "source": "bacen",
        "id_type": "sgs_code",
        "id_value": "433",
        "frequency": "M",
        "unit": "Var. % mensal"
      },
      {
        "series_id": "ea1c30e7-2501-456f-ad5c-70f5b91348fb",
        "name": "Índice nacional de preços ao consumidor - amplo (IPCA) - em 12 meses",
        "source": "bacen",
        "id_type": "sgs_code",
        "id_value": "13522",
        "frequency": "M",
        "unit": "%"
      }
    ],
    "total": 2,
    "page": 1,
    "per_page": 3
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}