robinhood-chain

mcp-server-robinhood-chain

Agent 智能网关（0.15.0 新增，可选启用）。 设置 MADEONSOL_AGENT_GATEWAY_ENABLED=on，并提供付费（PRO 或更高级别） MADEONSOL_API_KEY，即可添加六个固定用于 robinhood-chain 的研究工具： discover_opportunities、evaluate_token、inspect_wallet、 inspect_deployer、evaluate_signal 和 changes_since。这些工具会使用你的密钥调用 POST /api/v1/agent-gateway/actions，绝不会签署或支付 x402 请求。RHC 的限制明确如下：evaluate_signal 会报告 Signal Scorecard 在 Robinhood Chain 上不受支持（目前没有经过验证的 RHC 等效功能）；changes_since 涵盖三个经过整理的 KOL/部署者事件类别，而非每笔兑换。未选择启用时，工具清单 不变。另提供托管端点： https://madeonsol.com/api/agent-gateway/mcp（Bearer msk_ 密钥，不使用 MCP OAuth）。网关规范。

托管的 /api/agent-gateway/mcp 传输使用按请求提供的账户密钥和自定义 Authorization 标头。它不实现 MCP OAuth； 请勿将此软件包的私有环回 HTTP 适配器作为公共服务开放。

📚 API 文档 · 🤖 Robinhood Chain · 💰 免费 API 密钥

Robinhood Chain MCP 服务 — 面向 AI Agent 的 EVM 原生链上交易情报，链 ID 为 4663。

让 Claude、Cursor 或任何 MCP 客户端直接访问我们可自托管的 RHC 节点提供的 Robinhood Chain（一个 Arbitrum Orbit L2）交易数据：实时 KOL 交易，以及协同和首次触达发现信号；完整的 Uniswap v2/v3/v4 DEX 交易记录；代币发现及发行捆绑包和早期买家质量检测（支持单个和批量）；1 分钟 OHLC 蜡烛图；涵盖 99k+ 已排名部署者的部署者信誉数据（排行榜、提醒、趋势、每位部署者的发行历史）；以及智能资金钱包排名 — 另可对 RHC 规则引擎进行完整的 CRUD 操作：跟单规则、市值下跌/回升价格提醒、KOL 协同提醒和首次触达推送订阅，所有功能均设有按链配额。每个工具均为 EVM 原生：小写 0x 地址、eth_amount、tx_hash、block_number、net_flow_eth。KOL→EVM 映射通过追踪每位 Solana KOL 的桥接存款（deBridge / Relay / Mayan / Wormhole）得出，这是 MadeOnSol 独有的数据集。

RHC 覆盖已包含在每个套餐中，无需额外付费。在 madeonsol.com/pricing 获取免费 API 密钥（每天 200 次请求，无需信用卡）。

0.8.1 — 与更广泛的 RHC SDK 版本保持一致：自 2026-08-27 起，WebSocket 流令牌（POST /api/v1/stream/token）永不过期 — 每次调用都会返回同一个令牌，expires_at / next_refresh_at 始终为 null，只有显式传入 {"rotate": true} 才会替换令牌。本 MCP 服务提供 REST 工具，而非 WebSocket 通道，也不包含流令牌工具，因此工具行为没有变化。

0.5.0 — 与更广泛的 RHC SDK 版本保持一致：TS/Python/Rust SDK 中的流通道名称已修正（RHC 实时数据通道为 rhc:dex_trades；服务端仅将 rhc:trades 作为其已弃用别名接受）。本 MCP 服务提供 REST 工具，而非 WebSocket 通道，因此工具行为没有变化 — rhc_trades 工具（GET /rhc/trades 交易记录）不受影响。 仅支持密钥模式。 使用 msk_ Bearer API 密钥（MADEONSOL_API_KEY）进行身份验证。Robinhood Chain 确实提供无密钥的 x402 按次付费通道，目前有 10 个端点（从最初的 6 个增加而来），文档见 madeonsol.com/robinhood/x402，但该通道不属于此服务。

服务更新 2026-10-04（无需更改软件包）：RHC 跟单规则支持任何有效的来源钱包。 source_wallets 不再必须是已跟踪的 KOL 钱包（/rhc/kol/wallets）：任何有效的 0x 钱包都会触发跟单；是否属于 KOL 仅用于补充信息，跟单来源也不占用 Wallet Tracker 配额。每条规则都会报告 source_admission（any_wallet）和 operational_state（eligible，或基础设施状态 monitoring_pending / monitoring_unavailable / source_capacity_unavailable）。source_wallets_tracked / source_wallets_untracked、no_tracked_sources 和 untracked_source_wallets 警告属于旧字段，仍会填充。现有规则无需修改即可继续使用。限制不变：PRO 为 3 条规则 × 5 个钱包，ULTRA 为 20 × 50，BUSINESS 为 100 × 250。

**0.16.1 新增：**代币锁工具上的 family 提示现在列出 stonkbrokers-vesting（StonkBrokers Safety Deposit Box 归属），API 自 2026-10-19 起接受该值。仅为提示，不涉及工具变更。

0.16.0 新增：跨时段捆绑买入、当前捆绑持仓占比、每个代币的 KOL 交易、侦察员排行榜、开发者活动（共 73 个工具）。 新增五个只读工具。rhc_token_bundles（GET /rhc/tokens/{address}/bundles）会列出某代币上的所有协同买入集群，包括发行时及后续买入，并提供当前持仓；对于已关注的集群，还会提供退出进度。rhc_token_bundle_share（GET /rhc/tokens/{address}/bundle-share）会根据我们节点上的 balanceOf，给出每个捆绑账户当前持有的总供应量占比；除非读取了所有账户，否则会返回 null 并附上原因。rhc_token_kol_trades（GET /rhc/tokens/{address}/kol-trades）会返回某个代币上所有已跟踪 KOL 的交易。rhc_kol_scout_leaderboard 会对那些率先买入代币、随后被其他 KOL 跟进的 KOL 排名。rhc_deployer_activity（GET /rhc/deployer-hunter/{address}/activity）会按时间线列出开发者的发行、开发者买入和开发者卖出，并提供精确的原始金额。现有工具新增可选参数：include_balances（rhc_token_bundle、rhc_token_buyer_quality）、verify_current_balances + include_scout_scores（rhc_token_early_buyers）、include_wallet_flags（rhc_token_holders）、include_launches_24h（rhc_deployer_tokens）、include_performance（rhc_kol_profile）、sort + min_closed（rhc_kol_leaderboard）。仅新增功能，不影响现有行为。

0.13.0 新增：代币锁来源信息。 工具说明：代币锁记录包含 provider（根据锁仓合约地址判断身份：仅已知提供方的部署会标记为 verified；compatible 表示 ABI 匹配，但无法识别操作方，且没有 id / 网站 / lock_url）、explorer（Blockscout 链接）、price_usd、seconds_until_end、seconds_until_next_unlock（服务端 2026-10-02）。RHC 提款仍不跟踪（withdrawn 为 null）；LP 记录不会包含 usd / 价格 / %。仅新增字段，不影响现有行为。rhc_token_locks 支持 cursor（严格键集分页）。 0.11.0 新增 — 重大变更：HTTP 模式现在需要单独的令牌（安全修复，SEC-02）。 如果你使用 MCP_TRANSPORT=http 运行此服务，现在还必须设置 MCP_HTTP_TOKEN（自行生成的随机密钥），并在每个请求中以 Authorization: Bearer <token> 的形式发送，包括 GET /health 和服务卡片端点。此前，任何能够访问绑定端口的对象都可以使用操作员自己的凭据调用所有工具，完全不需要身份验证。HTTP 模式现在被严格限制为字面上的环回地址（127.0.0.1 / ::1），会直接拒绝 Origin / X-Forwarded-* 标头和重复的 Authorization / Host 标头，只开放 POST /mcp 和两个 GET 路由，并且在配置了钱包/支付凭据时拒绝启动。如果你使用默认的 stdio 传输方式（Claude Desktop、Cursor、大多数 MCP 客户端），则一切不变，无需采取任何操作。 这是针对单个共享操作员令牌的修复，并非新的多用户或 OAuth 系统。完整说明：docs/audit/SEC02_PRIVATE_HTTP_MCP.md。

0.10.1 新增 — 服务现在会报告 MCP instructions。 initialize 响应的 instructions 字段（供调用方 Agent 使用的操作指南，不同于本 README/软件包说明）此前从未设置；会检查运行中服务的目录（Glama）报告“未记录 MCP 指令”。没有新增工具；总数仍为 68。

0.10.0 新增 — 代币锁定与归属（当时共 68 个工具）。 新增三个工具，于 2026-09-15 发布，直到现在才在此处记录（代码发布时没有提升版本号，也没有添加变更日志条目，因此这份 README 一直写着 65 个工具，而服务实际上已注册 68 个；今后会通过主代码库中的 scripts/verify-mcp-tool-counts.mjs 检查）。rhc_token_locks（PRO+）按时间倒序列出所有代币上创建的锁定/归属合约，包括兼容 PinkLock、HoodLock、兼容 Team Finance、Titan、兼容 UNCX 的 LP 锁仓服务以及 Sablier v4，数据由我们自己的节点解码。rhc_token_lock_summary（PRO+）将某个代币的所有锁定汇总为实时视图，显示“团队是否锁定、锁定了多少、锁定到何时、是否可以取消”。rhc_token_unlocks（PRO+）列出全链范围内未来 1h–90d 的解锁事件。这三个工具都只记录创建事件：任何 RHC 锁仓服务的链上事件都不会追踪提款和取消，因此 withdrawn 始终为 null（未知），绝不会是 0；切勿将锁定状态表述为超出计划所显示范围的“仍被锁定”。

0.9.0 新增 — 早期买家（当时共 65 个工具）。 rhc_token_early_buyers（GET /rhc/tokens/{address}/early-buyers，PRO+）— 列出代币的早期买家，按排名排序，并标示其是否仍持有代币。内部 Agent 基础设施覆盖审计发现，这是所有 Agent 接入界面中都无法访问的唯一一项 RHC 功能，并非只有此处无法访问。

0.8.0 新增 — 代币化股票与流动性移除事件流。 新增两个工具。rhc_equities（GET /rhc/equities，BASIC）列出所有官方 Robinhood 代币化股票和 ETF（NVDA、SPY、AAPL，……），包含实时价格 / MC / 流动性、24h 交易量、ETH 成交量以及买卖双方占比；支持按 volume / trades / market_cap / last_trade / symbol 排序，并可按精确 symbol 或子串 q 筛选。身份识别依据是发行方信标，而不是名称：只有当合约是 Robinhood 发行方信标 0xe10b6f6b…151b00 上的 EIP-1967 信标代理时，才会列出该代币；该信息由我们自己的节点读取。发布当天，存在 20 个伪造的“GameStop • Robinhood Token”合约和 8 个名称带有完全相同官方后缀的伪造 NVDA 合约，它们都不会出现在列表中。rhc_lp_events（GET /rhc/lp-events，PRO+）是地毯式骗局风险信号：记录来自我们节点日志订阅的受监控资金池中的 Uniswap v2/v3 Burn 事件，以及 v4 中负增量的 ModifyLiquidity 事件；支持按 token / pool / provider / dex 筛选，并使用 next_before 游标分页。仅记录移除事件——不会持久化添加事件（响应的 coverage 区块中会注明 adds_persisted: false），金额是原始 uint256 字符串，v4 行仅包含 liquidity，而 provider_is_token_deployer 是典型的骗局信号。数据始于 2026-08-05。 0.7.0 新增 — holder_growth：谁来了，谁离开了。 rhc_token_holders 工具现在会在 GET /rhc/tokens/{address}/holders 返回 holder_growth：{ "1h", "24h", "7d" } × { cutoff_block, entered, entered_still_holding, exited, net }。entered = 首笔该代币 Transfer 发生在窗口截止区块或之后的地址（当前余额不限）；entered_still_holding = 其中当前余额仍非零的地址；exited = 窗口开始前已有余额、且在窗口内最后一次变动后余额归零的持有者；net ≈ holder_count 的变化量。所有计数均不包含池和销毁地址。之所以能实现这一功能，是因为 RHC 余额是从我们自有节点上的 ERC-20 Transfer 日志折算得出的——折算过程会保留每个地址的首次出现区块和最后变动区块，并保留余额为零的行——因此这是直接读取，而非估算；Solana 持有者普查是某个时间点的账本扫描，没有历史记录，无法回答这个问题。只有当链上该时间窗口内没有已摄取的交易时，窗口才会是 null（绝不会是 0）；只有增长数据读取失败时，整个区块才会是 null。发布当天的合理性检查：一个当天早上上线的代币在 24h 内有 593 个地址进入，其中 560 个仍在持有，且 holder_count 恰好为 560。

0.6.0 新增 — 钱包情报。 新增 10 个操作，覆盖 Robinhood Chain 钱包相关功能；此前完全没有 SDK 绑定：rhc_wallet、rhc_wallet_pnl、rhc_wallet_positions、rhc_wallet_trades，以及观察列表工具——rhc_wallet_tracker_list、rhc_wallet_tracker_add、rhc_wallet_tracker_remove、rhc_wallet_tracker_relabel、rhc_wallet_tracker_trades 和 rhc_wallet_tracker_summary。所有金额均以 ETH 计价，成本基础按滚动 90 天窗口内的 FIFO 计算——cost_basis_observable_from 表示窗口开始日期，因此，如果某个持仓在此日期之前开仓，它会显示为没有匹配买入记录的卖出。个人资料、盈亏和持仓这三类操作在服务端共享同一个快照缓存，因此对某个地址调用全部三项，计算量大约相当于一次，而不是三次；cache_hit 会标明是哪次调用承担了计算。观察列表配额按链计算（PRO 50 / ULTRA 250 / BUSINESS 1,000 个 RHC 钱包），与您的 Solana 列表互不相关。

安装与配置

将以下内容添加到您的 MCP 客户端配置中（Claude Desktop、Cursor、Claude Code）。无需安装步骤——首次运行时由 npx 获取：

{
  "mcpServers": {
    "robinhood-chain": {
      "command": "npx",
      "args": ["-y", "mcp-server-robinhood-chain"],
      "env": {
        "MADEONSOL_API_KEY": "msk_your_api_key_here"
      }
    }
  }
}

然后可以向您的 Agent 提问，例如 “Robinhood Chain 上被跟踪的 KOL 目前在买什么？” 或 “为链 4663 上代币 0x… 的早期买家群体评分。”

传输方式

• stdio（默认）——供本地客户端使用（Claude Desktop、Cursor、Claude Code）。
• http——可选的私有适配器，仅支持 API 密钥，供一位受信任的操作者通过 loopback 使用。请参阅下方的访问要求；不支持公开托管。

私有 HTTP 传输（SEC-02）

Stdio 仍是 Claude Desktop、Cursor 和其他本地 MCP 客户端的默认传输方式。现在，HTTP 需要显式配置私有操作员；此前未经过身份验证的 HTTP 启动设置将被安全拒绝。

1. 将 MADEONSOL_API_KEY 设置为操作员的 msk_ 密钥。
2. 生成一个单独的随机访问令牌，例如 node -e "console.log(require('node:crypto').randomBytes(32).toString('base64url'))"，并将其保存为 MCP_HTTP_TOKEN。不要复用上游 API 密钥，也不要将任一凭据放入 URL。
3. 设置 MCP_TRANSPORT=http、HOST=127.0.0.1（默认值，也可设为 ::1），并可选设置 PORT（默认值为 3100）。启动前会拒绝非环回地址绑定、缺少凭据，以及任何 SVM_PRIVATE_KEY 或 RHC_PAYER_KEY。Solana 钱包/x402 模式仍可通过 stdio 使用。
4. 连接到 http://127.0.0.1:3100/mcp，并在每个请求中附带 Authorization: Bearer <MCP_HTTP_TOKEN>，以及常规 MCP Content-Type 和 Accept 标头。如果客户端无法附加标头，请使用 stdio。本地令牌由 MCP 适配器验证；只有 MADEONSOL_API_KEY 会发送到上游。

仅开放 POST /mcp、GET /health 和 GET /.well-known/mcp/server-card.json，且这些端点都需要身份验证。/ 和任意路径不再是 MCP 端点。该适配器是无状态的：不会签发会话 ID，会拒绝提供的 Mcp-Session-Id，并对 /mcp 上的 GET/DELETE 请求返回 405。Host 必须是所选的环回地址字面值及其端口，或带有该准确端口的 localhost。浏览器 Origin 标头、转发/代理标头和跨源请求都会被拒绝；不授予 CORS 访问权限。

限制：未压缩 JSON 请求体最大为 256 KiB，标头最大为 8 KiB，请求体上传期限为 10 秒，最多允许 16 个已通过身份验证的活动请求。这些限制会在工具分发前拒绝超大或格式错误的输入。这不是整个工具执行过程的期限；断开连接后，已提交的上游操作仍可能继续执行。

持有本地令牌的所有人都将作为同一操作员行事，包括访问该操作员的变更工具。这不是多用户/OAuth 服务：不要将其置于公共代理之后，不要与不可信用户共享，也不要暴露已注资的签名者。不同用户需要使用隔离的进程/凭据，或等待未来能对每个主体进行身份验证并映射其各自凭据的传输方式。使用新的 MCP_HTTP_TOKEN 重启即可轮换访问权限。

Docker 镜像采用相同的环回限制，并要求提供这两项环境凭据。其健康检查会进行身份验证，且不会将令牌放入 URL。不支持公开发布 Docker 端口；请使用 stdio，或使用位于同一可信网络命名空间中的客户端。

工具 — 全部 64 个 Robinhood Chain 路由

每个工具都与 Robinhood Chain v1 API 路由一一对应。其中 49 个用于读取（GET，以及两个批处理工具；由于地址列表过长，无法放入查询字符串，因此使用 POST 发送地址列表），15 个会实际写入（规则引擎上的 POST / PATCH / DELETE 操作，以及三项钱包观察列表变更）——这些工具会在下方标记为 ✍️ / 🗑️，并带有非 readOnly 的 MCP 注解，因此行为良好的客户端不会推测性调用它们。字段采用 EVM 原生格式。

读取

工具	路由	套餐等级	描述
rhc_kol_feed	/api/v1/rhc/kol/feed	BASIC	KOL 交易动态，附带 MC/峰值数据，以及 mc_multiple_since_trade（PRO+ 实时更新；免费密钥延迟 5 分钟）
rhc_kol_leaderboard	/api/v1/rhc/kol/leaderboard	BASIC	按交易笔数、再按 ETH 净流量排名的 KOL（24h/7d/30d）
rhc_kol_hot_tokens	/api/v1/rhc/kol/hot-tokens	BASIC	时间窗口内由 2 个或更多不同 KOL 买入的共识代币
rhc_kol_profile	/api/v1/rhc/kol/{wallet}	BASIC	单个 KOL 资料——最近 200 笔交易的统计数据 + 最近 50 笔交易
rhc_kol_coordination	/api/v1/rhc/kol/coordination	BASIC	全窗口 SQL KOL 共识（15m/1h/6h/24h/7d），而非 1,000 笔交易的热门代币样本——ETH 净流量、达成共识所需时间及逐 KOL 明细
rhc_kol_first_touches	/api/v1/rhc/kol/first-touches	BASIC	每个代币最早的 KOL 买入（发现信号）——买入时 MC、代币年龄、tx_hash。evm_address 仅限 ULTRA
rhc_trades	/api/v1/rhc/trades	PRO+	DEX 交易记录——Uniswap v2/v3/v4 兑换，包含有效的 trader_eoa 和 MEV 字段
rhc_lp_events	/api/v1/rhc/lp-events	PRO+	流动性移除动态（rug 信号）——v2/v3 Burn + v4 负向 ModifyLiquidity，原始 uint256 字符串，provider_is_token_deployer。仅记录移除，不持久化添加操作
rhc_tokens	/api/v1/rhc/tokens	PRO+	代币发现——MC、流动性、峰值 MC + 回撤、启动平台、部署者等级
rhc_equities	/api/v1/rhc/equities	BASIC	代币化股票和 ETF（NVDA、SPY、AAPL…）——实时报价/MC/流动性 + 24 小时交易量 / ETH 交易量 / 买卖方分布。身份依据 = 发行方 beacon 0xe10b…151b00，而非名称
rhc_token	/api/v1/rhc/tokens/{address}	BASIC	代币快照——价格/MC/FDV、部署者区块、KOL 活动、资金池
rhc_token_batch	POST /api/v1/rhc/token/batch	BASIC	单次调用最多查询 50 个代币——价格/MC/FDV、峰值 MC、部署者信誉。未知地址会回显为 found: false
rhc_token_candles	/api/v1/rhc/tokens/{address}/candles	PRO+	1 分钟 OHLC 蜡烛图——价格 + MC OHLC、含买卖明细的交易量
rhc_token_kol_consensus	/api/v1/rhc/tokens/{address}/kol-consensus	PRO+	KOL 持仓情况——买家/卖家、退出率、net_flow_eth、入场 MC 中位数
rhc_token_buyer_quality	/api/v1/rhc/tokens/{address}/buyer-quality	BASIC	早期买家质量评分（0–100），包含捆绑买家 + 集中抛售群体相关指标
rhc_token_batch_buyer_quality	POST /api/v1/rhc/tokens/batch/buyer-quality	BASIC	单次调用查询最多 20 个代币的买家质量（上限为 20，不是 50——这是逐代币群体计算）
rhc_token_bundle	/api/v1/rhc/tokens/{address}/bundle	BASIC	启动捆绑检测（same_block）+ 该群体仍持有的数量
rhc_token_top_traders	/api/v1/rhc/tokens/{address}/top-traders	PRO+	按已实现 ETH 流量排名的顶级交易者（net_eth = 卖出 − 买入，不是 PnL）+ 钱包信誉
rhc_token_flow	/api/v1/rhc/tokens/{address}/flow	PRO+	按互斥群体统计净买入/卖出——正值 net_eth 表示该群体已分发代币
rhc_token_peak_history	/api/v1/rhc/tokens/{address}/peak-history	PRO+	峰值 MC、回撤、高水位曲线——peak_mc_usd_recorded 与 peak_mc_usd_observed
rhc_token_risk	/api/v1/rhc/tokens/{address}/risk	PRO+	实时计算 EVM 原生风险——代理升级能力、LP 托管、未缓存的蜜罐卖出模拟
rhc_token_holders	/api/v1/rhc/tokens/{address}/holders	PRO+	根据 Transfer 日志重放精确计算持有者及集中度，并与 totalSupply() 核对。请先检查 verified。holder_growth（1h/24h/7d）：entered、entered_still_holding、exited、net ≈ holder_count 的变化量 Δ
rhc_deployer_leaderboard	/api/v1/rhc/deployer-hunter/leaderboard	BASIC	按信誉排名的 99k+ 部署者——graduation_rate（$40K）、runner_rate（$100K）；等级依据 runner_rate
rhc_deployer_profile	/api/v1/rhc/deployer-hunter/{address}	BASIC	单个部署者资料 + 最近 50 个代币
rhc_deployer_tokens	/api/v1/rhc/deployer-hunter/{address}/tokens	BASIC	分页启动历史，含实时 + 峰值 MC（sort=peak_mc_usd 仅适用于当前分页）
rhc_deployer_history	/api/v1/rhc/deployer-hunter/{address}/history	PRO+	深度分页的部署历史（每页最多 1000 条），附带精确总数
rhc_deployer_trajectory	/api/v1/rhc/deployer-hunter/{address}/trajectory	BASIC	表现是在改善还是下滑？连续记录、10 次启动滚动成功率曲线、表现最好/最差阶段。成功 = 达到 $40K 毕业门槛
rhc_deployer_best_tokens	/api/v1/rhc/deployer-hunter/best-tokens	BASIC	时间窗口内由 elite/good 部署者发行、峰值 MC 最高的代币
rhc_deployer_stats	/api/v1/rhc/deployer-hunter/stats	BASIC	全链摘要——各等级数量、垃圾信息占比、警报量、启用的 tier_rules
rhc_deployer_alerts	/api/v1/rhc/deployer-hunter/alerts	BASIC	部署者警报——默认按可交易性筛选，在读取时解析等级（tier_at_alert、tier_is_stale）
rhc_recent_bonds	/api/v1/rhc/deployer-hunter/recent-bonds	BASIC	刚达到 $40K 峰值 MC 毕业里程碑的代币，按峰值时间从新到旧排列
rhc_alpha_wallets	/api/v1/rhc/alpha-wallets	PRO+	聪明钱钱包——net_eth、win_rate、memecoin_share、likely_bot
rhc_wallet	/api/v1/rhc/wallet/{address}	PRO+	钱包 90 天资料——ETH PnL、逐代币明细、信誉标记（与 PnL/持仓共用一个快照缓存）
rhc_wallet_pnl	/api/v1/rhc/wallet/{address}/pnl	PRO+	滚动 90 天窗口内按 FIFO 成本基础计算的 PnL——曲线、已平仓 + 未平仓头寸；cost_basis_observable_from
rhc_wallet_positions	/api/v1/rhc/wallet/{address}/positions	PRO+	按市值计算的未平仓头寸——请检查 liquidity_basis
rhc_wallet_trades	/api/v1/rhc/wallet/{address}/trades	PRO+	单个钱包的交易记录，按钱包（而非代币）使用键集分页
rhc_wallet_tracker_list	/api/v1/rhc/wallet-tracker/watchlist	PRO+	列出你的 RHC 观察列表——配额按链计算
✍️ rhc_wallet_tracker_add	POST /api/v1/rhc/wallet-tracker/watchlist	PRO+	跟踪钱包（写入时地址会转换为小写）；若已跟踪则返回 409，达到上限则返回 403
🗑️ rhc_wallet_tracker_remove	DELETE /api/v1/rhc/wallet-tracker/watchlist/{address}	PRO+	取消跟踪钱包，释放一个配额名额
✍️ rhc_wallet_tracker_relabel	PATCH /api/v1/rhc/wallet-tracker/watchlist/{address}	PRO+	修改已跟踪钱包的标签；null 会清除标签
rhc_wallet_tracker_trades	/api/v1/rhc/wallet-tracker/trades	PRO+	汇总你跟踪的钱包的交易动态，并附带标签
rhc_wallet_tracker_summary	/api/v1/rhc/wallet-tracker/summary	PRO+	基于 rhc_trades 的逐钱包汇总——完整历史，不限于捕获日志
rhc_copytrade_list	/api/v1/rhc/copytrade/subscriptions	PRO+	列出你的跟单规则。每条规则都包含 source_admission + operational_state；任何有效的 0x 来源钱包都会触发，无论是否为 KOL（自 2026-10-04 起；source_wallets_tracked / _untracked 为旧字段）
rhc_copytrade_get	/api/v1/rhc/copytrade/subscriptions/{id}	PRO+	按数字 ID 获取一条跟单规则（包含相同的跟踪字段）
rhc_copytrade_signals	/api/v1/rhc/copytrade/signals	PRO+	触发历史，保留 7 天——错过 Webhook 后的补查途径
rhc_price_alerts_list	/api/v1/rhc/price-alerts	PRO+	列出你的市值下跌/恢复警报
rhc_price_alerts_get	/api/v1/rhc/price-alerts/{id}	PRO+	按数字 ID 获取一条价格警报，并显示其记录的 baseline_mc_usd
rhc_price_alerts_events	/api/v1/rhc/price-alerts/events	PRO+	dip / recovery 触发历史，保留 30 天
rhc_coordination_alerts_list	/api/v1/rhc/kol/coordination/alerts	PRO+	列出你的 KOL 协同行为警报规则
rhc_coordination_alerts_get	/api/v1/rhc/kol/coordination/alerts/{id}	PRO+	按 UUID 获取一条协同规则
rhc_first_touch_subscriptions_list	/api/v1/rhc/kol/first-touches/subscriptions	ULTRA+	列出你的首次触达推送订阅
rhc_first_touch_subscriptions_get	/api/v1/rhc/kol/first-touches/subscriptions/{id}	ULTRA+	按 UUID 获取一条首次触达订阅

写入 — 规则引擎

这些会修改服务端状态、消耗各层级配额并触发 Webhook。它们标注为 readOnlyHint: false；删除工具还带有 destructiveHint: true。创建操作不具备幂等性——调用两次会创建两条规则，并可能触及上限，返回 409。

工具	路由	层级	描述
✍️ rhc_copytrade_create	POST /api/v1/rhc/copytrade/subscriptions	PRO+	创建一条跟单规则。webhook_secret 只返回一次
✍️ rhc_copytrade_update	PATCH /api/v1/rhc/copytrade/subscriptions/{id}	PRO+	更新规则；source_wallets 会整体替换列表，并重新检查是否超过层级上限
🗑️ rhc_copytrade_delete	DELETE /api/v1/rhc/copytrade/subscriptions/{id}	PRO+	永久删除。若要暂停，请使用 is_active: false
✍️ rhc_price_alerts_create	POST /api/v1/rhc/price-alerts	PRO+	创建 MC 下跌（以及可选的恢复）提醒。基线会在此刻捕获
✍️ rhc_price_alerts_update	PATCH /api/v1/rhc/price-alerts/{id}	PRO+	仅限 name / delivery_mode / webhook_url / is_active——阈值不可修改
🗑️ rhc_price_alerts_delete	DELETE /api/v1/rhc/price-alerts/{id}	PRO+	永久删除。重新创建会重新捕获基线，因此删除后再创建并非无操作
✍️ rhc_coordination_alerts_create	POST /api/v1/rhc/kol/coordination/alerts	PRO+	当 min_kols 个或更多 KOL 在 window_minutes 内买入同一代币时触发
✍️ rhc_coordination_alerts_update	PATCH /api/v1/rhc/kol/coordination/alerts/{id}	PRO+	更新阈值、MC 范围、投递方式及 is_active
🗑️ rhc_coordination_alerts_delete	DELETE /api/v1/rhc/kol/coordination/alerts/{id}	PRO+	永久删除
✍️ rhc_first_touch_subscriptions_create	POST /api/v1/rhc/kol/first-touches/subscriptions	ULTRA+	当代币首次出现受跟踪 KOL 买入时推送。未知筛选键会被拒绝
✍️ rhc_first_touch_subscriptions_update	PATCH /api/v1/rhc/kol/first-touches/subscriptions/{id}	ULTRA+	filters 会整体替换已存储的对象——未提供的键会被删除
🗑️ rhc_first_touch_subscriptions_delete	DELETE /api/v1/rhc/kol/first-touches/subscriptions/{id}	ULTRA+	永久删除

规则引擎配额按链计算。 即使 Solana 的跟单规则、价格提醒、协调规则或首次触达订阅已满，也不会占用你的 RHC 配额，反之亦然。

引擎	PRO	ULTRA	BUSINESS
跟单规则（每条规则的来源钱包数）	3（5）	20（50）	100（250）
价格提醒（启用）	5	25	125
协调规则	5	20	100
首次触达订阅	—	10	50

BASIC 可使用任何有效密钥。PRO+ 工具使用 BASIC 密钥时会返回 HTTP 403——在 madeonsol.com/pricing 升级。

Agent 常犯的五个错误

• RHC 价格提醒会在几秒内触发，而非亚秒级。 自 2026-09-15 起，提醒会在链上交易进入交易流（rhc:dex_trade）时进行评估，并以价格表轮询（5 s / 60 s）和交易记录回放作为安全保障；最低延迟取决于链上交易刷新（约 2 s）。不要承诺其与亚秒级的 Solana 价格提醒一致。创建响应中的 evaluation 块显示 mode: "event_driven"。事件中的 fired_at 表示评估器观察到价格变动的时间，而非链上发生变动的时间。

• RHC 跟单没有市值区间。 与 Solana 引擎不同，跟单规则没有 min_mc_usd / max_mc_usd，因为 RHC KOL 交易事件不包含市值——要实现该筛选器，就需要在每天约 330 万笔交易的链上针对每个事件读取数据库，否则筛选器会悄无声息地永远无法匹配。请改用 min_trade_eth 和 only_action 进行筛选。

• trader_eoa 不只是 tx.from。 它表示 实际交易账户：普通交易中为 tx.from，交易经打包时则为 ERC-4337 用户操作发送方（UserOperationEvent）——绝不是转发批次的捆绑器，也不是路由器。无论哪种情况，它都是 EOA；在 Robinhood Chain 上，用户操作发送方是携带 EIP-7702 委托的普通 EOA，而非智能合约钱包。请根据 trader_eoa 归属交易并对钱包进行排名；单独的 trader 字段仅表示交换日志的接收方，在聚合交换中即为路由器。

• rhc_deployer_alerts 默认会筛除不可交易的代币。 liquidity_usd 低于 $100（包括流动性未知）的代币提醒会被丢弃——市值 $45K、但流动性池已枯竭且仅有 $68 的提醒并不构成信号。传入 include_untradeable: true 可获取原始交易记录；响应始终会回显当前生效的 tradability_filter。提醒中的 tier 会在读取时根据实时信誉视图确定，因此绝不会显示部署者已失去的信誉等级——触发提醒时的快照会单独通过 tier_at_alert 返回，tier_is_stale 标记其变化。

• graduation_rate 不再决定等级。 它仍表示 $40K 峰值市值门槛，也仍会在所有位置返回，但 elite/good 等级根据 runner_rate（$100K）以及 24h 的部署者历史确定。根据 graduation_rate 对部署者排名，等于依据一个等级评定时已不再采用的指标进行排名。

为什么选择 Robinhood Chain

Robinhood Chain 兼具两种特性——既有 launchpad memecoin（pons / flap / clanker / hood.fun / virtuals），也有代币化股票和稳定币。大多数 launchpad 都是直接进入 DEX（没有联合曲线），因此“毕业”是一个市值里程碑：graduation_rate = 部署者发行的代币中，峰值市值达到 $40K 以上的比例；runner_rate = 达到 $100K 的比例。elite/good 等级依据 runner_rate，且要求部署者拥有 24h 历史记录（elite = 5 个以上代币，存在 24h 以上，runner_rate >= 0.50；good = >= 0.25）——仍会报告 graduation_rate，但不再用它确定等级，因为 $40K 门槛已被证明容易刷高；只有 spammer 仍依据该指标判定（20 个以上代币，graduation_rate < 0.05）。由于它是一个没有原子多签交易的 Arbitrum Orbit L2，检测到的发射捆绑交易属于 same_block（不存在 atomic_tx）。

链接

• 🤖 Robinhood Chain 概览 — https://madeonsol.com/robinhood
• 💰 定价与免费 API 密钥 — https://madeonsol.com/pricing
• 📚 API 文档 — https://madeonsol.com/api-docs

许可证

MIT © MadeOnSol