SAHMK
Developers API

API for
Saudi Market Data

Saudi stock market data at your fingertips: real-time prices, historical datasets, financial statements, and market indicators.

Real-time & historical data for Tadawul stocks

Code samples on GitHub

Licensed by

Tadawul Saudi Arabia
Terminal

# Request

# identifier supports symbol, Arabic name, English name, or alias
curl -H "X-API-Key: your_key" \
     https://app.sahmk.sa/api/v1/quote/2222/

# Response

{
  "symbol": "2222",
  "name": "أرامكو السعودية",
  "name_en": "Saudi Arabian Oil Co",
  "price": 25.26,
  "change": 0,
  "change_percent": 0,
  "volume": 9169694,
  "is_delayed": false
}

99.9%

Uptime

+20

Endpoints

+350

TASI & Nomu companies

Data products

Comprehensive APIs for your Saudi market data needs

Stock Quotes

Free

Stock prices by company identifier (symbol/name/alias) with trading data and changes

GET /api/v1/quote/{identifier}/

Market Overview

Free

Gainers, losers, and TASI index

GET /api/v1/market/summary/

Historical Data

Starter+

Historical OHLCV data and adjusted prices

GET /api/v1/historical/{symbol}/

Financial Statements

Starter+

Income, balance sheet, and cash flow

GET /api/v1/financials/{symbol}/
View all endpoints|Code samples

Get started in minutes

Simple steps to start using the API

1

Create a free account

Sign up for a developer account in seconds

2

Generate your API key

Create your key from the developer dashboard

3

Start building

Integrate market data into your product

example.pyPython
import requests

API_KEY = "your_api_key"
BASE_URL = "https://app.sahmk.sa/api/v1"

response = requests.get(
    f"{BASE_URL}/quote/2222/",
    headers={"X-API-Key": API_KEY}
)

data = response.json()
print(f"{data['name_en']}: {data['price']} SAR")
# 2222 can be any supported identifier (symbol, Arabic name, English name, or alias).
More examples on GitHub

Choose the right plan

Flexible plans for all needs, from small projects to large enterprises

* Prices exclude 15% VAT

Save up to 20% with the annual plan

Free

Explore API capabilities

0/month
Up to 100 requests/day
  • 15-min delayed prices
  • Market overview
  • Gainers and losers
  • Company fundamentals
  • Limited usage for exploration

Starter

For small projects and historical data

149/month
Up to 5K requests/day
  • All Free plan features
  • Bulk quotes
  • Historical OHLCV data
  • Historical financial data up to 3 years
  • Dividends and company fundamentals
  • For historical and non-real-time data
Most popular

Pro

For active applications and real-time data

499/month
Up to 50K requests/day
  • All Starter features
  • Intraday 60m data: up to 90 days
  • Real-time prices
  • Real-time WebSocket
  • Extended financial data + quarterly statements
  • Advanced indicators, signals, and analysis tools
  • Webhooks & event rules

Business

For commercial products and financial platforms

1,499/month
Up to 150K requests/day
  • All Pro features, plus:
  • Intraday 30m data: up to 6 months
  • Intraday 60m data: up to 1 year
  • Up to 30 API keys
  • Company comparison (up to 20 symbols)
  • Higher webhook & event limits
  • For active teams and commercial products

Enterprise Solutions

Enterprise

For financial institutions and platforms that need custom limits, redistribution, SLA agreements, and custom integrations.

  • Custom limits
  • SLA agreements
  • Large-scale operations and distribution
  • Custom deployment and operations
  • Custom data and integrations
  • Dedicated technical support

Market Data Usage

SAHMK market data may be used within your applications, tools, or products.

Developer plans are intended for development, internal tools, and small-scale applications.

Large-scale public market data platforms, commercial display services, or data redistribution may require an enterprise agreement.

Reselling market data or providing it as a standalone API or data feed is not permitted without a separate agreement with SAHMK.

Ready to build?

Create your free account and start with 100 free requests per day

Start for freeRead docsGitHub