x402nano

x402nano

为什么选择 x402nano

x402nano 为 AI Agent 和 MCP 客户端提供可通过机器支付的 Polymarket 市场情报。它提供免费的市场发现和定价工具，以及付费的只读 Market Brief 和 Market Delta 工具，每次调用收费 0.05 USDC，网络为 Base 主网。

它不会进行交易、下注或托管资金，也不提供财务建议。买方密钥始终保存在调用方本地，x402nano 永远不会接收或存储这些密钥。

在线服务： https://x402nano.onrender.com

公开的 Market Watcher 演示： https://x402nano-market-watcher.bobjonesgood.chatgpt.site

x402nano 是一个独立项目，与 x402nano.org 或 Nano/XNO 加密货币均无关联。“nano”指的是本项目范围精简、按请求付费的情报服务。提及 x402、Base、Polymarket、USDC 和 MCP，仅用于说明技术兼容性或公开数据来源，并不代表这些项目对 x402nano 的认可。

MCP 服务

x402nano 使用生产级 Streamable HTTP 传输协议，提供公开、无状态的 MCP 端点：

https://x402nano.onrender.com/mcp

该远程服务提供免费的市场发现和定价工具，以及受 x402 保护、收费 0.05 USDC 的 Market Brief 和 Market Delta 工具。付费 MCP 调用使用官方 x402 MCP 支付流程：调用方在本地签名，由 facilitator 在 Base 上验证并结算；x402nano 绝不会接收或存储买方私钥。

此代码库还保留了经过验证、采用保守支付预算的本地 stdio MCP 服务。有关这两种连接方式、免费验证和客户端要求，请参阅 mcp-server/README.md。符合标准的远程服务清单位于 server.json。

Agent 快速入门

对于新的 MCP 客户端或自主 Agent：

1. 在官方 MCP Registry 中查找 io.github.Bobjonesgood/x402nano。
2. 连接到 Streamable HTTP 远程服务：https://x402nano.onrender.com/mcp。
3. 列出工具，并确认存在 list_trending_markets、get_market_pricing、get_market_brief 和 get_market_delta。
4. 调用 list_trending_markets 选择一个市场 slug。
5. 调用 get_market_pricing 确认 Base 主网定价。
6. 使用支持 x402 的 MCP 客户端调用 get_market_brief 或 get_market_delta。

定价和支付范围：

• 免费工具：list_trending_markets、get_market_pricing。
• 付费工具：get_market_brief、get_market_delta。
• 价格：每次调用付费工具收费 0.05 USDC，即 50000 个原子单位。
• 网络：Base 主网，eip155:8453。
• 卖方：0x4cc3831eB479aCFb6D44631d4a30814508Cf52d3。
• 买方密钥始终保存在调用方本地。x402nano 绝不会接收或存储买方私钥。
• 输出仅提供只读市场情报，不涉及交易、下注或财务建议。

您购买的内容

x402nano 不出售原始 Polymarket 数据，而是出售面向 Agent 的打包市场情报对象，帮助 Agent 无需自行整合市场元数据、当前价格、变动历史、评分、收据处理和安全边界。

付费市场简报包括：

• 市场标识、问题、类别、状态、结束日期和来源 URL
• 当前领先结果及其隐含概率
• 结果定价摘要和主要结果
• 成交量、24 小时成交量、7 天成交量、流动性，以及可用时的变动背景
• 可用时，根据公开价格历史提供的 24 小时变动摘要
• 结算／来源背景和数据质量说明
• 描述性评分：变动、关注度和数据完整性
• 供 Agent 后续检查的观察要点
• 证明已付费解锁的收据元数据
• 非建议声明

付费市场变动报告包括：

• 自调用方提供的 since 时间戳以来的变化
• 可用时，领先结果的起始／结束概率
• 概率绝对变化和相对变化
• 方向、变化标记、重复检查优先级和异常变动标记
• 当前成交量／流动性背景
• 可用时的轨迹数据点
• 说明缺失历史数据或最近数据点的质量说明
• 证明已付费解锁的收据元数据
• 非建议声明

付费市场简报响应示例：

{
  "status": "unlocked",
  "receipt": {
    "id": "receipt-id-after-payment",
    "amount": "0.05",
    "asset": "USDC",
    "network": "eip155:8453"
  },
  "data": {
    "briefType": "read-only-market-intelligence",
    "market": {
      "slug": "example-polymarket-slug",
      "question": "Will example event happen in 2026?",
      "status": "active",
      "url": "https://polymarket.com/event/example"
    },
    "snapshot": {
      "generatedAt": "2026-06-29T12:00:00.000Z",
      "source": "polymarket:gamma",
      "leadingOutcome": "Yes",
      "leadingOutcomeImpliedProbability": "42.0%"
    },
    "metrics": {
      "volume24h": "17,260.91",
      "liquidity": "81,697.04"
    },
    "movement": {
      "window": "24h",
      "direction": "up",
      "absoluteChange": "0.032"
    },
    "scores": {
      "marketMovementScore": 61,
      "attentionScore": 72,
      "dataCompletenessScore": 100,
      "unusualMovementFlag": false
    },
    "watchPoints": [
      "Watch whether the leading outcome changes, flattens, or reverses over the next observation window."
    ],
    "boundaries": [
      "Read-only public market data summary.",
      "No trading execution.",
      "No custody of user funds.",
      "No buy/sell/bet recommendation."
    ]
  }
}

付费市场变动报告响应示例：

{
  "status": "unlocked",
  "receipt": {
    "id": "receipt-id-after-payment",
    "amount": "0.05",
    "asset": "USDC",
    "network": "eip155:8453"
  },
  "data": {
    "briefType": "read-only-market-delta",
    "market": {
      "slug": "example-polymarket-slug",
      "question": "Will example event happen in 2026?"
    },
    "window": {
      "since": "2026-06-29T11:00:00.000Z",
      "until": "2026-06-29T12:00:00.000Z"
    },
    "change": {
      "source": "polymarket:clob",
      "outcome": "Yes",
      "startProbability": 0.388,
      "endProbability": 0.42,
      "absoluteChange": "0.032",
      "relativeChange": "+8.2%",
      "direction": "up",
      "changed": true
    },
    "significance": {
      "repeatCheckPriority": "medium",
      "unusualMovementFlag": false,
      "summary": "The leading outcome moved up by 0.032 over the requested window."
    },
    "dataQuality": {
      "priceHistoryAvailable": true,
      "usedNearestHistoryPoint": false,
      "notes": [
        "Delta is computed from available public market data.",
        "This endpoint does not store caller state; clients provide the since timestamp."
      ]
    }
  }
}

时效性和方法：

• 有效付款后，按需生成付费简报和变动报告。
• 公开时效性元数据声明预期最大时效为 90 秒；付费内容在付款前始终由 402 限制访问。
• 简报变动信息使用最新的公开 Polymarket 数据，以及可用时的 24 小时领先结果历史数据。
• 变动报告根据公开的 Polymarket CLOB 价格历史，计算调用方提供的 since 时间戳至最新可用数据点之间领先结果代币的变动。
• 如果无法获取精确历史数据，响应会在 dataQuality 中说明，而不会假装精确。
• 评分是根据变动幅度、成交量、流动性和数据可用性得出的描述性启发式评分，不是预测或建议。

面向 AI Agent 和机器人的可机器支付市场情报 API。

x402nano 通过 HTTP 402 付款流程提供只读 Polymarket 市场简报。Agent 请求市场简报后会收到付款验证请求，随后携带 X-PAYMENT 重试，即可收到解锁后的 JSON 和收据。

这是市场情报基础设施，不是交易建议。

付费简报包括 24 小时市场变动、成交量／流动性背景、结算背景、观察要点和安全的描述性评分。不包括交易执行、托管、投注建议或买卖建议。

在线端点

https://x402nano.onrender.com

免费发现／趋势端点：

GET https://x402nano.onrender.com/api/markets/trending

付费市场简报端点：

GET https://x402nano.onrender.com/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel

付费市场变动报告端点：

GET https://x402nano.onrender.com/api/markets/delta?slug=will-gideon-saar-be-the-next-prime-minister-of-israel&since=2026-06-15T12:00:00Z

历史主网证明

以下是在 Base 主网上进行的独立历史测试，均已获得所有者批准。它们证明了过去发生过付费解锁；并非付款操作说明。

证明	发起方	购买的资源	价格和网络	交易	当前行为
直接访问核心 Market Brief	x402nano 专用本地买家脚本	GET /api/markets/brief?slug=...	在 Base 主网上支付 0.05 USDC（eip155:8453）	BaseScan · receipt f1ffa2f5cabf94c3	核心付费简报端点仍在运行；此交易仅为历史记录。
直接访问核心 Market Delta	x402nano 专用本地买家脚本	GET /api/markets/delta?slug=...&since=...	在 Base 主网上支付 0.05 USDC（eip155:8453）	BaseScan · receipt 75fe7c800fed47d4	核心付费增量端点仍在运行；此交易仅为历史记录。请参阅证明说明。
Market Watcher 配套客户端证明	经所有者批准的受控 Market Watcher 客户端	通过配套购买流程购买一份 x402nano Market Brief	在 Base 主网上支付 0.05 USDC（eip155:8453）	BaseScan	仅为历史配套客户端证明。公开的 Market Watcher 部署仍以 mock 为先，真实支付已禁用，且没有买家密钥。

核心直接访问证明验证了 HTTP 402 挑战、本地签名后的支付重试、链上 USDC 结算、收据生成，以及只读 JSON 解锁。卖家钱包地址为 0x4cc3831eB479aCFb6D44631d4a30814508Cf52d3。

证明参考：

Direct core Market Brief transaction:
https://basescan.org/tx/0x54ba49a288a56d20046c25f4496bec405f2eefc05fe413cd511caf96227911b1

In-repo proof notes:
TRUST.md
ARCHITECTURE.md
LISTING_METADATA.md
DIRECT_DELTA_X402_PRODUCTION_UNLOCK_PROOF.md

注意：真实解锁后，本地买家脚本因支付后立即读取的买家余额已过时而以非零状态退出。卖家余额已更新，收据和事件已记录；之后进行的无支付余额检查确认，买家余额从 1.00 USDC 降至 0.95 USDC。

买家流程

1. 发现 API。

GET https://x402nano.onrender.com/.well-known/x402.json

2. 请求付费市场简报。

Invoke-WebRequest `
  -Uri "https://x402nano.onrender.com/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel" `
  -UseBasicParsing

3. 预期收到 402 Payment Required。

响应包含类似以下内容的支付要求：

{
  "error": "payment_required",
  "paymentRequirements": {
    "network": "eip155:8453",
    "asset": "USDC",
    "amount": "0.05",
    "payTo": "0x4cc3831eB479aCFb6D44631d4a30814508Cf52d3",
    "resource": "/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel"
  }
}

4. 签名并发送 x402 支付。

使用兼容 x402 的客户端签署 Base 主网 USDC 支付，然后使用以下内容重试相同请求：

X-PAYMENT: <signed-x402-payment>

5. 接收已解锁的 JSON。

成功的付费响应包含收据和市场简报内容：

{
  "receipt": {
    "id": "f1ffa2f5cabf94c3",
    "network": "eip155:8453",
    "amount": "0.05",
    "asset": "USDC"
  },
  "data": {
    "briefType": "read-only-market-intelligence",
    "status": "ok",
    "market": {
      "slug": "will-gideon-saar-be-the-next-prime-minister-of-israel"
    },
    "movement": {
      "window": "24h",
      "direction": "flat",
      "trajectory": []
    },
    "metrics": {
      "volume24h": "17,260.91",
      "liquidity": "81,697.04"
    },
    "resolution": {
      "endDate": "2026-12-31T00:00:00Z"
    },
    "scores": {
      "marketMovementScore": 45,
      "attentionScore": 70,
      "dataCompletenessScore": 100,
      "unusualMovementFlag": false
    }
  }
}

增量简报

增量简报是供 Agent 轮询循环重复付费使用的对象。简报回答“这个市场目前的情况如何？”，增量则回答“自 Agent 上次检查后发生了什么变化？”

GET https://x402nano.onrender.com/api/markets/delta?slug=will-gideon-saar-be-the-next-prime-minister-of-israel&since=2026-06-15T12:00:00Z

未付款时，路由会返回 402 Payment Required。使用有效的 X-PAYMENT 重试时，响应会包含收据和只读增量 JSON：

{
  "status": "unlocked",
  "receipt": {
    "id": "receipt-id-after-payment",
    "network": "eip155:8453",
    "amount": "0.05",
    "asset": "USDC"
  },
  "data": {
    "briefType": "read-only-market-delta",
    "market": {
      "slug": "will-gideon-saar-be-the-next-prime-minister-of-israel"
    },
    "window": {
      "since": "2026-06-15T12:00:00.000Z",
      "until": "2026-06-15T18:30:00.000Z"
    },
    "change": {
      "available": true,
      "outcome": "Yes",
      "absoluteChange": "0.050",
      "relativeChange": "+11.9%",
      "direction": "up",
      "changed": true
    },
    "significance": {
      "repeatCheckPriority": "high",
      "unusualMovementFlag": true,
      "summary": "The leading outcome moved up by 0.050 over the requested window."
    }
  }
}

增量简报为 Agent 提供描述性的市场背景信息。它们不包含交易执行、托管、投注建议、预测或买入／卖出建议。

轮询客户端示例：

examples/delta-polling.js
examples/delta-polling.py

两个示例都展示了预期的 Agent 循环：检查新鲜度元数据、请求增量、处理 402、使用来自调用方签名钩子的 x402 支付重试、解析收据和增量内容，然后在成功响应后更新 since。

本地证明命令

从仓库根目录运行以下命令（需先正常克隆仓库）。

仅进行预检；不会签署或发送付款：

$env:MAINNET_PAID_PATH="/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel"
$env:MAINNET_MAX_USDC="0.05"
$env:MAINNET_PAYMENT_ACK="PREFLIGHT_ONLY"
npm.cmd run agent:mainnet

真实支付示例，仅用于经所有者单独批准且有意发送一笔 0.05 USDC 解锁付款的测试：

$env:MAINNET_PAID_PATH="/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel"
$env:MAINNET_MAX_USDC="0.05"
$env:MAINNET_PAYMENT_ACK="PAY_REAL_0.05_USDC"
npm.cmd run agent:mainnet

发布征求意见

x402nano 正在征求 20 位 AI Agent、交易机器人和市场数据构建者的反馈。

请检查：

Would a machine-readable market brief be useful to your agent?
Is 0.05 USDC per brief the right shape for testing?
What fields would your bot need before paying for a brief?
Would you rather call this directly, through an SDK, or through another agent framework?

定位：

Stop scraping. Use a machine-payable API for market briefs.
0.05 USDC per read-only market brief on Base.
No account. No API key. HTTP 402 and X-PAYMENT.

当前范围

范围内：

Polymarket public data
read-only market intelligence
free trending endpoint
paid market brief endpoint
paid market delta endpoint
HTTP 402 challenge
Base mainnet USDC unlock
receipt and proof

本次发布范围之外：

trading advice
trade execution
Telegram bot
lead generation
x402 consulting
new product features before feedback

开发

npm.cmd install
npm.cmd run build

核心脚本：

npm.cmd run agent:mainnet
npm.cmd run wallet:mainnet:create
npm.cmd run build

许可证

本项目采用 MIT License 许可。