madeonsol

mcp-server-madeonsol

Agent 智能网关（4.1.0 新增，可选启用）。 设置 MADEONSOL_AGENT_GATEWAY_ENABLED=on，并搭配付费（PRO 或更高级别） MADEONSOL_API_KEY，即可添加六个专为 Solana 设计的研究工具： discover_opportunities、evaluate_token、inspect_wallet、 inspect_deployer、evaluate_signal 和 changes_since。这些工具会携带你的密钥调用 POST /api/v1/agent-gateway/actions，计入你的常规配额，且绝不会为 x402 请求签名或付款。回答会提供各来源的 evidence，并在来源受限时明确标记 partial 状态。changes_since 会重放七类精选的 KOL/部署者事件， 而非每笔兑换。未选择启用时，工具列表保持不变。 也可通过以下地址使用托管端点： https://madeonsol.com/api/agent-gateway/mcp（Streamable HTTP，Authorization: Bearer msk_…）；该端点未实现 MCP OAuth，因此仅支持 OAuth 的连接器无法使用它。MCP 是 Agent 调用工具的方式，而非计费方案。请参阅 网关规范。

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

六类早期数据流扩展（#457，尚未启用）： 托管的 earlyStream() 客户端、私有列表控制和代币/钱包助手已在 madeonsol-x402 TypeScript SDK 中实现。此软件包不会因这项 PR 获得该托管客户端 或新的 MCP/插件操作。现有狙击兼容性仅适用于 ULTRA+， 且仅限部署者。原始 WebSocket 集成请参阅候选发布版线路规范； 发布/版本一致性仍是发布门槛。

⚡ 通过 Smithery 安装 · 🤖 在 Claude Desktop 中使用 · 🖱️ 在 Cursor 中使用 · 📚 API 文档 · 💰 免费 API 密钥 · 🔎 在 Glama 上查看

适用于 MadeOnSol Solana KOL 情报 API 的 MCP 服务。可通过 Claude Desktop、Cursor 或任何兼容 MCP 的客户端使用。

Solana 实时交易情报：追踪 2,000 多个 KOL 钱包，付费密钥延迟低于 3 秒，并支持 x402 按次付费（免费套餐的实时数据流延迟 5 分钟）；为 8.5 万多个 Pump.fun 部署者评分；在链上确认前约 500ms 显示解封后的部署信号；检测多个 KOL 之间的协同活动；展示捆绑群组持仓（同一时隙的钱包仍持有多少代币供应量）；直接从代币账户核实任意钱包当前的链上持仓；并串流 9 个以上程序中的每笔 DEX 交易。免费套餐：每天 200 次请求，覆盖 40 多个端点（实时数据流延迟 5 分钟），无需预先付费注册。请前往 madeonsol.com/pricing 获取密钥。 服务端更新 2026-10-05/08（无需更改软件包）：实时开发者活动及 USDC/USDT 交易规模。 已签名的 Webhook 事件 dev:activity（PRO+）和 ULTRA+ DEX 套接字 dev_subscribe 路径会发送 dev_sell、dev_buy、dev_token_transfer_out 和 dev_token_transfer_in（转账绝不会被视为卖出）。现在，转账检测会合并两种来源：旧版的有界开发者钱包监控，以及针对已归因创建者的广泛 SPL Token/Token-2022 候选来源（仅在实时运行期间）。transfer_watch_coverage 仅描述旧版监控；订阅确认中的 transfer_sources.broad 会报告广泛来源的状态和缺口。通过恢复获取的广泛来源记录仅属于 REST 历史记录，不会触发追溯性实时警报。创建者归因缺失、来源缺口以及不受支持的混合兑换加独立转账情形仍存在局限。在 dex:trades 中，使用 USDC 或 USDT 支付的兑换现在会附带 sol_amount（稳定币交易腿对应的 SOL 等值，用于 dust、min_sol、max_sol），以及新增字段 sol_amount_basis（native_sol | stable_quote_equivalent | stable_quote_unconverted）和 stable_quote；stable_quote_unconverted 表示 sol_amount 为 0（规模未知）。详情：更新日志。

服务端更新 2026-10-04（无需更改软件包）：跟单规则支持任何有效来源钱包。 source_wallets 不再要求是受追踪的 KOL 钱包：任何有效的 Solana 钱包都会触发，KOL 成员身份仅作为可选的补充信息；跟单来源不占用 Wallet Tracker 配额。每条规则都会报告 source_admission（any_wallet）和 operational_state（eligible，或基础设施状态 monitoring_pending / monitoring_unavailable / source_capacity_unavailable）。source_wallets_tracked / source_wallets_untracked 和 untracked_source_wallets 警告属于旧版字段，仍会填充。此更新取代下文旧说明中“仅受追踪的 KOL 钱包会触发信号”的表述。限额不变：PRO 为 3 条规则 × 5 个钱包，ULTRA 为 20 × 50，BUSINESS 为 100 × 250。

部署者活动时间线（2026-10-08 扩展）。 madeonsol_deployer_activity 绑定 GET /deployer-hunter/{wallet}/activity（PRO+，仅限使用 msk_ API 密钥）：提供一条按时间倒序排列的时间线，包含发布、dev_buy、dev_sell、dev_token_transfer_out、dev_token_transfer_in、创建者转账、费用领取、资金流入和资本流出。持久化的实时记录可能包含低于最低门槛的交易；恢复的转账记录可能带有 recovered、recovered_at、late_classified 和 counterparty_count。解读空时间范围前，请先查看各类别的覆盖范围和保留情况；PRO 响应不包含身份信息块或费用支付方地址。 4.2.0 新增：持续追踪代币捆绑情况、当前捆绑持有比例，以及 KOL 对某个代币的所有交易（共 108 个工具）。 新增三个工具，仅支持 msk_ API（不支持 x402 路由）。madeonsol_token_bundles（GET /tokens/{mint}/bundles）会列出代币上的每个协同买入集群，包括发行时的捆绑集群以及之后形成的集群，并提供各集群目前仍持有的数量；对于服务器持续追踪的集群，还会提供其退出进度（exit：卖出比例、已完全退出的钱包数、已实现的 SOL）。madeonsol_token_bundle_share（GET /tokens/{mint}/bundle-share）提供一个数值，表示所有捆绑钱包当前持有的供应量比例；除非已读取每个钱包，否则会返回 null 并附带原因，绝不猜测数值。madeonsol_kol_token_trades（GET /kol/tokens/{mint}/trades）会返回某个代币上存储的所有受追踪 KOL 交易，按时间从新到旧排列，并支持基于键集的分页。现有工具新增可选参数：madeonsol_token_cap_table（limit、verify_current_balances、include_scout_scores）、madeonsol_token_buyer_quality 和 madeonsol_token_bundle（include_balances）、madeonsol_token_holders（include_wallet_flags）。仅增加功能。

3.3.0 新增：代币锁定来源信息。 工具描述：代币锁定记录包含 provider（identity 的状态为 verified | compatible | unverified；在 Solana 上 lock_url 始终为 null，绝不会构造该值）、explorer（Solana Explorer 链接）、price_usd、seconds_until_end、seconds_until_next_unlock；对于 Bonfida，还包含分期 schedule（服务器版本为 2026-10-02）。仅增加功能。madeonsol_token_locks_feed 接受 cursor（严格的键集分页）。

3.2.0 新增：付费工具调用丢失答案后可恢复，无需再次付费（PAY-05）。 在 x402（无密钥）模式下，如果付费调用的答案丢失或仍处于待处理状态，系统会使用相同的凭证重新发送调用，并附上由付款方签名的 PAYMENT-RECOVERY 标头（有上限），然后返回服务器存储的答案。工具结果会携带 _x402_payment 来源信息（付款 ID、原始/延迟、实时/已存储）；无法完成的付款会返回带代码的 x402_payment_error，提示不要再次付款。恢复重试不会使用 X402_MAX_* 预算。对于不支持恢复的服务器（旧版本或已关闭恢复功能），结果与之前相同：重新提交的凭证最终会触发 409 replay_detected，并显示该错误，绝不会再次付款。没有新增或移除工具。API 密钥用户：无变化。

3.1.1 新增：工具描述与 API 一致。 madeonsol_token_risk 和 madeonsol_tokens_batch_risk 描述的是供你制定自身策略使用的风险证据，而非定论。madeonsol_deployer_profile 列出了实际响应字段：is_deployer、嵌套的 deployer 对象（total_tokens_deployed、total_bonded 等）、pump_stats、pump_tokens、launchpad_tokens；未追踪的钱包会返回 is_deployer: false 和 deployer: null。没有新增或移除工具。

3.1.0 新增——跟单交易和 Wallet Tracker 工具与 API 一致。 madeonsol_copytrade_create / _update 最多接受 250 个 source_wallets（BUSINESS 的每条规则上限；此前工具会在服务器处理请求前拒绝超过 50 个的钱包）。服务器仍会执行你所在套餐的上限（PRO 为 5，ULTRA 为 50，BUSINESS 为 250）。Create、update 和 madeonsol_copytrade_signals 新增市值区间 min_mc_usd / max_mc_usd。only_action 的描述现在说明了实际默认值（buy），工具描述也说明信号仅会针对受追踪的 KOL 钱包触发。madeonsol_wallet_tracker_trades 新增 order（slot | block_time）和 before_slot 游标，其 action 筛选条件仅接受 buy | sell：API 一直会以 400 拒绝 transfer_in / transfer_out。如需查询转账，请使用 event_type: "transfer"。madeonsol_copytrade_update 说明：对没有签名密钥的规则执行会设置 webhook_url 的 PATCH 时，会返回一次性显示的 webhook_secret；跟单交易工具也会说明较新服务器返回的 source_wallets_untracked / warnings[] 字段。madeonsol_test_webhook 新增可选参数 event（用于示例的已订阅事件）。 3.0.0 新增 — 仅对 x402（无密钥）模式构成破坏性变更：现在必须设置 5 个环境变量，启动失败而非静默降级（安全修复，SDK-01）。 除 SVM_PRIVATE_KEY 外，还需设置 X402_PAY_TO、X402_FEE_PAYER、X402_MAX_AMOUNT_ATOMIC、X402_MAX_TOTAL_AMOUNT_ATOMIC 和 SVM_RPC_URL。此前，无密钥模式会对 402 挑战要求的任意 Solana USDC 金额、收款方和费用支付方进行签名。现在，每个挑战都会在签名前进行校验，确认其符合可信商户 payTo、可信支付协调方 feePayer（必须与您的钱包不同）、USDC mint、solana:5eykt… 主网、exact 方案、单次调用上限和生命周期上限。请使用下方无密钥部分中的规范值；单次调用上限必须至少为 20000（0.02 USDC），才能访问所有端点。预算按客户端实例／进程计算：不适用于整个钱包，不在进程间共享，并会在创建新实例或重启时重置。无密钥模式要求基础 URL 必须精确为 https://madeonsol.com。API 密钥（msk_）用户：无变化，无需新增配置。 HTTP 模式仍拒绝钱包签名者（SEC-02，未变）。 2.0.0 新增 — 重大变更：HTTP 模式现在需要单独的令牌（安全修复，SEC-02）。 如果你使用 MCP_TRANSPORT=http 运行此服务，现在还必须设置 MCP_HTTP_TOKEN（自行生成的随机密钥），并在每个请求中通过 Authorization: Bearer <token> 发送该令牌，包括 GET /health 和服务器卡片端点。此前，任何能够访问绑定端口的对象都能使用操作者自己的 API 密钥调用所有工具，完全不需要身份验证。HTTP 模式现在严格限制为字面环回地址（127.0.0.1 / ::1），会直接拒绝 Origin/X-Forwarded-* 标头和重复的 Authorization/Host 标头，只开放 POST /mcp 和两个 GET 路由；如果配置了钱包／支付签名者，服务将拒绝启动——HTTP 模式绝不会携带付款方密钥。如果你使用默认的 stdio 传输方式（Claude Desktop、Cursor 和大多数 MCP 客户端），则一切照旧——无需采取任何操作。 这是一项所有操作者共用单个令牌的修复，并非新的多用户或 OAuth 系统；所有 HTTP 调用者仍共用操作者自己的 MadeOnSol API 密钥。完整说明：docs/audit/SEC02_PRIVATE_HTTP_MCP.md。

1.27.1 新增 — 服务现在会报告 MCP instructions。 initialize 响应中的 instructions 字段（提供给调用 Agent 的操作指南，与本 README／软件包描述不同）此前从未设置；会检查运行中服务的目录（Glama）因此报告“未记录 MCP instructions”。没有新增工具；总数仍为 104 个。

1.27.0 新增 — 顶级交易者、狙击手监视列表管理和两个更新工具（当时总计 104 个工具）。 内部 Agent 基础设施覆盖率审计发现了六项新增内容。madeonsol_token_top_traders（GET /tokens/{mint}/top-traders，PRO/ULTRA）按已实现的 PnL 或 ROI 对代币钱包进行排名，并补充 KOL／Alpha 钱包身份信息——此端点此前已存在于 REST API 和 x402 通道中，但没有对应的 MCP 工具。madeonsol_sniper_watchlist_list / _add / _remove（PRO+/ULTRA）用于管理自定义的狙击部署监视列表（madeonsol_sniper_recent(watchlist: true) 会将结果限定为列表中的项目）——此前只能通过原始 HTTP 访问。madeonsol_update_webhook（PATCH）可更改 webhook 的 URL、事件或启用状态，无需删除并重新创建。madeonsol_wallet_tracker_relabel（PATCH）可重命名或清除已跟踪钱包的标签。

1.26.0 新增 — 指定日期的部署者信誉和创作者费用奖励。 新增两个工具（PRO+，仅限 msk_ API 密钥，不提供 x402 路由）。madeonsol_deployer_as_of 对应 GET /deployer-hunter/{wallet}/as-of：返回部署者在 date 当日的准确信誉（默认为今天，UTC）——取该日期或之前最新的变更时写入快照，让 Agent 能在没有前视偏差的情况下进行回测。snapshot.snapshot_date 可能早于 date（仅在发生变更时写入）；snapshot.carried: true 表示这种情况。若 date 当日或之前没有快照，则返回 as_of: false, snapshot: null——绝不会合成快照。date 必须不早于 2026-04-07，且不能是未来日期。madeonsol_deployer_rewards 对应 GET /deployer-hunter/{wallet}/rewards：以两种互不合并的方式返回 pump.fun 创作者费用奖励——collected（实际到账的钱款：直接金库领取记录保留 90 天、社交账号领取，以及任意代币的股东分红）和 attributed（该部署者所部署代币的每笔付款，细分为 to_self / to_others，并提供 redirected_pct）。每个金额字段的格式均为 {sol, usdc, usd}；存在 SOL 金额但没有 SOL 价格时，usd 为 null（绝不会悄悄返回 0）。top_tokens/top_recipients（按 USD 排序，最多 10 项）会展示费用流向。该工具对非部署者同样有效（is_deployer: false，attributed 为空）。 1.25.0 新增 — 代币飙升与复苏：动能触发信号，并附上真实情况。 新增的 madeonsol_tokens_surges 工具绑定 GET /tokens/surges（PRO+，仅限 msk_ API 密钥 — 无 x402 路由）：按时间倒序列出每一次代币动能触发信号。两种类型，一种行结构。surge — 创建时间不到 30 min、且市值相较其发行市值大幅上涨的代币，分为三个档位，每个 mint 最多触发一次：early（≤10 min、≥$12k、≥发行市值的 3×）、strong（≤30 min、≥$30k、≥发行市值的 6× 且 ≥过去 3 min 内最低样本的 2× — 表示它此刻正在上涨）、breakout（≤2 min、≥$45k、≥8×）。档位必须持续满足（当前 tick 和一个至少早 10 s 的样本；代币年龄不到 20 s 时不会触发）— 年龄 1 s 时，同一 slot 的打包交易将市值标记为 $475k，这只是尖峰，不是飙升。revival — 至少 24 h 没有 1 分钟交易蜡烛图的代币重新开始交易，仅由交易明细确认（≥5 笔买入、≥$500 买入交易量、市值 ≥休眠前收盘值的 1.5×），绝不由价格标记确认；tier 为 null。两种类型都必须满足硬性门槛：流动性 ≥$1.5k 且 ≥市值的 2 %，市值增幅必须由买入交易量实际支撑（在伪造交易池中，价格标记只需约 $0 就能推高市值）。每一行都包含爆发期的 tape（source 为 candles / wallet_trades；只有 mint 在交易覆盖范围内时才有 unique_buyers — 否则为 wallet_data_available:false，绝不会推断为零）、kol 买家、前 20 名 early_buyers 群体（打包买入 / 已卖出 / 狙击钱包）、deployer 信誉和 risk_flags[]（bundled_launch、few_buyers、wash_pattern、thin_liquidity、cold_deployer、sniper_heavy、early_buyers_exiting、sell_pressure、no_tape_trades、no_prior_price、mint_authority_active、transfer_fee — 为空表示未触发标记，并不代表已验证安全）。年龄 ≥65 min 的行包含 +1 h outcome；stats=1 会按 (kind, tier) 输出命中率（up_1h_pct、median_peak_multiple、doubled_1h_pct）— 这些数据在构建时就采用样本外统计。过滤器包括 kind、tier、mint、launchpad、deployer_tier、min_mc_usd / max_mc_usd、min_buys、exclude_flags、only_clean；游标为 since / before。通过新的 token:surges WS 通道实时推送（事件 token:surge / token:revival；订阅过滤器 kinds[]、tiers[]、launchpads[]、exclude_flags[]、min_mc_usd / max_mc_usd、deployer_tier[]），也可通过 madeonsol_create_webhook 订阅，事件为 token:surge / token:revival，并支持相同的过滤器。响应会在 definitions 中回显当前阈值。

1.24.1 新增 — 流式代币永不过期。 madeonsol_stream_token（POST /stream/token）现在每次调用永远返回同一个 token。只有订阅失效，或你调用该工具并设置 rotate: true 替换 token 时，它才会停止工作（之前的值仍可使用 60 s）。expires_at 和新增的 next_refresh_at 始终为 null（保留以兼容线路协议 — 不要据此安排刷新）；响应新增 rotated（布尔值）和 lifetime（字符串）。服务端绝不会自行轮换，也不会在你主动轮换之前发送 token_refresh；4001 关闭码表示“重新签发”（订阅失效或已轮换），绝不表示定时刷新。建议在 WebSocket 握手中使用 Authorization: Bearer <token> — ?token= 仍然可用，并会在访问日志中遮蔽。 1.24.0 新增 — 代币锁定与归属计划、即将解锁，以及 pump.fun 创建者费用分成 / 领取。 新增五个工具（均为 PRO+，仅支持 msk_ API 密钥 — 无 x402 路由）。madeonsol_token_locks 绑定 GET /tokens/{mint}/locks：列出某个 mint 上所有链上锁定 / 归属合约（Streamflow、Jupiter Lock、Bonfida vesting），包含时间表、条款（cancelable_by_sender = 锁定方可以取回代币 — 资金是相对于接收方而非锁定方锁定的），以及根据实时数据计算的视图（locked_*、claimable_*、next_unlock），并提供包含未来 7 天 / 30 天解锁总量的 summary。madeonsol_token_locks_feed（GET /tokens/locks）是跨代币的新合约动态流（游标 pagination.next_since，或通过 WS 频道 token:locks 推送）；madeonsol_token_unlocks（GET /tokens/unlocks）列出 1 小时至 90 天范围内即将发生的解锁事件（cliff / period / final / tranche），可按 soonest / largest_usd / largest_pct 排序。不包含 LP 锁定 — 仅包含代币 / 归属锁定。madeonsol_token_fee_shares（GET /tokens/{mint}/fee-shares）解码 pump.fun 币的链上 SharingConfig — 包含股东及其 share_bps、is_admin、is_social_pda（分配给某个 X 身份的费用：social.platform 2 = X，user_id = 数字平台 ID，而非用户名）、redirected_bps、is_default: true = 100% 分配给创建者 — 以及分配汇总和配置历史；madeonsol_token_fee_claims（GET /tokens/fee-claims）是费用事件动态流（distribution，包含每个地址的 payouts[]、social_claim、shares_created/updated/reset、creator_transferred，以及仅在通过 type= 请求时返回的 creator_claim），通过 WS 频道 token:fee_claims 推送。费用事件历史从 2026-08-17 开始。 所有基本单位金额均为数字字符串；如果小数位数或价格未知，ui / usd / pct 为 null。

1.23.0 新增 — 实时持有者普查：精确持有者数量、带标签的持有者，以及明确命名而非仅被排除的池。 新增的 madeonsol_token_holders 工具绑定 GET /tokens/{mint}/holders（PRO+）：从账本读取 mint 的所有代币账户（状态为 confirmed），并按持有者合并，因此 concentration.holder_count 是精确值（不同的非零持有者数量，减去池 / 联合曲线 / 销毁地址） — 绝非根据交易推算的估值；只有在服务提供方拒绝对超大市值代币进行普查时，值才会是 null，此时会返回前 20 名视图，并在 source.census_fallback_reason 中说明原因。每个公开的持有者都带有我们的标签（deployer / kol / early_buyer / bundle / bot / dump_cluster — 标签为空表示我们不了解其身份，并不代表其持有者没有问题）；excluded[] 会列出从流通量分母中排除的对象：reason = pool（带有 dex 和 pool_address）、bonding_curve（pump.fun / LaunchLab）、burn，或者仅在确实无法归属 PDA 时为 program_account；pool_pct / burned_pct / program_pct 会细分排除项。金额是原始 u64 字符串。披露范围：PRO 排名前 1–10，ULTRA 排名前 1–50，BUSINESS 排名前 1–100 — 计算方式不受套餐等级影响。大型代币的上游扫描需要 5–30 秒：扫描完成并写入缓存期间，会返回 503 holder_scan_in_progress 和 retry_after_seconds: 20；之后重试可立即完成。 1.22.0 新增 — 成交明细中显示两个价格，默认值也已改为正确的价格。 成交明细现在会告诉你一笔交易的实际成本。每笔交易中的 price_sol/price_usd 是该笔交易的实际成交价，即 sol_amount / token_amount，与同一行中的金额以及 PnL 端点完全一致。由于 sol_amount 是钱包净 SOL 变动，因此这是交易者的全包有效汇率：包括兑换手续费和任何账户租金，而不是池子的中间价。市值追踪器使用的规范池价已移至新的 market_price_sol/market_price_usd 字段；它在每次池更新时对每个代币采样一次，因此同一 slot 中的每笔交易都使用相同的价格。此前，price_sol 携带的是该规范价格，与行内金额不符，差异中位数为 7.9%（p90 约为 74%）：在上涨行情中，过时的市场价格会显得偏低；在下跌行情中则会显得偏高，因此对成交明细中的价格取平均会继承这种偏差，而不会相互抵消。成本基础、成交和 PnL 请使用 price_sol；若要获取不受交易规模和方向影响的单代币价格序列，请使用 market_price_sol。madeonsol_token_trades 和 madeonsol_wallet_trades 都包含这四个字段，两个工具的描述也都明确说明了该使用哪个价格，避免 Agent 错误地取平均值。

1.21.0 新增 — Deployer Hunter 功能已补全。 API 上已有、但 SDK 尚无绑定的七个新操作：madeonsol_deployer_leaderboard、madeonsol_deployer_stats、madeonsol_deployer_profile、madeonsol_deployer_tokens、madeonsol_deployer_alert_stats、madeonsol_deployer_best_tokens 和 madeonsol_deployer_recent_bonds。请对照 bonding_rate（历史累计）和 recent_bond_rate（滚动统计）来阅读——两者之间的差距才是信号，单独看任何一个数字都不够。只有当 labeled_tokens >= 3 时，runner_rate 才有参考意义；对于未追踪的钱包，返回的是计数器归零的资料，而不是 404，因此在将 0% 的成键率视为过往表现之前，请先检查 total_deployed。依赖版本范围现在限定为实际测试过的版本（@x402/* ^2.x、@solana/kit ^5.5.1），而不是开放范围 >=0.0.1；延迟导入的 x402 对等依赖也已标记为可选，因此带密钥安装时不再拉取整套 Solana 技术栈。 1.20.0 新增 — 代币深度 / 价格影响 + 风险数据中的部署者自我交易。 新增工具 madeonsol_token_depth（GET /tokens/{mint}/depth）——按池计算价格影响 / 滑点：“需要多少 SOL 才能让该代币价格变动 N%”，逐池计算（并非路由器最优结果）。最多传入 8 个 SOL 买入 sizes（每个值 >0 且 ≤10000；默认值为 [0.5, 1, 5, 10]）；每个可计算的池都会返回 spot_price_sol、fee_pct、每个 size 对应的 quotes[] 条目（size_sol、tokens_out、avg_price_sol、price_impact_pct），以及 to_move_price——使价格变动 1% / 5% / 10% 所需的 SOL。恒定乘积 AMM 的数据来自流式储备（source: "stream"，附带 reserves_age_ms）；pump.fun / bonk 联合曲线则通过读取曲线虚拟储备的实时数据获得（source: "live_rpc"）。无法如实计算价格的池——集中流动性 CLMM / Orca / DLMM、Meteora-DBC 曲线、未分类模型——会在 unsupported_pools[] 中返回并附带 reason（例如 concentrated_liquidity_depth_not_supported、curve_graduated_use_amm_pool），而不是返回错误数字；primary_pool 表示深度最大的可计算池，found: false 表示没有具备足够权威数据的池可用于计算深度（请参阅 unsupported_pools[].reason；已跟踪的池仍可能列在其中）。仅限 PRO / ULTRA。此外，madeonsol_token_risk 现在会在顶层返回 dev 块（部署者自我交易；mint 没有部署者流水线记录时为 null）：创建交易的自买快照（buy_sol、buy_tokens、buy_supply_pct）、创建后的汇总（bought_tokens_after——可捕捉创建快照显示为 0 的同一秒独立交易开发者买入——sold_tokens、sold_sol、first_sell_at / last_sell_at）、链上实时持仓（holdings_tokens、holdings_supply_pct——pump.fun 使用 1B 分母，其他情况为 null——wallet_empty：开发者钱包当前是否为空），以及 transferred_out（未通过卖出离开的代币数量；null = 未知，绝不猜测），另有 as_of。deployer:alert webhook / WS 负载新增 dev_buy_sol + dev_buy_supply_pct。

1.19.0 新增 — 批量钱包分类 + 代币交易记录 + 扩大的免密目录。 新增工具 madeonsol_wallet_batch_classify——一次调用即可查询 1–100 个钱包的信誉标记（计为一次请求）：每个钱包返回 is_sniper / is_bundler / is_dumper / is_kol（及 kol_name）、bot_confidence（字符串枚举 none / low / medium / high，未纳入 alpha 跟踪时为 null），以及 dump_cluster 块（dump_cohorts、runner_cohorts、total_cohorts、as_of）。这些标记仅适用于 pump.fun 流水线：false = 未观察到，并非已验证无风险；is_bundler 为全时段数据，is_dumper 为滚动 42 天数据。新增工具 madeonsol_token_trades——按 mint 分页的游标式交易记录（实时数据流的回填补充）：tx_signature、wallet_address、action、sol_amount、token_amount、price_sol / price_usd、early_buyer_rank、slot、block_time、traded_at；过滤条件为 action / wallet / since–until（默认完整历史记录——数据采集始于 2026-04-12），另有 coverage 说明块。两者均仅限 PRO / ULTRA。madeonsol_wallet_stats 标记新增 is_sniper / is_bundler / is_dumper + dump_cluster，且 bot_confidence 现在已正确标注为字符串枚举（之前文档误标为数字，且因服务端错误始终返回 null——现在会返回实际值）。madeonsol_token_risk 输入和 madeonsol_sniper_recent 部署现在新增基于 slot 时间窗口的 sniper_footprint / footprint 汇总（buys、buyers、sol、supply_pct、sniper_wallet_buys、data_available、as_of——null = 无法观测，并非 0）。免密 x402 目录从 18 个端点扩充至 25 个：代币 K 线（$0.01）、即将绑定（$0.01）、顶级交易者（$0.02）、持有人分布（$0.02）、近期狙击手（$0.01）、代币流量（$0.01）、部署者轨迹（$0.01）——madeonsol_sniper_recent 和 madeonsol_deployer_trajectory 现在也可通过 x402 免密使用。

1.18.0 新增 — 经链上验证的钱包持仓。 新增工具 madeonsol_wallet_holdings——直接从链上读取钱包的当前持仓：其实际 SPL + Token-2022 代币账户和 SOL 余额，每项数据均补充了我们的 price_usd / value_usd / market_cap_usd / name / symbol / is_bonded，以及 transfer_delta（链上数量 − 根据交易推算的净持仓；可揭示空投、内部人士注资和钱包跳转等非兑换流动）。它不同于 madeonsol_wallet_positions（根据交易以 FIFO 推算）：此工具返回钱包当前实际持有的资产。参数：limit（1–500，默认 200）、min_value_usd（默认 0）。返回 { address, sol_balance, holdings[], summary, verified_at, trade_window_days, cache_hit, ttl_seconds }。仅限 ULTRA。

1.17.0 新增 — 捆绑群组持仓。 新增工具 madeonsol_token_bundle——查询哪些在同一 slot 买入代币的“捆绑”钱包，以及它们仍持有多少供应量（这是基于已确认链上数据的既有持仓“当前持有比例”拉盘 / 内幕信号）。返回一个 bundle 块（wallet_count、bundle_kind atomic_tx / same_slot / none、held_ratio、held_pct_of_supply——核心指标，即净持仓 / 流通供应量；未知时为 null——fully_exited、buy_volume、tokens_held），以及一个 wallets[] 数组（rank、wallet、held_ratio、has_sold、atomic、is_kol）。BASIC 仅获取 bundle 块（wallets[] 为空）；PRO 会额外返回带标记的前 10 个钱包；ULTRA 会返回完整群组及补充身份信息（kol_name、win_rate、bot_confidence、tokens_held）。

1.16.0 新增 — 批量风险评分 + 实时流会话控制。 新增工具 madeonsol_tokens_batch_risk——一次调用即可对最多 50 个 mint 进行批量 rug 风险 / 安全评分，返回与 madeonsol_token_risk 相同的逐 mint 数据结构（0–100 分、band、可解释的 factors[]、原始 inputs），并附带 as_of 时间戳；未跟踪的 mint 会返回 { mint, error: "not_tracked" }，不会导致整个批处理失败，且整次调用仅计为配额中的一次请求。此外还新增两个 WebSocket 会话工具：madeonsol_stream_sessions_list（列出你的实时会话——id、service、tier、channels、connected_at、remote_ip、messages_sent）和 madeonsol_stream_session_kill（按 id 强制断开会话以释放连接名额，例如断开失效套接字）。仅限 PRO / ULTRA。

1.15.0 新增 — 即将绑定代币发现 + 趋势排序。 新增工具 madeonsol_almost_bonded——发现接近毕业的 pump.fun 绑定前代币，并按速度（Δ进度 / 分钟）排序：“95% 且加速”优先于“92% 且停滞”。每个代币都包含 progress_pct、velocity_pct_per_min、eta_minutes、stalled、real_sol_reserves、market_cap_usd、liquidity_usd、authorities_revoked、deployer_tier 和 age_minutes。参数：min_progress、max_progress、min_velocity_pct_per_min、max_age_minutes、deployer_tier、authority_revoked、min_liq、sort（velocity_desc / progress_desc / eta_asc）、limit。仅限 PRO / ULTRA。此外，madeonsol_tokens_list 新增四种动量排序方式——mc_change_5m_desc、mc_change_1h_desc、volume_1h_desc 和 trending（近期交易量 × 正向动量的综合排名）。

1.14.0 新增 — 代币交易流量。 新增工具 madeonsol_token_flow——按 1h / 24h 时间窗口汇总交易流量（自然交易量与虚假交易量）：unique_wallets / unique_buyers / unique_sellers、buy_count / sell_count / total_trades、buy_sol / sell_sol / net_sol（卖出 − 买入；正值 = SOL 净流出池），以及 trades_per_wallet（刷量交易代理指标）。仅限 PRO / ULTRA。部署者提醒（madeonsol_deployer_alerts）现在会包含 deployers.deployer_sol_balance——提醒发出时部署者钱包的 SOL 余额（历史记录中为 null）。

1.13.0 新增 — 代币 OHLCV K 线。 新增工具 madeonsol_token_candles——从链上交易数据流汇总历史价格 K 线（1m / 5m / 15m / 1h / 4h / 1d）。每根 K 线包含 t/open/high/low/close/volume_usd/trades/market_cap_usd。PRO 返回最近 30 天的 OHLCV；ULTRA 还会增加买入 / 卖出量及笔数拆分、净流量、MEV 交易量、开盘 / 收盘流动性、最高 / 最低 MC，以及完整历史记录。仅限 PRO / ULTRA。

1.12.0 新增 — 代币风险评分。 新增工具 madeonsol_token_risk——提供透明的 0–100 rug 风险 / 安全评分（分数越高，风险越大），以及 band（安全 / 谨慎 / 危险）、可解释的 factors[] 数组和原始 inputs（mint / 冻结权限、流动性、流动性与 MC 比率、转账费用、发行批次、部署者绑定率、KOL 信号、黑名单）。仅限 PRO / ULTRA。

1.11.0 新增 — madeonsol_tokens_list 新增三个过滤参数：min_liq_mc_ratio、max_liq_mc_ratio 和 deployer_tier。响应条目现在包含 liquidity_to_mc_ratio 和 deployer_tier。新增工具：madeonsol_signal_performance——在采取行动前评估信号的有效性（命中率、样本量、中位结果）。KOL 排行榜条目现在包含 median_hold_minutes_30d 和 percentile_early_entry_30d。

1.10.4 新增 — 部署者提醒 / 资料现在会公开 runner_rate + labeled_tokens（部署者已标记代币中上涨而非抛售的比例；仅当 labeled_tokens ≥3 时使用），以及 avg_time_to_bond_minutes。 1.10.3 新功能 — 检测抛售集群。 madeonsol_token_buyer_quality 的细分结果现在包含 dump_cluster_count（前 20 名中有 3 个或更多抛售集群钱包 → 历史抛售率为 94%，而基准值为 61%）和 recycled_early_buyer_count。所有套餐级别均会返回完整细分结果。此外，API 现在会实时推送每个 pump.fun 毕业事件（token:graduations WS 通道）。

1.10 新功能 — Deshred 狙击手提醒。 madeonsol_sniper_recent 会通过 shred 级数据，在链上确认前约 500 毫秒展示 pump.fun 部署。PRO：优质／良好部署者。ULTRA：所有级别 + 自定义关注列表。使用 sniper:deploys WebSocket 或 sniper:deploy webhook 接收实时推送。

1.9 新功能 — 价格提醒、侦察员排行榜、协同行为历史记录。 madeonsol_price_alerts_* CRUD（PRO=5，ULTRA=25）。madeonsol_scout_leaderboard 根据首次触达后的跟进率为顶级侦察员排名。madeonsol_coordination_history 和 madeonsol_peak_history 提供历史记录。madeonsol_wallet_stats 现在会返回 derived：win_rate、roi、verdict、biggest_miss。

1.8 新功能 — 通用钱包 API。 madeonsol_wallet_stats、madeonsol_wallet_pnl、madeonsol_wallet_positions、madeonsol_wallet_trades — 为任意 Solana 钱包提供 FIFO 成本基础损益和支持游标分页的原始交易。PRO 及以上套餐可用。命中缓存不会计入配额。

1.7.0 新功能 （2026-05-12） — 新增两个工具：madeonsol_me（账户／配额查询 — 无需解析速率限制标头，即可查看套餐级别、剩余请求次数和各项功能用量）和 madeonsol_tokens_list（PRO 及以上套餐可用的筛选式、可排序代币目录 — 市值区间、最低流动性、主要 DEX、权限／安全标记，以及计算得出的 1 小时交易量／MEV 份额／市值变化增量）。代币响应现在会公开 velocity / MEV-share 字段。代币目录默认设置 min_liq=2000，以跳过虚假的微量市值代币 — 传入 min_liq=0 可关闭此限制。/token/{mint} 现在会返回结构化 400 错误（code / reason / example / docs），而不是纯文本。KOL／alpha 排行榜中的弃用字段 avg_entry_mc_usd 已彻底移除。

4.0.0 新功能（重大变更）： 狙击工具需要 ULTRA、BUSINESS 或 ENTERPRISE API 密钥；在无密钥（x402）模式下，请求会在付款前被拒绝，因为服务器已于 2026-10-06 停用无密钥狙击端点（HTTP 410，不会扣费）。

通过 Smithery 安装（一行命令）

Smithery 是最简单的安装方式 — 它会为你写入配置并处理安装：

npx -y smithery mcp add madeonsol/solana-kol-intelligence

Smithery 会提示你输入 MADEONSOL_API_KEY（可在 madeonsol.com/pricing 免费获取），并为你配置 Claude Desktop 或你选择的 MCP 客户端。重启客户端后，询问：“KOL 现在正在买入什么？”

你也可以通过命令行浏览工具：

npx -y smithery tool get madeonsol/solana-kol-intelligence madeonsol_kol_feed

快速开始 — 手动配置（10 秒）

npm install -g mcp-server-madeonsol

将以下内容添加到 claude_desktop_config.json 或 Cursor MCP 设置中（https://madeonsol.com/pricing 提供免费套餐）：

{ "mcpServers": { "madeonsol": { "command": "mcp-server-madeonsol", "env": { "MADEONSOL_API_KEY": "msk_..." } } } }

重启 Claude Desktop 并询问：“KOL 现在正在买入什么？”

AI Agent 快速入门（x402 / 按次付费）

正在构建自主 Agent？无需注册。配置一个已充值的 Solana 钱包和明确的支付预算。付费工具调用会通过 x402 在该预算范围内授权小额支付——无需 API 密钥、无需账户，也无需费心应对速率限制。

{
  "mcpServers": {
    "madeonsol": {
      "command": "mcp-server-madeonsol",
      "env": {
        "SVM_PRIVATE_KEY": "<base58 solana private key>",
        "X402_PAY_TO": "GLu63pRCYrp4BJu5P5ciYKxgeZFW9c8TJ8jWzK3TB9AR",
        "X402_FEE_PAYER": "2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4",
        "X402_MAX_AMOUNT_ATOMIC": "20000",
        "X402_MAX_TOTAL_AMOUNT_ATOMIC": "1000000",
        "SVM_RPC_URL": "https://<your-trusted-solana-rpc>"
      }
    }
  }
}

工作原理：

• SVM_PRIVATE_KEY 背后的钱包会将每次请求结算为 Solana 上的 USDC 小额支付（每次调用约 $0.005–$0.02，并在链上结算）。无需订阅；支出上限由配置的授权预算限定。

• 阅读 /api/x402，查看当前无需密钥的目录和价格。Sniper 仅支持 API 密钥。

• 免费的 madeonsol_discovery 工具无需身份验证，会返回所有端点及其准确的单次调用价格——先调用它，了解各工具的费用。

• 在服务旁安装 x402 对等依赖（仅此模式需要）：

  npm install -g mcp-server-madeonsol @x402/fetch @x402/svm @x402/core @solana/kit @scure/base
  

仅提供数据。 MadeOnSol 返回交易情报——不会进行交易、签署兑换，也不会托管资金。你的钱包唯一需要支付的费用就是按次收取的数据费用。

想要固定月费、免费套餐或不使用钱包？请使用下方的开发者路径。

必需的支付策略（不兼容的免密升级）

Solana 免密支付要求明确指定可信商户、支付中介和授权预算。API 密钥模式不变，且优先于已配置的钱包。

仅允许使用主网 USDC 进行精确金额支付。请从可信运营方配置中设置这两个地址，不要依赖服务器质询。SVM_RPC_URL 必须是你信任的 HTTPS RPC；不会回退到公共 RPC。Agent 钱包不能同时作为支付中介的手续费付款方。

设置项	含义
X402_PAY_TO	接收 USDC 的可信商户钱包
X402_FEE_PAYER	支付交易手续费的可信支付中介钱包
X402_MAX_AMOUNT_ATOMIC	每笔支付的最高金额，必须是正整数字符串
X402_MAX_TOTAL_AMOUNT_ATOMIC	生命周期授权额度，必须是正整数字符串
SVM_RPC_URL	明确指定的可信 HTTPS Solana RPC URL

USDC 使用 6 位小数：20000 = 0.02 USDC，1000000 = 1 USDC。请设置足以覆盖计划使用端点的限额；这些示例不构成价格保证。

MadeOnSol 的规范值（Solana 主网 USDC）。 此处固定了这些值（GitHub 和 npm README），因此你无需从 402 响应中获取：

• 商户 payTo / X402_PAY_TO：GLu63pRCYrp4BJu5P5ciYKxgeZFW9c8TJ8jWzK3TB9AR（也显示在 https://madeonsol.com/x402 和 https://madeonsol.com/.well-known/x402）
• 支付中介 feePayer / X402_FEE_PAYER：2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4。这是 PayAI（MadeOnSol 使用的第三方支付中介）的手续费付款方。如果 PayAI 更换该地址，免密调用将失败并默认拒绝（客户端拒绝签名），直至你更新此值；MadeOnSol 发布新版本时会公布新地址。
• 价格：Solana 端的价格为 5000–20000 原子单位（0.005–0.02 USDC），因此 maxAmountAtomic / X402_MAX_AMOUNT_ATOMIC 必须至少为 20000，才能使用所有端点。

预算按客户端实例 / 进程计算：不适用于整个钱包，不在进程间共享，并会在启动新实例或进程时重置。免密模式要求基础 URL 必须准确为 https://madeonsol.com。

在并发调用获得批准 / 签名之前，会预留额度；未签名的拒绝会释放额度；开始创建支付后，即使 RPC、签名或付费响应失败，额度也会保留。它衡量的是授权尝试次数，而非已结算支出。不会自动退款或重放支付。超时无法撤销已发送的证明。

额度按服务进程计算；重启后会启用新的额度。请复用正在运行的进程。多个 MCP 服务或其他客户端若共享同一个钱包，需要使用外部共享预算。缺少或无效的免密设置会导致启动失败；钱包签名仍仅限于标准输入输出。支付尝试超时默认为 30 秒。

身份验证

有两种选项（按优先级排序）：

方法	环境变量	最适合
MadeOnSol API 密钥（推荐）	MADEONSOL_API_KEY	开发者 — 获取免费密钥
x402 微支付	SVM_PRIVATE_KEY	使用 Solana 钱包的 AI Agent

v1.0 重大变更： 已移除 RapidAPI 身份验证（RAPIDAPI_KEY）。MadeOnSol RapidAPI 市场已于 2026-04-19 退役。请在 madeonsol.com/pricing 获取免费的 msk_ 密钥。

安装

npm install -g mcp-server-madeonsol

仅在使用 SVM_PRIVATE_KEY 时才需要 x402 对等依赖项（@x402/fetch @x402/svm @x402/core @solana/kit @scure/base）。

配置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "madeonsol": {
      "command": "mcp-server-madeonsol",
      "env": {
        "MADEONSOL_API_KEY": "msk_your_api_key_here"
      }
    }
  }
}

Cursor

使用相同的命令和环境变量添加到 MCP 设置中。

私有 HTTP 传输（SEC-02）

Claude Desktop、Cursor 和其他本地 MCP 客户端仍默认使用 Stdio。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，或使用位于同一可信网络命名空间中的客户端。

工具

KOL 情报

工具	描述
madeonsol_kol_feed	实时 KOL 交易动态（1,000+ 个钱包）
madeonsol_kol_coordination	多个 KOL 的汇聚信号（v1.1）——密度峰值窗口、退出检测、0-100 分
madeonsol_kol_first_touches	首次触达 KOL 事件——经回测验证的侦察信号。可按侦察员级别、胜率、代币年龄和铸造地址后缀筛选
madeonsol_kol_leaderboard	KOL 盈亏和胜率排名（180 天历史记录；周期：今天、7d、30d、90d、180d）
madeonsol_kol_pairs	KOL 关联矩阵——哪些 KOL 会共同交易相同的代币
madeonsol_kol_hot_tokens	KOL 动量代币——买入意愿不断增强
madeonsol_kol_trending_tokens	按 KOL 买入量排名的代币（5m–12h 窗口）。ULTRA 还会提供完整的 KOL 钱包地址。
madeonsol_kol_pnl	深度钱包级盈亏：权益曲线、风险指标、已平仓头寸。ULTRA 还会提供未平仓头寸（已买入但尚未卖出的代币）。
madeonsol_kol_timing	KOL 入场/离场时机概况——所有级别均可使用

部署者追踪

工具	描述
madeonsol_deployer_alerts	经 KOL 信息补充的 Pump.fun 部署者发币动态。可按级别（精英/良好/中等/新兴/冷门）筛选。ULTRA 解锁完整分页。每条提醒的 deployers 现在包含 deployer_sol_balance——提醒发出时部署者钱包的 SOL 余额（历史记录为 null）。
madeonsol_deployer_trajectory	部署者技能曲线——连胜记录、滚动绑定率、趋势——所有级别均可使用
madeonsol_deployer_history	Pump.fun 部署者的每日声誉时间序列（每天记录 bonding_rate、recent_bond_rate、tier、avg_peak_mc）——可在发币时回测部署者信号，避免前视偏差。limit 为 1–365（默认值为 90）

早期狙击观测（ULTRA/BUSINESS/ENTERPRISE）

根据 shred 级（deshred）数据重建的 Pump.fun 确认前部署动态——发币信息会在链上确认前 ~500ms 出现。Pro 可查看精英/良好级部署者；Ultra 可查看所有级别。

工具	描述
madeonsol_sniper_recent	面向 ULTRA/BUSINESS/ENTERPRISE API 密钥的早期部署观测。无 x402；不保证提前量。观测结果不代表已执行交易。
madeonsol_sniper_by_deployer	单个部署者钱包的 Deshred 部署记录（Ultra）

钱包追踪器

工具	描述
madeonsol_wallet_tracker_watchlist	列出已追踪的钱包和剩余容量（Pro：50，Ultra：100，Business：500；Free 级别不提供钱包追踪器）
madeonsol_wallet_tracker_add	将钱包添加到关注列表
madeonsol_wallet_tracker_remove	从关注列表中移除钱包
madeonsol_wallet_tracker_trades	已关注钱包的历史兑换/转账事件（保留 120 天）。返回 events[] + next_cursor / next_cursor_slot。action 为 buy 或 sell（仅限兑换；转账的 action: null，使用 event_type: transfer 筛选转账）。order = slot（默认值）或 block_time；使用 before_slot 或旧版参数 before 翻页
madeonsol_wallet_tracker_summary	钱包级统计：兑换次数、买入/卖出的 SOL 数量、最后一次事件

通用钱包 （1.8 新增 — 适用于任何钱包，而不仅限于精选 KOL，PRO+）

工具	描述
madeonsol_wallet_stats	汇总 90d 统计数据 + 跨产品标记（is_kol、is_alpha_tracked + bot_confidence none/low/medium/high、is_deployer + tokens_deployed，1.19 新增： is_sniper / is_bundler / is_dumper + dump_cluster 群组）——快速评估未知钱包
madeonsol_wallet_batch_classify	1.19 新增 · 一次调用即可批量获取 1–100 个钱包的信誉标记——is_sniper/is_bundler/is_dumper/is_kol + kol_name、bot_confidence、dump_cluster。范围仅限 Pump.fun 流水线：false = 未观测到，并非已验证为干净
madeonsol_wallet_pnl	完整 FIFO 成本基础损益：已实现 + 未实现 SOL、利润因子、最大回撤、平均 + 中位持有分钟数、每日 UTC 损益曲线，以及根据实时 mc-tracker 价格补充信息的已平仓 + 未平仓头寸
madeonsol_wallet_positions	仅未平仓头寸——/pnl 的精简版本。共享同一缓存。
madeonsol_wallet_holdings	1.18 新增 · 已验证的当前链上持仓（真实 SPL + Token-2022 账户 + SOL），补充价格/MC/名称信息，并提供与交易推算头寸的对比 transfer_delta。仅限 ULTRA。
madeonsol_wallet_trades	支持游标分页的原始交易，可按 action / token / since-until 筛选

服务端缓存，TTL 根据最近活动动态调整（5min / 1h / 24h）。仅可在 90 天窗口内查看成本基础。

Alpha 钱包情报

基于 150 万余条早期买家记录评分（在 Pump.fun 代币前 20 位买家中出现过的钱包）。

工具	层级	描述
madeonsol_alpha_leaderboard	所有	盈利能力最强的早期买家钱包。Free/Pro 最多支持 100 个；ULTRA 可解锁 500 个 + 机器人信号
madeonsol_alpha_wallet	ULTRA	按代币提供完整明细 + bot_signals 数组
madeonsol_alpha_linked	ULTRA	行为上存在关联的钱包（在 2 秒内共同购买 3 个以上代币）

代币质量

工具	套餐等级	说明
madeonsol_tokens_list	PRO+	可筛选、可排序的代币目录——MC 区间、流动性下限、主要 DEX、权限/安全标记、计算得出的 1h 交易量 / MEV 占比 / MC 变化幅度，以及动量排序（mc_change_5m_desc、mc_change_1h_desc、volume_1h_desc、trending）。默认 min_liq=2000，跳过虚假 MC 的低价值代币。
madeonsol_almost_bonded	PRO+	接近毕业的预绑定 pump.fun 代币，按速度（Δ进度/分钟）排序——progress_pct、velocity_pct_per_min、eta_minutes、stalled、deployer_tier、age_minutes
madeonsol_token_cap_table	PRO+	首批非部署者早期买家，附带 PnL/KOL/机器人标记。PRO=10，ULTRA=20
madeonsol_token_buyer_quality	All	0–100 买家质量评分 + 完整明细（缓存 5 分钟）
madeonsol_token_risk	PRO+	透明的 0–100 风险评分（依据证据，而非结论），包含 band、可解释的 factors[] 和原始 inputs（1.19 新增：inputs.sniper_footprint——基于槽位窗口的狙击汇总，null = 无法观测；**1.20 新增：**顶层 dev 块——创建时部署者自买、卖出汇总、链上实时持仓、wallet_empty、transferred_out）
madeonsol_token_bundle	All	同槽位捆绑群组持仓——哪些同槽位捆绑钱包买入了某代币，以及目前仍持有多少供应量（重点显示 held_pct_of_supply，另含 bundle_kind、held_ratio、fully_exited）。BASIC：仅捆绑信息块。PRO：前 10 名标记。ULTRA：完整群组 + 身份信息
madeonsol_token_pools	PRO+	按交易场所划分的流动性地图——代币进行交易的所有 DEX 池（pump.fun/PumpSwap/Raydium/Meteora/Orca），含各池的 liquidity_usd、is_active（活跃或闲置），以及 summary（池/DEX 数量、total_liquidity_usd、primary_pool、top_pool_share_pct 集中度）
madeonsol_token_depth	1.20 新增 · PRO+	各池价格影响 / 滑点——按 SOL 买入金额列出 quotes[]（tokens_out、avg_price_sol、price_impact_pct）+ to_move_price（使价格变动 1%/5%/10% 所需的 SOL）。sizes 最多 8 个，默认 [0.5, 1, 5, 10]；不支持的池（CLMM/DLMM/DBC）会标记 reason
madeonsol_token_holders	新增 · PRO+	实时持币者普查 + 集中度——当前持有人（不同于 madeonsol_token_cap_table，后者列出最早买入者）。concentration.holder_count 为精确值（按 mint 范围执行 getProgramAccounts 普查，再按所有者合并；仅当提供方拒绝处理超大市值代币时才为 null，此时会回退到前 20 名，并提供 source.census_fallback_reason，绝不使用交易估算值）。每个披露的所有者都会标记为 deployer / kol / early_buyer / bundle / bot / dump_cluster（空值 = 未知，并非确认安全）。流动性池 / 绑定曲线 / 销毁账户不计入流通量分母，并在 excluded[] 中列明（reason：pool + dex + pool_address、bonding_curve、burn、program_account）；amount_raw 为原始 u64 字符串。披露数量：PRO 10 / ULTRA 50 / BUSINESS 100。大型代币：首次调用可能返回 HTTP 503 holder_scan_in_progress（retry_after_seconds: 20）——扫描会继续并缓存，重试即可立即返回
madeonsol_token_locks	1.24 新增 · PRO+	mint 上的代币锁定与归属——所有 Streamflow / Jupiter Lock / Bonfida 合约：program、kind（锁定 / 归属）、推导出的 status、发送方 / 接收方、时间安排（start_at / cliff_at / end_at、period_seconds）、条款（cancelable_by_sender——锁仓方可提取）、实时 locked_* / claimable_* / next_unlock，以及 summary（锁定 / 存入总额、unlocking_7d_* / unlocking_30d_*、最近的 next_unlock、active_cancelable_by_sender）。筛选条件：status、program、limit ≤500。基础单位金额为字符串；未知时，ui/usd/pct 为 null。不包含 LP 锁仓
madeonsol_token_locks_feed	1.24 新增 · PRO+	跨代币的新建锁定 / 归属合约信息流，按时间从新到旧排列——行结构相同，另含 token {symbol, price_usd, market_cap_usd}。游标 since / before（pagination.next_since / next_before）；筛选条件：mint、sender、recipient、program、kind、status、min_usd、min_pct_of_supply、include_estimated（回填的 Jupiter 行）。推送：WS 通道 token:locks（事件 token:lock）
madeonsol_token_unlocks	1.24 新增 · PRO+	所有活跃合约在 within = 1h–90d 时间范围内的即将解锁事件——每个合约一条记录，显示其下一个 event（cliff / period / final / tranche），含 amount_* + window_amount_*（时间窗口内的总释放量）、token、lock。排序方式：soonest / largest_usd / largest_pct；筛选条件：mint、program、kind、min_usd、min_pct_of_supply；limit ≤200，offset
madeonsol_token_fee_shares	1.24 新增 · PRO+	pump.fun 代币创建者费用的 SharingConfig——shareholders[]（share_bps、is_admin、is_social_pda + social {platform (2 = X), user_id, lifetime_claimed}、received_*）、redirected_bps、social_bps、is_default（100% 归创建者所有）、source stream / chain；distributions 汇总（接收者、历史接收者）、history[]、recent_distributions[]。金额以报价代币基础单位（lamports）表示，格式为字符串。事件历史始于 2026-08-17
madeonsol_token_fee_claims	1.24 新增 · PRO+	pump.fun 费用事件信息流，按时间从新到旧排列——type 为 distribution（含各股东的 payouts[]）/ social_claim（X 身份 → 钱包，mint 为 null）/ shares_created / shares_updated / shares_reset / creator_transferred / creator_claim（除非通过 type= 指定，否则不包含）。筛选条件：type（逗号分隔列表）、mint、recipient、actor、social_platform、social_user_id、min_sol、since / before。推送：WS 通道 token:fee_claims（事件 token:fee_claim）。历史始于 2026-08-17
madeonsol_tokens_surges	1.25 新增 · PRO+	代币动量触发记录，按时间从新到旧排列——kind 为 surge（代币诞生不足 30 min，与其 LAUNCH MC 相比；tier 为 early：≤10 min、≥$12k、≥3×；strong：≤30 min、≥$30k、≥6×且达到 3-min 低点的 ≥2×；breakout：≤2 min、≥$45k、≥8×；每个 mint 只触发一次，且须持续 ≥10 s）或 revival（无交易蜡烛图 ≥24 h，之后在成交记录中出现 ≥5 笔买入 / ≥$500 买入量 / 高于休眠前 MC ≥1.5×——绝非价格标记；tier 为 null）。每行包含爆发期 tape（交易覆盖范围外时 unique_buyers 为 null）、kol、early_buyers（捆绑 / 已卖出 / 狙击）、deployer、risk_flags[]（空值 = 未触发标记，并非确认安全），以及代币达到 ≥65 min 时提供的 outcome（+1 h MC / 峰值 / 低点）。stats=1 = 按 kind、tier 统计的 days 内命中率。筛选条件：kind、tier、mint、launchpad、deployer_tier、min_mc_usd / max_mc_usd、min_buys、exclude_flags（逗号分隔列表）、only_clean；游标 since / before；limit ≤200。推送：WS 通道 token:surges（事件 token:surge / token:revival）+ webhook 注册表。保留 60 d
madeonsol_tokens_batch_risk	PRO+	批量风险评分（依据证据，而非结论），最多支持 50 个 mint——结构与 madeonsol_token_risk 相同，另含 as_of。未跟踪的 mint 会返回 { mint, error: "not_tracked" }，不会导致整个批次失败；计为一次请求
madeonsol_token_candles	PRO+	历史 OHLCV 蜡烛图（1m–1d）。PRO=30d OHLCV；ULTRA=另含净流量、流动性变化、MEV 交易量和完整历史
madeonsol_token_flow	PRO+	1h/24h window 内的交易流汇总（有机与虚假交易量对比）——独立钱包/买家/卖家、买入/卖出笔数 + SOL、net_sol、作为洗盘交易代理指标的 trades_per_wallet
madeonsol_token_trades	1.19 新增 · PRO+	按 mint 筛选的交易记录——针对单个代币的原始交易，使用游标分页（支持操作 / 钱包 / since–until 筛选，默认提供完整历史）。历史始于 2026-04-12；coverage 块标示覆盖范围

跟单规则（PRO+）

当源钱包交易时触发信号的服务端规则。通过 Webhook（HMAC 签名）和／或 WebSocket 交付。限制：PRO 为 3 条规则 × 5 个源钱包，ULTRA 为 20 × 50，BUSINESS 为 100 × 250（Enterprise 遵循 Business 的限制）。服务端会强制执行你所属套餐的限制。任何有效的 Solana 钱包都可以作为源钱包，无论是否为 KOL（自 2026-10-04 起的服务端行为；KOL 身份是可选的补充信息，跟单源不占用 Wallet Tracker 配额）。每条规则都会报告 source_admission（any_wallet）和 operational_state（eligible，或基础设施状态：monitoring_pending、monitoring_unavailable、source_capacity_unavailable）。按链上时间计算，超过 10 秒的源交易不会执行；每笔交易在每条规则下最多产生一个信号。only_action 默认为 buy。min_mc_usd／max_mc_usd 可将规则（或信号查询）限制在源交易的某个市值区间；设置任一界限后，市值未知的交易会被丢弃。

工具	描述
madeonsol_copytrade_list	列出你的规则
madeonsol_copytrade_create	创建规则（可选 min_mc_usd／max_mc_usd）。webhook_secret 仅返回一次，请妥善保存
madeonsol_copytrade_get	获取一条规则
madeonsol_copytrade_update	更新字段或切换 is_active；将 MC 界限设为 null 可清除该界限
madeonsol_copytrade_delete	永久删除
madeonsol_copytrade_signals	获取最近触发的信号（最长 7 天）。筛选条件：subscription_id、since、limit、min_mc_usd／max_mc_usd

KOL 协同提醒（PRO/ULTRA — v1.1 推送信号）

当一个 KOL 群组同时买入同一代币时，实时推送提醒。在约 1 秒内触发（pg_notify 推送）。通过 WebSocket（kol:coordination 频道，按用户范围推送）和／或 HMAC 签名的 Webhook 交付。

工具	描述
madeonsol_coordination_alerts_list	列出你的规则（PRO=5，ULTRA=20）
madeonsol_coordination_alerts_create	创建规则。webhook_secret 仅返回一次，请妥善保存
madeonsol_coordination_alerts_get	获取一条规则
madeonsol_coordination_alerts_update	更新字段或切换 is_active
madeonsol_coordination_alerts_delete	永久删除

KOL Scout 信号 — 首次由 KOL 触及 (1.3 新增)

每次发生“某个代币 mint 首次被 KOL 买入”事件时触发。可按 Scout 等级（mv_kol_scout_score 中的 S/A/B/C）、KOL 胜率、代币年龄和 mint 后缀筛选。

回测： S 级 Scout 约有 50% 的概率在 4 小时内吸引至少 3 位 KOL 跟进买入，基线约为 14%（38 天／491k 笔买入／72,549 个事件）。公开排行榜：madeonsol.com/kol/scouts。

工具	描述
madeonsol_kol_first_touches	获取最近的 KOL 首次触及事件。筛选条件：min_scout_tier、min_kol_winrate_7d、token_age_max_min、mint_suffix、preset 等。
madeonsol_first_touch_subscriptions_list	列出你的首次触及 Webhook 订阅 — ULTRA
madeonsol_first_touch_subscriptions_create	创建 Webhook 规则（HMAC 签名）。webhook_secret 仅返回一次，请妥善保存。每位用户最多 10 条 — ULTRA
madeonsol_first_touch_subscriptions_get	获取一条订阅 — ULTRA
madeonsol_first_touch_subscriptions_update	更新字段或切换 is_active — ULTRA
madeonsol_first_touch_subscriptions_delete	永久删除 — ULTRA

不要轮询，使用推送。 第二位 KOL 跟进前的中位领先时间为 12 秒。WebSocket 频道：kol:first_touches（PRO+）。

价格提醒 (1.9 版新增)

代币下跌/回升价格提醒的增删改查。当代币市值达到你设置的阈值时触发。PRO 最多 5 条规则，ULTRA 最多 25 条。

工具	描述
madeonsol_price_alerts_list	列出你的价格提醒规则
madeonsol_price_alerts_create	创建下跌/回升提醒。webhook_secret 仅返回一次，请妥善保存
madeonsol_price_alerts_get	按 ID 获取一条提醒规则
madeonsol_price_alerts_update	更新字段或切换 is_active
madeonsol_price_alerts_delete	永久删除

Scout 排行榜与 KOL 共识 (1.9 版新增)

工具	套餐	描述
madeonsol_scout_leaderboard	PRO+	按首次触达后的跟进率、胜率和 ROI 排名的顶级 Scout 级 KOL
madeonsol_kol_consensus	PRO+	KOL 共识信号最强的代币，按 Scout 评分和近期 PnL 加权
madeonsol_peak_history	PRO+	代币的历史峰值密度时段，包含每次协调活动峰值及 KOL 细分情况
madeonsol_coordination_history	PRO+	全局协调事件日志，包含代币、KOL 数量、评分和结果

钱包衍生统计 (1.9 版新增)

madeonsol_wallet_stats 现在会返回一个 stats 对象，其中包含衍生字段：win_rate（0-1）、roi、verdict（"strong" | "profitable" | "neutral" | "losing"）以及 biggest_miss（钱包错过的退出后涨幅最高的代币）。

流式传输与 Webhook

工具	描述
madeonsol_stream_token	获取用于 KOL/部署者流式传输和 DEX 交易流的 WebSocket 令牌 — PRO/ULTRA。永不过期（1.24.1）：每次调用均返回相同令牌；rotate: true 会替换令牌（旧值还可使用 60 秒）；expires_at / next_refresh_at 始终为 null。频道现还包括 token:locks（新的锁定/归属合约，事件 token:lock）、token:fee_claims（pump.fun 费用事件，事件 token:fee_claim）和 token:surges（1.25 版新增 — 代币动量触发，事件 token:surge / token:revival，带有 risk_flags[]；订阅筛选项：kinds[]、tiers[]、launchpads[]、exclude_flags[]、min_mc_usd / max_mc_usd、deployer_tier[]）
madeonsol_stream_sessions_list	列出你的实时 WebSocket 会话 — id、service、tier、channels、connected_at、remote_ip、messages_sent — PRO/ULTRA
madeonsol_stream_session_kill	按 ID 终止实时 WebSocket 会话以释放连接名额（例如，幽灵套接字）— PRO/ULTRA
madeonsol_create_webhook	注册 Webhook 以接收实时推送通知 — PRO/ULTRA
madeonsol_list_webhooks	列出已注册的 Webhook — PRO/ULTRA
madeonsol_delete_webhook	按 ID 删除 Webhook — PRO/ULTRA
madeonsol_test_webhook	发送测试负载以验证 Webhook — PRO/ULTRA

常规

工具	描述
madeonsol_discovery	列出所有端点和价格（免费，无需身份验证）
madeonsol_me	查看你的账户 — 套餐、每日/突发配额状态、剩余请求数、订阅到期时间、各功能用量（Webhook、跟单钱包、协调规则等）。无需解析速率限制标头即可自行控制请求频率。

套餐

套餐	价格	跟踪的钱包数	每日请求数
BASIC（免费）	$0	10	200
PRO	€43/月（€430/年）≈ $49	50	10,000
ULTRA	€131/月（€1310/年）≈ $149	100 + WS 事件	100,000
BUSINESS	€400/月（€4000/年）≈ $449	500 + WS 事件	500,000

免费套餐在 40 多个端点上返回完整的 REST 响应结构，包括真实钱包、TX 签名和完整精度；实时数据流会延迟 5 分钟（延迟响应带有 delay/as_of 字段和 X-Data-Delay 标头）。付费套餐提供实时数据，并解锁 Webhook、WebSocket、规则引擎和仅限 ULTRA 的数据深度；x402 按次付费始终提供实时数据。前往 madeonsol.com/pricing 获取密钥。

Also Available

Platform	Package
TypeScript SDK	madeonsol on npm
Rust SDK	madeonsol on crates.io
Python (LangChain, CrewAI)	madeonsol-x402 on PyPI
ElizaOS	@madeonsol/plugin-madeonsol
Solana Agent Kit	solana-agent-kit-plugin-madeonsol

License

MIT