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 trades

GEThttps://api.q4.sa/v1/market/trades/{symbol}
Returns the latest executed trades for a stock, newest first.
Business+

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

limitinteger
Results per page.
Default: 50 · Range: 1–200

Response

dataobject[]
The result.
trade_idstring
timedatetime
pricenumber
Last traded price, SAR.
quantityinteger
valueinteger
Value.
sidestring
Aggressor side: buy if the trade lifted the ask, sell if it hit the bid.

Errors

400, 401, 403, 404, 429. Every error has the same shape: see Errors.
← Previous
List sector performance
Next →
Retrieve order book depth
Request
curl "https://api.q4.sa/v1/market/trades/2222?limit=2" \
  -H "x-api-key: $Q4_API_KEY"
Response
{
  "data": [
    {
      "trade_id": "T-2026110400021874",
      "time": "2026-11-04T10:42:13.412Z",
      "price": 25.42,
      "quantity": 1200,
      "value": 30504,
      "side": "buy"
    },
    {
      "trade_id": "T-2026110400021873",
      "time": "2026-11-04T10:42:12.980Z",
      "price": 25.4,
      "quantity": 5000,
      "value": 127000,
      "side": "sell"
    }
  ]
}