SAHMK
Developers API

API Pricing

Flexible plans for every stage. Start free and upgrade as you grow.

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

Frequently asked questions

What is the difference between real-time and delayed prices?

Delayed prices mean data is 15 minutes behind the live market. Real-time prices mean direct market data with no delay.

What happens if I exceed my daily limit?

You will receive a 429 (Too Many Requests) response. The daily limit resets automatically at midnight Saudi time.

Can I upgrade or downgrade my plan?

Yes.
  • Upgrading to a higher plan takes effect immediately.
  • Switching from monthly to yearly for the same plan starts automatically after the current cycle ends.
  • Switching from monthly to yearly for a higher plan takes effect immediately.
  • Downgrading to a lower plan becomes available at the end of the current subscription.

Is there a trial period?

The Free plan is always available and includes 100 requests/day for testing and development, with no commitment.

Which payment methods are supported?

We accept credit cards (Visa and Mastercard), Apple Pay, and STC Pay through the secure Moyasar gateway.

How do I connect to SAHMK API from Python?

Install the SAHMK package with pip install -U sahmk, set your API key, then call client.quote("2222") to fetch a stock quote. You can use a company identifier (symbol, Arabic name, English name, or alias). Quickstart guide ->

Do you provide a CLI tool?

Yes, the package also includes a CLI. After installing with pip install -U sahmk you can run: sahmk quote "Saudi Aramco" directly from the command line. CLI guide ->

What is SAHMK MCP and how do I use it with AI tools?

SAHMK MCP is a server that connects AI tools like Claude Desktop and Cursor to direct market data from the Saudi stock market. Install it with pip install -U sahmk-mcp then add the server config inside your client. MCP guide ->

Note: keep the package updated to get the latest tools.

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.

Need an enterprise-grade setup?

Custom limits + dedicated infrastructure options + SLA support

Explore enterprise solutions