Ações e índices

Listar ativos da B3

Ações, units, FIIs, ETFs e BDRs negociados na B3, com último fechamento e series_id de cada um.

GEThttps://api.fintay.com.br/v1/b3/tickers

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de consulta

asset_classstring

Classe do ativo: acao, unit, fii, etf, bdr, indice, fundo_listado.

searchstring

Parte do ticker ou do nome.

include_inactivebooleanpadrão: false

Inclui ativos que deixaram de ser negociados.

pageintegerpadrão: 1mín. 1

Página, a partir de 1.

per_pageintegerpadrão: 100mín. 1 · máx. 500

Itens por página.

Resposta

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

tickerstring

Exemplo: PETR3

series_idstring

Exemplo: 0656231b-c8b4-41ad-81d9-1fafdb0e7e7d

asset_classstring

Exemplo: acao

asset_groupstring

Exemplo: stock

namestring

Exemplo: Petroleo Brasileiro SA

sectorstring

Exemplo: Energia

is_activeboolean

Exemplo: true

last_datestring

Exemplo: 2026-10-09

latest_closenumber

Exemplo: 63.06

GETListar ativos da B3

curl "https://api.fintay.com.br/v1/b3/tickers?asset_class=acao&search=PETR&per_page=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "ticker": "PETR3",
        "series_id": "0656231b-c8b4-41ad-81d9-1fafdb0e7e7d",
        "asset_class": "acao",
        "asset_group": "stock",
        "name": "Petroleo Brasileiro SA",
        "sector": "Energia",
        "is_active": true,
        "last_date": "2026-10-09",
        "latest_close": 63.06
      },
      {
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "asset_class": "acao",
        "asset_group": "stock",
        "name": "Petroleo Brasileiro SA Pfd",
        "sector": "Energia",
        "is_active": true,
        "last_date": "2026-10-09",
        "latest_close": 56
      },
      {
        "ticker": "RECV3",
        "series_id": "8370b621-0eb2-439f-b1da-f012c57bd608",
        "asset_class": "acao",
        "asset_group": "stock",
        "name": "Petroreconcavo SA",
        "sector": "Energia",
        "is_active": true,
        "last_date": "2026-10-09",
        "latest_close": 12.22
      }
    ],
    "total": 3,
    "page": 1,
    "per_page": 3,
    "asset_class": "acao",
    "class_counts": {
      "fundo_listado": 72,
      "acao": 338,
      "bdr": 582,
      "unit": 10,
      "fii": 310,
      "indice": 4,
      "etf": 209,
      "outro": 3,
      "fracionario": 374
    }
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}