Saudi Market Data API

The only structured fundamental data API for Tadawul and Nomu. 394 companies. XBRL-sourced. Nightly updated. Used by fintech teams and quant analysts building Saudi market intelligence.

Bloomberg Terminal: $2,000+/month. Sahm Screener API: $199/month.

See it in action

curl -X GET \
  "https://sahmscreener.com/api/llm/company/2222" \
  -H "X-API-Key: your_api_key_here"

What can you build?

Portfolio Tracker

Real-time P/E, revenue and profit for Saudi holdings. Auto-refreshed nightly.

Robo-Advisor

Feed fundamental screens into allocation models. Value, growth, dividend filters built-in.

Research Platform

Power your investment research tool with Saudi earnings quality scores and 6-year dividend history.

ChatGPT / AI Agent

MCP-compatible. Your AI agent can query Saudi fundamentals in natural language via our MCP server.

Quant Screener

Filter 394 companies by 15+ metrics. Earnings quality, ROE, D/E, revenue growth — all in one API call.

Risk Dashboard

Monitor debt stress, profit quality and capital efficiency across your Saudi portfolio automatically.

Simple pricing

BEST VALUE

$999/year$2,388

$83.25/month — billed annually

You save $1,389 every year

✓Unlimited API calls

✓All 394 Tadawul & Nomu companies

✓Revenue, profit, P/E, ROE, D/E, EPS

✓Earnings Quality scores

✓6-year dividend history with yields

✓Quarterly financial data

✓Nightly data updates

✓JSON responses

✓MCP server compatible

✓Email support

7-day money-back guarantee

Get started in 5 minutes

Step 1 — Get your API key

Subscribe above → your API key is emailed instantly and shown in your account dashboard.

Step 2 — Make your first call

import requests

r = requests.get(
  "https://sahmscreener.com/api/llm/company/2222",
  headers={"X-API-Key": "your_key"}
)
print(r.json())

Step 3 — Explore endpoints

GET/api/llm/company/{symbol}

Full financials for one company

Example: /api/llm/company/2222

GET/api/llm/companies

List all 394 companies with key metrics

GET/api/llm/screener

Screen companies by metric

Example: ?min_roe=15&max_pe=20

Works with Claude, Cursor & ChatGPT

Our MCP server lets AI assistants query Saudi financial data in natural language. No API calls needed — just connect and ask.

Claude Desktop

{
  "mcpServers": {
    "sahm-screener": {
      "command": "npx",
      "args": ["-y", "@sahmscreener/mcp-server"],
      "env": {
        "SAHM_API_KEY": "your_key"
      }
    }
  }
}

Cursor / VS Code

{
  "mcpServers": {
    "sahm-screener": {
      "command": "npx",
      "args": ["-y", "@sahmscreener/mcp-server"],
      "env": {
        "SAHM_API_KEY": "your_key"
      }
    }
  }
}

Once connected, ask: “What are the most profitable Saudi banks?” “Show me Saudi stocks with ROE above 20%” “What is Saudi Aramco's dividend yield?”

Data sourced from CMA-mandated XBRL filings on the Saudi Exchange. Covers all 394 companies on Tadawul and Nomu. Updated nightly.