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

For teams and commercial applications

For launch-ready and commercial use applications

Business

For active commercial products and financial platforms

1,499/month
150K req/day
  • 150K requests/day
  • Up to 30 API keys
  • Realtime WebSocket
  • Advanced tools and analytics
  • Company comparison (up to 20 symbols)
  • Higher Webhook & Event Limits

Enterprise

For companies and financial platforms with tailored solutions

Custom
  • Custom limits
  • Custom agreements
  • Advanced operational or redistribution requirements

We tailor the best setup based on your usage

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