Tutorials
Step-by-step guides to help you build applications with the SAHMK Saudi Stock Market API. From fetching your first Tadawul quote to building real-time dashboards.
Get started
Install tools and fetch your first Tadawul data in minutes.
SAHMK CLI Quick Start
Query Tadawul data from your terminal — quotes, market summaries, company research, financials, dividends, events, and real-time streaming. No code required.
SAHMK Python SDK Quick Start
Get started with the official SAHMK Python SDK. Typed models, error handling, retries, and IDE autocompletion for Tadawul stock data.
Build apps
Ship trackers, research tools, and intraday workflows with REST and the SDK.
Build a Saudi Stock Tracker in Python (REST API)
Learn how to fetch real-time Tadawul stock quotes, track TASI gainers and losers, and build a portfolio tracker using the SAHMK REST API directly with Python.
Build a Stock Research Tool with the SAHMK Python SDK
Company profiles, financial statements, dividends, analyst consensus, and AI-generated events — build a complete Tadawul research tool with the SAHMK SDK.
Get Intraday Tadawul Data with SAHMK (SDK + MCP)
Fetch and analyze 30m/60m intraday candles using SAHMK Python SDK or MCP, with practical plan-limit guardrails and fallback patterns.
Realtime
Stream live quotes and order book depth over WebSocket.
Build a Real-Time Tadawul Stream with SAHMK WebSocket (JavaScript + Python)
Build production-safe real-time streaming with SAHMK WebSocket, including subscribe/unsubscribe, ping/pong handling, Pro+/Enterprise limits, and reconnect logic in JavaScript and Python.
Add Live Order Book Depth with SAHMK WebSocket (JavaScript + Python)
Show real-time bid and ask levels for Tadawul symbols. Request Market Depth access, subscribe over WebSocket, and keep your book UI up to date in JavaScript or Python.
AI & MCP
Connect SAHMK to AI assistants and local models.
Connect SAHMK to Claude Desktop or Cursor via MCP
Give AI assistants direct access to live Saudi stock data with the official SAHMK MCP server. Install, configure, and query the market in plain language.
Use SAHMK MCP with LM Studio and Local AI Models (Gemma + Qwen)
Run SAHMK MCP with LM Studio for private/local Saudi market workflows. Includes tested models, setup flow, system prompt, context guidance, and practical prompt examples.
More tutorials coming soon.