BuyCrypt
للمطورين ومساعدي الذكاء الاصطناعي

API لروبوتات التداول وMCP للذكاء الاصطناعي

الروبوت المكتوب لـ Binance USD-M Futures يعمل على حساب BuyCrypt التجريبي دون إعادة كتابة: يتغير عنوان API فقط. ومن خلال خادم MCP الخاص بـ BuyCrypt يرى Claude وChatGPT وCursor البطولات وتصنيف المتداولين وحسابك التجريبي.

سطر واحدفي كود الروبوت: base URL مختلف
500+عقدًا دائمًا بعملة USDT
9أدوات MCP، وكلها للقراءة فقط
api.buycrypt.comاستجابة حية
GET https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT
{ "symbol": "BTCUSDT", "price": "…" }
# روبوتك على Binance USD-M Futures
- base_url="https://fapi.binance.com"
+ base_url="https://api.buycrypt.com"
طريقتان للربط

الروبوت يتداول. والمساعد يجيب عن الأسئلة.

API لروبوتات التداول

صيغة الطلبات والتوقيعات والاستجابات مثل Binance USD-M Futures. يضع الروبوت الأوامر على حسابك التجريبي في BuyCrypt: الأسعار سوقية، والأموال تجريبية.

  • المكتبات نفسها: binance-futures-connector أو كودك الخاص على requests
  • REST وWebSocket خاص عبر listenKey، والشموع وسعر العلامة في البث
  • يُنشأ المفتاح في التطبيق ويعمل مع حساب تجريبي واحد فقط
توثيق API ←

MCP لمساعدي الذكاء الاصطناعي

عنوان واحد في إعدادات Claude أو ChatGPT أو Cursor، ويجلب المساعد بيانات BuyCrypt بنفسه حين تسأله عنها.

  • البطولات والجوائز وجدول المشاركين والمتصدرون حسب العملة
  • جواز سفر المتداول: التصنيف من 1000، والمستوى، وأسلوب التداول
  • حسابك التجريبي: الرصيد والمراكز والأوامر (بمفتاح للقراءة فقط)
اربطه في دقيقة ←
MCP · Model Context Protocol

MCP: اربط BuyCrypt بـ Claude وChatGPT وCursor

MCP معيار مفتوح يربط به مساعدو الذكاء الاصطناعي البيانات والأدوات الخارجية. يزوّد خادم BuyCrypt المساعد ببيانات المنصة الحية. لا حاجة إلى تسجيل ولا مفتاح، فالمفتاح يلزم فقط لحسابك التجريبي.

https://buycrypt.com/mcp
Streamable HTTPبلا تسجيل دخولقراءة فقط
  1. افتح claude.ai أو تطبيق Claude Desktop ← Customize → Connectors.
  2. اضغط + Add ← Add custom connector.
  3. الاسم BuyCrypt، والعنوان https://buycrypt.com/mcp، ثم Continue.
  4. في قسم Authentication اختر No sign in واضغط Add.

الموصِّلات المخصصة متاحة في كل خطط Claude، وفي الخطة المجانية موصِّل واحد. في فرق Team وEnterprise يضيف الموصِّل مالكُ المؤسسة من Organization settings → Connectors. ولحسابك التجريبي أضف المفتاح في قسم Request headers في النافذة نفسها — طريقة ذلك.

  1. نفّذ أمرًا واحدًا في الطرفية:
Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp

التحقق: claude mcp list — سيظهر buycrypt في القائمة. أضف --scope user ليكون الخادم متاحًا في كل المشاريع.

  1. افتح chatgpt.com/plugins في المتصفح.
  2. اضغط + ← Add custom MCP server.
  3. الاسم BuyCrypt، وفي قسم Connection اختر العنوان العام وأدخل https://buycrypt.com/mcp.
  4. في Authentication اختر No authentication. أكّد التحذير I understand and want to continue واضغط Create.

لا تُضاف خوادم MCP المخصصة في ChatGPT إلا من نسخة الويب، وهي غير متاحة في كل الخطط. إن لم تجد الخيار، فقد أغلقته خطتك أو مسؤول مساحة العمل. ولا يمكن ربط حسابك التجريبي في ChatGPT لأنه لا يمرّر المفاتيح إلى الخادم؛ لذلك استخدم Claude أو Claude Code أو Cursor.

أضف إلى Cursor

يفتح الزر Cursor بإعداد جاهز. أو يدويًا: أضف إلى ~/.cursor/mcp.json (لكل المشاريع) أو إلى .cursor/mcp.json في جذر المشروع:

mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp"
    }
  }
}

يصلح أي عميل يدعم Streamable HTTP: أدخل العنوان https://buycrypt.com/mcp، ولا حاجة إلى تفويض. وإذا كان العميل لا يشغّل إلا الخوادم المحلية (stdio)، فاربطه عبر الجسر mcp-remote، ويلزم Node.js:

claude_desktop_config.json وما يشبهه
{
  "mcpServers": {
    "buycrypt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://buycrypt.com/mcp"]
    }
  }
}

تحقّق من الخادم دون مساعد: npx @modelcontextprotocol/inspector --cli https://buycrypt.com/mcp --transport http --method tools/list

ماذا يستطيع الخادم

platform_overview

ما البطولات الجارية الآن، وأيها تنطلق تاليًا، وكم متداولًا في البطولات، وآخر الجوائز.

بلا مفتاح
list_tournaments

البطولات الجارية والقادمة والمنتهية: العملة، وطريقة الاحتساب، ومجموع الجوائز، والدخول، والمشاركون.

بلا مفتاح
get_tournament

بطولة واحدة: الجوائز حسب المراكز وجدول المشاركين بنتائجهم.

بلا مفتاح
leaderboard

المتصدرون حسب العملة خلال 7 أو 30 أو 90 يومًا — كما في صفحة «أفضل المتداولين».

بلا مفتاح
trader_profile

جواز سفر المتداول حسب الاسم المستعار: التصنيف من 1000، والمستوى، وأجزاء التقييم الخمسة، والأسلوب. الملفات العامة فقط.

بلا مفتاح
market_ticker

السعر والتغير خلال 24 ساعة لعقد دائم، مثل BTCUSDT.

بلا مفتاح
demo_account

الرصيد والهامش والمراكز المفتوحة في حسابك التجريبي.

مفتاحك
demo_open_orders

الأوامر المفتوحة في حسابك التجريبي.

مفتاحك
demo_recent_results

آخر نتائج الحساب التجريبي: ربح الصفقات المغلقة وخسارتها، والعمولات.

مفتاحك

لا تضع أي أداة أوامر، ولا تنضم إلى بطولات، ولا تحوّل أموالًا — الخادم يقرأ فقط.

ماذا تسأل المساعد

اضغط على السؤال لنسخه.

مثال حي

هكذا يرى المساعد BuyCrypt

أدناه استجابة حقيقية من الخادم https://buycrypt.com/mcp في هذه اللحظة. يتلقى المساعد البيانات نفسها ويعيد صياغتها بكلماته.

اعرض أفضل 5 متداولين لهذا الشهر في BTC
المساعد يستدعي leaderboard{"coin":"BTC","period_days":30,"limit":5}
جارٍ تحميل استجابة الخادم…
بمفتاحك

حسابك التجريبي في المساعد

تقرأ الأدوات demo_account وdemo_open_orders وdemo_recent_results حسابك التجريبي. ولهذا يرسل العميل مفتاح API الخاص بك إلى الخادم في ترويستين: X-BuyCrypt-Api-Key وX-BuyCrypt-Api-Secret. أنشئ للمساعد مفتاحًا للقراءة فقط: يرى الرصيد والمراكز والأوامر، لكن BuyCrypt لن ينفّذ به أي أمر أو إلغاء أو تغيير للرافعة المالية (الاستجابة 403). طريقة الحصول عليه.

Terminal
claude mcp add --transport http buycrypt https://buycrypt.com/mcp \
  --header "X-BuyCrypt-Api-Key: YOUR_API_KEY" \
  --header "X-BuyCrypt-Api-Secret: YOUR_API_SECRET"
mcp.json
{
  "mcpServers": {
    "buycrypt": {
      "url": "https://buycrypt.com/mcp",
      "headers": {
        "X-BuyCrypt-Api-Key": "YOUR_API_KEY",
        "X-BuyCrypt-Api-Secret": "YOUR_API_SECRET"
      }
    }
  }
}
  1. عند إضافة الموصِّل (Customize → Connectors → Add custom connector) اختر بعد العنوان No sign in.
  2. في قسم Request headers أضف ترويستين: X-BuyCrypt-Api-Key وX-BuyCrypt-Api-Secret بقيمك.
  3. اضغط Add. إذا كان الموصِّل مضافًا من قبل بلا مفتاح، فاحذفه وأضفه من جديد بالترويستين.

قراءة فقط

لا يضع خادم MCP الأوامر ولا يلغيها. يحتاج إلى المفتاح لقراءة الرصيد والمراكز والأوامر فقط. والمفتاح المخصص للقراءة فقط لا يتيح التداول حتى لو وقع في يد غيرك.

حساب تجريبي واحد

يعمل مفتاح BuyCrypt فقط مع الحساب التجريبي الذي أُنشئ له، ولا يمنح أي وصول إلى حسابات المنصات الحقيقية.

مفتاح منفصل

أنشئ للمساعد مفتاحًا منفصلًا للقراءة فقط. يُرسَل المفتاح إلى buycrypt.com فقط، ولا يحفظه الخادم ولا يدوّنه في السجلات. ويمكنك إبطاله من المكان نفسه الذي أنشأته فيه.

API لروبوتات التداول

API متوافق مع Binance USD-M Futures

المسارات وتوقيع HMAC-SHA256 والمعاملات وصيغة الاستجابات مثل Binance USD-M Futures. والفرق الوحيد أن الأوامر تُنفَّذ على حسابك التجريبي في BuyCrypt بأسعار السوق، ولا تذهب إلى منصة حقيقية. هكذا تختبر الاستراتيجية في السوق دون المخاطرة بالمال.

كيف تبدأ

  1. الحساب. سجّل الدخول إلى منصة الويب أو تطبيق BuyCrypt عبر Google أو Apple. سيظهر الحساب التجريبي فورًا.
  2. المفتاح. في منصة الويب أو التطبيق: الملف الشخصي ← مفاتيح API ← حسابك التجريبي ← قسم Bot API keys ← Generate API key. انسخ apiKey وapiSecret: السر يظهر مرة واحدة فقط. ولمساعد الذكاء الاصطناعي أو المراقبة، يوجد في منصة الويب زر Generate read-only key (for MCP).
  3. العنوان. في مكتبتك أدخل https://api.buycrypt.com بدل https://fapi.binance.com. تبقى المسارات /fapi/v1/… كما هي.
  4. التحقق. اطلب الرصيد عبر GET /fapi/v2/balance: ستجد في الاستجابة رصيد USDT في حسابك التجريبي.

ما يجب معرفته

  • عقود USDT فقط ووضع المركز الواحد (one-way)؛ وضع التحوّط غير مدعوم.
  • سعر المؤشر عبر /fapi/v1/ticker/price. أما المسار /fapi/v2/ticker/price الذي تستدعيه الإصدارات الحديثة من المكتبات فغير مدعوم بعد.
  • في البث العام تصل الشموع @kline_1m (كل 5 ثوانٍ) و@markPrice (كل ثانية).
  • recvWindow افتراضيًا 5,000 مللي ثانية، وحتى 60,000 مللي ثانية. زامِن الساعة عبر /fapi/v1/time.
  • يحصل الحساب الذي يملك مفتاح API للتداول على شارة 🤖 في تصنيف التطبيق، فيرى الجميع أن برنامجًا هو الذي يتداول.
  • صلاحيات المفتاح: المفتاح العادي (READ_TRADE) يقرأ ويتداول، أما مفتاح القراءة فقط (READ) فيقتصر على طلبات GET وlistenKey. وأي طلب أمر أو إلغاء أو تغيير للرافعة المالية أو الهامش به يُرَدّ عليه بـ HTTP 403 والرمز -2015.
pip install binance-futures-connector
import os
from binance.um_futures import UMFutures

client = UMFutures(
    key=os.environ["BUYCRYPT_API_KEY"],        # key from the BuyCrypt app
    secret=os.environ["BUYCRYPT_API_SECRET"],
    base_url="https://api.buycrypt.com",      # the only line that changes
)

print(client.balance())                             # demo account USDT
client.change_leverage(symbol="BTCUSDT", leverage=5)
order = client.new_order(symbol="BTCUSDT", side="BUY", type="MARKET", quantity=0.002)
print(order["orderId"], order["status"])
print(client.get_position_risk(symbol="BTCUSDT"))
pip install requests
import hashlib, hmac, os, time, urllib.parse, requests

API = "https://api.buycrypt.com"
KEY = os.environ["BUYCRYPT_API_KEY"]
SECRET = os.environ["BUYCRYPT_API_SECRET"]

def signed(method, path, **params):
    params["timestamp"] = int(time.time() * 1000)
    query = urllib.parse.urlencode(params)
    sig = hmac.new(SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
    r = requests.request(method, f"{API}{path}?{query}&signature={sig}",
                         headers={"X-MBX-APIKEY": KEY}, timeout=10)
    r.raise_for_status()
    return r.json()

print(signed("GET", "/fapi/v2/balance"))
print(signed("POST", "/fapi/v1/order", symbol="BTCUSDT", side="BUY",
             type="LIMIT", timeInForce="GTC", quantity=0.002, price=60000))
bash, openssl
# public data, no key
curl "https://api.buycrypt.com/fapi/v1/ticker/price?symbol=BTCUSDT"
curl "https://api.buycrypt.com/fapi/v1/klines?symbol=ETHUSDT&interval=1h&limit=3"

# demo account balance, signed request
KEY="YOUR_API_KEY"; SECRET="YOUR_API_SECRET"
Q="timestamp=$(date +%s)000"
SIG=$(printf '%s' "$Q" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
curl -H "X-MBX-APIKEY: $KEY" "https://api.buycrypt.com/fapi/v2/balance?$Q&signature=$SIG"

الطرق

العنوان الأساسي لـ REST هو https://api.buycrypt.com. تتطلب الطرق الموقّعة الترويسة X-MBX-APIKEY وtimestamp وsignature.

بيانات السوق بلا مفتاح
GET/fapi/v1/ping · /fapi/v1/timeفحص الاتصال ووقت الخادم بالمللي ثانية.
GET/fapi/v1/exchangeInfoالعقود ومرشّحات السعر والكمية والحدود.
GET/fapi/v1/ticker/price · /ticker/24hr · /ticker/bookTickerآخر سعر، وإحصاءات 24 ساعة، وأفضل أسعار الشراء والبيع.
GET/fapi/v1/depth · /fapi/v1/klinesدفتر الأوامر والشموع.
GET/fapi/v1/premiumIndex · /fapi/v1/fundingRateسعر العلامة والمؤشر ومعدل التمويل.
الحساب والمراكز موقّعة
GET/fapi/v2/account · /fapi/v3/accountالرصيد والهامش والمراكز في استجابة واحدة (v1 وv2 وv3 متطابقة).
GET/fapi/v2/balance · /fapi/v3/balanceرصيد الحساب التجريبي، USDT فقط.
GET/fapi/v2/positionRisk · /fapi/v3/positionRiskالمراكز المفتوحة: سعر الدخول، وسعر العلامة، والنتيجة غير المحققة، وسعر التصفية.
GET/fapi/v1/userTrades · /fapi/v1/incomeالصفقات حسب الرمز وسجل النتائج: الربح والخسارة، والعمولات.
GET/fapi/v1/commissionRate · /fapi/v1/leverageBracketالعمولة حسب الرمز ومستويات الرافعة المالية.
التداول موقّعة
POST/fapi/v1/orderأمر جديد: MARKET وLIMIT وSTOP وSTOP_MARKET وTAKE_PROFIT وTAKE_PROFIT_MARKET وTRAILING_STOP_MARKET؛ وreduceOnly وclosePosition وtimeInForce وnewClientOrderId.
GET/fapi/v1/order · /openOrders · /allOrdersأمر واحد، والأوامر المفتوحة، والسجل.
PUT/fapi/v1/orderتعديل أمر محدد.
DELETE/fapi/v1/order · /allOpenOrdersإلغاء أمر واحد أو كل الأوامر على رمز.
POST/fapi/v1/batchOrdersعدة أوامر في طلب واحد؛ وDELETE للإلغاء بقائمة.
POST/fapi/v1/algoOrderالأوامر المشروطة (الوقف وجني الأرباح والوقف المتحرك)؛ وGET /openAlgoOrders و/allAlgoOrders وDELETE /algoOrder و/algoOpenOrders.
POST/fapi/v1/leverage · /fapi/v1/marginTypeالرافعة المالية ونوع الهامش حسب الرمز.
GET/fapi/v1/positionSide/dualدائمًا dualSidePosition: false — وضع المركز الواحد.
تدفقات WebSocket
POST/fapi/v1/listenKeyمفتاح التدفق الخاص لمدة 60 دقيقة؛ PUT يمدّده وDELETE يغلقه.
WSwss://api.buycrypt.com/fapi/ws/<listenKey>أحداث حسابك: ORDER_TRADE_UPDATE وACCOUNT_UPDATE وMARGIN_CALL — بصيغة Binance.
WSwss://api.buycrypt.com/fapi/ws-market/btcusdt@markPriceتدفق عام لسوق واحدة: @markPrice و@kline_1m.
WSwss://api.buycrypt.com/stream?streams=btcusdt@markPrice/ethusdt@kline_1mعدة تدفقات في اتصال واحد، والاستجابات مغلّفة بـ {"stream", "data"}.
الحدود والأخطاء
1 دقيقةوزن 2,400 · ‏1,200 قراءة موقّعةلكل مفتاح API. وفي الاستجابات الترويستان X-MBX-USED-WEIGHT-1M وX-MBX-ORDER-COUNT-10S.
10 ثوانٍ300 أمرعند التجاوز: HTTP 429 وRetry-After.
ERR-1021 · -1022 · -2014 · -2015الوقت خارج recvWindow · توقيع غير صحيح · تنسيق مفتاح غير صحيح · المفتاح مُبطَل أو غير صحيح (HTTP 401)، المفتاح للقراءة فقط والطلب طلب تداول (HTTP 403).
ERR-1102 · -2010 · -2011 · -2019معامل إلزامي مفقود · رُفض الأمر · الأمر غير موجود · الهامش غير كافٍ.
مشتركون لروبوتك (نسخة تجريبية)

يمكن تسجيل الروبوت كروبوت عام: يضغط المستخدم «ربط» في التطبيق، فتفتح له BuyCrypt حسابًا تجريبيًا منفصلًا برصيد 1,000 USDT تجريبي وتصدر مفتاحًا لهذا الحساب فقط. يصل المفتاح إلى الويب هوك الخاص بك بالحدث subscription.created، ويتداول الروبوت على الحساب التجريبي للمشترك. وعندما يفصل المستخدم الربط تُغلق المراكز، ويتوقف المفتاح عن العمل، ويصلك subscription.disconnected.

لا تُمرَّر إلى الروبوت حسابات المستخدمين الحقيقية ولا مفاتيح منصاتهم — فقط مفتاح الحساب التجريبي المنفصل.

التسجيل عبر طلب موقّع POST /fapi/v1/bot/profiles بالمعاملات slug وdisplayName وwebhookUrl ‏(HTTPS فقط) وwebhookSecret ‏(32 حرفًا على الأقل)؛ ويحصل الروبوت على الحالة PENDING_REVIEW حتى المراجعة. كل حدث موقّع: الترويسة X-BuyCrypt-Signature = HMAC-SHA256(webhookSecret, timestamp + "." + body)، والوقت في X-BuyCrypt-Timestamp. يُعاد التسليم حتى 6 مرات (فورًا، ثم بعد 10 ثوانٍ و30 ثانية ودقيقتين و10 دقائق وساعة)؛ وبعد 10 محاولات تسليم فاشلة متتالية يُعطَّل الويب هوك، ويساعدك الدعم على إعادة تفعيله.

التحقق من توقيع الويب هوك، Python
import hashlib, hmac, os, time

WEBHOOK_SECRET = os.environ["BUYCRYPT_WEBHOOK_SECRET"]

def verify(headers, raw_body: bytes) -> bool:
    ts = int(headers["X-BuyCrypt-Timestamp"])
    if abs(time.time() * 1000 - ts) > 5 * 60 * 1000:   # older than 5 minutes: reject
        return False
    expected = hmac.new(WEBHOOK_SECRET.encode(), f"{ts}.".encode() + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, headers["X-BuyCrypt-Signature"])
المفاتيح والأمان

مفتاح BuyCrypt يفتح الحساب التجريبي فقط

مرتبط بحساب واحد

يُنشأ مفتاح API لحساب تجريبي محدد ولا يعمل إلا معه. ولا يمكن الوصول إلى الحسابات الحقيقية في البورصات عبر هذا API. ومفتاح القراءة فقط لا يتداول حتى على هذا الحساب.

يُعرض السر مرة واحدة

احفظ المفتاح والسر في متغيرات البيئة أو في مدير أسرار، لا في الكود ولا في المستودعات العامة.

إلغاء في ثانية

في منصة الويب أو التطبيق، وفي قسم «Bot API keys» نفسه، اضغط «Revoke»: ستتلقى جميع الطلبات بهذا المفتاح الخطأ 401 فورًا.

أسئلة

أسئلة شائعة

هل يتداول الروبوت بأموال حقيقية؟

لا. ينفّذ API الخاص بـ BuyCrypt الأوامر على حسابك التجريبي: الأسعار سوقية، والرصيد بعملة USDT التجريبية. لا تُرسل الأوامر إلى المنصة، لذا يمكنك اختبار الاستراتيجية بلا مخاطرة.

هل يجب إعادة كتابة الروبوت من أجل BuyCrypt؟

عادةً لا. إذا كان الروبوت يعمل مع Binance USD-M Futures، فاستبدل العنوان الأساسي بـ https://api.buycrypt.com وضع مفتاح BuyCrypt. المسارات والتوقيع وصيغة الاستجابات كما هي. تأكد أن الروبوت لا يستخدم وضع التحوّط ولا المسار /fapi/v2/ticker/price.

من أين أحصل على مفتاح API؟

في منصة الويب أو تطبيق BuyCrypt: الملف الشخصي ← مفاتيح API ← حسابك التجريبي ← Bot API keys ← Generate API key. ولـ MCP ومساعدي الذكاء الاصطناعي، استخدم «Generate read-only key (for MCP)» في منصة الويب: هذا المفتاح يرى الحساب لكنه لا يتداول. السر يظهر مرة واحدة فقط، فاحفظه فورًا. ومن المكان نفسه يمكنك إبطال المفتاح.

ما هو MCP ولماذا أحتاج إليه؟

MCP ‏(Model Context Protocol) معيار مفتوح يربط به مساعدو الذكاء الاصطناعي البيانات الخارجية. بعد ربط الخادم https://buycrypt.com/mcp يمكنك سؤال Claude أو ChatGPT أو Cursor عن البطولات والمتصدرين وجواز سفر المتداول، وسيجيب المساعد من بيانات BuyCrypt الحية.

هل يلزم التسجيل لربط MCP؟

لا. البطولات والتصنيف وجوازات سفر المتداولين والأسعار متاحة دون مفتاح. المفتاح مطلوب فقط للأدوات الثلاث التي تقرأ حسابك التجريبي، ويكفي فيها مفتاح للقراءة فقط.

هل يستطيع مساعد الذكاء الاصطناعي التداول عبر MCP؟

لا. أدوات الخادم التسع كلها تقرأ البيانات فقط: لا تُوضع أوامر ولا تُلغى، ولا ينضم أحد إلى البطولات، ولا تُحوَّل أموال.

هل سيحصل مطوّر الروبوت على مفاتيح منصتي؟

لا. عندما تربط روبوت شخص آخر، تفتح له BuyCrypt حسابًا تجريبيًا منفصلًا وتصدر مفتاحًا له وحده. لا تُمرَّر حساباتك الحقيقية ولا مفاتيح منصاتك إلى الروبوت. المزيد عن حماية البيانات في صفحة «الأمان».

ابدأ بالحساب التجريبي

حساب BuyCrypt مجاني: حساب تجريبي للروبوت، ومفتاح API في التطبيق، وبطولات وتصنيف يُظهران قيمة الاستراتيجية.