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:
- 1Utwórz darmowe konto, a następnie otwórz swój panel sterowania.
- 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.
- 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
- 1Zachowaj swoją istniejącą logikę wejścia, która generuje sygnał kandydata na długi/krótki.
- 2Eksportuj swój klucz:
export SMA_API_KEY="sm_your_key_here". - 3Przed każdym wejściem wywołaj
/v1/confirmz symbolem i kierunkiem. - 4Otwórz pozycję futures tylko na
CONFIRM, skalując wartość nominalną przezsize_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.
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:
{
"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.