Q4API Docs
Q4 APISign inGet API key
DocumentationAPI Reference
Overview
API reference
Companies
GETList companiesGETRetrieve a companyGETList sectors
Market data
GETRetrieve a quoteGETList quotesGETRetrieve price historyGETRetrieve index historyGETRetrieve market summaryGETList market moversGETList sector performanceGETList tradesGETRetrieve order book depth
WebSocket
WSQuotes streamWSTrades streamWSDepth stream
Fundamentals
GETRetrieve standardised statementsGETRetrieve as-reported statementsGETList figuresGETRetrieve ratiosGETCompare companiesGETList dividendsGETList corporate actionsGETList stock eventsGETSearch notes
Documents
GETList documentsGETRetrieve a documentGETList document pagesGETRetrieve document textGETRetrieve document summaryGETList notesGETRetrieve a noteGETList sectionsGETRetrieve a sectionGETSearch board report sections
Earnings calls
GETList earnings callsGETRetrieve an earnings callGETRetrieve a transcriptGETRetrieve call audio
Announcements
GETList announcementsGETRetrieve an announcement
Economic data
GETList seriesGETList observations
Webhooks & alerts
POSTCreate a webhookGETList webhooksDELDelete a webhookPOSTCreate an alert ruleGETList alert rulesDELDelete an alert rule
Account
GETRetrieve usage
Market data

List quotes

GEThttps://api.q4.sa/v1/quotes
Returns quotes for up to 50 stocks in one call.
Starter+Realtime needs Pro+.

Authorization

x-api-keyheaderrequired
Your API key. See Authentication.

Query parameters

symbolsstring (comma-separated)required
Comma-separated Tadawul symbols, up to 50.
data_modestring
Realtime needs Pro+. Defaults to the freshest data your plan allows: realtime on Pro+, 15-minute delayed below.
One of:realtimedelayed

Response

dataobject[]
The result.
symbolstring
Tadawul symbol.
pricenumber
Last traded price, SAR.
changenumber
Change from the previous close, SAR.
change_percentnumber
Change from the previous close, percent.
volumeinteger
Shares traded.
is_delayedboolean
True when the price is 15 minutes delayed.
updated_atdatetime
When this record last changed.
missingarray
Requested symbols that did not match a listed company.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Retrieve a quote
Next →
Retrieve price history
Request
curl "https://api.q4.sa/v1/quotes?symbols=2222,1120,2010" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "symbol": "2222",
      "price": 25.42,
      "change": 0.18,
      "change_percent": 0.71,
      "volume": 14382911,
      "is_delayed": true,
      "updated_at": "2026-11-04T10:42:13Z"
    },
    {
      "symbol": "1120",
      "price": 95.3,
      "change": -0.6,
      "change_percent": -0.63,
      "volume": 3104552,
      "is_delayed": true,
      "updated_at": "2026-11-04T10:42:11Z"
    },
    {
      "symbol": "2010",
      "price": 58.1,
      "change": 0.4,
      "change_percent": 0.69,
      "volume": 1877204,
      "is_delayed": true,
      "updated_at": "2026-11-04T10:42:09Z"
    }
  ],
  "missing": []
}