REST API
dokümanı

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

const res = await fetch(
  "https://fonoloji.com/v1/funds/PHE",
  { 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/PHE",
  headers={"X-API-Key": key},
)
print(r.json())

{
  "fund": {
    "code": "PHE",
    "name": "PUSULA PORTFÖY HİSSE SENEDİ FONU (HİSSE SENEDİ YOĞUN FON)",
    "type": "YAT",
    "category": "Hisse Senedi Şemsiye Fonu",
    "management_company": "Pusula Portföy Yönetimi A.Ş.",
    "isin": "TRYPSLP00010",
    "risk_score": 6,
    "trading_status": "AKTİF",
    "trading_start": "09:00",
    "trading_end": "17:00",
    "buy_valor": 1,
    "sell_valor": 2,
    "current_price": 2.816142,
    "current_date": "2026-04-30",
    "return_1d": -0.000586,
    "return_1w": -0.00501,
    "return_1m": 0.091457,
    "return_3m": 0.512178,
    "return_6m": 1.230964,
    "return_1y": 1.670785,
    "return_ytd": 0.946855,
    "real_return_1y": 1.040792,
    "volatility_90": 0.174613,
    "sharpe_90": 7.9141,
    "sortino_90": 12.8878,
    "calmar_1y": 6.39,
    "beta_1y": 1.0017,
    "max_drawdown_1y": -0.172801,
    "ma_30": 2.672913,
    "ma_90": 2.15306,
    "ma_200": 1.67323,
    "aum": 36522590809.75,
    "investor_count": 90471,
    "first_seen": "2024-04-09",
    "last_seen": "2026-05-01",
    "kap_url": "https://www.kap.org.tr/tr/fon-bilgileri/genel/phe-..."
  },
  "portfolio": {
    "code": "PHE",
    "date": "2026-04-22",
    "stock": 79.18,
    "government_bond": 0,
    "treasury_bill": 0,
    "corporate_bond": 0,
    "eurobond": 0,
    "gold": 0,
    "cash": 0,
    "other": 20.82
  }
}

{
  "code": "PHE",
  "period": "1y",
  "points": [
    {
      "date": "2025-05-02",
      "price": 1.036193,
      "total_value": 0,
      "investor_count": 632
    },
    {
      "date": "2025-05-05",
      "price": 1.047051,
      "total_value": 0,
      "investor_count": 619
    },
    ...
    {
      "date": "2026-04-29",
      "price": 2.817793,
      "total_value": 36522590809.75,
      "investor_count": 90471
    },
    {
      "date": "2026-04-30",
      "price": 2.816142,
      "total_value": null,
      "investor_count": null
    }
  ]
}

{
  "code": "PHE",
  "summary": "Pusula Portföy Hisse Senedi Fonu, son 1 yılda nominal %167.1, reel olarak ise %104.1 getiri sağladı. Portföyün %79'u hisse senedinden oluşuyor, bu da fonun hisse senedi yoğun kategorisiyle uyumlu. Sharpe oranı 7.91 ve volatilitesi %17.5 seviyesinde, bu da yüksek getiriyle birlikte görece makul bir risk profili olduğunu gösteriyor. Maksimum değer kaybı %17.3 olarak gerçekleşti. Fonun toplam yönetilen varlığı 36.52 milyon TL seviyesinde bulunuyor.",
  "cached": true,
  "model": "gpt-4.1-mini",
  "generated_at": 1777632746304
}

// 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/PHE adresini ziyaret ederek cache'i ısıtın.",
  "retryAfterSeconds": 60
}