Skip to main content
List Wallets
curl --request GET \
  --url https://api.spherepay.co/v2/wallet \
  --header 'Authorization: Bearer <token>'
{
  "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
  }
}
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.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
page
string
default:1
required

Page number of the list (default: 1)

Example:

1

​
limit
string
default:10
required

Number of items per page (default: 10)

Example:

10

​
customerId
string

Filter by customer ID

Example:

"customer_66c4168d418a410eae282b83883bdc39"

Response

​
data
object[]
required

Array of wallet objects

​
pagination
object
required
Last modified on June 18, 2026