メインコンテンツへスキップ

​
ベース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ベアラーAuthorizationAuthorization: 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_size201001ページあたりのアイテム数
レスポンス形式： 
{
  "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エージェントウォレットの作成と管理。

トランザクション

支払いの送信とトランザクション履歴の照会。

ポリシー

支出制限とアクセス制御の設定。

Webhook

Webhookエンドポイントの登録と管理。

x402 Pay

x402マイクロペイメント交渉のトリガー。

x402セッション

x402セッション予算の管理。