Get equity

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

GET /equities/{equity_id}

Response

{
	"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",
	"mic": "XNAS",
	"gics_sector": "Consumer Discretionary",
	"gics_sub_sector": "Internet & Direct Marketing Retail",,
    "primary_equity": true,
	"events": [
		{
			"event_id": "1672061",
			"title": "Q4 2016 Amazon.com Inc Earnings Call",
			"date": "2017-02-02T17:30:00",
			"event_type": "earnings"
		},
		{
			"event_id": "1672070",
			"title": "Casino Guichard Perrachon SA, Amazon and Monoprix Join Forces to innovate on behalf of Prime Now Customers Call",
			"date": "2018-03-27T06:59:00",
			"event_type": "special_situation"
		}
	],
	"linguistics": {
		"topics": [
			{
				"topic_id": 2544,
				"topic": "AWS",
				"priority": 1,
				"events": [
					{
						"event_id": 2270838,
						"title": "Q3 2022 Amazon.com Inc Earnings Call",
						"date": "2022-10-27T17:30:00",
						"event_type": "earnings"
					},
					{
						"event_id": 1309435,
						"title": "Goldman Sachs Technology & Internet Conference",
						"date": "2020-02-12T15:30:00",
						"event_type": "presentation"
					}
				]
			},
			{
				"topic_id": 1995,
				"topic": "Advertising",
				"priority": 2,
				"events": [
					{
						"event_id": 5221,
						"title": "Q1 2019 Earnings Call",
						"date": "2019-04-25T17:30:00",
						"event_type": "earnings"
					},
					{
						"event_id": 1672070,
						"title": "Casino Guichard Perrachon SA, Amazon and Monoprix Join Forces to innovate on behalf of Prime Now Customers Call",
						"date": "2018-03-27T06:59:00",
						"event_type": "special_situation"
					}
				]
			}
		]
	},
	"statistics": {
		"event_count": 32,
		"news_count": 68625,
		"filing_count": 363
	}
}

Code Samples

Bash

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

Python

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