跳转到主要内容

​
基础 URL

Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
开发和测试时使用沙盒 URL。仅在准备好使用真实资金交易时切换到生产环境。

​
认证

所有 API 请求必须包含以下认证头部之一：
方式头部示例
API 密钥X-API-KeyX-API-Key: awx_your_api_key
JWT BearerAuthorizationAuthorization: Bearer eyJhbGciOi...
# API key authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "X-API-Key: awx_your_api_key"

# JWT authentication
curl -X GET https://api.agentwallex.com/api/v1/agents \
  -H "Authorization: Bearer eyJhbGciOi..."
请参阅身份认证了解获取和管理凭证的完整详情。

​
分页

所有列表端点支持以下查询参数进行分页：
参数默认值最大值说明
page_num1—页码（从 1 开始）
page_size20100每页条目数
响应格式： 
{
  "data": [],
  "total": 42,
  "has_more": true
}

​
错误约定

所有错误遵循一致的格式： 
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}

​
错误类型

类型HTTP 状态码说明
invalid_request_error400请求体或参数无效
authentication_error401凭证缺失或无效
authorization_error403权限不足
not_found_error404资源不存在
rate_limit_error429超过速率限制
internal_error500服务器端错误
请参阅错误处理了解详细的错误处理指南。

​
API 分区

代理

创建和管理 AI 代理钱包。

交易

发送支付和查询交易历史。

策略

配置消费限额和访问控制。

Webhooks

注册和管理 Webhook 端点。

x402 支付

触发 x402 微支付协商。

x402 会话

管理 x402 会话预算。