API रेफरेंस

Smart Money 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 एजेंट से — और कैपिटल कमिट करने से पहले एक फास्ट, प्री-ट्रेड CONFIRM / REDUCE / SKIP डिसीजन चाहते हैं।

एक टाइपिकल लूप: आपकी स्ट्रैटेजी फायर करती है "go long BTC" → आप कॉल करते हैं GET /v1/confirm?symbol=BTC&direction=long → आप एंट्री को कन्फर्म, रिड्यूस या स्किप करते हैं और साइज़ को स्केल करते हैं size_mult. वन कॉल, सिंगल लो-लेटेंसी JSON रिस्पॉन्स, कोई एक्स्ट्रा इंफ्रास्ट्रक्चर नहीं।

यह नहीं है एक स्टैंडअलोन सिग्नल जनरेटर, चार्टिंग प्रोडक्ट या एक्जीक्यूशन वेन्यू। अगर आपके पास गेट करने के लिए कोई सिग्नल नहीं है, तो शुरुआत करें परफॉर्मेंस पेज से यह देखने के लिए कि स्कोर ने लाइव बॉट में वायर करने से पहले कैसा परफॉर्म किया है।

एक्सेस प्राप्त करना

1 — साइन अप करें। एक फ्री अकाउंट बनाएं signup पर (ईमेल/पासवर्ड या Google)। फ्री टियर के लिए क्रेडिट कार्ड की जरूरत नहीं।

2 — अपना डैशबोर्ड खोलें। आपका डैशबोर्ड आपका API की, करंट प्लान और डेली कोटा के खिलाफ लाइव यूसेज दिखाता है।

3 — अपना API की कॉपी करें। कीज़ प्रीफिक्स्ड होती हैं sm_. इसे हर रिक्वेस्ट पर X-API-Key हेडर के रूप में पास करें (देखें प्रमाणीकरण)। कभी भी अपग्रेड करें मूल्य निर्धारण पृष्ठ सीमाएँ बढ़ाने और अधिक प्रतीकों और एंडपॉइंट्स को अनलॉक करने के लिए।

स्पेक, एसडीके और कुकबुक

आपको जल्दी से एकीकृत करने के लिए आवश्यक सब कुछ, चाहे आप कोड स्वयं लिखें या इसे कोडिंग एजेंट को सौंप दें।

संसाधन	यह क्या है
कुकबुक	सबसे सामान्य एकीकरणों के लिए कॉपी-पेस्ट रेसिपी — प्रवेश से पहले पुष्टि करें, Freqtrade सिग्नल को गेट करें, गुणक द्वारा आकार दें, 402/429 को संभालें, और इसे कोडिंग एजेंट में वायर करें।
ओपनएपीआई स्पेक	प्रत्येक एंडपॉइंट की मशीन-पठनीय ओपनएपीआई परिभाषा। पोस्टमैन/इन्सोम्निया में आयात करें, क्लाइंट जनरेट करें, या एलएलएम को फीड करें। `github.com/tashiardit/smartmoneyapi-docs`.
पायथन क्लाइंट	आधिकारिक पायथन क्लाइंट लाइब्रेरी `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	एपीआई का एलएलएम-अनुकूल सादा-पाठ सारांश। क्लॉड, कोडेक्स, या कर्सर को इस पर इंगित करें (देखें कोडिंग एजेंट्स).

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": ["सभी वेन्यूज़ पर फंडिंग रेट पॉजिटिव", "व्हेल्स: 67% लॉन्ग सहमति"]
}

जब confidence है HIGH या MEDIUM और action है CONFIRM, अपनी पोजीशन का आकार size_multद्वारा स्केल करें। यह पूरा इंटीग्रेशन लूप है। पूर्ण फील्ड संदर्भ के लिए प्रतिक्रिया फील्ड्स देखें।

प्रमाणीकरण

सभी अनुरोधों के लिए एक एपीआई कुंजी की आवश्यकता होती है जिसे X-API-Key HTTP हेडर के रूप में पास किया जाता है।

HTTP हेडर
X-API-Key: sm_your_api_key_here

आपकी एपीआई कुंजी डैशबोर्ड से साइन अप करने के बाद उपलब्ध है। अपनी कुंजी को गुप्त रखें — इसे क्लाइंट-साइड कोड या पब्लिक रिपॉजिटरीज़ में एक्सपोज़ न करें।

वेबसॉकेट प्रमाणीकरण अलग है। अपनी कुंजी को कभी भी वेबसॉकेट यूआरएल में न डालें। रियल-टाइम स्ट्रीम्स अल्पकालिक, एकल-उपयोग टिकट्सका उपयोग करती हैं: अपनी कुंजी को /v1/ws/ticket पर पोस्ट करें X-API-Key हेडर के साथ, फिर लौटाए गए टिकट के साथ कनेक्ट करें। देखें वेबसॉकेट प्रमाणीकरण (टिकट्स).

गूगल साइन-इन (Firebase Auth)

उपयोगकर्ता Firebase प्रमाणीकरण के माध्यम से अपने Google खाते का उपयोग करके प्रमाणित कर सकते हैं। क्लाइंट पर Google साइन-इन के बाद, Firebase ID टोकन को लिंक्ड API सत्र के लिए एक्सचेंज करें। सिस्टम आपकी Google पहचान को स्वचालित रूप से API कुंजी प्रणाली के साथ सिंक करता है।

उपलब्ध: फ्री ट्रेडर प्रो

POST /auth/google

अनुरोध बॉडी

फील्ड	प्रकार	विवरण
id_tokenआवश्यक	स्ट्रिंग	क्लाइंट पर Google साइन-इन के बाद प्राप्त Firebase ID टोकन

उदाहरण प्रतिक्रिया

JSON

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

उपयोगकर्ता प्रोफ़ाइल डेटा — ईमेल, योजना, उपयोग इतिहास, प्राथमिकताएँ — Firestore में संग्रहीत होता है और आपके Google खाते से लिंक्ड होता है। डैशबोर्ड प्राइवेसी सेटिंग्स के माध्यम से कभी भी पूर्ण डेटा निर्यात या खाता हटाने का अनुरोध किया जा सकता है।

दर सीमाएँ

योजना	कॉल्स/दिन	बर्स्ट सीमा	डेटा विलंब
फ्री	50	2/मिनट	60 सेकंड
ट्रेडर	1,000	20/मिनट	रियल-टाइम
प्रो	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	भुगतान_आवश्यक	एंडपॉइंट या सिंबल को आपकी कुंजी की तुलना में एक उच्च योजना की आवश्यकता है (जैसे वेबसॉकेट फायरहोस को कॉल करने वाली मुफ्त कुंजी)। अपग्रेड करें या पब्लिक एंडपॉइंट पर वापस जाएं।
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 अब वेबसॉकेट एंडपॉइंट्स पर इसी कारण से स्वीकार नहीं किया जाता है।

कुंजियाँ सर्वर-साइड रखें। कभी भी API कुंजी को क्लाइंट-साइड JavaScript, मोबाइल ऐप बंडल या पब्लिक रिपॉजिटरी में एम्बेड न करें। इसे एनवायरनमेंट वेरिएबल या सीक्रेट मैनेजर से लोड करें। यदि कुंजी लीक हो जाती है, तो इसे रोटेट करें।

कुंजियाँ समय-समय पर रोटेट करें। अपनी कुंजी को पुनः उत्पन्न करें डैशबोर्ड पर एक शेड्यूल पर और तुरंत यदि आपको एक्सपोजर का संदेह है। पुरानी कुंजी नई कुंजी जारी होते ही काम करना बंद कर देती है।

ब्राउज़र सॉकेट्स के लिए टिकट का उपयोग करें। ब्राउज़र से रीयल-टाइम स्ट्रीम्स के लिए, अपनी कुंजी को सिंगल-यूज़ टिकट के लिए एक्सचेंज करें न कि रॉ कुंजी के साथ कनेक्ट करें — देखें वेबसॉकेट प्रमाणीकरण (टिकट).

कोडिंग एजेंट्स / LLM के साथ उपयोग

क्लॉड कोड, कोडेक्स, कर्सर, या किसी LLM कोडिंग एजेंट के साथ निर्माण कर रहे हैं? आप एजेंट को वह सब कुछ दे सकते हैं जो इस API को सही तरीके से वायर करने के लिए एक बार में आवश्यक है। दो मशीन-पठनीय संदर्भ प्रकाशित किए गए हैं:

संसाधन	URL
LLM सारांश	`https://smartmoneyapi.com/llms.txt`
ओपनएपीआई स्पेक	`github.com/tashiardit/smartmoneyapi-docs`

अपने एजेंट को इंगित करें /llms.txt फ़ाइल (the llms.txt convention) एक संक्षिप्त अवलोकन के लिए, फिर ओपनएपीआई स्पेक को सटीक अनुरोध/प्रतिक्रिया आकारों के लिए। एक-लाइन प्रॉम्प्ट जो अच्छी तरह से काम करता है:

प्रॉम्प्ट

# क्लॉड कोड / कर्सर / कोडेक्स में पेस्ट करें
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,
 डेरिवेटिव स्कोर: 0.81,
 ऑनचेन स्कोर: 0.68,
 व्हेल स्कोर: 0.73,
 एक्स स्कोर: 0.0,
 कारक: {
 डेरिवेटिव्स: { स्कोर: 0.81, वजन: 0.40, वेटेड: 0.324 },
 ऑनचेन: { स्कोर: 0.68, वजन: 0.35, वेटेड: 0.238, स्रोत: कॉइनमेट्रिक्स, उपलब्ध: 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 मैप। ऑन-चेन लेग उपयोग करता है वास्तविक मुफ्त कॉइन मेट्रिक्स डेटा (MVRV / एक्सचेंज-फ्लो / एक्टिव-एड्रेस) जब कोई ग्लासनोड कुंजी सेट नहीं है। यह एक मल्टी-फैक्टर संगम स्कोर — निर्णय समर्थन, गारंटीकृत जीत दर नहीं.

अनट्रैक्ड प्रतीक ईमानदार हैं। एक प्रतीक जो ट्रैक किए गए डेरिवेटिव्स/व्हेल यूनिवर्स से बाहर है, एक स्पष्ट "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" के साथ लौटाता है "unsupported":true — कभी भी गढ़ा हुआ नहीं LOW.

प्रतिक्रिया फ़ील्ड्स

फ़ील्ड	प्रकार	विवरण
ts	पूर्णांक	गणना का यूनिक्स टाइमस्टैम्प
symbol	स्ट्रिंग	एसेट प्रतीक (BTC/ETH/SOL)
direction	स्ट्रिंग	अनुरोधित दिशा (लॉन्ग/शॉर्ट)
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	फ्लोट	एक्स/सोशल-सेंटिमेंट उप-स्कोर (-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 ऑप्शन एनालिटिक्स (पब्लिक, नो ऑथ): पुट/कॉल रेशियो, मैक्स पेन, और स्ट्राइक के अनुसार ओपन इंटरेस्ट। एंडपॉइंट्स: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

स्पॉट BTC और ETH ETF डेली नेट फ्लो और फंड-वार ब्रेकडाउन (पब्लिक)। एंडपॉइंट्स: /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

बैकटेस्टिंग के लिए हिस्टोरिकल फंडिंग, ओपन इंटरेस्ट, लॉन्ग/शॉर्ट रेशियो (Binance), और OHLCV (CoinGecko)। एंडपॉइंट्स: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

DexScreener-पावर्ड ट्रेंडिंग पेयर्स, टोकन सर्च, और पेयर डिटेल्स (पब्लिक, नो ऑथ)। एंडपॉइंट्स: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

न्यूज़ इंटेलिजेंस: पॉलिसी/जियोपॉलिटिकल/क्रिप्टो न्यूज़ को इम्पैक्ट कैटेगरीज़ में वर्गीकृत, साथ ही फियर & ग्रीड (पब्लिक, नो ऑथ)। एंडपॉइंट्स: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

व्हेल वॉलेट कंसेंसस डेटा रिटर्न करता है: लॉन्ग/शॉर्ट स्प्लिट, टोटल नोशनल एक्सपोज़र, टॉप 10 पोजीशन्स (प्रो ओनली), और वॉलेट काउंट।

आवश्यकता: ट्रेडर प्रो

GET /signals

मॉनिटर की गई सभी एसेट्स पर सबसे हाल के HIGH/MEDIUM सिग्नल्स की स्ट्रीम रिटर्न करता है। अवसर स्कैनिंग के लिए उपयोगी।

आवश्यकता: प्रो

GET /v1/strategies/*

स्मार्ट मनी सिग्नल्स पर चलने वाली ऑटोमेटेड ट्रेडिंग स्ट्रैटेजीज़ के लिए पारदर्शी, रीड-ओनली ट्रैक रिकॉर्ड — जिसमें deriv40 SmartMoney कॉपीट्रेड स्ट्रैटेजी (account=9) शामिल है। सभी एंडपॉइंट्स एक ?account=<id> query पैरामीटर लेते हैं और 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 — क्लोज्ड-ट्रेड लेजर: array (या {trades:[…]}) का symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 — वर्तमान में ओपन पोजीशन्स: array (या {positions:[…]}) का symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals — स्ट्रैटेजीज़ को फीड करने वाले सिग्नल-टाइप ब्रेकडाउन (काउंट / विन्स / win_rate / avg_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× तक रिट्री होती हैं।

रिक्वेस्ट बॉडी

फील्ड	टाइप	डिस्क्रिप्शन
urlrequired	string	इवेंट्स को POST करने के लिए HTTPS एंडपॉइंट ( `https://`)
eventsrequired	array	इवेंट नाम, जैसे `["HIGH","MEDIUM","VETO"]` या `["*"]`
symbolsrequired	array	फिल्टर करने के लिए सिम्बल्स, जैसे `["BTC","ETH"]` या `["*"]`
secretrequired	string	आपका साइनिंग सीक्रेट, ≥ 16 chars (स्टोर्ड हैश्ड)

सिग्नेचर वेरिफाई करना

HMAC की SHA-256 हेक्स डाइजेस्ट आपके रजिस्टर्ड सीक्रेट है। उस की के साथ रॉ रिक्वेस्ट बॉडी का HMAC-SHA256 कंप्यूट करें और (कॉन्स्टेंट-टाइम) के खिलाफ तुलना करें X-SmartMoney-Signature. देखें Webhook Implementation गाइड.

इंटेलिजेंस

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": ["उच्च फंडिंग", "ओपन इंटरेस्ट डाइवर्जेंस", "व्हेल कटौती"],
 "recommendation": "लॉन्ग एक्सपोजर कम करें, स्टॉप टाइट करें। मौजूदा कीमत से ऊपर नए लॉन्ग से बचें।",
 "time_horizon": "4h–12h"
}

प्रो प्लान आवश्यक। AI प्रोसेसिंग ओवरहेड के कारण यह एंडपॉइंट प्रति अनुरोध 3 API कॉल्स का उपयोग करता है।

GET /liquidations

आवश्यकता: ट्रेडर प्रो

रिटर्न करता है दो पूरक दृश्य: (1) लीवरेज-प्रोजेक्टेड levels — एक अनुमान कहाँ लिक्विडेशन क्लस्टर्स स्थित हैं; और (2) एक realized_heatmap — REAL executed फोर्स्ड-लिक्विडेशन इंटेंसिटी (कीमत × समय), सार्वजनिक एक्सचेंज WebSocket फीड्स से लाइव एकत्रित: Binance, OKX, Bybit, Bitget, BitMEX. हीटमैप तब मौजूद होता है जब स्ट्रीम में सिंबल के लिए डेटा होता है (बहुत शांत मार्केट या स्टार्टअप के तुरंत बाद अनुपस्थित)।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
symbolवैकल्पिक	string	एसेट सिंबल (डिफॉल्ट `BTC`). रियल हीटमैप एक्टिवली-ट्रेडेड परप सिंबल्स को कवर करता है।

उदाहरण प्रतिक्रिया

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // REAL executed liquidations — 5 एक्सचेंजों से लाइव
 "realized_heatmap": {
 "window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
 "clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
  }
}

ट्रेडर प्लान: cascade_risk, निकटतम दूरियाँ, और रियलाइज्ड टोटल्स/बाय-साइड। प्रो प्लान: पूर्ण प्रोजेक्टेड levels प्लस पूर्ण realized_heatmap (मैट्रिक्स, प्रति-कीमत क्लस्टर्स, प्रति-एक्सचेंज काउंट्स)। प्रोजेक्टेड अनुमान बताता है "स्टॉप्स कहाँ हैं"; रियलाइज्ड हीटमैप दिखाता है "वास्तव में क्या लिक्विडेट हुआ।"

GET /liquidations/heatmap

उपलब्ध: फ्री कोई प्रमाणीकरण आवश्यक नहीं (प्रति-IP थ्रॉटल्ड)

पब्लिक कीमत-स्तर लिक्विडेशन हीटमैप। रिटर्न करता है एक Coinglass-स्टाइल कीमत × समय मैट्रिक्स REAL executed फोर्स्ड लिक्विडेशन्स, जिस कीमत पर प्रत्येक लिक्विडेशन प्रिंट हुआ उसके अनुसार बकेटेड — सार्वजनिक एक्सचेंज WebSocket फीड्स से लाइव एकत्रित: Binance, OKX, Bybit, Bitget, BitMEX. clusters ऐरे प्रैक्टिकल आउटपुट है: लिक्विडेटेड नोशनल द्वारा रैंक की गई कीमत बकेट्स, प्रत्येक अपने डॉमिनेंट साइड के साथ टैग्ड। डेटा लाइव स्ट्रीम पर निर्भर करता है — एक बहुत शांत सिंबल या अभी-अभी रीस्टार्ट किया गया गेटवे वेल-फॉर्म्ड खाली स्ट्रक्चर प्लस एक ईमानदार 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

आवश्यक: ट्रेडर प्रो

एक्ज़ीक्यूटेड ऑन-चेन DeFi लेंडिंग लिक्विडेशन्स हमारे खुद के लोकल 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 } },
 नोड्स: { bsc: { पहुंच योग्य: true, हेड ब्लॉक: 89173010, इवेंट्स_टोटल: 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_spreadवैकल्पिक	float	शामिल करने के लिए न्यूनतम फंडिंग रेट स्प्रेड (दशमलव के रूप में)। डिफ़ॉल्ट: `0.01`
symbolवैकल्पिक	string	किसी विशिष्ट एसेट पर फ़िल्टर करें। सभी समर्थित एसेट्स को स्कैन करने के लिए छोड़ दें।

उदाहरण प्रतिक्रिया

JSON

{
 "ts": 1710940821,
 "opportunities": [
    {
 "symbol": "BTC",
 "spread": 0.032,
 "apr": 84.2,
 "long_exchange": "hyperliquid",
 "short_exchange": "bybit",
 "action": "Long HYPE / Short BYBIT",
 "estimated_profit_8h_usd": 26.4
    }
  ]
}

ट्रेडर योजना: केवल शीर्ष 1 अवसर, कोई ऐतिहासिक स्प्रेड डेटा नहीं। प्रो योजना: सभी वर्तमान अवसर प्रति एक्सचेंज जोड़ी के साथ 24 घंटे का स्प्रेड इतिहास।

मुफ्त सार्वजनिक वेरिएंट नो ऑथ

एक नो-की पब्लिक एंडपॉइंट शीर्ष 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,
 कुल USD: 2447900000.0, शुद्ध USD: -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

उपलब्ध है: मुफ्त कोई प्रमाणीकरण आवश्यक नहीं (प्रति-IP थ्रॉटल्ड)

डीलर गामा एक्सपोजर (GEX) एनालिटिक्स के लिए BTC & ETH, डेरिबिट ऑप्शन चेन से लाइव गणना की गई (कोई प्रमाणीकरण नहीं)। स्ट्राइक के अनुसार शुद्ध डीलर GEX लौटाता है (SpotGamma डीलर-शॉर्ट कन्वेंशन), गामा-फ्लिप स्तर (स्ट्राइक जहां संचयी शुद्ध GEX शून्य को पार करता है), IV टर्म स्ट्रक्चर (एटीएम इम्प्लाइड वोल दिनों-से-एक्सपायरी के अनुसार), और एक फ्रंट-एक्सपायरी IV स्केव (25Δ-प्रॉक्सी रिस्क रिवर्सल)। GEX रेजिम है positive (डीलर लॉन्ग गामा → वोल-दबाने वाला) या negative (वोल-बढ़ाने वाला)। पूरी तरह से स्वतंत्र — हर कॉल पर पुनर्गणना, कोई संग्रहित-DB निर्भरता नहीं।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
प्रतीकवैकल्पिक	स्ट्रिंग	`BTC` या `ETH` केवल. डिफ़ॉल्ट: `BTC`.

उदाहरण अनुरोध

GET (कोई प्रमाणीकरण नहीं)

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

उदाहरण प्रतिक्रिया

JSON

{
 प्रतीक: BTC, उपलब्ध: True, स्पॉट: 63203.0,
 net_gex: 18240000.0, शासन: सकारात्मक,
 गामा_फ्लिप: 64919.82, गामा_फ्लिप_pct: 2.72,
 कॉल_gex: 31200000.0, पुट_gex: -12960000.0,
 स्ट्राइक_द्वारा: [
    { स्ट्राइक: 60000, net_gex: -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 — यह प्रति-खाता मार्जिन, क्रॉस बनाम आइसोलेटेड, जोड़ा गया मार्जिन, या एडीएल नहीं जान सकता।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
सिंबलवैकल्पिक	स्ट्रिंग	एसेट सिंबल। डिफॉल्ट: `BTC`.
मूव_पीसीटीवैकल्पिक	फ्लोट	प्रतिशत के रूप में काल्पनिक मूल्य परिवर्तन (नकारात्मक = नीचे, सकारात्मक = ऊपर)। डिफॉल्ट: `-5`.

उदाहरण अनुरोध

GET (no auth)

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": "अनुमानित — यह प्रति-खाता मार्जिन, क्रॉस बनाम आइसोलेटेड, जोड़ा गया मार्जिन, या एडीएल नहीं जान सकता।" }
}

ईमानदार नोट: हर अनुमानित संख्या वास्तविक डीबी रीड से प्राप्त की जाती है; विफलता पर कुछ भी नकली नहीं है। एक अनट्रैक्ड सिंबल, पुरानी स्नैपशॉट, या लापता मूल्य वापस आता है ok: true, empty: true एक सरल-अंग्रेजी संदेश के साथ, नकली बार नहीं। realized_context लाइव मजबूर-तरलता स्ट्रीम से एक युवा, बढ़ता नमूना है, जिसे केवल संदर्भ के रूप में सामने लाया जाता है — यह कभी भी अनुमान को "वास्तविक" नहीं बनाता।

GET /v1/wallet/{addr}/profile

उपलब्ध: मुफ्त कोई प्रमाणीकरण आवश्यक नहीं (प्रति-आईपी थ्रॉटल किया गया)

एक क्रॉस-वेन्यू वॉलेट प्रोफाइल पूरी तरह से लाइव ट्रैक्ड-व्हेल पोजीशन स्नैपशॉट से बनाया गया। एक ट्रैक किए गए हाइपरलिक्विड व्हेल के लिए, वर्तमान खुली पोजीशन, एक अवास्तविक-पीएनएल / एक्सपोजर / पोजीशन-काउंट समय श्रृंखला, एक OPEN/CLOSE/FLIP गतिविधि टाइमलाइन (लगातार स्नैपशॉट्स को डिफ करके पुनर्निर्मित), डिकोड किया गया एचएल-लीडरबोर्ड लेबल, और एक ओपन-बुक सारांश। लाइव पेज: wallet-profiler.html.

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
addrआवश्यक	स्ट्रिंग	वॉलेट पता (पाथ सेगमेंट), जैसे `/v1/wallet/0x3bcae23e…/profile`.
daysवैकल्पिक	integer	श्रृंखला और टाइमलाइन के लिए लुक-बैक विंडो। डिफॉल्ट: `30`.

उदाहरण अनुरोध

GET (no auth)

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

उदाहरण प्रतिक्रिया

JSON

{
 "ok": true, "wallet": "0x3bcae23e…", "tracked": true,
 "first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
 "hyperliquid": {
 "label": { "name": "Andre is back", "score": 74,
 "window_pnl_usd": 1307000, जीत दर (%): 71, ट्रेड्स: 42 },
 पोजीशन्स: [
      { वेन्यू: hyperliquid, सिंबल: ETH, दिशा: शॉर्ट,
 साइज़: 1200.0, एंट्री प्राइस: 1800.0, अनरियलाइज़्ड P&L: 34800.0,
 लिवरेज: 20.0, वैल्यू USD: 2160000.0 }
    ],
 सीरीज़: [ { टाइमस्टैम्प: 1783330000, अनरियलाइज़्ड P&L: 42000.0, एक्सपोज़र USD: 18400000.0, पोजीशन्स: 5 } ],
 टाइमलाइन: [ { टाइमस्टैम्प: 1783400000, इवेंट: फ्लिप, सिंबल: ETH,
 दिशा: शॉर्ट, पूर्व दिशा: लॉन्ग, वैल्यू USD: 2160000.0 } ],
 सारांश: {
 खुली पोजीशन्स: 5, लाभ में: 3, हानि में: 2, लॉन्ग्स: 0, शॉर्ट्स: 5,
 कुल अनरियलाइज़्ड P&L: -12000.0, कुल एक्सपोज़र USD: 21000000.0, मिश्रित लिवरेज: 19.9,
 विंडो (दिन): 30, विंडो में स्नैपशॉट्स: 474,
 रियलाइज़्ड P&L: None, रियलाइज़्ड P&L नोट: गणना योग्य नहीं — केवल खुले स्नैपशॉट्स दिखाई देते हैं, क्लोज़िंग फिल्स कभी नहीं।
    }
  }
}

स्पष्ट नोट: दिखाया गया सब कुछ वास्तविक है स्नैपशॉट डेटा से — pnl HL का अपना अनरियलाइज़्ड मार्क-टू-मार्केट है, value_usd खुला नोशनल है। राउंड-ट्रिप प्रति रियलाइज़्ड P&L उपलब्ध नहीं है (हम केवल खुले स्नैपशॉट्स देखते हैं, क्लोज़िंग फिल्स कभी नहीं) और इसे दिखाया गया है null / —; टाइमलाइन CLOSE इवेंट्स में कोई P&L क्लेम नहीं होता। एक वैध लेकिन अनट्रैक्ड एड्रेस रिटर्न करता है tracked: false एक नोट के साथ; एक अमान्य एड्रेस रिटर्न करता है ok: false, error: "invalid_address" (HTTP 400)। HL-लीडरबोर्ड लेबल डिस्कवरी पर HL की अपनी विंडो स्टैंडिंग है, हमारे द्वारा गणना नहीं की गई।

GET /flows

आवश्यक: प्रो

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 }
  },
 रोटेशन्स डिटेक्टेड: [
 4h विंडो में ETH से BTC की ओर कैपिटल रोटेशन,
 सभी विंडोज़ में SOL एक्यूमुलेशन स्थिर
  ]
}

प्रो प्लान आवश्यक। फ्लो वैल्यूज़ प्रति टाइम विंडो USD नेट इनफ्लो (पॉजिटिव) या आउटफ्लो (नेगेटिव) हैं।

GET /whale-events

आवश्यक: ट्रेडर प्रो

ट्रैक किए गए वॉलेट्स और ऑन-चेन एड्रेसेज़ के भीतर निर्दिष्ट लुक-बैक विंडो में डिटेक्ट किए गए महत्वपूर्ण व्हेल पोजीशन परिवर्तन — ओपन्स, क्लोज़ेज़, और दिशा फ्लिप्स — रिटर्न करता है।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
सिंबलवैकल्पिक	स्ट्रिंग	एसेट द्वारा फ़िल्टर करें। सभी मॉनिटर किए गए एसेट्स के लिए छोड़ दें।
महत्ववैकल्पिक	स्ट्रिंग	इवेंट महत्व द्वारा फ़िल्टर करें: `high`, `medium`, या `all`। डिफ़ॉल्ट: `all`
घंटेवैकल्पिक	इंटीजर	घंटों में लुक-बैक विंडो। डिफ़ॉल्ट: `24`

उदाहरण प्रतिक्रिया

JSON

{
 सिंबल: BTC,
 सारांश: {
 लॉन्ग की ओर फ्लिप्स: 3,
 शॉर्ट की ओर फ्लिप्स: 1,
 नए ओपन्स: 7,
 क्लोज़ेज़: 2
  },
 इवेंट्स: [
    {
 प्रकार: फ्लिप_लॉन्ग,
 वॉलेट: 0xWhale...a4f2,
 दिशा: लॉन्ग,
 साइज_यूएसडी: 4200000,
 समय: 1710938400
    }
  ]
}

ट्रेडर प्लान: केवल summary ऑब्जेक्ट रिटर्न करता है। प्रो प्लान: पूर्ण events फीड वॉलेट आइडेंटिफायर्स, साइज़ और टाइमस्टैम्प्स के साथ।

GET /regimes/history

आवश्यक: प्रो

किसी दिए गए एसेट के लिए ऐतिहासिक शासन वर्गीकरण डेटा लौटाता है। इसका उपयोग यह बैकटेस्ट करने के लिए करें कि विशिष्ट शासन प्रकार ऐतिहासिक रूप से कैसा प्रदर्शन करते हैं, प्रत्येक शासन प्रकार आमतौर पर कितने समय तक चलता है, और समय के साथ शासन परिवर्तन कैसे होते हैं।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
symbolवैकल्पिक	स्ट्रिंग	एसेट सिंबल। डिफॉल्ट: `BTC`
regimeवैकल्पिक	स्ट्रिंग	किसी विशिष्ट शासन प्रकार पर फ़िल्टर करें, जैसे `late_cycle_divergence`। सभी शासनों के लिए छोड़ दें।
daysवैकल्पिक	इंटीजर	दिनों में लुक-बैक विंडो। डिफॉल्ट: `30`। अधिकतम: `365`

उदाहरण प्रतिक्रिया

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 योजना आवश्यक है। के साथ संयोजित करें /analysis ऐतिहासिक शासन प्रदर्शन डेटा के विरुद्ध रणनीति धारणाओं को मान्य करने के लिए।

GET /exchange-health

उपलब्ध है: Free Trader Pro

सभी निगरानी वाले एक्सचेंजों के लिए रीयल-टाइम स्वास्थ्य स्थिति लौटाता है, जिसमें प्रति-एक्सचेंज विलंबता, त्रुटि दरें और डेटा स्थिरता संकेतक शामिल हैं। कोई प्रमाणीकरण आवश्यक नहीं है — सार्वजनिक रूप से सुलभ एंडपॉइंट।

उदाहरण प्रतिक्रिया

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

आवश्यक है: Trader Pro

डेरिवेटिव्स सेंटीमेंट, व्हेल गतिविधि, अस्थिरता और सोशल सिग्नल्स से गणना की गई रीयल-टाइम फियर & ग्रीड इंडेक्स (0-100) लौटाता है। ट्रेंड विश्लेषण के लिए घटक विवरण और 24-घंटे का इतिहास शामिल है।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
symbolवैकल्पिक	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 से जुड़ते हैं। किसी भी चार्ट पर हमारे सिग्नल्स को ओवरले करने के लिए Pine Script को TradingView में कॉपी-पेस्ट करें।

उदाहरण प्रतिक्रिया

JSON

{
 "webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
 "webhook_secret": "tvs_a1b2c3...",
 "pine_scripts": {
 "composite_indicator": "// Smart Money Composite v1
//@version=5
indicator(...)...",
 व्हेल_एक्टिविटी: // व्हेल एक्टिविटी ओवरले v1
...,
 फंडिंग_डैशबोर्ड: // फंडिंग रेट + LSR डैशबोर्ड v1
...
  }
}

POST /tradingview/webhook

उपलब्ध: ट्रेडर प्रो

ट्रेडिंगव्यू अलर्ट प्राप्त करता है, इसे /confirm, और पुष्टिकरण वापस भेजता है। ट्रेडिंगव्यू कस्टम हेडर्स नहीं भेज सकता, इसलिए अपने वेबहुक को JSON बॉडी में शामिल करके प्रमाणित करें secret (यह एंडपॉइंट 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	केली और स्मार्ट-स्टॉप गणना के लिए 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

आवश्यकता: ट्रेडर प्रो

आपकी कॉन्फ़िगर की गई वॉचलिस्ट में सभी सिम्बल्स के लिए कन्फर्मेशन स्टेटस स्नैपशॉट और प्रमुख रिस्क मेट्रिक्स लौटाता है। प्रत्येक सिम्बल के लिए अलग से कॉल किए बिना मल्टी-एसेट ओवरव्यू प्रदान करता है। /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"
    }
  ]
}

रियल-टाइम स्ट्रीमिंग (लाइव स्वैप्स)

हमारे स्वयं के BSC और Avalanche नोड्स से रियल-टाइम में डिटेक्ट किए गए $500 या अधिक के DEX स्वैप्स को स्ट्रीम करें। दो ट्रांसपोर्ट उपलब्ध हैं: फ्री/ब्राउज़र क्लाइंट्स के लिए एक पब्लिक सर्वर-सेंट इवेंट्स (SSE) स्ट्रीम, और पेड टायर्स के लिए एक लो-लेटेंसी वेबसॉकेट फायरहोज़। इवेंट्स ब्लॉक में शामिल होने के कुछ सेकंड के भीतर ब्रॉडकास्ट किए जाते हैं।

पब्लिक SSE स्ट्रीम (फ्री)

उपलब्ध: फ्री ट्रेडर प्रो

GET /v1/stream/public-swaps

कोई प्रमाणीकरण आवश्यक नहीं। सभी मॉडर्न ब्राउज़र्स में नेटिव EventSource सपोर्ट। सर्वर इवेंट्स और पीरियडिक हार्टबीट्स भेजता है swap कनेक्शन को एक्टिव रखने के लिए।

JavaScript (ब्राउज़र)

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

WebSocket फायरहोस (भुगतान आवश्यक)

आवश्यकताएँ: ट्रेडर प्रो

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

प्रमाणीकरण (अनुशंसित): अपनी लंबी अवधि वाली कुंजी को URL में कभी न डालें — यह प्रॉक्सी द्वारा लॉग की जाती है और ब्राउज़र इतिहास में सहेजी जाती है। इसके बजाय अपनी कुंजी को POST करें /v1/ws/ticket सुरक्षित X-API-Key हेडर का उपयोग करके, फिर प्राप्त एकल-उपयोग वाले ticket (लगभग 60 सेकंड के लिए वैध, एक बार प्रयुक्त) के साथ सॉकेट खोलें। सर्वर-साइड क्लाइंट जो हेडर सेट कर सकते हैं, वे सीधे हैंडशेक पर X-API-Key पास कर सकते हैं। फ्री-टियर कुंजियों को एक 402 payment_required प्रतिक्रिया मिलती है। एक hello फ्रेम कनेक्ट होने पर आपके टियर और प्रसारण सीमा के साथ भेजा जाता है।

JavaScript (ब्राउज़र)

// 1. अपनी कुंजी को एक अल्पकालिक टिकट के लिए एक्सचेंज करें (कुंजी हेडर में रहती है)
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
  method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. एकल-उपयोग वाले टिकट के साथ सॉकेट खोलें
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
  const swap = JSON.parse(e.data);
  if (swap.type === "swap") console.log(swap);
};

WebSocket प्रमाणीकरण (टिकट)

कारण: अपनी API कुंजी को WebSocket URL में कभी न डालें — क्वेरी स्ट्रिंग्स प्रॉक्सी, लोड बैलेंसर द्वारा लॉग की जाती हैं और ब्राउज़र इतिहास में सहेजी जाती हैं। इसके बजाय, अपनी कुंजी को एक अल्पकालिक, एकल-उपयोग वाले टिकट के लिए एक सामान्य प्रमाणित POST के माध्यम से एक्सचेंज करें, फिर उस टिकट के साथ कनेक्ट करें।

प्रवाह: POST करें /v1/ws/ticket अपने X-API-Key हेडर के साथ → प्राप्त करें { "ticket": "…", "expires_in": 60 }. फिर खोलें wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>टिकट है एकल-उपयोग और समाप्त होता है ~60 सेकंडसर्वर-साइड क्लाइंट जो अनुरोध हेडर सेट कर सकते हैं, उसके बजाय पास कर सकते हैं X-API-Key सीधे WebSocket हैंडशेक पर — कोई टिकट की आवश्यकता नहीं।

POST /v1/ws/ticket

आवश्यकता है: ट्रेडर प्रो

एक प्रमाणित WebSocket हैंडशेक के लिए एक बार का टिकट जारी करता है। इसके साथ प्रमाणीकरण करें X-API-Key हेडर (आपकी कुंजी अनुरोध हेडर को कभी नहीं छोड़ती)। लौटाया गया टिकट एक बार भुनाया जा सकता है /v1/ws/live-swaps इसके समाप्त होने से पहले।

cURL

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

उदाहरण प्रतिक्रिया

JSON

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

प्रतिक्रिया फ़ील्ड्स

फ़ील्ड	प्रकार	विवरण
ticket	स्ट्रिंग	एकल-उपयोग टोकन जो जोड़ा जाता है `?ticket=` WebSocket URL पर। एक बार भुनाया जाता है, फिर अमान्य हो जाता है।
expires_in	संख्या	टिकट के समाप्त होने तक सेकंड (~60)। प्रत्येक कनेक्शन प्रयास के लिए एक नया टिकट जारी करें।

नोट: पुराना ?key= क्वेरी-पैराम प्रमाणीकरण है अब स्वीकार नहीं किया जाता WebSocket एंडपॉइंट्स पर सुरक्षा कारणों से। एक टिकट (ब्राउज़र क्लाइंट) या X-API-Key हैंडशेक हेडर (सर्वर-साइड क्लाइंट) का उपयोग करें।

REST स्नैपशॉट

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

रोलिंग बफर से अंतिम N प्रसारित स्वैप्स लौटाता है। स्ट्रीम कनेक्शन खुलने से पहले डैशबोर्ड पर पहले पेंट के लिए उपयोगी। यह भी उपलब्ध है: /v1/live-swaps/status ब्रॉडकास्टर स्टैट्स के लिए।

इवेंट स्कीमा

फ़ील्ड	प्रकार	विवरण
chain	स्ट्रिंग	`bsc` या `avalanche`
dex	स्ट्रिंग	राउटर नाम (जैसे `pancakeswap_v2`, `traderjoe`) या `unknown_dex`
swapper	स्ट्रिंग	वॉलेट का पूरा 0x पता जिसने स्वैप किया
swapper_short	स्ट्रिंग	प्रदर्शन के लिए संक्षिप्त रूप (जैसे `0xb300…028d`)
swapper_url	स्ट्रिंग	चेन के ब्लॉक एक्सप्लोरर पर स्वैपर का सीधा लिंक
tx_hash	स्ट्रिंग	लेन-देन हैश
explorer_url	स्ट्रिंग	BscScan / Snowtrace पर लेन-देन का सीधा लिंक
token_in	स्ट्रिंग	बेचे गए टोकन का प्रतीक (जैसे `USDT`)
token_out	स्ट्रिंग	खरीदे गए टोकन का प्रतीक
amount_usd	संख्या	स्वैप का USD मूल्य (न्यूनतम: $500)
pair	स्ट्रिंग	फॉर्मेटेड पेयर लेबल (जैसे `USDT → USDC`)
block	संख्या	ब्लॉक नंबर जहां स्वैप माइन किया गया
timestamp	संख्या	यूनिक्स युग सेकंड
significance	स्ट्रिंग	`low` / `medium` / `high` / `critical` USD आकार के आधार पर
seq	संख्या	मोनोटोनिक प्रसारण अनुक्रम संख्या — गैप डिटेक्शन के लिए उपयोग करें

POST /alerts/conditions

आवश्यकता है: प्रो

कस्टम अलर्ट नियम बनाएं जो तब ट्रिगर होते हैं जब एक निर्दिष्ट मीट्रिक एक थ्रेशोल्ड को पार करता है। अलर्ट वेबहुक, ईमेल, या डैशबोर्ड नोटिफिकेशन फीड के माध्यम से वितरित किए जाते हैं, आपकी प्राथमिकताओं के आधार पर।

GET /v1/alerts/conditions

आपके द्वारा कॉन्फ़िगर किए गए सभी अलर्ट स्थितियों की सूची उनके आईडी, परिभाषाओं और वर्तमान स्थिति के साथ लौटाता है।

DELETE /v1/alerts/conditions/{id}

एक अलर्ट स्थिति को उसके आईडी द्वारा स्थायी रूप से हटाता है।

GET /v1/alerts/history

हाल के अलर्ट ट्रिगर इवेंट्स को टाइमस्टैम्प्स, मेल खाने वाली स्थितियों और ट्रिगर समय पर मीट्रिक मूल्य के साथ लौटाता है।

अलर्ट बनाएं — अनुरोध बॉडी

फ़ील्ड	प्रकार	विवरण
nameआवश्यक	string	इस अलर्ट के लिए मानव-पठनीय लेबल (अधिकतम 64 अक्षर)
metricrequired	string	मॉनिटर करने के लिए मीट्रिक। नीचे दी गई उपलब्ध मीट्रिक्स की तालिका देखें।
symboloptional	string	एसेट संदर्भ। प्रतीक-स्कोप्ड मीट्रिक्स के लिए आवश्यक है जैसे `funding_rate`.
operatorrequired	string	तुलना ऑपरेटर: `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdrequired	float	मीट्रिक के विरुद्ध तुलना करने के लिए संख्यात्मक मान
deliveryoptional	string	डिलीवरी चैनल, उदाहरण के लिए `telegram` (default) या `webhook`
cooldown_minutesoptional	integer	री-ट्रिगर के बीच न्यूनतम मिनट (डिफ़ॉल्ट 60)

मान्य मीट्रिक्स और ऑपरेटर्स की लाइव सूची द्वारा लौटाई जाती है GET /v1/alerts/conditions as available_metrics and available_operators.

उपलब्ध मीट्रिक्स

मीट्रिक	विवरण
funding_rate	प्रतीक के लिए वर्तमान फंडिंग रेट (दशमलव के रूप में)
global_lsr	प्रतीक के लिए वैश्विक लॉन्ग/शॉर्ट अनुपात
long_pct	प्रतीक के लिए नेट लॉन्ग खातों का प्रतिशत
top_trader_lsr	टॉप-ट्रेडर लॉन्ग/शॉर्ट अनुपात प्रतीक के लिए
taker_ratio	टेकर बाय/सेल अनुपात प्रतीक के लिए
mvrv	मार्केट वैल्यू टू रियलाइज्ड वैल्यू अनुपात (BTC/ETH)
sopr	स्पेंट आउटपुट प्रॉफिट रेशियो (BTC/ETH)
exchange_net_flow	ऑन-चेन एक्सचेंज नेट-फ्लो सिग्नल
accumulation	ऑन-चेन एक्यूमुलेशन सिग्नल
whale_long_pct	ट्रैक किए गए व्हेल वॉलेट्स का प्रतिशत जो प्रतीक के लिए लॉन्ग पोजीशन रखते हैं
whale_n_wallets	प्रतीक में पोजीशन वाले ट्रैक किए गए व्हेल वॉलेट्स की संख्या
composite_long	लॉन्ग दिशा में क्वेरी किए गए प्रतीक के लिए कंपोजिट स्कोर
composite_short	शॉर्ट दिशा में क्वेरी किए गए प्रतीक के लिए कंपोजिट स्कोर
funding_spread	प्रतीक के लिए क्रॉस-वेन्यू फंडिंग स्प्रेड

POST — उदाहरण बॉडी

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

GET /kelly

Requires: Pro

कैली क्राइटेरियन पोजीशन साइज़िंग सिफारिशें लौटाता है जो दिए गए प्रतीक, कॉन्फिडेंस लेवल और दिशा के लिए ऐतिहासिक सिग्नल प्रदर्शन के अनुसार कैलिब्रेट की गई हैं। ओवर-लेवरेजिंग से बचने के लिए पोजीशन साइज़ को अनुभवजन्य जीत दरों पर आधारित करता है।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
symbolrequired	string	एसेट प्रतीक: `BTC`, `ETH`, या `SOL`
confidenceoptional	string	मॉडल करने के लिए सिग्नल कॉन्फिडेंस लेवल: `HIGH`, `MEDIUM`, या `LOW`. डिफ़ॉल्ट: `HIGH`
directionoptional	string	ट्रेड दिशा: `long` या `short`. डिफ़ॉल्ट: `long`
account_sizeoptional	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

उपलब्ध: Free Trader Pro

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

उपलब्ध: Free Trader Pro प्रमाणीकरण आवश्यक नहीं

साइट-वाइड ईमानदार प्रदर्शन आँकड़े स्रोतित 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": "distinct confirm calls, 24h resolved outcomes",
 "winrate_by_symbol": {
 "BTC": { "win_rate": 0.68, "n": 22 },
 "ETH": { "win_rate": 0.55, "n": 18 },
 "SOL": { "win_rate": 0.60, "n": 8 }
  },
 "forward_holdout": {
 "win_rate": 0.59,
 "high_win_rate": 0.70,
 "high_n": 10,
 "is_distinct_from_insample": false
  }
}

इन-सैंपल चेतावनी। इस प्रतिक्रिया के सभी आँकड़े उसी अवधि से गणना किए गए हैं जिसका उपयोग स्कोरर को ट्यून करने के लिए किया गया था। forward_holdout object एकमात्र संख्या है जो उस डेटा पर अर्जित की गई है जिसे स्कोरर ने कभी नहीं देखा — समय के साथ इसे बढ़ते हुए देखें। पूर्ण मेथोडोलॉजी और इन-सैंपल / फॉरवर्ड-टेस्ट सीमा के लिए calibration.html देखें।

GET /v1/signals/performance

उपलब्ध: Free Trader Pro प्रमाणीकरण आवश्यक नहीं

कई रिज़ॉल्यूशन होराइज़न (4h, 12h, 24h, 72h) पर संकेत परिणाम ट्रैकिंग। प्रति होराइज़न हिट दर, कुल संकेत गणना और संकेत प्रकार के अनुसार विवरण लौटाता है।

पैरामीटर्स

पैरामीटर	प्रकार	विवरण
daysवैकल्पिक	integer	दिनों में पिछड़ा हुआ विंडो। डिफ़ॉल्ट: `30`
signal_typeवैकल्पिक	string	प्रकार द्वारा फ़िल्टर करें, जैसे `smart_money_confirm` or `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 }
  },
 प्रकार विवरण: {
 smart_money_confirm: { गिनती: 35, hit_rate_24h: 0.61 },
 regime_flip: { गिनती: 13, hit_rate_24h: 0.47 }
  }
}

GET /v1/signals/recent

उपलब्ध: Free Trader Pro प्रमाणीकरण आवश्यक नहीं

सभी निगरानी किए गए प्रतीकों में हाल ही में प्रकाशित 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

उपलब्ध: Free Trader Pro प्रमाणीकरण आवश्यक नहीं

संख्यात्मक 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

आवश्यक: Free Trader Pro

प्रमाणित उपयोगकर्ता की स्वयं की 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 लागू होता है।

शैडो गेट

आवश्यकता: मुफ्त ट्रेडर प्रो

एक अपरिवर्तनीय, केवल-जोड़ने योग्य व्यक्तिगत निर्णय लेजर। अपने ट्रेड निर्णयों को उन्हें निष्पादित करने से पहले या बाद में सबमिट करें; सिस्टम स्मार्ट मनी इंजन के खिलाफ एक कन्फर्म स्कोर की गणना करता है और एक स्थायी पंक्ति जोड़ता है। इसका उपयोग एक ईमानदार, टाइमस्टैम्प्ड ट्रैक रिकॉर्ड बनाने के लिए करें कि एपीआई का सिग्नल आपके अपने प्रविष्टियों के साथ कितनी अच्छी तरह संरेखित हुआ - वैश्विक जीत-दर पूल से पूरी तरह स्वतंत्र। फ्री और ट्रेडर टियर प्रतिक्रियाओं में साक्ष्य फील्ड्स हटा दिए जाते हैं; प्रो पूर्ण विवरण देता है। फ्री टियर डेटा पर एक टियर विलंब लागू होता है।

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,
 हल किया गया: False
}

टियर नोट। फ्री और ट्रेडर प्रतिक्रियाएं सबूत फील्ड्स को छोड़ देती हैं। factors / adjustments प्रो पूरी पुष्टि ब्रेकडाउन लौटाता है। फ्री के लिए एक टियर विलंब लागू होता है — पंक्ति तुरंत लिखी जाती है लेकिन पुष्टि स्कोर 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}"

आईडी द्वारा एकल निर्णय, जिसमें प्रो टियर के लिए पूर्ण पुष्टि साक्ष्य शामिल है। फ्री और ट्रेडर टियर प्रतिक्रियाओं में factors और adjustments हटा दिया गया। रिटर्न 403 अगर निर्णय किसी अलग एपीआई कुंजी से संबंधित है।

उदाहरण प्रतिक्रिया (प्रो)

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"

किसी निर्णय के परिणाम को मैन्युअली रूप से हल करें। ट्रेड बंद करने के बाद लेजर पंक्ति में अंतिम परिणाम दर्ज करने के लिए इसे कॉल करें। एक बार हल हो जाने पर, पंक्ति अपरिवर्तनीय होती है और इसे फिर से बदला नहीं जा सकता।

अनुरोध बॉडी

फील्ड	प्रकार	विवरण
outcomerequired	string	ट्रेड परिणाम: `win` या `loss`
exit_priceoptional	float	ट्रेड के लिए निकास मूल्य। संदर्भ के लिए संग्रहीत; यदि प्रदान किया गया हो तो P&L % की गणना के लिए उपयोग किया जाता है।
pnl_pctoptional	float	पोजीशन आकार के प्रतिशत के रूप में प्राप्त 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	गुम या अमान्य एपीआई कुंजी
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 स्ट्रैटेजी में Smart Money कन्फर्मेशन जोड़ने के लिए 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 # API एरर पर फेल ओपन

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

 if conf["confidence"] not in ["HIGH", "MEDIUM"]:
 print(f"Skipping {symbol} {side} — insufficient confidence.")
 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 स्टेटस पेज रियल-टाइम हेल्थ इंफो के लिए, या हमारा कॉन्टैक्ट फॉर्म.