مرجع API

Smart Money API

یک API هوش حرفه‌ای که داده‌های مشتقات، معیارهای زنجیره‌ای و فعالیت کیف‌پول نهنگ‌ها را در یک امتیاز اعتماد واحد برای ربات معاملاتی شما جمع‌آوری می‌کند.

نسخه فعلی API: v1. آدرس پایه: https://api.smartmoneyapi.com/v1

اصول طراحی

چهار ایده هر نقطه پایان و هر امتیازی که این API برمی‌گرداند را شکل می‌دهد. آن‌ها همچنین مرزهای صادقانه‌ای از آنچه انجام می‌دهد — و نمی‌دهد — هستند.

استراتژی-محور، نه سیگنال-محور. این یک فید سیگنال خرید/فروش نیست. شما استراتژی و نقطه ورود را ارائه می‌دهید؛ API به شما می‌گوید که آیا ساختار بازار پیرامونی — موقعیت‌های مشتقات، تأمین مالی، سود باز، لیکوئیدیشن‌ها، جریان زنجیره‌ای و اجماع نهنگ‌ها — با معامله‌ای که قبلاً می‌خواستید انجام دهید موافق است یا نه.

امتیازدهی اعتماد، نه پیش‌بینی باینری. هر پاسخ شامل یک درجه‌بندی confidence (HIGH / MEDIUM / LOW) و یک composite از -1.0 تا +1.0 است. هیچ تضمینی و هیچ فراخوان اوراکلی وجود ندارد — شما یک خوانش کالیبره شده از توافق، همراه با دلایل پشت آن دریافت می‌کنید، بنابراین می‌توانید اندازه را متناسب با قناعت تنظیم کنید.

پشتیبانی تصمیم، نه توصیه اجرایی. API یک توصیه CONFIRM / REDUCE / SKIP و یک ضریب اندازه برای منطق شما برای اقدام برمی‌گرداند. این API هرگز سفارشی نمی‌گذارد و هیچ چیز در اینجا توصیه مالی نیست. شما همچنان مسئول ریسک، اندازه‌گیری و اجرا هستید.

معیارهای زنده، نه تضمین‌های ثابت. نرخ‌های برد، آمار رژیم‌ها و ارقام دقت از یک نمونه متحرک محاسبه می‌شوند و با حرکت بازارها تغییر می‌کنند. ما آن‌ها را صادقانه منتشر می‌کنیم، حتی زمانی که متوسط هستند. هر معیار را به عنوان یک مشاهده فعلی در نظر بگیرید، نه یک وعده درباره آینده.

این API برای چه کسانی است

این API برای توسعه‌دهندگان ربات‌های کریپتو، الگوریتم‌ها و عامل‌های هوش مصنوعی ساخته شده است که از قبل سیگنال خرید/فروش دارند — از یک استراتژی TA، یک مدل ML، یک خط لوله Freqtrade، یک هشدار TradingView، یا یک عامل LLM — و می‌خواهند یک تصمیم تأیید / کاهش / رد قبل از اختصاص سرمایه بگیرند.

یک حلقه معمولی: استراتژی شما فعال می‌شود "خرید BTC" → شما فراخوانی می‌کنید GET /v1/confirm?symbol=BTC&direction=long → شما تأیید می‌کنید، کاهش می‌دهید یا ورود را رد می‌کنید و اندازه را بر اساس size_mult. یک فراخوانی، یک پاسخ JSON کم‌تأخیر، بدون زیرساخت اضافی.

این نیست یک تولیدکننده سیگنال مستقل، یک محصول نموداری یا یک محل اجرا. اگر سیگنال خود را برای کنترل ندارید، از صفحه عملکرد شروع کنید تا ببینید امتیاز چگونه رفتار کرده است قبل از اتصال آن به یک ربات زنده.

دریافت دسترسی

1 — ثبت‌نام کنید. یک حساب کاربری رایگان در signup ایجاد کنید (ایمیل/رمز عبور یا گوگل). برای سطح رایگان کارت اعتباری نیاز نیست.

2 — داشبورد خود را باز کنید. داشبورد شما کلید API، طرح فعلی و استفاده زنده از سهمیه روزانه شما را نشان می‌دهد.

3 — کلید API خود را کپی کنید. کلیدها با پیشوند sm_هستند. آن را به عنوان X-API-Key هدر در هر درخواست ارسال کنید (مشاهده احراز هویت). هر زمان در صفحه قیمت‌گذاری برای افزایش محدودیت‌ها و باز کردن نمادها و نقاط پایانی بیشتر.

مشخصات، SDK و کتاب آشپزی

همه چیزهایی که برای ادغام سریع نیاز دارید، چه خودتان کد بنویسید چه آن را به یک عامل کدنویسی بسپارید.

منبع	چیست
کتاب آشپزی	دستورالعمل‌های کپی-پیست برای رایج‌ترین ادغام‌ها — قبل از ورود تأیید کنید، یک سیگنال Freqtrade را کنترل کنید، اندازه را با ضریب تنظیم کنید، خطاهای 402/429 را مدیریت کنید و آن را به یک عامل کدنویسی وصل کنید.
مشخصات OpenAPI	تعریف ماشین‌خوان OpenAPI از هر نقطه پایانی. وارد Postman/Insomnia کنید، کلاینت‌ها را تولید کنید یا به یک LLM بدهید. در `github.com/tashiardit/smartmoneyapi-docs`.
کلاینت پایتون	کتابخانه رسمی کلاینت پایتون در `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	خلاصه متنی ساده و مناسب LLM از API. Claude، Codex یا Cursor را به آن اشاره کنید (مشاهده کنید عوامل کدنویسی).

شروع سریع در 2 دقیقه

مرحله 1 — آدرس پایه. هر نقطه پایانی در زیر قرار دارد:

آدرس پایه
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 هدر POST کنید، سپس با بلیط بازگشتی وصل شوید. مشاهده کنید احراز هویت WebSocket (بلیط‌ها).

ورود با گوگل (احراز هویت Firebase)

کاربران می‌توانند با استفاده از حساب گوگل خود از طریق احراز هویت Firebase وارد شوند. پس از ورود موفق با گوگل در کلاینت، توکن ID Firebase را با یک جلسه API مرتبط تعویض کنید. سیستم به طور خودکار هویت گوگل شما را با سیستم کلید API همگام می‌کند.

در دسترس برای: رایگان تریدر حرفه‌ای

POST /auth/google

بدنه درخواست

فیلد	نوع	توضیحات
id_tokenالزامی	رشته	توکن ID Firebase پس از ورود با گوگل در کلاینت دریافت شده است

نمونه پاسخ

JSON

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

داده‌های پروفایل کاربر — ایمیل، طرح، تاریخچه استفاده، ترجیحات — در Firestore ذخیره شده و به حساب گوگل شما مرتبط است. درخواست صدور کامل داده‌ها یا حذف حساب در هر زمان از طریق تنظیمات حریم خصوصی داشبورد امکان‌پذیر است.

محدودیت‌های نرخ

طرح	فراخوانی/روز	محدودیت انفجاری	تأخیر داده
رایگان	50	2/دقیقه	60 ثانیه
تریدر	1,000	20/دقیقه	بلادرنگ
پرو	5,000	60/دقیقه	زمان واقعی
شرکتی	100,000	400/دقیقه	زمان واقعی

هدرهای محدودیت نرخ در هر پاسخ گنجانده شده‌اند: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

URL پایه

https://api.smartmoneyapi.com/v1

تمام نقاط پایانی زیر نسبت به این URL پایه هستند. تمام پاسخ‌ها به صورت 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 بازنشانی می‌شود.,
 وضعیت: 429
}

برای مشاهده لیست کامل کدهای وضعیت (400 / 403 / 500 / 503 و غیره)، به کدهای خطامراجعه کنید. یک پیاده‌سازی قوی، خطاهای 5xx و 429 را موقتی (تلاش مجدد با تاخیر) و خطاهای 401/402/403 را قطعی (رفع کلید یا تغییر طرح) در نظر می‌گیرد.

بهترین روش‌های امنیتی

کلید را در هدر ارسال کنید، نه در URL. همیشه X-API-Key را به عنوان هدر HTTP ارسال کنید. کلیدهای موجود در رشته‌های پرس‌وجو (?key=) توسط پروکسی‌ها، بالانس‌کننده‌های بار و تاریخچه مرورگرها ثبت می‌شوند — روش قدیمی ?key= دیگر در نقاط پایانی WebSocket پذیرفته نمی‌شود دقیقاً به همین دلیل.

کلیدها را در سمت سرور نگه دارید. هرگز کلید API را در جاوااسکریپت سمت کلاینت، بسته برنامه موبایل یا مخزن عمومی قرار ندهید. آن را از یک متغیر محیطی یا مدیر رمز عبور بارگیری کنید. اگر کلیدی افشا شد، آن را تغییر دهید.

کلیدها را به صورت دوره‌ای تغییر دهید. کلید خود را از داشبورد به صورت زمان‌بندی‌شده و بلافاصله در صورت مشکوک بودن به افشا، مجدداً تولید کنید. کلید قدیمی بلافاصله پس از صدور کلید جدید غیرفعال می‌شود.

از بلیط‌ها برای سوکت‌های مرورگر استفاده کنید. برای جریان‌های بلادرنگ از مرورگر، کلید خود را با یک بلیط یک‌بارمصرف جایگزین کنید به جای اتصال با کلید خام — مشاهده کنید احراز هویت WebSocket (بلیط‌ها).

استفاده با عامل‌های کدنویسی / مدل‌های زبانی بزرگ

در حال ساخت با Claude Code، Codex، Cursor یا هر عامل کدنویسی مدل زبانی بزرگ هستید؟ می‌توانید همه چیز مورد نیاز برای اتصال صحیح به این API را یک‌جا به عامل تحویل دهید. دو مرجع ماشین‌خوان منتشر شده است:

منبع	URL
خلاصه مدل زبانی بزرگ	`https://smartmoneyapi.com/llms.txt`
مشخصات OpenAPI	`github.com/tashiardit/smartmoneyapi-docs`

عامل خود را به /llms.txt فایل (طبق llms.txt convention) برای یک نمای کلی مختصر نشانه‌گیری کنید، سپس مشخصات OpenAPI را برای شکل‌های دقیق درخواست/پاسخ بررسی کنید. یک دستور یک‌خطی که خوب جواب می‌دهد:

Prompt

# در Claude Code / Cursor / Codex پیست کنید
خواندن https://smartmoneyapi.com/llms.txt و مشخصات OpenAPI در
github.com/tashiardit/smartmoneyapi-docs، سپس یک بررسی پیش‌از معامله
به ربات من اضافه کنید که GET /v1/confirm را فراخوانی کند و ورودی‌ها را رد کند
مگر اینکه action برابر CONFIRM باشد.

مشاهده کتاب آشپزی برای یک دستورالعمل عملی از کدنویسی عامل.

نقاط پایانی

GET /confirm

نقطه پایانی اصلی. یک امتیاز ترکیبی اطمینان و توصیه اقدام برای جهت معامله داده شده برمی‌گرداند. قبل از ورود به هر موقعیتی این را فراخوانی کنید.

پوشش، به زبان ساده. /confirm امتیازات فعلی BTC، ETH و SOL — نمادهایی با تاریخچه حل‌شده کافی برای تأیید صادقانه. نمایشگر مشتقات به‌صورت جداگانه ~519 بازار مشتقات را رصد می‌کند برای داده‌های تأمین مالی، OI و نقدشوندگی، و رهگیری نهنگ‌ها بیش از 600 کیف‌پول را پوشش می‌دهد. نسخه Pro نمایشگر کامل، خروجی‌ها و پوشش گسترده‌تر بازار را باز می‌کند؛ /confirm پشتیبانی از نمادها با جمع‌آوری سابقه قابل اعتماد برای هر بازار گسترش می‌یابد.

پارامترها

پارامتر	نوع	توضیحات
symbolالزامی	رشته	نماد دارایی. یکی از: `BTC`, `ETH`, `SOL` (Trader+)
directionالزامی	رشته	جهت معامله: `long` یا `short`
sourceاختیاری	رشته	برچسب برای منبع سیگنال شما (برای تحلیل‌ها ثبت می‌شود). حداکثر 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,
 امتیاز مشتقه: 0.81,
 امتیاز آنچین: 0.68,
 امتیاز نهنگ: 0.73,
 امتیاز ایکس: 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	عدد صحیح	Unix timestamp محاسبه
symbol	رشته	نماد دارایی (BTC/ETH/SOL)
direction	رشته	جهت درخواستی (long/short)
composite	عدد اعشاری	امتیاز ترکیبی از -1.0 (مخالف شدید) تا +1.0 (تأیید قوی). نرخ برد نیست.
base_composite	عدد اعشاری	امتیاز ترکیبی قبل از اعمال تنظیمات پس از فیلتر
confidence	رشته	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
action	رشته	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
size_mult	عدد اعشاری	ضریب پیشنهادی اندازه موقعیت (مثلاً 0.0 – 1.5)
unsupported	بولین	`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 نماد: نقشه حرارتی نرخ تأمین، رتبهبندی سود باز و تشخیص سیگنال نسبت خرید/فروش. 10 ردیف اول عمومی است؛ صفحه نمایش کامل نیازمند تریدر یا پرو است. نقاط پایانی: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

تحلیلهای اختیار معامله BTC و ETH از Deribit (عمومی، بدون احراز هویت): نسبت put/call، حداکثر درد و سود باز بر اساس قیمت اعمال. نقاط پایانی: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

خالص جریان روزانه ETFهای BTC و ETH و تفکیک هر صندوق (عمومی). نقاط پایانی: /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 (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

نیازمند: Pro

ثبت یک URL HTTPS برای دریافت پیام‌های رویداد امضا شده در زمان واقعی هنگامی که یک سیگنال در دارایی‌های تحت نظارت شما فعال می‌شود. تحویل‌ها شامل یک X-SmartMoney-Event هدر و یک امضای HMAC-SHA256 در X-SmartMoney-Signatureهستند و حداکثر ۳ بار با تأخیر تصاعدی تکرار می‌شوند.

بدنه درخواست

فیلد	نوع	توضیح
urlالزامی	رشته	نقطه پایان HTTPS برای ارسال رویدادها به آن (باید با `https://`)
eventsالزامی	آرایه	نام رویدادها، مثلاً `["HIGH","MEDIUM","VETO"]` یا `["*"]`
symbolsالزامی	آرایه	نمادها برای فیلتر، مثلاً `["BTC","ETH"]` یا `["*"]`
secretالزامی	رشته	رمز امضای شما، ≥ 16 نویسه (ذخیره شده به صورت هش)

تأیید امضا

کلید HMAC، هگز دایجست SHA-256 رمز ثبت شده شماست. HMAC-SHA256 بدنه خام درخواست را با آن کلید محاسبه و (در زمان ثابت) با X-SmartMoney-Signature. ببینید راهنمای پیاده‌سازی Webhook.

هوشمندی

GET /analysis

نیازمند: پرو

بازگشت طبقه‌بندی رژیم بازار با قابلیت تشخیص تضاد سیگنال‌ها توسط هوش مصنوعی. تحلیل توافق بین سیگنال‌ها، شناسایی واگرایی‌ها بین داده‌های مشتقات، زنجیره‌ای و نهنگ‌ها، و تولید یک خلاصه به زبان طبیعی با عوامل ریسک آینده‌نگر و توصیه‌ای با افق زمانی.

پارامترها

پارامتر	نوع	توضیحات
symbolالزامی	رشته	نماد دارایی: `BTC`, `ETH`، یا `SOL`

نمونه پاسخ

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "Late Cycle — Signal Divergence",
 "summary": "BTC در فاز پایانی چرخه صعودی قرار دارد با قدرت زنجیره‌ای در تضاد با گسترش بیش از حد مشتقات. نهنگ‌ها در حال کاهش مواجهه هستند در حالی که LSR خرده‌فروشی در حال افزایش است.",
 "signal_conflicts": [
 "امتیاز نهنگ نزولی در حالی که امتیاز زنجیره‌ای صعودی است",
 "نرخ تأمین در بالاترین سطح ۳ ماه — ریسک احتمالی فشار"
  ],
 "risk_factors": ["تأمین مالی بالا", "واگرایی OI", "کاهش نهنگ"],
 "recommendation": "مواجهه طولانی را کاهش دهید، استاپ‌ها را محکم کنید. از موقعیت‌های طولانی جدید بالاتر از قیمت فعلی اجتناب کنید.",
 "time_horizon": "4h–12h"
}

پلن پرو مورد نیاز است. این نقطه پایانی به دلیل سربار پردازش هوش مصنوعی، ۳ فراخوانی API در هر درخواست مصرف می‌کند.

GET /liquidations

نیازمند: تریدر پرو

بازگشت دو دیدگاه مکمل: (1) پیش‌بینی شده با اهرم levels — تخمینی از جایی که خوشه‌های تسویه قرار دارند؛ و (2) یک realized_heatmap — واقعی اجرا شده شدت تسویه اجباری (قیمت × زمان)، جمع‌آوری شده زنده از فیدهای WebSocket صرافی‌های عمومی: Binance, OKX, Bybit, Bitget, BitMEX. نقشه حرارتی زمانی نمایش داده می‌شود که جریان داده برای نماد وجود داشته باشد (در بازار بسیار آرام یا بلافاصله پس از راه‌اندازی отсут دارد).

پارامترها

پارامتر	نوع	توضیحات
symbolاختیاری	رشته	نماد دارایی (پیش‌فرض `BTC`). نقشه حرارتی واقعی نمادهای پرطرفدار پرپ را پوشش می‌دهد.

نمونه پاسخ

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // تسویه‌های واقعی اجرا شده — زنده از ۵ صرافی
 "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 }
  }
}

پلن تریدر: cascade_risk، نزدیک‌ترین فاصله‌ها، و مجموع/براساس طرف واقعی. پلن پرو: پیش‌بینی کامل levels به علاوه کامل realized_heatmap (ماتریس‌ها، خوشه‌های هر قیمت، تعداد هر صرافی). تخمین پیش‌بینی شده پاسخ می‌دهد "استاپ‌ها کجا هستند"؛ نقشه حرارتی واقعی نشان می‌دهد "چه چیزی واقعاً تسویه شده است."

GET /liquidations/heatmap

در دسترس برای: رایگان نیاز به احراز هویت ندارد (محدود شده براساس IP)

عمومی نقشه حرارتی تسویه سطح قیمت. بازگشت یک ماتریس قیمت × زمان به سبک Coinglass از واقعی اجرا شده تسویه‌های اجباری، دسته‌بندی شده براساس قیمتی که هر تسویه در آن ثبت شده — جمع‌آوری شده زنده از فیدهای WebSocket صرافی‌های عمومی: Binance, OKX, Bybit, Bitget, BitMEX. آرایه clusters خروجی عملی است: سطل‌های قیمت رتبه‌بندی شده براساس ارزش اسمی تسویه شده، هر کدام با طرف غالب خود برچسب گذاری شده‌اند. داده‌ها به جریان زنده بستگی دارند — یک نماد بسیار آرام یا یک دروازه تازه راه‌اندازی شده ساختار خالی به‌خوبی شکل‌گرفته به همراه یک noteصادقانه بازمی‌گرداند. سطوح نمایش داده شده فقط تسویه‌های واقعی هستند، هرگز تخمینی نیستند.

پارامترها

پارامتر	نوع	توضیحات
symbolاختیاری	string	نماد دارایی (پیش‌فرض `BTC`).
window_minutesاختیاری	int	بازه زمانی بازگشت به عقب بر حسب دقیقه (پیش‌فرض `240`، محدود به ۵–۱۴۴۰).
price_bucketsاختیاری	int	تعداد سطل‌های قیمت (پیش‌فرض `50`، محدود به ۵–۱۰۰).

نمونه پاسخ

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

نیازمند: تریدر پرو

اجرا شده تسویه‌های وام‌دهی دیفای روی زنجیره که مستقیماً از گره‌های کامل محلی ما BSC + Avalanche ثبت شده‌اند — مستقل از هر ربات معاملاتی. شامل Venus/Cream و Moolah روی BSC، و AAVE V3/V2، Benqi، BankerJoe، Granary و Vinium روی Avalanche می‌شود. سطح پرو همچنین at_risk موقعیت‌ها را بازمی‌گرداند (وابسته به ربات، ممکن است وجود نداشته باشد).

پارامترها

پارامتر	نوع	توضیحات
chainاختیاری	string	`bsc` یا `avax`. برای همه زنجیره‌ها حذف کنید.
limitاختیاری	integer	حداکثر سطرها (پیش‌فرض ۱۰۰، حداکثر ۵۰۰). جدیدترین‌ها اول.

نمونه پاسخ

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, بازپرداخت دلار شناخته شده: 148230.55 } },
 گره‌ها: { bsc: { قابل دسترس: true, بلوک سر: 89173010, رویدادهای کل: 61 } }
  }
}

GET /smart-stop

نیازمند: معامله‌گر حرفه‌ای

سطوح هوشمند حد ضرر را بر اساس نقشه حرارتی نقدینگی فعلی، باندهای نوسان و ساختار بازار محاسبه می‌کند. توصیه‌های طبقه‌بندی شده حد ضرر و پیشنهادهای حد سود متناسب با قیمت ورود و تحمل ریسک شما را بازمی‌گرداند.

پارامترها

پارامتر	نوع	توضیحات
نمادالزامی	رشته	نماد دارایی: `BTC`, `ETH`، یا `SOL`
جهتالزامی	رشته	جهت موقعیت: `long` یا `short`
قیمت_وروداختیاری	عدد اعشاری	قیمت ورود شما. در صورت عدم تعیین، به صورت پیش‌فرض قیمت فعلی بازار در نظر گرفته می‌شود.
درصد_ریسکاختیاری	عدد اعشاری	حداکثر ریسک قابل قبول به عنوان درصدی از حساب. پیش‌فرض: `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

نیازمند: معامله‌گر حرفه‌ای

فرصت‌های آربیتراژ نرخ تأمین مالی بین صرافی‌ها را به صورت بلادرنگ شناسایی می‌کند. فرصت‌های رتبه‌بندی شده با بازده سالانه تخمینی، جفت صرافی بهینه و اقدام پوشش ریسک مورد نیاز برای کسب اسپرد را بازمی‌گرداند.

پارامترها

پارامتر	نوع	توضیحات
حداقل_اسپرداختیاری	عدد اعشاری	حداقل اسپرد نرخ تأمین مالی برای включение (به صورت اعشاری). پیش‌فرض: `0.01`
نماداختیاری	رشته	فیلتر برای یک دارایی خاص. برای اسکن تمام دارایی‌های پشتیبانی شده، خالی بگذارید.

نمونه پاسخ

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
    }
  ]
}

طرح معامله‌گر: فقط 1 فرصت برتر، بدون داده‌های تاریخی اسپرد. طرح حرفه‌ای: تمام فرصت‌های فعلی با تاریخچه اسپرد 24 ساعته برای هر جفت صرافی.

نسخه عمومی رایگان بدون احراز هویت

یک نقطه پایان عمومی بدون کلید، 10 فرصت برتر را با یک صفحه نمایشگر بین صرافی زنده بازمی‌گرداند که برای قرارگیری یا بررسی سریع ایده‌آل است. تاریخچه اسپرد برای هر نماد و فیلدهای سنگین را حذف می‌کند و از یک حافظه پنهان 120 ثانیه‌ای سرویس می‌دهد. هنگامی که هیچ اسپرد تأمین مالی بین صرافی در پنجره تازگی وجود نداشته باشد، یک opportunities آرایه خالی با note برمی‌گرداند — هرگز داده‌های جعلی.

GET (بدون احراز هویت)

GET /v1/derivatives/funding-arb

JSON

{
 "opportunities": [
    {
 نماد: OGN,
 درصد اسپرد: 0.297667,
 سود سالانه (APR): 325.95,
 صرافی لانگ: bybit,
 صرافی شورت: hyperliquid,
 سود تخمینی به ازای هر 10 هزار: 29.77,
 ملاحظات ریسک: اسپرد کم — اطمینان حاصل کنید که کارمزدها حاشیه آربیتراژ را از بین نبرند.
    }
  ],
 نمادهای اسکن شده: 222,
 ts: 1783268753,
 عمومی: True,
 محدود: True
}

رایگان، بدون نیاز به کلید API. فقط 10 فرصت برتر، محدود و کش شده (120 ثانیه). صفحه نمایش زنده: funding-arb.html.

GET /smart-money/flow

نیازمند: تریدر حرفه‌ای

یک شاخص وزنی کیفیت شاخص جهت‌گیری نهنگ‌ها به ازای هر نماد، امتیازدهی شده -100 (تمایل نهنگ‌ها به شورت) تا +100 (تمایل به لانگ). ساخته شده از هزاران کیف پول نهنگ‌های Hyperliquid — هر کدام با وزن خود بر اساس سابقه برد و سود/زیان و کاهش بر اساس زمان. این یک شاخص موقعیت‌یابی است، نه سیگنال خرید/فروش یا پیش‌بینی قیمت. نمادهایی با تعداد کم کیف پول مشارکت‌کننده به صورت thin برچسب‌گذاری و امتیازدهی شده‌اند. صفحه نمایش زنده: smart-money-flow.html.

پارامترها

پارامتر	نوع	توضیحات
نماداختیاری	رشته	یک نماد (مثلاً `BTC`). حذف کنید تا تمام نمادهای ردیابی شده بر اساس \|امتیاز\| رتبه‌بندی شوند.
window_hoursاختیاری	عدد صحیح	بازه زمانی امتیازدهی، محدود به `1..168`. پیش‌فرض `24`.

مثال پاسخ

JSON

{
 نمادها: [
    {
 نماد: SPX,
 امتیاز: -90.93,
 جهت: شورت قوی,
 تعداد کیف‌پول‌ها: 26,
 لانگ دلاری: 184200.0, شورت دلاری: 2410000.0,
 وزن کیفیت: True,
 نمونه کیفیت: غنی,
 مشارکت‌کنندگان برتر: [ { کیف پول: 0x31ca…974b, جهت: شورت, ارزش دلاری: 5338.25, وزن: 0.4948 } ]
    }
  ],
 window_hours: 24,
 وزن کیفیت: True,
 ts: 1783270000,
 یادداشت: شاخص وزنی کیفیت جهت‌گیری نهنگ‌ها (100- تا 100+). نه یک پیش‌بینی قیمت یا سیگنال خرید/فروش.
}

پلن تریدر: 12 نماد برتر، جزئیات مشارکت‌کنندگان محفوظ. پلن حرفه‌ای: تمام نمادها با top_contributors. وزن کیف‌پول‌ها محدود به [0.25,1.0]؛ سود/زیان یک نماینده تحقق نیافته از آخرین تصاویر موقعیت است.

GET /v1/whales/crowding

در دسترس برای: رایگان نیاز به احراز هویت ندارد — کاربران ناشناس 10 نماد برتر را دریافت می‌کنند، تریدر+ لیست کامل را دریافت می‌کند

ترکیبی موقعیت‌یابی نهنگ‌ها و زمینه شلوغی به ازای هر نماد، ادغام شده در 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اختیاری	عدد اعشاری	حداقل ناخالص ترکیبی (دلار) برای یک نماد تا شامل شود. پیش‌فرض: `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,
 صرافی‌ها: {
 hl: { کل: 1900000000.0, خالص: -40000000.0, تعداد نهنگ‌ها: 272 },
 gmx: { کل: 320000000.0, خالص: -6000000.0, تعداد نهنگ‌ها: 59 },
 jupiter: { کل: 227900000.0, خالص: -5000000.0, تعداد نهنگ‌ها: 83 }
      },
 تمرکز در ۳ مورد اول: 0.159, hhi: 0.011, میانگین وزنی اهرم: 19.1,
 نقدشوندگی در محدوده ۵٪: { long: 621700000.0, short: 665600000.0 },
 نقدشوندگی در محدوده ۱۰٪: { long: 840000000.0, short: 910000000.0 },
 شاخص ازدحام: 0.003
    }
  ],
 ملاحظات: [ فاصله‌های لیکوییداسیون برآوردهای حاشیه ایزوله هستند، نه گزارش شده توسط صرافی. ]
}

یادداشت صادقانه: skew است net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). فقط صرافی‌هایی که واقعاً حضور دارند در venuesنمایش داده می‌شوند. پوزیشن‌های بدون اهرم از سطل‌های لیکویید حذف می‌شوند تا فرض نشوند. تماس‌گیرندگان ناشناس ۱۰ نماد برتر بر اساس کل (با gated: true) دریافت می‌کنند؛ کاربران Trader+ لیست کامل را دریافت می‌کنند.

GET /v1/options/gex

در دسترس برای: رایگان نیاز به احراز هویت ندارد (محدودیت درخواست بر اساس IP)

Dealer گاما اکسپوژر (GEX) تحلیل‌ها برای BTC & ETH, که به صورت زنده از زنجیره اختیار معامله عمومی Deribit محاسبه می‌شود (بدون احراز هویت). GEX خالص دیلر را در هر استرایک برمی‌گرداند (طبق قرارداد SpotGamma دیلر-شورت)، سطح گاما-فلیپ (استرایکی که در آن GEX خالص تجمعی از صفر عبور می‌کند)، ساختار مدت IV (نوسان ضمنی ATM بر اساس روزهای باقی‌مانده تا انقضا)، و انحراف IV (ریسک ریورسال پروکسی ۲۵Δ). رژیم GEX positive (دیگران گاما لانگ → سرکوب نوسان) یا negative (تقویت نوسان) است. کاملاً مستقل — در هر درخواست مجدداً محاسبه می‌شود، وابستگی به پایگاه داده ذخیره‌شده ندارد.

پارامترها

پارامتر	نوع	توضیحات
نماداختیاری	رشته	`BTC` یا `ETH` فقط. پیش‌فرض: `BTC`.

درخواست نمونه

GET (بدون احراز هویت)

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

پاسخ نمونه

JSON

{
 "نماد": "BTC", "موجود": true, "نقطه‌ای": 63203.0,
 "GEX_خالص": 18240000.0, "رژیم": "مثبت",
 "گاما_فلیپ": 64919.82, "گاما_فلیپ_درصد": 2.72,
 "GEX_کال": 31200000.0, "GEX_پوت": -12960000.0,
 "براساس_استرایک": [
    { "استرایک": 60000, "GEX_خالص": -2100000.0 },
    { "استرایک": 65000, "GEX_خالص": 4800000.0 }
  ],
 "ساختار_مدت": [
    { "انقضا": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
    { "انقضا": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
  ],
 "انحراف": {
 "انقضا": "8JUL26", "dte": 0.76,
 "put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
 "ریسک_ریورسال": 14.35, "تمایل": "ترس_نزولی"
  }
}

یادداشت صادقانه: ضریب قرارداد Deribit برابر ۱ است (OI بر اساس سکه). در صورت هرگونه خطای واکشی، نقطه پایانی available: false با پنل‌های خالی برمی‌گردد — هرگز GEX جعلی نیست. انحراف IV از یک پروکسی ثابت ±۱۰٪ استرایک برای ۲۵Δ استفاده می‌کند (۲۵-دلتای واقعی نیاز به حل دلتا برای هر استرایک دارد)؛ مناسب برای نمایش، به عنوان یک تقریب مستند شده است.

GET /v1/liquidations/simulate

در دسترس برای: رایگان نیاز به احراز هویت ندارد (محدودیت درخواست بر اساس IP)

تعاملی تست استرس آبشار لیکوییدبا فرض حرکت فرضی قیمت، موقعیت‌های اهرمی که لیکویید می‌شوند، حجم اجباری بر اساس سطح قیمت/جهت/صرافی و خوانش عمق آبشار را برمی‌گرداند. حرکت نزولی باعث لیکویید پوزیشن‌های لانگ می‌شود که قیمت لیکویید آنها در/بالای هدف قرار دارد؛ حرکت صعودی باعث لیکویید پوزیشن‌های شورت می‌شود که قیمت لیکویید آنها در/زیر آن قرار دارد. دو روش مستقل ادغام شده‌اند: قیمت‌های دقیق لیکویید از نهنگ‌های ردیابی‌شده Hyperliquid واقعی اهرم/ورود، به علاوه خوشه‌های آماری باند OI برای هر صرافی (اهرم جمعی استنباط شده از فاندینگ). همه چیز به وضوح برچسب‌گذاری شده است 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.

پارامترها

پارامتر	نوع	توضیحات
آدرسالزامی	رشته	آدرس کیف پول (بخش مسیر)، به عنوان مثال `/v1/wallet/0x3bcae23e…/profile`.
روزهااختیاری	عدد صحیح	پنجره بازگشت به عقب برای سری و جدول زمانی. پیش‌فرض: `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": "آندره برگشته", "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 نهional باز است. سود و زیان تحقق یافته در هر دور کامل نامعلوم است (فقط تصاویر باز را می‌بینیم، نه معاملات بسته‌شونده) و به صورت null / —نمایش داده می‌شود؛ رویدادهای بسته شدن خط زمانی ادعای سود و زیان ندارند. یک آدرس معتبر اما ردیابی‌نشده برگردانده می‌شود tracked: false با یک یادداشت؛ یک آدرس نامعتبر برگردانده می‌شود ok: false, error: "invalid_address" (HTTP 400). برچسب لیست رهبران HL، وضعیت پنجره خود HL در زمان کشف است، نه محاسبه شده توسط ما.

GET /flows

نیازمند: Pro

داده‌های جریان سرمایه چنددارایی را برمی‌گرداند که الگوهای چرخش بین BTC، ETH و SOL را در چندین بازه زمانی نشان می‌دهد. برای شناسایی اینکه کدام دارایی در حال تجمع سرمایه و کدام در حال توزیع در هر لحظه است مفید است.

نمونه پاسخ

JSON

{
 زمان‌مهر: 1710940821,
 جریان‌ها: {
 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 }
  },
 چرخش‌های تشخیص داده شده: [
 سرمایه در حال چرخش از ETH به BTC در بازه 4 ساعته,
 تجمع SOL در تمام بازه‌ها ثابت است
  ]
}

نیازمند طرح Pro. مقادیر جریان، خالص ورود (مثبت) یا خروج (منفی) دلاری در هر بازه زمانی است.

GET /whale-events

نیازمند: Trader Pro

تغییرات قابل توجه پوزیشن نهنگ‌ها — بازکردن، بستن و تغییر جهت — را که در کیف‌پول‌ها و آدرس‌های زنجیره‌ای ردیابی‌شده در بازه زمانی مشخص تشخیص داده شده‌اند، برمی‌گرداند.

پارامترها

پارامتر	نوع	توضیح
نماداختیاری	رشته	فیلتر بر اساس دارایی. برای همه دارایی‌های تحت نظر حذف کنید.
اهمیتاختیاری	رشته	فیلتر بر اساس اهمیت رویداد: `high`, `medium`، یا `all`. پیش‌فرض: `all`
ساعتاختیاری	عدد صحیح	بازه زمانی به ساعت. پیش‌فرض: `24`

نمونه پاسخ

JSON

{
 نماد: BTC,
 خلاصه: {
 تغییر جهت به خرید: 3,
 تغییر جهت به فروش: 1,
 بازکردن‌های جدید: 7,
 بستن‌ها: 2
  },
 رویدادها: [
    {
 type: flip_long,
 wallet: 0xWhale...a4f2,
 direction: long,
 size_usd: 4200000,
 ts: 1710938400
    }
  ]
}

Trader plan: Returns the summary object only. Pro plan: Full events feed with wallet identifiers, sizes, and timestamps.

GET /regimes/history

Requires: Pro

Returns historical regime classification data for a given asset. Use this to backtest how specific regime types have performed historically, how long each regime type typically lasts, and how regime transitions unfold over time.

Parameters

Parameter	Type	Description
symboloptional	string	Asset symbol. Default: `BTC`
regimeoptional	string	Filter to a specific regime type, e.g. `late_cycle_divergence`. Omit for all regimes.
daysoptional	integer	Look-back window in days. Default: `30`. Maximum: `365`

Example Response

JSON

{
 symbol: BTC,
 current_regime: late_cycle_divergence,
 regime_summary: {
 late_cycle_divergence: { occurrences: 4, avg_duration_h: 38, avg_return_pct: -2.1 },
 accumulation: { occurrences: 6, avg_duration_h: 72, avg_return_pct: 5.4 },
 breakout: { occurrences: 3, avg_duration_h: 18, avg_return_pct: 9.2 }
  },
 transitions: [
    { from: accumulation, to: breakout, ts: 1710850000 },
    { from: breakout, to: late_cycle_divergence, ts: 1710915000 }
  ]
}

Pro plan required. Combine with /analysis to validate strategy assumptions against historical regime performance data.

GET /exchange-health

Available to: Free Trader Pro

Returns real-time health status for all monitored exchanges including per-exchange latency, error rates, and data staleness indicators. No authentication required — publicly accessible endpoint.

Example Response

JSON

{
 overall_status: ok,
 ts: 1710940821,
 exchanges: {
 bybit: { status: ok, latency_ms: 42, error_rate_1h: 0.0, last_data_age_s: 18 },
 binance: { status: ok, latency_ms: 38, error_rate_1h: 0.0, last_data_age_s: 22 },
 hyperliquid: { status: degraded, latency_ms: 310, error_rate_1h: 0.04, last_data_age_s: 95 },
 okx: { status: ok, latency_ms: 55, error_rate_1h: 0.0, last_data_age_s: 30 }
  }
}

GET /sentiment

Requires: Trader Pro

Returns a real-time Fear & Greed index (0-100) computed from derivatives sentiment, whale activity, volatility, and social signals. Includes component breakdown and 24-hour history for trend analysis.

Parameters

Parameter	Type	Description
symboloptional		نماد دارایی. پیش‌فرض: `BTC`

نمونه پاسخ

JSON

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

معادل رقیب: Santiment Social Volume + Alternative.me Fear & Greed — ترکیب شده در یک نقطه پایانی واحد با تجزیه‌جزء اجزا.

ادغام‌ها

GET /tradingview/setup

نیازمند: تریدر پرو

تنظیمات ادغام TradingView شخصی‌سازی شده شما را برمی‌گرداند: URL وب‌هوک، رمز برای اعتبارسنجی و اسکریپت‌های Pine آماده‌استفاده که مستقیماً به Smart Money API متصل می‌شوند. اسکریپت Pine را در 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

در دسترس برای: تریدر پرو

هشدار TradingView را دریافت می‌کند، آن را از طریق /confirmاجرا می‌کند و تأییدیه را برمی‌گرداند. TradingView نمی‌تواند هدرهای سفارشی ارسال کند، بنابراین با قرار دادن وب‌هوک خود secret در بدنه JSON احراز هویت کنید (این نقطه پایانی از X-API-Key استفاده نمی‌کند). پاسخ تأییدیه را می‌پوشاند و یک سطح بالاتر action از CONFIRMED (اعتماد دیمن HIGH/MEDIUM) یا VETOED.

بدنه درخواست

JSON

{
 "secret": "your_webhook_secret",
 "symbol": "BTC",
 "direction": "long",
 "timeframe": "1h",
 "strategy": "EMA crossover",
 "price": 67500.0
}

الزامی: secret, symbol, direction (long|short). اختیاری: source, timeframe, strategy, price.

شخصی‌سازی

GET /preferences

نیازمند: تریدر پرو

تنظیمات شخصی‌سازی فعلی شما را برمی‌گرداند، شامل پارامترهای پیش‌فرض معاملات، پروفایل ریسک، لیست پیگیری و ترجیحات اعلان.

PUT /v1/preferences

تنظیمات را با ارسال یک بدنه JSON با هر زیرمجموعه‌ای از فیلدهای زیر به‌روزرسانی کنید. فیلدهای حذف شده مقادیر فعلی خود را حفظ می‌کنند.

فیلدهای ترجیح

فیلد	نوع	توضیحات
default_trade_size_usd	float	اندازه موقعیت پیش‌فرض به دلار برای محاسبات Kelly و توقف هوشمند
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 خودمان شناسایی و استریم کنید. دو روش انتقال در دسترس است: یک استریم عمومی Server-Sent Events (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 Firehose (پولی)

نیازمند: Trader Pro

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

احراز هویت (توصیه می‌شود): هرگز کلید ماندگار خود را در URL قرار ندهید — توسط پراکسی‌ها ثبت می‌شود و در تاریخچه مرورگر ذخیره می‌شود. در عوض، کلید خود را به /v1/ws/ticket با استفاده از هدر امن X-API-Key ارسال کنید، سپس سوکت را با ticket (معتبر ~60 ثانیه، یکبار مصرف) باز کنید. کلاینت‌های سمت سرور که می‌توانند هدرها را تنظیم کنند، می‌توانند X-API-Key را مستقیماً در handshake ارسال کنند. کلیدهای رایگان یک 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 قرار ندهید — رشته‌های کوئری توسط پراکسی‌ها، بالانس‌کننده‌های بار و تاریخچه مرورگر ثبت می‌شوند. در عوض، کلید خود را به یک بلیط کوتاه‌مدت و یکبار مصرف از طریق یک POST احراز هویت شده معمولی تبدیل کنید، سپس با آن بلیط متصل شوید.

فرآیند: POST به /v1/ws/ticket با هدر X-API-Key → دریافت { "ticket": "…", "expires_in": 60 }. سپس باز کنید wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. The ticket is یکبارمصرف و منقضی می‌شود در ~60 ثانیه. کلاینت‌های سمت سرور که می‌توانند هدرهای درخواست را تنظیم کنند، می‌توانند به جای آن X-API-Key مستقیماً در handshake WebSocket ارسال کنند — نیازی به تیکت نیست.

POST /v1/ws/ticket

نیازمند: تریدر حرفه‌ای

یک تیکت یک‌بارمصرف برای handshake 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	string	توکن یکبارمصرف برای اضافه کردن به عنوان `?ticket=` در URL WebSocket. یک بار استفاده می‌شود، سپس باطل می‌شود.
expires_in	number	ثانیه تا انقضای تیکت (~60). برای هر تلاش اتصال یک تیکت تازه ایجاد کنید.

توجه: احراز هویت قدیمی از طریق ?key= پارامتر کوئری دیگر پذیرفته نمی‌شود در نقاط پایانی WebSocket به دلایل امنیتی. از یک تیکت (برای کلاینت‌های مرورگر) یا X-API-Key هدر handshake (برای کلاینت‌های سمت سرور) استفاده کنید.

نمونه REST

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

آخرین N سوآپ‌های پخش شده از بافر rolling را برمی‌گرداند. برای نمایش اولیه در داشبوردها قبل از باز شدن اتصال جریان مفید است. همچنین قابل دسترسی است: /v1/live-swaps/status برای آمار broadcaster.

طرح رویداد

فیلد	نوع	توضیحات
chain	string	`bsc` یا `avalanche`
dex	string	نام روتر (مثلاً `pancakeswap_v2`, `traderjoe`) یا `unknown_dex`
مبادله‌کننده	رشته	آدرس کامل 0x کیف پولی که مبادله را انجام داده است
مبادله‌کننده_کوتاه	رشته	فرم کوتاه‌شده برای نمایش (مثلاً `0xb300…028d`)
لینک_مبادله‌کننده	رشته	لینک مستقیم به مبادله‌کننده در اکسپلورر بلاک چین
هش_تراکنش	رشته	هش تراکنش
لینک_اکسپلورر	رشته	لینک مستقیم به تراکنش در BscScan / Snowtrace
توکن_ورودی	رشته	نماد توکن فروخته شده (مثلاً `USDT`)
توکن_خروجی	رشته	نماد توکن خریداری شده
مقدار_دلاری	عدد	ارزش دلاری مبادله (حداقل: 500 دلار)
جفت	رشته	برچسب جفت فرمت‌شده (مثلاً `USDT → USDC`)
بلوک	عدد	شماره بلوکی که مبادله در آن ثبت شده است
زمان_ثبت	عدد	ثانیه‌های یونیکس اپاک
اهمیت	رشته	`low` / `medium` / `high` / `critical` بر اساس اندازه دلاری
ترتیب	عدد	عدد ترتیب پخش یکنواخت — برای تشخیص فاصله استفاده می‌شود

POST /alerts/conditions

نیازمند: پرو

قوانین هشدار سفارشی ایجاد کنید که هنگام عبور یک متریک مشخص از آستانه، فعال می‌شوند. هشدارها بسته به ترجیحات شما از طریق وب‌هوک، ایمیل یا فید اطلاع‌رسانی داشبورد تحویل داده می‌شوند.

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` (پیش‌فرض) یا `webhook`
cooldown_minutesoptional	integer	حداقل دقیقه بین فعال‌سازی مجدد (پیش‌فرض 60)

لیست زنده متریک‌ها و عملگرهای معتبر توسط GET /v1/alerts/conditions as available_metrics and available_operators.

متریک‌های موجود

Metric	Description
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 — Example Body

{
 "name": "BTC funding rate spike",
 "metric": "funding_rate",
 "symbol": "BTC",
 "operator": "gt",
 "threshold": 0.05
}

GET /kelly

Requires: Pro

توصیه‌های اندازه‌گیری موقعیت بر اساس معیار کالی که با عملکرد تاریخی سیگنال برای نماد، سطح اطمینان و جهت تنظیم شده است. اندازه موقعیت را بر اساس نرخ برد تجربی تنظیم می‌کند تا از اهرم بیش از حد جلوگیری شود.

Parameters

Parameter	Type	Description
symbolrequired	string	نماد دارایی: `BTC`, `ETH`, یا `SOL`
confidenceoptional	string	سطح اطمینان سیگنال برای مدل‌سازی: `HIGH`, `MEDIUM`, یا `LOW`. پیش‌فرض: `HIGH`
directionoptional	string	جهت معامله: `long` یا `short`. پیش‌فرض: `long`
account_sizeoptional	float	اندازه حساب به دلار برای محاسبه `suggested_size_usd`. پیش‌فرض: `10000`

Example Response

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": "Half-Kelly برای معاملات زنده توصیه می‌شود تا خطای تخمین را در نظر بگیرد."
}

پلن حرفه‌ای مورد نیاز است. محاسبات بر اساس نمونه‌ای ۹۰ روزه از سیگنال‌های تاریخی منطبق با نماد، سطح اطمینان و پارامترهای جهت درخواستی انجام می‌شود.

GET /performance

دسترسی برای: رایگان تریدر حرفه‌ای

آمار دقت تاریخی سیگنال‌های صادر شده توسط API را بر اساس سطح اطمینان ارائه می‌دهد. برای درک قابلیت اطمینان سیگنال‌ها قبل از سرمایه‌گذاری مفید است.

پارامترها

پارامتر	نوع	توضیحات
symbolاختیاری	string	فیلتر بر اساس دارایی. برای آمار کلی در تمام نمادها، این پارامتر را حذف کنید.
daysاختیاری	integer	بازه زمانی به روز. پیش‌فرض: `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 نتایج distinct-call. نرخ برد در سطوح اطمینان HIGH و MEDIUM، دقت کلی، فاکتور سود و تجزیه‌وتحلیل به ازای هر نماد را برمی‌گرداند. تمام ارقام درون نمونه‌ای در طول پنجره امتیازدهی هستند؛ برای روش‌شناسی و زمینه، به 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: { نرخ برد: 0.68, n: 22 },
 ETH: { نرخ برد: 0.55, n: 18 },
 SOL: { نرخ برد: 0.60, n: 8 }
  },
 forward_holdout: {
 نرخ برد: 0.59,
 نرخ برد بالا: 0.70,
 n بالا: 10,
 متمایز از داده‌های درون‌نمونه: False
  }
}

هشدار درون‌نمونه. تمام ارقام در این پاسخ از دوره‌ای محاسبه شده‌اند که برای تنظیم امتیازدهنده استفاده شده است. این forward_holdout شیء تنها عددی است که از داده‌هایی جمع‌آوری شده که امتیازدهنده هرگز ندیده است — تماشا کنید که چگونه با گذشت زمان رشد می‌کند. مشاهده کنید calibration.html برای روش‌شناسی کامل و مرز بین درون‌نمونه و آزمون پیش‌رو.

GET /v1/signals/performance

در دسترس برای: رایگان معامله‌گر حرفه‌ای نیاز به احراز هویت ندارد

ردیابی نتایج سیگنال در چندین افق زمانی (4h, 12h, 24h, 72h). نرخ‌های موفقیت در هر افق، تعداد کل سیگنال‌ها و تفکیک بر اساس نوع سیگنال را برمی‌گرداند.

پارامترها

پارامتر	نوع	توضیحات
daysاختیاری	عدد صحیح	بازه زمانی بازگشت به گذشته بر حسب روز. پیش‌فرض: `30`
signal_typeاختیاری	رشته	فیلتر بر اساس نوع، مثلاً `smart_money_confirm` or `regime_flip`. حذف کنید برای همه انواع.
symbolاختیاری	رشته	فیلتر بر اساس نماد دارایی، مثلاً `BTC`. حذف کنید برای تجمیع across همه نمادها.

نمونه پاسخ

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

در دسترس برای: رایگان معامله‌گر حرفه‌ای نیاز به احراز هویت ندارد

فید سیگنال‌های اخیراً منتشرشده با سطح HIGH و MEDIUM در تمام نمادهای تحت نظارت. هر ورودی شامل نوع سیگنال، سطح اطمینان، جهت و وضعیت حل‌شدگی در صورت موجود بودن می‌شود.

نمونه پاسخ

JSON

{
 سیگنال‌ها: [
    {
 شناسه: 1042,
 نماد: BTC,
 جهت: long,
 نوع سیگنال: تأیید هوشمند پول,
 اطمینان: HIGH,
 ترکیبی: 0.74,
 زمان‌مهر: 1710940821,
 حل‌شده: true,
 نتیجه 24h: برد
    }
  ],
 تعداد: 50
}

GET /v1/signals/{id}/outcome

در دسترس برای: رایگان معامله‌گر حرفه‌ای نیاز به احراز هویت ندارد

نتیجه حل‌شده برای یک سیگنال واحد بر اساس شناسه عددی آن. بازدهی برد/باخت در هر افق حل‌شدگی (4h, 12h, 24h, 72h) به همراه قیمت در زمان سیگنال و در زمان حل‌شدگی را برمی‌گرداند.

پارامترها

پارامتر	نوع	توضیحات
شناسهالزامی	عدد صحیح	شناسه سیگنال (بخش مسیر)، مثلاً `/v1/signals/1042/outcome`

نمونه پاسخ

JSON

{
 شناسه: 1042,
 نماد: BTC,
 جهت: long,
 اطمینان: HIGH,
 قیمت ورود: 63200.0,
 زمان‌مهر: 1710940821,
 نتایج: {
 4h: { نتیجه: برد, قیمت: 64100.0, درصد: 1.41 },
 12h: { نتیجه: برد, قیمت: 65200.0, درصد: 3.16 },
 24h: { نتیجه: برد, قیمت: 65800.0, درصد: 4.11 },
 72h: { نتیجه: در انتظار, قیمت: null, درصد: 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

{
 نرخ برد بالا: 0.714,
 تعداد بالا: 14,
 نرخ برد متوسط: 0.530,
 medium_n: 34,
 overall_accuracy: 0.613,
 overall_n: 48,
 profit_factor: 1.77,
 winrate_horizon: 24h,
 by_symbol: {
 BTC: { win_rate: 0.68, n: 22 },
 ETH: { win_rate: 0.55, n: 18 }
  }
}

مبنای تماس متمایز. نرخ‌های برد بر اساس هر تماس تأیید متمایز (یک تماس برای هر نماد در هر بازه ۵ دقیقه‌ای) محاسبه می‌شوند، نه برای هر درخواست API — این کار از افزایش N توسط ربات‌هایی که به طور مکرر پرس‌وجو می‌کنند جلوگیری می‌کند. ارقام درون نمونه‌ای در بازه پیش‌فرض ۳۰ روزه هستند؛ همان هشدار مربوط به /v1/stats اعمال می‌شود.

Shadow Gate

نیازمند: رایگان تریدر پرو

یک دفترچه تصمیم‌گیری شخصی تغییرناپذیر و فقط افزودنی. تصمیمات معاملاتی خود را قبل یا بعد از اجرا ارسال کنید؛ سیستم یک امتیاز تأیید در برابر موتور Smart Money محاسبه کرده و یک ردیف دائمی اضافه می‌کند. از آن برای ساخت یک سابقه زمانی‌دار صادقانه از میزان هم‌خوانی سیگنال API با ورودی‌های خود استفاده کنید — کاملاً مستقل از استخر نرخ برد جهانی. پاسخ‌های سطح رایگان و تریدر فیلدهای شواهد را حذف می‌کنند؛ پرو تجزیه کامل را برمی‌گرداند. تأخیر سطحی برای داده‌های سطح رایگان اعمال می‌شود.

POST /v1/shadow-gate/decisions

ارسال یک تصمیم. بدون تغییر در Idempotency-Key هدر درخواست — ارسال مجدد همان کلید، ردیف موجود را بدون ایجاد نسخه تکراری برمی‌گرداند. سیستم بلافاصله موتور تأیید را فراخوانی کرده و نتیجه را به عنوان یک ردیف دفترچه تغییرناپذیر اضافه می‌کند.

Request Body

فیلد	نوع	توضیحات
symbolالزامی	string	نماد دارایی، مثلاً `BTC`
sideالزامی	string	جهت معامله: `long` یا `short`
strategy_idاختیاری	string	برچسب استراتژی تعریف شده توسط فراخواننده (حداکثر ۶۴ کاراکتر). به همان شکل ذخیره می‌شود برای گروه‌بندی و فیلتر کردن.

Example Request

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"

Example Response

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 شواهد را حذف می‌کنند. پرو تجزیه کامل تأیید را برمی‌گرداند. تأخیر سطحی برای سطح رایگان اعمال می‌شود — ردیف بلافاصله نوشته می‌شود اما امتیاز تأیید ممکن است داده‌های کش شده تا ۶۰ ثانیه قبل را منعکس کند.

GET /v1/shadow-gate/decisions

تصمیمات shadow-gate خود را فهرست کنید، جدیدترین ابتدا. محدود به مالک — فقط تصمیمات ارسال شده توسط کلید API شما برگردانده می‌شوند.

Parameters

Parameter	Type	Description
limitاختیاری	integer	حداکثر ردیف‌ها برای بازگشت. پیش‌فرض: `50`, max: `200`
cursorاختیاری	string	مکان‌نما صفحه‌بندی مات از پاسخ قبلی `next_cursor` فیلد. برای صفحه اول حذف کنید.

Example Response

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, ts: 1710937000, حل شده: True }
  ],
 تعداد: 2,
 مکان‌نمای بعدی: None
}

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

تصمیم واحد بر اساس شناسه، شامل شواهد تأیید کامل برای سطح Pro. پاسخ‌های سطح Free و Trader factors و adjustments حذف شده است. برمی‌گرداند 403 اگر تصمیم متعلق به یک کلید API دیگر باشد.

نمونه پاسخ (Pro)

JSON

{
 "id": 318,
 "symbol": "BTC",
 "side": "long",
 "strategy_id": "ema_crossover",
 "decision": "CONFIRM",
 "confidence": "HIGH",
 "composite": 0.74,
 "size_mult": 1.5,
 "factors": {
 "derivatives": { "score": 0.81, "weight": 0.40, "weighted": 0.324 },
 "onchain": { "score": 0.68, "weight": 0.35, "weighted": 0.238 },
 "whale": { "score": 0.73, "weight": 0.25, "weighted": 0.183 }
  },
 "ts": 1710940821,
 "resolved": False,
 "outcome": None
}

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

به صورت دستی نتیجه یک تصمیم را حل کنید. این را پس از بستن معامله فراخوانی کنید تا نتیجه نهایی در برابر ردیف دفتر ثبت شود. پس از حل، ردیف تغییرناپذیر است و نمی‌تواند دوباره تغییر کند.

بدنه درخواست

فیلد	نوع	توضیح
outcomeالزامی	رشته	نتیجه معامله: `win` یا `loss`
exit_priceاختیاری	عدد اعشاری	قیمت خروج برای معامله. برای مرجع ذخیره می‌شود؛ در صورت ارائه برای محاسبه سود و زیان درصدی استفاده می‌شود.
pnl_pctاختیاری	عدد اعشاری	سود و زیان تحقق یافته به عنوان درصدی از اندازه موقعیت، مثلاً `3.5` یا `-1.2`

نمونه پاسخ

JSON

{
 "id": 318,
 "resolved": True,
 "outcome": "win",
 "exit_price": 65800.0,
 "pnl_pct": 4.1,
 "resolved_at": 1711027200
}

تغییرناپذیری. ردیف دفتر فقط قابل افزودن است. پس از ارسال یک تصمیم، نمی‌توان آن را حذف کرد و پس از حل، نمی‌توان آن را دوباره حل کرد. این اطمینان می‌دهد که سابقه‌ای که می‌سازید صادقانه و مقاوم در برابر دستکاری است.

کدهای خطا

وضعیت	کد	توضیح
400	invalid_params	پارامترهای پرس‌وجو وجود ندارد یا نامعتبر است
401	unauthorized	کلید API وجود ندارد یا نامعتبر است
403	plan_restriction	نقطه پایانی در طرح فعلی شما در دسترس نیست
429	rate_limit_exceeded	محدودیت روزانه یا انفجاری رسیده است
500	internal_error	خطای سرور - وضعیت منبع را در /health بررسی کنید
503	data_stale	منبع داده در دسترس نیست؛ با آخرین داده‌های شناخته شده برگردانده شده است

نمونه کدها

Python

import 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()

# در حلقه معاملاتی شما:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
 print("رد کردن — اطمینان کافی نیست")
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 (!resok) throw new Error(`API error: ${resstatus}`);
 return res.json();
}

// نحوه استفاده
confirmTrade('BTC', 'long').then(data => {
  console.log(dataconfidence, datasize_mult);
});

cURL

Shell

# تایید معامله خرید
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# دریافت داده‌های نهنگ‌ها
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/whales?symbol=BTC"

# بررسی مصرف
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

import requests
from freqtrade.strategy import IStrategy

class SmartMoneyStrategy(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 # Fail open on API error

CCXT + Smart Money

Python — CCXT

import 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()

 اگر conf["confidence"] وجود ندارد در ["HIGH", "MEDIUM"]:
 چاپ(f"رد کردن {symbol} {side} — اطمینان کافی نیست.")
 برگرداندن None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 چاپ(f"سفارش ثبت شد: {adj_amount} {symbol} {side}")
 برگرداندن order

نیاز به کمک دارید؟

بررسی کنید صفحه وضعیت API برای اطلاعات سلامت لحظه‌ای، یا از فرم تماس.