API reference
API reference
Every endpoint under
https://api.q4.sa/v1. Send your key in the x-api-key header.Companies
Every company listed on the Saudi Exchange main market and Nomu, with profiles and sectors.
Market data
Quotes, price history, indices, market breadth, trades and order book depth.
GET
/quote/{symbol}
Retrieve a quote
Free
GET/quotes
List quotes
Starter+
GET/prices/{symbol}/history
Retrieve price history
Starter+
GET/indices/{index}/history
Retrieve index history
Starter+
GET/market/summary
Retrieve market summary
Free
GET/market/movers
List market movers
Free
GET/market/sectors
List sector performance
Free
GET/market/trades/{symbol}
List trades
Business+
GET/market/depth/{symbol}
Retrieve order book depth
Business+
WebSocket
Realtime quotes, trades and depth pushed over a WebSocket connection.
Fundamentals
Financial statements, every printed figure with its page, ratios, dividends, corporate actions and stock events.
GET
/companies/{symbol}/financials
Retrieve standardised statements
Starter+
GET/companies/{symbol}/financials/as-reported
Retrieve as-reported statements
Starter+
GET/companies/{symbol}/facts
List figures
Starter+
GET/companies/{symbol}/ratios
Retrieve ratios
Starter+
GET/compare
Compare companies
Starter+
GET/companies/{symbol}/dividends
List dividends
Starter+
GET/companies/{symbol}/corporate-actions
List corporate actions
Starter+
GET/events
List stock events
Pro+
GET/companies/{symbol}/notes
Search notes
Starter+
Documents
Financial reports, board reports, presentations and prospectuses, with page text and summaries.
GET
/documents
List documents
Free
GET/documents/{id}
Retrieve a document
Free
GET/documents/{id}/pages
List document pages
Starter+
GET/documents/{id}/text
Retrieve document text
Starter+
GET/documents/{id}/summary
Retrieve document summary
Starter+
GET/documents/{id}/notes
List notes
Starter+
GET/documents/{id}/notes/{number}
Retrieve a note
Starter+
GET/documents/{id}/sections
List sections
Starter+
GET/documents/{id}/sections/{section_id}
Retrieve a section
Starter+
GET/companies/{symbol}/sections
Search board report sections
Starter+
Earnings calls
Earnings call recordings with word-timed transcripts.
Announcements
Issuer announcements published on Tadawul.
Economic data
Saudi government statistics from GASTAT, SAMA and Tadawul.
Webhooks & alerts
Register endpoints for push notifications and price alert rules.
Account
Your plan and remaining quota.