מדריך אינטגרציה

אשר כניסות לנצחיים של Bybit עם Smart Money API

קרא נתוני שוק החלף של Bybit בזמן אמת עם CCXT, שאל את Smart Money API האם זרימת הלווייתנים ומיקומי הנגזרים מאשרים את הכיוון שלך, ואז בצע את הכניסה לנצחיים — בגודל המוצע על ידי המכפיל.

למי זה מיועד

מפתחי Python שמפעילים בוט לנצחיים של USDT ב-Bybit על CCXT שרוצים בדיקת הקשר שוק עצמאית לפני כל כניסה. Smart Money API הוא תמיכה בהחלטה — הוא לא מבצע הזמנות עבורך; הקוד שלך ב-CCXT נשאר בשליטה על הביצוע והסיכון.

דרישות מוקדמות

  • Python 3.9+ עם pip install ccxt requests.
  • מפתחות API של Bybit מוגדרים ל-CCXT (קריאה בלבד מספיקה לבדיקה).
  • מפתח API של Smart Money API (הרמה החינמית מכסה את BTC).

קבל את מפתח ה-API שלך

כל בקשה מאומתת עם ה- X-API-Key header. כדי לקבל מפתח:

  1. 1צור חשבון חינמי, ואז פתח את ה- לוח מחוונים.
  2. 2העתק את מפתח ה-API המוצג תחת גישת API. הרמה החינמית מכסה את BTC ב-20 בקשות/יום — מספיק כדי לבדוק את המדריך הזה מקצה לקצה.
  3. 3צריך סמלים נוספים או גבולות גבוהים יותר? השווה רמות ב- דף תמחור.

שמור על המפתח בסוד — אחסן אותו במשתנה סביבה, לעולם אל תכניס אותו לבקרת מקור.

התקנה

  1. 1התקן את הספריות: pip install ccxt requests.
  2. 2ייצא את המפתח שלך: export SMA_API_KEY="sm_your_key_here".
  3. 3פתח החלפות של Bybit עם CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), תן לאסטרטגיה שלך לבחור כיוון מועמד, ואז התקשר ל- /v1/confirm כשער הקשר סופי.
  4. 4בצע את הכניסה לנצחיים עם CCXT רק כאשר הפעולה היא CONFIRM, גודל לפי size_mult.

דוגמה עובדת

סקריפט זה קורא מחירון החלף של Bybit עם CCXT, מפיק כיוון מועמד, ואז מתקשר ל- 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

הקשר השוק לא תומך במסחר זה. הישאר בצד ובדוק שוב במועמד הבא.

מוכן לבנות?

קח מפתח חינמי ובצע את שיחת האישור הראשונה שלך תוך פחות מדקה.

לא ייעוץ פיננסי. מסחר בקריפטו כרוך בסיכון.