إنشاء أداة لأبحاث الأسهم باستخدام حزمة SAHMK Python SDK

from sahmk import SahmkClient

client = SahmkClient(api_key="your_api_key_here")

company = client.company("2222")

print(f"{company.name_en} ({company.symbol})")
print(f"Type:   {company.security_type}")
print(f"Sector: {company.sector} / {company.industry}")
print(f"Price:  {company.current_price} SAR")

if company.fundamentals:
    f = company.fundamentals
    print(f"\nMarket Cap:      {f.market_cap / 1e9:,.0f}B SAR")
    print(f"P/E Ratio:       {f.pe_ratio}")
    print(f"EPS:             {f.eps} SAR")
    print(f"Price/Book:      {f.price_to_book}")
    print(f"Beta:            {f.beta}")
    print(f"52-Week Range:   {f.fifty_two_week_low} – {f.fifty_two_week_high} SAR")
    print(f"Float Shares:    {f.float_shares:,}")

if company.technicals:
    t = company.technicals
    print(f"\nRSI (14):        {t.rsi_14}")
    print(f"MACD:            {t.macd_line} (signal: {t.macd_signal})")
    print(f"Direction:       {t.price_direction}")

if company.valuation:
    v = company.valuation
    gap = ((v.fair_price - company.current_price) / company.current_price) * 100
    print(f"\nFair Price:      {v.fair_price} SAR (confidence: {v.fair_price_confidence})")
    print(f"vs Current:      {gap:+.1f}%")

if company.analysts:
    a = company.analysts
    print(f"\nAnalyst Target:  {a.target_mean} SAR (range: {a.target_low}–{a.target_high})")
    print(f"Consensus:       {a.consensus} ({a.num_analysts} analysts)")

financials = client.financials("2222")

print(f"Financial Statements for {financials.symbol}\n")

# Most recent income statement
if financials.income_statements:
    inc = financials.income_statements[0]
    print(f"Income Statement ({inc.report_date})")
    print(f"  Revenue:      {inc.total_revenue / 1e9:,.0f}B SAR")
    if inc.gross_profit:
        margin = (inc.gross_profit / inc.total_revenue) * 100
        print(f"  Gross Profit: {inc.gross_profit / 1e9:,.0f}B SAR ({margin:.0f}% margin)")
    print(f"  Net Income:   {inc.net_income / 1e9:,.0f}B SAR")

# Most recent balance sheet
if financials.balance_sheets:
    bs = financials.balance_sheets[0]
    print(f"\nBalance Sheet ({bs.report_date})")
    print(f"  Total Assets:  {bs.total_assets / 1e9:,.0f}B SAR")
    print(f"  Equity:        {bs.stockholders_equity / 1e9:,.0f}B SAR")
    print(f"  Total Debt:    {bs.total_debt / 1e9:,.0f}B SAR")

# Most recent cash flow
if financials.cash_flows:
    cf = financials.cash_flows[0]
    print(f"\nCash Flow ({cf.report_date})")
    print(f"  Operating:     {cf.operating_cash_flow / 1e9:,.0f}B SAR")
    print(f"  Free Cash:     {cf.free_cash_flow / 1e9:,.0f}B SAR")

print("Revenue Trend (Quarterly)")
for inc in financials.income_statements:
    bar = "█" * int(inc.total_revenue / 1e10)
    print(f"  {inc.report_date}: {inc.total_revenue / 1e9:>6,.0f}B  {bar}")

divs = client.dividends("2222")

print(f"Dividends for {divs.symbol}")
print(f"  Current Price:       {divs.current_price} SAR")
print(f"  Trailing 12M Yield:  {divs.trailing_12m_yield}%")
print(f"  Trailing 12M Total:  {divs.trailing_12m_dividends} SAR/share")
print(f"  Payments Last Year:  {divs.payments_last_year}")

if divs.upcoming:
    print("\nUpcoming Distributions:")
    for u in divs.upcoming:
        print(f"  {u.period}: {u.value} SAR/share")
        print(f"    Eligibility: {u.eligibility_date}")
        print(f"    Payment:     {u.distribution_date}")

if divs.history:
    print("\nPayment History:")
    for h in divs.history[:4]:
        print(f"  {h.period} {h.fiscal_year}: {h.value} SAR ({h.value_percent}%) — paid {h.distribution_date}")

events = client.events(symbol="2222", limit=5)

print(f"Recent Events ({events.count} total)\n")
for e in events.events:
    sentiment_icon = {"positive": "↑", "negative": "↓", "neutral": "→"}.get(e.sentiment, "•")
    print(f"  {sentiment_icon} [{e.event_type}] {e.importance}")
    print(f"    {e.description}")
    print(f"    {e.article_date}\n")

all_events = client.events(limit=20)
print(f"Available event types: {all_events.available_types}")

from sahmk import SahmkClient, SahmkError

client = SahmkClient(api_key="your_api_key_here")

SYMBOL = "2222"

def research(symbol):
    company = client.company(symbol)
    print(f"{'=' * 60}")
    print(f"  {company.name_en} ({company.symbol})")
    print(f"  {company.sector} / {company.industry}")
    print(f"  Price: {company.current_price} SAR")
    print(f"{'=' * 60}")

    if company.fundamentals:
        f = company.fundamentals
        print(f"\n  P/E: {f.pe_ratio}  |  EPS: {f.eps}  |  Beta: {f.beta}")
        print(f"  52W: {f.fifty_two_week_low}–{f.fifty_two_week_high} SAR")

    if company.valuation:
        v = company.valuation
        gap = ((v.fair_price - company.current_price) / company.current_price) * 100
        label = "undervalued" if gap > 0 else "overvalued"
        print(f"  Fair Price: {v.fair_price} SAR ({gap:+.0f}% — {label})")

    if company.analysts:
        a = company.analysts
        print(f"  Consensus: {a.consensus.upper()} | Target: {a.target_mean} SAR ({a.num_analysts} analysts)")

    try:
        divs = client.dividends(symbol)
        print(f"\n  Dividend Yield: {divs.trailing_12m_yield}% trailing")
        if divs.upcoming:
            u = divs.upcoming[0]
            print(f"  Next Payment:   {u.value} SAR on {u.distribution_date}")
    except SahmkError:
        pass

    try:
        fin = client.financials(symbol)
        if fin.income_statements:
            inc = fin.income_statements[0]
            print(f"\n  Latest Revenue:    {inc.total_revenue / 1e9:,.0f}B SAR ({inc.report_date})")
            print(f"  Latest Net Income: {inc.net_income / 1e9:,.0f}B SAR")
        if fin.cash_flows:
            cf = fin.cash_flows[0]
            print(f"  Free Cash Flow:    {cf.free_cash_flow / 1e9:,.0f}B SAR")
    except SahmkError:
        pass

    try:
        events = client.events(symbol=symbol, limit=3)
        if events.events:
            print(f"\n  Recent Events:")
            for e in events.events:
                print(f"    [{e.event_type}] {e.description[:80]}")
    except SahmkError:
        pass

    print(f"\n{'=' * 60}")


research(SYMBOL)