erhnysr-bist100

? BIST100 & Turkish Markets / Borsa İstanbul ve Türk Piyasaları

Real-time tracking of Borsa Istanbul, currency rates, and commodities. Borsa İstanbul, döviz kurları ve emtia fiyatlarının gerçek zamanlı takibi.

---

When To Use / Ne Zaman Kullanılır

• User asks about Turkish stock market or BIST100 index
• User queries a specific Turkish stock (e.g., THYAO, GARAN, SISE, ASELS)
• User asks about USD/TRY, EUR/TRY, or other currency pairs
• User asks about gold prices (gram altın, çeyrek altın, ons altın)
• Part of the daily brief pipeline (called by turkish-daily-brief)
• User says "piyasalar nasıl?", "borsa ne durumda?", "dolar kaç?"

---

Market Reference / Piyasa Referansı

Borsa İstanbul İşlem Saatleri

Sürekli İşlem:  10:00 - 18:00 (UTC+3)
Açılış Seansı:  09:40 - 10:00
Kapanış Seansı: 18:00 - 18:10
Tatil Günleri:  Cumartesi, Pazar, Resmi Tatiller
Zaman Dilimi:   Europe/Istanbul (UTC+3, yıl boyu)

Major BIST100 Stocks / Önemli BIST100 Hisseleri

THYAO  — Türk Hava Yolları (Turkish Airlines)
GARAN  — Garanti BBVA Bankası
AKBNK  — Akbank
YKBNK  — Yapı Kredi Bankası
ISCTR  — İş Bankası
SISE   — Şişecam
ASELS  — ASELSAN (Savunma/Defence)
TUPRS  — Tüpraş (Enerji/Refinery)
EREGL  — Ereğli Demir Çelik
KCHOL  — Koç Holding
SAHOL  — Sabancı Holding
TAVHL  — TAV Havalimanları
BIMAS  — BİM Mağazaları
TCELL  — Turkcell
TOASO  — Tofaş Otomobil
FROTO  — Ford Otosan
PETKM  — Petkim
EKGYO  — Emlak Konut GYO
PGSUS  — Pegasus Havayolları
SASA   — SASA Polyester

Currency Pairs / Döviz Çiftleri

USD/TRY  — Amerikan Doları / Türk Lirası
EUR/TRY  — Euro / Türk Lirası
GBP/TRY  — İngiliz Sterlini / Türk Lirası
JPY/TRY  — Japon Yeni / Türk Lirası
CHF/TRY  — İsviçre Frangı / Türk Lirası

Gold & Commodities / Altın ve Emtialar

Gram Altın     — 1 gram 24 ayar altın (TRY)
Çeyrek Altın   — ~1.75 gram (TRY)
Yarım Altın    — ~3.50 gram (TRY)
Tam Altın      — ~7.00 gram (TRY)
Ons Altın      — XAU/USD (Troy ounce)
Gümüş          — XAG/USD
Brent Petrol   — Brent Crude (USD)

---

Data Sources & Methods / Veri Kaynakları ve Yöntemler

Method 1: Web Scraping (Primary / Ana Yöntem)

Bloomberg HT — Most Reliable for Turkish Markets:

from hermes_tools import web_extract

# BIST100 Index
result = web_extract(["https://www.bloomberght.com/borsa/endeksler/bist-100"])
# Extract: Current value, change %, daily high/low, volume

# Individual Stock
result = web_extract(["https://www.bloomberght.com/borsa/hisseler/THYAO"])
# Extract: Price, change, volume, market cap

# Currency Rates
result = web_extract(["https://www.bloomberght.com/doviz"])
# Extract: USD/TRY, EUR/TRY, GBP/TRY

# Gold Prices
result = web_extract(["https://www.bloomberght.com/altin"])
# Extract: Gram, çeyrek, yarım, tam, ons

Bigpara (Hürriyet Finance):

# BIST100
result = web_extract(["https://bigpara.hurriyet.com.tr/borsa/canli-borsa/"])

# Currency
result = web_extract(["https://bigpara.hurriyet.com.tr/doviz/"])

# Gold
result = web_extract(["https://bigpara.hurriyet.com.tr/altin/"])

Investing.com TR:

# BIST100
result = web_extract(["https://tr.investing.com/indices/ise-100"])

# Comprehensive market overview
result = web_extract(["https://tr.investing.com/"])

Method 2: Yahoo Finance API (Backup / Yedek Yöntem)

from hermes_tools import terminal

# BIST100 Index
terminal("curl -s 'https://query1.finance.yahoo.com/v8/finance/chart/XU100.IS?interval=1d&range=1d'")

# Individual Stock (add .IS suffix for Borsa Istanbul)
terminal("curl -s 'https://query1.finance.yahoo.com/v8/finance/chart/THYAO.IS?interval=1d&range=1d'")

# USD/TRY
terminal("curl -s 'https://query1.finance.yahoo.com/v8/finance/chart/USDTRY=X?interval=1d&range=1d'")

# EUR/TRY
terminal("curl -s 'https://query1.finance.yahoo.com/v8/finance/chart/EURTRY=X?interval=1d&range=1d'")

# Gold (XAU/USD)
terminal("curl -s 'https://query1.finance.yahoo.com/v8/finance/chart/GC=F?interval=1d&range=1d'")

Yahoo Finance Ticker Reference for BIST:

BIST100 Index:  XU100.IS
BIST30 Index:   XU030.IS
BIST Bank:      XBANK.IS
Stocks:         {TICKER}.IS  (e.g., THYAO.IS, GARAN.IS, ASELS.IS)
USD/TRY:        USDTRY=X
EUR/TRY:        EURTRY=X

Method 3: DuckDuckGo Search (Fallback / Son Çare)

from hermes_tools import web_search

# Quick price check when APIs are down
result = web_search("BIST100 bugün", limit=3)
result = web_search("dolar TL kuru bugün", limit=3)
result = web_search("gram altın fiyatı bugün", limit=3)

---

Procedures / İşlem Adımları

Procedure 1: Market Overview / Piyasa Özeti

Trigger: "Piyasalar nasıl?", "Borsa ne durumda?", "Market overview"

Steps:

1. Fetch BIST100 index value and daily change
2. Fetch USD/TRY and EUR/TRY rates
3. Fetch gram altın price
4. Check if market is open/closed based on current time (UTC+3)
5. Format as compact summary

Output:

? PİYASA ÖZETİ — 11 Mart 2026, 14:30

BIST100:    9,245.67  ▲ +1.23% (+112.45)
USD/TRY:    38.4521   ▼ -0.15%
EUR/TRY:    41.2380   ▲ +0.08%
Gram Altın: ₺3,245    ▲ +0.52%

? Borsa AÇIK — kapanışa 3s 30dk

Procedure 2: Stock Lookup / Hisse Sorgulama

Trigger: "THYAO nasıl?", "THYAO hissesi", "Garanti hissesi ne durumda?"

Steps:

1. Identify stock ticker from user input
   • Direct ticker: "THYAO" → THYAO
   • Company name: "Türk Hava Yolları" → THYAO
   • Partial match: "Garanti" → GARAN
2. Fetch stock data from Bloomberg HT or Yahoo Finance
3. Extract: price, daily change %, volume, high/low, market cap
4. Format with Turkish number formatting (1.000,50)

Ticker Resolution Table:

COMPANY_TICKERS = {
    "thy": "THYAO", "türk hava": "THYAO", "turkish airlines": "THYAO",
    "garanti": "GARAN", "akbank": "AKBNK", "yapı kredi": "YKBNK",
    "iş bankası": "ISCTR", "şişecam": "SISE", "aselsan": "ASELS",
    "tüpraş": "TUPRS", "ereğli": "EREGL", "koç": "KCHOL",
    "sabancı": "SAHOL", "tav": "TAVHL", "bim": "BIMAS",
    "turkcell": "TCELL", "tofaş": "TOASO", "ford otosan": "FROTO",
    "petkim": "PETKM", "pegasus": "PGSUS", "sasa": "SASA",
}

Output:

? THYAO — Türk Hava Yolları
━━━━━━━━━━━━━━━━━━━━━━━━━━

Fiyat:     ₺287,40    ▲ +2.15%
Değişim:   +₺6,05
Hacim:     45.2M
Gün İçi:   ₺282,00 - ₺289,50
P.Değeri:  ₺396,2 Milyar

? Son güncelleme: 14:30

Procedure 3: Currency Rates / Döviz Kurları

Trigger: "Dolar kaç?", "Euro kuru", "Döviz kurları"

Steps:

1. Detect which currencies are requested
2. Fetch from Bloomberg HT or Yahoo Finance
3. Include buy/sell spread if available
4. Show daily change direction and percentage

Output:

? DÖVİZ KURLARI — 11 Mart 2026

USD/TRY:  38,4521  ▼ -0,15%  (Alış: 38,42 / Satış: 38,48)
EUR/TRY:  41,2380  ▲ +0,08%  (Alış: 41,20 / Satış: 41,28)
GBP/TRY:  48,7650  ▲ +0,22%  (Alış: 48,72 / Satış: 48,81)

? Son güncelleme: 14:30 • TCMB efektif kurları

Procedure 4: Gold Prices / Altın Fiyatları

Trigger: "Altın kaç?", "Gram altın", "Çeyrek altın fiyatı"

Steps:

1. Fetch gold prices from Bloomberg HT or Bigpara
2. Include all popular variants (gram, çeyrek, yarım, tam, ons)
3. Show daily changes

Output:

? ALTIN FİYATLARI — 11 Mart 2026

Gram Altın:    ₺3.245,00   ▲ +₺17  (+0,52%)
Çeyrek Altın:  ₺5.320,00   ▲ +₺28  (+0,53%)
Yarım Altın:   ₺10.640,00  ▲ +₺56  (+0,53%)
Tam Altın:     ₺21.280,00  ▲ +₺112 (+0,53%)
Ons Altın:     $2.185,40   ▲ +$8,20 (+0,38%)

? Son güncelleme: 14:30

Procedure 5: Portfolio Watchlist / Portföy Takip Listesi

Trigger: "Portföyümü takip et", "Şu hisseleri izle: THYAO, GARAN, ASELS"

Steps:

1. Parse ticker list from user input
2. Fetch current prices for all tickers
3. Format as compact watchlist table
4. Offer to schedule periodic updates

Output:

? TAKİP LİSTEN — 11 Mart 2026, 14:30

Hisse    Fiyat      Değişim    %
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
THYAO    ₺287,40    +₺6,05    ▲ +2,15%
GARAN    ₺142,80    -₺1,20    ▼ -0,83%
ASELS    ₺84,50     +₺0,75    ▲ +0,90%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⏰ Takip zamanlamak ister misin?

---

Number Formatting / Sayı Formatlama

Turkish number format differs from English:

def format_turkish_number(value, decimals=2):
    """Format number in Turkish style: 1.234.567,89"""
    if isinstance(value, str):
        value = float(value.replace('.', '').replace(',', '.'))
    formatted = f"{value:,.{decimals}f}"
    # Swap . and , for Turkish format
    formatted = formatted.replace(',', 'X').replace('.', ',').replace('X', '.')
    return formatted

def format_turkish_currency(value, symbol="₺"):
    """Format as Turkish currency."""
    return f"{symbol}{format_turkish_number(value)}"

# Examples:
# 1234567.89  →  "₺1.234.567,89"
# 38.4521     →  "38,4521"
# 0.0523      →  "%5,23" (percentage)

---

Market Status Detection / Piyasa Durumu Tespiti

from datetime import datetime, timezone, timedelta

def get_market_status():
    """Check if Borsa Istanbul is currently open."""
    ist = timezone(timedelta(hours=3))
    now = datetime.now(ist)
    
    # Weekend check
    if now.weekday() >= 5:  # Saturday=5, Sunday=6
        return "KAPALI", "Hafta sonu — Pazartesi 10:00'da açılır"
    
    hour_min = now.hour * 60 + now.minute
    
    if hour_min < 580:  # Before 09:40
        return "KAPALI", "Açılış seansı 09:40'ta başlar"
    elif hour_min < 600:  # 09:40-10:00
        return "AÇILIŞ SEANSI", "Sürekli işlem 10:00'da başlar"
    elif hour_min < 1080:  # 10:00-18:00
        remaining = 1080 - hour_min
        h, m = divmod(remaining, 60)
        return "AÇIK", f"Kapanışa {h}s {m}dk"
    elif hour_min < 1090:  # 18:00-18:10
        return "KAPANIŞ SEANSI", "Gün sonu seansı"
    else:
        return "KAPALI", "Yarın 10:00'da açılır"

---

Error Handling / Hata Yönetimi

• If Bloomberg HT fails → try Bigpara → try Yahoo Finance → try web_search
• If market is closed → show last closing values with note
• If ticker not found → suggest closest match from known tickers list
• If currency API fails → try TCMB XML (https://www.tcmb.gov.tr/kurlar/today.xml)
• Always show data timestamp so user knows freshness

---

Pitfalls / Dikkat Edilecekler

1. Market hours: BIST operates 10:00-18:00 UTC+3, no DST — don't show "live" outside hours
2. Yahoo suffix: All BIST tickers need .IS suffix on Yahoo Finance
3. Number format: Turkish uses dot for thousands, comma for decimal — NEVER mix with English format
4. Gold variants: Çeyrek/yarım/tam altın are NOT simply multiples of gram due to crafting markup
5. TCMB rates: Central bank rates differ from market rates — specify which you're showing
6. Weekend data: Don't show stale Friday data as "current" on Monday — label it clearly
7. Lira symbol: Use ₺ (U+20BA), not TL or TRY in display