Ações e índices

Histórico de um índice

Série histórica de fechamento de um índice, como ^BVSP (Ibovespa) ou IFIX.SA.

GEThttps://api.fintay.com.br/v1/indices/{ticker}

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de rota

tickerstringobrigatório

Código do índice, como em /v1/indices.

Parâmetros de consulta

date_fromstring · date

Data inicial.

date_tostring · date

Data final.

limitintegerpadrão: 5000mín. 1 · máx. 20000

Máximo de pontos.

Resposta

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

reference_datestring

Exemplo: 2026-10-05

close_priceinteger

Exemplo: 206912

open_pricenull

high_pricenull

low_pricenull

volumenull

GETHistórico de um índice

curl "https://api.fintay.com.br/v1/indices/%5EBVSP?limit=5" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "index": {
      "ticker": "^BVSP",
      "series_id": "0f00362d-0325-4927-a74e-69f32af02804",
      "name": "Ibovespa",
      "source": "b3",
      "family": "Bolsa",
      "is_active": true,
      "is_brazilian": true,
      "first_date": "2026-10-05",
      "last_date": "2026-10-09",
      "latest_close": 209067,
      "previous_close": 206220,
      "change_percent": 1.38
    },
    "points": [
      {
        "reference_date": "2026-10-05",
        "close_price": 206912,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-10-06",
        "close_price": 205835,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-10-07",
        "close_price": 204302,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}