Market Index APImarketindex.com.au ↗
Access ASX company listings, stock overviews, dividends, director transactions, sector performance, and announcements via the Market Index API.
What is the Market Index API?
The Market Index API covers 12 endpoints that expose ASX market data including live stock overviews, sector performance, dividend yields, director/insider transactions, and company announcements. The get_stock_overview endpoint alone returns over a dozen fields per ticker — price, market cap, EPS, debt-to-equity, GICS classification, and more — while get_director_transactions surfaces the 200 most recent buy, sell, and issued transactions across all listed companies.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/8c2e4aa9-de26-46ca-9ef5-bda5e5a5d33d/get_asx_companies_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace marketindex-com-au-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Market Index ASX API — bounded, re-runnable; every call capped."""
from parse_apis.market_index_asx_api import MarketIndex, Code, Query, NotFound
client = MarketIndex()
# Search for mining stocks — limit caps total items fetched.
for stock in client.stocks.search(query=Query.MINING, limit=3):
print(stock.code, stock.title, stock.status)
# Get detailed overview for one stock, then drill into its announcements.
bhp = client.stocks.get(code=Code.BHP)
print(bhp.title, bhp.last, bhp.market_cap, bhp.sector)
for ann in bhp.announcements.list(limit=3):
print(ann.heading, ann.date_time, ann.is_price_sensitive)
# Check market indices for the current session.
for idx in client.indexes.list(limit=3):
print(idx.desc.name, idx.quote.price, idx.quote.pct_change)
# View upcoming dividends — each carries its parent company as a typed resource.
div = client.dividends.upcoming(limit=1).first()
if div:
print(div.company.title, div.dps, div.frank_percent, div.days_till_payment)
# Typed error handling: catch NotFound on an invalid code.
try:
client.stocks.get(code="ZZZZZ")
except NotFound as exc:
print(f"not found: {exc}")
print("exercised: stocks.search / stocks.get / announcements.list / indexes.list / dividends.upcoming")
Retrieve the full list of all ASX-listed companies. Returns every company with its stock code, name, security type, and trading status. The list is not paginated — the entire directory is returned in a single response.
No input parameters required.
{
"type": "object",
"fields": {
"companies": "array of company objects each containing code, title, type, and status"
},
"sample": {
"data": {
"companies": [
{
"code": "BHP",
"type": "01",
"title": "BHP Group Ltd",
"status": "OPEN"
},
{
"code": "CBA",
"type": "01",
"title": "Commonwealth Bank of Australia",
"status": "OPEN"
}
]
},
"status": "success"
}
}About the Market Index API
Stock and Market Data
The get_stock_overview endpoint accepts a single code parameter (e.g. BHP, CBA) and returns a broad set of fundamentals: last price, change, change_percent, volume, market_cap in AUD, and a fundamentals object covering EPS, book value, debt-to-equity, and share count. The company_sector field provides GICS classification details. get_market_overview returns live quotes and historical averages for key indices including the ASX 200, All Ords, Resources, Small Ords, and Industrials, plus an all_indices array with the full index set.
Dividends and Yield Screening
get_upcoming_dividends lists upcoming ASX dividend payments ordered by ex-date, with per-record fields for dps (dividend per share), frank_percent, ex_date, dividend_payable_date, yield, and days_till_payment. For yield-based screening, get_highest_dividend_yield ranks stocks by yield and also exposes gross (gross yield), annualChange, drp (dividend reinvestment plan status), and frankingAverage.
Director Transactions and Announcements
get_director_transactions returns the 200 most recent insider transactions with transaction_type (buy, sell, issued), quantity, price, value, director_name, stock_code, and date. Individual director profiles are available via get_director_profile using a hyphenated name slug. For announcements, get_stock_announcements returns up to 50 items for a single ticker with heading, date, type, and sensitivity flag, while get_asx_announcements covers all companies and accepts limit and offset for pagination.
Sectors, News, and Search
get_asx_sectors returns performance data for all 11 GICS sectors, each with a quote object (price, change, pctChange) and an averages object covering week, month, year, and YTD periods. get_market_news returns articles with title, published date, category, related stocks array, and content type. search_stocks does a case-insensitive match against codes and names, returning up to 50 results with code, title, type, and status.
The Market Index API is a managed, monitored endpoint for marketindex.com.au — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when marketindex.com.au changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official marketindex.com.au API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen ASX stocks by highest dividend yield using
gross,frankingAverage, anddrpfields fromget_highest_dividend_yield - Monitor insider activity by polling
get_director_transactionsfor recent buy or sell events with price and value data - Build a sector rotation dashboard using weekly, monthly, and YTD performance from
get_asx_sectors - Alert on company announcements by checking
get_stock_announcementsfor a watchlist of ASX tickers - Populate a stock screener with EPS, book value, debt-to-equity, and market cap from
get_stock_overview - Track upcoming ex-dividend dates and payable dates using
get_upcoming_dividendsordered byex_date - Search for companies by partial name or sector keyword via
search_stocksand resolve full details throughget_stock_overview
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Market Index have an official developer API?+
What does `get_director_transactions` return, and how many records does it cover?+
stock_code, company_name, director_name, transaction_type (buy, sell, or issued), quantity, price, value, and date. There are no filter parameters — it always returns the latest 200.Does the API cover historical price data or intraday OHLCV candles?+
Can I paginate through all ASX announcements?+
get_asx_announcements supports limit and offset parameters for pagination across all companies. get_stock_announcements is per-ticker and returns up to 50 announcements without offset support.Does the API include options, warrants, or futures data for ASX instruments?+
type and status fields. Derivatives such as options, warrants, and futures are not covered. You can fork this API on Parse and revise it to add those instrument types if they appear on Market Index.