Hướng dẫn tích hợp
Sử dụng Smart Money API cùng với CCXT
Đọc dữ liệu thị trường 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 của bạn không, sau đó đặt lệnh trên sàn giao dịch bạn chọn.
Đối tượng sử dụng
Nhà phát triển Python xây dựng bot độc lập với sàn giao dịch trên 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à hỗ trợ quyết định — nó không đặt lệnh thay bạn; CCXT vẫn kiểm soát việc thực thi.
Điều kiện tiên quyết
- Python 3.9+ với
pip install ccxt requests. - API keys của sàn giao dịch được cấu hình cho CCXT (chỉ đọc là đủ để kiểm tra).
- Một Smart Money API key (gói miễn phí bao gồm BTC).
Lấy API key của bạn
Mỗi yêu cầu 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í bao gồm 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ờ đưa vào hệ thống kiểm soát 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". - 3Để chiến lược của bạn quyết định hướng khả thi từ dữ liệu thị trường CCXT, sau đó gọi
/v1/confirmnhư một cổng ngữ cảnh cuối cùng. - 4Đặt lệnh với CCXT chỉ khi hành động là
CONFIRM, định cỡ theosize_mult.
Ví dụ minh họa
Script này đọc ticker bằng CCXT, xác định hướng khả thi, 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.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")
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à CAO hoặc TRUNG BÌNH, 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
XÁC NHẬN
Ngữ cảnh hỗ trợ hướng của bạn. Tiến hành với quy tắc vào lệnh và rủi ro của bạn, tùy chọn điều chỉnh kích thước theo size_mult.
GIẢM
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.
BỎ QUA
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.