İçeriğe geç

Hesap

GET /v1/me: anahtarın sahibi, yetkileri, plan limitleri ve günlük kullanımı.

Yetki: account:read

GET /v1/me

İsteği yapan anahtar hakkında bilgi. Entegrasyonun ilk adımında anahtarın çalıştığını ve yetkilerini doğrulamak, çalışırken de kalan günlük kotayı görmek için kullanılır. Bu istek de sayaçtan 1 düşer; sık sorgulamak yerine yanıt başlıklarındaki X-Quota-Remaining değerini izleyin.

Örnek

curl "https://api.istfin.com/v1/me" \  -H "Authorization: Bearer $ISTFIN_API_KEY"

Yanıt

{
  "data": {
    "userId": "66f1c0a2e4b0d9a1b2c3d4e5",
    "keyId": "66f1c0b7e4b0d9a1b2c3d4f0",
    "scopes": ["market:read", "fundamentals:read", "account:read"],
    "modules": [],
    "entitlements": { "livePrice": false, "liveVolume": false, "liveIndex": false },
    "rateLimit": { "perMinute": 30, "perDay": 1000 },
    "limits": {
      "symbolsPerRequest": 20,
      "intradayHistoryDays": 30,
      "dailyHistoryDays": 90,
      "weeklyHistoryDays": 365,
      "monthlyHistoryDays": 1825,
      "newsHistoryDays": 90,
      "fundamentalsHistoryDays": 730,
      "backtestSymbols": 1,
      "intradayBacktestSymbols": 0
    },
    "usage": { "today": 124, "remainingToday": 876 }
  },
  "meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}
AlanTipAçıklama
userIdstringHesap kimliği
keyIdstringAnahtar kimliği (paneldeki kayıtla aynı)
scopesstring[]Anahtarın yetkileri (Kimlik doğrulama)
modulesstring[]Aboneliğe eklenmiş ürün modülleri (algo, depth, custody); şu an boş döner
entitlementsobjectEtkin veri yetkisi: livePrice, liveVolume, liveIndex; false = 15 dk gecikmeli. Temel planda hepsi false; Canlı planda livePrice ve liveIndex true
rateLimit.perMinuteintegerDakikalık limit
rateLimit.perDayintegerGünlük kota
limits.symbolsPerRequestintegerTek istekte en fazla hisse (/v1/quotes, MCP get_quotes)
limits.intradayHistoryDaysinteger | nullGün içi barlarda (1 dk-4 saat) geriye gidilebilecek gün; null sınırsız
limits.dailyHistoryDaysinteger | nullGünlük barlarda geriye gidilebilecek gün
limits.weeklyHistoryDaysinteger | nullHaftalık barlarda geriye gidilebilecek gün
limits.monthlyHistoryDaysinteger | nullAylık barlarda geriye gidilebilecek gün
limits.newsHistoryDaysinteger | nullKAP bildirimlerinde geriye gidilebilecek gün
limits.fundamentalsHistoryDaysinteger | nullFinansal tablo ve oran serisinde geriye gidilebilecek gün; null sınırsız
limits.backtestSymbolsintegerBacktest başına en fazla hisse; 0 backtest kapalı
limits.intradayBacktestSymbolsintegerGün içi periyotta backtest başına hisse; 0 kapalı
usage.todayintegerBugün kullanılan (İstanbul günü)
usage.remainingTodayintegerBugün kalan

Bu sayfada