Saltar al contenido principal
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"
}
Las sesiones le permiten preautorizar un presupuesto de gasto para llamadas API x402 repetidas. Los pagos dentro de una sesión se deducen del presupuesto de la sesión sin requerir aprobación individual para cada llamada.

​
Cuerpo de la solicitud

​
agent_id
string
requerido
El agente cuya billetera financia la sesión.
​
budget_limit
string
requerido
Monto total máximo que la sesión puede gastar (por ejemplo, "100.00").
​
chain
string
requerido
Identificador de cadena CAIP-2 para la liquidación (por ejemplo, eip155:84532).
​
ttl_seconds
integer
requerido
Tiempo de vida de la sesión en segundos. La sesión expira después de esta duración.
​
allowed_urls
string[]
Lista opcional de URLs que esta sesión está autorizada a pagar. Si se omite, se permiten todas las URLs habilitadas para x402.

​
Ejemplo

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"
}

Autorizaciones

​
X-API-Key
string
header
requerido

API key authentication. Keys are prefixed with awx_.

Cuerpo

application/json
​
agent_id
string
requerido

The agent whose wallet funds the session.

​
budget_limit
string
requerido

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

​
chain
string
requerido

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

​
ttl_seconds
integer
requerido

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.

Respuesta

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.

Opciones disponibles:
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.