List All Registered Customer Crypto Wallets

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

string

default:"1"

Page number to retrieve. Defaults to "1".

limit

string

default:"10"

Number of wallets to return per page. Defaults to "10".

customerId

string

Filter results to only wallets belonging to the specified customer ID.

  -H "Authorization: Bearer $SPHERE_API_KEY"

Response fields

data

object[]

Array of wallet objects.

Show properties

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").

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.

pagination

object

Pagination metadata.

Show properties

page

number

Current page number.

limit

number

Number of items per page.

total

number

Total number of wallets matching the query.

totalPages

number

Total number of pages.

hasNext

boolean

Whether a next page exists.

hasPrevious

boolean

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
`400`	`address/invalid`	One or more query parameters are invalid.
`404`	`resource/not-found`	The specified customer ID does not exist.
`422`	`validation/failed`	Validation failed. The response includes a per-field `errors` array.

Documentation Index

​Endpoint

​Authentication

​Query parameters

​Response fields

​Error responses

Endpoint

Authentication

Query parameters

Response fields

Error responses