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

Retrieve a quote

GEThttps://api.q4.sa/v1/quote/{symbol}
Returns the latest price, change, volume and best bid and ask for one stock.
FreeFree and Starter get prices delayed by 15 minutes. Realtime needs Pro+.

Authorization

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

Path parameters

symbolstringrequired
Tadawul symbol, e.g. 2222 for Saudi Aramco. ISINs are accepted too.

Query parameters

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.
name_enstring
Name in English.
pricenumber
Last traded price, SAR.
changenumber
Change from the previous close, SAR.
change_percentnumber
Change from the previous close, percent.
opennumber
Opening price.
highnumber
Highest price.
lownumber
Lowest price.
previous_closenumber
Previous session’s closing price.
volumeinteger
Shares traded.
turnovernumber
Value traded, SAR.
tradesinteger
Number of trades.
bidnumber
Best bid price.
bid_sizeinteger
Shares at the best bid.
asknumber
Best ask price.
ask_sizeinteger
Shares at the best ask.
week_52_highnumber
Highest close in the last 52 weeks.
week_52_lownumber
Lowest close in the last 52 weeks.
sessionstring
Market session: pre_open, open, closing_auction or closed.
is_delayedboolean
True when the price is 15 minutes delayed.
updated_atdatetime
When this record last changed.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List sectors
Next →
List quotes
Request
curl "https://api.q4.sa/v1/quote/2222" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "symbol": "2222",
    "name_en": "Saudi Arabian Oil Co.",
    "price": 25.42,
    "change": 0.18,
    "change_percent": 0.71,
    "open": 25.24,
    "high": 25.5,
    "low": 25.2,
    "previous_close": 25.24,
    "volume": 14382911,
    "turnover": 365104220.6,
    "trades": 21874,
    "bid": 25.4,
    "bid_size": 182400,
    "ask": 25.42,
    "ask_size": 96310,
    "week_52_high": 28.95,
    "week_52_low": 23.1,
    "session": "open",
    "is_delayed": true,
    "updated_at": "2026-11-04T10:42:13Z"
  }
}