Hướng dẫn tích hợp
Xác nhận lệnh perpetuals Bybit với Smart Money API
Đọc dữ liệu thị trường swap Bybit trực tiếp bằng CCXT, hỏi Smart Money API xem dòng tiền cá mập và vị thế phái sinh có xác nhận hướng giao dịch của bạn không, sau đó đặt lệnh perpetuals — định cỡ bằng hệ số nhân được đề xuất.
Đối tượng sử dụng
Nhà phát triển Python đang vận hành bot USDT-perpetuals trên Bybit bằng CCXT muốn kiểm tra ngữ cảnh thị trường độc lập trước mỗi lệnh. Smart Money API là công cụ hỗ trợ quyết định — nó không đặt lệnh thay bạn; mã CCXT của bạn vẫn kiểm soát việc thực thi và rủi ro.
Điều kiện tiên quyết
- Python 3.9+ với
pip install ccxt requests. - API keys Bybit đã cấu hình cho CCXT (chỉ đọc là đủ để kiểm tra).
- Một Smart Money API key (gói miễn phí hỗ trợ BTC).
Lấy API key của bạn
Mỗi yêu cầu được xác thực bằng X-API-Key header. Để lấy key:
- 1Tạo tài khoản miễn phí, sau đó mở bảng điều khiển.
- 2Sao chép API key hiển thị dưới mục Truy cập API. Gói miễn phí hỗ trợ BTC với 20 yêu cầu/ngày — đủ để kiểm tra hướng dẫn này từ đầu đến cuối.
- 3Cần thêm mã hoặc giới hạn cao hơn? So sánh các gói trên trang giá.
Giữ key bí mật — lưu trữ trong biến môi trường, không bao giờ commit vào hệ thống kiểm soát mã nguồn.
Thiết lập
- 1Cài đặt các thư viện:
pip install ccxt requests. - 2Xuất key của bạn:
export SMA_API_KEY="sm_your_key_here". - 3Mở swaps Bybit bằng CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), để chiến lược của bạn chọn hướng giao dịch tiềm năng, sau đó gọi/v1/confirmnhư một cổng kiểm tra ngữ cảnh cuối cùng. - 4Chỉ đặt lệnh perpetuals bằng CCXT khi hành động là
CONFIRM, định cỡ bằngsize_mult.
Ví dụ minh họa
Script này đọc ticker swap Bybit bằng CCXT, xác định hướng giao dịch tiềm năng, sau đó gọi GET /v1/confirm?symbol=BTC&direction=long trước khi quyết định có đặt lệnh hay không.
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")
Phản hồi mong đợi
Một lệnh gọi thành công tới /v1/confirm trả về JSON như sau:
{
"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 dao động từ -1.0 (phản đối mạnh) đến +1.0 (xác nhận mạnh), confidence là HIGH hoặc MEDIUM, và size_mult là hệ số nhân kích thước đề xuất 0.0–1.5. Xem tài liệu đầy đủ về các trường trong tài liệu API.
Cách hành động dựa trên phản hồi
CONFIRM
Ngữ cảnh hỗ trợ hướng giao dịch của bạn. Tiến hành với quy tắc vào lệnh và quản lý rủi ro của bạn, có thể định cỡ bằng size_mult.
REDUCE
Tín hiệu hỗn hợp. Cân nhắc vị thế nhỏ hơn, điểm dừng chặt hơn hoặc chờ thiết lập rõ ràng hơn.
SKIP
Ngữ cảnh thị trường không hỗ trợ giao dịch này. Đứng ngoài và kiểm tra lại ở ứng viên tiếp theo.
Sẵn sàng xây dựng?
Lấy key miễn phí và thực hiện lệnh xác nhận đầu tiên trong chưa đầy một phút.
Không phải lời khuyên tài chính. Giao dịch crypto có rủi ro.