Οδηγός Ενσωμάτωσης

Επιβεβαιώστε εισόδους Bybit perpetuals με Smart Money API

Διαβάστε ζωντανά δεδομένα αγοράς swap του Bybit με CCXT, ρωτήστε το Smart Money API εάν η ροή φαλαινοειδών και το positioning παραγώγων επιβεβαιώνουν την κατεύθυνσή σας, μετά τοποθετήστε την είσοδο perpetuals — μεγέθυνση σύμφωνα με τον προτεινόμενο πολλαπλασιαστή.

Για ποιον είναι αυτό

Προγραμματιστές Python που τρέχουν ένα bot Bybit USDT-perpetuals στο CCXT που θέλουν έναν ανεξάρτητο έλεγχο πλαισίου αγοράς πριν από κάθε είσοδο. Το Smart Money API είναι υποστήριξη απόφασης — δεν τοποθετεί εντολές για εσάς· ο κώδικας CCXT σας παραμένει υπεύθυνος για την εκτέλεση και τον κίνδυνο.

Προαπαιτούμενα

  • Python 3.9+ με pip install ccxt requests.
  • Κλειδιά API του Bybit ρυθμισμένα για CCXT (αρκεί το read-only για δοκιμή).
  • Ένα κλειδί Smart Money API (το δωρεάν επίπεδο καλύπτει το BTC).

Αποκτήστε το κλειδί API σας

Κάθε αίτημα πιστοποιείται με την X-API-Key κεφαλίδα. Για να αποκτήσετε ένα κλειδί:

  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Ανοίξτε swaps του Bybit με CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), αφήστε τη στρατηγική σας να επιλέξει μια υποψήφια κατεύθυνση, μετά καλέστε /v1/confirm ως τελικό πλαίσιο ελέγχου.
  4. 4Τοποθετήστε την είσοδο perpetuals με CCXT μόνο όταν η ενέργεια είναι CONFIRM, μεγέθυνση κατά size_mult.

Ενεργό παράδειγμα

Αυτό το script διαβάζει ένα ticker swap του 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

Τα σήματα είναι μικτά. Σκεφτείτε μια μικρότερη θέση, πιο σφιχτά stop, ή αναμονή για ένα καθαρότερο setup.

SKIP

Το πλαίσιο αγοράς δεν υποστηρίζει αυτή τη συναλλαγή. Μείνετε εκτός και ελέγξτε ξανά στο επόμενο υποψήφιο.

Έτοιμοι να δημιουργήσετε;

Πάρτε ένα δωρεάν κλειδί και κάντε την πρώτη σας κλήση επιβεβαίωσης σε λιγότερο από ένα λεπτό.

Δεν είναι οικονομική συμβουλή. Η συναλλαγή κρυπτονομισμάτων περιλαμβάνει κίνδυνο.