AgentServices

AgentServices

面向 AI Agent 的付费 API 层——通过 x402 小额支付提供数据、智能分析、推理和媒体服务

规范项目： https://github.com/vbkotecha/agentservices-api 官方网站： https://agentservices.to 许可证： Apache-2.0

AgentServices 是一个独立项目，与任何其他 x402 市场数据提供商均无关联、未获其认可，也不用于替代它们。

线上地址： agentservices.to | MCP 服务： https://agentservices.to/mcp（可流式传输的 HTTP）| 发现： /.well-known/x402

这是什么？

AgentServices 是面向 AI Agent 的商业化 API 层。无需 API 密钥，也无需订阅——Agent 使用 x402 支付协议，通过 Base 上的 USDC 按请求付费。

涵盖加密数据、市场情报、DeFi 分析、链上分析、400+ 个大模型、图像生成、文本转语音、投资组合智能分析和争议解决的 60 多个端点。其中 12 个免费，48 个以上通过 x402 付费（每次调用 $0.002 至 $0.25）。

v6.0 新增内容

• 400+ 个大模型，通过兼容 OpenAI 的 /v1/chat/completions 提供——GPT、Claude、Gemini、DeepSeek、Grok、Llama 等
• 智能路由器——使用 model: "auto"，由网关对任务进行分类，并选择能够处理任务的最便宜模型
• 图像生成——通过 gpt-image-2 使用 /v1/images/generations（$0.05）
• 文本转语音——使用自然语音的 /v1/audio/speech（$0.05）
• 3 个新的 MCP 工具——chat、generate_image、text_to_speech

买家流程：发现 → 试用 → 付费 → 留存

完整流程请参阅买家快速入门。下一步的具体操作是运行无需凭据的发现检查：

python3 examples/mcp_discovery_buyer_proof.py

然后按照相同的买家流程操作：

1. **发现：**使用 MCP 发现验证脚本确认托管的 MCP 服务和免费工具目录。
2. **免费试用：**使用免费 SDK 验证脚本获取真实价格结果。
3. **检查付费质询：**使用付费 SDK 验证脚本解码实时 402 条款。该脚本绝不会签署或结算付款。
4. **购买结果：**支付返回的 x402 条款，重试相同请求，并留存返回的付费结果。有关结果限制和来源信息，请参阅 token-risk、market-pulse 和 research-brief 合约。
5. **留存凭证：**使用原始质询、付费响应以及你的钱包授权或交易参考信息，运行现有的收据构建器。

这四种验证方式各有限制：发现和免费 SDK 验证的是无需支出的访问；付费 SDK 验证脚本仅验证质询结构；收据构建器会对买家持有的证据进行哈希处理，但不会验证结算。它们都不声称发生了采用、结算或收入。

有关激活度量指标的定义，请参阅 Activation Metrics。若要探测实时转化漏斗，请运行 python3 examples/check_activation_funnel.py。

买家路径：发现 → 试用 → 付费 → 留存

完整路径请参阅买家快速入门。下一步的具体操作是运行无需凭证的发现检查：

python3 examples/mcp_discovery_buyer_proof.py

然后按照相同的买家旅程操作：

1. **发现：**通过 MCP 发现验证确认托管的 MCP 服务和免费工具目录。
2. **免费试用：**通过免费 SDK 验证获取真实价格结果。
3. **检查付费挑战：**通过付费 SDK 验证解码实时的 402 条款。它不会签署或结算付款。
4. **购买结果：**支付返回的 x402 条款，重试同一请求，并保留返回的付费结果。有关结果限制和来源信息，请参阅 token 风险、市场脉搏和研究简报合约。
5. **保留证据：**使用原始挑战、付费响应以及你的钱包授权或交易引用，运行现有的收据生成器。

这四项验证的能力各不相同：发现验证和免费 SDK 验证无需支出即可确认访问；付费 SDK 验证只确认挑战格式；收据生成器会对买家持有的证据进行哈希处理，但不会验证结算情况。它们都不声称存在用户采用、结算或收入。

端点

免费（无需付款）

端点	描述
GET /v1/prices?symbols=BTC,ETH	当前加密货币价格（CoinGecko）
GET /v1/trending	按市场活动度排列的热门代币
GET /v1/global	全球市值、交易量、BTC 主导率
GET /v1/fear-greed	加密货币恐惧与贪婪情绪指数
GET /v1/gas	Base/Ethereum 当前 Gas 价格
GET /v1/predictions	AI 生成的市场预测
GET /v1/news	最新加密货币新闻标题
GET /v1/social/trending	热门社交情绪话题
GET /v1/geo?ip=1.2.3.4	IP 地理位置查询
GET /v1/swap/quote?from=&to=&amount=	DEX 兑换报价（0x 集成）
GET /v1/policies	列出争议解决策略模板
GET /v1/trade/hyperliquid/bootstrap	Hyperliquid Agent 签名引导（approveAgent 流程）
POST /v1/trade/hyperliquid/order	转发由 Agent 签名的 HL 订单（受策略控制）
POST /v1/trade/hyperliquid/cancel	转发由 Agent 签名的 HL 撤单
GET /v1/trade/hyperliquid/order	HL 订单状态（查询参数：user、oid）
GET /v1/trade/hyperliquid/order/{id}	HL 订单状态（路径参数）
GET/PUT /v1/trade/hyperliquid/policy	执行约束（最大名义金额、币种允许列表、紧急停止开关）
POST /v1/trade/hyperliquid/paper/order	用于 Agent 训练的模拟订单
POST /v1/trade/hyperliquid/eval/order	策略通过/失败评估（训练环境）
GET /health	API 健康检查

交易 API — 交易场所入口（免费 — 不使用 x402）

AgentServices 正在构建 /v1/trade/{venue}/… 下的交易场所交易入口。首先支持 Hyperliquid；后续将支持更多交易场所，并推出与交易场所无关的 /v1/trade/execute 路由器。

每个入口都是一条策略约束 + 转发通道，而不是更智能的路由器。我们不声称成交效果优于直接使用交易场所。调用时无需支付执行费用（下单路径不使用 x402）。我们不收取构建者费用，因此通过我们路由不会比直接交易更贵。

**我们绝不会收集交易场所的 API 密钥。**Agent 在本地使用经 HL 批准的 Agent 钱包签署订单（在主钱包上调用 approveAgent 是唯一需要人工完成的初始化步骤）。AgentServices 会进行策略检查（最大名义金额、币种允许列表、紧急停止开关），然后转发已签名的负载。

请求正文接受 market_type：spot、perp 或 future。Hyperliquid 目前支持 perp 和 spot；不支持的类型会返回机器可读的 market_type_not_supported 错误。

MCP 工具	HTTP 等效接口
trade_hyperliquid_order	POST /v1/trade/hyperliquid/order
trade_hyperliquid_cancel	POST /v1/trade/hyperliquid/cancel
trade_hyperliquid_order_status	GET /v1/trade/hyperliquid/order
trade_hyperliquid_get_policy / trade_hyperliquid_set_policy	GET/PUT /v1/trade/hyperliquid/policy
trade_hyperliquid_paper_order	POST /v1/trade/hyperliquid/paper/order
trade_hyperliquid_eval_order	POST /v1/trade/hyperliquid/eval/order

旧版 hl_* MCP 工具名称仍作为别名保留。有关 approveAgent 签名模式，请参阅 GET /v1/trade/hyperliquid/bootstrap。

**路线图：**为更多交易场所提供 /v1/trade/{venue}；之后推出与交易场所无关的 /v1/trade/execute 路由。

付费 — 数据 API（x402）

端点	价格	说明
GET /v1/indicators/BTC	$0.02	技术指标（RSI、MACD、布林带、ATR、支撑位/阻力位）
GET /v1/yields	$0.02	按 TVL 排序的顶级 DeFi 收益池
GET /v1/metadata?url=	$0.01	URL 元数据提取和展开
GET /v1/search?q=	$0.01	加密货币/市场信息网络搜索
GET /v1/onchain/:address	$0.02	任意地址的链上分析
GET /v1/onchain/:address/tokens	$0.03	任意地址的代币持仓

付费 — 综合分析 API（x402）

端点	价格	说明
GET /v1/token-risk/{token}	$0.03	基于快照的波动性、流动性代理指标和市值风险评分
GET /v1/crypto-signals	$0.04	汇总多个指标得出的买入/卖出信号
GET /v1/yield-comparison	$0.03	比较不同协议的收益及风险调整后回报
GET /v1/hn-sentiment	$0.02	对 Hacker News 科技话题进行情绪分析
GET /v1/npm-stats/:package	$0.02	NPM 软件包下载统计和趋势
GET /v1/github-trending	$0.02	按语言/主题筛选的 GitHub 热门仓库
GET /v1/marketing-intel	$0.05	营销情报：竞争对手、内容缺口、广告文案

付费 — 整合型情报（x402）

端点	价格	说明
GET /v1/research?q=	$0.05	深度研究：一次调用完成搜索 + 提取 + 综合分析
GET /v1/portfolio?symbol=BTC	$0.10	投资组合情报：价格 + 信号 + 风险 + 情绪 + 结论
GET /v1/defi-strategy	$0.25	DeFi 策略报告：顶级收益 + TVL + 比较 + 风险提示
GET /v1/market-pulse	$0.05	市场脉搏：恐惧与贪婪 + 热门趋势 + 新闻 + 社交媒体 + 巨鲸 + 全球市场
GET /v1/onchain-overview	$0.15	链上概览：巨鲸 + 交易所资金流 + 稳定币资金流 + 相关性 + DeFi TVL

付费 — AI 推理（x402）

端点	价格	说明
POST /v1/inference	$0.03	大模型推理（gpt-5.4/5.4-mini/5.5）— 聊天补全
POST /v1/complete	$0.03	文本补全（CodexSale 代理）

付费 — 争议解决（x402）

端点	价格	描述
POST /v1/disputes	$0.05	AI 驱动的争议解决（7 个政策模板）

---

使用场景 — Agent 可以构建什么

投资组合监控器

# ALL-IN-ONE: Get portfolio intelligence in a single call ($0.10)
# Returns: price + technical signal + risk score + market sentiment + verdict
curl "https://agentservices.to/v1/portfolio?symbol=BTC"

# Or build it yourself from individual endpoints:
# Get current prices (FREE)
curl https://agentservices.to/v1/prices?symbols=BTC,ETH,SOL

# Get technical signals for entry/exit ($0.04)
curl https://agentservices.to/v1/crypto-signals

# Check snapshot-based token risk before buying ($0.03)
# Use a CoinGecko-compatible identifier for portable direct HTTP calls.
curl https://api.agentservices.to/v1/token-risk/pepe
# Contract and payment-receipt guidance: docs/token-risk-outcome-contract.md

DeFi 收益优化器

# ALL-IN-ONE: Get DeFi strategy report ($0.25)
# Returns: top yields + protocol TVL + cross-chain comparison + risk flags
curl "https://agentservices.to/v1/defi-strategy"

# Get all yield pools ranked by TVL ($0.02)
curl https://agentservices.to/v1/yields

# Compare yields with risk-adjusted returns ($0.03)
curl https://agentservices.to/v1/yield-comparison

# Check on-chain position for any wallet ($0.02)
curl https://agentservices.to/v1/onchain/0x9863aB6242663FCc84c33632741711dB78f8Fd15

市场情报 Agent

# ALL-IN-ONE: Get market pulse report ($0.05)
# Returns: fear-greed + trending + news + social + whales + global market
curl "https://agentservices.to/v1/market-pulse"

# Get market sentiment (FREE)
curl https://agentservices.to/v1/fear-greed

# Search for latest news on any topic ($0.01)
curl "https://agentservices.to/v1/search?q=base+chain+ecosystem"

# Get trending tokens (FREE)
curl https://agentservices.to/v1/trending

# Get marketing intelligence report ($0.05)
curl "https://agentservices.to/v1/marketing-intel?competitor=blockrun&topic=x402"

技术分析机器人

# Full technical indicator suite ($0.02)
curl https://agentservices.to/v1/indicators/BTC
# Returns: RSI, MACD, Bollinger Bands, ATR, Support/Resistance levels

# AI-generated market predictions (FREE)
curl https://agentservices.to/v1/predictions

# Combine with on-chain analytics ($0.03)
curl https://agentservices.to/v1/onchain/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/tokens

开发者研究 Agent

# GitHub trending repos ($0.02)
curl "https://agentservices.to/v1/github-trending?language=python&since=weekly"

# NPM package stats ($0.02)
curl https://agentservices.to/v1/npm-stats/react

# Hacker News sentiment ($0.02)
curl "https://agentservices.to/v1/hn-sentiment?q=AI+agents"

AI 聊天 / 推理

# Chat completions via x402 ($0.03)
curl -X POST https://agentservices.to/v1/inference \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"Explain x402 in 3 sentences"}]}'

链上分析

# ALL-IN-ONE: Get full on-chain overview ($0.15)
# Returns: whale movements + exchange flows + stablecoin flows + correlation matrix + DeFi TVL
curl "https://agentservices.to/v1/onchain-overview"

# On-chain analytics for any wallet ($0.02)
curl https://agentservices.to/v1/onchain/0x9863aB6242663FCc84c33632741711dB78f8Fd15

# Token holdings for any wallet ($0.03)
curl https://agentservices.to/v1/onchain/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/tokens

---

快速开始

使用 curl

# Free — no payment needed
curl https://agentservices.to/v1/prices?symbols=BTC,ETH

# Paid — returns HTTP 402 with payment instructions in the header
curl -i https://agentservices.to/v1/indicators/BTC
# Response includes x402 payment envelope: network, amount, payTo address
# Agent pays via x402 client, retries with X-Payment header, gets data

用作 MCP 服务（Claude Desktop、Cursor 等）

{
  "mcpServers": {
    "agentservices": {
      "url": "https://agentservices.to/mcp",
      "transport": "streamable-http"
    }
  }
}

提供 13 种以上 MCP 工具：crypto_prices、trending_tokens、global_market、gas_prices、market_predictions、crypto_news、social_trending、technical_indicators、defi_yields、search_web、token_risk、crypto_signals、onchain_analytics、deep_research、portfolio_intelligence、defi_strategy、market_pulse、onchain_overview

使用 Python

import httpx

# Free endpoints
resp = httpx.get("https://agentservices.to/v1/prices?symbols=BTC,ETH")
prices = resp.json()

# Paid endpoints — use x402 client to handle payment
from x402.client import x402Client
client = x402Client()
result = client.get("https://agentservices.to/v1/indicators/BTC")
# Client handles 402 → pays USDC → retries with payment proof → returns data

使用 JavaScript/TypeScript

// Free endpoints
const prices = await fetch("https://agentservices.to/v1/prices?symbols=BTC,ETH").then(r => r.json());

// Paid endpoints — use @x402/facilitator
import { wrapFetchWithPayment } from "@x402/facilitator";
const paidFetch = wrapFetchWithPayment(fetch);
const indicators = await paidFetch("https://agentservices.to/v1/indicators/BTC").then(r => r.json());

争议解决引擎

AgentServices 包含一个 AI 驱动的争议解决系统，提供 7 个政策模板：

政策	使用场景
freelance-delivery	自由职业者与客户之间的交付争议
milestone-payment	基于里程碑的项目付款争议
sla-monitoring	服务级别协议违约
api-quality	API 响应质量 / 正常运行时间争议
bug-bounty	漏洞赏金有效性争议
scope-dispute	项目范围蔓延争议
physical-commerce	实物商品交易争议

面向人类的计费入口（ChatGPT / Claude）

Wallet Agent 继续通过 x402 on REST 付款——保持不变。通过 ChatGPT Developer Mode 或 Claude 自定义连接器接入的用户，可在 MCP 上使用 Google OAuth + Stripe 预付额度。

支付方式	对象	方式
x402	Wallet Agent	未经身份验证的 REST → HTTP 402 → Base 上的 USDC
Credits	已登录用户	MCP 上的 Google OAuth → 从预付余额中扣除相同的美元价格

ChatGPT 的 MCP URL： https://agentservices.to/mcp

环境变量

复制 .env.example。启用面向人类的入口需要以下变量：

变量	用途
GOOGLE_CLIENT_ID	Google OAuth 客户端 ID
GOOGLE_CLIENT_SECRET	Google OAuth 客户端密钥
OAUTH_JWT_SECRET	为 MCP bearer 令牌签名（或使用 SESSION_SECRET）
STRIPE_SECRET_KEY	Stripe API 密钥
STRIPE_WEBHOOK_SECRET	验证 checkout.session.completed webhook
STRIPE_PRICE_CREDITS_10	可选的 $10 套餐 Stripe Price ID（否则使用硬编码值）
PUBLIC_BASE_URL	规范主机名，例如 https://agentservices.to

预付额度余额存储在 Stripe Customer Balance 中（每个 Google sub 对应一个 Stripe Customer）。无需 Redis、Postgres 或其他数据库。

未配置 Google/Stripe 变量时，API 将以仅 x402 模式启动。

Google Cloud Console 重定向 URI

添加两个主机：

• https://agentservices.to/oauth/google/callback
• https://api.agentservices.to/oauth/google/callback

Stripe webhook

将 Stripe 指向：

• https://agentservices.to/billing/webhook
• https://api.agentservices.to/billing/webhook

事件：checkout.session.completed

发现与列表

• x402 发现 — 已上线
• MCP Registry — 登记名称为 to.agentservices/agentservices
• CDP Bazaar — 已启用扩展
• awesome-x402 — 已提交 PR

技术栈

• FastAPI（Python 3.11+）
• x402 v2 支付中间件（Coinbase CDP facilitator）
• Base Mainnet 上的 USDC（EIP-3009 免 gas 转账）
• 部署于 Vercel（agentservices.to + api.agentservices.to，从 main 自动部署）

Coinbase AgentKit 集成

AgentServices 内置了 Coinbase AgentKit 操作提供程序（agentkit/ 目录）。这使任何 AgentKit Agent 都能通过类型化且有文档说明的操作使用 AgentServices API：

from coinbase_agentkit import AgentKit, AgentKitConfig
from agentkit import agentservices_action_provider

agent_kit = AgentKit(AgentKitConfig(
    wallet_provider=wallet_provider,
    action_providers=[agentservices_action_provider()]
))

18 项操作涵盖免费接口（价格、恐惧与贪婪指数、热门趋势、Gas）和付费接口（指标、DeFi 收益、投资组合情报、研究、链上分析、AI 推理等）。完整文档请参阅 agentkit/README.md。

许可证

MIT — 基于它构建、分叉并集成。

链接

• API： agentservices.to
• MCP： agentservices.to/mcp
• 发现： agentservices.to/.well-known/x402
• GitHub： github.com/vbkotecha/agentservices-api
• x402 协议： x402.org
• Base： base.org