Register a Customer Crypto Wallet for Transfers

curl --request POST \ --url https://api.spherepay.co/v2/wallet \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "customerId": "customer_66c4168d418a410eae282b83883bdc39", "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "network": "sol" } '

{ "id": "wallet_ce745ef7f3df4b9a8bff1301ce24b045", "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", "network": "sol", "customerId": "customer_66c4168d418a410eae282b83883bdc39", "created": "2025-01-01T00:00:00.000Z", "updated": "2025-01-01T00:00:00.000Z" }

Authorizations

Authorization

string

header

required

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

Body

application/json

customerId

string

required

The unique identifier of the customer who owns this wallet.

Minimum string length: 1

Example:

"customer_66c4168d418a410eae282b83883bdc39"

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"

network

enum<string>

required

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

Available options:

arbitrum,

avalanche,

base,

ethereum,

optimism,

polygon,

sol,

tron

Example:

"sol"

Response

string

required

The unique identifier of the wallet.

Example:

"wallet_ce745ef7f3df4b9a8bff1301ce24b045"

address

string

required

The wallet address on the specified network.

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

network

enum<string>

required

The blockchain network for this wallet.

Available options:

sol,

fogo,

ethereum,

optimism,

arbitrum,

polygon,

base,

avalanche,

sui,

noble,

sei,

tron,

starknet,

aptos,

hyperliquid

Example:

"sol"

customerId

string

required

The unique identifier of the customer who owns this wallet.

Example:

"customer_66c4168d418a410eae282b83883bdc39"

created

string

required

The ISO 8601 timestamp when the wallet was created.

Example:

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

updated

string

required

The ISO 8601 timestamp when the wallet was last updated.

Example:

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