/ الدليل / الملعب / agent-trade-kit
● مجتمع okx ⚡ فوري

agent-trade-kit

بواسطة okx · okx/agent-trade-kit

أداة تداول MCP رسمية من OKX — 112 أداة للتداول الفوري والمبادلات والعقود الأجلة والخيارات وروبوتات الشبكة والاستثمار الدوري (DCA) — مع وضع القراءة فقط وتخزين بيانات الاعتماد محلياً فقط.

agent-trade-kit هو MCP للعقدة (Node) لتداول OKX. يغطي بيانات السوق والتداول الفوري والمقايضات الأبدية والعقود الأجلة والخيارات والأرباح والحساب واستراتيجيات الخوارزمية والروبوتات — 112 أداة في 8 وحدات. تبقى بيانات الاعتماد محلية (بدون إعادة توجيه سحابية). تم توفير العلم --read-only لاستخدام التحليل فقط.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

agent-trade-kit.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-trade-kit",
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-trade-kit": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "agent-trade-kit"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add agent-trade-kit -- npx -y agent-trade-kit

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: agent-trade-kit

البحث عن أحد الأصول قبل الإقرار بالتداول (قراءة فقط)

👤 متداولو العملات المشفرة الذين يقومون بالعناية الواجبة ⏱ ~20 min advanced

متى تستخدمه: عندما تفكر في فتح مركز وتريد الرسوم البيانية + المؤشرات + لقطة دفتر الأوامر في مسار واحد — بدون أي خطر من التداولات العرضية.

المتطلبات الأساسية
  • مفتاح OKX API (نطاق القراءة فقط) — OKX > API > إنشاء مفتاح بإذن القراءة فقط
الخطوات
  1. ابدأ في وضع القراءة فقط
    قم بتكوين agent-trade-kit مع --read-only. تأكد من تعطيل أدوات التداول.✓ تم النسخ
    → تم تفعيل أدوات البحث فقط
  2. سحب البيانات
    بالنسبة لـ SOL-USDT: شموع 4 ساعات آخر 30 يوم، RSI(14)، MACD، سعر التمويل الحالي، عمق أفضل سعر والاتجاه الحالي للفائدة المفتوحة.✓ تم النسخ
    → مكدس المؤشرات
  3. التركيب
    ما هي الصورة التقنية قصيرة الأجل وهل هي متوافقة مع التمويل / الفائدة المفتوحة؟✓ تم النسخ
    → التحليل

النتيجة: رؤية مستنيرة بدون خطر التنفيذ.

المزالق
  • التحليل التقني ليس محرك تنبؤ — استخدمه كمدخل واحد؛ وليس كإشارة تداول بمفرده

إعداد روبوت الشبكة ضمن معاملات محافظة

👤 متداولو العملات المشفرة الذين يستكشفون استراتيجيات الشبكة ⏱ ~30 min advanced

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

المتطلبات الأساسية
  • حساب OKX ممول — أموال حقيقية على المحك — تقدم بحذر
  • مفتاح API كامل (نطاق التداول) — OKX > API؛ لا تفعل السحب
الخطوات
  1. التخطيط
    بالنسبة لـ ETH-USDT الفوري: حلل نطاق آخر 30 يوم. اقترح شبكة: 40 مستوى، نطاق $2800-$3400، $50 استثمار لكل مستوى. اعرض العوائد المتوقعة.✓ تم النسخ
    → خطة الشبكة مع الافتراضات
  2. تأكيد وإنشاء
    قبل التنفيذ: تأكد من المعاملات. إذا قلت 'انطلق'، أنشئ روبوت الشبكة؛ وإلا توقف.✓ تم النسخ
    → بوابة تأكيد صريحة

النتيجة: روبوت الشبكة يعمل بخطر محدد الحجم.

المزالق
  • كسر النطاق = الشبكة تخسر — عيّن سعر التوقف عن الخسارة خارج النطاق؛ راجع أسبوعياً
  • نموذج اللغة يحدد حجم الأمر بشكل خاطئ — خسارة أموال حقيقية — أحجام بداية صغيرة؛ تحقق من كل معامل قبل التأكيد

فحص PnL للمحفظة والمراكز المفتوحة

👤 المتداولون النشطون ⏱ ~5 min intermediate

متى تستخدمه: فحص الصباح — ماذا لدي مفتوح، كيف يسير، أي مخاطر للهامش الخاص بي؟

الخطوات
  1. سحب حالة الحساب
    اسرد جميع المراكز المفتوحة (فوري + مقايضة + أجل) مع PnL غير المحقق. اعرض حقوق الملكية في الحساب + نسبة هامش الصيانة.✓ تم النسخ
    → لقطة المحفظة
  2. فحص المخاطر
    أي مركز في أعلى خطر تصفية؟ كم يبعد عن سعر التصفية الخاص به؟✓ تم النسخ
    → المخاطر مرتبة

النتيجة: فحص صباحي واعي للمخاطر.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

agent-trade-kit + filesystem

تسجيل كل تنفيذ تداول محلياً للضريبة والتدقيق

بعد كل تداول، أضف الأداة/الجانب/الحجم/السعر/ts إلى ~/trades/YYYY-MM.csv.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
market_candles instrument, bar, limit? بيانات الأسعار 1 API call
market_book instrument, depth فحص السيولة 1 API call
account_balance حالة الحساب 1 API call
spot_place_order instrument, side, size, type, price? تنفيذ فوري — مدمر؛ تأكد! 1 API call + real money
grid_bot_create instrument, range, levels, total_investment إطلاق استراتيجية الشبكة — مدمرة؛ تأكد! 1 API call + real money

التكلفة والحدود

تكلفة التشغيل

حصة API
لدى OKX API حدود معدل لكل نقطة نهاية
الرموز لكل استدعاء
بيانات الشموع والكتب قد تكون كبيرة — قللها بحد
التكلفة المالية
MCP مجاني. التداولات تتحمل رسوم OKX + خطر الأموال الحقيقية.
نصيحة
استخدم --read-only حتى تقرأ قائمة الأدوات وتثق بانضباط الإشارة الخاصة بك.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: مفتاح API بدون إذن السحب، أبداً
تخزين بيانات الاعتماد: محلي عبر okx config init — يبقى على القرص
نقل البيانات الخارجي: إلى OKX API؛ بيانات الحساب إلى موفر نموذج اللغة الخاص بك
لا تمنح أبدًا: إذن السحب على مفتاح API يُستخدم مع نموذج اللغة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Signature invalid

عدم تطابق مفتاح API / السر / كلمة المرور. أعد تشغيل okx config init. تحقق أيضاً من ساعة الخادم (API حساس للوقت).

Insufficient balance for order

تحويل الأموال إلى حساب التداول (OKX بها محافظ متعددة).

Tool missing when expected

قد يكون الفرز لكل وحدة يحجبه؛ تحقق من الإعدادات.

البدائل

agent-trade-kit مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Hummingbot / custom bot frameworksتريد التداول الآلي غير القائم على نموذج اللغةرمز، بدون نموذج لغة؛ أكثر حتمية
Direct OKX APIتريد السيطرة الكاملة ويمكنك التدقيق الذاتيبناء الغلاف الخاص بك

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills