مرجع API

Smart Money API

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

إصدار API الحالي: v1. رابط الأساس: https://api.smartmoneyapi.com/v1

مبادئ التصميم

أربع أفكار تشكل كل نقطة طرفية وكل درجة تُرجعها هذه الواجهة. وهي أيضًا الحدود الصادقة لما تعد به — وما لا تعد به.

إستراتيجية أولاً، وليس إشارة أولاً. هذه ليست خلاصة إشارات شراء/بيع. أنت تجلب الإستراتيجية ونقطة الدخول؛ تخبرك الواجهة ما إذا كانت بنية السوق المحيطة — التموضع في المشتقات، التمويل، الفائدة المفتوحة، التصفيات، تدفق سلسلة الكتل، وإجماع الحيتان — توافق على الصفقة التي تريد تنفيذها بالفعل.

مقيّم بالثقة، وليس تنبؤًا ثنائيًا. كل إجابة تحمل درجة confidence (عالي / متوسط / منخفض) و composite من -1.0 إلى +1.0. لا توجد ضمانات ولا استدعاءات نبوئية — تحصل على قراءة معايرة للاتفاق، مع الأسباب الكامنة وراءها، حتى تتمكن من تحديد الحجم بما يتناسب مع القناعة.

دعم القرار، وليس نصيحة تنفيذية. ترجع الواجهة توصية CONFIRM / REDUCE / SKIP ومضاعف حجم لـ منطقك للتصرّف بناءً عليه. لا تضع أوامر أبدًا، ولا شيء هنا يُعتبر نصيحة مالية. أنت تظل مسؤولًا عن المخاطرة، تحديد الحجم، والتنفيذ.

مقاييس حية، وليس ضمانات ثابتة. معدلات الفوز، إحصائيات النظام، وأرقام الدقة تُحسب من عينة متحركة وتتغير مع تغير الأسواق. ننشرها بصدق، بما في ذلك عندما تكون متوسطة. عالج كل مقياس كملاحظة حالية، وليس وعدًا بالمستقبل.

لمن صُممت هذه الواجهة

صُممت هذه الواجهة لـ مطوري بوتات، خوارزميات، ووكلاء الذكاء الاصطناعي للعملات الرقمية الذين لديهم بالفعل إشارة شراء/بيع — من إستراتيجية تحليل فني، نموذج تعلم آلي، خط أنابيب Freqtrade، تنبيه TradingView، أو وكيل نموذج لغة كبيرة — ويريدون قرارًا سريعًا قبل الالتزام برأس المال CONFIRM / REDUCE / SKIP قرار قبل الالتزام برأس المال.

حلقة نموذجية: تُطلق إستراتيجيتك "اذهب طويلًا على BTC" → تستدعي GET /v1/confirm?symbol=BTC&direction=long → تؤكد، تقلل، أو تتخطى الدخول وتقيس الحجم بواسطة size_mult. استدعاء واحد، استجابة JSON منخفضة الكمون، لا حاجة لبنية تحتية إضافية.

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

الحصول على الوصول

1 — سجّل. أنشئ حسابًا مجانيًا على signup (بريد إلكتروني/كلمة مرور أو Google). لا حاجة لبطاقة ائتمان للطبقة المجانية.

2 — افتح لوحة التحكم الخاصة بك. لوحة التحكم الخاصة بك تعرض مفتاح API الخاص بك، الخطة الحالية، والاستخدام الحي مقابل الحصة اليومية.

3 — انسخ مفتاح API الخاص بك. المفاتيح تبدأ بـ sm_. مرره كـ X-API-Key رأس في كل طلب (انظر المصادقة). قم بالترقية في أي وقت على صفحة الأسعار لرفع الحدود وإلغاء قفل المزيد من الرموز والنقاط الطرفية.

المواصفات، SDK وكتاب الطبخ

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

المصدر	ما هو
كتاب الطبخ	وصفات جاهزة لأكثر عمليات الدمج شيوعًا — تأكيد قبل الدخول، تنظيم إشارة Freqtrade، تحديد الحجم بواسطة المضاعف، التعامل مع 402/429، وتوصيلها بوكيل برمجة.
مواصفات OpenAPI	تعريف OpenAPI قابل للقراءة الآلية لكل نقطة طرفية. استيراد إلى Postman/Insomnia، إنشاء عملاء، أو إدخالها إلى LLM. في `github.com/tashiardit/smartmoneyapi-docs`.
عميل Python	مكتبة عميل Python الرسمية في `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	ملخص نصي سهل للـ LLM عن API. وجه Claude أو Codex أو Cursor إليه (انظر وكلاء البرمجة).

بدء سريع في دقيقتين

الخطوة 1 — عنوان URL الأساسي. كل نقطة طرفية موجودة تحت:

عنوان URL الأساسي
https://api.smartmoneyapi.com

الخطوة 2 — احصل على مفتاح API الخاص بك. سجل مجانًا (لا حاجة لبطاقة ائتمان) وانسخ مفتاحك من لوحة التحكم. قم بتمريره كـ X-API-Key الرأس في كل طلب.

الخطوة 3 — أول مكالمة لك. الصق هذا في طرفيتك واستبدل sm_your_key بالمفتاح من لوحة التحكم الخاصة بك:

cURL

curl -H "X-API-Key: sm_your_key" "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

الاستجابة المتوقعة:

JSON
{
 "ts": 1710940821,
 "symbol": "BTC",
 "direction": "long",
 "composite": 0.74,
 "confidence": "HIGH",
 "action": "CONFIRM",
 "size_mult": 1.5,
 "deriv_score": 0.81,
 "onchain_score": 0.68,
 "whale_score": 0.73,
 "reasons": ["معدل التمويل إيجابي عبر جميع المنصات", "الحيتان: 67٪ إجماع طويل"]
}

عندما confidence يكون HIGH أو MEDIUM و action يكون CONFIRM، قم بقياس حجم مركزك بواسطة size_mult. هذه هي حلقة الدمج الكاملة. انظر حقول الاستجابة للحصول على مرجع الحقول الكامل.

المصادقة

جميع الطلبات تتطلب مفتاح API يتم تمريره كـ X-API-Key رأس HTTP.

رأس HTTP
X-API-Key: sm_your_api_key_here

مفتاح API الخاص بك متاح من لوحة التحكم بعد التسجيل. احتفظ بمفتاحك سريًا — لا تعرضه في كود العميل أو المستودعات العامة.

مصادقة WebSocket مختلفة. لا تضع مفتاحك في عنوان URL لـ WebSocket. تستخدم التدفقات في الوقت الفعلي تذاكرقصيرة العمر لمرة واحدة: أرسل مفتاحك إلى /v1/ws/ticket مع X-API-Key الرأس، ثم اتصل بالتذكرة المرتجعة. انظر مصادقة WebSocket (تذاكر).

تسجيل الدخول عبر Google (Firebase Auth)

يمكن للمستخدمين المصادقة باستخدام حساب Google الخاص بهم عبر مصادقة Firebase. بعد تسجيل الدخول الناجح عبر Google على العميل، استبدل رمز معرف Firebase بجلسة API مرتبطة. يقوم النظام تلقائيًا بمزامنة هوية Google مع نظام مفتاح API.

متاح لـ: مجاني تاجر محترف

POST /auth/google

جسم الطلب

الحقل	النوع	الوصف
id_tokenمطلوب	string	رمز معرف Firebase الذي تم الحصول عليه بعد تسجيل الدخول عبر Google على العميل

مثال على الاستجابة

JSON

{
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}

يتم تخزين بيانات ملف تعريف المستخدم — البريد الإلكتروني، الخطة، سجل الاستخدام، التفضيلات — في Firestore ومرتبطة بحساب Google الخاص بك. يمكن طلب تصدير بيانات كاملة أو حذف الحساب في أي وقت عبر إعدادات الخصوصية في لوحة التحكم.

حدود المعدل

الخطة	مكالمات/يوم	حد الانفجار	تأخير البيانات
مجاني	50	2/دقيقة	60 ثانية
تاجر	1,000	20/دقيقة	في الوقت الفعلي
Pro	5,000	60/دقيقة	في الوقت الحقيقي
Enterprise	100,000	400/دقيقة	في الوقت الحقيقي

تتضمن كل استجابة رؤوس حدود المعدل: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Base URL

https://api.smartmoneyapi.com/v1

جميع النقاط النهائية أدناه مرتبطة بهذا العنوان الأساسي. جميع الردود بتنسيق JSON مع Content-Type: application/json.

الأخطاء

تستخدم الأخطاء رموز حالة HTTP القياسية وجسم JSON متسق. قم دائمًا بالتفريق بناءً على رمز الحالة، وليس على نص الاستجابة. الأخطاء الثلاثة التي ستواجهها غالبًا:

الحالة	الرمز	المعنى وما يجب فعله
401	غير مصرح به	مفتاح API مفقود أو غير صالح. تحقق من أن `X-API-Key` الرأس موجود وصحيح.
402	مطلوب الدفع	النقطة النهائية أو الرمز يتطلب خطة أعلى مما يمتلكه مفتاحك (مثل مفتاح مجاني يستدعي WebSocket firehose). قم بالترقية أو عد إلى نقطة نهاية عامة.
429	تم تجاوز حد المعدل	تم الوصول إلى الحد اليومي أو الحد الفوري. تراجع وأعد المحاولة بعد `X-RateLimit-Reset`؛ لا تقم بالضغط المتكرر.

كل خطأ يعود بنفس الشكل:

JSON
{
 "error": "rate_limit_exceeded",
 "message": "تم الوصول إلى الحد اليومي البالغ 100 استدعاء. يتم إعادة الضبط في 00:00 UTC.",
 "status": 429
}

للحصول على القائمة الكاملة لرموز الحالة (400 / 403 / 500 / 503 والمزيد)، انظر رموز الأخطاء. يعامل التكامل القوي الأخطاء 5xx و429 على أنها مؤقتة (أعد المحاولة مع التراجع) و401/402/403 على أنها نهائية (قم بإصلاح المفتاح أو الخطة).

أفضل ممارسات الأمان

أرسل المفتاح في الرأس، وليس في العنوان. قم دائمًا بتمرير X-API-Key كجزء من رأس HTTP. المفاتيح في سلاسل الاستعلام (?key=) يتم تسجيلها بواسطة الوكالات، موازنات التحميل، وسجل المتصفح — لم يعد يتم قبول ?key= auth في نقاط نهاية WebSocket لهذا السبب بالضبط.

احتفظ بالمفاتيح على جانب الخادم. لا تقم أبدًا بتضمين مفتاح API في JavaScript على جانب العميل، حزمة تطبيق محمول، أو مستودع عام. قم بتحميله من متغير بيئة أو مدير أسرار. إذا تم تسريب مفتاح، قم بتدويره.

قم بتدوير المفاتيح بشكل دوري. قم بإعادة إنشاء مفتاحك من لوحة التحكم على جدول زمني وعلى الفور إذا كنت تشك في التعرض. يتوقف المفتاح القديم عن العمل لحظة إصدار مفتاح جديد.

استخدم التذاكر لمقابس المتصفح. للتدفقات في الوقت الحقيقي من المتصفح، قم بتبادل مفتاحك لتذكرة لاستخدام واحد بدلاً من الاتصال بالمفتاح الخام — انظر مصادقة WebSocket (التذاكر).

الاستخدام مع وكلاء الترميز / LLMs

هل تقوم بالبناء باستخدام Claude Code أو Codex أو Cursor أو أي وكيل ترميز LLM؟ يمكنك إعطاء الوكيل كل ما يحتاجه لتوصيل هذا API بشكل صحيح في خطوة واحدة. يتم نشر مرجعين قابلين للقراءة الآلية:

المصدر	URL
ملخص LLM	`https://smartmoneyapi.com/llms.txt`
مواصفات OpenAPI	`github.com/tashiardit/smartmoneyapi-docs`

قم بتوجيه وكيلك إلى /llms.txt الملف (اتفاقية llms.txt) للحصول على نظرة عامة موجزة، ثم مواصفات OpenAPI لأشكال الطلب/الاستجابة الدقيقة. سطر واحد من التعليمات يعمل بشكل جيد:

Prompt

# الصق في Claude Code / Cursor / Codex
اقرأ https://smartmoneyapi.com/llms.txt ومواصفات OpenAPI في
github.com/tashiardit/smartmoneyapi-docs، ثم أضف فحصًا ما قبل التداول
إلى روبوت الخاص بي يستدعي GET /v1/confirm ويتخطى الإدخالات
ما لم يكن الإجراء CONFIRM.

انظر إلى كتاب الطبخ للحصول على وصفة عمل وكيل ترميز.

النقاط النهائية

GET /confirm

النقطة النهائية الأساسية. تُرجع درجة ثقة مركبة وتوصية إجراء لاتجاه تداول معين. قم باستدعاء هذا قبل الدخول في أي مركز.

التغطية، بعبارات بسيطة. /confirm حاليًا يتم تسجيل BTC، ETH و SOL — الرموز التي لديها تاريخ كافٍ لحلّه بشكل صادق. يقوم فحص المشتقات بشكل منفصل بمراقبة حوالي 519 سوقًا للمشتقات للتمويل، بيانات OI والتسوية، ويغطي تتبع الحيتان أكثر من 600 محفظة. Pro يفتح الفحص الكامل، التصديرات وتغطية أوسع للسوق؛ /confirm يتم توسيع دعم الرموز مع تراكم كل سوق لسجل موثوق.

المعلمات

المعلمة	النوع	الوصف
symbolمطلوب	string	رمز الأصل. واحد من: `BTC`, `ETH`, `SOL` (Trader+)
directionمطلوب	string	اتجاه التداول: `long` أو `short`
sourceاختياري	string	تسمية لمصدر إشارتك (يتم تسجيله للتحليلات). الحد الأقصى 32 حرفًا.

مثال على الطلب

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

مثال على الاستجابة

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "direction": "long",
 "composite": 0.74,
 "confidence": "HIGH",
 "action": "CONFIRM_FULL",
 "size_mult": 1.5,
 deriv_score: 0.81,
 onchain_score: 0.68,
 whale_score: 0.73,
 x_score: 0.0,
 عوامل: {
 مشتقات: { درجة: 0.81, وزن: 0.40, موزون: 0.324 },
 على السلسلة: { درجة: 0.68, وزن: 0.35, موزون: 0.238, مصدر: coinmetrics, متاح: True },
 حوت: { درجة: 0.73, وزن: 0.25, عامل التقادم: 1.0, موزون: 0.183 }
  },
 تعديلات: { اتفاق: 0.0, اتجاه: 0.0, أخبار ماكرو: 0.0 },
 أوزان: { مشتقات: 0.40, على السلسلة: 0.35, ذكاء الحيتان: 0.25 },
 تغطية: { مشتقات: True, حوت: True, على السلسلة: True },
 أسباب: [
 معدل التمويل إيجابي عبر جميع المنصات,
 LSR يميل إلى المراكز الطويلة: 1.42,
 الحيتان: 67% إجماع على المراكز الطويلة,
 MVRV فوق 1.0 — مؤشر صعودي على السلسلة
  ]
}

شفاف بالتصميم. كل استجابة تحتوي على factors كائن يظهر لكل جزء درجة × وزن = موزون مساهمة، adjustments كائن للتعديلات اللاحقة، weights المستخدمة، و coverage خريطة. يستخدم جزء السلسلة بيانات Coin Metrics المجانية الحقيقية (MVRV / تدفق التبادل / العناوين النشطة) عند عدم تعيين مفتاح Glassnode. هذا متعدد العوامل التقاء درجة — دعم قرار، ليس ضمانًا لمعدل الفوز.

الرموز غير المتابعة صادقة. رمز خارج نطاق المشتقات/حيتان المتابعة يعيد "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" مع "unsupported":true — وليس أبدًا LOW.

حقول الاستجابة

حقل	نوع	وصف
ts	عدد صحيح	الطابع الزمني يونيكس للحساب
رمز	سلسلة	رمز الأصل (BTC/ETH/SOL)
اتجاه	سلسلة	الاتجاه المطلوب (طويل/قصير)
مركب	عدد عشري	درجة التقاء مركبة من -1.0 (معاكس شديد) إلى +1.0 (تأكيد قوي). ليس معدل فوز.
base_composite	عدد عشري	المركب قبل تطبيق تعديلات ما بعد التصفية
ثقة	سلسلة	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
إجراء	سلسلة	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
حجم_مضاعف	عدد عشري	مضاعف حجم المركز المقترح (مثال: 0.0 – 1.5)
غير مدعوم	منطقي	`true` عندما يكون الرمز خارج التغطية (مقترن بـ NO_DATA)
deriv_score	عدد عشري	درجة فرعية للمشتقات (-1 إلى 1)
onchain_score	عدد عشري	درجة فرعية على السلسلة (-1 إلى 1)
whale_score	عدد عشري	درجة فرعية لإجماع الحيتان (-1 إلى 1)
x_score	عدد عشري	درجة فرعية لـ X/المشاعر الاجتماعية (-1 إلى 1); 0 عند عدم الاستخدام
factors	كائن	تفصيل لكل جزء: `score × weight = weighted` للمشتقات / على السلسلة / حوت / x_sentiment (يشمل على السلسلة `source`)
adjustments	كائن	تعديلات موقعة ما بعد التصفية (اتفاق، اتجاه، rsi_1h، أخبار ماكرو، زخم، وقت اليوم، تضاؤل التسلسل)
weights	كائن	مجموعة الأوزان المستخدمة فعليًا في هذا التقييم
coverage	كائن	`{derivatives, whale, onchain}` — الأجزاء التي تحتوي على بيانات حقيقية
reasons	مصفوفة	نصوص تفسيرية مقروءة للبشر للدرجة

GET /snapshot

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

يتطلب: متداول محترف

GET /onchain

تُرجع المقاييس الأولية على السلسلة: MVRV، SOPR، صافي تدفق البورصة، نسبة القيمة المحققة، وتصنيف موضع الدورة.

يتطلب: متداول محترف

GET /v1/derivatives/*

شاشة مشتقات عبر البورصات لأكثر من 500 رمز: خريطة حرارة معدل التمويل، ترتيب الفائدة المفتوحة، واكتشاف إشارات نسبة الطويل/القصير. الصفوف العشرة الأولى عامة؛ الشاشة الكاملة تتطلب متداول أو محترف. النقاط النهائية: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

تحليلات خيارات BTC و ETH من Deribit (عامة، بدون مصادقة): نسبة البيع/الشراء، الحد الأقصى للألم، والفائدة المفتوحة حسب الإضراب. النقاط النهائية: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

صافي التدفقات اليومية لـ BTC و ETH ETF وتفصيل لكل صندوق (عام). النقاط النهائية: /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

التمويل التاريخي، الفائدة المفتوحة، نسبة الطويل/القصير (Binance)، وOHLCV (CoinGecko) للاختبار الخلفي. النقاط النهائية: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

أزواج رائجة، بحث عن الرموز، وتفاصيل الأزواج بواسطة DexScreener (عامة، بدون مصادقة). النقاط النهائية: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

ذكاء الأخبار: أخبار السياسة/الجغرافيا السياسية/العملات المشفرة مصنفة إلى فئات تأثير، بالإضافة إلى الخوف والجشع (عامة، بدون مصادقة). النقاط النهائية: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

تُرجع بيانات إجماع محافظ الحيتان: تقسيم الطويل/القصير، التعرض الافتراضي الكلي، أفضل 10 مراكز (للمحترفين فقط)، وعدد المحافظ.

يتطلب: متداول محترف

GET /signals

تُرجع تدفقًا لأحدث إشارات HIGH/MEDIUM عبر جميع الأصول المراقبة. مفيدة لمسح الفرص.

يتطلب: محترف

GET /v1/strategies/*

سجل أداء شفاف للقراءة فقط للاستراتيجيات التداول الآلية التي تنفذ على إشارات Smart Money — بما في ذلك deriv40 استراتيجية SmartMoney Copytrade (account=9). جميع النقاط النهائية تأخذ ?account=<id> معلمة استعلام وتُرجع JSON. لا تتطلب مصادقة (سجل أداء عام).

النقاط النهائية

GET /v1/strategies/stats?account=9 — مقاييس رئيسية: total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
GET /v1/strategies/equity?account=9 — منحنى الأسهم للرسم: { initial_equity, curve: [{ time, equity }] }.
GET /v1/strategies/trades?account=9&limit=500 — سجل الصفقات المغلقة: مصفوفة (أو {trades:[…]}) من symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 — المراكز المفتوحة حاليًا: مصفوفة (أو {positions:[…]}) من symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals — تفصيل نوع الإشارات التي تغذي الاستراتيجيات (عدد / انتصارات / معدل الانتصار / متوسط الربح والخسارة لكل نوع إشارة).

الأداء السابق ليس مؤشرًا على النتائج المستقبلية. الأرقام تم تعبئتها خلفيًا على مدى نظام واحد لمدة ~3 أشهر بالإضافة إلى الصفقات الحية وتظهر بدون رسوم حيث تم الإشارة.

GET /export

تنزيل بيانات الإشارات التاريخية كـ CSV للاختبار الخلفي. المعلمات: symbol, from (unix ts)، to (unix ts).

يتطلب: محترف

GET /health

فحص صحة النظام. يُرجع حداثة البيانات لكل مصدر وحالة API العامة. لا تتطلب مصادقة.

استجابة JSON
{
 "status": "ok",
 "uptime_s": 1209600,
 "sources": {
 "bybit": { "lag_s": 42, "ok": true },
 "binance": { "lag_s": 38, "ok": true },
 "hyperliquid": { "lag_s": 61, "ok": true },
 "onchain": { "lag_s": 290, "ok": true }
  }
}

GET /usage

تُرجع إحصائيات استخدام API الحالية: المكالمات اليومية، الإجماليات الشهرية، حدود الحصة، وأوقات الإعادة.

POST /webhooks

يتطلب: محترف

تسجيل عنوان HTTPS URL لتلقي دفعات الأحداث الموقعة في الوقت الفعلي عند إطلاق إشارة عبر الأصول المراقبة. عمليات التسليم تحمل X-SmartMoney-Event رأس وHMAC-SHA256 توقيع في X-SmartMoney-Signature، وإعادة المحاولة حتى 3 مرات مع التراجع.

جسم الطلب

الحقل	النوع	الوصف
urlمطلوب	string	نقطة نهاية HTTPS لإرسال الأحداث إليها (يجب أن تبدأ بـ `https://`)
eventsمطلوب	array	أسماء الأحداث، على سبيل المثال `["HIGH","MEDIUM","VETO"]` أو `["*"]`
symbolsمطلوب	array	الرموز للتصفية، على سبيل المثال `["BTC","ETH"]` أو `["*"]`
secretمطلوب	string	سر التوقيع الخاص بك، ≥ 16 حرفًا (مخزنة بشكل مشفر)

التحقق من التوقيع

مفتاح HMAC هو التجزئة السداسية العشرية لـ SHA-256 لسرك المسجل. احسب HMAC-SHA256 لجسم الطلب الخام باستخدام ذلك المفتاح وقارن (بوقت ثابت) مع X-SmartMoney-Signature. انظر دليل تنفيذ الويب هوك.

الذكاء

GET /analysis

يتطلب: Pro

يعيد تصنيفًا مدعومًا بالذكاء الاصطناعي لنظام السوق مع اكتشاف تعارض الإشارات. يحلل اتفاقية الإشارات المتقاطعة، ويحدد الاختلافات بين المشتقات، وسلسلة البيانات، وبيانات الحيتان، وينتج ملخصًا طبيعيًا مع عوامل المخاطر المستقبلية وتوصية محددة بجدول زمني.

المعلمات

المعلمة	النوع	الوصف
symbolمطلوب	string	رمز الأصل: `BTC`, `ETH`، أو `SOL`

مثال على الاستجابة

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "Late Cycle — Signal Divergence",
 "summary": "BTC في مرحلة متأخرة من الدورة الصاعدة مع تعارض قوة سلسلة البيانات مع تمدد المشتقات. الحيتان يقلصون التعرض بينما يرتفع LSR للتجزئة.",
 "signal_conflicts": [
 "درجة الحيتان هبوطية بينما درجة سلسلة البيانات صعودية",
 "معدل التمويل عند أعلى مستوى في 3 أشهر — خطر ضغط محتمل"
  ],
 "risk_factors": ["تمويل مرتفع", "تباعد OI", "تخفيض الحيتان"],
 "recommendation": "قلص التعرض الطويل، شدد نقاط التوقف. تجنب المراكز الطويلة الجديدة فوق السعر الحالي.",
 "time_horizon": "4h–12h"
}

يحتاج إلى خطة Pro. تستهلك هذه النقطة 3 استدعاءات API لكل طلب بسبب عبء معالجة الذكاء الاصطناعي.

GET /liquidations

يتطلب: Trader Pro

يعيد وجهتي نظر متكاملتين: (1) تقدير الرافعة المالية levels — تقدير لأماكن حيث توجد مجموعات التصفية؛ و (2) realized_heatmap — REAL المنفذة شدة التصفية القسرية (السعر × الوقت)، مجمعة مباشرة من تغذيات WebSocket للتبادلات العامة: Binance, OKX, Bybit, Bitget, BitMEX. تظهر خريطة الحرارة عندما يكون هناك بيانات للرمز (تغيب في سوق هادئ جدًا أو بعد التشغيل مباشرة).

المعلمات

المعلمة	النوع	الوصف
symbolاختياري	string	رمز الأصل (افتراضي `BTC`). تغطي خريطة الحرارة الفعلية رموز العقود الدائمة المتداولة بنشاط.

مثال على الاستجابة

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // تصفيات حقيقية منفذة — مباشرة من 5 تبادلات
 "realized_heatmap": {
 "window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
 "clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
  }
}

خطة Trader: cascade_risk، أقرب المسافات، والمجموع المنفذ/حسب الجانب. خطة Pro: تقدير كامل levels بالإضافة إلى realized_heatmap الكاملة (مصفوفات، مجموعات لكل سعر، أعداد لكل تبادل). التقدير يجيب عن "أين نقاط التوقف"؛ خريطة الحرارة الفعلية تُظهر "ما تم تصفيته فعليًا."

GET /liquidations/heatmap

متاح لـ: Free لا يلزم مصادقة (محدود لكل IP)

Public خريطة حرارة التصفية حسب مستوى السعر. تُعيد مصفوفة على غرار Coinglass للسعر × الوقت لـ REAL المنفذة تصفيات قسرية، مجمعة حسب السعر الذي تمت فيه كل تصفية — مجمعة مباشرة من تغذيات WebSocket للتبادلات العامة: Binance, OKX, Bybit, Bitget, BitMEX. الـ clusters array هو المخرجات العملية: مجموعات الأسعار المرتبة حسب القيمة الاسمية المصفاة، كل منها مع الجانب المسيطر. تعتمد البيانات على البث المباشر — قد يعيد الرمز الهادئ جدًا أو البوابة المعادة التشغيل هيكلًا فارغًا مع note. المستويات المعروضة هي تصفيات حقيقية فقط، وليست تقديرات.

المعلمات

المعلمة	النوع	الوصف
symbolاختياري	string	رمز الأصل (الافتراضي `BTC`).
window_minutesاختياري	int	نافذة الرجوع بالدقائق (الافتراضي `240`، محددة بين 5-1440).
price_bucketsاختياري	int	عدد مجموعات الأسعار (الافتراضي `50`، محددة بين 5-100).

نموذج الاستجابة

JSON

{
 "symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
 "price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
 "price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
 "matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
 "clusters": [
    { "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
 "short_notional": 720000.0, "count": 37, "dominant_side": "long" }
  ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
 "generated_at": 1710940200, "public": true
}

ملاحظة صادقة: هذا النقطة النهائية تعكس فقط ما تم التقاطه في البث المباشر. عندما يكون الرمز هادئًا أو البث قد بدأ للتو، totals.count is 0, clusters يكون فارغًا، وحقل note يشرح السبب. إنه سجل لعمليات التصفية المنفذة — ليس توقعًا. لتقدير "أين توجد نقاط التوقف" المتوقعة، استخدم النقطة النهائية المعتمدة /liquidations نقطة النهاية.

GET /liquidations/onchain

يتطلب: متداول Pro

تم تنفيذ تصفية قروض DeFi على السلسلة تم التقاطها مباشرة من عقدنا المحلية عقد BSC + Avalanche الكاملة — مستقلة عن أي بوت تداول. تغطي Venus/Cream و Moolah على BSC، و AAVE V3/V2 و Benqi و BankerJoe و Granary و Vinium على Avalanche. الطبقة Pro تُرجع أيضًا at_risk المراكز (تعتمد على البوت، قد تكون غائبة).

المعلمات

المعلمة	النوع	الوصف
chainاختياري	string	`bsc` أو `avax`. احذف لجميع السلاسل.
limitاختياري	integer	الحد الأقصى للصفوف (الافتراضي 100، الحد الأقصى 500). الأحدث أولاً.

نموذج الاستجابة

JSON

{
 "chain": "bsc", "count": 2,
 "liquidations": [
    { "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
 "debt_symbol": "DAI", "repay_usd": 426.15,
 "collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
  ],
 "summary": {
 "window_hours": 24, "enabled": true,
 "by_protocol": { "bsc:Venus": { "count": 61, "repay_usd_known": 148230.55 } },
 "nodes": { "bsc": { "reachable": true, "head_block": 89173010, "events_total": 61 } }
  }
}

GET /smart-stop

المتطلبات: متداول احترافي

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

المعطيات

المعطى	النوع	الوصف
symbolمطلوب	string	رمز الأصل: `BTC`, `ETH`, أو `SOL`
directionمطلوب	string	اتجاه الصفقة: `long` أو `short`
entry_priceاختياري	float	سعر دخولك. الافتراضي هو سعر السوق الحالي إذا لم يُحدد.
risk_pctاختياري	float	أقصى مخاطرة مقبولة كنسبة مئوية من الحساب. الافتراضي: `2.0`

نموذج الاستجابة

JSON

{
 "symbol": "BTC",
 "direction": "long",
 "entry_price": 96420,
 "stops": {
 "tight": { "price": 95100, "note": "أدنى من هيكل 1 ساعة. الأفضل للمتاجرات السريعة." },
 "recommended": { "price": 93800, "note": "أدنى من تجمع التصفية الرئيسي عند 94 ألف دولار. وقف تأرجح قياسي." },
 "wide": { "price": 91200, "note": "أدنى من منطقة الطلب 4 ساعات. وقف صفقة مراكز." }
  },
 "avoid_zones": [
    { "low": 94200, "high": 94800, "reason": "تجمع تصفية كثيف — مخاطر انزلاق عالية" }
  ],
 "take_profit_suggestions": [
    { "tp1": 98500, "tp2": 101000, "tp3": 104200 }
  ]
}

باقة المتداول: تُرجع فقط recommended وقف الخسارة. باقة الاحترافي: جميع مستويات الوقف الثلاثة، avoid_zones، واقتراحات جني الأرباح الكاملة.

GET /funding-arb

المتطلبات: متداول احترافي

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

المعطيات

المعطى	النوع	الوصف
min_spreadاختياري	float	أقل فارق لسعر التمويل لإدراجه (كرقم عشري). الافتراضي: `0.01`
symbolاختياري	string	تصفية لأصل محدد. اتركه فارغًا لفحص جميع الأصول المدعومة.

نموذج الاستجابة

JSON

{
 "ts": 1710940821,
 "opportunities": [
    {
 "symbol": "BTC",
 "spread": 0.032,
 "apr": 84.2,
 "long_exchange": "hyperliquid",
 "short_exchange": "bybit",
 "action": "شراء HYPE / بيع BYBIT",
 "estimated_profit_8h_usd": 26.4
    }
  ]
}

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

نسخة مجانية عامة لا يتطلب مصادقة

نقطة نهاية عامة بدون مفتاح تُرجع أفضل 10 فرص مع شاشة عرض عبر البورصات المباشرة، مثالية للتضمين أو الفحص السريع. تحذف تاريخ الفارق لكل رمز والحقول الثقيلة وتُقدم من ذاكرة تخزين مؤقت مدتها 120 ثانية. عندما لا توجد فروق تمويل عبر البورصات في نافذة التحديث، تُرجع opportunities مصفوفة فارغة مع note — لا تُصنع بيانات أبدًا.

GET (لا يتطلب مصادقة)

GET /v1/derivatives/funding-arb

JSON

{
 "opportunities": [
    {
 "symbol": "OGN",
 "spread_pct": 0.297667,
 "annualized_apr": 325.95,
 "long_exchange": "bybit",
 "short_exchange": "hyperliquid",
 "estimated_profit_per_10k": 29.77,
 "risk_notes": "هامش منخفض — تأكد من أن الرسوم لا تستهلك هامش المراجحة."
    }
  ],
 "scanned_symbols": 222,
 "ts": 1783268753,
 "public": true,
 "limited": true
}

"مجاني، بدون مفتاح API. أفضل 10 فرص فقط، محدودة ومخزنة مؤقتًا (120 ثانية). صفحة الفحص المباشر:" "funding-arb.html".

"GET" "/smart-money/flow"

"يتطلب:" "Trader" "Pro"

"مؤشر موزون بالجودة" "لمؤشر اتجاه الحيتان" "لكل رمز، مُقيّم" -100 "(أموال الحيتان تميل إلى البيع) إلى" +100 "(تميل إلى الشراء). مبني من آلاف محافظ حيتان Hyperliquid التي يتم تتبعها — كل منها موزون حسب معدل الفوز التاريخي والأرباح والخسائر ويتضاءل حسب القرب الزمني. هذا" "مؤشر تموضع، وليس إشارة شراء/بيع أو توقع سعر." "الرموز التي تحتوي على عدد قليل من المحافظ المساهمة يتم تصنيفها" thin "وتقييمها بصدق. صفحة مباشرة:" "smart-money-flow.html".

"المعلمات"

"المعلمة"	"النوع"	"الوصف"
"symbol""اختياري"	"string"	"رمز واحد (مثل" `BTC`"). احذف للحصول على جميع الرموز المتابعة مصنفة حسب \|score\|."
"window_hours""اختياري"	"int"	"نافذة التقييم، محددة بـ" `1..168`". الافتراضي" `24`.

"مثال على الرد"

"JSON"

{
 ""symbols"": [
    {
 ""symbol"": ""SPX"",
 ""score"": -90.93,
 ""direction"": ""strong_short"",
 ""n_wallets"": 26,
 ""long_usd"": 184200.0, ""short_usd"": 2410000.0,
 ""quality_weighted"": true,
 ""sample_quality"": ""rich"",
 ""top_contributors"": [ { ""wallet"": ""0x31ca…974b"", ""direction"": ""short"", ""value_usd"": 5338.25, ""weight"": 0.4948 } ]
    }
  ],
 ""window_hours"": 24,
 ""quality_weighted"": true,
 ""ts"": 1783270000,
 ""note"": "مؤشر تموضع اتجاه الحيتان الموزون بالجودة (-100..+100). ليس توقعًا للسعر أو إشارة شراء/بيع."
}

"خطة Trader:" "أفضل 12 رمزًا، تفاصيل المساهمين محجوبة." "خطة Pro:" "جميع الرموز مع" top_contributors". أوزان المحافظ محدودة بـ" [0.25,1.0]"؛ الأرباح والخسائر هي وكيل غير محقق من أحدث لقطات المواضع."

"GET" "/v1/whales/crowding"

"متاح لـ:" "Free" "لا يلزم مصادقة — مجهول يحصل على أفضل 10 رموز، Trader+ يحصل على القائمة الكاملة"

"مدمج" "سياق تموضع الحيتان والازدحام" "لكل رمز، مدمج عبر" "Hyperliquid + GMX v2 + Jupiter Perps"". يُرجع القيمة الإجمالية/الصافية، الانحراف الاتجاهي، عدد المحافظ والمنصات، تركيز المواضع (حصة أفضل 3 + HHI)، متوسط الرافعة المالية الموزون، و" "مجموعات قرب التصفية" "(القيمة الإجمالية للدولار الجالسة ضمن 5% و 10% من سعر التصفية المقدر، مقسمة شراء/بيع). هذا" "سياق، وليس إشارة اتجاهية." "الحقول التي لا يمكن اشتقاقها هي" null "وتظهر كـ" — "— على سبيل المثال" lev_wavg/crowding_index "عندما لا تحمل أي صفقة رافعة مالية. مسافات التصفية هي تقدير هامش معزول ("pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), "ليس" "أسعار تصفية تم الإبلاغ عنها من قبل المنصة."

"المعلمات"

"المعلمة"	"النوع"	"الوصف"
"min_notional""اختياري"	"float"	"الحد الأدنى للقيمة الإجمالية المجمعة (بالدولار) لإدراج الرمز. الافتراضي:" `1000000`.

"مثال على الطلب"

"GET (لا مصادقة)"

"curl" ""https://api.smartmoneyapi.com/v1/whales/crowding?min_notional=1000000""

"مثال على الرد"

"JSON"

{
 ""ok"": true, ""ts"": 1783423500, الحد الأدنى للقيمة الاسمية: 1000000, عدد الرموز: 92,
 الرموز: [
    {
 الرمز: BTC,
 إجمالي الدولار الأمريكي: 2447900000.0, صافي الدولار الأمريكي: -51000000.0, الميل: -0.021,
 عدد الحيتان: 414, عدد المنصات: 3,
 المنصات: {
 مرتفع/منخفض: { الإجمالي: 1900000000.0, الصافي: -40000000.0, عدد الحيتان: 272 },
 gmx: { الإجمالي: 320000000.0, الصافي: -6000000.0, عدد الحيتان: 59 },
 jupiter: { الإجمالي: 227900000.0, الصافي: -5000000.0, عدد الحيتان: 83 }
      },
 تركيز أعلى 3: 0.159, مؤشر هيرشمان-هيرفيندال: 0.011, متوسط الرافعة المالية المرجح: 19.1,
 التصفية ضمن 5٪: { طويل: 621700000.0, قصير: 665600000.0 },
 التصفية ضمن 10٪: { طويل: 840000000.0, قصير: 910000000.0 },
 مؤشر الازدحام: 0.003
    }
  ],
 تحذيرات: [ مسافات التصفية هي تقديرات للهامش المعزول، وليست كما أبلغت بها البورصة. ]
}

ملاحظة صادقة: skew هو net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). فقط المنصات الموجودة فعليًا تظهر في venues. يتم استبعاد المراكز التي لا تحتوي على رافعة مالية من سلال التصفية بدلاً من افتراضها. يتلقى المتصلون المجهولون أفضل 10 رموز حسب الإجمالي (مع gated: true)؛ يتلقى Trader+ القائمة الكاملة.

GET /v1/options/gex

متاح لـ: مجاني لا يلزم مصادقة (محدد لكل IP)

التاجر التعرض للجاما (GEX) تحليلات لـ BTC & ETH, يتم حسابها مباشرة من سلسلة خيارات Deribit العامة (بدون مصادقة). يعيد صافي تعرض التاجر للجاما لكل سعر إضراب (اتفاقية SpotGamma للتاجر القصير)، مستوى انعكاس الجاما (سعر الإضراب حيث يتجاوز صافي التعرض للجاما التراكمي الصفر)، هيكل مدة التقلب الضمني (التقلب الضمني ATM حسب الأيام حتى الانتهاء)، وميل التقلب الضمني الأمامي (انعكاس المخاطر الوكيل بـ 25Δ). نظام GEX هو positive (التجار طويلون في الجاما → قمع التقلب) أو negative (تضخيم التقلب). مستقل بالكامل — يتم إعادة حسابه في كل استدعاء، ولا يعتمد على قاعدة بيانات مخزنة.

المعلمات

المعلمة	النوع	الوصف
الرمزاختياري	سلسلة نصية	`BTC` أو `ETH` فقط. الافتراضي: `BTC`.

طلب مثال

GET (بدون مصادقة)

curl "https://api.smartmoneyapi.com/v1/options/gex?symbol=BTC"

رد المثال

JSON

{
 "symbol": "BTC", "available": true, "spot": 63203.0,
 "net_gex": 18240000.0, "regime": "positive",
 "gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
 "call_gex": 31200000.0, "put_gex": -12960000.0,
 "by_strike": [
    { "strike": 60000, "net_gex": -2100000.0 },
    { "strike": 65000, "net_gex": 4800000.0 }
  ],
 "term_structure": [
    { "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
    { "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
  ],
 "skew": {
 "expiry": "8JUL26", "dte": 0.76,
 "put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
 "risk_reversal": 14.35, "bias": "downside_fear"
  }
}

ملاحظة صادقة: مضاعف عقد Deribit هو 1 (المراكز المفتوحة مقومة بالعملة). في حالة أي فشل في الجلب، يعيد النقطة النهائية available: false مع لوحات فارغة — لا يتم تصنيع GEX أبدًا. يستخدم ميل التقلب الضمني وكيلًا ثابتًا لسعر الإضراب ±10٪ لـ 25Δ (يتطلب الـ 25-delta الحقيقي حل دلتا لكل سعر إضراب)؛ مناسب للعرض، موثق كتقريب.

GET /v1/liquidations/simulate

متاح لـ: مجاني لا يلزم مصادقة (محدد لكل IP)

تفاعلي اختبار ضغط متتالية التصفيةبالنظر إلى حركة سعرية افتراضية، تُعيد التقدير للمراكز ذات الرافعة المالية التي سيتم تصفيتها، وحجم التداول القسري حسب مستوى السعر/الاتجاه/التبادل، وقراءة عمق المتتالية. الحركة الهبوطية تصفي المراكز الطويلة التي يقع سعر تصفيتها عند/فوق الهدف؛ الحركة الصعودية تصفي المراكز القصيرة التي يقع سعر تصفيتها عند/تحته. يتم دمج طريقتين مستقلتين: أسعار التصفية الدقيقة من الحيتان المُتتبعة على Hyperliquid الحقيقية الرافعة المالية/نقطة الدخول، بالإضافة إلى تجمعات نطاقات المراكز المفتوحة الإحصائية لكل تبادل (يُستنتج الرافعة المالية للجمهور من التمويل). كل شيء مُوسوم بوضوح estimated: true — لا يمكن معرفة الهامش لكل حساب، المتقاطع مقابل المعزول، الهامش المضاف، أو ADL.

المعاملات

المعامل	النوع	الوصف
الرمزاختياري	سلسلة	رمز الأصل. الافتراضي: `BTC`.
move_pctاختياري	رقم عشري	حركة سعرية افتراضية كنسبة مئوية (سالب = هبوط، موجب = صعود). الافتراضي: `-5`.

طلب مثال

GET (لا يحتاج مصادقة)

curl "https://api.smartmoneyapi.com/v1/liquidations/simulate?symbol=BTC&move_pct=-5"

رد مثال

JSON

{
 "ok": true, "estimated": true, "symbol": "BTC",
 "ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
 "triggered_notional_usd": 380000000.0,
 "cascade_depth": 0.029, "cascade_bucket": "low",
 "by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
 "by_side": { "long": 380000000.0, "short": 0.0 },
 "clusters": [
    { "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
  ],
 "whale_positions_used": 272, "exchanges": 3,
 "realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
 "methodology": { "disclaimer": "تقديري — لا يمكن معرفة الهامش لكل حساب، المتقاطع مقابل المعزول، الهامش المضاف، أو ADL." }
}

ملاحظة صادقة: كل رقم متوقع مستمد من قراءات قاعدة بيانات حقيقية؛ لا شيء يُختلق عند الفشل. رمز غير متتبع، لقطة قديمة، أو سعر مفقود يُعيد ok: true, empty: true رسالة واضحة، وليس أشرطة مزيفة. realized_context هي عينة صغيرة نامية من تدفق التصفية القسرية المباشر، تُعرض فقط كسياق — لا تجعل التوقع "محققًا" أبدًا.

GET /v1/wallet/{addr}/profile

متاح لـ: مجاني لا تحتاج مصادقة (محدود لكل IP)

ملف تعريف محفظة متعددة المنصات مبني بالكامل من لقطات مراكز الحيتان المتتبعة مباشرة. بالنسبة لحوت Hyperliquid متتبع، يُعيد المراكز المفتوحة الحالية، سلسلة زمنية لـ PnL غير المحقق/التعرض/عدد المراكز سلسلة زمنية، خط زمني للنشاط OPEN/CLOSE/FLIP خط زمني للنشاط (يُعاد بناؤه بمقارنة اللقطات المتتالية)، تسمية لوحة المتصدرين لـ HL المفكوكة، وملخص كتاب مفتوح. الصفحة المباشرة: wallet-profiler.html.

المعاملات

المعامل	النوع	الوصف
addrمطلوب	سلسلة	عنوان المحفظة (جزء المسار)، مثال `/v1/wallet/0x3bcae23e…/profile`.
daysاختياري	عدد صحيح	نافذة النظر للخلف للسلسلة والخط الزمني. الافتراضي: `30`.

طلب مثال

GET (لا يحتاج مصادقة)

curl "https://api.smartmoneyapi.com/v1/wallet/0x3bcae23e8c380dab4732e9a159c0456f12d866f3/profile?days=30"

رد مثال

JSON

{
 "ok": true, "wallet": "0x3bcae23e…", "tracked": true,
 "first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
 "hyperliquid": {
 "label": { "name": "Andre is back", "score": 74,
 "window_pnl_usd": 1307000, نسبة_الفوز_٪: 71, الصفقات: 42 },
 المراكز: [
      { المنصة: hyperliquid, الرمز: ETH, الاتجاه: بيع,
 الحجم: 1200.0, سعر_الدخول: 1800.0, الربح_غير_المحقق: 34800.0,
 الرافعة_المالية: 20.0, القيمة_بالدولار: 2160000.0 }
    ],
 السلسلة: [ { الوقت: 1783330000, الربح_غير_المحقّق: 42000.0, التعرض_بالدولار: 18400000.0, المراكز: 5 } ],
 الخط_الزمني: [ { الوقت: 1783400000, الحدث: انعكاس, الرمز: ETH,
 الاتجاه: بيع, من_الاتجاه: شراء, القيمة_بالدولار: 2160000.0 } ],
 ملخص: {
 المراكز_المفتوحة: 5, في_ربح: 3, في_خسارة: 2, صفقات_الشراء: 0, صفقات_البيع: 5,
 إجمالي_الربح_غير_المحقق: -12000.0, إجمالي_التعرض_بالدولار: 21000000.0, الرافعة_المالية_المختلطة: 19.9,
 أيام_النافذة: 30, لقطات_في_النافذة: 474,
 الربح_المحقق: None, ملاحظة_الربح_المحقق: غير قابل للاشتقاق — يتم رؤية اللقطات المفتوحة فقط، وليس عمليات الإغلاق.
    }
  }
}

ملاحظة صادقة: كل ما يظهر هو حقيقي من بيانات اللقطة — pnl هو تقييم السوق غير المحقق الخاص بـ HL، value_usd هو القيمة الاسمية المفتوحة. الربح والخسارة المحققان لكل دورة غير متاح (نرى فقط اللقطات المفتوحة، وليس عمليات الإغلاق) ويظهر كـ null / —؛ أحداث الإغلاق في الخط الزمني لا تحمل أي مطالبة بالربح أو الخسارة. عنوان صالح ولكن غير متتبع يعود tracked: false مع ملاحظة؛ عنوان غير صالح يعود ok: false, error: "invalid_address" (HTTP 400). ملصق لوحة المتصدرين HL هو ترتيب النافذة الخاص بـ HL عند الاكتشاف، وليس محسوبًا من قبلنا.

GET /flows

يتطلب: Pro

يعرض بيانات تدفق رأس المال عبر الأصول المختلفة، موضحًا أنماط التناوب بين BTC وETH وSOL عبر فترات زمنية متعددة. مفيد لتحديد الأصل الذي يجذب رأس المال وأصل الذي يتم توزيعه في أي لحظة.

مثال على الاستجابة

JSON

{
 "ts": 1710940821,
 "flows": {
 "BTC": { "1h": 142000000, "4h": 380000000, "12h": -90000000, "24h": 220000000 },
 "ETH": { "1h": -38000000, "4h": -110000000, "12h": 55000000, "24h": -80000000 },
 "SOL": { "1h": 12000000, "4h": 29000000, "12h": 18000000, "24h": 44000000 }
  },
 "rotations_detected": [
 "انتقال رأس المال من ETH إلى BTC خلال نافذة 4 ساعات",
 "تراكم SOL مستمر عبر جميع النوافذ الزمنية"
  ]
}

يُتطلب الاشتراك في الخطة المدفوعة. قيم التدفق تمثل صافي التدفق الداخلي (إيجابي) أو الخارجي (سلبي) بالدولار لكل نافذة زمنية.

GET /whale-events

يتطلب: تاجر احترافي

يعرض تغييرات كبيرة في مراكز الحيتان - فتح، إغلاق، وتغيير الاتجاه - التي تم اكتشافها في المحافظ والعناوين المتعقبة على السلسلة خلال نافذة البحث المحددة.

المعايير

المعيار	النوع	الوصف
symbolاختياري	string	تصفية حسب الأصل. اتركه فارغًا ليشمل جميع الأصول المراقبة.
significanceاختياري	string	تصفية حسب أهمية الحدث: `high`, `medium`, أو `all`. الافتراضي: `all`
hoursاختياري	integer	نافذة البحث بالساعات. الافتراضي: `24`

مثال على الاستجابة

JSON

{
 "symbol": "BTC",
 "summary": {
 "flips_to_long": 3,
 "flips_to_short": 1,
 "new_opens": 7,
 "closes": 2
  },
 "events": [
    {
 "نوع": "قلب_طويل",
 "محفظة": "0xWhale...a4f2",
 "اتجاه": "طويل",
 "حجم_بالدولار": 4200000,
 "ط": 1710938400
    }
  ]
}

خطة المتداول: تُرجع summary الكائن فقط. الخطة الاحترافية: تغذية events كاملة مع معرفات المحافظ، الأحجام، وطوابع الزمن.

GET /regimes/history

يتطلب: الاحترافية

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

المعاملات

المعامل	النوع	الوصف
الرمزاختياري	سلسلة	رمز الأصل. الافتراضي: `BTC`
النظاماختياري	سلسلة	تصفية لنوع نظام محدد، مثل `late_cycle_divergence`. احذف لجميع الأنظمة.
الأياماختياري	عدد صحيح	نافذة النظر للخلف بالأيام. الافتراضي: `30`. الحد الأقصى: `365`

مثال على الاستجابة

JSON

{
 "رمز": "BTC",
 "النظام_الحالي": "تباعد_دورة_متأخرة",
 "ملخص_النظام": {
 "تباعد_دورة_متأخرة": { "التكرارات": 4, "متوسط_المدة_س": 38, "متوسط_العائد_٪": -2.1 },
 "تراكم": { "التكرارات": 6, "متوسط_المدة_س": 72, "متوسط_العائد_٪": 5.4 },
 "اختراق": { "التكرارات": 3, "متوسط_المدة_س": 18, "متوسط_العائد_٪": 9.2 }
  },
 "تحولات": [
    { "من": "تراكم", "إلى": "اختراق", "ط": 1710850000 },
    { "من": "اختراق", "إلى": "تباعد_دورة_متأخرة", "ط": 1710915000 }
  ]
}

تتطلب الخطة الاحترافية. اجمع مع /analysis للتحقق من افتراضات الاستراتيجية مقابل بيانات أداء النظام التاريخي.

GET /exchange-health

متاح ل: مجاني متداول احترافي

تُرجع حالة الصحة في الوقت الفعلي لجميع البورصات المراقبة بما في ذلك زمن الوصول لكل بورصة، معدلات الخطأ، ومؤشرات تقادم البيانات. لا يلزم مصادقة — نقطة نهاية متاحة للجمهور.

مثال على الاستجابة

JSON

{
 "حالة_عامة": "جيد",
 "ط": 1710940821,
 "بورصات": {
 "bybit": { "حالة": "جيد", "زمن_الوصول_مللي": 42, "معدل_الخطأ_1س": 0.0, "عمر_آخر_بيانات_ث": 18 },
 "binance": { "حالة": "جيد", "زمن_الوصول_مللي": 38, "معدل_الخطأ_1س": 0.0, "عمر_آخر_بيانات_ث": 22 },
 "hyperliquid": { "حالة": "متدني", "زمن_الوصول_مللي": 310, "معدل_الخطأ_1س": 0.04, "عمر_آخر_بيانات_ث": 95 },
 "okx": { "حالة": "جيد", "زمن_الوصول_مللي": 55, "معدل_الخطأ_1س": 0.0, "عمر_آخر_بيانات_ث": 30 }
  }
}

GET /sentiment

يتطلب: متداول احترافي

تُرجع مؤشر الخوف والجشع في الوقت الفعلي (0-100) المحسوب من مشتقات المشاعر، نشاط الحيتان، التقلب، وإشارات التواصل الاجتماعي. يتضمن تفصيل المكونات وتاريخ 24 ساعة لتحليل الاتجاه.

المعاملات

المعامل	النوع	الوصف
الرمزاختياري	string	رمز الأصل. الافتراضي: `BTC`

مثال للاستجابة

JSON

{
 "symbol": "BTC",
 "score": 72,
 "label": "جشع",
 "components": {
 "volatility": 65,
 "momentum": 78,
 "derivatives": 70,
 "whale_activity": 75,
 "social": 68
  },
 "history_24h": [
    { "ts": 1710940800, "score": 68, "label": "جشع" },
    { "ts": 1710937200, "score": 65, "label": "جشع" }
  ],
 "ts": 1710940821
}

ما يعادله من المنافسين: حجم التواصل الاجتماعي لـ Santiment + مؤشر الخوف والجشع من Alternative.me — مجتمعان في نقطة نهاية واحدة مع تفصيل للمكونات.

التكاملات

GET /tradingview/setup

يتطلب: متداول Pro

تُرجع إعدادات تكامل TradingView المخصصة لك: عنوان URL للويب هوك، السر للتأكيد، ومؤشرات Pine Script جاهزة للاستخدام والتي تتصل مباشرة بـ Smart Money API. انسخ وألصق كود Pine Script في TradingView لعرض إشاراتنا على أي مخطط.

مثال للاستجابة

JSON

{
 "webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
 "webhook_secret": "tvs_a1b2c3...",
 "pine_scripts": {
 "composite_indicator": "// Smart Money Composite v1
//@version=5
indicator(...)...",
 "whale_activity": "// Whale Activity Overlay v1
...",
 "funding_dashboard": "// Funding Rate + LSR Dashboard v1
..."
  }
}

POST /tradingview/webhook

متاح لـ: متداول Pro

يتلقى تنبيهًا من TradingView، يعالجه عبر /confirm، ثم يُرجع التأكيد. لا يمكن لـ TradingView إرسال رؤوس مخصصة، لذا قم بالمصادقة عن طريق تضمين ويب هوك الخاص بك secret في جسم JSON (هذه النقطة لا تستخدم X-API-Key). الرد يضمّن التأكيد ويضيف مستوى أعلى action من CONFIRMED (ثقة الخلفية عالية/متوسطة) أو VETOED.

جسم الطلب

JSON

{
 "secret": "your_webhook_secret",
 "symbol": "BTC",
 "direction": "long",
 "timeframe": "1h",
 "strategy": "تقاطع EMA",
 "price": 67500.0
}

مطلوب: secret, symbol, direction (long|short). اختياري: source, timeframe, strategy, price.

التخصيص

GET /preferences

يتطلب: متداول Pro

تُرجع إعدادات التخصيص الحالية بما في ذلك معاملات التداول الافتراضية، ملف المخاطرة، قائمة المراقبة، وتفضيلات الإشعارات.

PUT /v1/preferences

قم بتحديث التفضيلات عن طريق إرسال جسم JSON بأي مجموعة من الحقول أدناه. الحقول غير المدرجة تحتفظ بقيمها الحالية.

حقول التفضيلات

الحقل	النوع	الوصف
default_trade_size_usd	float	حجم المركز الافتراضي بالدولار لحسابات كيلي والتوقف الذكي
risk_tolerance	string	`conservative`, `moderate`، أو `aggressive`
default_risk_pct	float	المخاطرة الافتراضية لكل صفقة كنسبة مئوية من الحساب. تُستخدم بواسطة `/smart-stop` عندما `risk_pct` غير موجود
watchlist	array	قائمة مرتبة لرموز الأصول، مثل `["BTC","ETH","SOL"]`
notification_email	string	عنوان البريد الإلكتروني لتسليم التنبيهات
timezone	string	سلسلة IANA للوحدة الزمنية، مثل `America/New_York`

PUT — مثال للجسم

{
 "default_trade_size_usd": 5000,
 "risk_tolerance": "moderate",
 "default_risk_pct": 1.5,
 "watchlist": ["BTC", "ETH", "SOL"]
}

GET /watchlist

يتطلب: متداول محترف

يعرض لقطة لحالة التأكيد ومقاييس المخاطر الرئيسية لجميع الرموز في قائمة المراقبة المُهيأة لديك. يوفر نظرة عامة متعددة الأصول دون الحاجة إلى استدعاء /confirm كل رمز على حدة.

نموذج الاستجابة

JSON

{
 "ts": 1710940821,
 "watchlist": [
    {
 "symbol": "BTC",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "accumulation",
 "cascade_risk": "LOW"
    },
    {
 "symbol": "ETH",
 "confidence": "MEDIUM",
 "action": "REDUCE",
 "regime": "late_cycle_divergence",
 "cascade_risk": "HIGH"
    },
    {
 "symbol": "SOL",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "breakout",
 "cascade_risk": "MEDIUM"
    }
  ]
}

البث المباشر (المبادلات الحية)

بث مبادلات DEX بقيمة ≥ 500$ يتم اكتشافها في الوقت الفعلي من عقد BSC وAvalanche الخاصة بنا. يتوفر نوعان من النقل: بث عام لأحداث الخادم المرسلة (SSE) مجاني/لعملاء المتصفحات، وقناة WebSocket منخفضة الكمون للطبقات المدفوعة. يتم بث الأحداث خلال ثوانٍ من تضمينها في كتلة.

بث SSE العام (مجاني)

متاح لـ: مجاني متداول محترف

GET /v1/stream/public-swaps

لا يلزم مصادقة. مدعوم أصليًا EventSource في جميع المتصفحات الحديثة. يرسل الخادم swap أحداثًا ونبضات دورية للحفاظ على الاتصال نشطًا.

JavaScript (المتصفح)

const es = new EventSource("https://api.smartmoneyapi.com/v1/stream/public-swaps");
es.addEventListener("swap", e => {
  const swap = JSON.parse(e.data);
  console.log(swap.chain, swap.pair, swap.amount_usd);
});

قناة WebSocket المدفوعة

يتطلب: متداول محترف

WSS /v1/ws/live-swaps?ticket=…

المصادقة (موصى بها): لا تضع مفتاحك طويل الأمد في عنوان URL — يتم تسجيله بواسطة الوكائل وحفظه في سجل المتصفح. بدلاً من ذلك، أرسل مفتاحك عبر POST إلى /v1/ws/ticket باستخدام رأس X-API-Key آمن، ثم افتح الاتصال باستخدام ticket للاستخدام الواحد (صالح لمدة ~60 ثانية، يُستَخدَم مرة واحدة). يمكن للعملاء من جانب الخادم الذين يمكنهم تعيين الرؤوس بدلاً من ذلك تمرير X-API-Key مباشرة أثناء المصافحة. تتلقى مفاتيح الطبقة المجانية ردًا 402 payment_required . يتم إرسال إطار hello عند الاتصال مع معلومات طبقتك وعتبة البث.

JavaScript (المتصفح)

// 1. استبدل مفتاحك بتذكرة قصيرة الأجل (يبقى المفتاح في الرأس)
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
  method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. افتح الاتصال باستخدام التذكرة لمرة واحدة
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
  const swap = JSON.parse(e.data);
  if (swap.type === "swap") console.log(swap);
};

مصادقة WebSocket (التذاكر)

السبب: لا تضع مفتاح API الخاص بك في عنوان URL لـ WebSocket — تُسجل سلاسل الاستعلام بواسطة الوكائل وموازنات الحمل وتحفظ في سجل المتصفح. بدلاً من ذلك، استبدل مفتاحك بتذكرة قصيرة الأجل لمرة واحدة ticket عبر POST مصادق عليه عادي، ثم اتصل باستخدام تلك التذكرة.

التدفق: أرسل POST إلى /v1/ws/ticket مع رأس X-API-Key → استلم { "ticket": "…", "expires_in": 60 }. ثم افتح wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>التذكرة هي للاستخدام الواحد وتنتهي صلاحيتها في ~60 ثانيةيمكن للعملاء من جانب الخادم الذين يمكنهم تعيين رؤوس الطلبات بدلاً من ذلك تمريرها X-API-Key مباشرة على مصافحة WebSocket — لا حاجة لتذكرة.

POST /v1/ws/ticket

يتطلب: تاجر محترف

يصدر تذكرة لمرة واحدة لمصافحة WebSocket مصادقة. قم بالمصادقة باستخدام X-API-Key الرأس (مفتاحك لا يغادر رؤوس الطلبات). يمكن استرداد التذكرة التي تم إرجاعها مرة واحدة على /v1/ws/live-swaps قبل أن تنتهي صلاحيتها.

cURL

curl -X POST -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/ws/ticket"

مثال على الاستجابة

JSON

{
 "ticket": "wst_9f3c1a8e4b2d…",
 "expires_in": 60
}

حقول الاستجابة

حقل	النوع	الوصف
تذكرة	سلسلة نصية	رمز لمرة واحدة لإلحاقه كـ `?ticket=` على عنوان WebSocket. يتم استبداله مرة واحدة، ثم يصبح غير صالح.
ينتهي في	عدد	الثواني حتى تنتهي صلاحية التذكرة (~60). قم بإنشاء تذكرة جديدة لكل محاولة اتصال.

ملاحظة: المصادقة القديمة باستخدام ?key= معلمة الاستعلام لم تعد مقبولة على نقاط نهاية WebSocket لأسباب أمنية. استخدم تذكرة (للعملاء في المتصفح) أو X-API-Key رأس المصافحة (للعملاء من جانب الخادم).

لقطة REST

GET /v1/live-swaps/recent?limit=20

تُرجع آخر N مقايضة بثت من المخزن المؤقت المتداول. مفيد للعرض الأولي على لوحات التحكم قبل فتح اتصال البث. متاح أيضًا: /v1/live-swaps/status لإحصائيات البث.

مخطط الحدث

الحقل	النوع	الوصف
سلسلة	سلسلة نصية	`bsc` أو `avalanche`
منصة التبادل اللامركزي	سلسلة نصية	اسم الموجه (مثل `pancakeswap_v2`, `traderjoe`) أو `unknown_dex`
مبادِل	سلسلة	عنوان 0x الكامل للمحفظة التي قامت بالمبادلة
مبادِل_مختصر	سلسلة	صيغة مختصرة للعرض (مثلاً `0xb300…028d`)
رابط_المبادِل	سلسلة	رابط مباشر للمبادِل على مستكشف الكتل الخاص بالسلسلة
رمز_المعاملة	سلسلة	بصمة المعاملة
رابط_المستكشف	سلسلة	رابط مباشر للمعاملة على BscScan / Snowtrace
الرمز_المباع	سلسلة	رمز الرمز المباع (مثلاً `USDT`)
الرمز_المشترى	سلسلة	رمز الرمز المشترى
المبلغ_بالدولار	رقم	قيمة المبادلة بالدولار (الحد الأدنى: 500$)
الزوج	سلسلة	تسمية الزوج المنسقة (مثلاً `USDT → USDC`)
الكتلة	رقم	رقم الكتلة التي تم فيها تنفيذ المبادلة
الطابع_الزمني	رقم	الثواني في توقيت يونكس
الأهمية	سلسلة	`low` / `medium` / `high` / `critical` بناءً على الحجم بالدولار
التسلسل	رقم	رقم تسلسلي أحادي للبث - يُستخدم للكشف عن الفجوات

POST /alerts/conditions

يتطلب: Pro

أنشئ قواعد تنبيه مخصصة يتم تشغيلها عند تجاوز مقياس معين لحد معين. يتم تسليم التنبيهات عبر webhook أو البريد الإلكتروني أو موجز الإشعارات في لوحة التحكم حسب تفضيلاتك.

GET /v1/alerts/conditions

يعرض قائمة بجميع شروط التنبيه المكونة مع معرفاتها وتعريفاتها وحالتها الحالية.

DELETE /v1/alerts/conditions/{id}

يزيل شرط التنبيه بشكل دائم باستخدام معرفه.

GET /v1/alerts/history

يعرض أحداث تشغيل التنبيهات الحديثة مع الطوابع الزمنية والشروط المتطابقة وقيمة المقياس وقت التشغيل.

إنشاء تنبيه - جسم الطلب

الحقل	النوع	الوصف
الاسممطلوب	string	تسمية قابلة للقراءة البشرية لهذا التنبيه (بحد أقصى 64 حرفًا)
metricrequired	string	المقياس المراقب. انظر جدول المقاييس المتاحة أدناه.
symboloptional	string	سياق الأصل. مطلوب للمقاييس ذات النطاق الرمزي مثل `funding_rate`.
operatorrequired	string	معامل المقارنة: `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdrequired	float	قيمة رقمية لمقارنة المقياس بها
deliveryoptional	string	قناة التسليم، على سبيل المثال `telegram` (default) أو `webhook`
cooldown_minutesoptional	integer	الحد الأدنى للدقائق بين إعادة التشغيل (الافتراضي 60)

يتم إرجاع القائمة الحية للمقاييس والمعاملات الصالحة بواسطة GET /v1/alerts/conditions as available_metrics and available_operators.

المقاييس المتاحة

المقياس	الوصف
funding_rate	معدل التمويل الحالي للرمز (كنسبة عشرية)
global_lsr	نسبة الطويل/القصير العالمية للرمز
long_pct	النسبة المئوية للحسابات الطويلة الصافية للرمز
top_trader_lsr	نسبة الطويل/القصير للمتداولين الكبار للرمز
taker_ratio	نسبة المشتري/البائع للرمز
mvrv	نسبة القيمة السوقية إلى القيمة المحققة (BTC/ETH)
sopr	نسبة ربح الإخراج المنفق (BTC/ETH)
exchange_net_flow	إشارة صافي التدفق على السلسلة للتبادل
accumulation	إشارة التراكم على السلسلة
whale_long_pct	النسبة المئوية لمحافظ الحيتان التي يتم تتبعها وتحتفظ بمراكز طويلة للرمز
whale_n_wallets	عدد محافظ الحيتان التي يتم تتبعها والتي لديها مركز في الرمز
composite_long	درجة مركبة للرمز المطلوب في اتجاه الطويل
composite_short	درجة مركبة للرمز المطلوب في اتجاه القصير
funding_spread	انتشار التمويل عبر المنصات للرمز

POST — مثال الجسم

{
 "name": "ارتفاع معدل تمويل BTC",
 "metric": "funding_rate",
 "symbol": "BTC",
 "operator": "gt",
 "threshold": 0.05
}

GET /kelly

يتطلب: Pro

إرجاع توصيات تحديد حجم المركز بناءً على معيار كالي المُعدلة لأداء الإشارة التاريخي للرمز المحدد، مستوى الثقة، والاتجاه. يحدد حجم المركز بناءً على معدلات الفوز التجريبية لتجنب الرافعة المالية الزائدة.

المعلمات

المعلمة	النوع	الوصف
symbolrequired	string	رمز الأصل: `BTC`, `ETH`، أو `SOL`
confidenceoptional	string	مستوى ثقة الإشارة للنمذجة: `HIGH`, `MEDIUM`، أو `LOW`. الافتراضي: `HIGH`
directionoptional	string	اتجاه التداول: `long` أو `short`. الافتراضي: `long`
account_sizeoptional	float	حجم الحساب بالدولار الأمريكي لحساب `suggested_size_usd`. الافتراضي: `10000`

مثال على الاستجابة

JSON

{
 "symbol": "BTC",
 "confidence": "HIGH",
 "direction": "long",
 "win_rate": 0.68,
 "avg_reward_risk_ratio": 2.1,
 "kelly_fraction": 0.36,
 "half_kelly": 0.18,
 "suggested_size_usd": 1800,
 "samples": 142,
 "note": "يوصى باستخدام نصف كالي للتداول الحي لمراعاة خطأ التقدير."
}

يُتطلب الاشتراك في الخطة الاحترافية. تستند الحسابات إلى عينة متحركة لمدة 90 يومًا من الإشارات التاريخية التي تطابق الرمز المطلوب، ومستوى الثقة، ومعلمات الاتجاه.

GET /performance

متاح لـ: مجاني متداول احترافي

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

المعايير

المعيار	النوع	الوصف
الرمزاختياري	سلسلة نصية	تصفية حسب الأصل. احذف للحصول على إحصائيات مجمعة لجميع الرموز.
الأياماختياري	عدد صحيح	نافذة النظر إلى الوراء بالأيام. الافتراضي: `30`

نموذج الاستجابة

JSON

{
 "symbol": "BTC",
 "period_days": 30,
 "by_confidence": {
 "HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
 "MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
  }
}

الإحصائيات والإشارات

GET /v1/stats

متاح لـ: مجاني متداول احترافي لا يلزم مصادقة

إحصائيات الأداء الصادقة على مستوى الموقع مأخوذة من smart_money_confirm نتائج مكالمات مميزة. يُعيد معدلات الربح لمستويات الثقة العالية والمتوسطة، والدقة العامة، وعامل الربح، وتفصيل لكل رمز. جميع الأرقام داخل العينة خلال نافذة التقييم؛ راجع calibration.html للحصول على السياق ومنهجية الاحتفاظ الأمامي.

نموذج الاستجابة

JSON

{
 "high_winrate": 0.714,
 "high_winrate_n": 14,
 "medium_winrate": 0.530,
 "medium_winrate_n": 34,
 "overall_accuracy": 0.613,
 "overall_accuracy_n": 48,
 "profit_factor": 1.77,
 "avg_win_pct": 4.2,
 "winrate_horizon": "24h",
 "winrate_basis": "مكالمات تأكيد مميزة، نتائج محسوبة خلال 24 ساعة",
 "winrate_by_symbol": {
 "BTC": { "win_rate": 0.68, "n": 22 },
 "ETH": { "win_rate": 0.55, "n": 18 },
 "SOL": { "win_rate": 0.60, "n": 8 }
  },
 "forward_holdout": {
 "win_rate": 0.59,
 "high_win_rate": 0.70,
 "high_n": 10,
 "is_distinct_from_insample": false
  }
}

تحذير داخل العينة. جميع الأرقام في هذه الاستجابة محسوبة من نفس الفترة المستخدمة لضبط المُقيّم. الـ forward_holdout object هو الرقم الوحيد المتراكم على بيانات لم يراها المُقيّم من قبل — شاهد نموه مع الوقت. راجع calibration.html للحصول على المنهجية الكاملة وحدود الاختبار الداخلي/الأمامي.

GET /v1/signals/performance

متاح لـ: مجاني متداول احترافي لا يلزم مصادقة

تتبع نتائج الإشارات عبر آجال حلول متعددة (4 ساعات، 12 ساعة، 24 ساعة، 72 ساعة). يُعيد معدلات الضرب لكل أجل، وإجمالي عدد الإشارات، وتفصيل حسب نوع الإشارة.

المعايير

المعيار	النوع	الوصف
الأياماختياري	عدد صحيح	نافذة النظر إلى الوراء بالأيام. الافتراضي: `30`
نوع_الإشارةاختياري	سلسلة نصية	تصفية حسب النوع، مثال: `smart_money_confirm` أو `regime_flip`. احذف لجميع الأنواع.
الرمزاختياري	سلسلة نصية	تصفية حسب رمز الأصل، مثال: `BTC`. احذف للحصول على تجميع لجميع الرموز.

نموذج الاستجابة

JSON

{
 "signal_type": "smart_money_confirm",
 "symbol": "BTC",
 "days": 30,
 "total_signals": 48,
 آفاق: {
 4h: { معدل النجاح: 0.65, تم الحل: 46 },
 12h: { معدل النجاح: 0.61, تم الحل: 44 },
 24h: { معدل النجاح: 0.58, تم الحل: 40 },
 72h: { معدل النجاح: 0.54, تم الحل: 32 }
  },
 تفصيل النوع: {
 تأكيد_المال_الذكي: { العدد: 35, معدل_النجاح_24h: 0.61 },
 انقلاب_النظام: { العدد: 13, معدل_النجاح_24h: 0.47 }
  }
}

GET /v1/signals/recent

متاح لـ: مجاني متداول محترف لا يلزم مصادقة

تغذية بالإشارات المنشورة حديثًا ذات المستوى العالي والمتوسط عبر جميع الرموز المراقبة. يتضمن كل إدخال نوع الإشارة، ومستوى الثقة، والاتجاه، وحالة الحل إن كانت متاحة.

نموذج الاستجابة

JSON

{
 "signals": [
    {
 "id": 1042,
 "symbol": "BTC",
 "direction": "long",
 "signal_type": "smart_money_confirm",
 "confidence": "HIGH",
 "composite": 0.74,
 "ts": 1710940821,
 "resolved": true,
 "outcome_24h": "win"
    }
  ],
 "count": 50
}

GET /v1/signals/{id}/outcome

متاح لـ: مجاني متداول محترف لا يلزم مصادقة

نتيجة محلولة لإشارة واحدة باستخدام الرقم التعريفي الخاص بها. تُرجع النجاح/الفشل في كل أفق زمني للحل (4h، 12h، 24h، 72h) مع السعر وقت الإشارة وعند الحل.

المعاملات

المعامل	النوع	الوصف
idمطلوب	عدد صحيح	معرف الإشارة (جزء المسار)، مثال: `/v1/signals/1042/outcome`

نموذج الاستجابة

JSON

{
 "id": 1042,
 "symbol": "BTC",
 "direction": "long",
 "confidence": "HIGH",
 "entry_price": 63200.0,
 "ts": 1710940821,
 "outcomes": {
 "4h": { "result": "win", "price": 64100.0, "pct": 1.41 },
 "12h": { "result": "win", "price": 65200.0, "pct": 3.16 },
 "24h": { "result": "win", "price": 65800.0, "pct": 4.11 },
 "72h": { "result": "pending", "price": null, "pct": null }
  }
}

GET /v1/confirm-winrate

يتطلب: مجاني متداول محترف

تفصيل معدل الفوز لإشارات التأكيد لمفتاح API الخاص بالمستخدم المصادق عليه. يُرجع معدلات الفوز المميزة لكل مستوى ثقة، عامل الربح، والأرقام لكل رمز. يتطلب X-API-Key رأس.

نموذج الطلب

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm-winrate"

نموذج الاستجابة

JSON

{
 "high_winrate": 0.714,
 "high_n": 14,
 "medium_winrate": 0.530,
 متوسط_ن: 34,
 الدقة_الإجمالية: 0.613,
 الإجمالي_ن: 48,
 عامل_الربح: 1.77,
 معدل_الفوز_الأفق: 24h,
 حسب_الرمز: {
 BTC: { معدل_الفوز: 0.68, ن: 22 },
 ETH: { معدل_الفوز: 0.55, ن: 18 }
  }
}

أساس مكالمة مميزة. يتم حساب معدلات الفوز لكل مكالمة تأكيد مميزة (واحدة لكل رمز في نافذة مدتها 5 دقائق)، وليس لكل ضربة API — هذا يمنع تضخم N من البوتات التي تطلب بشكل متكرر. الأرقام داخل العينة على النافذة الافتراضية البالغة 30 يومًا؛ نفس التحذير كما في /v1/stats ينطبق.

بوابة الظل

يتطلب: مجاني تاجر محترف

سجل قرارات شخصي ثابت وقابل للإضافة فقط. قدم قرارات التداول الخاصة بك قبل أو بعد تنفيذها؛ يحسب النظام درجة التأكيد ضد محرك Smart Money ويضيف صفًا دائمًا. استخدمه لبناء سجل زمني صادق لمدى توافق إشارة API مع مداخلاتك الخاصة — مستقل تمامًا عن مجموعة معدل الفوز العالمي. تحتوي استجابات الطبقة المجانية والتاجر على حقول الأدلة مقطوعة؛ تُرجع الطبقة المحترفة التفاصيل الكاملة. ينطبق تأخير الطبقة على بيانات الطبقة المجانية.

POST /v1/shadow-gate/decisions

قدم قرارًا. غير قابل للتكرار في Idempotency-Key رأس الطلب — إعادة تقديم نفس المفتاح يعيد الصف الموجود دون إنشاء نسخة مكررة. يستدعي النظام محرك التأكيد على الفور ويضيف النتيجة كصف سجل غير قابل للتغيير.

هيئة الطلب

الحقل	النوع	الوصف
الرمزمطلوب	سلسلة	رمز الأصل، مثل `BTC`
الجانبمطلوب	سلسلة	اتجاه التداول: `long` أو `short`
معرف_الإستراتيجيةاختياري	سلسلة	تسمية الإستراتيجية المحددة من قبل المتصل (بحد أقصى 64 حرفًا). يتم تخزينها كما هي للتجميع والتصفية.

مثال الطلب

cURL

curl -X POST \
 -H "X-API-Key: sm_your_key" \
 -H "Idempotency-Key: my-signal-20260701-001" \
 -H "Content-Type: application/json" \
 -d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
 "https://api.smartmoneyapi.com/v1/shadow-gate/decisions"

مثال الاستجابة

JSON

{
 "id": 318,
 "symbol": "BTC",
 "side": "long",
 "strategy_id": "ema_crossover",
 "decision": "CONFIRM",
 "confidence": "HIGH",
 "composite": 0.74,
 "size_mult": 1.5,
 "ts": 1710940821,
 "resolved": false
}

ملاحظة الطبقة. تحذف استجابات الطبقة المجانية والتاجر factors / adjustments حقول الأدلة. تُرجع الطبقة المحترفة تفاصيل التأكيد الكاملة. ينطبق تأخير الطبقة على الطبقة المجانية — يتم كتابة الصف على الفور ولكن قد تعكس درجة التأكيد بيانات مخزنة مؤقتًا تصل إلى 60 ثانية.

GET /v1/shadow-gate/decisions

سرد قرارات بوابة الظل الخاصة بك، الأحدث أولاً. محدود بالمالك — يتم إرجاع القرارات المقدمة من مفتاح API الخاص بك فقط.

المعلمات

المعلمة	النوع	الوصف
الحداختياري	عدد صحيح	الحد الأقصى للصفوف المراد إرجاعها. الافتراضي: `50`، الحد الأقصى: `200`
المؤشراختياري	سلسلة	مؤشر ترقيم صفحة غير شفاف من `next_cursor` حقل الاستجابة السابقة. احذف للصفحة الأولى.

مثال الاستجابة

JSON

{
 "decisions": [
    { "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
    { "id": 317, "symbol": "ETH", "side": بيع, قرار: SKIP, ثقة: LOW, مركب: -0.12, حجم المضاعف: 0.0, طابع زمني: 1710937000, تم الحل: True }
  ],
 عدد: 2,
 المؤشر التالي: None
}

GET /v1/shadow-gate/decisions/{id}

قرار فردي حسب المعرف، بما في ذلك أدلة التأكيد الكاملة للطبقة الاحترافية. تحتوي استجابات الطبقة المجانية والمتاجرة على factors و adjustments مزال. يُرجع 403 إذا كان القرار ينتمي إلى مفتاح API مختلف.

مثال على الاستجابة (الاحترافية)

JSON

{
 معرف: 318,
 رمز: BTC,
 اتجاه: شراء,
 معرف الاستراتيجية: تقاطع المتوسط المتحرك,
 قرار: تأكيد,
 ثقة: HIGH,
 مركب: 0.74,
 حجم المضاعف: 1.5,
 عوامل: {
 مشتقات: { درجة: 0.81, وزن: 0.40, موزون: 0.324 },
 على السلسلة: { درجة: 0.68, وزن: 0.35, موزون: 0.238 },
 حوت: { درجة: 0.73, وزن: 0.25, موزون: 0.183 }
  },
 طابع زمني: 1710940821,
 تم الحل: False,
 نتيجة: None
}

POST /v1/shadow-gate/decisions/{id}/resolve

حل نتيجة القرار يدويًا. استدعِ هذا بعد إغلاق الصفقة لتسجيل النتيجة النهائية مقابل صف دفتر الأستاذ. بمجرد الحل، يصبح الصف غير قابل للتغيير ولا يمكن تغييره مرة أخرى.

نص الطلب

حقل	نوع	وصف
نتيجةمطلوب	سلسلة	نتيجة الصفقة: `win` أو `loss`
سعر الخروجاختياري	رقم عشري	سعر الخروج للصفقة. يتم تخزينه للرجوع إليه؛ يُستخدم لحساب نسبة الربح/الخسارة إذا تم توفيره.
نسبة الربح/الخسارةاختياري	رقم عشري	الربح/الخسارة المحقق كنسبة من حجم المركز، على سبيل المثال `3.5` أو `-1.2`

مثال على الاستجابة

JSON

{
 معرف: 318,
 تم الحل: True,
 نتيجة: فوز,
 سعر الخروج: 65800.0,
 نسبة الربح/الخسارة: 4.1,
 تم الحل في: 1711027200
}

عدم القابلية للتغيير. صف دفتر الأستاذ للإضافة فقط. بمجرد تقديم القرار، لا يمكن حذفه، وبمجرد حله، لا يمكن إعادة حله. وهذا يضمن أن السجل الذي تبنيّه صادق ومقاوم للتلاعب.

رموز الخطأ

الحالة	الرمز	الوصف
400	معلمات غير صالحة	معلمات الاستعلام مفقودة أو غير صالحة
401	غير مصرح	مفتاح API مفقود أو غير صالح
403	تقييد الخطة	النقطة النهائية غير متاحة في خطتك الحالية
429	تجاوز الحد الأقصى للمعدل	تم الوصول إلى الحد اليومي أو المفاجئ
500	خطأ داخلي	خطأ في الخادم — تحقق من /health للحصول على حالة المصدر
503	بيانات قديمة	مصدر البيانات غير متاح؛ تم الإرجاع مع آخر بيانات معروفة

أمثلة على الأكواد

Python

استيراد requests

r = requests.get(
 "https://api.smartmoneyapi.com/v1/confirm",
  params={"symbol": "BTC", "direction": "long"},
  headers={X-API-Key: sm_your_key}
)
data = r.json()

print(data["confidence"])  # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0

Python

import requests

API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"

def confirm_trade(symbol, direction):
  resp = requests.get(
    f"{BASE_URL}/confirm",
    params={"symbol": symbol, "direction": direction},
    headers={"X-API-Key": API_KEY},
    timeout=5
  )
  resp.raise_for_status()
 return resp.json()

# In your trading loop:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
 print("Skipping — insufficient confidence")
else:
  size = base_size * signal["size_mult"]
 place_order(symbol, direction, size)

JavaScript / Node.js

JavaScript

const API_KEY = 'sm_your_key';

async function confirmTrade(symbol, direction) {
 const params = new URLSearchParams({ symbol, direction });
 const res = await fetch(
    `https://api.smartmoneyapi.com/v1/confirm?${params}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
 if (!res.ok) throw new Error(`API error: ${res.status}`);
 return res.json();
}

// Usage
confirmTrade('BTC', 'long').then(data => {
  console.log(data.confidence, data.size_mult);
});

cURL

Shell

# Confirm a long trade
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# Get whale data
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/whales?symbol=BTC"

# Check usage
curl -X GET \
  -H X-API-Key: sm_your_key \
 https://api.smartmoneyapi.com/v1/usage

تكامل Freqtrade

أضف تأكيد Smart Money إلى أي إستراتيجية Freqtrade عن طريق تعديل confirm_trade_entry الطريقة.

Python — إستراتيجية Freqtrade

استيراد طلبات
من freqtrade.strategy استيراد IStrategy

فئة إستراتيجية SmartMoney(IStrategy):
  SM_API_KEY = "sm_your_key"
  SM_BASE = "https://api.smartmoneyapi.com/v1"

 def confirm_trade_entry(self, pair, order_type,
                         amount, rate, time_in_force,
                         current_time, entry_tag, **kwargs):
    symbol = pair.split("/")[0]
 if symbol not in ["BTC", "ETH", "SOL"]:
 return True # تخطي التحقق للرموز غير المدعومة
 try:
      r = requests.get(
        f"{self.SM_BASE}/confirm",
        params={"symbol": symbol, "direction": "long"},
        headers={"X-API-Key": self.SM_API_KEY},
        timeout=3
      ).json()
 return r.get("confidence") in ["HIGH", "MEDIUM"]
 except:
 return True # السماح بالمرور في حالة خطأ API

CCXT + Smart Money

Python — CCXT

استيراد ccxt, requests

exchange = ccxt.bybit({
 "apiKey": "YOUR_BYBIT_KEY",
 "secret": "YOUR_BYBIT_SECRET"
})

SM_KEY = "sm_your_key"

def smart_trade(symbol, side, amount):
 # التحقق من التأكيد أولاً
  conf = requests.get(
 "https://api.smartmoneyapi.com/v1/confirm",
    params={"symbol": symbol, "direction": side},
    headers={"X-API-Key": SM_KEY}
  ).json()

 if conf["confidence"] not in ["HIGH", "MEDIUM"]:
 print(f"تخطي {symbol} {side} — ثقة غير كافية.")
 return None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 print(f"تم تنفيذ الأمر: {adj_amount} {symbol} {side}")
 return order

بحاجة إلى مساعدة؟

تحقق من صفحة حالة API للحصول على معلومات الصحة في الوقت الفعلي، أو استخدم نموذج الاتصال.