Limitler
Plan limitleri, istek maliyeti, yanıt başlıkları, 403 ve 429 davranışı.
Limitler
Limitler plana bağlıdır. Planınızın değerleri abonelik ekranının plan adımında ve GET /v1/me yanıtında yazar.
| Limit | Kapsam | /v1/me alanı |
|---|---|---|
| Dakikalık (burst) | Hesap bazında, kayan pencere (GCRA) | rateLimit.perMinute |
| Günlük kota | Hesap bazında, İstanbul gece yarısında sıfırlanır | rateLimit.perDay |
| Tek istekte hisse | /v1/quotes, MCP get_quotes | limits.symbolsPerRequest |
| Bar geçmişi | Periyoda göre: gün içi, günlük, haftalık, aylık; backtest dönemi de | limits.intradayHistoryDays, dailyHistoryDays, weeklyHistoryDays, monthlyHistoryDays (null sınırsız) |
| KAP geçmişi | /v1/news listesi ve tek bildirim | limits.newsHistoryDays (null sınırsız) |
| Finansal geçmiş | Finansal tablo dönemleri, oran serisi | limits.fundamentalsHistoryDays (null sınırsız) |
| Backtest başına hisse | POST /v1/backtests, MCP run_strategy; günlük ve üstü | limits.backtestSymbols (0 kapalı) |
| Gün içi backtest | Aynı uçlar, 1 günden kısa periyot | limits.intradayBacktestSymbols (0 kapalı) |
| IP | Dakikada 300 istek, anahtar doğrulanmadan önce IP başına |
Uzun aralıklı grafiklerde kaba periyot kullanın: 3 ay için 1d, 6 ay ve 1 yıl için 1w, 5 yıl için 1mo.
Sayaçlar hesaba bağlıdır, anahtara değil. REST ve MCP aynı sayaçlardan düşer.
İstek maliyeti
Çoğu istek 1 sayılır. Ağır uçlar daha fazla düşer:
| Uç | Maliyet |
|---|---|
GET /v1/market/movers | 2 |
POST /v1/backtests | Hisse başına 10 |
| Diğer tüm uçlar | 1 |
Dakikalık limitten pahalı tek bir istek reddedilmez: o dakikanın tamamını kullanır, günlük kotadan tam maliyetiyle düşer.
Yanıt başlıkları
Her kimliği doğrulanmış yanıt limit durumunu başlıklarla bildirir.
| Başlık | Anlamı |
|---|---|
RateLimit | IETF biçimi: limit=60, remaining=57, reset=12 |
RateLimit-Policy | 60;w=60 (limit; pencere saniyesi) |
X-RateLimit-Limit | Dakikalık limit |
X-RateLimit-Remaining | Bu dakika kalan istek |
X-RateLimit-Reset | Pencerenin dolmasına kalan saniye |
X-RateLimit-Policy | burst |
X-Quota-Limit | Günlük kota |
X-Quota-Remaining | Bugün kalan istek |
X-Quota-Reset | Günün bitmesine kalan saniye (İstanbul saatiyle gece yarısı) |
Retry-After | Yalnızca 429'da: kaç saniye sonra tekrar denenmeli |
X-Request-Id | İsteğin kimliği; destek taleplerinde paylaşın |
429 yanıtları
İki farklı kod döner; ikisi de Retry-After başlığı ve gövdede retryAfter alanı taşır.
{
"error": {
"code": "RATE_LIMITED",
"message": "İstek limitine ulaştınız, kısa süre sonra tekrar deneyin",
"retryAfter": 3
},
"meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}| Kod | Ne zaman | Beklenecek süre |
|---|---|---|
RATE_LIMITED | Dakikalık limit aşıldı (veya IP limiti) | Birkaç saniye (Retry-After) |
QUOTA_EXCEEDED | Günlük kota doldu | Gün sonuna kadar (Retry-After) |
Günlük kota dolduğunda istek işlenmez ve dakikalık sayaçtan düşmez.
Plan sınırı (403)
İstek planınızın sınırını aşarsa 403 PLAN_LIMIT_EXCEEDED döner; details[].path sınıra takılan girdiyi gösterir.
{
"error": {
"code": "PLAN_LIMIT_EXCEEDED",
"message": "Planınızda tek istekte en fazla 20 hisse sorgulanabilir",
"details": [
{
"path": "query.symbols",
"code": "PLAN_LIMIT",
"message": "Planınızda tek istekte en fazla 20 hisse sorgulanabilir"
}
]
},
"meta": { "requestId": "req_01jzqk4x8m9b2c5d7e8f9g0h1j" }
}Gün içi barlarda from verilmezse yanıt planınızın geçmiş penceresinin başından başlar; pencereden eski bir from ya da to 403 döner.
Öneriler
X-RateLimit-Remainingdeğeri düşerken istekleri seyreltin; 429'u beklemeyin.- 429 aldığınızda
Retry-Afterkadar bekleyin, sabit aralıkla yeniden denemeyin. - Toplu fiyat için tek tek
/v1/quotes?symbols=THYAOyerine planınızın izin verdiği kadar sembolü tek istekte isteyin. - Tarihsel veri için
/v1/bars/{symbol}isteğindelimitdeğerini ihtiyacınız kadar büyük tutun (en fazla 5000); sayfa sayfa çekmek kota tüketir.