Find equities

Fetch equities, optionally with events, and narrowed down by search term or supported equity identifiers

GET /equities-v2

searchquerystringReturns equities with names matching the search term
eventsquerybooleanWhether to include events
bloomberg_tickerquerystringFilter equities to 1+ bloomberg tickers (comma-separated)
isinquerystringFilter equities to 1+ ISINs (comma-separated)
ricquerystringFilter equities to 1+ Reuters/Refinitiv RICs (comma-separated)
permidquerystringFilter equities to 1+ PermIDs (comma-separated)
sector_idquerystringFilter equities to a specific sector
subsector_idquerystringFilter equities to a specific subsector
tickerquerystringFilter equities to 1+ tickers (comma-separated)
pagequeryintegerThe page of results to return
page_sizequeryintegerThe size of pages to return (default: 100, max: 2500)


  • 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.


  "params": {
    "page": 1,
    "sector_id": 1
  "pagination": {
    "total_count": 1461,
    "current_page": 1,
    "total_pages": 15,
    "page_size": 100
  "data": [
      "equity_id": 1,
      "name": "AMAZON COM INC",
      "common_name": "Amazon Inc.",
      "local_ticker": "AMZN",
      "bloomberg_ticker": "AMZN:US",
      "ric": "AMZN.OQ",
      "permid": "4295905494",
      "isin": "US0231351067",
      "sector_id": 1,
      "gics_sector": "Consumer Discretionary",
      "subsector_id": 21,
      "gics_sub_sector": "Internet & Direct Marketing Retail",
      "primary_equity": true,
      "created": "2023-02-09T01:29:13",
      "modified": "2024-06-11T10:15:51"

Code Samples


curl --request GET \
  --url 'https://premium.aiera.com/api/equities-v2' \
  --header 'X-API-Key: xxx'


import requests
requests.request("GET", "https://premium.aiera.com/api/equities-v2", headers={"X-API-Key": "xxx"})
Get Sectors