Skip to main content
POST
/
v1
/
usdc
/
transfer
Send USDC
curl --request POST \
  --url https://api.example.com/v1/usdc/transfer \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount_usdc": 123,
  "to_address": "<string>",
  "chain": "<string>",
  "description": "<string>",
  "idempotency_key": "<string>"
}
'
{
  "id": "<string>",
  "status": "<string>",
  "amount_usdc": 123,
  "fee_usdc": 123,
  "to_address": "<string>",
  "chain": "<string>",
  "tx_hash": {},
  "created_at": "<string>"
}
This endpoint is deprecated. Use POST /v1/pay with an EVM address recipient instead.
Sends USDC on-chain from the project’s Bridge.xyz wallet to an external wallet address on Base.
Requires a bearer token with the pay permission.

​
Request Body

​
amount_usdc
number
required
Amount of USDC to send (e.g., 10.50 for 10.50 USDC). Max 100,000.
​
to_address
string
required
Destination EVM address. Must be 0x followed by 40 hexadecimal characters. Cannot be the zero address.
​
chain
string
default:"base"
Blockchain network to send on. Default: "base".
​
description
string
Payment description for record-keeping. Max 500 characters.
​
idempotency_key
string
Unique key to prevent duplicate transfers. Max 255 characters.

​
Response

​
id
string
required
Unique transaction identifier.
​
status
string
required
Transaction status: pending, processing, completed, or failed.
​
amount_usdc
number
required
Amount of USDC sent.
​
fee_usdc
number
required
Platform fee in USDC.
​
to_address
string
required
Destination wallet address.
​
chain
string
required
Blockchain network used.
​
tx_hash
string | null
required
On-chain transaction hash. null while the transaction is pending.
​
created_at
string
required
ISO 8601 timestamp of when the transfer was created.

​
Examples

curl -X POST https://api.unwall.xyz/v1/usdc/transfer \
  -H "Authorization: Bearer aw_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_usdc": 25.00,
    "to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
    "description": "Contractor payment",
    "idempotency_key": "pay-contractor-2026-03"
  }'
Response (201 Created)
{
  "id": "tx_usdc_abc123",
  "status": "processing",
  "amount_usdc": 25.0,
  "fee_usdc": 0.375,
  "to_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28",
  "chain": "base",
  "tx_hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "created_at": "2026-03-11T14:30:00Z"
}