curl -X POST "{{base_url}}/account/crypto/transfer" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"network":"BASE","asset":"USDC","amount":25,"address":"0x..."}'
{
"code": 200,
"message": "BASE USDC transfer initiated successfully.",
"data": {
"reference": "7c1e2a40-6b3d-4f1a-9c2e-1a0b8d4e6f21",
"amount": 25,
"asset": "USDC",
"asset_type": "stablecoin",
"network": "BASE",
"address": "0x...",
"transaction_hash": "0x..."
}
}
Account
Crypto transfer
Send crypto from the partner wallet to an external address.
POST
/
account
/
crypto
/
transfer
curl -X POST "{{base_url}}/account/crypto/transfer" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"network":"BASE","asset":"USDC","amount":25,"address":"0x..."}'
{
"code": 200,
"message": "BASE USDC transfer initiated successfully.",
"data": {
"reference": "7c1e2a40-6b3d-4f1a-9c2e-1a0b8d4e6f21",
"amount": 25,
"asset": "USDC",
"asset_type": "stablecoin",
"network": "BASE",
"address": "0x...",
"transaction_hash": "0x..."
}
}
Sends
amount of asset from the partner wallet for that network to address. The wallet must already exist on the partner portal — ERC-20 for EVM chains, or a Solana / Stellar wallet for those chains.
Supported networks and assets match Crypto balance.
Chain to send on. Case-insensitive. Same aliases as Crypto balance.
Optional Stellar memo, up to 28 characters. Sent only when
network resolves to STELLAR. Ignored on other chains.Errors
| Status | Message | When |
|---|---|---|
400 | Validation message | Missing fields, amount not greater than 0, or memo longer than 28 characters |
400 | Unauthorized | API key does not match a partner |
400 | Unsupported network. Allowed networks: ... | Unknown chain |
400 | Unsupported asset {ASSET} on {CHAIN}. Allowed: ... | Asset is not on that chain |
400 | No {wallet} wallet found. Create one on the partner portal first. | No ERC-20, Solana, or Stellar wallet for the chain |
400 | Failed to initiate {ASSET} transfer on {CHAIN} | Signer rejected the transfer. A chain error detail is appended when one is returned |
curl -X POST "{{base_url}}/account/crypto/transfer" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{"network":"BASE","asset":"USDC","amount":25,"address":"0x..."}'
{
"code": 200,
"message": "BASE USDC transfer initiated successfully.",
"data": {
"reference": "7c1e2a40-6b3d-4f1a-9c2e-1a0b8d4e6f21",
"amount": 25,
"asset": "USDC",
"asset_type": "stablecoin",
"network": "BASE",
"address": "0x...",
"transaction_hash": "0x..."
}
}
