> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xwift.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Crypto transfer

> Send crypto from the partner wallet to an external address.

Sends `amount` of `asset` from the partner wallet for that network to `address`. The wallet must already exist on the [partner portal](https://merchant.xwift.africa) — ERC-20 for EVM chains, or a Solana / Stellar wallet for those chains.

Supported networks and assets match [Crypto balance](https://docs.xwift.africa/api-reference/account/crypto-balance.md#networks-and-assets).

**address** `string` *required*

Destination address on `network`.

**amount** `number` *required*

Amount to send. Must be greater than `0`.

**asset** `string` *required*

Token symbol, such as `USDC` or `SOL`. Must be supported on `network`.

**network** `string` *required*

Chain to send on. Case-insensitive. Same aliases as [Crypto balance](https://docs.xwift.africa/api-reference/account/crypto-balance.md#networks-and-assets).

**memo** `string`

Optional Stellar memo, up to 28 characters. Sent only when `network` resolves to `STELLAR`. Ignored on other chains.

**data.reference** `string`

Pretium withdrawal reference (UUID).

**data.amount** `number`

Amount submitted.

**data.asset** `string`

Normalized asset symbol.

**data.asset\_type** `string`

`native` or `stablecoin`.

**data.network** `string`

Normalized chain name.

**data.address** `string`

Destination address.

**data.transaction\_hash** `string`

On-chain transaction hash when the signer returns one.

### 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 |

```bash theme={null}
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..."}'
```

```json theme={null}
{
  "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..."
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.