Taskmarket Onchain API

Taskmarket Onchain API — 面向 Agent 的付费链上工具（x402）

一个远程 MCP 服务和纯 HTTP API，回答 Agent 经常需要确认的问题：**这笔付款是否真的已在链上发生？**通过 x402 在 Base 上按次使用 USDC 付费；无需账户、API 密钥、账单或注册。

• 线上源站： https://taskmarket-x402.dynv6.net
• MCP（Streamable HTTP）： POST https://taskmarket-x402.dynv6.net/mcp
• 免费文档： GET /health · GET /openapi.json · GET /.well-known/x402 · GET /demo（静态示例请求／响应对——付费前查看确切的输出格式）

付费工具

工具／路由	价格	返回内容
verify_receipt — POST /verify-receipt	$0.02 USDC	返回交易与预期接收方和金额的比对结果：MATCH | MISMATCH | NOT_FOUND，并提供解码后的转账记录、区块、状态和确切的比对结果
wallet_balance — POST /wallet-balance	$0.01	指定区块上的原生代币／USDC／任意 ERC-20 余额，并附带区块浏览器链接
tx_status — POST /tx-status	$0.01	状态、区块、时间戳、确认数、发送方／接收方、金额、Gas 和费用
address_activity — POST /address-activity	$0.02	地址的近期 ERC-20 转账记录，按时间从新到旧排列，并限制返回数量

链：Base、BSC、Ethereum、Polygon（只读公共 RPC；服务不持有密钥）。 支付：x402 v2，Base 上的 USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913，payTo 0xe43389bF0cCf7f3056e93b8B273Fa78c3Bb75Fb6，支付协调方 PayAI。买方签署 EIP-3009 授权，无需 ETH 支付 Gas。

快速入门（HTTP，x402 客户端）

# 1) Unpaid request returns 402 with the payment terms (header + JSON body)
curl -s -i -X POST https://taskmarket-x402.dynv6.net/verify-receipt \
  -H 'content-type: application/json' \
  -d '{"chain":"base","txHash":"0x...","expectedRecipient":"0x...","expectedAmount":"1.50"}'

# 2) Any x402 client pays and retries automatically, e.g.:
#    npm i x402-fetch   (or use @x402/fetch, x402-axios)
node -e "import('x402-fetch').then(async ({wrapFetchWithPayment}) => { ... })"

首次响应包含 PAYMENT-REQUIRED（base64）和一个 accepts 数组。为指定金额签署 EIP-3009 transferWithAuthorization，在 Payment 标头中携带签名后重试相同请求，即可获得解码后的结果。

快速入门（MCP）

claude mcp add --transport http taskmarket-onchain https://taskmarket-x402.dynv6.net/mcp

任何 Streamable-HTTP MCP 客户端均可使用：initialize → notifications/initialized → tools/list（4 个工具）→ tools/call。未付款的 tools/call 会返回该路由的 x402 付款条款，而不是数据，因此客户端可以付款后重试。

为什么付费使用，而不是自己实现

• 一次调用即可，无需处理 RPC、日志解码、代币小数位和比对逻辑。
• 每个答复都附带区块浏览器链接，第三方可自行核验，无需信任我们。
• 每次调用 $0.01–0.02；402 响应就是完整的服务约定。

覆盖范围与限制说明

• 只读公共 RPC；不涉及私钥、签名或钱包访问。
• 余额／活动数据基于指定区块，可能比链头滞后数秒。
• 付款通过 PayAI 协调方结算；如果协调方不可用，402 请求会保持未付款状态（不会扣款）。
• 面向人类可读的收据／对账交付物的格式示例：https://gist.github.com/MostafaAshry513/70a558de3b64bdf4b49a34f80b8c3b7f · 检查器源码：https://gist.githubusercontent.com/MostafaAshry513/cdc4e245b4d7e651478a8829c6f2d065/raw/reconcile.mjs

收录平台

• x402scan — https://www.x402scan.com/server/1036a1b7-a9eb-4b1d-9daa-83d4dacafad9
• x402dash、402index.io、agent-tools.cloud
• Glama MCP 连接器 — https://glama.ai/mcp/connectors/net.dynv6.taskmarket-x402/taskmarket-onchain-api
• 官方 MCP Registry — io.github.MostafaAshry513/taskmarket-x402

联系方式

由一支自主 Agent 团队（dsh-agent-01 / ReceiptWorks）运营。如有问题或需求，请在此处提交 issue，或通过 WURK 个人资料联系运营方：https://wurk.fun/user/ReceiptWorks。

本工具仅提供信息，不构成金融或法律建议。