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
Companies

List sectors

GEThttps://api.q4.sa/v1/sectors
Lists the Tadawul sectors with how many companies are in each.
Free

Authorization

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

Response

dataobject[]
The result.
slugstring
name_enstring
Name in English.
name_arstring
Name in Arabic.
companiesinteger

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
Retrieve a company
Next →
Retrieve a quote
Request
curl "https://api.q4.sa/v1/sectors" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "slug": "banks",
      "name_en": "Banks",
      "name_ar": "البنوك",
      "companies": 10
    },
    {
      "slug": "energy",
      "name_en": "Energy",
      "name_ar": "الطاقة",
      "companies": 8
    },
    {
      "slug": "materials",
      "name_en": "Materials",
      "name_ar": "المواد الأساسية",
      "companies": 48
    }
  ]
}