Retrieve a Customer Crypto Wallet by ID

Use this endpoint to retrieve a single registered wallet by its ID. The response includes the wallet address, its blockchain network, and the ID of the owning customer.

Endpoint

GET https://api.spherepay.co/v2/wallet/{id}

Authentication

All requests require a Bearer token in the Authorization header.

Authorization: Bearer <token>

Path parameters

string

required

The wallet ID returned when the wallet was registered (e.g., "wallet_ce745ef7f3df4b9a8bff1301ce24b045").

  -H "Authorization: Bearer $SPHERE_API_KEY"

Response fields

string

Unique identifier for the wallet.

address

string

The blockchain address that was registered.

network

string

The network code this wallet is registered on (e.g., "sol", "ethereum", "polygon").

customerId

string

ID of the customer who owns this wallet.

created

string

ISO 8601 timestamp of when the wallet was registered.

updated

string

ISO 8601 timestamp of the most recent update.

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

Error responses

Status	Code	Description
`400`	`address/invalid`	The request is malformed or the ID format is invalid.
`404`	`resource/not-found`	No wallet with the specified ID exists.
`422`	`validation/failed`	Validation failed. The response includes a per-field `errors` array.

Documentation Index

​Endpoint

​Authentication

​Path parameters

​Response fields

​Error responses

Endpoint

Authentication

Path parameters

Response fields

Error responses