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 market summary

GEThttps://api.q4.sa/v1/market/summary
Returns the index level, breadth and totals for the session.
Free

Authorization

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

Query parameters

indexstring
Market: the main market (TASI) or the parallel market (Nomu).
One of:TASINOMU
Default: TASI
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.
indexstring
Index code.
valuenumber
Value.
changenumber
Change from the previous close, SAR.
change_percentnumber
Change from the previous close, percent.
volumeinteger
Shares traded.
turnoverinteger
Value traded, SAR.
tradesinteger
Number of trades.
advancinginteger
Stocks up on the day.
declininginteger
Stocks down on the day.
unchangedinteger
Stocks flat on the day.
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
Retrieve index history
Next →
List market movers
Request
curl "https://api.q4.sa/v1/market/summary?index=TASI" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": {
    "index": "TASI",
    "value": 11903.8,
    "change": 61.2,
    "change_percent": 0.52,
    "volume": 268430112,
    "turnover": 6702118400,
    "trades": 512870,
    "advancing": 142,
    "declining": 81,
    "unchanged": 23,
    "session": "closed",
    "is_delayed": true,
    "updated_at": "2026-11-03T12:20:00Z"
  }
}