Use this endpoint to retrieve a paginated list of all crypto wallets registered in your SpherePay account. You can optionally filter by customer ID to return only wallets belonging to a specific customer. Results are returned in descending order of creation time.
Endpoint GET https://api.spherepay.co/v2/wallet
Authentication All requests require a Bearer token in the Authorization header.
Authorization: Bearer <token>
Query parameters Page number to retrieve. Defaults to "1".
Number of wallets to return per page. Defaults to "10".
Filter results to only wallets belonging to the specified customer ID.
-H "Authorization: Bearer $SPHERE_API_KEY "
Response fields Array of wallet objects. Unique identifier for the wallet.
The blockchain address that was registered.
The network code this wallet is registered on (e.g., "sol", "ethereum").
ID of the customer who owns this wallet.
ISO 8601 timestamp of when the wallet was registered.
ISO 8601 timestamp of the most recent update.
Pagination metadata. Number of items per page.
Total number of wallets matching the query.
Whether a next page exists.
Whether a previous page exists.
"data" : [ { "id" : "wallet_ce745ef7f3df4b9a8bff1301ce24b045" , "address" : "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" , "network" : "sol" , "customerId" : "customer_66c4168d418a410eae282b83883bdc39" , "created" : "2025-01-01T00:00:00.000Z" , "updated" : "2025-01-01T00:00:00.000Z" } ], "pagination" : { "page" : 1 , "limit" : 10 , "total" : 1 , "totalPages" : 1 , "hasNext" : false , "hasPrevious" : false } }
Error responses Status Code Description 400address/invalidOne or more query parameters are invalid. 404resource/not-foundThe specified customer ID does not exist. 422validation/failedValidation failed. The response includes a per-field errors array.
