ریٹ لیمٹنگ اور کوٹا

Smart Money API کی ریٹ لیمٹس، ہر سبسکرپشن ٹیئر کے روزانہ کوٹا، اور اپنے API استعمال کو زیادہ سے زیادہ کرنے کی اصلاح کی حکمت عملیوں کو سمجھیں۔

جائزہ

Smart Money API تمام صارفین کے لیے سروس کوالٹی اور انصاف کو یقینی بنانے کے لیے روزانہ درخواستوں کے کوٹا نافذ کرتا ہے۔ ہر سبسکرپشن ٹیئر میں ایک مختلف روزانہ حد شامل ہوتی ہے۔ جب آپ اپنے روزانہ کوٹا سے تجاوز کر جاتے ہیں، تو آپ کو 429 ٹو مینی ریکویسٹس کا ایرر ملتا ہے جب تک کہ آپ کا کوٹا مڈنائٹ UTC پر ری سیٹ نہیں ہو جاتا۔

ریٹ لیمٹس ہر API کی کے لیے لاگو ہوتی ہیں۔ ہر کی کا اپنا الگ کوٹا ہوتا ہے۔ آپ مختلف ایپلیکیشنز کے لیے متعدد کیز جنریٹ کر سکتے ہیں اور ہر ایک کے استعمال کی علیحدہ سے نگرانی کر سکتے ہیں۔

سبسکرپشن ٹیئر کے لحاظ سے کوٹا

ٹیئر روزانہ درخواستیں قیمت خصوصیات
مفت 20 درخواستیں/دن $0 BTC, ETH, SOL, فنڈنگ ریٹس، لیکویڈیشنز
ٹریڈر 400 درخواستیں/دن $29/مہینہ تمام علامات، وہیل پوزیشنز، OI ڈیٹا
پرو 4,000 درخواستیں/دن $79/مہینہ تصدیقی اسکورز، آن چین ڈیٹا، ویب ہکس
انٹرپرائز کسٹم کسٹم مختصر سپورٹ، کسٹم انٹیگریشنز

ریٹ لیمٹ رسپانس ہیڈرز

ہر API رسپانس میں آپ کے موجودہ کوٹا کی حیثیت کو ظاہر کرنے والے ہیڈرز شامل ہوتے ہیں:

HTTP ہیڈرز
X-Requests-Limit: 200 X-Requests-Remaining: 147 X-Requests-Reset: 1711116000 X-Requests-Reset-ISO: 2026-03-22T00:00:00Z
ہیڈر تفصیل
X-Requests-Limit روزانہ اجازت شدہ کل درخواستیں (مثلاً، ٹریڈر کے لیے 200)
X-Requests-Remaining موجودہ دن میں باقی درخواستیں
X-Requests-Reset یونکس ٹائم اسٹیمپ جب کوٹا ری سیٹ ہوتا ہے
X-Requests-Reset-ISO کوٹا ری سیٹ کے لیے ISO 8601 ٹائم اسٹیمپ

درخواستوں سے پہلے کوٹا چیک کرنا

پائتھون
import requests from datetime import datetime def check_quota_before_request(api_key): response = requests.head( "https://api.smartmoneyapi.com/v1/whales/events", headers={"Authorization": f"Bearer {api_key}"} ) limit = int(response.headers.get("X-Requests-Limit", 0)) remaining = int(response.headers.get("X-Requests-Remaining", 0)) reset_unix = int(response.headers.get("X-Requests-Reset", 0)) reset_time = datetime.fromtimestamp(reset_unix) percent_used = (limit - remaining) / limit * 100 print(f"Quota: {remaining}/{limit} requests ({percent_used:.1f}% used)") print(f"Resets at: {reset_time}") if remaining < 5: print("WARNING: Approaching quota limit!") return False return True # Check before making requests if check_quota_before_request("sk_live_abc123xyz789"): print("Safe to proceed with API calls")

روزانہ ریٹ ونڈو

ریٹ لیمٹس 24 گھنٹے کی رولنگ ونڈو پر کام کرتی ہیں۔ آپ کا کوٹا روزانہ مڈنائٹ UTC (00:00 UTC) پر ری سیٹ ہوتا ہے۔ عین ری سیٹ کا وقت X-Requests-Reset-ISO ہیڈر میں فراہم کیا جاتا ہے۔

مثال: ٹریڈر ٹیئر (400 درخواستیں/دن)

  • دن 1 (21 مارچ): 00:00 UTC پر 200 درخواستیں دستیاب
  • 10:30 UTC: 75 درخواستیں کیں، 125 باقی
  • 15:45 UTC: 100 مزید درخواستیں کیں، 25 باقی
  • 23:59 UTC: اب بھی 25 درخواستیں باقی (آگے نہیں لے جا سکتے)
  • دن 2 (22 مارچ، 00:00 UTC): کوٹا 200 پر ری سیٹ

اصلاح کی حکمت عملیاں

1. API رسپانسز کو کیش کریں

وہیل پوزیشنز ہر سیکنڈ میں تبدیل نہیں ہوتیں۔ نتائج کو 30-60 سیکنڈز کے لیے کیش کریں اور نئی API کالز کرنے کے بجائے کیش شدہ ڈیٹا فراہم کریں۔

پائتھون
import requests import time class CachedClient: def __init__(self, api_key, cache_ttl=60): self.api_key = api_key self.cache_ttl = cache_ttl self.cache = {} self.cache_time = {} def get_whale_positions(self, symbol): cache_key = f"whales:{symbol}" now = time.time() # Return cached data if still fresh if cache_key in self.cache: age = now - self.cache_time[cache_key] if age < self.cache_ttl: print(f"Served from cache (age: {age:.1f}s)") return self.cache[cache_key] # Fetch fresh data response = requests.get( f"https://api.smartmoneyapi.com/v1/whales/events?symbol={symbol}", headers={"Authorization": f"Bearer {self.api_key}"} ) data = response.json() self.cache[cache_key] = data self.cache_time[cache_key] = now return data # Usage: Cache for 60 seconds client = CachedClient("sk_live_abc123xyz789", cache_ttl=60) whales1 = client.get_whale_positions("BTCUSDT") # API call whales2 = client.get_whale_positions("BTCUSDT") # From cache whales3 = client.get_whale_positions("BTCUSDT") # From cache

2. ریئل ٹائم ڈیٹا کے لیے WebSocket استعمال کریں

WebSocket کنکشنز اپ ڈیٹس کو فوری طور پر فراہم کرتے ہیں اور آپ کی ریٹ لیمٹ کے خلاف شمار نہیں ہوتے۔ اسٹریمز کو سبسکرائب کریں اور اپ ڈیٹس کو جیسے ہی ہوں وصول کریں، جس سے REST API کالز کی تعداد کم ہو جاتی ہے۔

3. درخواستوں کو حکمت عملی سے بیچ کریں

جب ممکن ہو تو ہر علامت کے لیے الگ درخواستوں کے بجائے ایک درخواست میں متعدد علامات شامل کریں۔ اس سے API کالز 10x تک کم ہو جاتی ہیں۔

4. درخواست کے وقت فلٹرنگ استعمال کریں

فلٹرز (علامت، ایکسچینج، کم از کم پوزیشن سائز) کو کوئری پیرامیٹرز میں لاگو کریں تاکہ بالکل وہی ڈیٹا حاصل کریں جس کی آپ کو ضرورت ہے، پوسٹ پروسیسنگ کی ضرورت سے بچیں۔

ریٹ لیمٹ ایررز کو ہینڈل کرنا

ایکسپونینشل بیک آف کے ساتھ دوبارہ کوشش کریں

پائتھون
import requests import time def request_with_retry(url, api_key, max_retries=5): for attempt in range(max_retries): try: response = requests.get( url, headers={"Authorization": f"Bearer {api_key}"}, timeout=10 ) if response.status_code == 200: return response.json() elif response.status_code == 429: # Rate limited - back off exponentially wait_time = min(2 ** attempt, 300) # Max 5 minutes reset_time = response.headers.get("X-Requests-Reset-ISO") print(f"Rate limited. Retrying in {wait_time}s (resets at {reset_time})") time.sleep(wait_time) elif response.status_code >= 500: # Server error - retry wait_time = 2 ** attempt print(f"Server error {response.status_code}. Retrying in {wait_time}s") time.sleep(wait_time) else: # Other error - don't retry raise Exception(f"HTTP {response.status_code}: {response.text}") except requests.exceptions.Timeout: wait_time = 2 ** attempt print(f"Timeout. Retrying in {wait_time}s") time.sleep(wait_time) raise Exception("Max retries exceeded") # Usage data = request_with_retry( "https://api.smartmoneyapi.com/v1/whales/events", "sk_live_abc123xyz789" ) print(data)

اپ گریڈ کے لیے تیار ہیں؟

مفت ٹیئر کافی نہیں؟ ٹریڈر یا پرو میں اپ گریڈ کریں تاکہ زیادہ کوٹا اور تصدیقی اسکورز اور آن چین ڈیٹا جیسی اعلیٰ خصوصیات تک رسائی حاصل کریں۔

قیمت دیکھیں

آج ہی اپنا API استعمال بہتر بنائیں

کیشنگ لاگو کریں، ریئل ٹائم ڈیٹا کے لیے WebSocket استعمال کریں، اور ریٹ لیمٹس کو خوش اسلوبی سے ہینڈل کریں۔

دستاویزات پڑھیں
مفت شروع کریں — 100 کالز/دن، کوئی کارڈ نہیں

تین ایکسچینجز سے لائیو وہیل فلو، فنڈنگ، اوپن انٹرسٹ اور آن چین ڈیٹا کو ایک API سے حاصل کریں۔ مفت ٹیئر، کوئی کریڈٹ کارڈ نہیں، کسی بھی وقت اپ گریڈ کریں۔

مفت شروع کریں →
لائیو API کنسول آزمائیں → (اکاؤنٹ کی ضرورت نہیں)
30 سیکنڈز میں اپنا API کی حاصل کریں

بنانے کے لیے تیار ہیں؟ ایک مفت API کی حاصل کریں (100 کالز/دن، کوئی کارڈ نہیں) اور لائیو وہیل، فنڈنگ اور آن چین ڈیٹا کو کھینچنا شروع کریں۔

اپنا API کی حاصل کریں →