Skip to main content
POST
Create Transaction
Submit a new transaction through an agent’s wallet. The transaction passes through the policy engine for validation, then is signed via MPC and broadcast to the blockchain.

Request Body

string
required
The agent whose wallet will send the transaction.
string
required
Transaction direction. Currently only outbound is supported.
string
required
Transaction type. Values: transfer.
string
Sender address. If omitted, the agent’s wallet address is used.
string
required
Recipient on-chain address.
string
required
Amount to send as a decimal string (e.g., "10.5").
string
required
Token symbol (e.g., USDC, USDT, ETH).
string
required
CAIP-2 chain identifier (e.g., eip155:84532).
string
Optional memo or reference string.

Response

Example

Response

Authorizations

X-API-Key
string
header
required

API key authentication. Keys are prefixed with awx_.

Body

application/json
agent_id
string
required

The agent whose wallet will send the transaction.

direction
enum<string>
required

Transaction direction. Currently only outbound is supported.

Available options:
outbound
type
enum<string>
required

Transaction type.

Available options:
transfer
to_address
string
required

Recipient on-chain address.

amount
string
required

Amount to send as a decimal string (e.g., "10.5").

token
string
required

Token symbol (e.g., USDC, USDT, ETH).

chain
string
required

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

from_address
string

Sender address. If omitted, the agent's wallet address is used.

memo
string

Optional memo or reference string.

Response

Transaction created and submitted.

An on-chain transaction submitted through an agent's wallet.

id
string

Unique transaction identifier.

hash
string

On-chain transaction hash (available after broadcast).

agent_id
string

Agent that initiated the transaction.

direction
enum<string>

Transaction direction.

Available options:
outbound
type
enum<string>

Transaction type.

Available options:
transfer
from_address
string

Sender address.

to_address
string

Recipient address.

amount
string

Amount sent as a decimal string.

token
string

Token symbol (e.g., USDC, USDT, ETH).

chain
string

CAIP-2 chain identifier.

fee
string

Network gas fee paid.

status
enum<string>

Transaction status.

Available options:
pending,
confirmed,
failed
memo
string

Optional memo string.

created_at
string<date-time>

ISO 8601 creation timestamp.