کوینکس با راهاندازی برنامه همکاری «کارگزار API»، به دنبال برآوردن نیازهای معاملاتی مختلف کاربران سراسر جهان است.
مشتریان زیر میتوانند کارگزار کوینکس بشوند:
- صرافیها
- رباتهای معاملاتی
- پلتفرمهای مدیریت دارایی
- ارائهدهندگان کیفپول
- گروه های تریدر
امتیازات ویژه کارگزاران کوینکس عبارتاند از:
- نرخ کمیسیون برای همه کارگزاران از 40% شروع میشود.
- دوره 3 ماهه کمیسیون بیقیدوشرط برای کارگزاران جدید.
- دسترسی به نقدینگی و عمق کل بازار پلتفرم کوینکس
- بهرهمندی از سیستمهای مدیریت ریسک و پشتیبانی فنی قوی کوینکس.
کارگزار API شوید
- با استفاده از سرویس API یکپارچه کوینکس، طی چند مرحله، میتوانید خدمات معاملاتی کوینکس را بهطور یکپارچه در دسترس مشتریانتان قرار دهید.
- پلتفرم کوینکس، کارگزاران و کاربران همگی از طریق اتصال کلیدهای API کار میکنند. هر کارگزار شناسه کارگزاری منحصربهفردی را دریافت میکند. کارگزار سفارشات کاربری که تحت نظرش معامله میکند را با استفاده از کلید API کاربر و با شناسه کارگزاری خودش به دفترچه سفارشات کوینکس ارسال میکند و از کمیسیون های ناشی از کارمزد معاملات سفارشات مربوطه بهرهمند میشود.
1. درخواست برای کارگزاری کوینکس
(1) وارد حساب کاربریتان در کوینکس شوید و به صفحه کارگزار بروید. برای تکمیل فرم درخواست کارگزاری اینجا را کلیک کنید >>
(2) پس از ارسال فرم درخواست، درخواستتان را طی 3 الی 5 روز کاری بررسی خواهیم کرد. درصورتیکه درخواستتان پس از بررسی تأیید شود، مدیر پشتیبانی منحصر به خودتان برای تکمیل درخواستتان با شما تماس خواهد گرفت.
2. ضوابط کمیسیون
(1) کمیسیون ها بر اساس حجم معاملات کاربر در برنامه کارگزار با احتساب فعالیت معاملاتی حقیقی و نرخ کمیسیون محاسبه می شوند.
(2) قاعده کمیسیون: نرخ مشخصی از کمیسیون ها بابت معاملات اسپات/فیوچرز صورت گرفته از طریق API کوینکس به کارگزار تعلق خواهد گرفت.
(3) دامنه کمیسیون:
- معاملات اجرا شده از طریق API کوینکس واجد شرایط دریافت کمیسیون هستند. معاملات دستی صورت گرفته در کوینکس واجد شرایط نیستند.
- به تراکنش های بازار CET کمیسیونی تعلق نمی گیرد (برای مثال CETUSDT و CETUSDC و CETBTC). پنجاه درصد از کارمزد حاصل از معاملات سایر بازارهای AMM به عنوان کمیسیون ذخیره می شوند.
- اگر یک کاربر تریدر توسط سفیر کوینکس معرفی شده باشد، کمیسیون هایی که بابت آن کاربر به کارگزار تعلق می گیرند، نصف خواهند شد.
(4) زمان تسویه: کمیسیون های کارگزاران به صورت روزانه تسویه شده و بین ساعت 04:30 تا 06:30 به حساب اسپات کارگزار منتقل خواهند شد. زمان دقیق انتقال مشروط به بروزرسانی های پلتفرم است.
رویههای یکپارچهسازی کارگزار
1. استفاده از API عمومی کوینکس برای ادغام
1) فهرست اندپوینت ها
Spot
POST /spot/order
POST /spot/stop-order
Futures
POST /futures/order
POST /futures/stop-order
ملاحظات: broker_id برای سایر اندپوینت ها لازم نیست. لطفا دستورالعمل های مستندات Public API را دنبال کنید.
2) Broker ID (شناسه کارگزار) را در قسمت client_id بنویسید و سفارش را ثبت کنید.
مثال:
Request
{
“market”: “CETUSDT”,
“market_type”: “SPOT”,
“side”: “buy”,
“type”: “limit”,
“amount”: “10000",
“price”: “1",
“client_id”: “x-2150937652-zlczpf54lgjsba”,
“is_hide”: true
}
کارگزار کوینکس اکنون از client_id پشتیبانی می کند. دستورالعمل های استفاده از آن اینجا ذکر شده است.
برای مثال: x-2150937652-zlczpf54lgjsba
- Client_id باید با "x-" شروع شود و بعد از آن Broker ID (شناسه کارگزار) و یک "-" دیگر نوشته شوند.
- آخرین قسمت آن شناسه تعریف شده توسط کاربر است که می توان آن را خالی گذاشت.
- Client_id نباید در مجموع بیشتر از 32 کاراکتر باشد.
- هنگام استفاده از اندپوینتی که به client_id نیاز دارد ضروری است client_id مذکور را به عنوان یک پارامتر کامل منتقل کنید. برش زدن آن باعث نامعتبر شدن client_id می شود.
برای جزئیات بیشتر در مورد کمیسیون، به صفحه کمیسیون کارگزار مراجعه کنید.
ویژگی Broker (کارگزار) از بازگرداندن نوع حساب و نام حساب فرعی کاربر پشتیبانی می کند.
Request parameter
None
Parameter Response
| پارامتر | نوع | توضیح |
| user_type | رشته (string) | NORMAL: کاربر معمولیSUB_ACCOUNT: حساب فرعی |
| sub_user_name | رشته (string) | نام حساب فرعی. اگر کاربر معمولی باشد، خالی (blank) خواهد بود. |
2. ایجاد و ارائه مجوز API برای کارگزاران یکپارچهشده با OAuth
(1) معرفی جریان کد مجوز
جریان کد مجوز از یکپارچهسازی با اپلیکیشنها و اپلیکیشنهای تحت وب پشتیبانی میکند و کاربران میتوانند وارد صفحه مجوز شوند.
وقتی اپلیکیشنی شخص ثالث به کد مجوز کاربری دسترسی پیدا کند، میتواند آن را به توکن دسترسی تبدیل و از این توکن برای فراخوانی OpenAPI کوینکس و دسترسی به منابع داده مجاز کاربر استفاده کند.
(2) معرفی کارگزار OAuth
- کاربران از طریق OAuth2 کوینکس تنها با یک کلیک میتوانند اجازه معامله در اپلیکیشنهای شخص ثالث را بدهند و کاربران نیازی به ارائه کلیدهای API یا رمز ورود به سیستم نخواهند داشت.
- در حال حاضر، کوینکس از مجوزهای مبتنی بر پروتکل OAuth2.0 با استفاده از جریان کد مجوز پشتیبانی میکند.
(3) آمادهسازی و مراحل یکپارچهسازی
- در وبسایت رسمی کوینکس ثبتنام و حساب کاربری ایجاد کنید. سپس، درخواست کارگزار شدن بدهید.
- قبل از یکپارچهسازی، باید درخواستی برای تبدیلشدن به کارگزار OAuth بدهید. یک مدیر حساب اختصاصی اسناد توسعه مربوطه را در اختیارتان قرار میدهد و تا راهاندازی کامل کمکتان میکند.
- پس از تأیید درخواستتان برای کارگزار شدن، اعلانی از طریق ایمیل حاوی شناسه مشتری (client_id) و گذرواژه مشتری (client_secret) دریافت خواهید کرد.
- برچسبی برای کمیسیون کارگزاریتان در نظر بگیرید. هنگام ارسال سفارش باید «شناسه_کارگزار» (broker_id) را برای دریافت کمیسیون در قسمت «شناسه_مشتری» (client_id) درج کنید.
سؤالات متداول درباره کارگزار
1. آیا کمیسیون های کارگزارهای جدید و قدیم هنگام ثبت سفارش متفاوت هستند؟
پاسخ: خیر، همه کاربران، اعم از کاربران جدید و قدیمی، میتوانند هنگام معامله از طریق API کمیسیون دریافت کنند.
2. الزامات کارگزار شدن چیست؟
پاسخ: اگر نیاز به دسترسی به نقدینگی و عمق بازار در کوینکس دارید و اگر میخواهید پرتفوی کریپتوی خود را با استفاده از فناوری کوینکس بسازید، میتوانید برای کارگزار شدن درخواست دهید.
3. نرخ کمیسیون برای کارگزاران کوینکس چقدر است؟
پاسخ: نرخ کمیسیون در کوینکس 40% است. برای دریافت نرخ کمیسیون های بیشتر، لطفاً با مدیر حسابتان تماس بگیرید.