Wallets
Register a customer's existing stablecoin wallet address to enable on-ramp and off-ramp transfers.
A wallet in SpherePay is a registration of your customer's existing blockchain wallet address. SpherePay does not create or custody wallets — it links a wallet your customer already owns to their SpherePay profile so that transfers can be routed to or from that address.
You must register at least one wallet before creating an on-ramp or off-ramp transfer that involves crypto.
SpherePay does not create wallets
SpherePay registers an existing wallet address — it does not generate or host a new wallet on your customer's behalf. The address must already exist on the target network before registration.
Register a Wallet (API)
POSThttps://api.spherepay.co/v2/wallet
For full API details, refer to the Create Wallet API Reference.
Supported Networks
| Network | Network Code | USDC | USDT | EURC |
|---|---|---|---|---|
| Solana | sol | ✅ | - | ✅ |
| Ethereum | ethereum | ✅ | ✅ | ✅ |
| Tron | tron | - | ✅ | - |
| Polygon | polygon | ✅ | - | - |
| Base | base | ✅ | - | ✅ |
| Arbitrum | arbitrum | ✅ | - | - |
| Avalanche | avalanche | ✅ | - | - |
| [NEW] Starknet | starknet | ✅ | - | - |
Request Example
{
"customerId": "customer_1234567890",
"network": "sol",
"address": "0x1234567890123456789012345678901234567890"
}Response Example
{
"id": "wallet_1234567890",
"address": "0x1234567890123456789012345678901234567890",
"network": "sol",
"customerId": "customer_1234567890",
"created": "2026-01-25T12:00:00.000Z",
"updated": "2026-01-25T12:00:00.000Z"
}The returned id is your persistent reference to this wallet — store it against the customer record and use it in transfer requests to identify the registered address.
Last updated on