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:

  1. 1Tạo tài khoản miễn phí, sau đó mở bảng điều khiển.
  2. 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.
  3. 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

  1. 1Cài đặt các thư viện: pip install ccxt requests.
  2. 2Xuất key của bạn: export SMA_API_KEY="sm_your_key_here".
  3. 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/confirm như một cổng kiểm tra ngữ cảnh cuối cùng.
  4. 4Chỉ đặt lệnh perpetuals bằng CCXT khi hành động là CONFIRM, định cỡ bằng size_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.

bybit_confirm.py
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:

200 OK · application/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 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.