Get equity

Fetch a specific equity, optionally with events, linguistics, and statistics

GET /equities-v2/{equity_id}

Request

https://premium.aiera.com/api/equities-v2/1?include_company_metadata=true

Response

{
  "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",
  "gics_sector": "Consumer Discretionary",
  "gics_sub_sector": "Broadline Retail",
  "primary_equity": true,
  "created": "2017-06-01T00:00:00",
  "modified": "2024-11-11T14:02:12",
  "status": "active",
  "company_metadata": {
    "company_id": 1,
    "common_name": "Amazon",
    "legal_name": "Amazon.com Inc",
    "incorporated_country_code": "US",
    "domiciled_country_code": "US",
    "urls": [
      {
        "url": "https://s3.amazonaws.com/assets.aiera.com/assets/manual-override-1-1723048553.9238625.png",
        "url_type": "logo_icon"
      },
      {
        "url": "https://ir.aboutamazon.com/overview/default.aspx",
        "url_type": "ir_home"
      },
      {
        "url": "https://ir.aboutamazon.com/events/default.aspx",
        "url_type": "ir_events"
      },
      {
        "url": "https://press.aboutamazon.com/press-release-archive",
        "url_type": "ir_news"
      },
      {
        "url": "https://www.amazon.com/",
        "url_type": "home"
      },
      {
        "url": "https://ir.aboutamazon.com/sec-filings/default.aspx",
        "url_type": "filings"
      },
      {
        "url": "https://www.youtube.com/user/amazon",
        "url_type": "youtube"
      }
    ]
  }
}

Code Samples

Bash

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

Python

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