API参考

Smart Money API

一个专业级智能API，将衍生品数据、链上指标和巨鲸钱包活动汇总为单一置信度评分，供您的交易机器人使用。

当前API版本： v1。基础URL： https://api.smartmoneyapi.com/v1

设计原则

四个理念塑造了该API的每个端点和返回的每个评分。它们也是其承诺与不承诺的诚实边界。

策略优先，非信号优先。 这不是一个买卖信号源。您提供策略和入场点；API告诉您周围的市场结构——衍生品持仓、资金费率、未平仓合约、清算、链上资金流和巨鲸共识——是否与您已想进行的交易一致。

置信度评分，非二元预测。 每个答案都带有一个分级 confidence （高/中/低）和一个 composite 从-1.0到+1.0的数值。没有保证，也没有预言机调用——您会得到一个校准过的一致性读数及其背后的原因，从而可以根据信念按比例调整仓位。

决策支持，非执行建议。 API返回一个确认/减少/跳过建议和一个仓位乘数，供您的逻辑执行。它从不下单，此处内容均非财务建议。您仍需对风险、仓位和执行负责。

动态指标，非固定保证。 胜率、市场状态统计和准确率数据基于滚动样本计算，并随市场变化而变动。我们如实公布这些数据，包括表现平庸时。将每个指标视为当前观察结果，而非对未来承诺。

该API的适用对象

该API专为 加密货币机器人、算法和AI代理开发者 设计，他们已有一个多空信号——来自技术分析策略、机器学习模型、Freqtrade流水线、TradingView警报或LLM代理——并希望在投入资金前获得快速的预交易 确认/减少/跳过 决策。

典型流程：您的策略触发 “做多BTC” → 您调用 GET /v1/confirm?symbol=BTC&direction=long → 您确认、减少或跳过入场，并根据 size_mult调整仓位大小。一次调用，单一低延迟JSON响应，无需额外基础设施。

它不是独立的信号生成器、图表产品或交易场所。如果您没有自己的信号作为门槛，请先查看性能页面了解评分的历史表现，再将其接入实盘机器人。

获取访问权限

1 — 注册。 在 signup 创建免费账户（邮箱/密码或谷歌登录）。免费层级无需信用卡。

2 — 打开仪表盘。 您的仪表盘显示API密钥、当前套餐和每日配额的使用情况。

3 — 复制API密钥。 密钥前缀为 sm_。将其作为 X-API-Key 请求头传递（参见身份验证）。随时可在定价页面提高限额并解锁更多交易对和端点。

规范、SDK与实用指南

快速集成所需的一切资源，无论您自行编写代码还是交由编程代理处理。

资源	功能说明
实用指南	常见集成场景的即用代码模板——包括入场确认、Freqtrade信号过滤、乘数仓位计算、处理402/429错误，以及对接编程代理的完整流程。
OpenAPI规范	所有端点的机器可读OpenAPI定义。可导入Postman/Insomnia、生成客户端代码或输入LLM。访问 `github.com/tashiardit/smartmoneyapi-docs`.
Python客户端	官方Python客户端库位于 `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	面向LLM的API纯文本摘要。可提供给Claude、Codex或Cursor使用（参见编程代理).

2分钟快速入门

第一步——基础URL 所有端点均位于：

基础URL
https://api.smartmoneyapi.com

第二步——获取API密钥 免费注册（无需信用卡）并从控制面板复制密钥。每次请求时通过 X-API-Key 请求头传递。

第三步——首次调用 将以下代码粘贴至终端，并将 sm_your_key 替换为控制面板中的密钥：

cURL

curl -H "X-API-Key: sm_your_key" "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

预期响应：

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": ["全平台资金费率为正", "鲸鱼群体：67%做多共识"]
}

当 confidence 为 HIGH 或 MEDIUM 且 action 为 CONFIRM时，按 size_mult调整仓位规模。这即是完整的集成闭环。参阅响应字段获取完整字段说明。

身份验证

所有请求需通过 X-API-Key HTTP请求头传递API密钥。

HTTP请求头
X-API-Key: sm_your_api_key_here

注册后可从控制面板获取API密钥。请妥善保管密钥——切勿在客户端代码或公共仓库中暴露。

WebSocket验证方式不同 切勿将密钥放入WebSocket URL。实时流使用短期单次有效的 接入凭证：将密钥POST至 /v1/ws/ticket 并携带 X-API-Key 请求头，随后使用返回的凭证连接。详见 WebSocket验证（接入凭证）.

谷歌登录（Firebase认证）

用户可通过Firebase认证使用谷歌账户登录。客户端成功登录后，将Firebase ID令牌兑换为关联的API会话。系统会自动将谷歌身份与API密钥体系同步。

可用计划：免费版交易者版专业版

POST /auth/google

请求体

字段	类型	说明
id_token必填	字符串	客户端谷歌登录后获取的Firebase ID令牌

响应示例

JSON

{
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}

用户档案数据（邮箱、订阅计划、使用记录、偏好设置）存储于Firestore并与谷歌账户关联。可通过控制面板隐私设置随时申请数据导出或账户删除。

速率限制

计划	调用/日	突发限制	数据延迟
免费版	50	2次/分钟	60秒
交易者版	1,000	20次/分钟	实时
专业版	5,000	60/分钟	实时
企业版	100,000	400/分钟	实时

每个响应都包含速率限制头部信息： X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

基础URL

https://api.smartmoneyapi.com/v1

以下所有端点均基于此基础URL。所有响应均为JSON格式，且 Content-Type: application/json.

错误处理

错误使用标准HTTP状态码及统一JSON结构体。请始终根据状态码而非响应文本进行分支处理。最常见三种错误：

状态	代码	含义与处理方式
401	unauthorized	API密钥缺失或无效。请检查 `X-API-Key` 请求头是否存在且正确。
402	payment_required	该接口或交易对需要比当前密钥更高权限的套餐（例如免费密钥调用WebSocket数据流）。升级套餐或切换至公共端点。
429	rate_limit_exceeded	达到每日或瞬时调用限制。请等待 `X-RateLimit-Reset`后重试；切勿频繁请求。

所有错误返回统一格式：

JSON示例
{
 "error": "rate_limit_exceeded",
 "message": "每日100次调用限额已用尽。将于UTC时间00:00重置。",
 "status": 429
}

完整状态码列表（400/403/500/503等）请参阅错误代码文档。稳健的集成方案应将5xx和429视为临时错误（退避重试），401/402/403视为终止错误（需修复密钥或套餐）。

安全最佳实践

密钥应通过请求头传递，切勿置于URL中。 始终将 X-API-Key 作为HTTP头部传递。查询字符串中的密钥（?key=）会被代理服务器、负载均衡器和浏览器历史记录——旧版 ?key= 鉴权方式因此原因已不再支持WebSocket端点。

密钥应保存在服务端。 切勿将API密钥嵌入客户端JavaScript、移动应用包或公开仓库。应从环境变量或密钥管理器加载。若密钥泄露，请立即轮换。

定期轮换密钥。 从控制面板定期重新生成密钥，若怀疑泄露应立即操作。新密钥签发后旧密钥即刻失效。

浏览器端WebSocket使用票据。 需在浏览器中获取实时流时，请将密钥兑换为一次性票据而非直接使用原始密钥——参见 WebSocket鉴权（票据）.

与编程代理/LLM配合使用

正在使用Claude Code、Codex、Cursor或其他LLM编程代理？您可一次性提供代理所需全部API对接资料。我们发布了两份机器可读文档：

资源	URL
LLM摘要	`https://smartmoneyapi.com/llms.txt`
OpenAPI规范	`github.com/tashiardit/smartmoneyapi-docs`

引导编程代理查看 /llms.txt 文件（遵循 llms.txt规范）获取简明概述，再查阅OpenAPI规范了解精确的请求/响应结构。推荐使用单行指令：

提示

# 粘贴到Claude Code / Cursor / Codex中
阅读https://smartmoneyapi.com/llms.txt和OpenAPI规范
github.com/tashiardit/smartmoneyapi-docs，然后在我的机器人中添加一个预交易
检查，调用GET /v1/confirm并跳过条目
除非动作为CONFIRM。

参见 Cookbook 以获取一个编码代理的详细配方。

端点

GET /confirm

核心端点。返回给定交易方向的综合置信分数和行动建议。在进入任何仓位之前调用此端点。

覆盖范围，简单来说。 /confirm 当前评分 BTC, ETH和SOL ——这些符号有足够的历史记录来诚实地确认。衍生品筛选器单独 监控约519个衍生品市场 的资金、持仓量和清算数据，鲸鱼跟踪覆盖600多个钱包。Pro解锁完整的筛选器、导出和更广泛的市场覆盖； /confirm 随着每个市场积累可靠的记录，符号支持会扩展。

参数

参数	类型	描述
symbol必填	字符串	资产符号。其中之一： `BTC`, `ETH`, `SOL` (Trader+)
方向必填	字符串	交易方向： `long` 或 `short`
来源可选	字符串	您的信号源标签（用于分析记录）。最多32个字符。

示例请求

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

示例响应

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "direction": "long",
 "composite": 0.74,
 "confidence": "HIGH",
 "action": "CONFIRM_FULL",
 "size_mult": 1.5,
 衍生品评分: 0.81,
 链上评分: 0.68,
 鲸鱼评分: 0.73,
 X评分: 0.0,
 因素: {
 衍生品: { 评分: 0.81, 权重: 0.40, 加权: 0.324 },
 链上: { 评分: 0.68, 权重: 0.35, 加权: 0.238, 来源: CoinMetrics, 可用: True },
 鲸鱼: { 评分: 0.73, 权重: 0.25, 陈旧因素: 1.0, 加权: 0.183 }
  },
 调整: { 一致性: 0.0, 趋势: 0.0, 新闻宏观: 0.0 },
 权重: { 衍生品: 0.40, 链上: 0.35, 鲸鱼情报: 0.25 },
 覆盖范围: { 衍生品: True, 鲸鱼: True, 链上: True },
 原因: [
 所有场所的资金费率均为正,
 LSR偏向多头：1.42,
 鲸鱼：67%多头共识,
 MVRV高于1.0 — 链上看涨
  ]
}

设计透明。 每个响应都包含一个 factors 对象，显示每个部分的 评分 × 权重 = 加权 贡献，一个 adjustments 对象用于后过滤调整， weights 使用的 coverage 地图。链上部分使用 真实的免费Coin Metrics数据 （MVRV / 交易所流量 / 活跃地址）当未设置Glassnode密钥时。这是一个多因素汇合评分 — 决策支持， 并非保证的胜率.

未跟踪的符号是诚实的。 一个符号在跟踪的衍生品/鲸鱼宇宙之外会返回一个明确的 "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" 与 "unsupported":true — 从不伪造 LOW.

响应字段

字段	类型	描述
ts	整数	计算的Unix时间戳
symbol	字符串	资产符号（BTC/ETH/SOL）
direction	字符串	请求的方向（多头/空头）
composite	浮点数	汇合评分从-1.0（极端反对）到1.0（强烈确认）。非胜率。
base_composite	浮点数	应用后过滤调整前的汇合评分
confidence	字符串	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
action	字符串	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
size_mult	浮点数	建议的头寸大小乘数（例如0.0 – 1.5）
unsupported	布尔值	`true` 当符号不在覆盖范围内时（与NO_DATA配对）
deriv_score	浮点数	衍生品子评分（-1到1）
onchain_score	浮点数	链上子评分（-1到1）
whale_score	浮点数	鲸鱼共识子评分（-1到1）
x_score	浮点数	X/社交情绪子评分（-1到1）；未使用时为0
factors	对象	每部分细分： `score × weight = weighted` 衍生品 / 链上 / 鲸鱼 / X情绪（链上包括 `source`)
adjustments	对象	签名的后过滤调整（一致性、趋势、rsi_1h、新闻宏观、动量、时间_of_day、streak_decay）
weights	对象	实际用于此评估的权重集
coverage	对象	`{derivatives, whale, onchain}` — 哪些部分有真实数据
reasons	数组	评分的可读解释字符串

GET /snapshot

返回包括所有子评分、原始指标和给定符号的指标值的完整市场快照。适用于仪表板记录。

需要：交易员专业版

GET /onchain

返回原始链上指标：MVRV、SOPR、交易所净流量、实现市值比率及周期位置分类。

要求：交易员专业版

GET /v1/derivatives/*

跨交易所衍生品筛选器，覆盖500+交易对：资金费率热力图、未平仓合约排名及多空比信号检测。前10行数据公开；完整筛选器需交易员或专业版权限。端点： /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

Deribit提供的BTC和ETH期权分析（公开，无需认证）：多空比、最大痛点及按行权价划分的未平仓合约。端点： /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

现货BTC和ETF每日净流入及单只基金明细（公开）。端点： /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

历史资金费率、未平仓合约、多空比（Binance）及OHLCV数据（CoinGecko）用于回测。端点： /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

DexScreener提供的热门交易对、代币搜索及交易对详情（公开，无需认证）。端点： /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

新闻情报：政策/地缘政治/加密新闻按影响分类，附带恐慌贪婪指数（公开，无需认证）。端点： /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

返回鲸鱼钱包共识数据：多空分布、总名义敞口、前十大持仓（仅专业版）及钱包数量。

要求：交易员专业版

GET /signals

返回所有监控资产的最新HIGH/MEDIUM信号流，适用于机会扫描。

要求：专业版

GET /v1/strategies/*

基于Smart Money信号执行的自动化交易策略透明只读记录——包括 deriv40 SmartMoney跟单策略（account=9）。所有端点接受 ?account=<id> 查询参数并返回JSON。无需认证（公开记录）。

端点

GET /v1/strategies/stats?account=9 ——核心指标： total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
GET /v1/strategies/equity?account=9 ——用于图表的权益曲线： { initial_equity, curve: [{ time, equity }] }.
GET /v1/strategies/trades?account=9&limit=500 ——已平仓交易账本：数组（或 {trades:[…]}）的 symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 ——当前持仓：数组（或 {positions:[…]}）的 symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals ——策略信号类型细分（每种信号类型的数量/胜率/平均盈亏）。

过往表现不预示未来结果。数据回填覆盖约3个月周期及实时交易，标注处为扣除手续费前数据。

GET /export

下载历史信号数据CSV用于回测。参数： symbol, from （Unix时间戳）， to （Unix时间戳）。

要求：专业版

GET /health

系统健康检查。返回各数据源的新鲜度及API总体状态。无需认证。

JSON响应
{
 "status": "ok",
 "uptime_s": 1209600,
 "sources": {
 "bybit": { "lag_s": 42, "ok": true },
 "binance": { "lag_s": 38, "ok": true },
 "hyperliquid": { "lag_s": 61, "ok": true },
 "onchain": { "lag_s": 290, "ok": true }
  }
}

GET /usage

返回当前API使用统计：今日调用量、月度总量、配额限制及重置时间。

POST /webhooks

要求：专业版

注册HTTPS URL以在监控资产触发信号时接收实时签名事件推送。推送携带 X-SmartMoney-Event 请求头及HMAC-SHA256签名于 X-SmartMoney-Signature，最多重试3次（退避策略）。

请求体

字段	类型	描述
url必填	字符串	接收事件的HTTPS端点（必须以 `https://`)
events必填	数组	事件名称，如 `["HIGH","MEDIUM","VETO"]` 或 `["*"]`
symbols必填	数组	筛选的交易对，如 `["BTC","ETH"]` 或 `["*"]`
secret必填	字符串	您的签名密钥， ≥ 16字符（存储为哈希值）

验证签名

HMAC密钥为注册密钥的SHA-256十六进制摘要。用该密钥计算原始请求体的HMAC-SHA256值并与 X-SmartMoney-Signature. 参见 Webhook 实现指南.

智能分析

GET /analysis

要求：专业版

返回AI驱动的市场状态分类及信号冲突检测。分析跨信号一致性，识别衍生品、链上数据和大户活动之间的分歧，并生成包含前瞻性风险因素和时间范围建议的自然语言摘要。

参数

参数名	类型	说明
symbol必填	string	资产代码： `BTC`, `ETH`或 `SOL`

示例响应

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "周期尾声——信号分歧",
 "summary": "BTC处于牛市后期阶段，链上实力与衍生品过度扩张形成冲突。大户正在减仓而散户杠杆持仓比持续攀升。",
 "signal_conflicts": [
 "大户评分看跌而链上评分看涨",
 "资金费率创3个月新高——潜在轧空风险"
  ],
 "risk_factors": ["高企的资金费率", "未平仓合约分歧", "大户减持"],
 "recommendation": "减少多头敞口，收紧止损。避免在当前价格上方新建多头。",
 "time_horizon": "4小时–12小时"
}

需专业版计划。由于AI处理开销，此端点每次请求消耗3次API调用。

GET /liquidations

要求：交易员版专业版

返回 两个互补视图：(1) 杠杆预测 levels ——对 强平集群位置 的预估；以及(2) realized_heatmap ——从 实际执行 的强制平仓强度（价格×时间）实时聚合，数据来自交易所公开WebSocket推送： Binance、OKX、Bybit、Bitget、BitMEX。当数据流包含该币种时显示热力图（极平静市场或刚启动时可能缺失）。

参数

参数名	类型	说明
symbol可选	string	资产代码（默认 `BTC`）。实时热力图覆盖活跃交易的永续合约币种。

示例响应

JSON

{
 "symbol": "BTC",
 "cascade_risk": "高危",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // 实际强平数据——实时来自5家交易所
 "realized_heatmap": {
 "window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
 "clusters": [ { "price": 93250.0, "名义价值": 4820000.0, "笔数": 37, "dominant_side": "多头" } ],
 "by_side": { "多头": 6100000.0, "空头": 2400000.0 },
 "totals": { "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
  }
}

交易员版： cascade_risk最近距离及实际总量/方向数据 专业版： 完整预测 levels 叠加完整 realized_heatmap （矩阵结构、按价格聚类、分交易所计数）。预测数据回答"止损位分布"，实时热力图展示"实际强平情况"。

GET /liquidations/heatmap

可用权限：免费版无需认证（IP限流）

公共价格层级强平热力图。返回Coinglass风格的价×时矩阵，展示 实际执行 的强制平仓，按强平成交价分桶——实时聚合自交易所公开WebSocket推送： Binance、OKX、Bybit、Bitget、BitMEX。 clusters 数组是核心输出：按强平名义价值排序的价格区间，标注主导方向。数据依赖实时流——极冷门币种或刚重启的网关返回规范空结构及真实 note。所显示层级均为实际强平，绝无预估。

参数

参数	类型	描述
symbol可选	string	资产符号（默认 `BTC`).
window_minutes可选	int	回溯时间窗口（分钟，默认 `240`，限制在5–1440之间）。
price_buckets可选	int	价格分档数量（默认 `50`，限制在5–100之间）。

示例响应

JSON

{
 "symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
 "price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
 "price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
 "matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
 "clusters": [
    { "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
 "short_notional": 720000.0, "count": 37, "dominant_side": "long" }
  ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
 "generated_at": 1710940200, "public": true
}

重要说明： 此端点仅反映实时流捕获的数据。当标的交易清淡或流刚启动时， totals.count is 0, clusters 为空，且 note 字段会说明原因。这是已执行强平的记录—— 而非预测。如需预估“止损位在哪里”，请使用需认证的 /liquidations 端点。

GET /liquidations/onchain

要求： Trader Pro

已执行 链上DeFi借贷强平 直接从我们本地的 BSC + Avalanche全节点 捕获——独立于任何交易机器人。覆盖BSC上的Venus/Cream和Moolah，以及Avalanche上的AAVE V3/V2、Benqi、BankerJoe、Granary和Vinium。Pro层级额外返回 at_risk 仓位（依赖机器人，可能缺失）。

参数

参数	类型	描述
chain可选	string	`bsc` 或 `avax`。留空则查询所有链。
limit可选	integer	最大行数（默认100，上限500）。按最新优先排序。

示例响应

JSON

{
 "chain": "bsc", "count": 2,
 "liquidations": [
    { "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
 "debt_symbol": "DAI", "repay_usd": 426.15,
 "collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
  ],
 "summary": {
 "window_hours": 24, "enabled": true,
 "by_protocol": { "bsc:Venus": { "count": 61, repay_usd_known: 148230.55 } },
 nodes: { bsc: { reachable: True, head_block: 89173010, events_total: 61 } }
  }
}

GET /smart-stop

Requires: Trader Pro

基于当前清算热力图、波动率带和市场结构，计算智能止损水平。返回根据您的入场价格和风险承受能力校准的分级止损建议和止盈建议。

Parameters

Parameter	Type	Description
symbolrequired	string	资产代码： `BTC`, `ETH`, 或 `SOL`
directionrequired	string	持仓方向： `long` 或 `short`
entry_priceoptional	float	您的入场价格。若省略则默认为当前市场价格。
risk_pctoptional	float	最大可接受风险（账户百分比）。默认值： `2.0`

Example Response

JSON

{
 symbol: BTC,
 direction: long,
 entry_price: 96420,
 stops: {
 tight: { price: 95100, note: 低于1小时结构。最适合短线交易。 },
 recommended: { price: 93800, note: 低于94K美元的主要清算集群。标准摆动止损。 },
 wide: { price: 91200, note: 低于4小时需求区。长线交易止损。 }
  },
 avoid_zones: [
    { low: 94200, high: 94800, reason: 密集清算集群——高滑点风险 }
  ],
 take_profit_suggestions: [
    { tp1: 98500, tp2: 101000, tp3: 104200 }
  ]
}

Trader 计划： 仅返回 recommended 止损建议。 Pro 计划： 所有三个止损层级， avoid_zones，以及完整的止盈建议。

GET /funding-arb

Requires: Trader Pro

实时识别跨交易所资金费率套利机会。返回按年化收益率排名的机会，包括最优交易所对和捕获利差所需的对冲操作。

Parameters

Parameter	Type	Description
min_spreadoptional	float	最小资金费率利差（十进制）。默认值： `0.01`
symboloptional	string	筛选特定资产。留空则扫描所有支持的资产。

Example Response

JSON

{
 ts: 1710940821,
 opportunities: [
    {
 symbol: BTC,
 spread: 0.032,
 apr: 84.2,
 long_exchange: hyperliquid,
 short_exchange: bybit,
 action: 做多 HYPE / 做空 BYBIT,
 estimated_profit_8h_usd: 26.4
    }
  ]
}

Trader 计划： 仅显示排名第一的机会，无历史利差数据。 Pro 计划： 所有当前机会，附带每个交易所对的24小时利差历史。

免费公开版无需认证

无密钥公共端点返回前10名机会，带实时跨交易所筛选器，适合嵌入或快速检查。它剔除了单资产利差历史和繁重字段，并基于120秒缓存。若在新鲜度窗口内无跨交易所资金利差，则返回空 opportunities 数组并附带 note ——绝不伪造数据。

GET (no auth)

GET /v1/derivatives/funding-arb

JSON

{
 opportunities: [
    {
 symbol: OGN,
 spread_pct: 0.297667,
 annualized_apr: 325.95,
 long_exchange: bybit,
 short_exchange: hyperliquid,
 estimated_profit_per_10k: 29.77,
 risk_notes: 低点差 — 确保手续费不会侵蚀套利利润空间。
    }
  ],
 scanned_symbols: 222,
 ts: 1783268753,
 public: True,
 limited: True
}

免费，无需API密钥。仅展示前10个机会，数据限流且缓存（120秒）。实时筛选页面： funding-arb.html.

GET /smart-money/flow

需要： Trader Pro

质量加权的 鲸鱼方向指数 按币种评分 -100 （鲸鱼资金倾向做空）至 +100 （倾向做多）。基于数千个追踪的Hyperliquid鲸鱼钱包构建 —— 每个钱包按其历史胜率和盈亏加权，并随时间衰减。这是 持仓指数，非买卖信号或价格预测。 贡献钱包较少的币种会标注 thin 并如实评分。实时页面： smart-money-flow.html.

参数

参数	类型	描述
symbol可选	string	单个币种（如 `BTC`）。留空获取全部跟踪币种，按\|score\|排序。
window_hours可选	int	评分时间窗口，限制在 `1..168`。默认 `24`.

示例响应

JSON

{
 symbols: [
    {
 symbol: SPX,
 score: -90.93,
 direction: strong_short,
 n_wallets: 26,
 long_usd: 184200.0, short_usd: 2410000.0,
 quality_weighted: True,
 sample_quality: rich,
 top_contributors: [ { wallet: 0x31ca…974b, direction: short, value_usd: 5338.25, weight: 0.4948 } ]
    }
  ],
 window_hours: 24,
 quality_weighted: True,
 ts: 1783270000,
 note: 质量加权鲸鱼方向持仓指数（-100..+100）。非价格预测或买卖信号。
}

Trader计划： 前12个币种，贡献者详情隐藏。 Pro计划： 所有币种含 top_contributors。钱包权重限制在 [0.25,1.0]；盈亏为最新持仓快照的未实现估算值。

GET /v1/whales/crowding

开放给：免费无需认证 —— 匿名用户获取前10币种，Trader+获取完整列表

综合 鲸鱼持仓与拥挤度分析 按币种合并 Hyperliquid + GMX v2 + Jupiter Perps。返回总/净名义金额、方向偏差、钱包及场所计数、持仓集中度（前三份额+HHI）、加权平均杠杆、以及 强平临近区间 （距离预估强平价5%和10%内的名义金额，分多空）。此为 背景数据，非方向信号。 无法推导的字段为 null 并显示为 — —— 例如 lev_wavg/crowding_index 当无持仓带杠杆时。强平距离为隔离保证金估算值（pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), 非交易所报告的强平价。

参数

参数	类型	描述
min_notional可选	float	纳入币种的最小综合总名义金额（USD）。默认： `1000000`.

示例请求

GET（无认证）

curl "https://api.smartmoneyapi.com/v1/whales/crowding?min_notional=1000000"

示例响应

JSON

{
 ok: True, ts: 1783423500, 最小名义金额: 1000000, n_symbols: 92,
 symbols: [
    {
 symbol: BTC,
 gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
 n_whales: 414, n_venues: 3,
 venues: {
 hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
 gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
 jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
      },
 conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
 liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
 liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
 crowding_index: 0.003
    }
  ],
 caveats: [ 清算距离是隔离保证金的估计值，而非交易所报告的。 ]
}

诚实说明： skew 是 net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1)。只有实际存在的交易场所才会出现在 venues。无杠杆的头寸被排除在清算桶之外，而非假设。匿名调用者将获得按总额排名前10的symbol（带有 gated: true）；Trader+用户将获得完整列表。

GET /v1/options/gex

可用对象：免费无需认证（按IP限流）

Dealer gamma exposure (GEX) 分析 BTC & ETH，实时从公开的Deribit期权链计算（无需认证）。返回每个行权价的净dealer GEX（SpotGamma dealer-short惯例）， gamma翻转水平 （累计净GEX跨越零的行权价）， IV期限结构 （按到期日计算的ATM隐含波动率），以及一个前端到期 IV偏斜 （25Δ代理风险逆转）。GEX机制是 positive （dealer多头gamma → 波动抑制）或 negative （波动放大）。完全自包含——每次调用重新计算，无存储数据库依赖。

参数

参数	类型	描述
symbol可选	字符串	`BTC` 或 `ETH` 仅。默认： `BTC`.

示例请求

GET（无需认证）

curl "https://api.smartmoneyapi.com/v1/options/gex?symbol=BTC"

示例响应

JSON

{
 "symbol": "BTC", "available": true, "spot": 63203.0,
 "net_gex": 18240000.0, "regime": "positive",
 "gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
 "call_gex": 31200000.0, "put_gex": -12960000.0,
 "by_strike": [
    { "strike": 60000, "net_gex": -2100000.0 },
    { "strike": 65000, "net_gex": 4800000.0 }
  ],
 "term_structure": [
    { "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
    { "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
  ],
 "skew": {
 "expiry": "8JUL26", "dte": 0.76,
 "put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
 "risk_reversal": 14.35, "bias": "downside_fear"
  }
}

诚实说明： Deribit合约乘数为1（以币计量的未平仓合约）。在任何获取失败时，端点返回 available: false 空面板——从不伪造GEX。IV偏斜使用固定的±10%行权价代理25Δ（真正的25-delta需要为每个行权价求解delta）；适用于显示，记录为近似值。

GET /v1/liquidations/simulate

可用对象：免费无需认证（按IP限流）

交互式 清算级联压力测试给定一个假设的价格变动，返回估计会被清算的杠杆头寸、按价格水平/方向/交易所划分的强制交易量，以及级联深度读数。价格下跌会清算多头其清算价格位于或高于目标价；价格上涨会清算空头其清算价格位于或低于目标价。合并了两种独立方法：来自追踪的Hyperliquid鲸鱼的精确清算价格实际杠杆/入场点，加上每个交易所的统计OI带聚类（通过资金费率推断群体杠杆）。所有内容均明确标注 estimated: true ——无法获知每个账户的保证金、全仓与逐仓模式、追加保证金或自动减仓。

参数

参数	类型	描述
symbol可选	string	资产代号。默认值： `BTC`.
move_pct可选	float	假设价格变动百分比（负值=下跌，正值=上涨）。默认值： `-5`.

示例请求

GET（无需认证）

curl "https://api.smartmoneyapi.com/v1/liquidations/simulate?symbol=BTC&move_pct=-5"

示例响应

JSON

{
 "ok": true, "estimated": true, "symbol": "BTC",
 "ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
 "triggered_notional_usd": 380000000.0,
 "cascade_depth": 0.029, "cascade_bucket": "low",
 "by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
 "by_side": { "long": 380000000.0, "short": 0.0 },
 "clusters": [
    { "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
  ],
 "whale_positions_used": 272, "exchanges": 3,
 "realized_context": { "available": true, "coverage_hours": 17.8, "by_side_24h": { "long": 6100000.0, "short": 2400000.0 } },
 "methodology": { "disclaimer": "估算值——无法获知每个账户的保证金、全仓与逐仓模式、追加保证金或自动减仓。" }
}

特别说明： 所有预测数字均源自真实数据库读取；失败时不会伪造数据。若遇到未追踪的代币、过期的快照或缺失的价格，会返回 ok: true, empty: true 简明英文提示，而非虚假数据。 realized_context 是一个来自实时强制清算流的年轻且不断增长的样本，仅作为背景信息展示——它永远不会使预测变为"已实现"。

GET /v1/wallet/{addr}/profile

可用对象：免费无需认证（按IP限流）

一个跨平台的 钱包画像 完全基于实时追踪的鲸鱼头寸快照构建。对于被追踪的Hyperliquid鲸鱼，返回当前未平仓头寸、未实现盈亏/风险敞口/头寸数量的 时间序列，一份OPEN/CLOSE/FLIP 活动时间线 （通过对比连续快照重建）、解码后的HL排行榜标签，以及一个公开账本摘要。实时页面： wallet-profiler.html.

参数

参数	类型	描述
addr必填	string	钱包地址（路径参数），例如 `/v1/wallet/0x3bcae23e…/profile`.
days可选	integer	时间序列和时间线的回溯窗口。默认值： `30`.

示例请求

GET（无需认证）

curl "https://api.smartmoneyapi.com/v1/wallet/0x3bcae23e8c380dab4732e9a159c0456f12d866f3/profile?days=30"

示例响应

JSON

{
 "ok": true, "wallet": "0x3bcae23e…", "tracked": true,
 "first_seen_ts": 1782827733, "latest_snapshot_ts": 1783418468, "as_of": 1783418468,
 "hyperliquid": {
 "label": { "name": "Andre is back", "score": 74,
 "window_pnl_usd": 1307000, 胜率百分比: 71, 交易次数: 42 },
 持仓: [
      { 交易平台: Hyperliquid, 交易对: ETH, 方向: 空头,
 头寸规模: 1200.0, 入场价格: 1800.0, 未实现盈亏: 34800.0,
 杠杆倍数: 20.0, 价值（美元）: 2160000.0 }
    ],
 系列: [ { 时间戳: 1783330000, 未实现盈亏: 42000.0, 风险敞口（美元）: 18400000.0, 持仓: 5 } ],
 时间线: [ { 时间戳: 1783400000, 事件: 方向反转, 交易对: ETH,
 方向: 空头, 原方向: 多头, 价值（美元）: 2160000.0 } ],
 概要: {
 未平仓持仓: 5, 盈利中: 3, 亏损中: 2, 多头持仓: 0, 空头持仓: 5,
 总未实现盈亏: -12000.0, 总风险敞口（美元）: 21000000.0, 综合杠杆率: 19.9,
 统计窗口天数: 30, 窗口内快照数: 474,
 已实现盈亏: None, 已实现盈亏说明: 不可推导——仅能查看未平仓快照，无平仓成交记录。
    }
  }
}

重要说明： 所有展示数据均真实源自快照数据—— pnl 为Hyperliquid官方未实现市值标记， value_usd 即未平仓名义价值。 每笔完整交易的已实现盈亏数据不可用 （仅能查看未平仓快照，无平仓成交记录），故显示为 null / —；时间线中的平仓事件不包含盈亏声明。有效但未被追踪的地址将返回 tracked: false 并附说明；无效地址返回 ok: false, error: "invalid_address" （HTTP 400）。HL-leaderboard标签为Hyperliquid自身在发现时的窗口排名，非我方计算。

GET /flows

要求：专业版

返回跨资产资金流数据，展示BTC、ETH和SOL在不同时间窗口的资金轮动模式。有助于识别特定时段内资金流入或流出的资产。

示例响应

JSON

{
 时间戳: 1710940821,
 资金流: {
 BTC: { 1小时: 142000000, 4小时: 380000000, 12小时: -90000000, 24小时: 220000000 },
 ETH: { 1小时: -38000000, 4小时: -110000000, 12小时: 55000000, 24小时: -80000000 },
 SOL: { 1小时: 12000000, 4小时: 29000000, 12小时: 18000000, 24小时: 44000000 }
  },
 检测到的轮动: [
 4小时窗口内资金从ETH轮动至BTC,
 SOL在所有时间窗口均呈现资金流入
  ]
}

需专业版计划。资金流值为各时间窗口的美元净流入（正）或流出（负）。

GET /whale-events

要求：交易员版专业版

返回指定回溯窗口内追踪钱包及链上地址的大额持仓变动——包括开仓、平仓和方向反转。

参数

参数	类型	描述
交易对可选	字符串	按资产筛选。留空则返回所有监控资产。
重要性可选	字符串	按事件重要性筛选： `high`, `medium`，或 `all`。默认值： `all`
小时数可选	整数	回溯窗口小时数。默认值： `24`

示例响应

JSON

{
 交易对: BTC,
 概要: {
 转向多头: 3,
 转向空头: 1,
 新开仓: 7,
 平仓: 2
  },
 事件: [
    {
 类型: 翻多,
 钱包地址: 0xWhale...a4f2,
 方向: 多头,
 规模(美元): 4200000,
 时间戳: 1710938400
    }
  ]
}

交易者计划： 仅返回 summary 对象。 专业计划： 完整 events 包含钱包标识符、规模及时间戳的数据流。

GET /regimes/history

需求：专业版

返回指定资产的历史状态分类数据。用于回测特定状态类型的历史表现、各状态通常持续时间及状态随时间演变过程。

参数

参数名	类型	说明
symbol可选	string	资产代码。默认值： `BTC`
regime可选	string	筛选特定状态类型，例如 `late_cycle_divergence`。留空则返回所有状态。
days可选	integer	回溯天数窗口。默认值： `30`。最大值： `365`

响应示例

JSON

{
 symbol: BTC,
 current_regime: late_cycle_divergence,
 regime_summary: {
 late_cycle_divergence: { occurrences: 4, avg_duration_h: 38, avg_return_pct: -2.1 },
 accumulation: { occurrences: 6, avg_duration_h: 72, avg_return_pct: 5.4 },
 breakout: { occurrences: 3, avg_duration_h: 18, avg_return_pct: 9.2 }
  },
 transitions: [
    { from: accumulation, to: breakout, ts: 1710850000 },
    { from: breakout, to: late_cycle_divergence, ts: 1710915000 }
  ]
}

需专业版。结合 /analysis 可基于历史状态表现数据验证策略假设。

GET /exchange-health

可用版本：免费版交易者版专业版

返回所有监测交易所的实时健康状态，包括各交易所延迟、错误率及数据陈旧指标。无需认证——公开访问端点。

响应示例

JSON

{
 overall_status: ok,
 ts: 1710940821,
 exchanges: {
 bybit: { status: ok, latency_ms: 42, error_rate_1h: 0.0, last_data_age_s: 18 },
 binance: { status: ok, latency_ms: 38, error_rate_1h: 0.0, last_data_age_s: 22 },
 hyperliquid: { status: degraded, latency_ms: 310, error_rate_1h: 0.04, last_data_age_s: 95 },
 okx: { status: ok, latency_ms: 55, error_rate_1h: 0.0, last_data_age_s: 30 }
  }
}

GET /sentiment

需求：交易者版专业版

返回基于衍生品情绪、巨鲸活动、波动率及社交信号计算的实时恐惧贪婪指数(0-100)。包含成分分解与24小时历史数据用于趋势分析。

参数

参数名	类型	说明
symbol可选	string	资产符号。默认值： `BTC`

示例响应

JSON

{
 "symbol": "BTC",
 "score": 72,
 "label": "贪婪",
 "components": {
 "波动性": 65,
 "动量": 78,
 "衍生品": 70,
 "巨鲸活动": 75,
 "社交": 68
  },
 "history_24h": [
    { "ts": 1710940800, "score": 68, "label": "贪婪" },
    { "ts": 1710937200, "score": 65, "label": "贪婪" }
  ],
 "ts": 1710940821
}

竞品对标： Santiment社交交易量 + Alternative.me恐惧贪婪指数 — 整合为单一接口并附带成分指标分解。

集成方式

GET /tradingview/setup

所需条件：交易员专业版

返回您个性化的TradingView集成设置：包括Webhook URL、验证密钥，以及可直接连接Smart Money API的即用型Pine Script指标。将Pine Script复制粘贴到TradingView中，即可在任何图表上叠加我们的信号。

示例响应

JSON

{
 "webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
 "webhook_secret": "tvs_a1b2c3...",
 "pine_scripts": {
 "composite_indicator": "// Smart Money Composite v1
//@version=5
indicator(...)...",
 鲸鱼活动: // 鲸鱼活动叠加层 v1
...,
 资金费率仪表盘: // 资金费率 + LSR 仪表盘 v1
...
  }
}

POST /tradingview/webhook

可用对象：交易员专业版

接收TradingView警报，通过 /confirm并返回确认信息。由于TradingView无法发送自定义请求头，请在JSON请求体中包含您的webhook secret 进行身份验证（此端点不使用X-API-Key）。响应会封装确认信息并添加一个顶层 action 的 CONFIRMED （守护进程置信度高/中）或 VETOED.

请求体

JSON

{
 "secret": "your_webhook_secret",
 "symbol": "BTC",
 "direction": "long",
 "timeframe": "1h",
 "strategy": "EMA均线交叉",
 "price": 67500.0
}

必填项： secret, symbol, direction (long|short）。可选填： source, timeframe, strategy, price.

个性化设置

GET /preferences

要求权限：交易员专业版

返回您当前的个性化设置，包括默认交易参数、风险偏好、观察列表及通知偏好。

PUT /v1/preferences

通过发送包含以下任意字段的JSON请求体更新偏好设置。未包含字段将保留当前值。

偏好设置字段

字段	类型	说明
default_trade_size_usd	float	Kelly公式和智能止损计算的默认仓位大小（美元）
risk_tolerance	string	`conservative`, `moderate`，或 `aggressive`
default_risk_pct	float	单笔交易默认风险（账户百分比）。当 `/smart-stop` 未填写时 `risk_pct` 使用此值
watchlist	array	资产符号的有序列表，例如 `["BTC","ETH","SOL"]`
notification_email	string	接收警报的电子邮件地址
timezone	string	IANA时区字符串，例如 `America/New_York`

PUT — 示例请求体

{
 "default_trade_size_usd": 5000,
 "risk_tolerance": "moderate",
 "default_risk_pct": 1.5,
 "watchlist": ["BTC", "ETH", "SOL"]
}

GET /watchlist

要求：交易员专业版

返回您配置的关注列表中所有交易对的确认状态快照及关键风险指标。无需逐个调用即可获取多资产概览。 /confirm 分开查询每个交易对。

示例响应

JSON

{
 "ts": 1710940821,
 "watchlist": [
    {
 "symbol": "BTC",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "accumulation",
 "cascade_risk": "LOW"
    },
    {
 "symbol": "ETH",
 "confidence": "MEDIUM",
 "action": "REDUCE",
 "regime": "late_cycle_divergence",
 "cascade_risk": 高位
    },
    {
 交易对: SOL,
 置信度: 高,
 操作: 确认,
 行情阶段: 突破,
 瀑布风险: 中等
    }
  ]
}

实时流式传输（Live Swaps）

通过我们自建的BSC和Avalanche节点实时监测≥500美元的DEX交易。提供两种传输方式：面向免费/浏览器客户端的公开服务器推送事件（SSE）流，以及付费层级的低延迟WebSocket数据管道。交易事件在区块确认后数秒内广播。

公开SSE流（免费）

适用对象：免费交易员专业版

GET /v1/stream/public-swaps

无需认证。原生支持所有现代浏览器。 EventSource 服务器实时推送 swap 事件和定期心跳以保持连接活跃。

JavaScript（浏览器）

const es = new EventSource("https://api.smartmoneyapi.com/v1/stream/public-swaps");
es.addEventListener("swap", e => {
  const swap = JSON.parse(e.data);
  console.log(swap.chain, swap.pair, swap.amount_usd);
});

WebSocket Firehose (付费)

要求： Trader Pro

WSS /v1/ws/live-swaps?ticket=…

认证（推荐）： 切勿将长期有效的密钥放在URL中——它会被代理记录并保存在浏览器历史记录中。相反，请将您的密钥POST到 /v1/ws/ticket 使用安全的 X-API-Key 标头，然后使用返回的一次性 ticket （有效期约60秒，一次性使用）打开套接字。可以设置标头的服务器端客户端可以直接在握手时传递 X-API-Key 。免费层密钥会收到一个 402 payment_required 响应。连接时会发送一个 hello 帧，显示您的层级和广播阈值。

JavaScript (浏览器)

// 1. 将您的密钥交换为短期有效的票据（密钥保留在标头中）
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
  method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. 使用一次性票据打开套接字
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
  const swap = JSON.parse(e.data);
  if (swap.type === "swap") console.log(swap);
};

WebSocket 认证（票据）

原因： 切勿将您的API密钥放在WebSocket URL中——查询字符串会被代理、负载均衡器记录并保存在浏览器历史记录中。相反，请通过正常的认证POST请求将您的密钥交换为短期有效的一次性票据，然后使用该票据连接。

流程： POST到 /v1/ws/ticket 带有您的 X-API-Key 标头 → 接收 { "ticket": "…", "expires_in": 60 }。然后打开 wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. 票据为 一次性使用 且将在 ~60秒后过期。支持设置请求头的服务端客户端可直接通过 X-API-Key WebSocket握手传递——无需票据。

POST /v1/ws/ticket

所需权限：交易员专业版

生成用于认证WebSocket握手的一次性票据。通过 X-API-Key 请求头认证（您的密钥始终不会离开请求头）。返回的票据可在 /v1/ws/live-swaps 过期前兑换一次。

cURL

curl -X POST -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/ws/ticket"

响应示例

JSON

{
 "ticket": "wst_9f3c1a8e4b2d…",
 "expires_in": 60
}

响应字段

字段	类型	说明
ticket	string	需附加到WebSocket URL的 `?ticket=` 一次性令牌。兑换后即失效。
expires_in	number	票据过期剩余秒数（约60）。每次连接尝试需生成新票据。

注意： 旧版 ?key= 查询参数认证 已不再支持 出于安全考虑，WebSocket端点现仅支持票据（浏览器客户端）或 X-API-Key 握手请求头（服务端客户端）。

REST快照

GET /v1/live-swaps/recent?limit=20

返回滚动缓冲区中最近N笔广播交易。适用于仪表板在流连接建立前的首屏渲染。另提供： /v1/live-swaps/status 用于广播者统计。

事件结构

字段	类型	说明
chain	string	`bsc` 或 `avalanche`
dex	string	路由名称（如 `pancakeswap_v2`, `traderjoe`）或 `unknown_dex`
swapper	string	执行交易的完整0x地址
swapper_short	string	缩写显示形式（如 `0xb300…028d`)
swapper_url	string	区块链浏览器中该地址的直接链接
tx_hash	string	交易哈希
explorer_url	string	BscScan/Snowtrace上该交易的直接链接
token_in	string	卖出代币符号（如 `USDT`)
token_out	string	买入代币符号
amount_usd	number	交易美元价值（最低$500）
pair	string	格式化交易对标签（如 `USDT → USDC`)
block	number	交易所在区块号
timestamp	number	Unix时间戳（秒）
significance	string	`low` / `medium` / `high` / `critical` 基于美元交易量
seq	number	单调递增的广播序列号——用于检测数据间隙

POST /alerts/conditions

所需权限：专业版

创建当指定指标超过阈值时触发的自定义警报规则。警报可通过Webhook、电子邮件或仪表板通知推送交付，具体取决于您的偏好设置。

GET /v1/alerts/conditions

返回所有已配置警报条件的列表，包含ID、定义及当前状态。

DELETE /v1/alerts/conditions/{id}

根据ID永久删除警报条件。

GET /v1/alerts/history

返回近期警报触发事件，包含时间戳、匹配条件及触发时的指标值。

创建警报——请求体

字段	类型	说明
name必填	string	此警报的人类可读标签（最多64个字符）
metricrequired	string	要监控的指标。请参阅下方的可用指标表。
symboloptional	string	资产上下文。对于符号范围的指标（如 `funding_rate`.
operatorrequired	string	比较运算符： `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdrequired	float	用于与指标进行比较的数值
deliveryoptional	string	交付渠道，例如 `telegram` （默认）或 `webhook`
cooldown_minutesoptional	integer	重新触发之间的最小分钟数（默认60）

有效指标和运算符的实时列表由 GET /v1/alerts/conditions as available_metrics and available_operators.

可用指标

指标	描述
funding_rate	符号的当前资金费率（以小数表示）
global_lsr	符号的全球多空比率
long_pct	符号的净多头账户百分比
top_trader_lsr	符号的顶级交易者多空比率
taker_ratio	符号的Taker买卖比率
mvrv	市场价值与实现价值比率（BTC/ETH）
sopr	已花费产出利润比率（BTC/ETH）
exchange_net_flow	链上交易所净流量信号
accumulation	链上积累信号
whale_long_pct	跟踪的鲸鱼钱包持有符号多头仓位的百分比
whale_n_wallets	持有符号仓位的跟踪鲸鱼钱包数量
composite_long	符号在多头方向查询的综合评分
composite_short	符号在空头方向查询的综合评分
funding_spread	符号的跨平台资金费率差

POST — 示例请求体

{
 "name": "BTC资金费率飙升",
 "metric": "funding_rate",
 "symbol": "BTC",
 "operator": "gt",
 "threshold": 0.05
}

GET /kelly

要求： Pro

返回根据历史信号表现校准的凯利准则仓位大小建议，针对给定符号、置信水平和方向。基于实证胜率确定仓位大小，以避免过度杠杆。

参数

参数	类型	描述
symbolrequired	string	资产符号： `BTC`, `ETH`，或 `SOL`
confidenceoptional	string	要建模的信号置信水平： `HIGH`, `MEDIUM`，或 `LOW`。默认： `HIGH`
directionoptional	string	交易方向： `long` 或 `short`。默认： `long`
account_sizeoptional	float	用于计算的账户大小（以美元计） `suggested_size_usd`。默认： `10000`

示例响应

JSON

{
 "symbol": "BTC",
 "confidence": "HIGH",
 "direction": "long",
 "win_rate": 0.68,
 "avg_reward_risk_ratio": 2.1,
 "kelly_fraction": 0.36,
 "half_kelly": 0.18,
 "suggested_size_usd": 1800,
 "samples": 142,
 "note": "建议在实际交易中使用半凯利以考虑估计误差。"
}

需订阅Pro计划。计算基于90天滚动历史信号样本，匹配请求的交易对、置信度及方向参数。

GET /performance

可用权限： Free Trader Pro

返回API所发信号的历史准确率统计，按置信度分级呈现。有助于在投入资金前评估信号可靠性。

参数

参数名	类型	说明
symboloptional	string	按资产筛选。留空则返回全币种聚合统计数据。
daysoptional	integer	回溯天数窗口。默认值： `30`

响应示例

JSON

{
 "symbol": "BTC",
 "period_days": 30,
 "by_confidence": {
 "HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
 "MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
  }
}

统计与信号

GET /v1/stats

可用权限： Free Trader Pro 无需认证

全站真实统计数据源自 smart_money_confirm 独立调用结果。返回高/中置信度胜率、整体准确率、盈利因子及分币种明细。所有数据均为评分窗口内样本；查阅 calibration.html 了解背景及前瞻性验证方法。

响应示例

JSON

{
 "high_winrate": 0.714,
 "high_winrate_n": 14,
 "medium_winrate": 0.530,
 "medium_winrate_n": 34,
 "overall_accuracy": 0.613,
 "overall_accuracy_n": 48,
 "profit_factor": 1.77,
 "avg_win_pct": 4.2,
 "winrate_horizon": 24小时,
 胜率基准: 独立确认信号，24小时已结算结果,
 按交易对统计胜率: {
 BTC: { 胜率: 0.68, 信号数: 22 },
 ETH: { 胜率: 0.55, 信号数: 18 },
 SOL: { 胜率: 0.60, 信号数: 8 }
  },
 前瞻测试: {
 胜率: 0.59,
 高胜率区间: 0.70,
 高信号量区间: 10,
 与样本内数据差异: False
  }
}

样本内数据说明 本报告所有数据均来自评分模型训练周期。 forward_holdout 该指标是模型从未见过的真实市场数据结果——请观察其随时间变化趋势。完整方法论及样本内外分界详见 calibration.html 。

GET /v1/signals/performance

可用权限：免费版交易者版专业版无需身份验证

多时间维度信号结果追踪（4小时/12小时/24小时/72小时）。返回各维度命中率、总信号量及按信号类型分类统计。

参数说明

参数名	类型	描述
days可选	整数	回溯天数。默认值： `30`
signal_type可选	字符串	按类型筛选，例如 `smart_money_confirm` 或 `regime_flip`。留空则返回所有类型。
symbol可选	字符串	按交易对筛选，例如 `BTC`。留空则返回全品种汇总。

响应示例

JSON

{
 signal_type: smart_money_confirm,
 symbol: BTC,
 days: 30,
 total_signals: 48,
 时间范围: {
 4小时: { 命中率: 0.65, 已结算: 46 },
 12小时: { 命中率: 0.61, 已结算: 44 },
 24小时: { 命中率: 0.58, 已结算: 40 },
 72小时: { 命中率: 0.54, 已结算: 32 }
  },
 类型细分: {
 聪明钱确认: { 计数: 35, 24小时命中率: 0.61 },
 趋势反转: { 计数: 13, 24小时命中率: 0.47 }
  }
}

GET /v1/signals/recent

可用权限：免费版交易者版专业版无需认证

所有监测标的近期发布的HIGH和MEDIUM信号流。每条记录包含信号类型、置信等级、方向及可用的结算状态。

响应示例

JSON

{
 signals: [
    {
 id: 1042,
 symbol: BTC,
 direction: long,
 signal_type: smart_money_confirm,
 confidence: HIGH,
 composite: 0.74,
 ts: 1710940821,
 resolved: true,
 outcome_24h: win
    }
  ],
 count: 50
}

GET /v1/signals/{id}/outcome

可用权限：免费版交易者版专业版无需认证

通过数字ID查询单个信号的结算结果。返回各时间范围（4h/12h/24h/72h）的命中/未命中状态，以及信号触发时和结算时的价格。

参数说明

参数	类型	描述
id必填	整数	信号ID（路径参数），例如 `/v1/signals/1042/outcome`

响应示例

JSON

{
 id: 1042,
 symbol: BTC,
 direction: long,
 confidence: HIGH,
 entry_price: 63200.0,
 ts: 1710940821,
 outcomes: {
 4h: { result: win, price: 64100.0, pct: 1.41 },
 12h: { result: win, price: 65200.0, pct: 3.16 },
 24h: { result: win, price: 65800.0, pct: 4.11 },
 72h: { result: pending, price: null, pct: null }
  }
}

GET /v1/confirm-winrate

要求权限：免费版交易者版专业版

认证用户API密钥的确认信号胜率分析。返回各置信等级的独立调用胜率、盈利系数及按标的统计。需提供有效的 X-API-Key 请求头

请求示例

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm-winrate"

响应示例

JSON

{
 high_winrate: 0.714,
 high_n: 14,
 medium_winrate: 0.530,
 中等样本量: 34,
 整体准确率: 0.613,
 总体样本量: 48,
 盈利因子: 1.77,
 胜率周期: 24h,
 按交易对: {
 BTC: { 胜率: 0.68, 样本量: 22 },
 ETH: { 胜率: 0.55, 样本量: 18 }
  }
}

基于独立调用统计。 胜率按独立的确认调用计算（每个交易对每5分钟窗口一次），而非每次API请求——这避免了机器人高频轮询导致的样本量虚高。数据基于默认30天窗口内的样本；与 /v1/stats 相同的注意事项适用。

影子门

所需权限：免费版交易者版专业版

一个不可篡改、仅追加的个人决策账本。在执行交易前后提交您的决策；系统会对照Smart Money引擎计算确认分数并永久追加记录。用于建立API信号与您实际入场时点匹配度的真实时间戳记录——完全独立于全局胜率池。免费版和交易者版的响应会移除证据字段；专业版返回完整分析结果。免费版数据存在层级延迟。

POST /v1/shadow-gate/decisions

提交决策。通过 Idempotency-Key 请求头实现幂等性——重复提交相同密钥将返回现有记录而不会重复创建。系统会立即调用确认引擎并将结果作为不可变账本记录追加。

请求正文

字段	类型	说明
symbol必填	string	资产代号，如 `BTC`
side必填	string	交易方向： `long` 或 `short`
strategy_id选填	string	调用方定义的策略标签（最多64字符）。原样存储用于分组筛选。

请求示例

cURL

curl -X POST \
 -H "X-API-Key: sm_your_key" \
 -H "Idempotency-Key: my-signal-20260701-001" \
 -H "Content-Type: application/json" \
 -d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
 "https://api.smartmoneyapi.com/v1/shadow-gate/decisions"

响应示例

JSON

{
 "id": 318,
 "symbol": "BTC",
 "side": "long",
 "strategy_id": "ema_crossover",
 "decision": "CONFIRM",
 "confidence": "HIGH",
 "composite": 0.74,
 "size_mult": 1.5,
 "ts": 1710940821,
 "resolved": false
}

层级说明。 免费版和交易者版响应会省略 factors / adjustments 证据字段。专业版返回完整确认分析。免费版存在层级延迟——记录会立即写入但确认分数可能反映最多60秒前的缓存数据。

GET /v1/shadow-gate/decisions

列出您提交的影子门决策（按时间倒序）。所有权限定——仅返回当前API密钥提交的决策。

参数

参数名	类型	说明
limit选填	integer	返回的最大行数。默认值： `50`，最大值： `200`
cursor选填	string	来自先前响应 `next_cursor` 字段的不透明分页游标。首次查询可省略。

响应示例

JSON

{
 "decisions": [
    { "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
    { "id": 317, "symbol": "ETH", "side": 空头, 决策: SKIP, 置信度: LOW, 复合指标: -0.12, 规模倍数: 0.0, 时间戳: 1710937000, 已结算: True }
  ],
 计数: 2,
 下一页游标: None
}

GET /v1/shadow-gate/decisions/{id}

通过ID获取单个决策（Pro层级含完整确认证据）。Free和Trader层级的响应中 factors 和 adjustments 字段会被移除。若决策属于其他API密钥则返回 403 。

示例响应（Pro）

JSON

{
 ID: 318,
 交易对: BTC,
 方向: 多头,
 策略ID: ema_crossover,
 决策: CONFIRM,
 置信度: HIGH,
 复合指标: 0.74,
 规模倍数: 1.5,
 因子: {
 衍生品: { 分数: 0.81, 权重: 0.40, 加权值: 0.324 },
 链上数据: { 分数: 0.68, 权重: 0.35, 加权值: 0.238 },
 巨鲸: { 分数: 0.73, 权重: 0.25, 加权值: 0.183 }
  },
 时间戳: 1710940821,
 已结算: False,
 结果: None
}

POST /v1/shadow-gate/decisions/{id}/resolve

手动结算决策结果。平仓后调用此接口以记录最终结果至账本行。结算后不可更改。

请求体

字段	类型	说明
outcome必填	字符串	交易结果： `win` 或 `loss`
exit_price选填	浮点数	平仓价格（仅记录，若提供则用于计算盈亏百分比）
pnl_pct选填	浮点数	实现盈亏百分比（相对于仓位规模），例如 `3.5` 或 `-1.2`

示例响应

JSON

{
 ID: 318,
 已结算: True,
 结果: 盈利,
 平仓价: 65800.0,
 盈亏百分比: 4.1,
 结算时间: 1711027200
}

不可变性 账本行仅支持追加。决策提交后不可删除，结算后不可重新结算。由此确保交易记录真实可验证。

错误码

状态	代码	描述
400	invalid_params	缺失或无效的查询参数
401	unauthorized	缺失或无效的API密钥
403	plan_restriction	当前订阅计划不支持该端点
429	rate_limit_exceeded	达到每日或突发限制
500	internal_error	服务器错误——请检查/health接口状态
503	data_stale	数据源不可用（返回最后已知数据）

代码示例

Python

import requests

r = requests.get(
 "https://api.smartmoneyapi.com/v1/confirm",
  params={"symbol": "BTC", "direction": "long"},
  headers={X-API-Key: sm_your_key}
)
data = r.json()

print(data["confidence"])  # 高/中
print(data["size_mult"]) # 1.5 / 1.0

Python

import requests

API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"

def confirm_trade(symbol, direction):
  resp = requests.get(
    f"{BASE_URL}/confirm",
    params={"symbol": symbol, "direction": direction},
    headers={"X-API-Key": API_KEY},
    timeout=5
  )
  resp.raise_for_status()
 return resp.json()

# 在交易循环中:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
 print("跳过 — 置信度不足")
else:
  size = base_size * signal["size_mult"]
 place_order(symbol, direction, size)

JavaScript / Node.js

JavaScript

const API_KEY = 'sm_your_key';

async function confirmTrade(symbol, direction) {
 const params = new URLSearchParams({ symbol, direction });
 const res = await fetch(
    `https://api.smartmoneyapi.com/v1/confirm?${params}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
 if (!resok) throw new Error(`API error: ${resstatus}`);
 return res.json();
}

// 用法
confirmTrade('BTC', 'long').then(data => {
  console.log(dataconfidence, datasize_mult);
});

cURL

Shell

# 确认做多交易
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# 获取鲸鱼数据
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/whales?symbol=BTC"

# 检查用量
curl -X GET \
  -H X-API-Key: sm_your_key \
 https://api.smartmoneyapi.com/v1/usage

Freqtrade集成

通过重写方法，为任何Freqtrade策略添加Smart Money确认功能。 confirm_trade_entry 方法。

Python — Freqtrade策略

import requests
from freqtrade.strategy import IStrategy

class SmartMoneyStrategy(IStrategy):
  SM_API_KEY = "sm_your_key"
  SM_BASE = "https://api.smartmoneyapi.com/v1"

 def confirm_trade_entry(self, pair, order_type,
                         amount, rate, time_in_force,
                         current_time, entry_tag, **kwargs):
    symbol = pair.split("/")[0]
 if symbol not in ["BTC", "ETH", "SOL"]:
 return True # 跳过不支持的币种检查
 try:
      r = requests.get(
        f"{self.SM_BASE}/confirm",
        params={"symbol": symbol, "direction": "long"},
        headers={"X-API-Key": self.SM_API_KEY},
        timeout=3
      ).json()
 return r.get("confidence") in ["HIGH", "MEDIUM"]
 except:
 return True # API出错时默认放行

CCXT + Smart Money

Python — CCXT

import ccxt, requests

exchange = ccxt.bybit({
 "apiKey": "YOUR_BYBIT_KEY",
 "secret": "YOUR_BYBIT_SECRET"
})

SM_KEY = "sm_your_key"

def smart_trade(symbol, side, amount):
 # 先检查确认信号
  conf = requests.get(
 "https://api.smartmoneyapi.com/v1/confirm",
    params={"symbol": symbol, "direction": side},
    headers={"X-API-Key": SM_KEY}
  ).json()

 if conf["confidence"] not in ["HIGH", "MEDIUM"]:
 print(f"跳过{symbol} {side}交易 — 置信度不足。")
 return None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 print(f"订单已下达: {adj_amount} {symbol} {side}")
 return order

需要帮助？

查看 API状态页获取实时健康信息，或使用我们的联系表单.

Smart Money API

设计原则

该API的适用对象

获取访问权限

规范、SDK与实用指南

2分钟快速入门

身份验证

谷歌登录（Firebase认证）

请求体

响应示例

速率限制

基础URL

错误处理

安全最佳实践

与编程代理/LLM配合使用

端点

GET /confirm

参数

示例请求

示例响应

响应字段

GET /snapshot

GET /onchain

GET /v1/derivatives/*

GET /v1/options/*

GET /v1/etf/*

GET /v1/historical/*

GET /v1/dex/*

GET /v1/news/*

GET /whales

GET /signals

GET /v1/strategies/*

端点

GET /export

GET /health

GET /usage

POST /webhooks

请求体

验证签名

智能分析

GET /analysis

参数

示例响应

GET /liquidations

参数

示例响应

GET /liquidations/heatmap

参数

示例响应

GET /liquidations/onchain

参数

示例响应

GET /smart-stop

Parameters

Example Response

GET /funding-arb

Parameters

Example Response

免费公开版 无需认证

GET /smart-money/flow

参数

示例响应

GET /v1/whales/crowding

参数

示例请求

示例响应

GET /v1/options/gex

参数

示例请求

示例响应

GET /v1/liquidations/simulate

参数

示例请求

示例响应

GET /v1/wallet/{addr}/profile

参数

示例请求

示例响应

GET /flows

示例响应

免费公开版无需认证