集成指南

与CCXT一起使用Smart Money API

使用CCXT读取实时市场数据,询问Smart Money API鲸鱼流向和衍生品持仓是否确认您的方向,然后在您选择的交易所下单。

适用人群

在CCXT上构建交易所无关机器人的Python开发者 CCXT 希望在下单前进行独立市场背景检查的人。Smart Money API是决策支持工具——它不会为您下单;CCXT仍掌握执行权。

先决条件

  • Python 3.9+ 并 pip install ccxt requests.
  • 为CCXT配置的交易所API密钥(只读即可用于测试)。
  • 一个Smart Money API密钥(免费层涵盖BTC)。

获取您的API密钥

每个请求都通过 X-API-Key 标头进行身份验证。要获取密钥:

  1. 1创建一个免费账户,然后打开您的 仪表板.
  2. 2复制在 API访问下显示的API密钥。免费层级涵盖每天20次BTC请求——足以从头到尾测试本指南。
  3. 3需要更多交易对或更高限制?请在 定价页面.

比较各层级。

获取免费API密钥

  1. 1设置 pip install ccxt requests.
  2. 2安装库: export SMA_API_KEY="sm_your_key_here".
  3. 3导出您的密钥: /v1/confirm 让您的策略根据CCXT市场数据决定候选方向,然后调用
  4. 4作为最终的上下文门。 CONFIRM仅在动作为时使用CCXT下单,并根据 size_mult.

工作示例

该脚本使用CCXT读取行情,推导出候选方向,然后调用 GET /v1/confirm?symbol=BTC&direction=long 在决定是否下单之前。

ccxt_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.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:

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 范围从-1.0(强烈反对)到+1.0(强烈确认), confidence 为HIGH或MEDIUM,且 size_mult 是0.0–1.5的建议规模乘数。完整字段参考请参阅 API文档.

如何根据响应采取行动

确认

市场背景支持您的方向。按照您自己的入场和风险规则进行,可选择按比例调整规模。 size_mult.

减少

信号混杂。考虑缩小仓位、收紧止损或等待更清晰的入场机会。

跳过

市场背景不支持此交易。暂时观望,并在下一个候选机会时重新检查。

准备好构建了吗?

获取免费密钥,并在不到一分钟内进行首次确认调用。

非财务建议。加密货币交易涉及风险。