Equities

Resolve equities

Check if Aiera has coverage for specific equities based on provided identifiers


GET /equities-v2/resolve

ParameterTypeDataTypeDescription
bloomberg_tickerquerystringResolve equities using 1+ bloomberg tickers (comma-separated)
isinquerystringResolve equities using 1+ ISINs (comma-separated)
permidquerystringResolve equities using 1+ PermIDs (comma-separated)
ricquerystringResolve equities using 1+ Reuters/Refinitiv RICs (comma-separated)
tickerquerystringResolve equities using 1+ local tickers (comma-separated)

NOTE

  • Only one of the equity identifiers (bloomberg_ticker, isin, permid, ric, or ticker) should be used per request. Using multiple equity identifiers will end up resolving only one of them.

Response

{
  "equities": [
    {
      "equity_id": 1,
      "name": "AMAZON COM INC",
      "common_name": "AMAZON COM INC",
      "local_ticker": "AMZN",
      "mic": "XNAS",
      "bloomberg_ticker": "AMZN:US",
      "isin": "US0231351067",
      "permid": "4295905494",
      "ric": "AMZN.OQ",
      "sector_id": 1,
      "gics_sector": "Consumer Discretionary",
      "subsector_id": 21,
      "gics_sub_sector": "Internet & Direct Marketing Retail",
      "primary_equity": true
    },
    {
      "equity_id": 2,
      "name": "Alphabet Inc.",
      "common_name": "Alphabet Inc.",
      "local_ticker": "GOOGL",
      "mic": "XNAS",
      "bloomberg_ticker": "GOOGL:US",
      "isin": "US02079K3059",
      "permid": "5030853586",
      "ric": "GOOGL.OQ",
      "sector_id": 2,
      "gics_sector": "Communication Services",
      "subsector_id": 36,
      "gics_sub_sector": "Interactive Media & Services",
      "primary_equity": true
    }
  ],
  "total": 2,
  "failed": {
    "isin": ["US0123456789"]
  },
  "total_failed": 1,
  "params": {
    "bloomberg_ticker": null,
    "isin": "US0231351067,US02079K3059,US0123456789",
    "permid": null,
    "ric": null,
    "ticker": null
  }
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/equities-v2/resolve?isin=US0231351067,US02079K3059,US30303M1027' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request(
    "GET",
    "https://premium.aiera.com/api/equities-v2/resolve?isin=US0231351067,US02079K3059,US30303M1027",
    headers={"X-API-Key": "xxx"},
)
Previous
Get Equity