REST API dokümanı

export KEY="fon_..."
curl -H "X-API-Key: $KEY" \
  "https://fonoloji.com/v1/funds/IIH"

const res = await fetch(
  "https://fonoloji.com/v1/funds/IIH",
  { headers: { "X-API-Key": process.env.FONOLOJI_KEY } }
);
const fund = await res.json();

import os, requests
key = os.environ["FONOLOJI_KEY"]
r = requests.get(
  "https://fonoloji.com/v1/funds/IIH",
  headers={"X-API-Key": key},
)
print(r.json())

{
  "fund": {
    "code": "IIH",
    "name": "İSTANBUL PORTFÖY ÜÇÜNCÜ HİSSE SENEDİ FONU (HİSSE SENEDİ YOĞUN FON)",
    "type": "YAT",
    "category": "Hisse Senedi Şemsiye Fonu",
    "management_company": "İstanbul Portföy Yönetimi A.Ş.",
    "isin": "TRYISTP00109",
    "risk_score": 7,
    "trading_status": "AKTİF",
    "trading_start": "09:00",
    "trading_end": "17:30",
    "buy_valor": 1,
    "sell_valor": 2,
    "current_price": 32.501632,
    "current_date": "2026-09-25",
    "return_1d": -0.021478,
    "return_1w": -0.007747,
    "return_1m": -0.032491,
    "return_3m": -0.00845,
    "return_6m": 0.082018,
    "return_1y": 0.196815,
    "return_ytd": 0.189539,
    "real_return_1y": -0.089925,
    "volatility_90": 0.205798,
    "sharpe_90": -1.8471,
    "sortino_90": -1.8503,
    "calmar_1y": 1.4829,
    "beta_1y": 0.8626,
    "max_drawdown_1y": -0.132727,
    "ma_30": 33.324049,
    "ma_90": 32.860645,
    "ma_200": 32.51339,
    "aum": 1486584069.38,
    "investor_count": 19300,
    "first_seen": "2021-06-15",
    "last_seen": "2026-09-25",
    "kap_url": "https://www.kap.org.tr/tr/fon-bilgileri/genel/iih-..."
  },
  "portfolio": {
    "code": "IIH",
    "date": "2026-09-25",
    "stock": 87.32,
    "government_bond": 0,
    "treasury_bill": 0,
    "corporate_bond": 0,
    "eurobond": 0,
    "gold": 0,
    "cash": 3.26,
    "other": 0
  }
}

{
  "code": "IIH",
  "period": "1y",
  "points": [
    {
      "date": "2025-09-26",
      "price": 27.063296,
      "total_value": 3154947528.04,
      "investor_count": 32133
    },
    {
      "date": "2025-09-29",
      "price": 26.591406,
      "total_value": 3085645380.54,
      "investor_count": 32017
    },
    ...
    {
      "date": "2026-09-24",
      "price": 33.215041,
      "total_value": 1555284745.61,
      "investor_count": 19532
    },
    {
      "date": "2026-09-25",
      "price": 32.501632,
      "total_value": 1486584069.38,
      "investor_count": 19300
    }
  ]
}

{
  "code": "IIH",
  "summary": "İstanbul Portföy Üçüncü Hisse Senedi Fonu son 1 yılda nominal %19.7 getiri sağladı; TÜFE'ye göre reel getirisi ise %-9.0. Portföyün %87'si hisse senedinden oluşuyor, bu da fonun hisse senedi yoğun kategorisiyle uyumlu. 90 günlük volatilite %20.6, Sharpe oranı -1.85. Son bir yıldaki en büyük değer kaybı %13.3. Fonun toplam yönetilen varlığı 1.49 milyar TL.",
  "cached": true,
  "model": "gpt-4.1-mini",
  "generated_at": 1790380800000
}

// HTTP 503 — görsel henüz cache'te değil
{
  "error": "Görsel henüz hazırlanmadı",
  "message": "Bu fon için görsel cache boş. Birkaç dakika sonra tekrar deneyin veya tarayıcıdan https://fonoloji.com/fon/IIH adresini ziyaret ederek cache'i ısıtın.",
  "retryAfterSeconds": 60
}