إنشاء متتبع للأسهم السعودية باستخدام Python وواجهة SAHMK API

pip install requests

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.sahmk.sa/api/v1"

headers = {"X-API-Key": API_KEY}

# Fetch Aramco quote by identifier
response = requests.get(f"{BASE_URL}/quote/2222/", headers=headers)
data = response.json()

print(f"Company: {data['name_en']}")
print(f"Symbol:  {data['symbol']}")
print(f"Price:   {data['price']} SAR")
print(f"Change:  {data['change']} ({data['change_percent']}%)")
print(f"Volume:  {data['volume']:,}")

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.sahmk.sa/api/v1"

headers = {"X-API-Key": API_KEY}

# Get today__TOKEN_3__gainers__TOKEN_4__name_en__TOKEN_5__change_percent__TOKEN_6__price__TOKEN_7__s top losers (TASI by default)
losers_response = requests.get(f"{BASE_URL}/market/losers/?limit=5&index=TASI", headers=headers).json()
losers = losers_response['losers']

print("📉 Top 5 Losers Today")
print("-" * 50)
for stock in losers:
    print(f"  {stock['name_en']:<25} {stock['change_percent']:>+6.2f}%  {stock['price']} SAR")

print()

# Get market summary (TASI index)
summary = requests.get(f"{BASE_URL}/market/summary/?index=TASI", headers=headers).json()

print("🏛️  Market Summary")
print("-" * 50)
print(f"  TASI: {summary['index_value']} ({summary['index_change_percent']:+.2f}%)")
print(f"  Delayed Feed: {summary['is_delayed']}")

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.sahmk.sa/api/v1"

headers = {"X-API-Key": API_KEY}

# Define your portfolio: symbol, shares, avg cost
portfolio = [
    {"symbol": "2222", "shares": 100, "avg_cost": 27.50},  # Aramco
    {"symbol": "1180", "shares": 50,  "avg_cost": 32.00},  # Al Rajhi Bank
    {"symbol": "2350", "shares": 200, "avg_cost": 8.50},   # Saudi Kayan
    {"symbol": "7010", "shares": 75,  "avg_cost": 98.00},  # STC
]

print("📊 Portfolio Summary")
print("=" * 70)
print(f"  {'Stock':<20} {'Shares':>6} {'Avg Cost':>10} {'Price':>10} {'P/L':>12}")
print("-" * 70)

total_cost = 0
total_value = 0

for holding in portfolio:
    response = requests.get(
        f"{BASE_URL}/quote/{holding['symbol']}/",
        headers=headers
    )
    stock = response.json()

    current_price = float(stock["price"])
    cost_basis = holding["shares"] * holding["avg_cost"]
    market_value = holding["shares"] * current_price
    pnl = market_value - cost_basis
    pnl_pct = (pnl / cost_basis) * 100

    total_cost += cost_basis
    total_value += market_value

    sign = "+" if pnl >= 0 else ""
    print(
        f"  {stock['name_en']:<20} "
        f"{holding['shares']:>6} "
        f"{holding['avg_cost']:>9.2f} "
        f"{current_price:>9.2f} "
        f"{sign}{pnl:>8.2f} ({sign}{pnl_pct:.1f}%)"
    )

total_pnl = total_value - total_cost
total_pnl_pct = (total_pnl / total_cost) * 100
sign = "+" if total_pnl >= 0 else ""

print("=" * 70)
print(f"  Total Cost:   {total_cost:>10,.2f} SAR")
print(f"  Market Value: {total_value:>10,.2f} SAR")
print(f"  Total P/L:    {sign}{total_pnl:>10,.2f} SAR ({sign}{total_pnl_pct:.1f}%)")

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://api.sahmk.sa/api/v1"

headers = {"X-API-Key": API_KEY}

# Fetch multiple quotes in a single request
identifiers = "2222,الراجحي,stc,سابك"

response = requests.get(
    f"{BASE_URL}/quotes/",
    headers=headers,
    params={"symbols": identifiers}
)
stocks = response.json()["quotes"]

print(f"{'Symbol':<8} {'Company':<25} {'Price':>8} {'Change':>10}")
print("-" * 55)

for stock in stocks:
    change = f"{stock['change_percent']:+.2f}%"
    print(f"{stock['symbol']:<8} {stock['name_en']:<25} {stock['price']:>8} {change:>10}")