Ações e índices

Buscar ações internacionais

Busca ações de bolsas fora do Brasil por ticker ou nome, com país e bolsa de listagem.

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

Autorização

X-API-Keystringheaderobrigatório

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

Parâmetros de consulta

searchstringobrigatório

Ticker ou parte do nome.

countrystring

País em ISO 3166-1, ex.: US, GB, JP.

pageintegerpadrão: 1mín. 1

Página.

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

Itens por página.

Resposta

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

symbolstring

Exemplo: AAPL

namestring

Exemplo: Apple Inc.

countrystring

Exemplo: US

exchangestring

Exemplo: Nasdaq

asset_typestring

Exemplo: acao

currencystring

Exemplo: USD

series_idnull

latest_closenull

GETBuscar ações internacionais

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

Resposta

{
  "success": true,
  "data": {
    "items": [
      {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "country": "US",
        "exchange": "Nasdaq",
        "asset_type": "acao",
        "currency": "USD",
        "series_id": null,
        "latest_close": null
      },
      {
        "symbol": "APLE",
        "name": "Apple Hospitality REIT, Inc.",
        "country": "US",
        "exchange": "NYSE",
        "asset_type": "acao",
        "currency": "USD",
        "series_id": null,
        "latest_close": null
      },
      {
        "symbol": "2788.T",
        "name": "Apple International Co., Ltd.",
        "country": "JP",
        "exchange": "Bolsa de Tóquio",
        "asset_type": "acao",
        "currency": "JPY",
        "series_id": null,
        "latest_close": null
      }
    ],
    "page": 1,
    "per_page": 3,
    "has_more": true
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}