v1

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

Wallet management endpoints

An asynchronous request to create a wallet

An asynchronous request to create a wallet. The resulting wallet will be custodial, but the user can claim custody at a later time using the server generated secret provided in the response.

post/user/wallet/launch

Headers

x-api-keystring required

Required to authorize the request for a new wallet

Response

Successfully requested to create a custody wallet. The status will of the response will always be PROCESSING with an empty list of addresses. Must use the corresponding GET endpoint to check status and address metadata, using the provided server generated secret as authentication.

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"
  }
}