İçeriğe geç

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.

LimitKapsam/v1/me alanı
Dakikalık (burst)Hesap bazında, kayan pencere (GCRA)rateLimit.perMinute
Günlük kotaHesap bazında, İstanbul gece yarısında sıfırlanırrateLimit.perDay
Tek istekte hisse/v1/quotes, MCP get_quoteslimits.symbolsPerRequest
Bar geçmişiPeriyoda göre: gün içi, günlük, haftalık, aylık; backtest dönemi delimits.intradayHistoryDays, dailyHistoryDays, weeklyHistoryDays, monthlyHistoryDays (null sınırsız)
KAP geçmişi/v1/news listesi ve tek bildirimlimits.newsHistoryDays (null sınırsız)
Finansal geçmişFinansal tablo dönemleri, oran serisilimits.fundamentalsHistoryDays (null sınırsız)
Backtest başına hissePOST /v1/backtests, MCP run_strategy; günlük ve üstülimits.backtestSymbols (0 kapalı)
Gün içi backtestAynı uçlar, 1 günden kısa periyotlimits.intradayBacktestSymbols (0 kapalı)
IPDakikada 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/movers2
POST /v1/backtestsHisse başına 10
Diğer tüm uçlar1

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ıkAnlamı
RateLimitIETF biçimi: limit=60, remaining=57, reset=12
RateLimit-Policy60;w=60 (limit; pencere saniyesi)
X-RateLimit-LimitDakikalık limit
X-RateLimit-RemainingBu dakika kalan istek
X-RateLimit-ResetPencerenin dolmasına kalan saniye
X-RateLimit-Policyburst
X-Quota-LimitGünlük kota
X-Quota-RemainingBugün kalan istek
X-Quota-ResetGünün bitmesine kalan saniye (İstanbul saatiyle gece yarısı)
Retry-AfterYalnı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" }
}
KodNe zamanBeklenecek süre
RATE_LIMITEDDakikalık limit aşıldı (veya IP limiti)Birkaç saniye (Retry-After)
QUOTA_EXCEEDEDGünlük kota dolduGü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-Remaining değeri düşerken istekleri seyreltin; 429'u beklemeyin.
  • 429 aldığınızda Retry-After kadar bekleyin, sabit aralıkla yeniden denemeyin.
  • Toplu fiyat için tek tek /v1/quotes?symbols=THYAO yerine planınızın izin verdiği kadar sembolü tek istekte isteyin.
  • Tarihsel veri için /v1/bars/{symbol} isteğinde limit değerini ihtiyacınız kadar büyük tutun (en fazla 5000); sayfa sayfa çekmek kota tüketir.

Bu sayfada