{
  "hub": "Yahoo Finance Proxy Hub",
  "version": "2.0.0",
  "endpoints": {
    "realtime": {
      "websocket": "wss://<host>/ — subscribe JSON: { event:'subscribe', symbols:['THYAO.IS'] }"
    },
    "yahooFinance": [
      {
        "method": "GET",
        "path": "/api/yf/quote?symbols=A,B",
        "desc": "Snapshot quote (tek veya çoklu)"
      },
      {
        "method": "GET",
        "path": "/api/yf/history/:symbol?range=&interval=",
        "desc": "OHLCV geçmiş (candle serisi)"
      },
      {
        "method": "GET",
        "path": "/api/yf/search?q=",
        "desc": "Sembol arama"
      },
      {
        "method": "GET",
        "path": "/api/yf/summary/:symbol",
        "desc": "Şirket profili + finansallar"
      },
      {
        "method": "GET",
        "path": "/api/yf/trending?region=US",
        "desc": "Trend semboller"
      },
      {
        "method": "DELETE",
        "path": "/api/yf/cache",
        "desc": "YF cache temizle"
      }
    ],
    "halkArz": [
      {
        "method": "GET",
        "path": "/api/ipo/all",
        "desc": "Tüm halka arzlar"
      },
      {
        "method": "GET",
        "path": "/api/ipo/aktif",
        "desc": "Aktif arzlar"
      },
      {
        "method": "GET",
        "path": "/api/ipo/gecmis",
        "desc": "Geçmiş arzlar"
      },
      {
        "method": "GET",
        "path": "/api/ipo/taslak",
        "desc": "Taslak arzlar"
      },
      {
        "method": "GET",
        "path": "/api/ipo/detail/:slug",
        "desc": "Tek arz detayı (zengin)"
      },
      {
        "method": "DELETE",
        "path": "/api/ipo/cache",
        "desc": "IPO cache temizle"
      }
    ],
    "kiymetliMadenler": [
      {
        "method": "GET",
        "path": "/api/metals/tr",
        "desc": "TR retail altın/gümüş/platin/paladyum (altin.doviz.com)"
      },
      {
        "method": "GET",
        "path": "/api/metals/tr/:slug",
        "desc": "Tek ürün (gramAltin, ceyrek, bilezik22 vb.)"
      },
      {
        "method": "GET",
        "path": "/api/metals/tr/category/:c",
        "desc": "Kategori (gram|coin|bilezik|silver|platinum|palladium|spot)"
      },
      {
        "method": "DELETE",
        "path": "/api/metals/cache",
        "desc": "Metals cache temizle"
      }
    ],
    "bistAll": [
      {
        "method": "GET",
        "path": "/api/bist/all",
        "desc": "Uzmanpara BIST listesi + kıymetli madenler (birleşik)"
      },
      {
        "method": "GET",
        "path": "/api/bist/all?category=bist",
        "desc": "Sadece BIST"
      },
      {
        "method": "GET",
        "path": "/api/bist/all?category=metal",
        "desc": "Sadece kıymetli madenler"
      },
      {
        "method": "GET",
        "path": "/api/bist/all?type=Hisse",
        "desc": "Uzmanpara tip filtresi (Hisse, Endeks, vs.)"
      },
      {
        "method": "DELETE",
        "path": "/api/bist/all/cache",
        "desc": "BIST+metal cache temizle"
      }
    ],
    "system": [
      {
        "method": "GET",
        "path": "/health",
        "desc": "Sağlık ve upstream durumu"
      }
    ]
  },
  "symbolExamples": {
    "bist": "THYAO.IS, GARAN.IS, ASELS.IS, BIMAS.IS",
    "us": "AAPL, TSLA, MSFT, NVDA",
    "crypto": "BTC-USD, ETH-USD, SOL-USD",
    "forex": "EURUSD=X, TRYUSD=X, GBPUSD=X, USDTRY=X, EURTRY=X",
    "index": "^GSPC (S&P500), ^XU100.IS (BIST100)",
    "commoditiesFuture": "GC=F (altın), SI=F (gümüş), PL=F (platin), PA=F (paladyum), CL=F (petrol)"
  },
  "virtualSymbols": {
    "aciklama": "Yahoo'da doğrudan olmayan türev semboller. Normal subscribe ile kullanın, hub GC=F + USDTRY gibi kaynaklardan hesaplar.",
    "available": [
      "XAU_GRAM_TRY — Gram Altın (TRY, GC=F × USDTRY'den hesaplanır)",
      "XAG_GRAM_TRY — Gram Gümüş (TRY)",
      "XPT_GRAM_TRY — Gram Platin (TRY)",
      "XPD_GRAM_TRY — Gram Paladyum (TRY)",
      "XAU_GRAM_USD — Gram Altın (USD)",
      "XAG_GRAM_USD — Gram Gümüş (USD)",
      "XAU_OZ_TRY   — Ons Altın (TRY)",
      "XAG_OZ_TRY   — Ons Gümüş (TRY)"
    ]
  }
}