Посібник з інтеграції
Використовуйте Smart Money API разом з CCXT
Отримуйте актуальні ринкові дані за допомогою CCXT, запитуйте Smart Money API, чи підтверджують потік китів та позиції на деривативах ваш напрямок, а потім розміщуйте замовлення на вибраній біржі.
Для кого це
Розробники на Python, які створюють ботів, незалежних від бірж, на CCXT які хочуть отримати незалежну перевірку ринкового контексту перед кожним замовленням. Smart Money API — це підтримка прийняття рішень; воно не розміщує замовлення за вас; CCXT залишається під контролем виконання.
Передумови
- Python 3.9+ з
pip install ccxt requests. - API-ключами біржі, налаштованими для CCXT (достатньо режиму лише для читання для тестування).
- Ключ Smart Money API (безкоштовний тариф включає BTC).
Отримайте ваш API-ключ
Кожен запит автентифікується за допомогою X-API-Key заголовка. Щоб отримати ключ:
- 1Створіть безкоштовний обліковий запис, потім відкрийте ваш панель керування.
- 2Скопіюйте API-ключ, показаний у розділі Доступ до API. Безкоштовний тариф включає BTC з обмеженням 100 запитів/день — достатньо для тестування цього посібника від початку до кінця.
- 3Потрібно більше символів або вищі ліміти? Порівняйте тарифи на сторінці цін.
Зберігайте ключ у секреті — зберігайте його у змінній оточення, ніколи не додавайте його до системи контролю версій.
Налаштування
- 1Встановіть бібліотеки:
pip install ccxt requests. - 2Експортуйте ваш ключ:
export SMA_API_KEY="sm_your_key_here". - 3Нехай ваша стратегія визначає кандидатський напрямок з ринкових даних CCXT, потім викличте
/v1/confirmяк фінальну перевірку контексту. - 4Розмістіть замовлення за допомогою CCXT лише тоді, коли дія
CONFIRM, розмір заsize_mult.
Робочий приклад
Цей скрипт читає тикер за допомогою 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.binance() # any CCXT exchange
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": "ccxt-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/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", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT")
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
Ринковий контекст не підтримує цю угоду. Утримайтеся та перевірте наступного кандидата.
Готові будувати?
Отримайте безкоштовний ключ і зробіть ваш перший підтверджуючий виклик менш ніж за хвилину.
Не є фінансовою порадою. Торгівля криптовалютою пов’язана з ризиками.