ইন্টিগ্রেশন গাইড

Smart Money API দিয়ে Bybit পার্পেচুয়াল এন্ট্রি কনফার্ম করুন

CCXT দিয়ে Bybit সোয়াপ মার্কেট ডেটা রিয়েল-টাইমে পড়ুন, Smart Money API কে জিজ্ঞাস করুন হোয়েল ফ্লো এবং ডেরিভেটিভস পজিশনিং আপনার ডাইরেকশন কনফার্ম করছে কিনা, তারপর পার্পেচুয়াল এন্ট্রি করুন — সাজেস্টেড মাল্টিপ্লায়ার দিয়ে সাইজ করুন।

এটি কার জন্য

Python ডেভেলপাররা যারা Bybit USDT-পার্পেচুয়ালস বট চালাচ্ছেন CCXT যারা প্রতিটি এন্ট্রির আগে একটি স্বাধীন মার্কেট-কনটেক্স্ট চেক চান। Smart Money API হলো ডিসিশন সাপোর্ট — এটি আপনার জন্য অর্ডার দেয় না; আপনার CCXT কোড এক্সিকিউশন এবং রিস্ক কন্ট্রোলে থাকে।

প্রাক-প্রয়োজনীয়তা

  • Python 3.9+ সহ pip install ccxt requests.
  • Bybit API কী CCXT এর জন্য কনফিগার করা (টেস্ট করার জন্য রিড-অনলি যথেষ্ট)।
  • একটি Smart Money API কী (ফ্রি টিয়ার BTC কভার করে)।

আপনার API কী পান

প্রতিটি রিকোয়েস্ট অথেন্টিকেট করে X-API-Key হেডার দিয়ে। কী পেতে:

  1. 1একটি বিনামূল্যে অ্যাকাউন্ট তৈরি করুন, তারপর আপনার ড্যাশবোর্ড খুলুন.
  2. 2API কীটি কপি করুন যা নিচে দেখানো হয়েছে API অ্যাক্সেস। বিনামূল্যের টিয়ারটি BTC কে 20 অনুরোধ/দিনে কভার করে — এই গাইডটি শেষ থেকে শেষ পরীক্ষা করার জন্য যথেষ্ট।
  3. 3আরও সিম্বল বা উচ্চতর সীমা প্রয়োজন? টিয়ারগুলি তুলনা করুন মূল্য নির্ধারণ পৃষ্ঠায়.

কীটি গোপন রাখুন — এটিকে একটি পরিবেশ পরিবর্তনশীলে সংরক্ষণ করুন, কখনও সোর্স কন্ট্রোলে কমিট করবেন না।

সেটআপ

  1. 1লাইব্রেরি ইনস্টল করুন: pip install ccxt requests.
  2. 2আপনার কী এক্সপোর্ট করুন: export SMA_API_KEY="sm_your_key_here".
  3. 3CCXT দিয়ে Bybit সোয়াপ খুলুন (ccxt.bybit({"options":{"defaultType":"swap"}})), আপনার স্ট্র্যাটেজি দিয়ে একটি ক্যান্ডিডেট ডিরেকশন বাছুন, তারপর কল করুন /v1/confirm একটি ফাইনাল কনটেক্সট গেট হিসেবে।
  4. 4CCXT দিয়ে পার্পেচুয়ালস এন্ট্রি শুধুমাত্র তখনই দিন যখন অ্যাকশনটি CONFIRM, sizing by size_mult.

কাজের উদাহরণ

এই স্ক্রিপ্টটি CCXT ব্যবহার করে Bybit সোয়াপ টিকার পড়ে, একটি প্রার্থী দিক নির্ধারণ করে, তারপর কল করে GET /v1/confirm?symbol=BTC&direction=long এন্ট্রি দেওয়ার সিদ্ধান্ত নেওয়ার আগে।

bybit_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.bybit({"options": {"defaultType": "swap"}})   # Bybit perpetuals

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": "bybit-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read Bybit swap market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT: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:USDT", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT:USDT perp")
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 ডক্সে.

প্রতিক্রিয়ায় কীভাবে কাজ করবেন

CONFIRM

কনটেক্স্ট আপনার দিক সমর্থন করে। আপনার নিজের এন্ট্রি এবং রিস্ক নিয়ম অনুসরণ করুন, ঐচ্ছিকভাবে সাইজ স্কেলিং করে size_mult.

REDUCE

সিগন্যাল মিশ্রিত। একটি ছোট পজিশন, টাইটার স্টপ, অথবা একটি ক্লিনার সেটআপের জন্য অপেক্ষা করুন।

SKIP

মার্কেট কনটেক্স্ট এই ট্রেড সমর্থন করে না। পাশে থাকুন এবং পরবর্তী প্রার্থী পুনরায় চেক করুন।

বিল্ড করতে প্রস্তুত?

একটি বিনামূল্যের কী নিন এবং এক মিনিটের মধ্যে আপনার প্রথম কনফার্মেশন কল করুন।

আর্থিক পরামর্শ নয়। ক্রিপ্টো ট্রেডিংয়ে ঝুঁকি রয়েছে।