Rate limit
rate limit تعداد درخواستهایی را که کلاینت میتواند در واحد زمان به یک API بفرستد محدود میکند. با عبور از حد، سرور با 429 Too Many Requests که در RFC 6585 تعریف شده پاسخ میدهد و ممکن است هدر Retry-After را بیفزاید که میگوید چند ثانیه صبر کنید (خطای HTTP 429).
نرخ و سهمیه
معمولاً دو محدودیت وجود دارد: نرخ (درخواست در ثانیه یا دقیقه) و سهمیه (فراخوانی در روز یا ماه). در Genesis API هر دو به پلن بستگی دارند:
| پلن | درخواست در ثانیه | فراخوانی در 30 روز | سهمیه با نرخ کامل میماند |
|---|---|---|---|
| Trial | 1 | 500K | 5.8 روز |
| Start | 2 | 2M | 11.6 روز |
| Pro | 5 | 5M | 11.6 روز |
| Max | 15 | 10M | 7.7 روز |
ستون آخر درخواستهای بیوقفه با نرخ حداکثر و 200 برای هر پاسخ را فرض میکند. برای Pro: 5 × 86,400 = 432,000 درخواست در روز و 5,000,000 / 432,000 ≈ 11.6 روز. حد در ثانیه سقف رگبارهاست و سهمیه آهنگ میانگین را تعیین میکند: 30 روز شامل 2,592,000 ثانیه است، پس Pro میانگین 5,000,000 / 2,592,000 ≈ 1.93 درخواست در ثانیه را تاب میآورد.
فقط پاسخهای 200 از سهمیه کم میکنند؛ پاسخهای 304 و خطاها کم نمیکنند، اما در حد درخواست در ثانیه شمرده میشوند. حجم دانلود جداگانه محدود است: 60 مگابایت داده فشرده در هر 10 ثانیه برای هر کلید و بیش از آن 429 download_limited میگیرد.
چگونه در حد بمانیم
هر پاسخ Genesis API وضعیت محدودیت را در هدرها اعلام میکند:
| هدر | چه نشان میدهد |
|---|---|
X-RateLimit-Limit | حد درخواست در ثانیهٔ پلن شما |
X-RateLimit-Remaining | درخواستهای باقیمانده در پنجرهٔ فعلی |
X-RateLimit-Reset | زمان unix بازنشانی پنجره |
Retry-After | ثانیههای انتظار پیش از تلاش دوباره (با 429 و 503) |
سهمیه در X-Quota-Limit، X-Quota-Remaining، X-Quota-Reset و endpoint مصرف یعنی /account/usage دیده میشود. کد زیر سه endpoint را پشت سر هم polling میکند: وقتی پنجره درخواست باقی ندارد خودش تا X-RateLimit-Reset صبر میکند و با 429 و 503 به اندازهٔ Retry-After مکث میکند.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PATHS = ("/arbitrage/spot-spot", "/funding/spread",
"/market/open-interest")
def poll_once():
for path in PATHS:
r = requests.get(BASE + path, headers=HEADERS, timeout=10)
if r.status_code in (429, 503):
# سرور مکث میخواهد؛ دور بعد دوباره تلاش میکند
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "ردیفها:", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# پنجره تمام شد: بهجای 429 تا بازنشانی صبر کن
reset = int(r.headers.get("X-RateLimit-Reset", "0"))
time.sleep(max(0.0, reset - time.time()))
while True:
poll_once()
time.sleep(10) # تازگی Pro: polling سریعتر چیزی اضافه نمیکند
همچنین ببینید: polling در API، تازگی داده، پلنها و محدودیتها، محدودیتهای Genesis API، چگونه بدون رسیدن به حد، API را polling کنیم.
پرسش و پاسخ
وقتی سهمیهٔ ماهانه تمام شود چه میشود؟
درخواستهای بیش از سهمیه هرگز پولی حساب نمیشوند. تا بازنشانی صبر کنید (زمانش در X-Quota-Reset است) یا به پلن بالاتر بروید: پلن جدید بلافاصله اعمال میشود، سهمیه از صفر شروع میشود و باقیماندهٔ پلن قبلی از بین میرود.
میتوانم با کلید دوم از حد عبور کنم؟
نه. هر حساب یک کلید دارد و استفاده از چند حساب یا چرخاندن IP برای دور زدن حد قواعد را نقض میکند. اگر فراخوانی کم میآورید، موارد غیرضروری را با فیلترها، پارامتر coin و ETag همراه If-None-Match کم کنید یا به پلن بالاتر بروید.