Developers API

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.

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.

CLIPythonBeginner5 min read

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.

PythonSDKBeginner6 min read

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.

PythonREST APIIntermediate10 min read

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.

PythonSDKIntermediate10 min read

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 vs Enterprise limits, and reconnect logic in JavaScript and Python.

WebSocketJavaScriptPythonIntermediate12 min read

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.

MCPAI AgentsCursorClaude5 min read

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.

LM StudioMCPLocal ModelsPrivate AI7 min read

More tutorials coming soon.