SAHMK
Developers API

API for
Saudi Market Data

Saudi stock market data at your fingertips: real-time prices, order book depth, 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://api.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

Price, best bid/ask, trading data, and change by symbol or name

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

Market Overview

Free

Market summary: gainers and losers for TASI & Nomu

GET /api/v1/market/summary/

Historical Data

Starter+

Historical OHLCV prices with adjusted prices

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

Financial Statements

Starter+

Income, balance sheet, and cash flow

GET /api/v1/financials/{symbol}/

Market Depth

Pro+Request access

Market depth from 5 to 20 levels via REST and WebSocket

GET /api/v1/market/depth/{symbol}/
WS /ws/v1/market/depth/
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.py
import requests

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

# Get stock quote by identifier
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
  • Historical data and delayed prices
Most popular

Pro

For active applications and real-time data

499/month
Up to 50K requests/day
  • All Starter features
  • Real-time prices
  • Intraday 60m data: up to 90 days
  • Real-time WebSocket including market depth
  • 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.

Manage Realtime AccessDiscuss Enterprise Agreement

Ready to build?

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

Start for freeRead docsGitHub