跳轉到主要內容

基礎 URL

Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
開發和測試請使用 sandbox URL。僅在準備好使用真實資金進行交易時才切換至 production。

身份驗證

所有 API 請求必須包含以下其中一個身份驗證標頭:
方式標頭範例
API KeyX-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 Pay

觸發 x402 微型支付協商。

x402 Sessions

管理 x402 工作階段預算。