इंटीग्रेशन गाइड

CCXT के साथ Smart Money API का उपयोग करें

CCXT के साथ लाइव मार्केट डेटा पढ़ें, Smart Money API से पूछें कि क्या व्हेल फ्लो और डेरिवेटिव्स पोजीशनिंग आपकी दिशा की पुष्टि करते हैं, फिर अपनी पसंद के एक्सचेंज पर ऑर्डर दें।

यह किसके लिए है

Python डेवलपर्स जो एक्सचेंज-अज्ञेय बॉट्स बना रहे हैं CCXT जो प्रत्येक ऑर्डर से पहले एक स्वतंत्र मार्केट-संदर्भ जांच चाहते हैं। Smart Money API निर्णय समर्थन है — यह आपके लिए ऑर्डर नहीं देता; CCXT निष्पादन का नियंत्रण बनाए रखता है।

पूर्वापेक्षाएँ

  • Python 3.9+ के साथ pip install ccxt requests.
  • CCXT के लिए एक्सचेंज API कुंजियाँ कॉन्फ़िगर की गई हों (परीक्षण के लिए रीड-ओनली ठीक है)।
  • एक Smart Money API कुंजी (फ्री टियर BTC को कवर करता है)।

अपनी API कुंजी प्राप्त करें

प्रत्येक अनुरोध प्रमाणीकरण करता है X-API-Key हेडर के साथ। कुंजी प्राप्त करने के लिए:

  1. 1एक मुफ्त खाता बनाएं, फिर अपना डैशबोर्ड.
  2. 2के तहत दिखाए गए API कुंजी को कॉपी करें API एक्सेस. मुफ्त टियर BTC को 100 अनुरोध/दिन पर कवर करता है — इस गाइड को अंत तक टेस्ट करने के लिए पर्याप्त।
  3. 3अधिक प्रतीक या उच्च सीमा चाहिए? टियर्स की तुलना करें मूल्य निर्धारण पृष्ठ.

कुंजी को गुप्त रखें — इसे एक पर्यावरण चर में स्टोर करें, स्रोत नियंत्रण में कभी भी कमिट न करें।

सेटअप

  1. 1लाइब्रेरीज़ इंस्टॉल करें: pip install ccxt requests.
  2. 2अपनी कुंजी एक्सपोर्ट करें: export SMA_API_KEY="sm_your_key_here".
  3. 3अपनी रणनीति को CCXT मार्केट डेटा से एक उम्मीदवार दिशा तय करने दें, फिर कॉल करें /v1/confirm अंतिम संदर्भ गेट के रूप में।
  4. 4ऑर्डर केवल तभी दें जब कार्रवाई हो CONFIRM, आकार निर्धारित करके size_mult.

कार्यशील उदाहरण

यह स्क्रिप्ट CCXT के साथ एक टिकर पढ़ती है, एक संभावित दिशा निकालती है, और फिर कॉल करती है GET /v1/confirm?symbol=BTC&direction=long ऑर्डर देने का निर्णय लेने से पहले।

ccxt_confirm.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]            # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"

exchange = ccxt.binance()                       # any CCXT exchange

def confirm(symbol: str, direction: str) -> dict:
    """Ask Smart Money API for market-context confirmation."""
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "ccxt-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT")
direction = "long" if ticker["percentage"] and ticker["percentage"] > 0 else "short"

# 2. Confirm with Smart Money API before acting
sig = confirm("BTC", direction)
print(sig["action"], sig["confidence"], "size_mult", sig["size_mult"])

# 3. Act on the recommendation (CCXT executes; the API only advises)
if sig["action"] == "CONFIRM":
    base_qty = 0.01
    qty = base_qty * sig["size_mult"]          # scale by suggested multiplier
    # exchange.create_order("BTC/USDT", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT")
elif sig["action"] == "REDUCE":
    print("Context is mixed -> trade smaller or wait for a cleaner setup")
else:  # SKIP
    print("Context does not support this trade -> stand aside")

अपेक्षित प्रतिक्रिया

एक सफल कॉल /v1/confirm इस तरह JSON लौटाता है:

200 OK · application/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",
    "LSR favors longs: 1.42",
    "Whales: 67% long consensus",
    "MVRV above 1.0 — on-chain bullish"
  ]
}

composite -1.0 (मजबूत विरोध) से +1.0 (मजबूत पुष्टि) तक होता है, confidence HIGH या MEDIUM है, और size_mult 0.0–1.5 का सुझाव दिया गया आकार गुणक है। पूर्ण फ़ील्ड संदर्भ देखें API डॉक्स में.

प्रतिक्रिया पर कैसे कार्य करें

पुष्टि करें

संदर्भ आपकी दिशा का समर्थन करता है। अपने स्वयं के प्रवेश और जोखिम नियमों के साथ आगे बढ़ें, वैकल्पिक रूप से आकार को स्केल करके size_mult.

कम करें

संकेत मिश्रित हैं। एक छोटी स्थिति, सख्त स्टॉप, या एक साफ सेटअप के लिए प्रतीक्षा करने पर विचार करें।

छोड़ें

बाजार संदर्भ इस ट्रेड का समर्थन नहीं करता है। अलग रहें और अगले उम्मीदवार पर फिर से जांच करें।

बनाने के लिए तैयार हैं?

एक मुफ्त कुंजी प्राप्त करें और एक मिनट से कम समय में अपनी पहली पुष्टि कॉल करें।

वित्तीय सलाह नहीं। क्रिप्टो ट्रेडिंग में जोखिम शामिल है।