alphapipeline

AlphaPipeline

面向链上交易 Agent 的交易前安全关卡——买入前检查 rug pull／蜜罐风险，并提供市场／衍生品数据——按次付费（$0.005–$0.03 USDC），无需注册、API 密钥或 OAuth。 在兑换前检查代币的蜜罐／税费／流动性风险，或获取资金费率、DEX 滑点、韩国价格溢价、Polymarket 套利信号，以及 Hyperliquid HIP-4 预测市场赔率。通过 Base 上的 x402 协议（HTTP 402）在单个请求中完成身份验证和支付；也可以从 Claude Desktop、Cursor 或任何 MCP 客户端将其作为远程 MCP 服务调用。

---

为什么选择 AlphaPipeline

AlphaPipeline 是一个面向机器的数据 API。每个端点都通过 x402 按次计费：不带支付标头的请求会收到标准 HTTP 402 响应，其中会准确说明如何支付（资产、金额、网络、收款方）。无需创建账户、使用控制面板或申请 API 密钥——签名后附上支付信息重试请求，即可在同一请求／响应周期中获得数据。

它也以远程 MCP 服务（POST /mcp）的形式提供，因此 Agent 框架（Claude Desktop、Cursor、LangChain、CrewAI，以及任何支持 MCP 的工具）都能发现并调用它，无需编写自定义集成代码。

安全工具组是此 API 中经过实战检验最多的部分。 security.token_risk、security.contract_health_audit 和 security.token_diagnostic 已在 Base 上的真实链上兑换前作为实时安全关卡运行——它们不只是提供参考数据，而是在交易流程中实际作为通过／失败的依据，在资金面临风险前进行检查。这三个工具都不会返回定性结论字段（没有 safe_to_execute: true/false），而是返回原始的 GoPlus／Honeypot.is 数值，并将是否买入的决定留给你自己的代码。

• 发现功能始终免费。 initialize 和 tools/list 无需付费——你可以在决定付费前浏览完整的工具目录。
• 两个工具是永久免费的入门端点（unlocks.dump_risk 和 market.kimchi_alert，见下文），Agent 可在开始为安全工具组及其他工具付费前，用它们验证连接、延迟和响应架构。
• 结算由 Coinbase CDP（Developer Platform）Facilitator 在 Base 主网上处理（eip155:8453），资产为 USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）。

Coinbase 尚未审核这些端点——请在转账前确认你信任它们。

---

快速入门 — 远程 MCP

将以下内容添加到 MCP 客户端的配置中（Claude Desktop 的 claude_desktop_config.json、Cursor 的 .cursor/mcp.json 或同类配置）：

{
  "mcpServers": {
    "alphapipeline": {
      "url": "https://alphapipeline-eu.onrender.com/mcp"
    }
  }
}

tools/list 无需付费即可立即使用。调用收费工具的 tools/call 需要支持 x402 的客户端来签名并重试支付（持有钱包的机器人／Agent 客户端——大多数普通聊天界面都无法自动支付）。请参阅 examples/，其中提供了一个使用官方 x402 SDK 的可运行 Python 客户端。

快速入门 — 纯 REST / x402

curl -s "https://alphapipeline-eu.onrender.com/v1/security/token-risk?chain_id=8453&contract_address=0x..."
# -> HTTP 402, payment terms in the `payment-required` response header (base64 JSON)
# sign a payment, retry with the PAYMENT-SIGNATURE header attached -> 200 + data

**给客户端作者的说明：**此服务使用 x402 v2——402 响应正文为空 {}；实际付款条款（accepts 数组、价格、资产、收款地址）以 base64-JSON 格式放在 payment-required 响应头中，而不是正文中。基于旧版正文格式约定编写的客户端会收到一个没有错误的空对象，而不是明显的失败。请改为解码响应头。

**关于 unlocks.dump_risk 和 market.kimchi_alert 的说明：**这两个工具特意设为免费（无需 x402 付款），作为入门工具——它们提供的是市场背景信息信号，并非经过验证的交易前安全工具组（security.token_risk、security.contract_health_audit、security.token_diagnostic）的一部分；该工具组仍需付费。如果第三方发现目录（例如 x402 Bazaar）仍显示其中某个工具在此更改前的过期非零价格，请以此服务自身的 / 响应和 MCP tools/list 输出为准——它们始终反映实时价格。

**关于工具名称的说明：**MCP 工具名称使用 domain.tool_name 点号表示法（例如 market.kimchi_alert），以便工具列表按域形成可导航的树形结构。/v1/<domain>/... 下的 REST 路径不受此影响，保持稳定。

完整协议参考：/llms.txt · x402 文档

立即试用 — 无需钱包、注册或付款

在接入付费客户端之前，运行 check-my-slippage，看看此服务如何针对生产环境端点返回真实的实时数据：

npx check-my-slippage

真实输出（于 2026-09-18 直接从生产环境捕获，并非模拟样例）：

Checking live Polymarket exit-liquidity via AlphaPipeline...

Market:            will-the-fed-decrease-interest-rates-by-25-bps-after-the-october-2026-meeting-... (sell)
Position size:     500 shares
Executable:        true
Best quote:        $0.0060
Avg exit price:    $0.0060
Price impact:      0%
Data source:       polymarket-clob
Latency:           88ms

Want this for any market/size, in your own bot?
-> https://github.com/parkyucheol-del/alphapipeline

这会调用免费的限流接口（每个 IP 每分钟 10 次）GET /v1/prediction/preview-slippage——无需付款头，无需查询参数，始终针对固定基准市场运行，让你在为 prediction.exit_capacity_audit 付费之前评估数据质量；该工具支持你提供任意市场和规模。如果 npx check-my-slippage 在你的机器上无法运行，请改为直接调用此端点：curl https://alphapipeline-eu.onrender.com/v1/prediction/preview-slippage，或从源码运行：克隆此仓库后，在仓库目录中执行 node check-my-slippage/bin/index.js。

可直接复制的客户端 — DEX 买入前的安全检查关卡

如果你正在构建一个会在 Base 上买入新代币的狙击／发现机器人，这就是我们自己的实战测试机器人（alphapipeline-dogfood-bot）在每次链上购买前使用的硬性、不可绕过的检查模式：支付 $0.03 使用 security.token-diagnostic，然后根据返回的原始字段应用你自己的阈值（此服务不会返回 safe_to_buy: true/false 判定——参见为何选择 AlphaPipeline）。此模式改编自 examples/client_example.py：

# pip install "x402[https]" eth_account httpx
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

API = "https://alphapipeline-eu.onrender.com"

async def is_safe_to_buy(contract_address: str, chain_id: int = 8453) -> bool:
    account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])  # dedicated small wallet only
    client = x402Client()
    register_exact_evm_client(client, EthAccountSigner(account))
    async with x402HttpxClient(client) as http:
        r = await http.get(f"{API}/v1/security/token-diagnostic",
                            params={"contract_address": contract_address, "chain_id": chain_id})
        await r.aread()
        diag = r.json()  # $0.03 USDC charged on Base mainnet — no free tier for this one

    return (
        diag.get("is_honeypot") is not True
        and (diag.get("buy_tax_pct") or 0) <= 10
        and (diag.get("sell_tax_pct") or 0) <= 10
        and diag.get("liquidity_health") in ("LOCKED", "PARTIALLY_LOCKED")
    )

if __name__ == "__main__":
    print(asyncio.run(is_safe_to_buy("0xYourTargetTokenContract")))

请根据自己的风险承受能力调整阈值（买入／卖出税率、可接受的 liquidity_health 值、risk_flags_count 等）——完整字段列表见下方 security.token-diagnostic 架构。这正是我们的实战测试机器人对每个候选代币运行的逻辑；只有通过检查后，它才会花费真实的 USDC。

---

工具 / 端点

工具（MCP）	REST 端点	价格	功能说明
security.token_prescreen	GET /v1/security/token-prescreen	$0.01	交易前检查，最便宜档 — 批量筛选器：检查 LP 锁定／销毁状态（与 contract_health_audit 使用相同的 GoPlus 调用，不增加上游成本），并获取 GeckoTerminal 顶级池的 USD 流动性（与 dex.liquidity_slippage 使用相同的数据源），汇总在一个精简响应中。先用它批量筛查候选项，低成本剔除没有真实流动性或 LP 未锁定的项目，然后再只对剩余项目使用 token_risk／contract_health_audit／token_diagnostic。不检查貔貅盘／税费／增发，也不提供 LP 持有者明细 — 相关检查请参见对应工具。当 chain_id 未映射到 GeckoTerminal 时，liquidity_usd 为 null（目前支持 Base、Ethereum、BSC、Polygon、Arbitrum、Optimism、Avalanche）；LP 锁定数据不受影响。
security.token_authenticity	GET /v1/security/token-authenticity	$0.01	交易前检查，最便宜档 — 标记冒充知名主流资产（例如假冒的「USDC」）的合约，使用 GoPlus 的 fake_token／trust_list／honeypot_with_same_creator 字段（与 token-risk／contract-health-audit／token-prescreen 使用相同的 GoPlus 调用，不增加上游成本）。flagged_as_counterfeit: false 并不能证明其真实性 — 这只表示 GoPlus 在查询时未发现此类标记；只有当 flagged_as_counterfeit 为 true 时才会设置 true_token_address。不检查貔貅盘／税费／LP — 相关检查请参见 token_risk／contract_health_audit。这些字段没有 Honeypot.is 回退机制。
security.token_risk	GET /v1/security/token-risk	$0.02	交易前检查 — 买入或兑换前调用：由 GoPlus／Honeypot.is 提供支持的合约安全审计（貔貅盘标记、买入／卖出税、是否可增发、所有权是否已放弃，以及各项 GoPlus 信号 — 无法全部卖出、隐藏所有者、转账可暂停、自毁、是否被列入黑名单、滑点可修改、所有者集中度 — 汇总到 risk_flags 中）。需要筛查大量候选项？在付费使用此工具前，可先用更便宜的 security.token_prescreen（$0.01）进行初筛。
security.contract_health_audit	GET /v1/security/contract-health-audit	$0.02	交易前检查 — LP（流动性池）锁定／销毁审计，复用与 token-risk 相同的 GoPlus 数据：在你信任流动性前，标记流动性是否已锁定、已销毁，或由单个钱包自由持有。需要筛查大量候选项？security.token_prescreen（$0.01）以更低价格复用相同的 LP 锁定检查，并额外提供流动性数值。
security.token_diagnostic	GET /v1/security/token-diagnostic	$0.03	交易前检查 — 在一次调用中汇总 token_risk + contract_health_audit（使用相同的 GoPlus 数据，不会发起新的上游调用），在兑换前提供单一的可行／不可行判断依据。不提供综合评分或字母等级 — 只返回两种工具的字段，以及去重后的 risk_flags 并集。比单独调用两种工具更便宜。需要筛查大量候选项？在付费使用此工具前，可先用更便宜的 security.token_prescreen（$0.01）进行初筛。
dex.liquidity_slippage	GET /v1/dex/liquidity-slippage	$0.02	由 GeckoTerminal 提供支持的 DEX 池流动性和预估交易滑点，还提供固定的 $1k／$5k／$10k slippage_tiers、pool_fee_pct、assumed_gas_cost_usd 估值，以及 quote_token_is_stablecoin（当所选池不是以 USD 报价、需要额外跳转时会标记），方便快速检查市场深度。使用 token_address 调用时，还会返回 direct_stablecoin_pool_exists；若所选池不是以 USD 报价，还会返回 alternate_direct_pool（同一代币的另一个以 USD 报价的池），以便你在兑换前了解是否确实需要多跳路由。
derivatives.whale_position_audit	GET /v1/derivatives/whale-position-audit	$0.02	审计你提供的 Hyperliquid 钱包地址：未平仓头寸、杠杆、max_leverage、清算价格、PnL 和 return_on_equity_pct（后两项为 Hyperliquid 自身报告的字段）。不会发现或排行钱包 — Hyperliquid 的公开 API 没有排行榜端点。
derivatives.funding_rate	GET /v1/derivatives/funding-rate	$0.01	Bybit（主要来源）／Binance（备用来源）的永续期货资金费率，另含 mark_price／index_price（两种来源都会返回）和 open_interest_usd（仅 Bybit 来源返回，Binance 备用来源时为 null）。
derivatives.funding_rate_value	GET /v1/derivatives/funding-rate-value	$0.001	低价档 — funding_rate 的轻量封装：使用相同的缓存调用，仅保留 funding_rate／funding_rate_percentage（不含标记价格／指数价格，也不含未平仓合约量）。不发起新的上游调用。
derivatives.funding_apr_matrix	GET /v1/derivatives/funding-apr-matrix	$0.01	将当前资金费率折算为 APR，并根据假设的往返交易成本计算套利交易的盈亏平衡天数。
arb.spread_matrix	GET /v1/arb/spread-matrix	$0.02	CEX（Coinbase 现货）与 DEX（GeckoTerminal）价差计算器，提供经过 Gas 成本调整的盈利标记，以及 pool_fee_pct（仅供参考 — 不会从价差中扣除）。
prediction.neg_risk_arbitrage	GET /v1/prediction/neg-risk-arbitrage	$0.03	检测 Polymarket 否定风险（互斥、多结果）事件中的组合套利 — 完整的 YES 组合最终结算金额始终为 $1，因此组合价格偏离 $1（扣除成本后）就可能形成近乎无风险的收益机会。还会返回当前实际可执行的流动性瓶颈规模（按 VWAP 定价，而非只看最优档），以及 oldest_book_snapshot_time（各个结果中最旧的订单簿快照时间，是时效性瓶颈）。仅支持 Polymarket。
prediction.exit_capacity_audit	GET /v1/prediction/exit-capacity-audit	$0.02	遍历 Polymarket 某结果的实时订单簿，检查给定头寸规模目前是否确实可以成交，以及平均价格、价格影响、book_snapshot_time／tick_size／min_order_size。可通过 token_id 或精确的 market_slug 解析。
prediction.order_split_guide	GET /v1/prediction/order-split-guide	$0.02	遍历 Polymarket 某结果的实时订单簿，建议将大额头寸拆分成多少笔，以便每笔自身的价格影响不超过 max_price_impact_pct_per_slice（默认 1.0%）；同时提供 full_size_price_impact_pct，作为一次性下单的基准进行比较。基于单个快照计算 — 无法得知真实交易中订单簿是否会在分笔之间补充，详情请参见响应中的 notice 字段。复用 exit_capacity_audit 的订单簿辅助函数，不发起新的上游调用。可通过 token_id 或精确的 market_slug 解析。
prediction.bid_ask_spread_pct	GET /v1/prediction/bid-ask-spread-pct	$0.001	低价档 — 单个 Polymarket 结果的实时最优买卖价差占 mid_price 的百分比。它不衡量流动性或可成交性（相关检查请使用 exit_capacity_audit／order_split_guide）。复用相同的订单簿获取逻辑，不发起新的上游调用。可通过 token_id 或精确的 market_slug 解析。
prediction.orderbook_imbalance_ratio	GET /v1/prediction/orderbook-imbalance-ratio	$0.01	单个 Polymarket 结果的买方与卖方订单簿深度比率，分别在距各自最优报价 depth_band_pct（默认 5.0%）范围内求和 — 0.5 表示平衡，接近 1.0 表示买方占主导，接近 0.0 表示卖方占主导。仅作描述 — 不预测价格方向，也不提供置信度／判定字段。复用相同的订单簿获取逻辑，不发起新的上游调用。可通过 token_id 或精确的 market_slug 解析。
prediction.liquidity_depth_after_haircut	GET /v1/prediction/liquidity-depth-after-haircut	$0.02	单个 Polymarket 结果在距最优报价 max_price_impact_pct（默认 5.0%）范围内的可执行深度，分别给出折减前和折减后的数值；折减时会将最优报价档位的规模乘以折减比例 haircut_pct（默认 10.0%）— 用于模拟最优报价被撤销的风险，不会检测或标记实际的虚假挂单（不在支持范围内，参见 architecture-roadmap.md 阶段 3）。复用相同的订单簿获取逻辑，不发起新的上游调用。可通过 token_id 或精确的 market_slug 解析。
prediction.polymarket_fee_estimate	GET /v1/prediction/polymarket-fee-estimate	$0.01	对假设成交估算 Polymarket 自身的吃单费用（shares * fee_rate * price * (1 - price)，即官方钟形曲线公式）— 不包括 Gas、滑点或 AlphaPipeline 自身的收费。fee_rate 实时读取自 Polymarket 自身针对精确 token_id 的 GET /fee-rate，不会使用硬编码的类别费率表（各类别费率过去曾有变动 — 参见 architecture-roadmap.md Engineering Precision Backlog 第 3 项）。做市方在任何情况下均不付费；仅收取吃单费用。省略 price 时使用实时最优订单簿报价。可通过 token_id 或精确的 market_slug 解析。
prediction.polymarket_mispricing	GET /v1/prediction/polymarket-mispricing	$0.03	对你认定结算条件相同的 Polymarket 市场进行单调性检查（较高行权价的定价不得高于较低行权价）— 此端点不会自行验证或推断这种等价关系（Polymarket 的 API 没有可靠字段可用于此目的；参见 architecture-roadmap.md Engineering Precision Backlog 第 4 项及响应中的 notice）。接受 token_ids 或 market_slugs（以及可选的 outcomes）。不构成投资建议。
prediction.hip4_snapshot	GET /v1/prediction/hip4-snapshot	$0.01	Hyperliquid HIP-4 结果市场的实时概率快照 — 加密货币价格二元市场、体育比赛赢家、锦标赛赢家、美联储利率决议，以及 Hyperliquid 新增的任何市场类型，均可通过一次调用获取。没有精选市场列表：每个 fields 值都从 Hyperliquid 自身的描述字符串中原样解析。可选的 template／underlying 筛选条件可缩小结果范围。仅支持 Hyperliquid。
prediction.hip4_price_ladder	GET /v1/prediction/hip4-price-ladder	$0.01	将同一标的的 HIP-4「高于 $X」价格二元市场按行权价排列成阶梯，每一档都附带实时 Yes 概率 — 可一目了然地读取市场隐含价格分布，无需逐项浏览 hip4_snapshot 的原始列表。复用 hip4_snapshot 的缓存数据（不发起新的上游调用）。不提供成交量字段：Hyperliquid 不提供 HIP-4 各结果的成交量。必填 underlying。仅支持 Hyperliquid。
prediction.hip4_price	GET /v1/prediction/hip4-price	$0.002	低价档 — 查询单个阶梯档位：复用 hip4_price_ladder 的缓存数据，仅返回行权价最接近所请求 strike 的一档，并提供 matched_strike，以便判断是否存在接近目标的档位。不发起新的上游调用。必填 underlying、strike。仅支持 Hyperliquid。
prediction.hip4_mispricing	GET /v1/prediction/hip4-mispricing	$0.02	查找同一标的的 HIP-4「高于 $X」价格二元市场中的单调性违规：在相同到期时间／周期内，较高行权价的 Yes 价格不应高于较低行权价 — 任何反转都会通过 violation_bp 和理论上的 max_riskless_profit_per_usd 标记（该数值仅代表违规幅度，未扣除费用／滑点，也未考虑执行风险 — 不构成投资建议）。复用 hip4_price_ladder 的缓存数据，不发起新的上游调用。仅比较共享完全相同 (expiry, period) 的档位（参见 settlement_condition_note）。必填 underlying。仅支持 Hyperliquid。
market.cycle_compare	GET /v1/market/cycle-compare	$0.01	比较 BTC／ETH 自当前减半（2024-04-20）以来的价格回报与 2016 年、2020 年减半后相同天数的价格回报，并提供今日真实的 BTC 市值占比及 DXY／美国 10 年期国债宏观背景。读取每日刷新的缓存（请求时不进行实时上游调用）。这是原始价格对比，并非真实的历史市值占比 — 详情请参见响应中的 notice 字段。没有 ETH 2016 年周期数据（当时 ETH 尚不存在）。
market.oracle_gap	GET /v1/market/oracle-gap	$0.01	单个永续合约的 Hyperliquid 中间价与标记价／预言机价格之间的单次快照偏差 — 这是 2026-10-10 HyperEVM Papertrade 事件的成因（协议使用原始中间价而非标记价／预言机价格进行定价；攻击者在 Hyperliquid 本身移动了约 $2.31B 名义金额，使中间价波动约 12bp，净赚约 $1.28M）。以基点为单位返回 mid_oracle_gap_bp／mark_oracle_gap_bp，并提供固定阈值的 elevated 标记（abs(mid_oracle_gap_bp) >= alert_threshold_bp）— 这不代表已判定发生操纵。仅提供某一时间点的快照，不含交易流量／成交量数据（Hyperliquid 不提供各市场成交量）。
market.oracle_gap_bp	GET /v1/market/oracle-gap-bp	$0.001	低价档 — oracle_gap 的轻量封装：使用相同的缓存调用，仅保留以基点表示的偏差数值和 elevated 标记（不含中间价／标记价／预言机价格的绝对值）。不发起新的上游调用。
calendar.macro_dday	GET /v1/calendar/macro-dday	$0.01	根据静态的预加载日历，倒计时至最近的重要美国宏观事件（FOMC、CPI、NFP）— 不调用外部 API，上游服务中断时也不会失败。
tools.ai_markdown	GET /v1/tools/ai-markdown	$0.005	将任意网页 URL 转换为干净、无广告且针对大模型上下文窗口优化的 Markdown。
market.kimchi_alert	GET /v1/market/kimchi-alert	免费	实时监测韩国（Upbit）与全球参考价格（Coinbase 现货，CoinGecko 备用 — 并非 Binance 实时订单簿）之间的溢价 — 即「泡菜溢价」— 并提供反向溢价和 1 小时激增警报。默认免费，作为入门工具：提供市场信息，不属于付费交易前安全工具组。
unlocks.dump_risk	GET /v1/unlocks/dump-risk	免费	基于链上数据（Sablier）的代币解锁／归属期抛售风险代理指标，包括 vesting_progress_pct（已提取／已存入），用于显示归属期已推进的程度。默认免费，作为入门工具，让 Agent 在为其余服务付费前验证服务是否可用。
[实验性] events.hip4_alerts	GET /v1/prediction/hip4-alerts/event-types（免费） · GET /v1/prediction/hip4-alerts/subscribe（$0.02） · POST /v1/prediction/hip4-alerts/unsubscribe（免费）	见下文	通过 webhook 推送 HIP-4 概率跳变／新市场警报，无需自行轮询 hip4_snapshot。默认禁用（HIP4_EVENTS_ENABLED=false）— 参见下文「事件订阅」。
每个响应都会同时标注 UTC 和 KST 时间戳；每个收费端点的付款提示都会显示“Paid in USDC on Base.”，确保人在浏览器中看到 402 屏幕时，不会猜不出应该在哪条链上发送 USDC。

事件订阅（Webhook 推送）—— EXPERIMENTAL

2026-09-30 新增，设计上大致参考了仍处于草案阶段的 MCP Events 扩展 （github.com/modelcontextprotocol/experimental-ext-triggers-events—— 尚非官方规范，请求／响应格式可能会变更）。你无需自行轮询 GET /v1/prediction/hip4-snapshot，而是可以注册 Webhook；当 HIP-4 结果的 概率变化达到或超过阈值，或出现新的 HIP-4 市场时，服务会推送经 Standard Webhooks 签名（webhook-id / webhook-timestamp / webhook-signature，对 "{id}.{timestamp}.{body}" 使用 HMAC-SHA256）的 POST 请求。

依赖此功能前，请留意以下情况：

• 这实际上是轮询，并非实时推送源。 Hyperliquid 的 HIP-4 没有 Webhook／流式 API，因此此服务会在后台每隔 HIP4_EVENTS_POLL_INTERVAL_SECONDS（默认值为 300 秒，即 5 分钟）重新获取 get_hip4_snapshot() 并进行差异比较。某次变动可能会在实际发生后这么久才报告。
• 默认禁用（HIP4_EVENTS_ENABLED=false）。禁用时，订阅路由甚至不会注册到支付中间件， 且处理器本身也会再次检查并返回 503——因此，你绝不会为一个永远不会发送任何内容的订阅付费。
• 重启后订阅可能无法保留。 订阅会持久化到本地 JSON 文件 （HIP4_EVENTS_DATA_FILE，默认值为 data/hip4_event_subscriptions.json）， 对于单个长期运行的 Render 实例来说没有问题，但磁盘重置时数据会丢失。目前还没有由真正的数据库提供支持。
• hip4.resolving（即将解析／结算）尚未实现——Hyperliquid 的 outcomeMeta 不会提供经过验证的解析时间戳；本项目的原则是，绝不伪造无法用真实 数据佐证的字段。目前只有 hip4.prob_jump 和 hip4.market_created 可用。
• MCP 客户端在 /mcp 上获得与 JSON-RPC 方法 events/list / events/subscribe / events/unsubscribe 相同的三种操作（在实验性的 capabilities.extensions["io.modelcontextprotocol/events"] 键下声明）——events/subscribe 会在内部调用相同的付费 REST 路由，因此无论哪种方式，定价／付款都相同。
• 可选的噪声过滤器（HIP4_EVENTS_CLEF_FILTER_ENABLED，默认值为 false）。 启用后，每个 hip4.prob_jump 候选事件都会先由 Cloudflare Workers AI 的 clef-flash 决策模型评分（需要 CLOUDFLARE_ACCOUNT_ID / CLOUDFLARE_API_TOKEN），然后才会发送；评分低于 HIP4_EVENTS_CLEF_SIGNAL_THRESHOLD（默认值为 0.3）的候选事件不会发送。评分中不会用到交易量或订单簿深度数据——Hyperliquid 的公开 HIP-4 API 不提供这两项数据——因此模型仅根据概率变动进行判断。如果 Cloudflare 调用失败或缺少凭据，系统会默认放行：事件仍会发送，只是不带原本会附加的 clef_signal 字段。

设置并部署 HIP4_EVENTS_ENABLED=true 后，可快速测试：

curl -G https://alphapipeline-eu.onrender.com/v1/prediction/hip4-alerts/subscribe \
  --data-urlencode "webhook_url=https://webhook.site/your-id" \
  --data-urlencode "secret=replace-with-a-random-32-byte-secret"
# -> 402 with payment terms, same as any other endpoint here; pay, retry, get a subscription_id back

注意：这里使用的是带查询参数的 GET，而不是带 JSON 请求体的 POST——有关由此产生的权衡，请参阅端点描述中关于 secret 的说明（它会随 URL 查询字符串传输）。

数据来源

返回的每个数值，要么是从以下某个上游来源原样传递而来，要么是在其基础上进行的确定性计算——绝不会把第三方估算值冒充成我们自己的数据：

领域	上游	备注
market.kimchi_alert、arb.spread_matrix（CEX 部分）	Upbit（KRW）+ Coinbase 现货，CoinGecko 回退	并非 Binance 实时订单簿。为保持向后兼容，保留了旧字段名 binance_price_usdt——请参阅 cex_reference_price_usdt/cex_price_source。
security.token_risk、security.contract_health_audit、security.token_diagnostic、security.token_prescreen（LP 锁仓部分）、security.token_authenticity	GoPlus Security API，Honeypot.is 回退（token_authenticity 无回退）	五项工具均复用相同的 GoPlus 底层数据；没有独立的第二方意见。
derivatives.funding_rate、derivatives.funding_apr_matrix	Bybit v5（主要来源）、Binance premiumIndex（回退）	仅 Bybit 提供 open_interest_usd——走 Binance 回退路径时，该字段始终为 null。
derivatives.whale_position_audit	Hyperliquid 公共 API（clearinghouseState）	上游没有排行榜/发现端点——必须提供钱包地址。
dex.liquidity_slippage、arb.spread_matrix（DEX 部分）、security.token_prescreen（流动性部分）	GeckoTerminal	流动性深度是恒定乘积（50:50）估算值，并非每种代币的真实储备——响应自身的 notice 字段会说明这一点。对于未映射到 GeckoTerminal 网络标识的链（目前包括 Base、Ethereum、BSC、Polygon、Arbitrum、Optimism、Avalanche），token_prescreen 的 liquidity_usd 为 null。
unlocks.dump_risk	链上 Sablier 归属流（默认，免费）	VC/团队分类和精确解锁时间需要付费的 DropsTab 密钥（默认禁用），否则始终为 null——切勿将 null 视为安全信号。
calendar.macro_dday	静态预加载日历	不调用外部 API——上游服务中断时不会失败，但随着事件从日历中移除，需要手动更新。
prediction.neg_risk_arbitrage、prediction.exit_capacity_audit、prediction.order_split_guide、prediction.bid_ask_spread_pct、prediction.orderbook_imbalance_ratio、prediction.liquidity_depth_after_haircut、prediction.polymarket_fee_estimate、prediction.polymarket_mispricing	Polymarket Gamma API（事件/市场元数据）+ Polymarket CLOB API（订单簿、GET /fee-rate）	book_snapshot_time/tick_size/min_order_size/base_fee_bp 是 Polymarket 自行报告的值，会原样传递。
prediction.hip4_snapshot	Hyperliquid 公共 API（outcomeMeta + allMids）	没有排行榜/精选列表——Hyperliquid 当前列出的所有市场都会显示。outcome_id → allMids 价格键的映射未由 Hyperliquid 记录，而是根据实时数据反向推断得出（2026-09-28）；响应自身的 notice 字段会说明这一点。
prediction.hip4_price_ladder	与 prediction.hip4_snapshot 相同的 Hyperliquid 公共 API，两次调用均有缓存	仅对 hip4_snapshot 自身的数据重新排序/筛选——不单独调用上游；上游未提供成交量字段。
market.oracle_gap	Hyperliquid 公共 API（metaAndAssetCtxs）	中间价/标记价/预言机价格是 Hyperliquid 自行报告的字段，每次调用都会读取最新数据（短时缓存，ORACLE_GAP_CACHE_TTL_SECONDS，默认值为 3s），因为只有接近实时的价差检查才有意义。没有交易流/成交量数据——Hyperliquid 不提供这些数据。
market.cycle_compare	Yahoo Finance（BTC-USD/ETH-USD 完整价格历史、DX-Y.NYB、%5ETNX）+ CoinGecko /global（仅今日的市占率）	每日 GitHub Actions 定时任务会写入单个 JSON 缓存；端点只读取该文件。我们曾尝试 CoinMetrics Community（目前所有请求均返回 401）、CoinGecko 历史全球市值图表（仅限付费计划）、CoinGecko 免费 Demo 计划（历史数据上限为 365 天）以及 Kraken 公共 OHLC（上限为 720 根蜡烛图），在最终选择 Yahoo 之前均已排除——请参阅 scripts/collect_btc_cycle_metrics.py 的模块文档字符串。
tools.ai_markdown	你传入的 URL	不使用第三方数据提供商——我们会抓取并转换你提供的页面。
[实验性] events.hip4_alerts	与 prediction.hip4_snapshot 相同的 Hyperliquid 公共 API，每隔 HIP4_EVENTS_POLL_INTERVAL_SECONDS 轮询一次	采用轮询 + 差异比较，并非来自 Hyperliquid 的推送流——请参阅上文的“事件订阅”。

---

进行中 — 股票价差数据流（4 周数据试用，始于 2026-10-08）

目前每小时采集数据，尚未销售。scripts/collect_stock_discrepancy.py 通过 .github/workflows/stock-discrepancy-collect.yml 每小时运行一次，并将数据追加到 data-public/stock_discrepancy_log.jsonl（而不是 data/——该目录因存放 HIP-4 webhook 密钥而被 git 忽略；这些数据不包含任何敏感信息）。这里没有任何付费端点——目前只是在收集证据，以判断是否应该将其作为付费端点推出。

跟踪内容：每个交易日常规时段收盘价、Base B20 代币价格（通过 GeckoTerminal 获取的 Aerodrome 数据）、Hyperliquid HIP-3 股票永续合约标记价格和资金费率，以及两者之间的价差百分比，按股票代码和小时记录。股票代码列表：NVDA、AAPL、META、GOOGL——不包括 TSLA/MSTR/COIN。早前的简报提到了这些代码，但截至本文撰写时，尚未确认 Aerodrome 上有对应的 Coinbase B20/cbStock 代币（重新纳入前请再次核查）。

上线/暂缓决策，截止日期约为 2026-11-05（开始后 4 周）——以下 3 项中需满足 2 项：

1. 周末价差方向（周五收盘至周日夜间）与随后周一开盘跳空方向的吻合率 ≥65%（样本：4 个周末 × 股票代码数量，约 16-20 个数据点）。
2. 每个周末至少有一种股票代码出现一次 >1% 的价差——这是告警产品具备可行性的前提。
3. 数据缺口（data_gap: true 行——池流动性不足、上游 API 出错）占全部行数的比例 ≤10%。

如果未满足上述 3 项中的 2 项：不要勉强基于微弱信号推出付费产品。改为提供免费的公开仪表盘，并将其作为流量入口，引导用户了解 AlphaPipeline 的其他服务。

次要免费数据流：同一个 cron 任务还会将 Kalshi 的 KXBTC15M 15 分钟/每小时加密货币预测市场快照（公开、无需身份验证的 API）写入 data-public/kalshi_btc15m_log.jsonl，以便之后与 prediction.hip4_snapshot 自身的 BTC 概率进行比较。无需额外基础设施成本；不纳入上述上线/暂缓决策。

新增子数据流，始于 2026-10-26 — EQX 现货与 Hyperliquid 永续合约价差：EQX Labs 于 2026-10-26 22:30 KST 将 11 种代币化美国股票/ETF（EQSPY、EQQQQ、EQAAPL、EQAMZN、EQGOOG、EQMETA、EQMSFT、EQNVDA、EQTSLA、EQMU、EQSPCX）作为原生 Hyperliquid HIP-1 现货代币上线。与上述 Base 和 Hyperliquid 之间的比较（涉及两条不同的链，包含桥接/结算噪声）不同，这里比较的是同一 HyperCore 平台上的现货和永续合约，因此价差能更清晰地反映纯粹因非交易时段无法套利而产生的偏差。同一个每小时 cron 任务现在也会写入 data-public/eqx_gap_log.jsonl（同一脚本中的 collect_eqx_gap_rows()）。目前还不是付费端点——先观察非交易时段/周末价差是否始终大于常规交易时段，再作决定。上线时没有公开的 EQX 官方代币 ID 注册表，因此目前仅按代币名称（EQ + 股票代码）匹配行；待 EQX 发布 ID 后再重新核查。

---

免责声明

AlphaPipeline 提供量化市场数据和分析，仅供参考和研究使用。它不会执行交易、下订单、托管用户资金，也不提供任何形式的经纪/博彩/赌博服务——它是一个只读数据层。用户须自行负责确保其对这些数据的使用符合所在司法辖区适用的法律法规。

---

链接

• 实时服务：https://alphapipeline-eu.onrender.com
• 面向 Agent 的可读规范：https://alphapipeline-eu.onrender.com/llms.txt
• OpenAPI 文档：https://alphapipeline-eu.onrender.com/docs
• x402 Bazaar 列表：https://www.x402bazaar.org/
• Glama 列表（已验证，TDQS A / 4.4）：https://glama.ai/mcp/connectors/com.onrender.alphapipeline/alpha-pipeline-agent-mcp
• x402 协议：https://docs.x402.org

许可证

请参阅 LICENSE。