Wallets

List wallets

get

https://sandbox.sverse.iohttps://open.sverse.io

/v1/wallets

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ownerTypestring · enumOptionalPossible values:

ownerIdstringOptional

chainKeystringOptional

Optional filter by chainKey (e.g. eth-mainnet, ton-mainnet)

cursorstringOptional

limitinteger · min: 1 · max: 200OptionalDefault: 50

Responses

200

Wallets list

application/json

get

/v1/wallets

HTTPcURLJavaScriptPython

GET /v1/wallets HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Wallets list

{
  "items": [
    {
      "id": "wlt_01HXYZ...",
      "ownerType": "member",
      "ownerId": "text",
      "createdAt": "2026-01-19T11:24:17.964Z"
    }
  ],
  "page": {
    "nextCursor": "text"
  }
}

Create a logical wallet

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/wallets

Creates a logical wallet. Chain addresses can be generated/linked via /addresses.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ownerTypestring · enumRequiredPossible values:

ownerIdstringRequired

Responses

201

Wallet created

application/json

post

/v1/wallets

HTTPcURLJavaScriptPython

POST /v1/wallets HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "ownerType": "member",
  "ownerId": "text",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

201

Wallet created

{
  "id": "wlt_01HXYZ...",
  "ownerType": "member",
  "ownerId": "text",
  "createdAt": "2026-01-19T11:24:17.964Z"
}

List chain addresses for a wallet

get

https://sandbox.sverse.iohttps://open.sverse.io

/v1/wallets/{walletId}/addresses

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

walletIdstringRequired

Responses

200

Address list

application/json

get

/v1/wallets/{walletId}/addresses

HTTPcURLJavaScriptPython

GET /v1/wallets/{walletId}/addresses HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Address list

{
  "items": [
    {
      "id": "wad_01HXYZ...",
      "walletId": "text",
      "chainKey": "ton-mainnet",
      "address": "EQD...",
      "custodyType": "custodial",
      "status": "active",
      "createdAt": "2026-01-19T11:24:17.964Z",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

Create or link a chain address

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/wallets/{walletId}/addresses

Generates a custodial address or links an external address for a given chain.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

walletIdstringRequired

Body

application/json

chainKeystringRequiredExample: eth-mainnet

custodyTypestring · enumRequiredPossible values:

addressstring | nullableOptional

Required when custodyType=external.

labelstring | nullableOptional

Responses

201

Address created/linked

application/json

post

/v1/wallets/{walletId}/addresses

HTTPcURLJavaScriptPython

POST /v1/wallets/{walletId}/addresses HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "chainKey": "eth-mainnet",
  "custodyType": "custodial",
  "address": "text",
  "label": "text"
}

201

Address created/linked

{
  "id": "wad_01HXYZ...",
  "walletId": "text",
  "chainKey": "ton-mainnet",
  "address": "EQD...",
  "custodyType": "custodial",
  "status": "active",
  "createdAt": "2026-01-19T11:24:17.964Z",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Get wallet balances (multi-chain)

get

https://sandbox.sverse.iohttps://open.sverse.io

/v1/wallets/{walletId}/balances

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

walletIdstringRequired

Query parameters

chainKeystringOptional

Optional chain filter

Responses

200

Balances

application/json

get

/v1/wallets/{walletId}/balances

HTTPcURLJavaScriptPython

GET /v1/wallets/{walletId}/balances HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Balances

{
  "walletId": "text",
  "balances": [
    {
      "chainKey": "eth-mainnet",
      "currencyCode": "GOLD",
      "amount": "100.50"
    }
  ]
}