API Reference Overview

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:

Method	Header	Example
API Key	`X-API-Key`	`X-API-Key: awx_your_api_key`
JWT Bearer	`Authorization`	`Authorization: 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:

Parameter	Default	Max	Description
`page_num`	1	—	Page number (1-indexed)
`page_size`	20	100	Number 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

Type	HTTP Status	Description
`invalid_request_error`	400	Invalid request body or parameters
`authentication_error`	401	Missing or invalid credentials
`authorization_error`	403	Insufficient permissions
`not_found_error`	404	Resource does not exist
`rate_limit_error`	429	Rate limit exceeded
`internal_error`	500	Server-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

x402 Pay

Trigger x402 micropayment negotiation.

x402 Sessions

Manage x402 session budgets.

​Base URLs

​Authentication

​Pagination

​Error Contract

​Error Types

​API Sections

Agents

Transactions

Policies

Webhooks

x402 Pay

x402 Sessions

Base URLs

Authentication

Pagination

Error Contract

Error Types

API Sections