Sign in

v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Wallets

Create User Wallet

Create a user wallet with a wallet based on their authentication strategy. This endpoint creates a wallet in advance that can be claimed later when the user authenticates.

Authentication: This endpoint requires backend authentication using the x-secret-key header. The secret key should never be exposed publicly.

post/v1/wallets/user

Request body

type'google' | 'apple' | 'facebook' | 'discord' | 'email' | 'phone' | 'custom_auth_endpoint' | 'custom_jwt' | 'siwe' required
walletAddressstring

A valid Ethereum address (0x-prefixed hex string) or ENS name (e.g., vitalik.eth).

emailstring
phonestring
userIdstring

Example request

{
  "type": "email",
  "email": "test@test.com"
}

Response

Successfully created a user wallet with wallet.