The ASX 200 API for Retail Investors, Traders & AI Agents

Why This Is The Best ASX API

Built from the ground up for three audiences: retail investors who want clean data without paying Bloomberg prices, algorithmic traders who need consistent schemas for backtests, and AI agents that consume structured JSON and markdown.

Coverage at a Glance

The S&P/ASX 200 tracks the 200 largest Australian-listed companies by float-adjusted market capitalisation — covering roughly 82% of Australia's equity market. This API exposes all of them.

What's in a Company Profile

GET /api/v1/companies/{ticker} returns a single JSON document with identity, classification, narrative profile, data-quality signals, and a presigned download URL for the full markdown profile (~1-2 KB, covering Overview, Business Description, History, Recent Developments, Leadership, Key Facts, and Sources).

Data Sources & Normalisation

Where does the data come from, and how is it reconciled? We pull from several authoritative sources, then normalise everything into one consistent schema so that comparing BHP to CBA is apples-to-apples.

• Company filings — original ASX announcements and filings for all 200 ASX 200 members, plus SEC filings for dual-listed companies like BHP and RIO.
• Market data — authoritative vendor feeds for end-of-day prices, market capitalisation, shares outstanding, and EPS. (Prices are end-of-day, not real-time.)
• Annual reports — collected from official investor-relations pages and ASX announcement archives, stored as PDF plus markitdown-converted markdown.
• News & announcements — press releases from company newsrooms and ASX market announcements, with dates, categories, and direct links.
• Normalisation layer — we reconcile reporting currencies (AUD native, USD on request via conversion), align periods (full-year FY vs half-year H1 / H2), and compute 13 ratios identically across all 200 companies so cross-company screening is consistent.
• Source traceability — every financial row carries a primary_source field. You always know where a given number came from.

Financial Statements & Ratios

Historical financial statements are available per fiscal year end (most ASX companies end 30 June) plus semi-annual half-year (H1/H2) periods. Reported in each company's native currency — typically AUD, but global miners like BHP, Rio Tinto, and biotech CSL report in USD.

Statement fields (per period)

• Income: revenue, cost_of_revenue, gross_profit, operating_income, net_income
• Balance sheet: total_assets, total_equity, cash_and_equivalents, long_term_debt, shares_outstanding
• Cash flow: operating_cash_flow, capital_expenditures, free_cash_flow, dividends_paid
• Per-share: eps_basic, eps_diluted
• Metadata: period_end, period_type (FY/H1/H2), fiscal_year, currency, primary_source

Computed ratios (/metrics/summary)

• Valuation: pe_ratio, pb_ratio, ps_ratio
• Profitability: gross_margin, operating_margin, net_margin, roe, roa
• Per share: eps_basic, eps_diluted
• Leverage & liquidity: debt_to_equity, current_ratio

Example: BHP metrics (FY2025, year ended 30 June 2025)

Annual Reports & Half-Year Reports

For 94 of the 200 ASX 200 companies, we archive the original PDF annual and half-year reports alongside a markitdown-converted markdown version. The markdown is ideal for LLM context windows — BHP's 2024 annual report, for instance, compresses from a 16 MB PDF to a 470 KB clean-text markdown file.

Reports are available via GET /api/v1/companies/{ticker}/filings?source=asx, which returns presigned download URLs (1-hour expiry) for both the original PDF and the markdown.

Report coverage by type

Example: BHP Filings

# GET /api/v1/companies/BHP/filings?source=asx&limit=3
{
  "ticker": "BHP",
  "total": 12,
  "filings": [
    {
      "filing_date":   "2025-08-19",
      "form_type":     "annual",
      "description":   "BHP Annual Report 2025",
      "document_url":  "https://.../250819_bhpannualreport2025.pdf?<signature>",
      "markdown_url":  "https://.../250819_bhpannualreport2025.md?<signature>",
      "source":        "asx"
    },
    ...
  ]
}

API Endpoints Reference

All endpoints require an X-API-Key header.

Quickstart

1. Get a free API key

# curl
curl -X POST https://stockmarketapi.ai/api/v1/auth/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","tier":"free"}'

2. Fetch a full company profile

# Python
import httpx

headers = {"X-API-Key": "smk_live_..."}
base    = "https://stockmarketapi.ai/api/v1"

# Full profile (identity + narrative + presigned markdown URL)
c = httpx.get(f"{base}/companies/BHP", headers=headers).json()
print(c["long_name"], "—", c["industry"])
print(c["description"])

# Fetch the multi-kB narrative markdown (Overview / History / Recent Developments / ...)
profile_md = httpx.get(c["profile_markdown_url"]).text

# Computed ratios
m = httpx.get(f"{base}/companies/BHP/metrics/summary", headers=headers).json()
print(f"P/E: {m['pe_ratio']}  ROE: {m['roe']}")

# Latest annual report as markdown (ideal for LLM context)
filings = httpx.get(f"{base}/companies/BHP/filings?source=asx&limit=1", headers=headers).json()
latest_report_md = httpx.get(filings["filings"][0]["markdown_url"]).text

# Recent news and ASX announcements
news = httpx.get(f"{base}/companies/BHP/news?limit=10", headers=headers).json()
for a in news["articles"]:
    print(a["published_date"], a["title"])

3. Screen a universe

# All ASX 200 Financials-sector companies
asx_fin = httpx.get(f"{base}/indices/ASX200?sector=Financials", headers=headers).json()
for m in asx_fin["members"]:
    print(m["ticker"], m["name"])

All 200 ASX 200 Companies

Every S&P/ASX 200 member covered by the API. Profile indicates a full rich profile is available (description populated). Reports is the count of archived annual / half-year reports for that ticker. Quality % is the percentage of 8 core profile fields (description, long_name, website, employees, market_cap, industry, HQ city, HQ state) that are populated, rounded to the nearest 5%.

Raw JSON: GET /api/v1/indices/ASX200 · Bulk lookup (up to 25 tickers): GET /api/v1/companies/bulk?tickers=BHP,CBA,CSL

Payment Options

FAQ