Skip to main content

​
Base URLs

Sandbox:    https://api-sandbox.agentwallex.com/api/v1
Production: https://api.agentwallex.com/api/v1
Use the sandbox URL for development and testing. Switch to production only when you are ready to transact with real funds.

​
Authentication

All API requests must include one of the following authentication headers:
MethodHeaderExample
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..."
See Authentication for full details on obtaining and managing credentials.

​
Pagination

All list endpoints support pagination with the following query parameters:
ParameterDefaultMaxDescription
page_num1—Page number (1-indexed)
page_size20100Number of items per page
Response format: 
{
  "data": [],
  "total": 42,
  "has_more": true
}

​
Error Contract

All errors follow a consistent format: 
{
  "code": "invalid_request",
  "type": "invalid_request_error",
  "message": "human readable error description"
}

​
Error Types

TypeHTTP StatusDescription
invalid_request_error400Invalid request body or parameters
authentication_error401Missing or invalid credentials
authorization_error403Insufficient permissions
not_found_error404Resource does not exist
rate_limit_error429Rate limit exceeded
internal_error500Server-side error
See Error Handling for detailed guidance on handling errors.

​
API Sections

Agents

Create and manage AI agent wallets.

Transactions

Send payments and query transaction history.

Policies

Configure spending limits and access controls.

Webhooks

Register and manage webhook endpoints.

x402 Pay

Trigger x402 micropayment negotiation.

x402 Sessions

Manage x402 session budgets.