Przewodnik integracji

Potwierdź wejścia w bocie Binance Futures

Dodaj końcową bramę kontekstu rynkowego do swojego bota Binance USDⓈ-M futures: potwierdź kierunek przepływem wielorybów i pozycjonowaniem instrumentów pochodnych, a następnie dostosuj wielkość zamówienia za pomocą sugerowanego mnożnika.

Dla kogo jest to przeznaczone

Deweloperzy prowadzący bota Binance USDⓈ-M perpetual futures, którzy chcą niezależnej warstwy potwierdzenia przed każdym wejściem. Smart Money API to wsparcie decyzyjne — Twój bot zachowuje pełną kontrolę nad składaniem zleceń i zarządzaniem ryzykiem.

Wymagania wstępne

  • Python 3.9+ z pip install ccxt requests (CCXT obejmuje Binance USDⓈ-M futures).
  • Klucze API Binance futures z uprawnieniami do handlu (najpierw przetestuj na testnecie).
  • Klucz API Smart Money API (darmowy poziom obejmuje BTC).

Uzyskaj swój klucz API

Każde żądanie jest uwierzytelniane za pomocą X-API-Key nagłówka. Aby uzyskać klucz:

  1. 1Utwórz darmowe konto, a następnie otwórz swój panel sterowania.
  2. 2Skopiuj klucz API wyświetlony pod Dostęp do API. Darmowy poziom obejmuje BTC przy 20 żądaniach/dzień — wystarczy, aby przetestować ten przewodnik od początku do końca.
  3. 3Potrzebujesz więcej symboli lub wyższych limitów? Porównaj poziomy na stronie cenowej.

Zachowaj klucz w tajemnicy — przechowuj go w zmiennej środowiskowej, nigdy nie dodawaj go do kontroli źródła.

Konfiguracja

  1. 1Zachowaj swoją istniejącą logikę wejścia, która generuje sygnał kandydata na długi/krótki.
  2. 2Eksportuj swój klucz: export SMA_API_KEY="sm_your_key_here".
  3. 3Przed każdym wejściem wywołaj /v1/confirm z symbolem i kierunkiem.
  4. 4Otwórz pozycję futures tylko na CONFIRM, skalując wartość nominalną przez size_mult.

Przykład działania

Ten bot potwierdza długi lub krótki za pomocą GET /v1/confirm?symbol=BTC&direction=long i otwiera pozycję Binance USDⓈ-M futures tylko wtedy, gdy działanie jest 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)

Oczekiwana odpowiedź

Udane wywołanie /v1/confirm zwraca JSON w następujący sposób:

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 zakres od -1.0 (silne przeciw) do +1.0 (silne potwierdzenie), confidence jest WYSOKI lub ŚREDNI, a size_mult jest sugerowanym mnożnikiem wielkości 0.0–1.5. Zobacz pełne odniesienie do pola w dokumentacji API.

Jak działać na podstawie odpowiedzi

POTWIERDŹ

Kontekst wspiera Twój kierunek. Otwórz pozycję zgodnie z własnymi zasadami ryzyka, skalując wartość nominalną przez size_mult.

ZMNIEJSZ

Sygnały są mieszane. Rozważ mniejszą pozycję i ściślejszą dźwignię lub poczekaj na potwierdzenie.

POMIŃ

Kontekst rynkowy nie wspiera tej transakcji. Odczekaj i sprawdź ponownie przy następnym sygnale.

Gotowy do budowania?

Zdobądź darmowy klucz i wykonaj swoje pierwsze potwierdzenie w mniej niż minutę.

To nie jest porada finansowa. Handel kryptowalutami wiąże się z ryzykiem.