باب 56: API Management — خودکار ٹریڈنگ کا دروازہ

API (Application Programming Interface) ایک پروگراماتی دروازہ ہے جس کے ذریعے آپ کا کوڈ (یا تھرڈ پارٹی ٹول) براہِ راست بائننس سے بات کر سکتا ہے — آرڈر لگانا، بیلنس دیکھنا، مارکیٹ ڈیٹا لانا۔ یہ طاقتور ہے، مگر ایک غلطی مہنگی ہو سکتی ہے، کیونکہ API Key سے خودکار آرڈرز چلتے ہیں۔

📖 56.1 API کیسے کام کرتا ہے؟

آپ کا کوڈ/بوٹ  →  API Key + Secret (دستخطی توثیق)  →  بائننس سرور
                        ↑
              read / trade / (withdraw آف)

• API Key: عوامی شناخت (Public ID) — لاگ/شناخت کے لیے۔
• Secret Key: خفیہ چابی — صرف ایک بار دکھائی جاتی ہے؛ یہی دستخط بناتی ہے۔
• ہر Request پر دستخط (Signature) لگتا ہے، اسی لیے Secret ہرگز شیئر نہ کریں۔

📖 56.2 اجازتیں (Permissions) — کم سے کم اصول

API Management → Create API
   □ Enable Reading          (مارکیٹ/بیلنس پڑھنا)
   □ Enable Spot Trading     (Spot آرڈرز)
   □ Enable Margin Trading
   □ Enable Futures          (Futures آرڈرز)
   □ Enable Withdrawals      ← عموماً ہرگز نہ دیں

اصول: جو اجازت ضروری نہ ہو، آف رکھیں۔ Withdrawals API کے لیے عموماً آن نہ کریں — اگر Key لیک ہو تو صرف ٹریڈ کرے گا، فنڈز نکال نہیں سکے گا۔

📖 56.3 IP Whitelist — سب سے اہم تحفّظ

API پر صرف مخصوص IP پتے شامل کریں:
Server IP (VPS) یا اپنا اسٹیٹک IP
    → دوسرے کسی IP سے Key کام نہیں کرے گی

• اگر آپ کا IP غیر مستحکم (Dynamic) ہے تو VPS استعمال کریں۔
• Whitelist کے بغیر Key کہیں سے بھی استعمال ہو سکتی ہے — خطرہ بہت زیادہ۔
• کلید لیک ہو جائے تو Whitelist آخری دفاع ہے۔

📖 56.4 Rate Limits اور عام غلطیاں

بائننس API کی حدود:
- Request Weight per minute
- Order rate limits
- Error codes: -1003 (Too many requests)، -1021 (Timestamp)

• بہت تیز لوپ = IP بین (عارضی)
• Server Time سے گھڑی میلی: timestamp درست رکھیں (NTP)
• 429/418 کا مطلب Rate limit — backoff کے ساتھ دوبارہ کوشش

📖 56.5 حفاظتی اصول

✅ Secret Key صرف ایک مرتبہ — فائل/میپ ورژن میں محفوظ کریں
✅ Withdrawals اجازت آف
✅ IP Whitelist لازمی
✅ الگ API Key ہر بوٹ/حکمت عملی کے لیے
✅ غیر استعمال شدہ Key فوراً Delete
✅ کلید کبھی GitHub/پیپر/اسکرین شاٹ میں نہ ڈالیں
✅ رجسٹرڈ ای میل/2FA محفوظ رکھیں