İstek Limitleri ve Planlar

İki tür limit

Her planın bir aylık kotası (takvim ayı başına ücretlendirilen istek sayısı) ve API'yi ani istek patlamalarına karşı koruyan bir dakika başına limiti vardır. Kotalar her ayın 1'inde 00:00 UTC'de sıfırlanır.

Planlar ayrıca fiyatların ne kadar güncel olduğunu belirleyen güncelleme aralığı bakımından da farklılık gösterir. Güncelleme aralığınızdan daha sık sorgulama yapmak aynı fiyatları yeniden döndürür ve yalnızca kotanızı tüketir.

Bir bakışta planlar

• Free: ayda 100 istek, günlük güncellemeler, dakikada 10 istek
• Lite: ayda 1.000 istek, 30 dakikalık güncellemeler, dakikada 30 istek
• Standard: ayda 10.000 istek, 10 dakikalık güncellemeler, dakikada 60 istek
• Advanced: ayda 50.000 istek, 60 saniyelik güncellemeler, dakikada 120 istek
• Pro: ayda 100.000 istek, 60 saniyelik güncellemeler, dakikada 300 istek
• Ultra: ayda 500.000 istek, 15 saniyelik güncellemeler, dakikada 600 istek
• Business: ayda 500.000 istek, 15 saniyelik güncellemeler, dakikada 600 istek ve buna ek olarak çalışma süresi SLA'sı
• Enterprise: ayda 1.500.000 istek, 5 saniyelik güncellemeler, dakikada 1.200 istek

Özellikler de planla birlikte artar. Ayar fiyatları ücretli bir plan gerektirir; alış/satış fiyatları Standard, webhook alarmları Advanced, gerçek zamanlı akış ise Pro planından itibaren sunulur. Güncel fiyatlar için fiyatlandırma sayfasına bakın.

Neler istek olarak sayılır

• Bir veri endpoint'ine yapılan her başarılı çağrı, kaç sembol döndürdüğünden bağımsız olarak bir istek sayılır.
• /symbols ve /usage ücretsizdir ve hiçbir zaman sayılmaz.
• 104 (dakika başına limit), 106 (planınızda yok), 107 (origin'e izin verilmiyor) veya bir sunucu hatasıyla (500, 503) reddedilen istekler ücretlendirilmez.
• Sorgunun kendisinden kaynaklanan nedenlerle başarısız olan istekler ise sayılır. Bu, 201 ile 210 arasındaki doğrulama hatalarını ve 300 (sonuç yok) hatasını kapsar; bu nedenle tarihleri ve sembolleri göndermeden önce doğrulayın.

Kullanımınızı takip etmek

Kimliği doğrulanmış her yanıt, kotanızı header'larda bildirir:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9876
X-RateLimit-Used: 124
X-RateLimit-Reset: 1793491200
X-RateLimit-Reset-Date: 2026-11-01T00:00:00.000Z
X-RateLimit-Plan: Standard
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 59

Aynı değerler JSON gövdesindeki rate_limit nesnesinde de bulunur. reset bir Unix zaman damgasıdır, reset_date ise aynı anı ISO 8601 formatında verir: UTC'ye göre bir sonraki ayın başlangıcı.

Kota harcamadan kullanımı kontrol etmek

Kendi gösterge panellerinizden veya izleme araçlarınızdan /usage endpoint'ini çağırın. Ücretsizdir:

{
  "success": true,
  "usage": {
    "requests_made": 124,
    "requests_quota": 10000,
    "requests_remaining": 9876,
    "plan": "standard",
    "period_start": "2026-10-01T00:00:00.000Z",
    "period_end": "2026-11-01T00:00:00.000Z"
  },
  "result": { "plan": "Standard", "used": 124, "total": 10000, "remaining": 9876 },
  "rate_limit": {
    "limit": 10000,
    "remaining": 9876,
    "reset": 1793491200,
    "used": 124,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Bir limite ulaştığınızda

Her iki limit de HTTP 429 durum kodu ve bir hata gövdesiyle yanıt verir:

• 104 too_many_requests: geçerli dakika içinde çok fazla istek gönderildi. Yanıt, beklemeniz gereken saniye sayısını içeren bir Retry-After header'ı içerir. İstek hızınızı düşürün ve yeniden deneyin.
• 105 quota_exceeded: aylık kota tükendi. Kota ayın 1'inde (UTC) sıfırlanana kadar istekler başarısız olmaya devam eder. Planınızı yükseltmek hemen geçerli olur.

{
  "success": false,
  "error": {
    "code": 105,
    "type": "quota_exceeded",
    "info": "User has reached or exceeded his subscription plan's monthly API request allowance"
  }
}

Kotanızın içinde kalmak

• Yanıtları en az planınızın güncelleme aralığı kadar önbelleğe alın.
• Her sembol için ayrı bir çağrı yapmak yerine ihtiyacınız olan tüm sembolleri tek bir çağrıda isteyin.
• 10 dakikada bir sorgulama ayda yaklaşık 4.500 istek, dakikada bir sorgulama ise yaklaşık 45.000 istek kullanır. Sorgulama sıklığınıza uygun planı seçin.
• Pro ve üzeri planlarda sorgulama yerine gerçek zamanlı akışı kullanın ve eşik değerlerine tepki vermek için fiyat alarmlarından yararlanın.

Daha fazla ipucu için En iyi uygulamalar rehberine bakın.