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

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 with trading data and changes

GET /api/v1/quote/{symbol}/

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")
More examples on GitHub

Choose the right plan

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

* Prices exclude 15% VAT

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
  • Price alerts (Webhooks)

Starter

For developers and small projects

149/month
5K req/day
  • All Free plan features
  • Bulk quotes
  • Historical OHLCV data
  • Full financial statements
  • Dividends
  • Full company fundamentals
  • Technical indicators
  • Realtime prices
  • Price alerts (Webhooks)
Most popular

Pro

For growing apps and advanced products

499/month
50K req/day
  • All previous plan features
  • Realtime prices
  • WebSocket streaming
  • Technical indicators (RSI, MACD)
  • Fair value (proprietary)
  • Analyst consensus
  • Stock events (AI)
  • Realtime price alerts (up to 10)
  • Webhook notifications (up to 3 URLs)

Enterprise

For companies and financial platforms

Custom
  • All Pro features
  • Custom limits (API / Webhooks / Alerts)
  • Dedicated infrastructure (optional)
  • Service level agreement (SLA)
  • Priority support

Enterprise options

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