SAHMK
Developers API

API for
Saudi Market Data

Saudi stock market data at your fingertips: realtime 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
100 req/day
  • 15-min delayed prices
  • Market overview
  • Gainers and losers
  • Company fundamentals
  • Bulk quotes
  • Historical data
  • Financial statements
  • Dividends
  • Webhooks & Event Rules

Starter

For developers and small projects

149/month
5K req/day
  • All Free plan features
  • Bulk quotes
  • Historical OHLCV data
  • Historical financials (up to 3 years)
  • Dividends
  • Advanced company fundamentals
  • Technical indicators
  • Realtime prices
  • Webhooks & Event Rules
Most popular

Pro

For growing apps and advanced products

499/month
50K req/day
  • All previous plan features
  • Realtime prices
  • WebSocket streaming
  • Extended financials + quarterly history
  • Advanced indicators + signals
  • Fair value (proprietary)
  • Analyst consensus
  • Stock events (AI)
  • Webhooks & Event Rules

Business

For active commercial products and financial platforms

1,499/month
150K req/day
  • All previous plan features
  • Up to 30 API keys
  • Realtime WebSocket
  • Ready for commercial launch and financial applications
  • Company comparison (up to 20 symbols)
  • Higher Webhook & Event Limits
  • Built 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