v1

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-107095124.5 KB

Wallet management endpoints

Get status of a wallet

Get status of a wallet associated with a server generated secret. The secret is provided to the client at wallet create time.

get/user/wallet/launch

Headers

x-api-keystring required

The server generated secret required to authorize the request. This value should be the same one used returned in the POST response when the wallet was created.

Response

Successfully retrieved custody wallet status

secretstring

A secret created by the server and provided to the client only at initial wallet creation

statestring

Indicates custody state of the wallet (CUSTODY or SELF_CUSTODY)

statusstring

Indicates status of the onboarding process

Example response

{
  "secret": "server-generated-secret",
  "state": "SELF_CUSTODY",
  "status": "COMPLETE",
  "addresses": {
    "SYMBOL": "blockchain-address"
  }
}