Companies

GEThttps://whv3io2lif.execute-api.eu-north-1.amazonaws.com/default/eql-api-test

Single endpoint — returns the full company profile in one call. Identify the company by isin, ticker, or both. The response includes the company object and the complete financial_documents array ordered newest-first.

Query parameters

api_keystringRequiredYour EQL API key.

isinstringConditionalISO 6166 ISIN (12 chars). Required if ticker is not supplied.

tickerstringConditionalStock ticker symbol. Required if isin is not supplied.

Search modes

Supply isin, ticker, or both. Supplying both is recommended — some tickers map to multiple companies across exchanges, and the ISIN guarantees a unique match.

HTTP (by ISIN)

https://whv3io2lif.execute-api.eu-north-1.amazonaws.com/default/eql-api-test?api_key=YOUR_KEY&isin=KYG4672N1198

HTTP (by ticker)

https://whv3io2lif.execute-api.eu-north-1.amazonaws.com/default/eql-api-test?api_key=YOUR_KEY&ticker=HCM

HTTP (recommended)

https://whv3io2lif.execute-api.eu-north-1.amazonaws.com/default/eql-api-test?api_key=YOUR_KEY&ticker=HCM&isin=KYG4672N1198

Quickstart

Python

import requests

BASE = "https://whv3io2lif.execute-api.eu-north-1.amazonaws.com/default/eql-api-test"
r = requests.get(BASE, params={
    "api_key": "YOUR_KEY",
    "ticker": "HCM",
    "isin": "KYG4672N1198",
})
data = r.json()

# financial_documents[0] is always the most recent period
latest = data["financial_documents"][0]
a = latest.get("actual") or {}
e = latest.get("estimate") or {}

print(f"{data['company_name']} {latest['doc_type']} Q{latest.get('quarter','')} {latest['year']}")
print(f"  Actual revenue  : {a.get('net_sales', 'N/A')}")
print(f"  Actual EBITDA   : {a.get('ebitda', 'N/A')}")
print(f"  Estimate revenue: {e.get('revenue', 'N/A')}")
print(f"  Estimate EPS    : {e.get('eps', 'N/A')}")

Company object

JSON

{
  "company_name": "HUTCHMED (China) Limited",
  "stock_name": "HUTCHMED China",
  "tickers": ["HCM", "13.HK"],
  "isins": ["KYG4672N1198"],
  "region": "asia",
  "country": "hong-kong",
  "sector": "Healthcare",
  "weburl": "https://www.hutchmed.com",
  "financial_documents": [ ... ]
}

The API automatically filters its data feed: documents missing valid financial metrics or AI analysis are excluded where possible. Documents containing only forward-looking estimate data are still returned so that estimate-only periods are visible in the timeline.