v1

latestOpenAPI 3.1.02026-07-13570316.1 KB

Wallets

Create Server Wallet

Creates a server wallet from a unique identifier. If the wallet already exists, it will return the existing wallet.

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

post/v1/wallets/server

Request body

identifierstring required

Unique identifier for wallet creation or retrieval. Can be user ID, email, or any unique string. The same identifier will always return the same wallet.

Example request

{
  "identifier": "treasury-wallet-123"
}

Response

Server wallet created or connected successfully. Returns wallet addresses for subsequent operations.