Skip to main content

​
Step 1: Create an Account

  1. Go to app.unwall.xyz and sign up.
  2. Complete identity verification (KYC).
  3. Create your first project — give it a name like “My Agent” and optionally set a budget limit.
Each project is an isolated wallet with its own USDC balance, transaction history, and API tokens.

​
Step 2: Get Your API Token

From your project’s dashboard page:
  1. Navigate to Tokens and click Create Token.
  2. Select the permissions your agent needs: read, pay, and x402.
  3. Copy the token immediately — it starts with aw_live_ and is only displayed once.
Store your token securely. The full token value cannot be retrieved after creation. If you lose it, revoke the old token and create a new one.

​
Step 3: Fund Your Wallet

Get your project’s USDC deposit address: 
curl https://api.unwall.xyz/v1/stablecoin/address \
  -H "Authorization: Bearer aw_live_xxxxxxxxxxxx"
Response
{
  "chain": "base",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
  "currency": "usdc"
}
Send USDC on the Base network to the returned address. Your balance will update once the on-chain transaction confirms.

​
Step 4: Make Your First API Call

​
Check your balance

curl https://api.unwall.xyz/v1/balance \
  -H "Authorization: Bearer aw_live_xxxxxxxxxxxx"
Response
{
  "project_id": "proj_abc123",
  "available_usdc": 5000000,
  "pending_usdc": 0,
  "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
}

​
Send a payment via x402

Use the unified /v1/pay endpoint. When the recipient is an x402-enabled URL, Unwall automatically routes via the x402 protocol. 
curl -X POST https://api.unwall.xyz/v1/pay \
  -H "Authorization: Bearer aw_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "https://api.example.com/v1/data",
    "amount": 10000,
    "description": "Fetch market data via x402"
  }'
Response
{
  "id": "tx_def456",
  "status": "completed",
  "rail": "x402",
  "amount": 10000,
  "recipient": "https://api.example.com/v1/data",
  "created_at": "2026-03-11T10:30:00Z"
}

​
Step 5: Set Up MCP (Optional)

If you use Claude Desktop, Cursor, or another MCP-compatible client, you can give your AI assistant direct access to Unwall tools. Add the following to your Claude Desktop configuration (claude_desktop_config.json): 
{
  "mcpServers": {
    "unwall": {
      "command": "npx",
      "args": ["-y", "@unwall/mcp-server"],
      "env": {
        "UNWALL_API_TOKEN": "aw_live_xxxxxxxxxxxx"
      }
    }
  }
}
This gives your MCP client access to tools like get_balance, send_payment, send_usdc, x402_pay, and more.

​
What’s Next?

Authentication

Learn about token permissions, rate limits, and security best practices.

Unified Pay Endpoint

Deep dive into the POST /v1/pay endpoint and its routing logic.

x402 Payments

Understand how x402 protocol payments work under the hood.

MCP Server Guide

Full setup guide for the MCP server with all available tools.