Saudi Stock Exchange API
One API for 376 Saudi listed companies
5.1M+
Usable figures
5,200+
Financial reports
1,300+
Board reports
400+
Prospectuses
1,600+
Presentations
240+
Earnings calls
80,000+
Announcements
220,000+
Government data
1.1M+
Market data
Data products
Eleven datasets, one key
Every product has its own endpoints and docs. Start free with companies, delayed quotes and filings, then add what you need.
Companies
Free
Every Saudi listed company, with Arabic and English names, sectors and share counts.
GEThttps://api.q4.sa/v1/companiesView docs →Market data
Free
Quotes, adjusted OHLCV history, indices and market breadth for Tadawul.
GEThttps://api.q4.sa/v1/quote/{symbol}View docs →Realtime & streaming
Pro+
Live quotes, every trade and the order book, over REST or WebSocket.
WSwss://api.q4.sa/v1/ws/stocksView docs →Fundamentals
Starter+
Statements standardised or as reported, every footnote, and 5.1M+ figures traced to their page.
GEThttps://api.q4.sa/v1/companies/{symbol}/financialsView docs →Dividends & corporate actions
Starter+
Cash dividends, bonus shares, rights issues, buybacks and stock events.
GEThttps://api.q4.sa/v1/companies/{symbol}/dividendsView docs →Filings & reports
Free
Financial reports, board reports and prospectuses, with page text, notes and summaries.
GEThttps://api.q4.sa/v1/documentsView docs →Board reports
Starter+
The board of directors’ annual report, split into chapters: governance, pay, related parties, risks.
GEThttps://api.q4.sa/v1/companies/{symbol}/sections?category=remunerationView docs →Presentations
Free
Investor and earnings decks, page by page.
GEThttps://api.q4.sa/v1/documents?types=presentationView docs →Earnings calls
Pro+
Recordings and word-timed transcripts, split by speaker and section.
GEThttps://api.q4.sa/v1/earnings-calls/{id}/transcriptView docs →Announcements
Starter+
Every issuer announcement on Tadawul, full text, searchable.
GEThttps://api.q4.sa/v1/announcementsView docs →Economic data
Business+
GASTAT, SAMA and Tadawul statistics as clean time series.
GEThttps://api.q4.sa/v1/economic/series/{key}/observationsView docs →Integrate
Pull it, stream it, or get told
Use the REST API for anything on demand, the WebSocket for live prices, webhooks for new filings, and MCP for AI assistants.
Quickstart
First request in a minute
01
Get a key
Sign up free and we email you a key. It starts with q4_live_.
02
Call an endpoint
Send it in the x-api-key header. Every response is JSON.
03
Follow the source
Every figure links to the document and page it was printed on.
curl "https://api.q4.sa/v1/companies/1120/financials?statement=income" \
-H "x-api-key: $Q4_API_KEY"{
"data": {
"symbol": "1120",
"periods": [{
"fiscal_year": 2025,
"items": [{
"metric": "net_income",
"value": 21802000000,
"fact_id": "fct_9Qm2Lx"
}],
"source_document_id": "doc_7Hk2pQ"
}]
}
}Pricing
Plans that grow with you
Prices in SAR per month, excluding VAT. Annual billing saves 20%. Every plan includes the same data quality and sourcing.
Free
SAR
0
/mo
Try the API on real data.
- Company list and profiles
- Quotes delayed by 15 minutes
- Market summary, movers and sectors
- Document lists and metadata
Starter
SAR
99
/mo
Fundamentals and history for research tools.
- Daily, weekly and monthly price history
- Bulk quotes, up to 50 symbols per call
- Financial statements, ratios and sourced figures
- Dividends and corporate actions
- Document text, pages and summaries
- Tadawul announcements
Pro
Popular
SAR
349
/mo
Realtime prices and earnings calls for live products.
- Realtime quotes
- Intraday bars, 90 days of history
- WebSocket streaming, 60 symbols per connection
- Earnings calls, transcripts and audio
- Stock events feed
- Webhooks and alert rules
Business
SAR
999
/mo
Market microstructure and macro data at scale.
- Trade-by-trade feed and order book depth
- Intraday history from 2 years, 5-minute bars and up
- Government and economic data
- Compare up to 20 companies per call
- Bulk export
Enterprise
Custom
Custom limits, SLA and redistribution.
- Custom request limits
- Full-market WebSocket subscription
- Service-level agreement
- Redistribution rights
- Dedicated support
Which companies are covered?
All 376 companies listed on the Saudi Exchange, on the main market (TASI) and Nomu, including suspended and delisted companies for history.
Where do the financial figures come from?
From the filings themselves. We read every financial report published on Tadawul and keep each printed number with its document, page and position, so you can show your users the source.
Do I get standardised data or the statements as the company printed them?
Both. Standardised statements map every company to the same line items so you can compare them. As-reported statements give you every line exactly as printed, in order, with subtotals and the note behind each line. Both trace back to the same page.
Do you cover the notes to the financial statements?
Yes, both halves. Every table in the notes is in the figures endpoint, labelled with its note, and every note’s text comes back paragraph by paragraph with its page, so you can quote an accounting policy or a segment table and cite it.
Are prices realtime?
On Pro and above, yes, over REST and WebSocket. Free and Starter get prices delayed by 15 minutes, and every response says which you got.
Can I show the data in my own product?
Yes, inside your product for your own users. Redistributing raw data, for example reselling it or exposing it through your own API, needs an Enterprise agreement.
What happens if I go over my limit?
Requests return 429 until the quota resets at midnight Riyadh time. We never bill overage without asking. Upgrade any time from your dashboard.
Is there an Arabic version of the data?
Company names, sectors, announcements and summaries come in Arabic and English. Filings are kept in the language they were published in.
Build on the source of Saudi market data
Free to start. No card needed. Upgrade when you're ready to go live.