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

Επιβεβαιώστε τις εισόδους σε ένα bot Binance Futures

Προσθέστε μια τελική πύλη πλαισίου αγοράς στο bot Binance USDⓈ-M futures σας: επιβεβαιώστε την κατεύθυνση με τη ροή φαλαινοειδών και την θέση παραγώγων, στη συνέχεια προσδιορίστε το μέγεθος της παραγγελίας με τον προτεινόμενο πολλαπλασιαστή.

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

Προγραμματιστές που εκτελούν ένα bot Binance USDⓈ-M perpetual futures και θέλουν μια ανεξάρτητη στρώση επιβεβαίωσης πριν από κάθε είσοδο. Το Smart Money API είναι υποστήριξη απόφασης — το bot σας διατηρεί τον πλήρη έλεγχο της τοποθέτησης παραγγελιών και της διαχείρισης κινδύνου.

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

  • Python 3.9+ με pip install ccxt requests (Το CCXT καλύπτει τα Binance USDⓈ-M futures).
  • Κλειδιά API Binance futures με άδεια συναλλαγής (δοκιμάστε πρώτα στο testnet).
  • Ένα κλειδί API Smart Money API (η δωρεάν σειρά καλύπτει το BTC).

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

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

  1. 1Δημιουργήστε έναν δωρεάν λογαριασμό, στη συνέχεια ανοίξτε το ταμπλό σας.
  2. 2Αντιγράψτε το κλειδί API που εμφανίζεται κάτω από Πρόσβαση API. Η δωρεάν σειρά καλύπτει το BTC με 20 αιτήματα/ημέρα — αρκετά για να δοκιμάσετε αυτόν τον οδηγό από την αρχή μέχρι το τέλος.
  3. 3Χρειάζεστε περισσότερα σύμβολα ή υψηλότερα όρια; Συγκρίνετε τις σειρές στην σελίδα τιμολόγησης.

Κρατήστε το κλειδί μυστικό — αποθηκεύστε το σε μια μεταβλητή περιβάλλοντος, ποτέ μην το αποθηκεύετε στον έλεγχο πηγαίου κώδικα.

Αποκτήστε δωρεάν κλειδί API

Ρύθμιση

  1. 1Διατηρήστε την υπάρχουσα λογική εισόδου σας που παράγει ένα υποψήφιο σήμα αγοράς/πώλησης.
  2. 2Εξάγετε το κλειδί σας: export SMA_API_KEY="sm_your_key_here".
  3. 3Πριν από κάθε είσοδο, καλέστε /v1/confirm με το σύμβολο και την κατεύθυνση.
  4. 4Ανοίξτε την θέση futures μόνο όταν CONFIRM, προσαρμόζοντας την ονομαστική αξία με size_mult.

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

Αυτό το bot επιβεβαιώνει μια αγορά ή πώληση με GET /v1/confirm?symbol=BTC&direction=long και ανοίγει μια θέση Binance USDⓈ-M futures μόνο όταν η ενέργεια είναι CONFIRM.

binance_futures_bot.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]
SMA_BASE = "https://api.smartmoneyapi.com"

binance = ccxt.binance({
    "apiKey": os.environ["BINANCE_KEY"],
    "secret": os.environ["BINANCE_SECRET"],
    "options": {"defaultType": "future"},   # USDⓈ-M futures
})

def confirm(symbol: str, direction: str) -> dict:
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "binance-fut"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

def maybe_enter(symbol: str, direction: str, base_qty: float):
    sig = confirm(symbol, direction)
    print(sig["symbol"], direction, "->", sig["action"], sig["confidence"])

    if sig["action"] != "CONFIRM":
        print("Not confirmed -> no entry")   # REDUCE or SKIP
        return

    qty = round(base_qty * sig["size_mult"], 3)   # size by multiplier
    side = "buy" if direction == "long" else "sell"
    # binance.create_order("BTC/USDT", "market", side, qty)
    print(f"Would open {direction} {qty} BTC/USDT (futures)")

if __name__ == "__main__":
    # your strategy decided it wants a long here
    maybe_enter("BTC", "long", base_qty=0.02)

Αναμενόμενη απάντηση

Μια επιτυχημένη κλήση στο /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.

ΜΕΙΩΣΗ

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

ΠΑΡΑΛΕΙΨΗ

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

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

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

Αποκτήστε δωρεάν κλειδί API Διαβάστε τα έγγραφα Δείτε τις τιμές

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