目录收录
0x API
API for querying token and pool stats across various liquidity pools. 用于查询各流动性池中代币与资金池统计数据,适合 DeFi 行情展示、聚合器与数据分析类应用的快速验证。
免费 API
目录收录
无需认证
CORS: Yes
- 来源类型
- 目录收录
- 可用方式
- 免费可用
- 认证方式
- 无需认证
- 协议格式
- REST(见官方文档)
- 计费摘要
- 免费为主
- 稳定性说明
- 以来源方说明为准
面向 Agent
如何调用 0x API
供 Hermes、OpenClaw、浏览器自动化 Agent 等读取。优先解析 <head> 内 #boyapi-agent-spec JSON;下方为逐步说明。
Hermes
OpenClaw
Coding Agent
Browser Agent
-
1. 确认调用目标
本页为百易API 目录说明。业务请求发往
https://api.0x.org,不要向boyapi.com发送 0x 业务 API。 -
2. 构造 HTTP 请求
- 方法:
GET - 路径:
/swap/allowance-holder/price - 必填查询参数:
chainId、sellToken、buyToken - 数量:
sellAmount与buyAmount二选一 - 请求头:
0x-version: v2(无需 API Key)
- 方法:
-
3. 最小可执行示例
复制以下 cURL 即可试调(以太坊主网 WETH → DAI 示例):
curl -G 'https://api.0x.org/swap/allowance-holder/price' \ -H '0x-version: v2' \ --data-urlencode 'chainId=1' \ --data-urlencode 'sellToken=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2' \ --data-urlencode 'buyToken=0x6b175474e89094c44da98b954eedeac495271d0f' \ --data-urlencode 'sellAmount=1000000000000000000' -
4. 解析响应
HTTP 200 时关注
liquidityAvailable、buyAmount、sellAmount、minBuyAmount、route、fees、gas。若liquidityAvailable为 false,报价不完整。 -
5. 环境与限制
CORS:
Yes,可在浏览器直接 fetch;生产环境仍需遵守 0x 配额与条款。错误见「接入说明」中的错误码表(如INPUT_INVALID、422)。
机器可读规范(JSON)
application/json · #boyapi-agent-spec
{
"spec_version": "1.0",
"page_type": "boyapi_api_detail",
"api": { "slug": "0x", "name": "0x" },
"invocation": {
"method": "GET",
"base_url": "https://api.0x.org",
"path": "/swap/allowance-holder/price",
"full_url_example": "https://api.0x.org/swap/allowance-holder/price?chainId=1&sellToken=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&buyToken=0x6b175474e89094c44da98b954eedeac495271d0f&sellAmount=1000000000000000000",
"auth": { "type": "none", "headers": { "0x-version": "v2" } },
"required_params": ["chainId", "sellToken", "buyToken"],
"example_curl": "curl -G 'https://api.0x.org/swap/allowance-holder/price' -H '0x-version: v2' ..."
}
}
完整字段以页面 <head> 中 #boyapi-agent-spec 为准(与参数表、示例代码同步)。
Agent 注意:boyapi.com 仅提供目录与文档,不提供 0x 代理网关。调用失败时请核对链 ID、代币地址与
0x-version 请求头。
接入信息
可用方式
- 目录定位
- 免费目录收录(public-apis)
- 认证要求
- 无需认证(auth=No)
- HTTPS
- 支持(https=Yes)
- CORS
- Yes — 可在浏览器前端直接调用
- 接口名称
- 0x
- 典型端点
- GET /swap/allowance-holder/price
- 功能描述
- API for querying token and pool stats across various liquidity pools
平台支持
- 标注为目录收录,非百易API 自建接口
- CORS 为 Yes,可在浏览器端发起试调(仍受官方策略与配额约束)
- 生产环境请结合下方参数表、响应字段与错误码做完整评估