API حوالہ

سمارٹ منی API

ایک پیشہ ورانہ گریڈ کی انٹیلیجنس API جو آپ کے ٹریڈنگ بوٹ کے لیے ڈیریویٹو ڈیٹا، آن چین میٹرکس، اور وہیل والٹ کی سرگرمی کو ایک واحد کانفڈنس اسکور میں جمع کرتی ہے۔

موجودہ API ورژن: v1. بیس URL: https://api.smartmoneyapi.com/v1

ڈیزائن کے اصول

چار خیالات ہر اینڈ پوائنٹ اور ہر اسکور کو تشکیل دیتے ہیں جو یہ API واپس کرتا ہے۔ وہ اس کی دیانتدارانہ حدود بھی ہیں کہ یہ کیا کرتا ہے — اور کیا نہیں کرتا۔

حکمت عملی پر پہلے، سگنل پر نہیں۔ یہ خرید/فروخت سگنل فیڈ نہیں ہے۔ آپ حکمت عملی اور داخلہ لاتے ہیں؛ API آپ کو بتاتا ہے کہ آیا ارد گرد کا مارکیٹ ڈھانچہ — ڈیریویٹو پوزیشننگ، فنڈنگ، اوپن انٹرسٹ، لیکویڈیشنز، آن چین فلو، اور وہیل اتفاق رائے — آپ کے ٹریڈ کے ساتھ متفق ہے جو آپ پہلے ہی لینا چاہتے ہیں۔

اعتماد سے اسکور شدہ، بائنری پیشگوئی نہیں۔ ہر جواب ایک درجہ بند confidence (HIGH / MEDIUM / LOW) اور ایک composite -1.0 سے +1.0 تک لے کر آتا ہے۔ کوئی ضمانتیں نہیں ہیں اور کوئی اوریکل کالز نہیں ہیں — آپ کو اتفاق کی ایک کیلبریٹڈ پڑھائی ملتی ہے، اس کے پیچھے کی وجوہات کے ساتھ، تاکہ آپ یقین کے مطابق متناسب طور پر سائز کر سکیں۔

فیصلہ کی حمایت، عمل کی مشورہ نہیں۔ API ایک CONFIRM / REDUCE / SKIP سفارش اور ایک سائز ملٹی پلائر واپس کرتا ہے آپ کی منطق پر عمل کرنے کے لیے۔ یہ کبھی بھی آرڈرز نہیں دیتا، اور یہاں کچھ بھی مالی مشورہ نہیں ہے۔ آپ خطرے، سائز، اور عمل کے ذمہ دار رہتے ہیں۔

زندہ میٹرکس، مقررہ ضمانتیں نہیں۔ جیت کی شرح، ریجیم اعداد و شمار، اور درستگی کے اعداد و شمار ایک رولنگ نمونے سے حساب کیے جاتے ہیں اور مارکیٹوں کے ساتھ ساتھ حرکت کرتے ہیں۔ ہم انہیں ایمانداری سے شائع کرتے ہیں، حتیٰ کہ جب وہ معمولی ہوں۔ ہر میٹرک کو مستقبل کے بارے میں وعدے کے بجائے موجودہ مشاہدے کے طور پر سمجھیں۔

یہ API کس کے لیے ہے

یہ API بنایا گیا ہے کرپٹو بوٹ، الگورتھم، اور AI ایجنٹ ڈویلپرز کے لیے جن کے پاس پہلے سے ہی لمبی/چھوٹی سگنل ہے — TA اسٹریٹیجی سے، ML ماڈل سے، Freqtrade پائپ لائن سے، TradingView الرٹ سے، یا LLM ایجنٹ سے — اور وہ ایک تیز، پری ٹریڈ تصدیق کریں / کم کریں / چھوڑ دیں فیصلہ کرنے سے پہلے سرمایہ لگانے سے پہلے۔

ایک عام لوپ: آپ کی اسٹریٹیجی فائر کرتی ہے "BTC میں لمبی پوزیشن لیں" → آپ کال کرتے ہیں GET /v1/confirm?symbol=BTC&direction=long → آپ تصدیق کرتے ہیں، کم کرتے ہیں، یا انٹری چھوڑ دیتے ہیں اور سائز کو اسکیل کرتے ہیں size_mult۔ ایک کال، سنگل کم لیٹنسی JSON رسپانس، کوئی اضافی انفراسٹرکچر نہیں۔

یہ ہے نہیں ایک اسٹینڈیلون سگنل جنریٹر، چارٹنگ پروڈکٹ، یا ایکزیکیشن وینیو نہیں۔ اگر آپ کے پاس کوئی اپنا سگنل نہیں ہے تو، شروع کریں پرفارمنس پیج سے تاکہ دیکھ سکیں کہ اسکور نے لائیو بوٹ میں وائر کرنے سے پہلے کیسا رویہ دکھایا ہے۔

رسائی حاصل کرنا

1 — سائن اپ کریں۔ signup پر ایک مفت اکاؤنٹ بنائیں signup (ای میل/پاس ورڈ یا گوگل)۔ مفت ٹیر کے لیے کریڈٹ کارڈ کی ضرورت نہیں۔

2 — اپنا ڈیش بورڈ کھولیں۔ آپ کا ڈیش بورڈ آپ کا API کیز، موجودہ پلان، اور روزانہ کوٹہ کے خلاف لائیو استعمال دکھاتا ہے۔

3 — اپنا API کیز کاپی کریں۔ کیز کو پریفکس کیا جاتا ہے sm_۔ ہر درخواست پر اسے X-API-Key ہیڈر کے طور پر پاس کریں (دیکھیں تصدیق)۔ کسی بھی وقت اپ گریڈ کریں قیمتوں کا صفحہ حدود بڑھانے اور مزید علامات اور اینڈ پوائنٹس کو انلاک کرنے کے لیے۔

سپیک، ایس ڈی کے اور کک بک

آپ کو تیزی سے انضمام کے لیے درکار ہر چیز، چاہے آپ خود کوڈ لکھیں یا اسے کوڈنگ ایجنٹ کو سونپ دیں۔

وسیلہ	یہ کیا ہے
کک بک	سب سے عام انضمام کے لیے کاپی پیسٹ ترکیبیں — داخلے سے پہلے تصدیق کریں، Freqtrade سگنل کو گیٹ کریں، ضرب کے ذریعے سائز کریں، 402/429 کو ہینڈل کریں، اور اسے کوڈنگ ایجنٹ میں وائر کریں۔
اوپن اے پی آئی سپیک	ہر اینڈ پوائنٹ کی مشین پڑھنے والی اوپن اے پی آئی تعریف۔ Postman/Insomnia میں درآمد کریں، کلائنٹس بنائیں، یا کسی ایل ایل ایم کو فیڈ کریں۔ `github.com/tashiardit/smartmoneyapi-docs`.
پائتھن کلائنٹ	سرکاری پائتھن کلائنٹ لائبریری `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	ای پی آئی کا ایل ایل ایم دوستانہ سادہ متن کا خلاصہ۔ Claude، Codex، یا Cursor کو اس کی طرف اشارہ کریں (دیکھیں کوڈنگ ایجنٹس).

2 منٹ میں تیز آغاز

مرحلہ 1 — بیس یو آر ایل۔ ہر اینڈ پوائنٹ اس کے تحت موجود ہے:

بیس یو آر ایل
https://api.smartmoneyapi.com

مرحلہ 2 — اپنا اے پی آئی کی حاصل کریں۔ مفت میں سائن اپ کریں (کوئی کریڈٹ کارڈ درکار نہیں) اور اپنی کی کو ڈیش بورڈسے کاپی کریں۔ اسے ہر درخواست پر 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": ["Funding rate positive across all venues", "Whales: 67% long consensus"]
}

جب confidence ہے HIGH یا MEDIUM اور action ہے CONFIRM، اپنے پوزیشن کے سائز کو size_multسے اسکیل کریں۔ یہ مکمل انضمام لوپ ہے۔ مکمل فیلڈ حوالہ کے لیے جوابی فیلڈز دیکھیں۔

تصدیق

تمام درخواستوں کے لیے ایک اے پی آئی کی کی ضرورت ہوتی ہے جو X-API-Key ایچ ٹی ٹی پی ہیڈر کے طور پر پاس کی جائے۔

ایچ ٹی ٹی پی ہیڈر
X-API-Key: sm_your_api_key_here

آپ کا اے پی آئی کی ڈیش بورڈ سے دستیاب ہے۔ اپنی کی کو خفیہ رکھیں — اسے کلائنٹ سائیڈ کوڈ یا عوامی ذخیروں میں ظاہر نہ کریں۔

ویب سوکٹ تصدیق مختلف ہے۔ اپنی کی کو کبھی بھی ویب سوکٹ یو آر ایل میں نہ ڈالیں۔ ریئل ٹائم اسٹریمز مختصر المدت، ایک بار استعمال ہونے والے ٹکٹساستعمال کرتی ہیں: اپنی کی کو /v1/ws/ticket پر POST کریں X-API-Key ہیڈر کے ساتھ، پھر واپس ملنے والے ٹکٹ کے ساتھ کنیکٹ کریں۔ دیکھیں ویب سوکٹ تصدیق (ٹکٹس).

گوگل سائن ان (فائر بیس تصدیق)

صارفین اپنے گوگل اکاؤنٹ کے ذریعے فائر بیس تصدیق کا استعمال کرتے ہوئے تصدیق کر سکتے ہیں۔ کلائنٹ پر کامیاب گوگل سائن ان کے بعد، فائر بیس آئی ڈی ٹوکن کو ایک منسلک اے پی آئی سیشن کے لیے تبدیل کریں۔ نظام آپ کی گوگل شناخت کو اے پی آئی کی سسٹم کے ساتھ خود بخود ہم آہنگ کرتا ہے۔

دستیاب ہے: مفت ٹریڈر پرو

POST /auth/google

درخواست کا جسم

فیلڈ	قسم	تفصیل
id_tokenضروری	سٹرنگ	کلائنٹ پر گوگل سائن ان کے بعد حاصل کردہ فائر بیس آئی ڈی ٹوکن

مثال جواب

JSON

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

صارف پروفائل ڈیٹا — ای میل، پلان، استعمال کی تاریخ، ترجیحات — فائر اسٹور میں محفوظ کیا جاتا ہے اور آپ کے گوگل اکاؤنٹ سے منسلک ہوتا ہے۔ مکمل ڈیٹا ایکسپورٹ یا اکاؤنٹ ڈیلیشن کی درخواست کسی بھی وقت ڈیش بورڈ کی پرائیویسی سیٹنگز کے ذریعے کی جا سکتی ہے۔

ریٹ لیمٹس

پلان	کالز/دن	برسٹ لیمٹ	ڈیٹا تاخیر
مفت	50	2/min	60 سیکنڈز
ٹریڈر	1,000	20/min	ریئل ٹائم
پرو	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 فائر ہوز کو کال کر رہی ہے)۔ اپ گریڈ کریں یا پبلک اینڈ پوائنٹ پر واپس جائیں۔
429	ریٹ_لمٹ_زیادہ	روزانہ یا برسٹ لمٹ تک پہنچ گیا۔ پیچھے ہٹیں اور دوبارہ کوشش کریں `X-RateLimit-Reset`; ہتھوڑا نہ ماریں۔

ہر غلطی ایک ہی شکل واپس کرتی ہے:

JSON
{
 "error": "rate_limit_exceeded",
 "message": "Daily limit of 100 calls reached. Resets at 00:00 UTC.",
 "status": 429
}

اسٹیٹس کوڈز کی مکمل فہرست کے لیے (400 / 403 / 500 / 503 اور مزید)، دیکھیں غلطی کے کوڈز۔ ایک مضبوط انضمام 5xx اور 429 کو عارضی سمجھتا ہے (بیک آف کے ساتھ دوبارہ کوشش کریں) اور 401/402/403 کو ٹرمینل سمجھتا ہے (کلید یا پلان کو درست کریں)۔

سیکورٹی بہترین طریقے

کلید کو ہیڈر میں بھیجیں، URL میں کبھی نہیں۔ ہمیشہ پاس کریں X-API-Key ایک HTTP ہیڈر کے طور پر۔ کوئری سٹرنگز میں کلیدیں (?key=) پروکسی، لوڈ بیلنسرز، اور براؤزر ہسٹری کے ذریعے لاگ ہوتی ہیں — پرانے ?key= auth اب WebSocket اینڈ پوائنٹس پر قبول نہیں کیا جاتا ہے بالکل اسی وجہ سے۔

کلیدیں سرور سائیڈ رکھیں۔ کبھی بھی API کلید کو کلائنٹ سائیڈ جاوا اسکرپٹ، موبائل ایپ بنڈل، یا پبلک ریپوزٹری میں ایمبیڈ نہ کریں۔ اسے ماحولیاتی متغیر یا سیکرٹ مینیجر سے لوڈ کریں۔ اگر کلید لیک ہو جائے تو اسے تبدیل کریں۔

کلیدیں وقتاً فوقتاً تبدیل کریں۔ اپنی کلید کو دوبارہ بنائیں ڈیش بورڈ ایک شیڈول پر اور فوری طور پر اگر آپ کو لیک کا شبہ ہو۔ پرانی کلید نئی کلید جاری ہوتے ہی کام کرنا بند کر دیتی ہے۔

براؤزر ساکٹس کے لیے ٹکٹس استعمال کریں۔ براؤزر سے ریئل ٹائم اسٹریمز کے لیے، اپنی کلید کو سنگل یوز ٹکٹ کے لیے تبدیل کریں بجائے کہ خام کلید کے ساتھ کنیکٹ کریں — دیکھیں WebSocket تصدیق (ٹکٹس).

کوڈنگ ایجنٹس / LLMs کے ساتھ استعمال کرنا

Claude Code, Codex, Cursor, یا کسی بھی LLM کوڈنگ ایجنٹ کے ساتھ بنانا؟ آپ ایجنٹ کو وہ سب کچھ دے سکتے ہیں جو اسے اس API کو صحیح طریقے سے وائر کرنے کے لیے درکار ہے۔ دو مشین ریڈایبل حوالہ جات شائع کیے گئے ہیں:

وسائل	URL
LLM خلاصہ	`https://smartmoneyapi.com/llms.txt`
OpenAPI اسپیک	`github.com/tashiardit/smartmoneyapi-docs`

اپنے ایجنٹ کو پوائنٹ کریں /llms.txt فائل پر (the llms.txt کنونشن) ایک مختصر جائزہ کے لیے، پھر OpenAPI اسپیک پر درست درخواست/جواب کی شکلوں کے لیے۔ ایک لائن کا پرامپٹ جو اچھی طرح کام کرتا ہے:

پرامپٹ

# Claude Code / Cursor / Codex میں پیسٹ کریں
Read https://smartmoneyapi.com/llms.txt and the OpenAPI spec at
github.com/tashiardit/smartmoneyapi-docs, then add a pre-trade
check to my bot that calls GET /v1/confirm and skips entries
unless action is CONFIRM.

دیکھیں کک بک ایک کام کرنے والے کوڈنگ ایجنٹ کی ترکیب کے لیے۔

اینڈ پوائنٹس

GET /confirm

کور اینڈ پوائنٹ۔ کسی بھی پوزیشن میں داخل ہونے سے پہلے کسی تجارتی سمت کے لیے ایک کمپوزٹ کانفیڈنس اسکور اور ایکشن سفارش واپس کرتا ہے۔

کوریج، سادہ الفاظ میں۔ /confirm فی الحال اسکور کرتا ہے BTC, ETH اور SOL — وہ علامات جن کی کافی حل شدہ تاریخ ہے کہ ایمانداری سے تصدیق کی جا سکے۔ ڈیریویٹو اسکرینر الگ سے ~519 ڈیریویٹو مارکیٹس کی نگرانی کرتا ہے فنڈنگ، OI اور لیکویڈیشن ڈیٹا کے لیے، اور وہیل ٹریکنگ 600+ والیٹس کا احاطہ کرتا ہے۔ پرو مکمل اسکرینر، ایکسپورٹس اور وسیع مارکیٹ کوریج کو انلاک کرتا ہے؛ /confirm علامت کی سپورٹ کو ہر مارکیٹ کے قابل اعتماد ٹریک ریکارڈ جمع کرنے کے ساتھ وسعت دی جاتی ہے۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
علامتضروری	سٹرنگ	ایسٹ علامت۔ ایک: `BTC`, `ETH`, `SOL` (ٹریڈر+)
سمتضروری	سٹرنگ	تجارتی سمت: `long` یا `short`
ماخذاختیاری	سٹرنگ	آپ کے سگنل ماخذ کے لیے لیبل (تجزیات کے لیے لاگ کیا گیا)۔ زیادہ سے زیادہ 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,
 factors: {
 derivatives: { score: 0.81, weight: 0.40, weighted: 0.324 },
 onchain: { score: 0.68, weight: 0.35, weighted: 0.238, source: coinmetrics, available: True },
 whale: { score: 0.73, weight: 0.25, staleness_factor: 1.0, weighted: 0.183 }
  },
 adjustments: { agreement: 0.0, trend: 0.0, news_macro: 0.0 },
 weights: { derivatives: 0.40, onchain: 0.35, whale_intel: 0.25 },
 coverage: { derivatives: True, whale: True, onchain: True },
 reasons: [
 تمام جگہوں پر فنڈنگ ریٹ مثبت ہے,
 LSR لانگس کی حمایت کرتا ہے: 1.42,
 وہیلز: 67% لانگ اتفاق رائے,
 MVRV 1.0 سے اوپر — آن چین بُلش
  ]
}

ڈیزائن کے لحاظ سے شفاف۔ ہر جواب میں ایک شامل ہوتا ہے factors آبجیکٹ جو ہر حصے کا دکھاتا ہے اسکور × وزن = وزن شدہ شراکت، ایک adjustments آبجیکٹ پوسٹ-فلٹر ٹویکس کے لیے، weights استعمال شدہ، اور ایک coverage نقشہ۔ آن چین حصہ استعمال کرتا ہے اصل مفت کوائن میٹرکس ڈیٹا (MVRV / ایکسچینج-فلو / ایکٹو-ایڈریس) جب گلاسنوڈ کی کوئی کلید سیٹ نہیں ہوتی۔ یہ ایک ملٹی فیکٹر اتحاد اسکور — فیصلہ سازی کی حمایت، کوئی ضمانت شدہ جیت کی شرح نہیں.

ٹریک نہ کیے گئے علامات ایماندار ہیں۔ ایک علامت جو ٹریک کیے گئے ڈیریویٹوز/وہیل یونیورس سے باہر ہے ایک واضح لوٹاتی ہے "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" کے ساتھ "unsupported":true — کبھی بھی گھڑا ہوا نہیں LOW.

جوابی فیلڈز

فیلڈ	ٹائپ	تفصیل
ts	integer	حساب کتاب کا یونکس ٹائم اسٹیمپ
symbol	string	اثر کی علامت (BTC/ETH/SOL)
direction	string	درخواست کی گئی سمت (لانگ/شارٹ)
composite	float	کمپوزٹ اتحاد اسکور -1.0 (انتہائی مخالف) سے +1.0 (مضبوط تصدیق) تک۔ جیت کی شرح نہیں۔
base_composite	float	کمپوزٹ جس پر پوسٹ-فلٹر ایڈجسٹمنٹس لاگو نہیں کیے گئے تھے
confidence	string	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
action	string	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
size_mult	float	تجویز کردہ پوزیشن سائز ملٹی پلائر (مثلاً 0.0 – 1.5)
unsupported	bool	`true` جب علامت کوریج سے باہر ہو (NO_DATA کے ساتھ)
deriv_score	float	ڈیریویٹوز سب-اسکور (-1 سے 1)
onchain_score	float	آن چین سب-اسکور (-1 سے 1)
whale_score	float	وہیل اتفاق رائے سب-اسکور (-1 سے 1)
x_score	float	X/سماجی جذبات سب-اسکور (-1 سے 1); 0 جب غیر استعمال شدہ
factors	object	فی-حصہ تفصیل: `score × weight = weighted` ڈیریویٹوز / آن چین / وہیل / x_sentiment کے لیے (آن چین شامل ہے `source`)
adjustments	object	سائنڈ پوسٹ-فلٹر ٹویکس (اتفاق رائے، رجحان، rsi_1h، news_macro، مومینٹم، وقت_کا_دن، streak_decay)
weights	object	اس تشخیص کے لیے اصل میں استعمال شدہ وزن سیٹ
coverage	object	`{derivatives, whale, onchain}` — کون سے حصوں میں اصل ڈیٹا تھا
reasons	array	اسکور کے لیے انسانی پڑھنے کے قابل وضاحتیں

GET /snapshot

کسی دیے گئے علامت کے لیے تمام سب-اسکورز، خام میٹرکس، اور انڈیکیٹر ویلیوز سمیت مکمل مارکیٹ سنیپ شاٹ لوٹاتا ہے۔ ڈیش بورڈز اور لاگنگ کے لیے مفید۔

Requires: ٹریڈر پرو

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 آپشنز اینالیٹکس (عوامی، کوئی تصدیق نہیں): پٹ/کال ریٹیو، میکس پین، اور اوپن انٹرسٹ بائی سٹرائیک۔ اینڈ پوائنٹس: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

اسپاٹ BTC اور ETF یومیہ نیٹ فلو اور فی فنڈ بریک ڈاؤن (عوامی)۔ اینڈ پوائنٹس: /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

تاریخی فنڈنگ، اوپن انٹرسٹ، لانگ/شورٹ ریٹیو (بائننس)، اور OHLCV (کوائن گییکو) بیک ٹیسٹنگ کے لیے۔ اینڈ پوائنٹس: /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/*

خودکار ٹریڈنگ اسٹریٹیجیز کے لیے شفاف، پڑھنے کے قابل ٹریک ریکارڈ جو اسمارٹ منی سگنلز پر عمل کرتی ہیں — بشمول 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 — اسٹریٹیجیز کو فیڈ کرنے والے سگنل ٹائپ بریک ڈاؤن (کاؤنٹ / ونس / ون_ریٹ / اوسط pnl فی سگنل ٹائپ)۔

گزشتہ کارکردگی مستقبل کے نتائج کی نشاندہی نہیں کرتی۔ اعداد و شمار کو ایک ~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	ایونٹس کو POST کرنے کے لیے HTTPS اینڈ پوائنٹ (شروع ہونا ضروری ہے `https://`)
eventsضروری	سرنی	ایونٹ کے نام، مثلاً `["HIGH","MEDIUM","VETO"]` یا `["*"]`
symbolsضروری	سرنی	فلٹر کرنے کے لیے علامات، مثلاً `["BTC","ETH"]` یا `["*"]`
secretضروری	string	آپ کا سائننگ سیکرٹ، ≥ 16 حروف (اسٹورڈ ہیشڈ)

سگنیچر کی تصدیق

HMAC کی SHA-256 ہیکس ڈائجسٹ آپ کے رجسٹرڈ سیکرٹ ہے۔ خام درخواست کے جسم کا HMAC-SHA256 اس کلید کے ساتھ حساب کریں اور اس کا موازنہ کریں (مستقل وقت) کے خلاف X-SmartMoney-Signature. دیکھیں ویب ہوک نفاذ گائیڈ.

انٹیلی جنس

GET /analysis

ضروری ہے: پرو

AI سے چلنے والی مارکیٹ ریجیم کلاسیفکیشن اور سگنل تنازعات کی شناخت فراہم کرتا ہے۔ کراس-سگنل معاہدے کا تجزیہ کرتا ہے، ڈیریویٹوز، آن چین، اور وہیل ڈیٹا کے درمیان اختلافات کی نشاندہی کرتا ہے، اور مستقبل کے خطرات کے عوامل اور وقت پر مبنی سفارش کے ساتھ قدرتی زبان کا خلاصہ پیش کرتا ہے۔

پیرامیٹرز

پیرامیٹر	قسم	تفصیل
symbolضروری	string	ایسٹ سمبل: `BTC`, `ETH`, یا `SOL`

مثال جواب

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "لیٹ سائیکل — سگنل ڈائیورجنسی",
 "summary": "BTC لیٹ بل سائیکل فیز میں ہے جہاں آن چین طاقت ڈیریویٹوز کی زیادتی سے متصادم ہے۔ وہیلز ایکسپوژر کم کر رہے ہیں جبکہ ریٹیل LSR بڑھ رہا ہے۔",
 "signal_conflicts": [
 "وہیل اسکور بیئرش جبکہ آن چین اسکور بلش",
 "فنڈنگ ریٹ 3-ماہ کے اعلیٰ ترین سطح پر — ممکنہ اسکویز کا خطرہ"
  ],
 "risk_factors": ["بلند فنڈنگ", "OI ڈائیورجنسی", "وہیل کمی"],
 "recommendation": "لانگ ایکسپوژر کم کریں، اسٹاپس کو سخت کریں۔ موجودہ قیمت سے اوپر نئے لانگ سے گریز کریں۔",
 "time_horizon": "4h–12h"
}

پرو پلان ضروری ہے۔ یہ اینڈ پوائنٹ AI پروسیسنگ اوور ہیڈ کی وجہ سے ہر درخواست پر 3 API کالز استعمال کرتا ہے۔

GET /liquidations

ضروری ہے: ٹریڈر پرو

واپس کرتا ہے دو تکمیلی نظارے: (1) لیوریج-پروجیکٹڈ levels — ایک اندازہ کہاں لیکویڈیشن کلسٹرز بیٹھے ہیں؛ اور (2) ایک realized_heatmap — REAL executed فورسڈ-لیکویڈیشن انٹینسٹی (قیمت × وقت)، عوامی ایکسچینج ویب ساکٹ فیڈز سے لائیو جمع کی گئی: 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,
 // REAL executed liquidations — live from 5 exchanges
 "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

دستیاب ہے: فری کوئی تصدیق کی ضرورت نہیں (فی-آئی پی تھروٹلڈ)

پبلک قیمت-سطح لیکویڈیشن ہیٹ میپ۔ CoinGlass-style قیمت × وقت میٹرکس کو واپس کرتا ہے REAL executed فورسڈ لیکویڈیشنز، جس قیمت پر ہر لیکویڈیشن پرنٹ ہوئی اس کے مطابق بکٹ کی گئی — عوامی ایکسچینج ویب ساکٹ فیڈز سے لائیو جمع کی گئی: Binance, OKX, Bybit, Bitget, BitMEX. clusters array عملی آؤٹ پٹ ہے: لیکویڈیٹڈ نیشنل کے لحاظ سے درجہ بند قیمت کے buckets، ہر ایک کو اس کے غالب سائیڈ کے ساتھ ٹیگ کیا گیا۔ ڈیٹا لائیو سٹریم پر منحصر ہے — بہت پرسکون سمبل یا ابھی ری اسٹارٹ ہونے والا گیٹ وے اچھی طرح سے فارمڈ خالی ڈھانچہ کے ساتھ ساتھ ایک ایمانداری سے 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

ضروری ہے: ٹریڈر پرو

انجام دیا آن چین ڈی فائی لینڈنگ لیکویڈیشنز براہ راست ہمارے اپنے مقامی سے کیپچر کی گئی BSC + Avalanche فل نوڈز — کسی بھی ٹریڈنگ بوٹ سے آزاد۔ BSC پر Venus/Cream اور Moolah، اور Avalanche پر AAVE V3/V2، Benqi، BankerJoe، Granary اور Vinium کا احاطہ کرتا ہے۔ پرو ٹیئر اضافی طور پر 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

ضروریات: ٹریڈر پرو

موجودہ لیکویڈیشن ہیٹ مینک، والیٹیلیٹی بینڈز، اور مارکیٹ ڈھانچے کی بنیاد پر ذہین اسٹاپ-لاس لیولز کا حساب لگاتا ہے۔ آپ کی انٹری قیمت اور رسک برداشت کے مطابق درجہ بند اسٹاپ سفارشات اور ٹیک-پروفٹ تجاویز واپس کرتا ہے۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
symbolrequired	string	اسٹ کی علامت: `BTC`, `ETH`, یا `SOL`
directionrequired	string	پوزیشن کی سمت: `long` یا `short`
entry_priceoptional	float	آپ کی انٹری قیمت۔ اگر چھوڑ دیا جائے تو موجودہ مارکیٹ قیمت کو ڈیفالٹ کیا جاتا ہے۔
risk_pctoptional	float	اکاؤنٹ کا زیادہ سے زیادہ قابل قبول رسک فیصد میں۔ ڈیفالٹ: `2.0`

مثال کا جواب

JSON

{
 "symbol": "BTC",
 "direction": "long",
 "entry_price": 96420,
 "stops": {
 "tight": { "price": 95100, "note": "1h ڈھانچے سے نیچے۔ اسکیلپنگ کے لیے بہترین۔" },
 "recommended": { "price": 93800, "note": "94K پر بڑے لیکویڈیشن کلسٹر سے نیچے۔ معیاری سوئنگ اسٹاپ۔" },
 "wide": { "price": 91200, "note": "4h ڈیمانڈ زون سے نیچے۔ پوزیشن ٹریڈ اسٹاپ۔" }
  },
 "avoid_zones": [
    { "low": 94200, "high": 94800, "reason": "گھنا لیکویڈیشن کلسٹر — ہائی سلپپج رسک" }
  ],
 "take_profit_suggestions": [
    { "tp1": 98500, "tp2": 101000, "tp3": 104200 }
  ]
}

ٹریڈر پلان: صرف recommended اسٹاپ واپس کرتا ہے۔ پرو پلان: تینوں اسٹاپ درجے، avoid_zones، اور مکمل ٹیک-پروفٹ تجاویز۔

GET /funding-arb

ضروریات: ٹریڈر پرو

کراس-ایکسچینج فنڈنگ ریٹ آربیٹریج کے مواقع کو ریئل ٹائم میں شناخت کرتا ہے۔ تخمینی سالانہ پیداوار، بہترین ایکسچینج جوڑی، اور سپریڈ کو کھینچنے کے لیے درکار ہیج ایکشن کے ساتھ درجہ بند مواقع واپس کرتا ہے۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
min_spreadoptional	float	شامل کرنے کے لیے کم از کم فنڈنگ ریٹ سپریڈ (ڈیسیمل میں)۔ ڈیفالٹ: `0.01`
symboloptional	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
    }
  ]
}

ٹریڈر پلان: صرف ٹاپ 1 موقع، کوئی تاریخی سپریڈ ڈیٹا نہیں۔ پرو پلان: ایکسچینج جوڑی کے لیے 24h سپریڈ ہسٹری کے ساتھ تمام موجودہ مواقع۔

مفت پبلک ورژن کوئی تصدیق نہیں

ایک نو-کی پبلک اینڈ پوائنٹ ٹاپ 10 مواقع کو ایک لائیو کراس-ایکسچینج اسکرینر کے ساتھ واپس کرتا ہے، جو ایمبیڈنگ یا فوری چیکس کے لیے مثالی ہے۔ یہ فی-علامت سپریڈ ہسٹری اور بھاری فیلڈز کو چھوڑ دیتا ہے اور 120-سیکنڈ کی کش سے پیش کیا جاتا ہے۔ جب تازگی کی ونڈو میں کراس-ایکسچینج فنڈنگ سپریڈز موجود نہیں ہوتیں تو یہ خالی opportunities سرنی کے ساتھ ایک note — کبھی بھی گھڑا ہوا ڈیٹا نہیں۔

GET (no auth)

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

ضروری ہے: ٹریڈر پرو

ایک معیار پر مبنی وہیل ڈائریکشنل انڈیکس فی علامت، اسکورڈ -100 (وہیل پیسہ شارٹ کی طرف جھکاؤ) سے +100 (لانگ کی طرف جھکاؤ)۔ ہزاروں ٹریک کردہ ہائپرلیکوئڈ وہیل والیٹس سے بنایا گیا — ہر ایک کو اس کی اپنی تاریخی جیت کی شرح اور PnL کے مطابق وزن دیا گیا اور حالیہ وقت کے لحاظ سے کمزور کیا گیا۔ یہ ایک پوزیشننگ انڈیکس ہے، نہ کہ خرید/فروخت کا اشارہ یا قیمت کی پیشگوئی۔ وہ علامات جن میں چند والیٹس شامل ہیں ان کو لیبل کیا گیا ہے 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)۔ قیمت کی پیشگوئی یا خرید/فروخت کا اشارہ نہیں۔
}

ٹریڈر پلان: ٹاپ 12 علامات، معاون کی تفصیل چھپائی گئی۔ پرو پلان: تمام علامات فی علامت کے ساتھ top_contributors۔ والیٹ کے وزن محدود ہیں [0.25,1.0]؛ PnL تازہ ترین پوزیشن سنیپ شاٹس سے ایک غیر حقیقی پراکسی ہے۔

GET /v1/whales/crowding

دستیاب ہے: مفت کوئی تصدیق کی ضرورت نہیں — گمنام کو ٹاپ 10 علامات ملتی ہیں، ٹریڈر+ کو مکمل فہرست ملتی ہے

مشترکہ وہیل پوزیشننگ اور کراؤڈنگ سیاق فی علامت، میں ضم Hyperliquid + GMX v2 + Jupiter Perps۔ مجموعی/خالص نوٹیشنل، ڈائریکشنل اسکیو، والیٹ اور مقام کی گنتی، پوزیشن کی حراستی (ٹاپ-3 شیئر + HHI)، ایک وزن دار اوسط لیوریج، اور لکویڈیشن-قربت کی بالٹیاں (USD نوٹیشنل جو اس کے تخمینہ شدہ لکویڈیشن قیمت کے 5% اور 10% کے اندر بیٹھا ہے، لمبی/شارٹ تقسیم)۔ یہ ہے سیاق، نہ کہ ڈائریکشنل اشارہ۔ وہ فیلڈز جو اخذ نہیں کیے جا سکتے وہ ہیں null اور ظاہر ہوتے ہیں — — مثلاً lev_wavg/crowding_index جب کوئی پوزیشن لیوریج نہیں رکھتی۔ لکویڈیشن فاصلے ایک الگ تھلگ مارجن کا تخمینہ ہیں (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), نہیں ایکسچینج کی رپورٹ کردہ لکویڈیشن قیمتیں۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
min_notionalاختیاری	float	شامل ہونے کے لیے کم از کم مشترکہ مجموعی نوٹیشنل (USD)۔ ڈیفالٹ: `1000000`.

مثال درخواست

GET (no auth)

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, hhi: 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); ٹریڈر+ کو مکمل فہرست موصول ہوتی ہے۔

GET /v1/options/gex

دستیاب ہے: فری کوئی تصدیق درکار نہیں (فی-آئی پی تھروٹلڈ)

ڈیلر گاما ایکسپوژر (GEX) کے لئے تجزیات BTC & ETH, جو کہ عوامی ڈیریبٹ آپشنز چین سے لائیو حساب کیے جاتے ہیں (کوئی تصدیق نہیں)۔ ہر سٹرائیک کے لئے نیٹ ڈیلر GEX واپس کرتا ہے (SpotGamma ڈیلر-شارٹ کنونشن)، گاما-فلپ لیول (سٹرائیک جہاں مجموعی نیٹ GEX صفر کو پار کرتا ہے)، IV ٹرم اسٹرکچر (ATM مطلب والیٹیلٹی بذریعہ دن-تا-ختم ہونا)، اور ایک فرنٹ-ختم ہونے والی IV اسکیو (25Δ-پروکسی رسک ریورسل)۔ GEX ریجیم ہے positive (ڈیلرز لانگ گاما → والیٹیلٹی دبانے والا) یا negative (والیٹیلٹی بڑھانے والا)۔ مکمل طور پر خودمختار — ہر کال پر دوبارہ حساب کیا جاتا ہے، کوئی ذخیرہ شدہ ڈیٹا بیس انحصار نہیں۔

پیرامیٹرز

پیرامیٹر	قسم	تفصیل
علامتاختیاری	سٹرنگ	`BTC` یا `ETH` صرف۔ ڈیفالٹ: `BTC`.

مثال درخواست

GET (کوئی تصدیق نہیں)

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

مثال جواب

JSON

{
 علامت: BTC, دستیاب: True, سپاٹ: 63203.0,
 نیٹ_جیکس: 18240000.0, نظام: مثبت,
 گاما_فلپ: 64919.82, گاما_فلپ_فیصد: 2.72,
 کال_جیکس: 31200000.0, پٹ_جیکس: -12960000.0,
 سٹرائیک_بذریعہ: [
    { سٹرائیک: 60000, نیٹ_جیکس: -2100000.0 },
    { سٹرائیک: 65000, نیٹ_جی ای ایکس: 4800000.0 }
  ],
 ٹرم_سٹرکچر: [
    { ایکسپائری: 8JUL26, ڈی ٹی ای: 0.76, اے ٹی ایم_آئی وی: 62.1 },
    { ایکسپائری: 27MAR26, ڈی ٹی ای: 14.2, اے ٹی ایم_آئی وی: 58.4 }
  ],
 اسکیو: {
 ایکسپائری: 8JUL26, ڈی ٹی ای: 0.76,
 put_iv: 69.69, atm_iv: 62.1, call_iv: 55.34,
 رسک ریورسل: 14.35, بائیاس: ڈاؤن سائیڈ خوف
  }
}

ایمانداری سے نوٹ: Deribit کانٹریکٹ ملٹی پلائر 1 ہے (سکہ-نامزد OI)۔ کسی بھی فیل ہونے والی وصولی پر اینڈ پوائنٹ خالی پینلز واپس کرتا ہے — کبھی بھی گھڑا ہوا GEX نہیں۔ IV اسکیو 25Δ کے لیے ایک طے شدہ ±10% اسٹرائیک پراکسی استعمال کرتا ہے (اصل 25-ڈیلٹا کے لیے ہر اسٹرائیک کے ڈیلٹا کو حل کرنے کی ضرورت ہوتی ہے)؛ ڈسپلے کے لیے کافی، ایک تخمینے کے طور پر دستاویزی۔ available: false Deribit کانٹریکٹ ملٹی پلائر 1 ہے (سکہ-نامزد OI)۔ کسی بھی فیل ہونے والی وصولی پر اینڈ پوائنٹ خالی پینلز واپس کرتا ہے — کبھی بھی گھڑا ہوا GEX نہیں۔ IV اسکیو 25Δ کے لیے ایک طے شدہ ±10% اسٹرائیک پراکسی استعمال کرتا ہے (اصل 25-ڈیلٹا کے لیے ہر اسٹرائیک کے ڈیلٹا کو حل کرنے کی ضرورت ہوتی ہے)؛ ڈسپلے کے لیے کافی، ایک تخمینے کے طور پر دستاویزی۔

GET /v1/liquidations/simulate

دستیاب: مفت کوئی تصدیق کی ضرورت نہیں (فی آئی پی تھروٹلڈ)

انٹرایکٹو لیکویڈیشن کاسکیڈ اسٹریس ٹیسٹ. ایک فرضی قیمتی حرکت کو دیا گیا، تخمینہ لگایا گیا لیوریجڈ پوزیشنز جو لیکویڈیٹ ہوں گی، قیمتی سطح / سائڈ / ایکسچینج کے لحاظ سے مجبور والیوم، اور کاسکیڈ ڈیپتھ ریڈ آؤٹ۔ نیچے کی طرف حرکت لانگ پوزیشنز کو لیکویڈیٹ کرتی ہے لانگ جن کی لیکویڈیشن قیمت ہدف کے برابر یا اس سے اوپر ہو؛ اوپر کی طرف حرکت شارٹ پوزیشنز کو لیکویڈیٹ کرتی ہے شارٹ جن کی لیکویڈیشن قیمت ہدف کے برابر یا اس سے نیچے ہو۔ دو آزاد طریقوں کو ملا دیا گیا ہے: ٹریک کی گئی ہائپرلکویڈ وہیلز کی عین لیکویڈیشن قیمتیں ریل لیوریج/انٹری، کے ساتھ ساتھ ہر ایکسچینج کے لیے شماریاتی اوپن انٹرسٹ بینڈ کلسٹرز (فنڈنگ سے اندازہ لگایا گیا کراڈ لیوریج)۔ ہر چیز واضح طور پر لیبل کی گئی ہے 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

دستیاب ہے: فری کوئی تصدیق کی ضرورت نہیں (فی آئی پی تھروٹلڈ)

ایک کراس وینو والیٹ پروفائل جو مکمل طور پر لائیو ٹریک کی گئی وہیل پوزیشن سنیپ شاٹس سے بنایا گیا ہے۔ ایک ٹریک کی گئی ہائپرلکویڈ وہیل کے لیے، موجودہ اوپن پوزیشنز، ایک غیر ریئلائزڈ-PnL / ایکسپوژر / پوزیشن کاؤنٹ ٹائم سیریز, ایک OPEN/CLOSE/FLIP ایکٹیویٹی ٹائم لائن (مسلسل سنیپ شاٹس کو ڈف کر کے دوبارہ بنایا گیا)، ڈیکوڈ کی گئی ایچ ایل لیڈر بورڈ لیبل، اور ایک اوپن بک سمیری۔ لائیو صفحہ: 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, win_rate_pct: 71, ٹریڈز: 42 },
 پوزیشنز: [
      { وینو: hyperliquid, سیمبل: ETH, ڈائریکشن: شورٹ,
 سائز: 1200.0, انٹری_پکس: 1800.0, غیر حقیقی_پی این ایل: 34800.0,
 لیوریج: 20.0, ویلیو_یو ایس ڈی: 2160000.0 }
    ],
 سیریز: [ { ts: 1783330000, غیر حقیقی_پی این ایل: 42000.0, ایکسپوژر_یو ایس ڈی: 18400000.0, پوزیشنز: 5 } ],
 ٹائم لائن: [ { ts: 1783400000, ایونٹ: فلپ, سیمبل: ETH,
 ڈائریکشن: شورٹ, فرام_ڈائریکشن: لانگ, ویلیو_یو ایس ڈی: 2160000.0 } ],
 سمری: {
 اوپن_پوزیشنز: 5, ان_پروفٹ: 3, ان_لاس: 2, لانگز: 0, شورٹس: 5,
 ٹوٹل_غیر حقیقی_پی این ایل: -12000.0, ٹوٹل_ایکسپوژر_یو ایس ڈی: 21000000.0, بلینڈڈ_لیوریج: 19.9,
 ونڈو_ڈیز: 30, سنے پشوٹس_ان_ونڈو: 474,
 ریلائزڈ_پی این ایل: None, ریلائزڈ_پی این ایل_نوٹ: Not derivable — only open snapshots are seen, never closing fills.
    }
  }
}

ایماندارانہ نوٹ: جو کچھ دکھایا گیا ہے وہ ہے حقیقی سنے پشوٹ ڈیٹا سے — pnl HL کا اپنا غیر حقیقی مارک-ٹو-مارکیٹ ہے، value_usd اوپن نوٹینل ہے۔ ریلائزڈ P&L فی راؤنڈ-ٹرپ دستیاب نہیں ہے (ہم صرف اوپن سنے پشوٹس دیکھتے ہیں، کبھی بھی کلوزنگ فلز نہیں) اور دکھایا جاتا ہے null / —; ٹائم لائن CLOSE ایونٹس میں کوئی P&L کا دعویٰ نہیں ہوتا۔ ایک درست لیکن ان ٹریکڈ ایڈریس واپس آتا ہے tracked: false ایک نوٹ کے ساتھ؛ ایک غلط ایڈریس واپس آتا ہے ok: false, error: "invalid_address" (HTTP 400)۔ HL-leaderboard لیبل HL کی اپنی ونڈو اسٹینڈنگ ہے دریافت پر، ہمارے ذریعے حساب نہیں لگایا گیا۔

GET /flows

ضروری ہے: پرو

BTC، ETH، اور SOL کے درمیان کراس-ایسیٹ کیپیٹل فلو ڈیٹا واپس کرتا ہے جو کئی وقت کی ونڈوز میں رورٹیشن پیٹرن دکھاتا ہے۔ یہ کسی بھی وقت یہ شناخت کرنے کے لیے مفید ہے کہ کون سا اثاثہ کیپیٹل جمع کر رہا ہے اور کون سا تقسیم ہو رہا ہے۔

مثال کا جواب

JSON

{
 ts: 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 }
  },
 روٹیشنز_ڈیٹیکٹڈ: [
 4h ونڈو میں ETH سے BTC کی طرف کیپیٹل کا رورٹیشن,
 تمام ونڈوز میں SOL کا مستقل اکمولیشن
  ]
}

پرو پلان کی ضرورت ہے۔ فلو ویلیوز ہر وقت ونڈو کے لیے یو ایس ڈی نیٹ انفلو (مثبت) یا آؤٹ فلو (منفی) ہیں۔

GET /whale-events

ضروری ہے: ٹریڈر پرو

ٹریکڈ والیٹس اور آن-چین ایڈریسز کے اندر مخصوص لوک-بیک ونڈو میں پائی جانے والی وہیل پوزیشن میں اہم تبدیلیاں — اوپنز، کلوزز، اور ڈائریکشن فلپس — واپس کرتا ہے۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
سیمبلاختیاری	سٹرنگ	اثاثے کے لحاظ سے فلٹر کریں۔ تمام مانیٹرڈ اثاثوں کے لیے چھوڑ دیں۔
سگنیفکنساختیاری	سٹرنگ	ایونٹ کی اہمیت کے لحاظ سے فلٹر کریں: `high`, `medium`, یا `all`. ڈیفالٹ: `all`
گھنٹےاختیاری	انٹیجر	گھنٹوں میں لوک-بیک ونڈو۔ ڈیفالٹ: `24`

مثال کا جواب

JSON

{
 سیمبل: BTC,
 سمری: {
 فلپس_ٹو_لانگ: 3,
 فلپس_ٹو_شورٹ: 1,
 نیو_اوپنز: 7,
 کلوزز: 2
  },
 ایونٹس: [
    {
 ٹائپ: فلپ لانگ,
 والٹ: 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,
 "ایکسچینجز": {
 "بائبٹ": { "اسٹیٹس": "ٹھیک", "لیٹنسی_ایم ایس": 42, "غلطی کی شرح_1 گھنٹہ": 0.0, "آخری ڈیٹا عمر_سیکنڈ": 18 },
 "بائننس": { "اسٹیٹس": "ٹھیک", "لیٹنسی_ایم ایس": 38, "غلطی کی شرح_1 گھنٹہ": 0.0, "آخری ڈیٹا عمر_سیکنڈ": 22 },
 "ہائپرلیکوئڈ": { "اسٹیٹس": "کمزور", "لیٹنسی_ایم ایس": 310, "غلطی کی شرح_1 گھنٹہ": 0.04, "آخری ڈیٹا عمر_سیکنڈ": 95 },
 "اوکے ایکس": { "اسٹیٹس": "ٹھیک", "لیٹنسی_ایم ایس": 55, "غلطی کی شرح_1 گھنٹہ": 0.0, "آخری ڈیٹا عمر_سیکنڈ": 30 }
  }
}

GET /sentiment

ضرورت ہے: ٹریڈر پرو

ڈیریویٹوز سینٹی منٹ، وہیل ایکٹیویٹی، والیٹیلیٹی، اور سوشل سگنلز سے شمار کردہ ریئل ٹائم فیئر اینڈ گرید انڈیکس (0-100) واپس کرتا ہے۔ ٹرینڈ تجزیہ کے لیے جزو بریک ڈاؤن اور 24 گھنٹے کی تاریخ شامل ہے۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
علامتاختیاری	string	اثاثے کا علامتی نام۔ ڈیفالٹ: `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 Script اشارے جو براہ راست Smart Money API سے جڑتے ہیں۔ TradingView میں Pine Script کو کاپی پیسٹ کریں تاکہ ہمارے اشاروں کو کسی بھی چارٹ پر نمایاں کیا جا سکے۔

جواب کی مثال

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(...)...",
 وہیل_ایکٹیویٹی: // وہیل ایکٹیویٹی اوورلے v1
...,
 فنڈنگ_ڈیش بورڈ: // فنڈنگ ریٹ + LSR ڈیش بورڈ 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 کراس اوور",
 "price": 67500.0
}

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

ذاتی تشکیل

GET /preferences

ضروریات: ٹریڈر پرو

آپ کی موجودہ ذاتی ترتیبات واپس کرتا ہے جس میں ڈیفالٹ ٹریڈ پیرامیٹرز، رسک پروفائل، واچ لسٹ، اور اطلاقی ترجیحات شامل ہیں۔

PUT /v1/preferences

ذیل میں موجود کسی بھی فیلڈز کے سب سیٹ کے ساتھ JSON بھیج کر ترجیحات کو اپ ڈیٹ کریں۔ چھوڑی گئی فیلڈز اپنی موجودہ ویلیوز برقرار رکھتی ہیں۔

ترجیحی فیلڈز

فیلڈ	ٹائپ	تفصیل
default_trade_size_usd	float	کیلکولیٹرز کے لیے USD میں ڈیفالٹ پوزیشن سائز
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

ضروریات: ٹریڈر پرو

آپ کی تشکیل کردہ واچ لسٹ میں تمام علامات (symbols) کے لیے تصدیقی حیثیت کا سنیپ شاٹ اور اہم خطرے کے پیمانے واپس کرتا ہے۔ ہر علامت کو الگ سے کال کیے بغیر کثیر اثاثوں کا جائزہ فراہم کرتا ہے۔ /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 Firehose (Paid)

ضروری ہے: ٹریڈر پرو

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

تصدیق (تجویز کردہ): کبھی بھی اپنی طویل مدتی کلید یو آر ایل میں نہ ڈالیں — یہ پراکسیز کے ذریعے لاگ ہوتی ہے اور براؤزر کی تاریخ میں محفوظ ہو جاتی ہے۔ اس کے بجائے اپنی کلید کو 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 کلید کو WebSocket یو آر ایل میں نہ ڈالیں — کوئری سٹرنگز پراکسیز، لوڈ بیلنسرز کے ذریعے لاگ ہوتی ہیں اور براؤزر کی تاریخ میں محفوظ ہو جاتی ہیں۔ اس کے بجائے، اپنی کلید کو مختصر مدتی، سنگل یوز ٹکٹ کے لیے ایک عام تصدیق شدہ 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 براہ راست ویب ساکٹ ہینڈ شیک پر — کوئی ٹکٹ درکار نہیں۔

POST /v1/ws/ticket

درکار ہے: ٹریڈر پرو

ایک بار استعمال ہونے والا ٹکٹ جاری کرتا ہے ایک تصدیق شدہ ویب ساکٹ ہینڈ شیک کے لیے۔ تصدیق کریں 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=` منسلک کیا جائے۔ ایک بار استعمال ہوتا ہے، پھر ناکارہ ہو جاتا ہے۔
ختم ہونے کا وقت	نمبر	ٹکٹ کے ختم ہونے تک سیکنڈ (~60)۔ ہر کنکشن کوشش کے لیے ایک تازہ ٹکٹ جاری کریں۔

نوٹ: پرانا ?key= کوئری پیرام تصدیق اب قبول نہیں کیا جاتا ویب ساکٹ اینڈ پوائنٹس پر سیکیورٹی وجوہات کی بنا پر۔ ٹکٹ (براؤزر کلائنٹس) یا X-API-Key ہینڈ شیک ہیڈر (سرور سائیڈ کلائنٹس) استعمال کریں۔

REST سنیپ شاٹ

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

رولنگ بفر سے آخری N براڈکاسٹ سوئپس واپس کرتا ہے۔ ڈیش بورڈز پر پہلی پینٹنگ کے لیے مفید ہے جب تک کہ اسٹریم کنکشن کھل نہ جائے۔ دستیاب بھی ہے: /v1/live-swaps/status براڈکاسٹر اعداد و شمار کے لیے۔

ایونٹ سکیمہ

فیلڈ	قسم	تفصیل
چین	سٹرنگ	`bsc` یا `avalanche`
dex	سٹرنگ	راؤٹر کا نام (مثلاً `pancakeswap_v2`, `traderjoe`) یا `unknown_dex`
سوئپر	سٹرنگ	والٹ کا مکمل 0x ایڈریس جس نے سوئپ کو انجام دیا
سوئپر شارٹ	سٹرنگ	ڈسپلے کے لیے مختصر شکل (مثلاً `0xb300…028d`)
سوئپر یو آر ایل	سٹرنگ	چین کے بلاک ایکسپلورر پر سوئپر کا براہ راست لنک
ٹرانزیکشن ہیش	سٹرنگ	ٹرانزیکشن ہیش
ایکسپلورر یو آر ایل	سٹرنگ	BscScan / Snowtrace پر ٹرانزیکشن کا براہ راست لنک
ٹوکن ان	سٹرنگ	فروخت کردہ ٹوکن کا علامتی نام (مثلاً `USDT`)
ٹوکن آؤٹ	سٹرنگ	خریدے گئے ٹوکن کا علامتی نام
رقم USD	نمبر	سوئپ کی USD ویلیو (کم از کم: $500)
جوڑا	سٹرنگ	فارمیٹڈ جوڑا لیبل (مثلاً `USDT → USDC`)
بلاک	نمبر	بلاک نمبر جہاں سوئپ مائن کیا گیا
ٹائم اسٹیمپ	نمبر	یونکس ایپاک سیکنڈ
اہمیت	سٹرنگ	`low` / `medium` / `high` / `critical` USD سائز کی بنیاد پر
سیریز	نمبر	مونوٹونک براڈکاسٹ سیریل نمبر — گیپ ڈٹیکشن کے لیے استعمال کریں

POST /alerts/conditions

درکار ہے: پرو

کسٹم الرٹ قواعد بنائیں جو کسی مخصوص میٹرک کے تھریشولڈ کو عبور کرنے پر ٹرگر ہوں۔ الرٹس ویب ہک، ای میل، یا ڈیش بورڈ نوٹیفکیشن فیڈ کے ذریعے فراہم کیے جاتے ہیں، آپ کی ترجیحات کے مطابق۔

GET /v1/alerts/conditions

آپ کے تمام کنفیگرڈ الرٹ شرائط کی فہرست واپس کرتا ہے ان کی آئی ڈیز، تعریفوں، اور موجودہ حیثیت کے ساتھ۔

DELETE /v1/alerts/conditions/{id}

الرٹ کی شرط کو اس کی آئی ڈی کے ذریعے مستقل طور پر ہٹاتا ہے۔

GET /v1/alerts/history

حالیہ الرٹ ٹرگر ایونٹس کو ٹائم اسٹیمپس، مماثل شرائط، اور ٹرگر کے وقت میٹرک ویلیو کے ساتھ واپس کرتا ہے۔

الرٹ بنائیں — درخواست کا جسم

فیلڈ	قسم	تفصیل
نامدرکار ہے	string	اس الرٹ کے لیے انسانی پڑھنے کے قابل لیبل (زیادہ سے زیادہ 64 حروف)
میٹرکضروری	string	نگرانی کرنے کے لیے میٹرک۔ نیچے دستیاب میٹرکس کی جدول دیکھیں۔
علامتاختیاری	string	ایسٹ کا سیاق و سباق۔ علامت سے متعلق میٹرکس کے لیے ضروری ہے جیسے `funding_rate`.
آپریٹرضروری	string	موازنہ آپریٹر: `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
تھریشولڈضروری	float	میٹرک کے خلاف موازنہ کرنے کے لیے عددی قدر
ڈیلیوریاختیاری	string	ڈیلیوری چینل، مثلاً `telegram` (ڈیفالٹ) یا `webhook`
cooldown_minutesاختیاری	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

ضروری ہے: پرو

دی گئی علامت، اعتماد کی سطح، اور سمت کے لیے تاریخی سگنل کارکردگی کے مطابق کیلی کریٹیرین پوزیشن سائزنگ کی سفارشات واپس کرتا ہے۔ پوزیشن سائز کو تجرباتی جیت کی شرح پر مبنی کرتا ہے تاکہ اوور لیوریجنگ سے بچا جا سکے۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
symbolضروری	string	ایسٹ کی علامت: `BTC`, `ETH`, یا `SOL`
confidenceاختیاری	string	ماڈل کرنے کے لیے سگنل اعتماد کی سطح: `HIGH`, `MEDIUM`, یا `LOW`. ڈیفالٹ: `HIGH`
directionاختیاری	string	ٹریڈ کی سمت: `long` یا `short`. ڈیفالٹ: `long`
account_sizeاختیاری	float	حساب کرنے کے لیے اکاؤنٹ سائز USD میں `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

دستیاب ہے: فری ٹریڈر پرو

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 مختلف کال کے نتائج۔ 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: { 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 آبجیکٹ وہ واحد نمبر ہے جو ایسے ڈیٹا پر حاصل کیا گیا ہے جسے اسکورر نے کبھی نہیں دیکھا — وقت کے ساتھ اس کے بڑھنے کا مشاہدہ کریں۔ مکمل طریقہ کار اور ان-سیمپل / فارورڈ-ٹیسٹ کی حد کے لیے دیکھیں calibration.html مکمل طریقہ کار اور ان-سیمپل / فارورڈ-ٹیسٹ کی حد کے لیے۔

GET /v1/signals/performance

دستیاب ہے: Free Trader Pro کوئی تصدیق درکار نہیں

مختلف قرارداد افقوں (4h, 12h, 24h, 72h) پر سگنل آؤٹکم ٹریکنگ۔ ہر افق کے لیے ہٹ ریٹس، کل سگنل کاؤنٹس، اور سگنل کی قسم کی تفصیلات واپس کرتا ہے۔

پیرامیٹرز

پیرامیٹر	قسم	تفصیل
daysاختیاری	integer	دنوں میں نظر ثانی کی ونڈو۔ ڈیفالٹ: `30`
signal_typeاختیاری	string	قسم کے لحاظ سے فلٹر کریں، مثلاً `smart_money_confirm` یا `regime_flip`۔ تمام اقسام کے لیے چھوڑ دیں۔
symbolاختیاری	string	ایسیٹ کے نشان کے لحاظ سے فلٹر کریں، مثلاً `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

دستیاب: مفت ٹریڈر پرو کوئی تصدیق کی ضرورت نہیں

تمام زیر نظر علامات میں حال ہی میں شائع ہونے والے HIGH اور MEDIUM سگنلز کی فیڈ۔ ہر اندراج میں سگنل کی قسم، اعتماد کی سطح، سمت، اور دستیاب ہونے کی صورت میں حل شدہ حیثیت شامل ہوتی ہے۔

مثال کا جواب

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

دستیاب: مفت ٹریڈر پرو کوئی تصدیق کی ضرورت نہیں

کسی ایک سگنل کا اس کے عددی ID کے ذریعے حل شدہ نتیجہ۔ ہر حل شدہ افق (4h, 12h, 24h, 72h) پر ہٹ/مِس کے ساتھ ساتھ سگنل کے وقت اور حل شدہ وقت کی قیمت بھی واپس کرتا ہے۔

پیرامیٹرز

پیرامیٹر	قسم	تفصیل
idضروری	integer	سگنل 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 ہٹ کے حساب سے نہیں — اس سے بار بار پول کرنے والے بوٹس کی وجہ سے تعداد میں اضافے کو روکا جاتا ہے۔ اعداد و شمار 30 دن کی طے شدہ کھڑکی میں نمونے کے اندر ہیں؛ اسی طرح کی تنبیہ /v1/stats لاگو ہوتا ہے۔

شیڈو گیٹ

ضروریات: مفت ٹریڈر پرو

ایک ناقابل تغیر، صرف شامل کرنے والی ذاتی فیصلہ کی کتاب۔ اپنے تجارتی فیصلے ان کے عمل کرنے سے پہلے یا بعد میں جمع کروائیں؛ نظام اسمارٹ منی انجن کے خلاف ایک تصدیقی اسکور کا حساب لگاتا ہے اور ایک مستقل قطار شامل کرتا ہے۔ اسے ایک ایماندار، وقت کے ساتھ محفوظ شدہ ریکارڈ بنانے کے لیے استعمال کریں کہ کس طرح 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,
 ٹی ایس: 1710940821,
 حل شدہ: غلط
}

ٹیئر نوٹ۔ مفت اور ٹریڈر جوابات چھوڑ دیں۔ factors / adjustments ثبوت کے فیلڈز۔ Pro مکمل تصدیق کی تفصیلات فراہم کرتا ہے۔ Free کے لیے ایک درجے کی تاخیر لاگو ہوتی ہے — قطار فوراً لکھ دی جاتی ہے لیکن تصدیقی اسکور کیش شدہ ڈیٹا کو ظاہر کر سکتا ہے جو 60 سیکنڈ پرانا ہو سکتا ہے۔

GET /v1/shadow-gate/decisions

اپنی خود کی شاڈو گیٹ فیصلوں کی فہرست، نئے سے پرانے ترتیب میں۔ مالک تک محدود — صرف وہ فیصلے جو آپ کے API کلید کے ذریعے جمع کرائے گئے ہیں واپس کیے جاتے ہیں۔

پیرامیٹرز

پیرامیٹر	ٹائپ	تفصیل
limitاختیاری	integer	واپس کرنے کے لیے زیادہ سے زیادہ قطاریں۔ پہلے سے طے شدہ: `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": "short", "decision": "SKIP", "confidence": "LOW", "composite": -0.12, "size_mult": 0.0, "ts": 1710937000, "resolved": true }
  ],
 "count": 2,
 "next_cursor": null
}

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

ID کے ذریعے ایک فیصلہ، بشمول Pro tier کے لیے مکمل تصدیقی ثبوت۔ Free اور Trader tier کے جوابات میں factors اور adjustments ہٹا دیا گیا۔ واپس کرتا ہے 403 اگر فیصلہ کسی دوسرے API key سے تعلق رکھتا ہے۔

مثال کا جواب (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": null
}

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

دستی طور پر کسی فیصلے کے نتیجے کو حل کریں۔ تجارت بند کرنے کے بعد اسے کال کریں تاکہ لیجر قطار میں حتمی نتیجہ ریکارڈ کیا جا سکے۔ ایک بار حل ہونے کے بعد، قطار کو تبدیل نہیں کیا جا سکتا۔

درخواست کا جسم

فیلڈ	قسم	تفصیل
outcomeضروری	سٹرنگ	تجارت کا نتیجہ: `win` یا `loss`
exit_priceاختیاری	فلوٹ	تجارت کی خروجی قیمت۔ حوالہ کے لیے محفوظ؛ اگر فراہم کی گئی ہو تو P&L % کا حساب لگانے کے لیے استعمال ہوتی ہے۔
pnl_pctاختیاری	فلوٹ	حقیقت پسندانہ P&L پوزیشن کے سائز کے فیصد کے طور پر، مثال کے طور پر `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 key
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()

# 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 (!resok) throw new Error(`API error: ${resstatus}`);
 return res.json();
}

// Usage
confirmTrade('BTC', 'long').then(data => {
  console.log(dataconfidence, datasize_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 انضمام

کسی بھی Freqtrade حکمت عملی میں اسمارٹ منی کی تصدیق شامل کریں confirm_trade_entry طریقہ

Python — Freqtrade حکمت عملی

درآمد کریں درخواستیں
سے freqtrade.strategy درآمد کریں IStrategy

کلاس 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 # 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"Skipping {symbol} {side} — ناکافی اعتماد.")
 return None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 print(f"Order placed: {adj_amount} {symbol} {side}")
 return order

مدد چاہیے؟

چیک کریں API کی حیثیت کا صفحہ حقیقی وقت کی صحت کی معلومات کے لیے، یا ہمارا استعمال کریں رابطہ فارم.