Посібник з інтеграції
Підтвердження входів у боті для ф’ючерсів Binance
Додайте остаточну перевірку ринкового контексту до вашого бота для ф’ючерсів Binance USDⓈ-M: підтвердьте напрямок за потоками китів та позиціями на деривативах, а потім визначте розмір замовлення за запропонованим множником.
Для кого це
Розробники, які запускають бота для перпетуальних ф’ючерсів Binance USDⓈ-M і хочуть мати незалежний шар підтвердження перед кожним входом. Smart Money API — це підтримка прийняття рішень, а ваш бот зберігає повний контроль над розміщенням замовлень і управлінням ризиками.
Передумови
- Python 3.9+ з
pip install ccxt requests(CCXT підтримує ф’ючерси Binance USDⓈ-M). - API-ключі Binance futures з дозволом на торгівлю (спочатку протестуйте на testnet).
- Ключ Smart Money API (безкоштовний тариф включає BTC).
Отримайте ваш API-ключ
Кожен запит автентифікується за допомогою X-API-Key заголовка. Щоб отримати ключ:
- 1Створіть безкоштовний обліковий запис, потім відкрийте ваш панель керування.
- 2Скопіюйте API-ключ, який відображається в розділі Доступ до API. Безкоштовний тариф включає BTC з обмеженням 100 запитів/день — достатньо для повного тестування цього посібника.
- 3Потрібно більше символів або вищі ліміти? Порівняйте тарифи на сторінці цін.
Зберігайте ключ у секреті — зберігайте його у змінній оточення, ніколи не додавайте його до системи контролю версій.
Налаштування
- 1Залиште вашу поточну логіку входу, яка генерує сигнал на покупку/продаж.
- 2Експортуйте ваш ключ:
export SMA_API_KEY="sm_your_key_here". - 3Перед кожним входом викличте
/v1/confirmз символом та напрямком. - 4Відкривайте ф’ючерсну позицію лише за умови
CONFIRM, масштабуючи номінал наsize_mult.
Робочий приклад
Цей бот підтверджує покупку або продаж за допомогою GET /v1/confirm?symbol=BTC&direction=long і відкриває позицію на ф’ючерсах Binance USDⓈ-M лише коли дія є 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)
Очікувана відповідь
Успішний виклик /v1/confirm повертає 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
Ринковий контекст не підтримує цю угоду. Утримайтеся та перевірте наступний сигнал.
Готові будувати?
Отримайте безкоштовний ключ і зробіть перший запит на підтвердження менш ніж за хвилину.
Не є фінансовою порадою. Торгівля криптовалютою пов’язана з ризиками.