メインコンテンツへスキップ
POST
/
api
/
v1
/
x402
/
sessions
Create x402 Session
curl --request POST \
  --url https://api.agentwallex.com/api/v1/x402/sessions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "agent_abc123",
  "budget_limit": "100.00",
  "chain": "eip155:84532",
  "ttl_seconds": 3600,
  "allowed_urls": [
    "https://paid-api.example.com/v1/data"
  ]
}
'
{
  "id": "sess_xyz789",
  "agent_id": "agent_abc123",
  "budget_limit": "100.00",
  "budget_spent": "0.00",
  "budget_remaining": "100.00",
  "chain": "eip155:84532",
  "status": "active",
  "expires_at": "2025-06-15T15:30:00Z",
  "created_at": "2025-06-15T14:30:00Z"
}
セッションを使用すると、繰り返しの x402 API コールに対して支出バジェットを事前承認できます。セッション内の支払いはセッションバジェットから差し引かれ、各コールに対する個別の承認は不要です。

​
リクエストボディ

​
agent_id
string
必須
セッションに資金を提供するエージェント。
​
budget_limit
string
必須
セッションが使用できる最大合計金額（例："100.00"）。
​
chain
string
必須
決済用の CAIP-2 チェーン識別子（例：eip155:84532）。
​
ttl_seconds
integer
必須
セッションの有効期間（秒）。この期間後にセッションは期限切れになります。
​
allowed_urls
string[]
このセッションが支払いを許可する URL のリスト（オプション）。省略した場合、すべての x402 対応 URL が許可されます。

​
例

curl -X POST https://api.agentwallex.com/api/v1/x402/sessions \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "budget_limit": "100.00",
    "chain": "eip155:84532",
    "ttl_seconds": 3600,
    "allowed_urls": ["https://paid-api.example.com/v1/data"]
  }'
Response
{
  "id": "sess_xyz789",
  "agent_id": "agent_abc123",
  "budget_limit": "100.00",
  "budget_spent": "0.00",
  "budget_remaining": "100.00",
  "chain": "eip155:84532",
  "status": "active",
  "expires_at": "2025-06-15T15:30:00Z",
  "created_at": "2025-06-15T14:30:00Z"
}

承認

​
X-API-Key
string
header
必須

API key authentication. Keys are prefixed with awx_.

ボディ

application/json
​
agent_id
string
必須

The agent whose wallet funds the session.

​
budget_limit
string
必須

Maximum total amount the session can spend (e.g., "100.00").

​
chain
string
必須

CAIP-2 chain identifier for settlement (e.g., eip155:84532).

​
ttl_seconds
integer
必須

Session time-to-live in seconds. The session expires after this duration.

​
allowed_urls
string<uri>[]

Optional list of URLs this session is authorized to pay. If omitted, all x402-enabled URLs are allowed.

レスポンス

Session created successfully.

An x402 payment session with a pre-authorized spending budget.

​
id
string

Unique session identifier (e.g., sess_xyz789).

​
agent_id
string

Agent whose wallet funds the session.

​
budget_limit
string

Maximum total amount the session can spend.

​
budget_spent
string

Total amount spent so far.

​
budget_remaining
string

Remaining budget available.

​
chain
string

CAIP-2 chain identifier for settlement.

​
status
enum<string>

Session status.

利用可能なオプション:
active,
expired,
deleted
​
allowed_urls
string<uri>[]

URLs this session is authorized to pay.

​
expires_at
string<date-time>

ISO 8601 expiration timestamp.

​
created_at
string<date-time>

ISO 8601 creation timestamp.