Skip to main content
Create a Wallet
Use this endpoint to register a customer’s existing blockchain wallet address with SpherePay. SpherePay does not create or custody wallets — it links an address 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 a transfer that involves crypto. The wallet address must already exist on the target network before registration.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
address
string
required

The wallet address on the specified network. Must be a valid address format for the network.

Minimum string length: 1
Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

customerId
string
required

The unique identifier of the customer who owns this wallet.

Minimum string length: 1
Example:

"customer_66c4168d418a410eae282b83883bdc39"

network
enum<string>
required

The blockchain network for this wallet. Must be a supported crypto network.

Available options:
arbitrum,
avalanche,
base,
ethereum,
polygon,
sol,
tron
Example:

"sol"

Response

address
string
required

The wallet address on the specified network.

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

created
string
required

The ISO 8601 timestamp when the wallet was created.

Example:

"2025-01-01T00:00:00.000Z"

customerId
string
required

The unique identifier of the customer who owns this wallet.

Example:

"customer_66c4168d418a410eae282b83883bdc39"

id
string
required

The unique identifier of the wallet.

Example:

"wallet_ce745ef7f3df4b9a8bff1301ce24b045"

network
enum<string>
required

The blockchain network for this wallet.

Available options:
sol,
fogo,
ethereum,
arbitrum,
polygon,
base,
avalanche,
sui,
noble,
sei,
tron,
starknet,
aptos,
hyperliquid
Example:

"sol"

updated
string
required

The ISO 8601 timestamp when the wallet was last updated.

Example:

"2025-01-01T00:00:00.000Z"

Last modified on June 18, 2026