Overview
Introduction
Saudi market data, financials, filings and earnings calls through one API.
The Q4 API gives you the data behind Q4: prices and fundamentals for every company listed on the Saudi Exchange, the filings they come from, earnings call transcripts, announcements and government statistics.
What makes it different is the source. Every financial figure points to the document, page and position it was printed on, so you can show your users exactly where a number came from.
Ways to integrate
REST API
JSON over HTTPS. Pull companies, prices, figures and filings on demand.
WebSocket
Live quotes, trades and depth pushed as they change.
Webhooks
An HTTP request when a filing, announcement or transcript lands.
MCP
Give Claude and other assistants cited access to Q4 data.
Available datasets
Companies
FreeEvery Saudi listed company, with Arabic and English names, sectors and share counts.
Market data
FreeQuotes, adjusted OHLCV history, indices and market breadth for Tadawul.
Realtime & streaming
Pro+Live quotes, every trade and the order book, over REST or WebSocket.
Fundamentals
Starter+Statements standardised or as reported, every footnote, and 5.1M+ figures traced to their page.
Dividends & corporate actions
Starter+Cash dividends, bonus shares, rights issues, buybacks and stock events.
Filings & reports
FreeFinancial reports, board reports and prospectuses, with page text, notes and summaries.
Board reports
Starter+The board of directors’ annual report, split into chapters: governance, pay, related parties, risks.
Presentations
FreeInvestor and earnings decks, page by page.
Earnings calls
Pro+Recordings and word-timed transcripts, split by speaker and section.
Announcements
Starter+Every issuer announcement on Tadawul, full text, searchable.
Economic data
Business+GASTAT, SAMA and Tadawul statistics as clean time series.
Get started
- Sign up and create an API key.
- Make your first request with the Quickstart.
- Browse the API reference.