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