AgentFeed

AgentFeed

面向 AI Agent 的加密货币市场数据（强平、资金费率、未平仓合约、价格）、Solana 交易前检查、OFAC 制裁筛查、学术论文、实用工具和固定用途语言任务（OCR、翻译、摘要、提取、分类、提示词注入检查、转录）。使用 USDC 按次付费。无需账户、订阅或 API 密钥（预付费密钥为可选项，适用于无法使用 x402 付款的机器人）。

AgentFeed 通过 Solana、Base、Polygon、Arbitrum、Arc、Algorand、Optimism、Monad 和 Avalanche 上的 x402 付款协议销售实时交易数据，并可按需通过 Celo、HyperEVM、Unichain、Scroll、SKALE Base、BNB Chain、Ethereum、Robinhood Chain、World Chain、Sei 和 X Layer 提供（GET /api/<route>|<network>）。Agent 访问端点后会收到包含价格的 402 Payment Required，再从自己的钱包支付少于一美分的 USDC（或该网络指定的美元代币），即可获得数据——整个过程约两秒，Gas 费由支付促进方代付。

两种通道，同样的数据：

通道	端点	适用对象
MCP（Streamable HTTP）	https://x402.ochinimus.app/mcp	Claude、Cursor、原生支持 MCP 的框架
HTTP（x402）	https://x402.ochinimus.app/api/*	任何支持 HTTP 的对象

---

与众不同之处：强平数据流

我们在 Bybit、OKX 和 Binance 上运行自己的强平数据采集器，持续记录这三家平台上所有以 USDT 计价的永续合约，记录始于 2026-07-08。

这份数据流的规模不是口头宣称，而是可以查询验证的。测量时间为 2026-09-28 06:56 UTC：

记录数	4,924,729
整个数据流中的不同永续合约市场数	907
过去 7 天的不同永续合约市场数	861 — binance 728 · bybit 693 · okx 454
时间范围（UTC）	2026-07-08 16:42:32 → 2026-09-28 06:56:17

你阅读本文时，数据仍在增长：上方的记录数和五分钟后通过同一查询得到的记录数不会相同。

服务会在 / 的 coverage.perp_markets_7d 下实时公布过去 7 天的数据，并根据数据流重新计算，而非重复陈述，因此可以用它来核对本 README，而不必盲信。

这些数据无法购买。 无论向我们还是向任何人购买都不行：

• Binance 删除了其强平存档。 data.binance.vision 上的 liquidationSnapshot 已不复存在——该目录只是一个空壳。已于 2026-07-12 核实。
• Bybit 从未发布过历史强平数据。
• OKX 只提供滚动 7 天的 REST 窗口，仅此而已。

任何主流平台都没有公开的历史强平数据集，无论价格如何。获取这些数据的唯一方式，就是一直以来都在记录。

以下是我们数据不足之处的具体说明

坦诚说明这一点比营销宣传更重要：

平台	数据流	完整吗？
Bybit	allLiquidation	✅ 是。 每一笔强平，每 500ms 更新一次。这是主流永续合约平台中唯一完整且不受限流的公开强平数据流。
Binance	!forceOrder@arr	❌ 否。 仅提供快照——根据 Binance 自己的文档，每个交易对每 1000ms 最多一笔订单。allForceOrders REST 接口无人维护。
OKX	liquidation-orders	❌ 否。 每份合约每秒最多更新一次。
Hyperliquid	—	⛔ 未纳入。 Hyperliquid 不提供任何公开强平数据流。WsTrade 不包含强平标记；数据仅存在于用户专属数据流中。要采集这些数据，必须运行节点。

Binance 和 OKX 的记录存在结构性低估，而且在行情连锁崩盘期间——也正是数据最重要的时候——低估最为严重。 市面上所有强平数据集都存在这个问题，包括那些知名数据集。大多数都不会说明这一点。

Bybit 的记录是数据集中完整性最高的部分。 请据此权衡。

大多数数据集都会弄错的 side 字段

三家交易所，三套约定。我们将它们统一处理：

• Bybit 的 S 已经表示持仓方向（Buy = 多头被强平）。直接传递。
• Binance 的 S 表示订单方向——平掉多头的是 SELL 订单。反转。
• OKX 明确提供 posSide。映射处理。

在我们的输出中：Buy = 多头被强平。Sell = 空头被强平。 如果将其反过来，某些交易所的所有多空比都会算反。

名义价值使用 filled_qty × avg_fill_price——即实际成交的金额，而非 limit_price × requested_size。

---

价格索引

所有付费路由，按价格从低到高排列。根据 /.well-known/x402.json 生成，读取于 2026-10-18——名称、价格和路由均取自清单，并非手动维护的同步副本。每项返回的内容见 90 个工具，与服务发布的内容逐字一致。

Tool	Price	Route
buy_key_pass	$25	/api/keys/buy-pass
buy_key_20	$20	/api/keys/buy-20
topup_key_20	$20	/api/keys/topup-20
buy_key_5	$5	/api/keys/buy-5
topup_key_5	$5	/api/keys/topup-5
buy_key_1	$1	/api/keys/buy-1
buy_key_day_pass	$1	/api/keys/buy-day-pass
buy_key_trial	$0.25	/api/keys/buy-trial
get_squeeze_score	$0.1	/api/squeeze-score
get_cascade_scan	$0.05	/api/cascade-scan
get_liq_history	$0.05	/api/liq-history
get_peg_universe	$0.05	/api/peg-universe
get_ocr	$0.04	/api/ocr
get_translate	$0.04	/api/translate
get_cascade_history	$0.03	/api/cascade-history
get_peg_sessions	$0.03	/api/peg-sessions
get_extract	$0.025	/api/extract
get_sol_token_check	$0.025	/api/sol-token-check/:mint
get_base_launches	$0.02	/api/base-launches
get_cascade_forecast	$0.02	/api/cascade-forecast
get_exit_quote	$0.02	/api/exit-quote
get_funding_extremes	$0.02	/api/funding-extremes
get_funding_radar	$0.02	/api/funding-radar
get_hl_whales	$0.02	/api/hl-whales
get_liq_heatmap	$0.02	/api/liq-heatmap
get_liquidation_leaders	$0.02	/api/liquidation-leaders
get_market_state	$0.02	/api/market-state
get_oi_spike_scan	$0.02	/api/oi-spike-scan
get_peg_deviation	$0.02	/api/peg-deviation
get_summarize	$0.02	/api/summarize
get_token_holders	$0.02	/api/token-holders/:mint
get_tradfi_radar	$0.02	/api/tradfi-radar
get_transcribe	$0.02	/api/transcribe
get_venue_liq_share	$0.02	/api/venue-liq-share
get_wallet_activity	$0.02	/api/wallet-activity/:wallet
get_papers	$0.015	/api/papers
get_basis	$0.01	/api/basis
get_cascade_alert	$0.01	/api/cascade
get_equity_24h	$0.01	/api/equity-24h
get_honeypot_check	$0.01	/api/honeypot-check
get_insider_trades	$0.01	/api/insider-trades
get_liquidation_stats	$0.01	/api/liquidation-stats
get_open_interest	$0.01	/api/open-interest
get_orderbook_imbalance	$0.01	/api/orderbook-imbalance
get_orderbook_walls	$0.01	/api/orderbook-walls
get_pdf_markdown	$0.01	/api/pdf-markdown
get_sec_8k	$0.01	/api/sec-8k
get_signal_board	$0.01	/api/signal-board
get_token_risk	$0.01	/api/token-risk/:mint
get_top_movers	$0.01	/api/top-movers
get_trade_context	$0.01	/api/trade-context
get_volatility	$0.01	/api/volatility
get_sanctions_check	$0.008	/api/sanctions-check/:address
get_sol_holder_clusters	$0.008	/api/sol-holder-clusters/:mint
get_sol_token_flow	$0.008	/api/sol-token-flow/:mint
get_wallet_holdings	$0.008	/api/wallet-holdings/:wallet
get_base_balance	$0.005	/api/base-balance
get_base_gas	$0.005	/api/base-gas
get_classify	$0.005	/api/classify
get_convert	$0.005	/api/convert
get_domain	$0.005	/api/domain/:domain
get_email_verify	$0.005	/api/email-verify
get_funding_history	$0.005	/api/funding-history
get_funding_pulse	$0.005	/api/funding-pulse
get_funding_rate	$0.005	/api/funding-rate
get_hash	$0.005	/api/hash
get_jito_tips	$0.005	/api/jito-tips
get_liq_pulse	$0.005	/api/liq-pulse
get_macro_calendar	$0.005	/api/macro-calendar
get_market_snapshot	$0.005	/api/market-snapshot
get_paper	$0.005	/api/paper/:doi
get_perp	$0.005	/api/perp
get_positioning	$0.005	/api/positioning
get_priority_fees	$0.005	/api/priority-fees
get_qr	$0.005	/api/qr
get_recent_liquidations	$0.005	/api/liquidations
get_sec_filings	$0.005	/api/sec-filings
get_sol_network	$0.005	/api/sol-network
get_time	$0.005	/api/time
get_token_metadata	$0.005	/api/token-metadata/:mint
get_tradfi_perps	$0.005	/api/tradfi-perps
get_web_markdown	$0.005	/api/web-markdown
get_wiki	$0.005	/api/wiki
get_coin_signal	$0.004	/api/coin-signal/:coin
get_injection_check	$0.004	/api/injection-check
get_fx_rates	$0.002	/api/fx-rates
get_btc_price	$0.001	/api/btc-price
get_eth_price	$0.001	/api/eth-price
get_liq_feed	$0.001	/api/liq-feed
get_sol_price	$0.001	/api/sol-price
get_spot	$0.001	/api/price

同一个 402 支持两种支付协议

每个付费路由都会在 PAYMENT-REQUIRED 标头中以 x402 v2 挑战响应 402，并为 Base 和 Solana 在响应体中提供相同挑战的 x402 v1 格式（{x402Version: 1, accepts}）。使用 PAYMENT-SIGNATURE（v2，任何支付网络）或 X-PAYMENT（Base 或 Solana 上的 v1，由 CDP facilitator 的 v1 类型验证并结算）付款。Polygon 和 Arbitrum 在该服务中没有 v1 类型，因此仍使用 v2。每个 402 都会列出九个网络，另有十一个网络可按需提供（参见“在任意链上付款”）。每个网络都由唯一一个 facilitator 结算：Solana、Base、Polygon、Arbitrum 和 World Chain 由 CDP 结算；Arc 由 Circle's Facilitator Service 结算至专用的 Arc 地址；Algorand 由 GoPlausible 结算；Optimism、Monad、Avalanche、Celo、HyperEVM、Unichain、Scroll、SKALE Base、BNB Chain、Ethereum 和 Robinhood Chain 由 Ultravioleta 结算；Sei 和 X Layer 由 PayAI 结算。payments.js 只向每个 facilitator 客户端提供它负责的网络，因此某个网络上的付款绝不会到达其他 facilitator。 每个付费路由还会在 WWW-Authenticate 中携带 MPP tempo/charge 挑战（Tempo 主网，链 ID 4217，先用 OUSD，再用 USDC.e，按路由价格付款；不设费用支付方，付款方自行支付 gas）。只接受已签名的交易（pull 模式）：服务器会验证转账、处理请求，并且仅当响应状态码低于 400 时才广播交易，因此失败的调用不会收费；已广播的哈希凭证会被拒绝。/api/sol-price 和 /api/btc-price 还会携带 MPP solana/charge 挑战。所有挑战都通过同一个响应发送，因此客户端可使用其支持的任意协议完成结算。这两种协议使用互不重叠的标头命名空间，因此仅支持 x402 的客户端不会看到 MPP 挑战，也不会受到影响。

$ curl -si https://x402.ochinimus.app/api/btc-price      # 2026-09-23 09:18:09 UTC

HTTP/2 402
payment-required: eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwi…
www-authenticate: Payment id="T0-lA4BfXXpf3GvzGklT8YobRJwSlEu8AXu9ZLz5VOg",
                  realm="x402.ochinimus.app", method="solana", intent="charge",
                  request="eyJhbW91bnQiOiIxMDAwIiwiY3VycmVuY3ki…",
                  expires="2026-09-23T09:23:09.919Z", opaque="eyJfbXBweF9zY29wZSI6…"

Base64 解码后，该 MPP request 就是完整的报价：

{
  "amount": "1000",
  "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "recipient": "4a8o45skRPcyjAdyR8yES215Swvh8uTpZD6KLarhxCJ7",
  "methodDetails": {
    "decimals": 6,
    "network": "mainnet",
    "recentBlockhash": "6e6NEAxddHca5ipHioSwZRhcGcSL4rW4q18AYszfnxyv",
    "tokenProgram": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
  }
}

请注意其中没有什么：没有 feePayer。客户端自行支付交易费用，服务器也不持有已注资的签名密钥，这正是 MPP 挑战与同一响应中并列的 Solana x402 挑战之间的区别。

拒绝重放，而非仅仅劝阻。 在提供资源之前，会先在 SQLite 中以原子方式登记已结算的签名，因此两个进程若同时使用同一凭证，最终恰好一个得到 200，另一个被拒绝——这由分叉真实工作进程的测试覆盖，而非通过替身模拟竞争条件。

该层按设计采用宽松失败策略。 如果无法初始化，它会记录 [mpp] DISABLED: <cause>，而服务仍会在所有路由上继续提供 x402，不会因此关闭付费功能。哪些路由受保护，会实时发布在 / 和 /.well-known/x402.json 的 mpp.routes 下，因此公布的集合始终与实际挂载的路由一致。

AgentFeed 是 Solana 主网上多个接受 MPP 的商家之一——Foundation 自有的 Google 代理和 solana-foundation/pay-skills 中的 smartmoney-market 也支持 MPP。

由此产生的上游工作

solana-foundation/pay-kit #328	fix(mpp): send preflightCommitment with sendTransaction so confirmed-only blockhashes are accepted — 在 confirmed 状态下生成的挑战区块哈希会被默认使用 finalized 的预检银行拒绝，因此，快速付款的客户端总会失败。开放中，已批准，44/44 项检查通过，可合并／无冲突（读取于 2026-09-23）
solana-foundation/surfpool #813	fix(core): make blockhash handling honor commitment and preflightCommitment — 于 2026-09-21 合并，由 MicaiahReid 合并，EfeDurmaz16 发起；后者审查过 #328。其说明解释了为什么这个错误在 CI 中没有显现：“这使 pay-kit 的 Surfpool CI 未能发现一个确定会在主网上发生的故障：solana-foundation/pay-kit#328。”一个总是生成有效区块哈希的沙盒无法重现主网上每次都会发生的最终性竞争问题
solana-foundation/pay-skills #260	providers: add ochinimus/agentfeed
solana-foundation/pay #469	在非 GUI 环境中，pay 处理付费路由时会永远挂起：Touch ID 门禁会持续轮询一个无法显示的提示词

这里的 pay-kit 修复以 mpp/patches/@solana+mpp+0.7.0.patch 的形式提供，安装时由 patch-package 应用，并通过 npm run verify-patch 验证——此补丁是生产依赖， 而非开发依赖，因为否则使用 --omit=dev 安装会在未打补丁的情况下悄然完成。

高频调用者可享半价

通过两种方案之一，频繁调用的机器人支付路由价格的一半，最低 $0.0005；这两种方案都使用与按次付费接受项相同的 402。按次价格不变。六个预付密钥购买路由仅提供按次付费接受项。Gateway 接受项仅在 Arc 上提供：它于 2026 年 10 月 18 日从 Base、Polygon 和 Arbitrum 撤下，因为买方的客户端若将其选为该链上最便宜的接受项，就会向 Gateway 钱包签署一笔普通 USDC 授权；这并非 Gateway 付款，因此遭到拒绝。

	batch-settlement	Circle Gateway nanopayment
网络	Base、Polygon、Arbitrum	Arc
接受项	scheme: batch-settlement	scheme: exact，extra.name: GatewayWalletBatched
收款方	财库 0x22DB3A9686EE5261e7Bf3ed4f91277232E8076e6	Gateway 卖家 0xA853129ACF56A851f9d51CD8cb47619465260Fa9
买方一次性操作	存入一笔资金来开通支付通道（接受项中的 extra.minDeposit）；之后的每次调用都是链下凭证	将 USDC 存入 GatewayWallet 0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE
结算	我们每 30 分钟领取一次凭证	Circle 批量处理授权
未用完的资金	通过通道的定时提款退回（延迟 24 h）	留在买方的 Gateway 余额中

无论使用哪种方案，响应状态码为 400 或更高的调用都不会收费。

batch-settlement，在 Base 上

import { privateKeyToAccount } from 'viem/accounts';
import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';
import { BatchSettlementEvmScheme } from '@x402/evm/batch-settlement/client';
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';

const account = privateKeyToAccount(process.env.EVM_KEY);
const pub = createPublicClient({ chain: base, transport: http() });
const signer = Object.assign(account, { readContract: (args) => pub.readContract(args) });
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:8453', client: new BatchSettlementEvmScheme(signer) }],
});

// the first call opens the channel (one EIP-3009 authorization, no ETH needed); the rest are vouchers
for (let i = 0; i < 5; i++) {
  const res = await pay('https://x402.ochinimus.app/api/eth-price');
  console.log(res.status, await res.json());
}

在多次调用之间保持 pay 对象处于活动状态。如果客户端每次调用都启动一个新进程，当仍有未结算凭证时，它只会被要求重新同步一次，之后便会在同一请求中得到服务。

完整脚本包含一项检查，用于在签署任何内容之前验证接受项：ops/proof-batch.mjs。

Gateway，在 Arc 上

Gateway 接受项仅在 Arc 上提供（完整操作步骤请参阅下文“在 Arc 上付款”）：ops/proof-gateway.mjs（默认 CHAIN=arc）会向 GatewayWallet 存入一次资金，并支付一笔 nanopayment。

已在主网上验证

• 2026 年 10 月 13 日，Base 上的批量结算：使用存款开启了通道 0x6175…4492，发出 10 张 0.0005 USDC 凭证，并已领取和结算至金库；第二次运行在领取任务运行期间支付了 8 次调用。
• 2026 年 10 月 13 日，Arc 上的 Gateway：参见下文“在 Arc 上付款”。

所有款项均来自我们自己的测试钱包。

在 Arc 上付款

所有付费路由都通过两种方式在 Arc 主网上收取 USDC（eip155:5042，USDC 0x3600000000000000000000000000000000000000，6 位小数）。两种方式都与其他支付渠道共用同一个 402（预付费密钥购买路由仅提供完全匹配的方式），因此客户端可以用手头持有的资产付款。Arc 上的 Gas 以 USDC 支付，因此买家不需要其他资产。

	x402 精确支付	Circle Gateway 纳支付
接受方式	scheme: exact	scheme: exact、extra.name: GatewayWalletBatched
价格	路由价格	路由价格的一半，最低 $0.0005
结算方	Circle Facilitator Service，每次调用对应一笔交易	Circle Gateway，批量结算
收款方	0x0Cf44185564F2b72E291050DC79E578429E52f83	Gateway 卖家 0xA853129ACF56A851f9d51CD8cb47619465260Fa9
买家所需	Arc 上的 USDC	向 GatewayWallet 0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE 一次性存款

单次调用：x402 精确支付

import { privateKeyToAccount } from 'viem/accounts';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';

const account = privateKeyToAccount(process.env.ARC_KEY);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:5042', client: new ExactEvmScheme(account) }],
});
const res = await pay('https://x402.ochinimus.app/api/liquidation-stats');
console.log(res.status, await res.json());

完整脚本：ops/pay-arc.mjs。

多次调用：Gateway 纳支付

import { GatewayClient } from '@circle-fin/x402-batching/client';

const client = new GatewayClient({ chain: 'arc', privateKey: process.env.ARC_KEY });
await client.deposit('0.02'); // once: approve + deposit, gas paid in USDC
const res = await client.pay('https://x402.ochinimus.app/api/liquidation-stats');
console.log(res.formattedAmount, res.data);

完整脚本，包含根据实时 Gas 估算确定金额的存款和一次空运行：ops/proof-gateway.mjs（CHAIN=arc）。

已在主网上验证

• 2026 年 10 月 12 日，通过 Circle 的 Facilitator 使用 x402 精确支付：0x15e8…41d0
• 2026 年 10 月 13 日，Gateway 存款 0xffe7…9d50，随后进行了一笔 0.0005 USDC 纳支付（Circle 转账 d32e4ea9-2d62-4fd6-ad4c-6de70affba00）
• 2026 年 10 月 14 日，通过 Circle 的 Facilitator 使用生产密钥进行 x402 精确支付：0xee59…bf33，向 /api/eth-price 发起了一次 0.001 USDC 调用，状态为 ok

所有款项均来自我们自己的测试钱包。

代码位置

• lib/rails.js：Arc 支付渠道（网络、资产、payTo）。
• lib/circle-arc.js：Circle Facilitator Service 客户端：仅限 Arc 的 /supported、/verify、/settle 和结算状态轮询。仍在处理中的付款会被暂缓，并记录日志，供 ops/arc-reconcile.js 处理。
• lib/hf.js：半价档位：Base、Polygon 和 Arbitrum 上的批量结算，Arc 上的 Gateway 方案、半价规则，以及 routeGateway；它将 Gateway 付款交给 Circle 的 BatchFacilitatorClient 处理，其他付款则继续使用各自的 Facilitator。
• ops/batch-claim.js：每 30 分钟领取并结算批量结算凭证。
• payments.js：Facilitator 顺序：优先使用 Coinbase CDP，其次是 Arc 的 Circle，最后是 Gateway 档位。
• ops/gateway-withdraw.mjs 和 ops/arc-sweep.mjs：从热地址转出收入。
• test/arc.test.js。

在任意链上支付

每条付费路由的 402 都包含 9 个网络，另外 11 个网络可按需提供。将网络后缀添加到路由即可申请使用：GET /api/<route>|<network>（| 可以发送为 %7C），例如 Celo 对应的 /api/sol-price|eip155:42220。返回的 402 会包含默认的 accepts，以及该网络对应的 accept；在普通 URL 上也接受任意网络的支付。预付费密钥购买路由仅包含这 9 个网络。前 6 个网络（Solana、Base、Polygon、Arbitrum、Arc、Algorand）见“一个 402 上的两种支付协议”和“在 Arc 上支付”部分；下表列出其余 14 个网络，数据由 lib/ext-rails.js 生成。每一行均为 scheme: exact（EIP-3009），付款均汇入同一个 EVM 财库，并由该行列出的唯一 facilitator 结算。

网络	CAIP-2 id	代币和地址	小数位数	Facilitator	提供方式	路由最低价格
Optimism	eip155:10	USDC 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85	6	Ultravioleta	每个 402	无
Monad	eip155:143	USDC 0x754704Bc059F8C67012fEd69BC8A327a5aafb603	6	Ultravioleta	每个 402	无
Avalanche	eip155:43114	USDC 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E	6	Ultravioleta	每个 402	无
Celo	eip155:42220	USDC 0xcebA9300f2b948710d2653dD7B07f33A8B32118C	6	Ultravioleta	按需提供	无
HyperEVM	eip155:999	USDC 0xb88339CB7199b77E23DB6E890353E22632Ba630f	6	Ultravioleta	按需提供	无
Unichain	eip155:130	USDC 0x078D782b760474a361dDA0AF3839290b0EF57AD6	6	Ultravioleta	按需提供	无
Scroll	eip155:534352	USDC 0x06eFdBFf2a14a7c8E15944D1F4A48F9F95F663A4	6	Ultravioleta	按需提供	无
SKALE Base	eip155:1187947933	USDC.e 0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20	6	Ultravioleta	按需提供	无
BNB Chain	eip155:56	AUSD 0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a	6	Ultravioleta	按需提供	无
Ethereum	eip155:1	USDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48	6	Ultravioleta	按需提供	无
Robinhood Chain	eip155:4663	USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168	6	Ultravioleta	按需提供	无
World Chain	eip155:480	USDC 0x79A02482A880bCE3F13e09Da970dC34db4CD24d1	6	CDP	按需提供	无
Sei	eip155:1329	USDC 0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392	6	PayAI	按需提供	$0.005
X Layer	eip155:196	USDC 0xB6CEceAB302E2E4948951eE7843FC24E92933061	6	PayAI	按需提供	$0.005

并非所有网络都使用 USDC：BNB Chain 使用 AUSD 结算，Robinhood Chain 使用 USDG，SKALE Base 使用 USDC.e。Sei 和 X Layer 仅在价格不低于 $0.005 的路由上提供，因为 PayAI 会按次收取结算费用。

使用 @x402/fetch 支付

@x402/fetch 2.28 会拒绝 @x402/evm 的 DEFAULT_ASSETS 以外的任何代币，除非客户端通过 spendControls.allowedAssets 明确允许。开箱即用的标准客户端可以在 Monad、Avalanche、Celo、Ethereum 和 Sei 上支付。在 Optimism、HyperEVM、Unichain、Scroll、SKALE Base、BNB Chain、Robinhood Chain、World Chain 和 X Layer 上，必须先允许相应代币，否则支付会被拒绝。以下是 @x402/core 自身类型定义中的选项格式：

spendControls?: {
  maxAmountPerPayment?: Money | false;                 // USD cap on default assets, default "$1"
  allowedAssets?: true | SpendControlAsset[];          // true allows any asset
}
interface SpendControlAsset {
  network: Network;                                    // CAIP-2, e.g. 'eip155:10'
  asset: string;                                       // on-chain token address, or a default-asset symbol
  maxAmountPerPayment?: string;                        // integer atomic units, e.g. '50000' = $0.05 at 6 decimals
}

在 Optimism 上支付，并显式允许该代币（上限 '50000' 为 $0.05；代币地址见表格）：

import { privateKeyToAccount } from 'viem/accounts';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';

const account = privateKeyToAccount(process.env.EVM_KEY);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: 'eip155:10', client: new ExactEvmScheme(account) }],
  spendControls: { allowedAssets: [{ network: 'eip155:10', asset: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85', maxAmountPerPayment: '50000' }] },
});
const res = await pay('https://x402.ochinimus.app/api/sol-price');
console.log(res.status, await res.json());

如果没有 spendControls 这一行，同一客户端会抛出 "All payment requirements were rejected by spendControls"。完整脚本包含一次 dry run，可在签名任何内容前打印 accept：ops/r10-proof-evm.mjs。

已在主网上验证

• 2026 年 10 月 14 日，在 /api/sol-price|<network> 上进行了三笔 0.001 USDC 的验证付款，每笔都是从我们的测试钱包向金库转账 1 USDC：Optimism 0xdc64…d4c5、Monad 0xdf06…da2d、Avalanche 0x5c3e…70d0。
• 另外 11 条网络可按需提供，目前尚无已结算的付款。

这些付款全部来自我们自己的测试钱包。

90 个工具（83 条付费数据路由 + 7 个免费工具）与定价

83 个付费 + 7 个免费，MCP 通道上共 90 个（以下 8 条预付费密钥路由仅支持 HTTP）。每次调用都会单独通过 x402 按量以 USDC 计费——没有套餐，也没有最低消费。将全部 83 个付费数据工具各调用一次，费用为 $1.137。数量和价格汇总自实时清单，读取日期为 2026-10-15。

旗舰工具是 get_squeeze_score——一个 0–100 的空头挤压／多头平仓综合评分，根据资金费率、拥挤度、未平仓合约量的增长，以及我们独家清算数据流的清算偏斜度计算得出。一个数字，一角美元，即可回答“这笔交易是否过于拥挤，马上就会有人遭殃”。

护城河——我们自己的强平记录

工具	价格	路由	你将获得什么
get_squeeze_score	$0.1	/api/squeeze-score	针对任意 Hyperliquid 永续合约的轧空分数和多头挤压平仓分数，范围为 0–100。综合计算 Hyperliquid 资金费率（35）、巨鲸拥挤度（25：该币种在 Hyperliquid 上排名前 250 的账户中的净多头占比，并非散户）、通过我们自己的 5 分钟采样器统计的 24 小时未平仓量增幅（20），以及根据我们自己的记录计算的强平倾斜度（20）。用一个数字判断一笔交易是否过于拥挤、即将让某人蒙受损失。未列出的币种会返回 400；如果未平仓量记录不足 24 小时，或 Hyperliquid 或巨鲸快照不可用，则会返回 503；这两种情况都不会收费。若某个已列出的币种没有前 250 名账户持有，则返回 200，并注明缺少的输入数据。
get_liq_history	$0.05	/api/liq-history	按时间段汇总的强平历史：每个时间段的总额、多头和空头 USD 金额、强平记录数及最大单笔强平金额。适用于任意 USDT 永续合约，或全部已记录的标的，最多可查询过去 7 天的数据。Bybit 是加密货币领域唯一拥有完整强平记录的平台，而且没有交易所会发布这类历史数据。
get_liq_heatmap	$0.02	/api/liq-heatmap	按价格水平划分的强平热力图：展示过去 N 小时内杠杆实际在哪些价位被清算——每个价格区间的 USD 金额、强平记录数和多空占比，并标出最活跃的区间。基于真实强平记录，而非入场价格估算。涵盖 BTC、ETH、SOL、HYPE 或我们多平台强平记录中的任何其他 USDT 永续合约。
get_cascade_history	$0.03	/api/cascade-history	强平连锁事件历史：根据我们自己的记录还原过去同方向集中平仓事件，包括开始和结束时间、强平记录数、USD 总额及峰值单笔强平金额，最多可查询过去 72 小时的数据。/api/cascade 会告诉你现在正在发生什么；此工具会告诉你已经发生了什么。
get_venue_liq_share	$0.02	/api/venue-liq-share	按交易所统计强平情况：展示 Bybit、OKX 和 Binance 的强平占比、多空占比及最大单笔强平金额，适用于任意币种或全部已记录的标的。看看哪个交易所正在清算谁。
get_cascade_forecast	$0.02	/api/cascade-forecast	强平预测，面向未来，并非描述已经发生的情况。返回某个币种在接下来 15 分钟内的强平量超过其自身 15 分钟窗口第 90 百分位数的概率。根据我们覆盖超过 600 万笔强平记录的多平台完整记录进行校准，每 6 小时重新拟合；没有交易所会发布这类历史数据，因此无法重建。每个结果都会列出确切的问题、以 USD 计的阈值、所读取的时间窗口、作为概率依据的历史发生次数，以及如何根据公开数据流自行核验的说明。若某种状态的历史数据不足，此工具会拒绝预测，而不是猜测，并说明原因。已核验的记录可在 /api/forecast-record 免费查看。

第二道护城河——我们自有的代币化股票锚定价格数据流

工具	价格	路由	你能获得什么
get_peg_universe	$0.05	/api/peg-universe	按非交易时段锚定风险排序的代币化股票：我们追踪的所有代币化美国股票，以及 p95 和最大偏差（基点）、作为对照的市场开盘时段偏差，以及流动性中位数。无活跃交易的池子会被排除，而不会被报告为完美锚定。
get_peg_sessions	$0.03	/api/peg-sessions	按交易时段查看代币化股票锚定情况：分别列出开盘前、盘前、盘后、隔夜和周末时段的偏差——每个时段均提供均值、p95、最大值（基点）和流动性中位数，并标出非交易时段中最差的时间窗口。市场开盘时段作为对照。
get_peg_deviation	$0.02	/api/peg-deviation	Solana 上代币化股票的锚定偏差：代币化美国股票的链上 DEX 价格与标的资产最近一笔真实成交价格之间的偏差，以基点表示，并提供拆分为市场开盘时段和非交易时段的 24 小时统计数据。由我们自有的采集器每 5 分钟采样一次；代币价格从链上读取。latest.reference 为 null：不返回标的资产的参考价格（其来源不允许再分发），仅返回据此计算出的偏差。

每 5 分钟采样一次。偏差以标的资产最近一笔真实成交价格为基准——在美国市场交易时段之外，该价格是收盘前的最后一笔成交价，而非实时报价。无活跃交易的池子会被排除，而不会被报告为完美锚定。

第三道护城河——我们自有的抵押品退出流动性数据流

工具	价格	路由	你能获得什么
get_exit_method	免费	/api/exit-method	测量方法，以及每条付费结果背后的行数，均在请求时根据数据流计算
get_exit_quote	$0.02	/api/exit-quote	被清算抵押品的退出流动性：清算人将 Kamino 储备中的资产接入实时路由出售后实际能收回多少，与协议为其标记的预言机价格作对比。返回 max_exitable_usd（通过二分查找得出、清算人利润仍为正的最大交易金额，并附上其分辨率宽度）、可退出比例、按 2% 惩罚率下限计算的保守界限，以及最近一次实际探测交易金额的实际所得美元数、折价（基点）和清算人利润（基点）。区分路由器拒绝为代币报价（属于权限限制，而非流动性不足）与市场没有可用路径（是真正的流动性发现）——这是两种不同的事实，此前它们共用一个状态。本代币的数据流中连续六次观测结果一致，才会给出最终判定，因此一次糟糕的报价不会造成错误发现；暂缓给出判定时，会退回到最近一次已获佐证的测量结果并注明其时效，而非返回 null。当前没有坏账并不能否定上述情况——这只意味着还没有人被迫进行大额测试。测量方法、佐证规则和行数可通过 get_exit_method 免费获取。

实时清算与连锁反应

工具	价格	路径	可获取内容
get_recent_liquidations	$0.005	/api/liquidations	加密货币清算实时行情：Bybit、OKX 和 Binance 上近期永续合约清算记录，包含时间戳、被清算方向、规模、价格和美元价值。涵盖我们记录的所有 USDT 永续合约，不只限于主流币。Bybit 行情数据完整且不受限流。
get_cascade_alert	$0.01	/api/cascade	实时清算连锁反应检测：跨交易所监测 SOL、BTC、ETH、XRP 和 DOGE 上当前发生的同方向集中清算，提供方向、美元总额、记录数、持续时间和严重程度。要查询我们记录的所有永续合约，请使用 /api/cascade-scan。
get_cascade_scan	$0.05	/api/cascade-scan	一次扫描我们记录的所有 USDT 永续合约的清算连锁反应，不只限于主流币；提供币种、被清算方向、美元总额、记录数、持续时间和严重程度。数据基于我们自己的多交易所清算行情计算。
get_liquidation_leaders	$0.02	/api/liquidation-leaders	清算排行榜：按当前清算美元金额列出我们在 Bybit、OKX 和 Binance 上记录的所有 USDT 永续合约中的领先币种，并提供多空拆分、单笔最大记录和交易所数量。查看哪些币种正遭遇剧烈波动，并按规模排序。
get_liquidation_stats	$0.01	/api/liquidation-stats	清算统计：SOL、BTC、ETH、XRP 和 DOGE 的 1 小时及 24 小时总额，包括多空美元金额拆分、单笔最大记录，以及 Bybit、OKX 和 Binance 的交易所明细。
get_liq_pulse	$0.005	/api/liq-pulse	当 Agent 需要了解当前正在发生哪些清算时使用。返回我们记录的所有 USDT 永续合约过去 60 分钟的数据：美元总额、多空拆分、记录数和排名前 5 的币种。如果我们的记录已过期，则返回 503，且不收费。
get_liq_feed	$0.001	/api/liq-feed	当 Agent 需要了解正在发生的清算压力时使用。通过无间断游标，按币种返回跨交易所每 5 秒一个时间段的多空清算美元金额、主导方向，以及相对于该币种自身基线的压力。

衍生品

工具	价格	路由	返回内容
get_funding_radar	$0.02	/api/funding-radar	覆盖所有 Hyperliquid 永续合约的资金费率雷达：截至 2026 年 10 月 13 日共 337 个，其中主 DEX 有 178 个，HIP-3 DEX（股票、指数、商品、外汇）有 159 个。每个永续合约包含：当前资金费率的 8 小时等效值、与自身已结算历史相比的 30 天 z 分数、所属 DEX 和资产类别，以及 |z| 达到 2 或以上时的标记，并按最极端者优先排列。默认返回未平仓合约价值至少为 $10M 的永续合约；min_oi_usd 可更改此阈值，设为 0 则返回全部。每 5 分钟预计算一次，并附带 as_of；快照超过 15 分钟时返回 503，且不会收费。
get_market_state	$0.02	/api/market-state	一次调用即可获取 BTC、ETH、SOL 或 HYPE 的市场状态：现货和永续合约相对于 Hyperliquid 预言机的基差、7 天和 30 天已实现波动率、带 30 天 z 分数的资金费率、未平仓合约及其变化、Hyperliquid 顶级账户的净多头占比、按方向统计的 1 小时和 24 小时清算量、恐惧与贪婪指数、下一次 FOMC 或 CPI 发布，以及带有明确阈值的标记。每项数据都附有来源和 as-of 时间；未持有的数据项会以 null 返回，并附上原因。如果无法构建任何市场本身的数据，则返回 503，且不会收费。
get_funding_extremes	$0.02	/api/funding-extremes	展示流动性高于门槛的所有 Hyperliquid 永续合约中的资金费率极值：资金费率最高和最低的合约，以及年化百分比、24 小时价格变动和未平仓合约。呈现市场中最拥挤的交易——拥挤的空头可能面临轧空。
get_open_interest	$0.01	/api/open-interest	获取任意 Hyperliquid 永续合约的未平仓合约：以基础资产数量和美元计价的未平仓合约，以及标记价格；还包括通过我们自己的 5 分钟采样器计算的 1 小时和 24 小时变化（记录尚未累积到足够时长时为 null）。/api/positioning 还会提供 SOL 和 BTC 的巨鲸净多头占比。
get_oi_spike_scan	$0.02	/api/oi-spike-scan	扫描所有 Hyperliquid 永续合约中的未平仓合约激增情况：找出过去一小时未平仓合约相对于自身前一日数据出现异常变动的币种，并提供 1 小时、4 小时和 24 小时变化（以币种数量计，因此价格变动不计入）、激增 z 分数、价格变动和资金费率。数据来自我们自己的 5 分钟采样器：记录未积累满 24 小时前，返回 503，且不会收费。
get_basis	$0.01	/api/basis	获取任意 Hyperliquid 永续合约的基差：其标记价格相对于 Hyperliquid 预言机价格（验证者对现货交易场所价格取加权中位数）的溢价或折价百分比，并提供期货升水或贴水判断及资金费率背景。
get_volatility	$0.01	/api/volatility	获取任意 Hyperliquid 永续合约的已实现波动率：根据日线蜡烛图计算的 7 天和 30 天年化波动率，以及今日振幅百分比。可用于仓位规模计算。
get_funding_history	$0.005	/api/funding-history	获取任意 Hyperliquid 永续合约的资金费率历史，最多包含 200 次按小时结算的数据：平均费率、年化百分比、费率为正的时间间隔占比，以及原始序列。展示实际获得的持仓收益。
get_top_movers	$0.01	/api/top-movers	展示流动性高于门槛的所有 Hyperliquid 永续合约中，24 小时涨幅最大和跌幅最大的合约，并附上各自的资金费率。用于筛选“哪些资产出现了变动”。
get_perp	$0.005	/api/perp	当 Agent 需要通过一次调用获取某个永续合约市场信息时使用。返回 Hyperliquid 资金费率和未平仓合约（含我们自己的 5 分钟采样器计算的 1 小时 / 24 小时变化），以及 24 小时清算数据，包含多空拆分和来自我们自身逐笔成交记录的最大单笔清算。不存在的交易品种返回 400，读取失败返回 503；两种情况都不会收费。
get_funding_pulse	$0.005	/api/funding-pulse	当 Agent 需要查看当前最极端的资金费率时使用。返回流动性高于门槛的 Hyperliquid 永续合约中，绝对值最大的 5 个年化费率，并附上各自的 8 小时费率、未平仓合约和 24 小时价格变动。一次调用即可，无需完整扫描。

微观结构

工具	价格	路由	返回内容
get_orderbook_imbalance	$0.01	/api/orderbook-imbalance	任意 Hyperliquid 永续合约的订单簿失衡情况：中间价 ±N 个基点范围内挂单买入和卖出流动性的美元金额、两侧的比值，以及失衡方向。
get_orderbook_walls	$0.01	/api/orderbook-walls	任意 Hyperliquid 永续合约的订单簿墙：订单簿两侧最大的挂单，包含美元金额和距中间价的距离。

市场与持仓情况

工具	价格	路由	返回内容
get_spot	$0.001	/api/price	当 Agent 需要现货价格但不想选择交易场所时使用。返回 SOL、BTC 或 ETH 的链上 DEX 价格，即从 Solana、Ethereum 和 Base 上的深度 USDC 池读取链上状态后得出的中位数，以及提供该价格的池。其他任何代号都会返回 400 错误和支持列表，且不会计费。
get_sol_price	$0.001	/api/sol-price	SOL 价格／Solana 美元现货价格，实时链上读取：取 Solana 上两个深度最大的 SOL/USDC 池（Orca Whirlpool、Raydium CLMM）的中位数，根据链上状态计算。返回价格、读取时间和响应的池。
get_btc_price	$0.001	/api/btc-price	BTC 价格／Bitcoin 美元现货价格，实时链上读取：取 Base 和 Ethereum 上三次 Uniswap V3 读取结果的中位数（cbBTC/USDC，以及通过 WETH/USDC 交易对的 cbBTC 和 WBTC），根据链上状态计算。返回价格、读取时间和响应的池。
get_eth_price	$0.001	/api/eth-price	ETH 美元现货价格，从 Ethereum 和 Base 上两个深度最大的 WETH/USDC Uniswap V3 池进行链上读取。返回两者的中位数以及每个池各自的价格，以便调用方查看不同链之间的价差。根据链上状态计算，不使用交易所行情源。
get_funding_rate	$0.005	/api/funding-rate	任意 Hyperliquid 永续合约的资金费率：原始费率、间隔小时数、折算为 8 小时的费率、年化费率、下次资金费时间和标记价格。不指定代号时：返回 Hyperliquid 上 SOL 和 BTC 永续合约的资金费率及未平仓合约量。含 30 天 z 分数的完整表格：/api/funding-radar。
get_market_snapshot	$0.005	/api/market-snapshot	一次调用获取加密货币市场快照：从 DEX 池链上读取的 SOL 和 BTC 现货价格、Hyperliquid 上两种永续合约的资金费率及标记价格和未平仓合约量，以及带分类的恐惧与贪婪指数。读取五项，只需支付一次。
get_positioning	$0.005	/api/positioning	Hyperliquid 上 SOL 和 BTC 永续合约的持仓情况：未平仓合约量及其 1 小时和 24 小时变化，以及 Hyperliquid 排名前 250 的账户净多头占比。其他 Hyperliquid 永续合约请使用 /api/open-interest。
get_trade_context	$0.01	/api/trade-context	一次调用获取加密货币交易背景：从 DEX 池链上读取的 SOL 和 BTC 价格、永续合约资金费率、恐惧与贪婪指数、持仓情况（未平仓合约量及 Hyperliquid 头部账户的净多头占比），以及 1 小时／24 小时清算统计。交易前所需的完整概况，只需支付一次。
get_hl_whales	$0.02	/api/hl-whales	当 Agent 需要了解 Hyperliquid 最大交易者的持仓情况时使用。返回按币种汇总的 Hyperliquid 最大账户未平仓永续合约头寸：美元计价的净多头或净空头、账户数量、按头寸规模加权的入场价、按名义价值加权的清算距离、距离清算价 10% 以内的名义价值，以及未实现盈亏。指定 coin=BTC 时：返回按 5% 价格区间划分的巨鲸清算价位和最大头寸。每 5 分钟刷新一次；数据过期时返回 503。

Solana 链上

工具	价格	路由	可获取内容
get_wallet_holdings	$0.008	/api/wallet-holdings/:wallet	任意地址的 Solana 钱包持仓：原生 SOL 及其按 AgentFeed 自有链上 SOL 价格计算的美元价值、每种 SPL 代币的铸币地址、符号和数量（无代币价格），以及 NFT 数量。余额和链上元数据通过 Helius DAS getAssetsByOwner 获取，最多 100 项资产。
get_token_metadata	$0.005	/api/token-metadata/:mint	任意 Solana 铸币地址对应的 SPL 代币元数据：名称、符号、URI、小数位数、总供应量、铸币和冻结权限、代币程序，以及元数据是否仍可更改。从铸币账户及其元数据账户读取。
get_token_risk	$0.01	/api/token-risk/:mint	任意 SPL 铸币地址的 Solana 代币跑路检查／风险信号：铸币和冻结权限状态（已撤销更安全）、前 1 名和前 10 名持有者集中度、供应量及风险标记列表。不检查蜜罐或流动性池锁定。
get_token_holders	$0.02	/api/token-holders/:mint	任意 SPL 代币的主要持有者：提供每个账户的占比，以及 Solana 铸币地址的前 1 名、前 5 名和前 10 名持有者集中度。比 /api/token-risk 中的摘要更深入。
get_wallet_activity	$0.02	/api/wallet-activity/:wallet	Solana 钱包活动：任意地址的近期交易，每笔交易都包含钱包的 SOL 和代币余额变动、手续费、失败情况及调用的程序。从链上读取并由我们汇总。
get_priority_fees	$0.005	/api/priority-fees	当前 Solana 优先费：根据过去约 150 个区块槽中最繁忙的 SOL/USDC 池所支付的每区块槽最低费用，给出从最低到最高的百分位数，单位为每计算单元微 lamport，并提供建议等级。适用于需要确保交易上链的机器人。
get_jito_tips	$0.005	/api/jito-tips	链上采样的 Jito 小费：最新转入 Jito 小费账户的 SOL 金额 p25 至 p99、已上链捆绑包实际支付的金额，每 15 分钟刷新一次（答案中会注明数据时效），并提供上链建议。
get_sol_network	$0.005	/api/sol-network	Solana 网络健康状况：近期平均 TPS、当前区块槽、当前纪元及纪元进度百分比。
get_sol_token_check	$0.025	/api/sol-token-check/:mint	当 Agent 需要在交易前检查 Solana 代币时使用。返回铸币和冻结权限、Token-2022 陷阱、主要持有者、最深流动性池及其美元深度、买入 $100 和 $1,000 的价格影响、pump.fun 进度，以及包含所有规则的判定结果。
get_sol_token_flow	$0.008	/api/sol-token-flow/:mint	当 Agent 需要了解哪些人在交易某种 Solana 代币时使用。返回该代币最近几笔兑换中的独立交易者、交易量前 5 名的占比、往返交易钱包、新买家钱包占比，以及发行时间不足 7 天的铸币地址的发行区块槽捆绑包规模。
get_sol_holder_clusters	$0.008	/api/sol-holder-clusters/:mint	当 Agent 需要了解 Solana 代币的持有者是否属于同一所有者时使用。返回最先为前 20 个钱包注资的账户、共用注资方的聚类及其供应量占比。共用注资方可能是交易所。

Base / EVM

工具	价格	路由	提供内容
get_base_gas	$0.005	/api/base-gas	Base 的 Gas 价格（链 ID 8453），同时以 gwei 和 wei 为单位返回；节点提供相关信息时，还会返回基础费用、优先费用和区块号。返回两种单位，是因为以 wei 和 gwei 查询的调用方问的是同一个问题。数据由无需密钥的公共 RPC 提供，并采用三节点故障转移，因此无需轮换或续期 API 密钥。
get_base_balance	$0.005	/api/base-balance	查询 Base 或 Ethereum 主网中 0x 地址或 ENS 名称对应的钱包 ERC20 和原生 ETH 余额。请求时会从合约读取 decimals() 和 symbol()，而不是自行假定，因为假定为 18 会使 USDC 余额大出一万亿倍。ENS 通过两个独立解析器解析，只有双方结果一致时才会采用，因此错误地址绝不会产生一个看似确定、实际属于错误钱包的余额。不支持的链会被拒绝，而不会静默地从错误链返回结果。

| get_honeypot_check | $0.01 | /api/honeypot-check | 当 Agent 需要在买入前确认 Base、BNB Chain 或 Ethereum 上的代币能否卖出时使用。返回基于我们在代币最深流动性池执行买入后卖出模拟得出的判定，并测量买入和卖出税。此外，还会返回钱包转账是否可行、字节码标记（可增发、黑名单、代理、可暂停、所有者）、模拟与字节码结果不一致之处，以及区块号。支持 Uniswap、Aerodrome 和 PancakeSwap 流动性池。未找到流动性池也会作为一项发现返回；RPC 故障则返回 503。 | | get_base_launches | $0.02 | /api/base-launches | 当 Agent 需要了解 Base 上最新的代币发行时使用。返回过去 24 小时内在 Uniswap V4、V3、V2 和 Aerodrome 上创建的 Base 流动性池，按时间从新到旧排列，并附带发行平台、流动性和交易量。每项包含交易对、创建时间、根据 V4 hook 命名的发行平台（Zora、Clanker、Doppler、Flaunch）、报价侧流动性、24 小时交易量和兑换次数，以及针对最活跃代币的蜜罐模拟结果。每分钟读取一次 Base 日志；快照超过 5 分钟时返回 503。 |

文件申报、文档与网页

工具	价格	路由	返回内容
get_sec_filings	$0.005	/api/sec-filings	当 Agent 需要了解一家美国公司的最新 SEC 文件申报时使用。返回某个股票代码对应的最新 EDGAR 文件申报，可选一种表格类型（10-K、10-Q、8-K、4、S-1、13F-HR），包含申报日期、报告日期、访问编号、说明、8-K 项目代码，以及文档和申报索引的链接。来源：SEC EDGAR 公开文件申报。
get_insider_trades	$0.01	/api/insider-trades	当 Agent 需要了解公司内部人士的买卖情况时使用。返回该公司近期 SEC Form 4 文件申报中的每笔交易，每笔交易一行：内部人士、职位、交易代码及含义、股数、价格、价值、交易后持股数和日期，以及所选时间段内的公开市场买入和卖出总额。来源：SEC EDGAR Form 4 文件申报。
get_sec_8k	$0.01	/api/sec-8k	当 Agent 需要了解美国公司在过去几小时内披露的重大事件时使用。返回所选时间段内全市场提交的 8-K 文件申报，包含公司、CIK、申报时间、访问编号、8-K 项目代码及标题（例如 2.02 业绩、5.02 高管变动、1.01 协议），以及各项目的数量。来源：SEC EDGAR 最新文件申报。
get_web_markdown	$0.005	/api/web-markdown	当 Agent 需要将网页的可读文本转换为 Markdown 时使用。将你传入的单个 URL 的主要内容整理为简洁的 Markdown（使用 Mozilla Readability，然后使用 turndown），并返回标题、最终 URL、抓取时间和字数。仅支持端口 80 和 443 上的 http 或 https，文件大小上限为 5 MB，超时为 10 秒；遵守 robots.txt，并拒绝访问私有地址。被拦截或无法访问的 URL 不会收费。
get_pdf_markdown	$0.01	/api/pdf-markdown	当 Agent 需要将 PDF 文本转换为 Markdown 时使用。逐页返回你传入的单个 PDF URL 的文本，并提供标题、页数和字数。支持 http 或 https，文件大小上限为 10 MB，超时为 10 秒；遵守 robots.txt，并拒绝访问私有地址。非 PDF 文件、没有文本层的 PDF（扫描件）或无法访问的 URL 均不会收费。

宏观经济

工具	价格	路由	返回内容
get_macro_calendar	$0.005	/api/macro-calendar	面向交易者的 FOMC、CPI、NFP 和 PCE 日历：显示下一次美联储利率决议，以及 CPI、非农就业人数和 PCE 的发布日期；时间为将纽约时间转换为 UTC 后的时间（考虑夏令时），并为每项提供美联储、BLS 或 BEA 的官方来源 URL，以及我们核实信息的时间。每天从各机构自己的页面读取数据，不手动录入；超过 35 天未核实的数据会返回 503，且不会收费。
get_fx_rates	$0.002	/api/fx-rates	当 Agent 需要官方每日汇率时使用。返回 ECB 公布的约 30 种货币兑欧元参考汇率，或以其他货币为基准计算的交叉汇率，以及 Hyperliquid HIP-3 外汇和大宗商品标记价格。ECB 汇率可在 ECB 网站免费获取；仅供参考，不可用于交易。

传统金融永续合约与股票

工具	价格	路由	可获取内容
get_tradfi_radar	$0.02	/api/tradfi-radar	按资金费率排序的股票永续合约、标普 500、纳斯达克、黄金和石油永续合约：Hyperliquid HIP-3 DEX（trade[XYZ]、Paragon、Markets by Kinetiq、Entropy）上的所有股票、指数、大宗商品和外汇永续合约，包含折算为 8 小时的资金费率、30 天资金费率 z 分数、未平仓量及其 24 小时变化、标记价格与预言机价格的差值，以及 24 小时成交量。可按资产类别筛选。每 5 分钟预计算一次；数据过期时返回 503。
get_equity_24h	$0.01	/api/equity-24h	美股周末价格：从 Hyperliquid 股票永续合约和我们的代币化股票 DEX 价格中，获取股票或指数（TSLA、NVDA、标普 500、纳斯达克）的指示性 24/7 价格，并提供最近一次常规交易时段价格、时间和来源、推算的价差百分比、每个来源的流动性，以及交易时段（开盘前、盘前、盘后、隔夜、周末）。仅供参考，绝非交易所报价；没有任何来源具备流动性时返回 503。
get_tradfi_perps	$0.005	/api/tradfi-perps	当 Agent 需要在市场交易时段以外获取股票、指数、大宗商品或货币的 24/7 价格时使用。返回 Hyperliquid HIP-3 永续合约市场：预言机价格和标记价格、溢价、每小时和 8 小时资金费率、未平仓量、24 小时变化以及 DEX。指定交易代码（TSLA、GOLD、EUR 或 xyz:TSLA）时，返回该代码的所有活跃市场；不指定时，返回完整列表。价格采用各市场自身的 HIP-3 预言机价格和标记价格。

研究、合规与实用工具

工具	价格	路由	功能说明
get_sanctions_check	$0.008	/api/sanctions-check/:address	当 Agent 需要在付款或收款前筛查加密货币钱包时使用。将 Bitcoin、Ethereum、Tron、Solana 或其他地址与 OFAC SDN 名单进行精确匹配，并返回条目、项目和名单日期。没有匹配结果不代表已获准。
get_email_verify	$0.005	/api/email-verify	当 Agent 需要判断一个电子邮件地址是否有可能收到邮件时使用。返回语法、MX、一次性邮箱域名、角色账户和免费服务商检查，并给出 deliverable_likely、risky 或 undeliverable 判定及其原因。不进行 SMTP 探测。
get_domain	$0.005	/api/domain/:domain	当 Agent 需要了解域名的基本信息时使用。返回其 DNS A、AAAA、MX、NS 和 TXT 记录，以及实时 TLS 证书信息：颁发者、备用名称、有效日期和到期天数。仅限公共主机；不提供注册商数据。
get_papers	$0.015	/api/papers	当 Agent 需要查找某个主题的学术论文时使用。返回搜索到的 OpenAlex 作品（CC0 数据），最多 25 篇，包含标题、年份、DOI、作者、出版物、引用次数和开放获取链接；也可指定起始年份。缓存 24 小时。
get_paper	$0.005	/api/paper/:doi	当 Agent 需要查找 DOI 对应的论文时使用。返回标题、年份、作者、出版物、引用次数、开放获取 URL，以及 OpenAlex 收录的摘要（CC0 数据）。DOI 按原样放入路径中，包括斜杠：/api/paper/10.1038/nature14539。
get_wiki	$0.005	/api/wiki	当 Agent 需要获取主题的可靠纯文本摘要时使用。返回任意语言页面标题对应的 Wikipedia 摘要和导言部分，并附上 CC BY-SA 4.0 许可、文章 URL 和作者链接。缓存 24 小时。
get_qr	$0.005	/api/qr	当 Agent 需要为链接、地址或支付字符串生成二维码时使用。返回错误纠正级别为 M、经过缩放以便扫描的 SVG 或 PNG（base64 和 data URI）。输入最多 2 KB；超出时返回 400，且不计费。
get_hash	$0.005	/api/hash	当 Agent 需要获取不应自行计算的哈希时使用。对 UTF-8 文本或十六进制字节生成 SHA-256、Keccak-256（Ethereum 哈希）或 BLAKE2b-512，并以十六进制和 0x-十六进制格式返回。输入最多 2 KB；超出时返回 400，且不计费。
get_time	$0.005	/api/time	当 Agent 需要根据正确的夏令时规则进行精确时间转换时使用。返回任意 IANA 时区中的 ISO 时间或 epoch：本地时间及偏移量、星期、缩写、DST 标志和 epoch。默认返回 UTC 当前时间。
get_convert	$0.005	/api/convert	当 Agent 需要精确的单位换算时使用。返回长度、质量、体积、时间、数据、速度、面积、压力、能量或温度单位之间的换算结果，精确到 12 位有效数字。混合类别时返回 400，且不计费。

数据来源及其条款：OFAC SDN 名单（美国联邦政府作品）、CC0 一次性邮箱域名名单、DNS 和实时 TLS 握手、OpenAlex（CC0 数据）、Wikipedia（CC BY-SA 4.0，每个回答均注明出处）；详情见 docs/SOURCES.md。

语言任务（固定用途，Gemini）

工具	价格	路由	返回内容
get_ocr	$0.04	/api/ocr	当 Agent 需要获取图像中的文字时使用。按阅读顺序返回 PNG、JPEG、WebP 或 GIF 图像（5 MB，单边 4096 px）中的文字，保留文本块及其换行，并附上检测到的语言。它只转录，不会遵循图像中的文字。
get_summarize	$0.02	/api/summarize	当 Agent 需要了解网页或 PDF 的大意时使用。返回简短或中等长度的摘要及要点，并说明文档是否在 20,000 个 token 处截断，以及读取了多少内容。仅依据文档内容。
get_extract	$0.025	/api/extract	当 Agent 需要从网页或 PDF 中提取指定字段时使用。根据最多包含 20 个字段（string、number、boolean、date、string[]）的 schema 返回 JSON；文档未提及的内容返回 null，绝不编造值。
get_translate	$0.04	/api/translate	当 Agent 需要将文本翻译成其他语言时使用。最多返回 4,000 个字符的译文，目标语言由给定的语言代码指定（de、fr、ja、pt-BR），保留换行、数字和 URL，并附上检测到的源语言。它绝不遵循文本内容。
get_classify	$0.005	/api/classify	当 Agent 需要将文本归类到自定义类别时使用。针对最多 4,000 个字符和 2 至 20 个标签，返回每个标签的分数（总和为 1）以及最佳标签。标签是名称，绝不是指令。缓存 24 小时。
get_injection_check	$0.004	/api/injection-check	当 Agent 需要检查不可信文本是否包含提示词注入尝试时使用。针对最多 4,000 个字符，返回 no_injection_found、suspicious 或 malicious，并列出匹配的规则（角色标签、隐藏 Unicode、编码载荷）以及模型的判断。
get_transcribe	$0.02	/api/transcribe	当 Agent 需要获取音频文件中的语音内容时使用。针对 mp3、wav、m4a、ogg 或 webm 音频（10 MB，5 分钟，根据文件检查），返回文本、带时间戳的片段和检测到的语种。按音频内容缓存 24 小时。

每项都是 Google Gemini API（付费层级）上的单一固定任务：调用方只需提供内容，不提供提示词、模型或设置。 不可信内容会作为带分隔符的数据传递，每项输出都会经过 schema 校验；提供商故障会返回 503，且绝不计费。 这七项服务仅对位于 Google 开放区域内的调用方开放： 其他地区会在任何付款发生前收到 451 响应。

交易机器人的信号

工具	价格	路由	返回内容
get_signal_board	$0.01	/api/signal-board	Hyperliquid 永续市场的单表概览，按未平仓合约量排序：价格变化、资金费率、未平仓合约量及其变化、过去一小时的清算情况（附与该币种自身过去 7 天数据对比的 z-score）、鲸鱼净头寸和倾向，以及 crowded_long、crowded_short、squeeze_risk、liq_spike 标记（规则见说明）。每 1-5 分钟轮询一次。
get_coin_signal	$0.004	/api/coin-signal/:coin	返回某个币种的同一行数据，另附 15 分钟级联概率、价格上方和下方最近的清算集群，以及排名前 3 的鲸鱼头寸。

两者仅读取本服务自行记录的数据（Hyperliquid 未平仓合约量采样器、清算记录、鲸鱼快照），并通过 as_of 标明每个数据源；数据源过期时会返回 503，且绝不计费。使用预付费密钥时，价格分别为 $0.005 和 $0.002。

供机器人使用的清算压力信息流

GET /api/liq-feed 提供跨交易平台的清算压力数据，由 AgentFeed 根据自身记录的清算数据计算，并以适合机器人轮询的方式提供：5 秒分桶、永不跳过或重复的游标，以及最低价格。

• 每一行代表什么。 每个有清算发生的已结束 5 秒分桶，每个交易品种一行：longs 和 shorts（多头和空头仓位被清算的金额，含 USD、基础数量和 VWAP，所有交易平台合并为一个数值）、dominant（longs、shorts 或 balanced：占该分桶至少 60% 的一方）和 pressure（该分桶的 USD 金额相对于该交易品种自身典型的每 5 秒 USD 金额的比值；后者是过去 7 天中位数小时值，最低为每小时 $5,000）。数值四舍五入到 2 位有效数字（VWAP 为 3 位），不返回成交笔数。
• 游标。 发送一次 since=<ms>（最多回溯 24 小时；不提供时，首次调用从 2 分钟前开始），之后将每次响应中的 next 原样传回。分桶结束 10 秒后才会提供，每个已结束分桶只提供一次；has_more 会提示你立即再次请求。每次调用最多可查询 20 个交易品种、返回 500 行（symbols=BTC,ETH,SOL 或 BTC-USDT 格式）。
• 机器人调用的费用。 通过 x402 每次调用 $0.001，使用预付费密钥时每次 $0.0005。每位调用者、x402 付款方或预付费密钥每 5 秒（一个分桶）可调用一次；通行密钥每 10 秒可调用一次（被拒绝的轮询会返回 429 和 Retry-After，不会收费；收到 has_more 响应后发起的调用不受此限制）。一个密钥在 REST 和 MCP 工具 get_liq_feed 之间共用同一个计时器；通过 REST 调用时，x402 付款方按 IP 识别，通过 MCP 调用时则按付款钱包识别。时间范围每 5 秒前进一次，因此，更快的调用也无法获取新的分桶。按 5 秒的最低间隔计算，密钥每天可调用 17,280 次，费用为 $8.64；按 30 秒轮询，每天调用 2,880 次，费用为 $1.44；按 60 秒轮询，费用为 $0.72。机器人通行证（30 天 $25 固定费用，仅适用于此路由）每天只需 $0.83，轮询频率不限。

curl -s -H "X-AgentFeed-Key: $AGENTFEED_KEY" \
  "https://x402.ochinimus.app/api/liq-feed?symbols=BTC,ETH,SOL&since=$(( $(date +%s) * 1000 - 300000 ))"

免费试用工具

共七个，其中四个提供 HTTP 路由——这四个会发布在 / 下的 free_tools 中。其余三个仅支持 MCP，没有可替代的付费 HTTP 版本。

工具	路由
get_fear_greed	/api/fear-greed
get_last_liquidation	/api/last-liquidation（延迟 15 分钟）
get_exit_method	/api/exit-method
get_cascade_forecast_free	仅 MCP — 提供完整质量的 SOL 清算预测，不会省略任何内容
get_forecast_question	仅 MCP — 说明预测回答的问题，以及如何自行结算
get_forecast_record	/api/forecast-record — 实时已结算记录及原始行
pricing	仅 MCP — 列出所有内容及实时价格

另外两个免费 HTTP 端点不对应任何独立工具：

端点	返回内容
GET /api/sample	列出所有存有样本响应的付费路由
GET /api/sample/<route>	某个付费路由实际捕获的响应——与其 Bazaar 条目中的示例相同——并附带价格、输入架构和付费 URL。付费前可查看路由会返回什么。

免费路由返回 "paid": false，付费路由返回 "paid": true，因为该字段针对每次请求：它说明你调用的路由是否收费。使用 curl 调用上述任一端点都无需付费，响应也会明确说明这一点。

在 elizaOS Agent 中使用

npm i @seekdaseek/plugin-agentfeed   # one action per data route; the current version is on npm

将 AGENTFEED_PRIVATE_KEY 设置为有余额的 Solana 钱包，Agent 就会自动按次付费。默认单次调用支出上限为 $0.50（可通过 AGENTFEED_MAX_SPEND_PER_CALL 修改）。

立即免费试用

curl https://x402.ochinimus.app/api/fear-greed       # "paid": false — it really is free
curl https://x402.ochinimus.app/api/last-liquidation
curl https://x402.ochinimus.app/api/exit-method
curl https://x402.ochinimus.app/                    # full pricing index + live coverage
curl https://x402.ochinimus.app/api/cascade-scan    # returns 402 + payment terms

x402 客户端会自动付款并重试。

预付费密钥（适用于无法支付 x402 的机器人）

能够设置 HTTP 标头但无法签署 x402 付款的机器人（n8n、Freqtrade、Hummingbot、普通脚本、claw402 等网关）只需购买一次密钥，即可按调用次数消费余额。

• 一次购买：使用任意 x402 客户端，通过路由提供的任意精确支付方式购买：GET /api/keys/buy-trial（$0.25）、buy-1、buy-5、buy-20。通过标头发送密钥，即可使用 topup-5 或 topup-20 充值。也可以在浏览器中使用 Base 钱包访问 /keys：该页面不会加载任何库，只会发送密钥的哈希值。
• 按调用次数消费：在任何付费 GET 请求或 POST /mcp 中发送 X-AgentFeed-Key: afk_...（或 Authorization: Bearer afk_...）。每次调用从余额中扣除该路由 x402 价格的一半，最低 $0.0005；400、404、500 或 503 响应不会扣费。每个密钥每分钟最多 120 个请求。
• 自带密钥：自行生成 afk_ + 32 个随机字节的 base58 编码，并通过 ?key_hash=<sha256 hex>&prefix=<8 characters after afk_> 购买；服务器会登记哈希值，且永远不会看到密钥。付款后即使连接中断也不会损失任何东西。如果不提供 key_hash，服务器会生成密钥并仅返回一次。
• 机器人通行证：GET /api/keys/buy-pass（$25）是另一种密钥，适用于全天轮询 /api/liq-feed 的机器人：从付款结算时起有效 30 天，仅可用于 /api/liq-feed（以及 MCP 工具 get_liq_feed），每次调用不扣费，但仍限制每 10 秒调用一次。其他所有路由都会向其返回 403，且不能充值；GET /api/keys/balance 会显示其可用路由和到期时间。按每 30 秒轮询一次计算，每天费用为 $0.83；普通密钥则为每天 $1.44。
• 日通行证：GET /api/keys/buy-day-pass 的价格为 $1.00 固定费用，有效期为 24 小时，从付款结算时起计算；仅可用于 /api/liq-feed 和 /api/liquidations，每次调用不扣费；这两个路由各自每个密钥每 10 秒只能调用一次（每分钟 6 次；10 秒内再次调用会返回带有 Retry-After 的 429 响应，且不会扣费）。默认 x402 客户端可直接购买此通行证：@x402/fetch 2.28 在签名前会拒绝任何超过 $1 的付款，并接受恰好 $1.00 的付款（实测如此），因此 $5 和 $20 套餐及 $25 机器人通行证需要提高 spendControls，而日通行证不需要。其他所有路由都会向其返回 403，且不能充值；GET /api/keys/balance 会显示其可用路由、到期时间和剩余小时数。也可在浏览器中访问 /keys。
• 余额：免费使用 GET /api/keys/balance，并在请求中发送标头。
• 条款：预付费余额是使用额度，不予退款且永不过期（机器人通行证为固定价格、不予退款，有效期 30 天；日通行证同样不予退款，有效期 24 小时）；密钥是持有者凭据（任何持有密钥的人都可以消费余额）；滥用将导致密钥被撤销。购买路由只提供精确金额的付款方式，因为通过半价批量购买或 Gateway 套餐购买的额度会变成免费赠送 50%。
• 账目记录：购买记录是已结算的付款（状态为 paid）；其支付的调用记录状态为 key，表示已计入的额度消耗，绝不是收入。

没有钱包？使用 Apify Store

五个 AgentFeed 数据集也是 Apify Store actor。Store 通过 Apify 以法币计费，因此无需钱包。

Actor	返回内容	价格
加密货币清算热力图与地图：真实的 Hyperliquid 持仓	最大 Hyperliquid 账户的未平仓持仓中，按 5% 价格区间划分的清算水平	每种币 $0.008
学术论文搜索：OpenAlex，Google Scholar 的替代方案	来自 OpenAlex CC0 数据的论文，可按搜索词或 DOI 查询	每篇论文 $0.003
按股票代码查询美国公司申报文件：10-K、10-Q、8-K、Form 4	按股票代码查询 SEC EDGAR 系统中的近期公开申报文件	每份申报文件 $0.002
PDF 转 Markdown：从任意 PDF URL 提取干净文本	按页输出 PDF 文本，格式为 markdown	每份 PDF $0.01
AI 数据提取器：根据你的架构将网页或 PDF 转为 JSON	从网页或 PDF 中提取符合你所指定字段的结构化 JSON；页面未注明的字段为 null	每页 $0.02

价格按结果计费，此外每次运行还需支付 Apify 的 $0.00005 启动费。

在 NOFX 中使用 AgentFeed

NOFX 是一款开源 AI 交易终端。get_signal_board 和 get_coin_signal 的数据结构适用于其 External Data Sources：data.coins 是一个按未平仓合约量排序、以币种为键的对象，data.ranked 是列表，data.sources 列出各个来源；包含 30 种币的看板约为 10 KB。**请先阅读此说明：**在 NOFX 的提交版本 ef476f2 中，没有任何代码调用获取 External Data Sources 的函数（StrategyEngine.FetchExternalData），因此原版 NOFX 会保存这两项配置，却不会将其读入提示词；在会调用该函数的 NOFX 构建版本中，它们可以正常工作，同一个密钥也可供任何发送请求头的客户端使用。docs/nofx.md（中文）包含完整的策略 JSON、如何使用 NOFX 已用于支付 claw402 的钱包购买密钥、每位交易者的费用（按 NOFX 默认的 15 分钟扫描频率计算，看板每天约 $0.48，每种币每天约 $0.19），以及用于对照实时路由重放 NOFX 获取过程和 data_path 遍历的验证工具。

支付调用费用

**payTo 只能从最新的 402 响应中复制，切勿从交易历史中复制。**在 2026-07-31，有人伪造了与 Base 国库地址相似的地址（与 0x22DB…76e6 的首尾字符相同），向我们最大的买家发送了零金额地址投毒转账，因此 钱包的历史记录中可能会在真实收款方旁显示一个假收款方。

x402 — 本仓库内置的客户端

test-client.mjs 是本仓库自带的 Solana x402 付款客户端：通过 wrapFetchWithPaymentFromConfig 使用 @x402/svm 的 ExactSvmScheme，并读取标准的 solana-keygen 64 字节 JSON 密钥对。

node test-client.mjs https://x402.ochinimus.app/api/sol-price ./payer-wallet.json

test-client-evm.mjs 是通过 viem 账户在 Base（eip155:8453）上运行的同类客户端，test-mcp-client.mjs 则通过 Streamable HTTP 支付 MCP 工具调用。结算记录会写入审计表，其中包含付款方和交易签名；该客户端最近一次使用项目自有付款方 GBFoGJXvLsgBXAKJw9cGK18BGxaevpYtAyQKoqgcSQKz 运行时，结算交易为 4ixeZSHSYcBcx5PhRDvPbLwMY2Vgj24FPkjnCaBkewhfcva2kHj32suXv7UE2M4NGsh4q31yGJRqx5nvqbBLNxvD。

MPP — Foundation 的 pay CLI

pay --mainnet --mpp --account <account> curl -s https://x402.ochinimus.app/api/btc-price

该服务于 2026-09-19 的 21:53:39 和 21:57:36 UTC 各完成了一笔 MPP 支付，两笔支付的签名都已记录在重放存储中，因此都无法重复花费。

pay CLI 需要交互式会话。 auth_required: true 的账户会卡在 Touch ID 提示上，而该提示无法在 CI、无头 Agent 或计划任务中显示；并且它会无限期卡住——在没有占用任何 TCP 套接字的情况下，看起来就像网络挂起。这就是 solana-foundation/pay #469。请在真实的 GUI 会话中运行，或使用没有 auth_required 的账户。

MCP 快速入门

让任意 MCP 客户端连接到 https://x402.ochinimus.app/mcp（Streamable HTTP，POST）。付费工具会返回支付条款；支持 x402 的客户端会完成支付并重试。

已发布的 @x402/mcp 会导出 createx402MCPClient（已根据 npm tarball 2.27.0 进行核验，日期为 2026-09-23）。本仓库中的 test-mcp-client.mjs 实际上就是这样做的：

import { createx402MCPClient } from '@x402/mcp';
import { ExactSvmScheme } from '@x402/svm/exact/client';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = createx402MCPClient({
  name: 'agentfeed-test',
  version: '1.0.0',
  schemes: [{ network: 'solana:*', client: new ExactSvmScheme(signer) }],
  autoPayment: true,
});

await client.connect(new StreamableHTTPClientTransport(new URL('https://x402.ochinimus.app/mcp')));
const { tools } = await client.listTools();
const result = await client.callTool('get_sol_price', {});   // pays and retries

也可用作 elizaOS 插件。

---

配置

服务读取的所有变量，均从源码中提取（grep -rhoE "process\.env\.[A-Z0-9_]+"）。只有 HELIUS_API_KEY、PAY_TO 和（启用 MPP 时的）MPP_SECRET_KEY 没有可用的默认值。

变量	默认值	备注
PORT	3006
HELIUS_API_KEY	—	必填；构建主要的 Solana RPC URL（仅链上状态，不含 DAS）。如果 Helius 额度用尽或服务宕机，调用会转至 RPC_FALLBACKS（如下）
HELIUS_RPC	https://mainnet.helius-rpc.com/?api-key=$HELIUS_API_KEY
SOLANA_RPC_URL	Helius，来自 HELIUS_API_KEY	所有 Solana 读取操作的主要标准 RPC 端点：链上现价、锚定数据、代币和钱包路由（lib/solrpc.js）
RPC_FALLBACKS	https://api.mainnet-beta.solana.com	以逗号分隔的 https URL 列表（空值 = 无）。如果主端点返回 HTTP 429、402、403、5xx，连接中断或超时，同一调用会转至下一个 URL，并且主端点会被停用 10 分钟。没有端点响应时返回 503（不收费），绝不会返回过时或不完整的付费结果。devnet 或 testnet 主端点不会使用备用端点。每 10 分钟输出一条 rpc_usage 记录，统计各方法和主机的调用次数（仅记录主机，不记录密钥）
JITO_RPC_PRIMARY、JITO_RPC_FALLBACKS	公共主网 RPC；上面的主端点	Jito 小费采集器（bin/jito-tips-collect.js，每 15 分钟运行一次）先从免费的公共 RPC 读取，仅在备用时使用 Helius
X402_MODE	on	off 会让所有路由免费提供服务
X402_NETWORK	—	X402_MODE 为 on 时必填：生产环境使用 mainnet，测试使用 devnet；未设置时启动失败
PAY_TO	—	必填；接收 USDC 的 Solana 财库地址
PAY_TO_EVM	—	所有 EVM 支付通道使用的 EVM 财库地址；未设置时，所有 EVM 支付通道都会从支付挑战中移除
X402_EVM_NETWORKS	未设置（全部）	以逗号分隔的 CAIP-2 ID，用于缩小原有 EVM 支付通道范围（Base、Polygon、Arbitrum、Arc），例如 eip155:8453 表示仅使用 Base；R10 网络由 X402_EXT_NETWORKS 缩小范围
X402_EXT_NETWORKS	未设置（全部）	以逗号分隔的 CAIP-2 ID，用于缩小 R10 网络范围（lib/ext-rails.js）；X402_EXT=off 会移除所有这些网络，X402_ULTRAVIOLETA=off 和 X402_PAYAI=off 会分别移除一个支付协调方的条目
FACILITATOR_URL	—	X402_MODE 为 on 时必填；未设置时启动失败。生产环境使用 CDP 支付协调方：https://api.cdp.coinbase.com/platform/v2/x402
MPP_ENABLED	未设置（关闭）	true 会挂载 solana/charge 层
MPP_SECRET_KEY	—	MPP_ENABLED=true 时必填；长度必须达到 32 个字符或更长 — mppx 会对挑战 ID 进行 HMAC 绑定，使验证过程无状态；初始化时会拒绝任何更短的值
MPP_NETWORK	mainnet
MPP_REALM	x402.ochinimus.app	WWW-Authenticate 挑战中的 realm
MPP_RPC_URL	Helius，来自 HELIUS_API_KEY
LIQ_DB	/opt/agentfeed/liquidations.db	清算数据流（只读）
PEGWATCH_DB	/opt/pegwatch/pegwatch.db	切换前的代币化股票锚定数据流及其基准（只读）
PEG_ONCHAIN_DB	与源文件位于同一目录的 peg-onchain.db	我们的链上锚定数据流，由 bin/peg-collect.js 写入
JITO_TIPS_FILE	与源文件位于同一目录的 jito-tips.json	链上 Jito 小费样本，由 bin/jito-tips-collect.js 写入
OVERHANG_DB_PATH	/opt/overhang/overhang.db	抵押品退出流动性数据流（只读）
CALIPER_DIR	/opt/caliper	预测模型目录
CALIPER_MODEL	$CALIPER_DIR/model.json
CALIPER_RECORD_DB	$CALIPER_DIR/record.db
CALIPER_LIQ_DB	/opt/agentfeed/liquidations.db
TELEGRAPH_LOG	与源文件位于同一目录	请求结构日志
BYBIT_WS BYBIT_API BYBIT_MAX_SYMBOLS	Bybit 公共接口，仅用于清算数据流（自 R7 起，没有路由读取 Bybit 市场数据）	1000 个交易对上限
OKX_WS OKX_API	OKX 公共接口，仅用于清算数据流（自 R6 起，没有路由读取 OKX 市场数据）
BINANCE_WS	Binance 公共接口，仅用于清算数据流（自 R6 起，没有路由读取 Binance 市场数据）
HL_API	https://api.hyperliquid.xyz/info
BASE_RPC	https://mainnet.base.org
DB_PATH、SIGNATURE、VERIFY_DELAY_MS、HOME 和 PATH 仅出现在 MPP 测试
框架（mpp/test/helpers/）中，并非服务配置。

测试

npm install
cd mpp && npm install && cd ..    # separate tree: mppx pins express>=5, this service is express 4

node --test test/tool.test.js     # 10 tests — the route wrapper and the `paid` flag
node --test mpp/test/*.js         # 40 tests — MPP conformance, offline, every RPC call stubbed

两个 package.json 都没有声明 test 脚本；上面的命令是测试 文件本身记录的命令。

test/tool.test.js 会在一个临时 express 应用上，通过真实套接字挂载来自 lib/tool.js 的真实包装器——这与 server.js 挂载的是同一个模块，并非副本——因此 req.route 的填充方式与生产环境完全一致。它涵盖了一个收费路由、一个路径参数路由（这证明标志匹配的是已注册的模式，而非请求 URL）、一个未收费但仍通过价格参数注册的路由、X402_MODE=off、成功／错误／bad_request 时审计行的字段集合，以及通过 req.route.path 进行原型污染的情况。

两项 MPP 测试会派生真实工作进程，在进程边界之间对重放存储进行竞争测试，而非在一个事件循环中模拟竞争。

---

免费数据集

一份涵盖多个交易场所的清算数据集——已标准化、每日增长且免费——附带完整的质量说明，涵盖数据覆盖日期、已知缺漏、交易所限流和字段定义：ochinimuse.gumroad.com/l/liqdata

使用前请阅读 DATASET_QUALITY.md。其中会准确说明数据在哪些地方有误。

---

链接

MCP Registry · Smithery · x402 清单 · ochinimus