برای اتصال حساب صرافی به یک ربات معامله‌گر یا سرویس کپی ترید به کلید API نیاز دارید. کلید API مثل یک کارت دسترسی محدود است: اگر درست ساخته شود، سرویس فقط می‌تواند سفارش ثبت کند و هیچ راهی برای برداشت پول ندارد. در این راهنما اصول ساخت کلید امن و تنظیمات هر صرافی را مرور می‌کنیم.
چهار قانون طلایی
- دسترسی برداشت (Withdraw) را هرگز فعال نکنید. هیچ سرویس معاملاتی برای کار کردن به برداشت نیاز ندارد.
- فقط دسترسی خواندن و معامله (Read + Trade) برای بازار فیوچرز کافی است.
- کلید را به IP سرور محدود کنید. با این کار حتی اگر کلید لو برود، از جای دیگری قابل استفاده نیست.
- برای هر سرویس یک کلید جدا بسازید تا در صورت نیاز فقط همان را حذف کنید.
حالت یک‌طرفه (One-way mode)
بیشتر ربات‌های معاملاتی در حالت یک‌طرفه کار می‌کنند؛ یعنی در هر نماد فقط یک پوزیشن خرید یا فروش باز است. اگر حساب شما در حالت دوطرفه (Hedge) باشد، ممکن است سفارش‌ها رد شوند. قبل از اتصال، حالت پوزیشن را در تنظیمات فیوچرز بررسی کنید.
بایننس (Binance)
مسیر: API Management ← Create API. پس از ساخت کلید، گزینه‌ی Enable Futures را فعال کنید، دسترسی برداشت را خاموش بگذارید و کلید را به IP سرور محدود کنید. حالت پوزیشن را روی One-way قرار دهید.
بای‌بیت (Bybit)
مسیر: API ← Create New Key ← System-generated. نوع Read-Write را انتخاب کنید و در بخش Contract فقط Orders و Positions را فعال کنید. Withdraw را فعال نکنید و کلید را به IP محدود کنید. حساب باید Unified Trading Account و در حالت یک‌طرفه باشد.
او‌کی‌ایکس (OKX)
مسیر: Profile ← API keys ← Create V5 key. دسترسی‌های Read و Trade کافی است و Withdraw نباید فعال باشد. OKX علاوه بر کلید و رمز، یک Passphrase هم می‌خواهد که هنگام ساخت کلید تعیین می‌کنید. حالت حساب باید حداقل Single-currency margin و حالت پوزیشن Net (یک‌طرفه) باشد.
بیت‌گت و گیت (Bitget و Gate.io)
در بیت‌گت از بخش API Management یک کلید با دسترسی خواندن و معامله‌ی فیوچرز بسازید و آن را به IP محدود کنید. در گیت یک کلید APIv4 با دسترسی Perpetual futures (read + trade) بسازید، برداشت را غیرفعال کنید و IP سرور را در فهرست سفید قرار دهید. حالت پوزیشن باید Single (یک‌طرفه) باشد.
هایپرلیکوئید (Hyperliquid)
هایپرلیکوئید یک صرافی غیرمتمرکز است و به‌جای کلید API از API Wallet استفاده می‌کند:
- در app.hyperliquid.xyz به بخش More ← API بروید.
- یک API Wallet بسازید و آن را Authorise کنید.
- آدرس حساب اصلی و کلید خصوصی API Wallet را در سرویس وارد کنید.
هرگز کلید خصوصی کیف‌پول اصلی خود را وارد هیچ سرویسی نکنید. API Wallet می‌تواند معامله کند اما توانایی برداشت ندارد؛ این مهم‌ترین تفاوت آن با کیف‌پول اصلی است.
بعد از ساخت کلید
- کلید را در سرویس وارد و تست اتصال را اجرا کنید. یک تست خوب موجودی، دسترسی‌های کلید و اطلاعات بازار مثل قیمت خرید و فروش، حداقل سفارش و کارمزد را بررسی می‌کند.
- اگر کلید را دیگر لازم ندارید، آن را هم در سرویس و هم در صرافی حذف کنید.
- کلید و رمز را در پیام‌رسان یا ایمیل برای کسی ارسال نکنید.
امنیت کلیدها در یانکی
در یانکی کلیدها پیش از ذخیره با AES-256-GCM رمزگذاری می‌شوند، پس از ذخیره دیگر نمایش داده نمی‌شوند و فقط موتور معاملاتی آن‌ها را برای ثبت سفارش باز می‌کند. پس از وارد کردن کلید، تست اتصال موجودی، دسترسی‌ها و شرایط بازار صرافی را بررسی می‌کند تا سفارش‌ها با قیمت و اندازه‌ای ثبت شوند که صرافی می‌پذیرد. برای شروع وارد پنل شوید و مقاله‌ی کپی ترید چیست؟ را هم بخوانید.
