Q4API Docs
Q4 APISign inGet API key
DocumentationAPI Reference
Overview
IntroductionQuickstartData overviewPlans and limits
Datasets
CompaniesMarket dataRealtime & streamingFundamentalsDividends & corporate actionsFilings & reportsBoard reportsPresentationsEarnings callsAnnouncementsEconomic data
REST API
AuthenticationPagination and filteringRate limitsErrors
WebSocket
ConnectingStreamsWebSocket errors
Webhooks
WebhooksWebhook eventsSignatures
MCP
Q4 MCP connector
More
ChangelogSupport
Datasets

Market data

Quotes, adjusted OHLCV history, indices and market breadth for Tadawul.
1.1M+
Daily price bars
15 min
Delay on Free and Starter
Adjusted
For splits and rights issues
Available from Free

Prices come from the Saudi Exchange. Daily bars are adjusted for splits, bonus shares and rights issues, so returns are comparable across corporate actions. Pass adjusted=false for the prices as traded.

Delayed and realtime

Free and Starter plans get quotes delayed by 15 minutes, and every response says so in is_delayed. Pro and above get realtime quotes over REST and the WebSocket.

Intervals

IntervalPlanHistory
1d, 1w, 1moStarter+Since listing
1min to 60minPro90 days
5min to 60minBusiness2 years

Trading sessions

Tadawul trades Sunday to Thursday, 10:00 to 15:00 Riyadh time, with a closing auction to 15:10. Bars use Riyadh trading dates.

Endpoints

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
← Previous
Companies
Next →
Realtime & streaming
On this page
Delayed and realtimeIntervalsTrading sessionsEndpoints