Create Wallet

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonOptional

customerRequiredstring

The id of the customer associated with the wallet. If not provided, this will be associated with the owner of the account.

networkRequiredstring

The network of the wallet. Transfer supported networks are sol, ethereum and base. Please refer to our Accepted Currency Guide for the full network and coins supported.

addressRequiredstring

The address of the wallet.

nicknamestring

The name of the wallet for easier identification.

curl -X POST "https://api.sandbox.spherepay.co/v1/wallet" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "{{customer_id}}",
    "network": "sol",
    "address": "9K6CyrAoG6zJYwi2hneXdxN47CpWqiywaS7fmgFAYc3v"
  }'

{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "wallet": {
      "id": "wallet_adc97840430947c2a6462c77cb67cf5b",
      "address": "9K6CyrAoG6zJYwi2hneXdxN47CpWqiywaS7fmgFAYc3v",
      "network": "sol",
      "nickname": null,
      "risk": "low",
      "primary": false,
      "feePayer": false,
      "signed": false,
      "mock": false,
      "lookupKey": null,
      "customer": "customer_68f1c089703945e7bbff6f04bf1c5041",
      "owner": "customer",
      "exported": null,
      "created": "2025-04-08T23:07:19.299Z",
      "updated": "2025-04-08T23:07:19.299Z",
      "deleted": null
    }
  },
  "ts": "2025-04-13T22:04:37.275Z",
  "request": "request_3d919acf664243be98012ee6289d723f"
}

Authorization

Request Body

Response

TypeScript