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" }
}| Alan | Tip | Açıklama |
|---|---|---|
userId | string | Hesap kimliği |
keyId | string | Anahtar kimliği (paneldeki kayıtla aynı) |
scopes | string[] | Anahtarın yetkileri (Kimlik doğrulama) |
modules | string[] | Aboneliğe eklenmiş ürün modülleri (algo, depth, custody); şu an boş döner |
entitlements | object | Etkin veri yetkisi: livePrice, liveVolume, liveIndex; false = 15 dk gecikmeli. Temel planda hepsi false; Canlı planda livePrice ve liveIndex true |
rateLimit.perMinute | integer | Dakikalık limit |
rateLimit.perDay | integer | Günlük kota |
limits.symbolsPerRequest | integer | Tek istekte en fazla hisse (/v1/quotes, MCP get_quotes) |
limits.intradayHistoryDays | integer | null | Gün içi barlarda (1 dk-4 saat) geriye gidilebilecek gün; null sınırsız |
limits.dailyHistoryDays | integer | null | Günlük barlarda geriye gidilebilecek gün |
limits.weeklyHistoryDays | integer | null | Haftalık barlarda geriye gidilebilecek gün |
limits.monthlyHistoryDays | integer | null | Aylık barlarda geriye gidilebilecek gün |
limits.newsHistoryDays | integer | null | KAP bildirimlerinde geriye gidilebilecek gün |
limits.fundamentalsHistoryDays | integer | null | Finansal tablo ve oran serisinde geriye gidilebilecek gün; null sınırsız |
limits.backtestSymbols | integer | Backtest başına en fazla hisse; 0 backtest kapalı |
limits.intradayBacktestSymbols | integer | Gün içi periyotta backtest başına hisse; 0 kapalı |
usage.today | integer | Bugün kullanılan (İstanbul günü) |
usage.remainingToday | integer | Bugün kalan |