Wallets
Create Wallet
Creates a new wallet of specified type. If called with an idempotency key or for a user who already has a wallet, returns existing wallet. When linkedUser is provided, subsequent calls with the same linkedUser will return the existing wallet. Supports both custodial and non-custodial wallet types.
API scope required: wallets.create
POST
Headers
API key required for authentication
Unique key to prevent duplicate wallet creation
Body
application/json
Response
201
application/json
Returns an existing wallet (200) if one already exists for the provided linkedUser or idempotencyKey, or creates and returns a new wallet (201). The response includes the wallet details and whether it was newly created.
Complete wallet configuration including type-specific settings
The type of wallet configuration
Available options:
evm-smart-wallet
EVM smart wallet type specific configuration settings
The onchain address of the wallet
The user that is linked to this wallet in format <locatorType>:<value>
ISO timestamp of when the wallet was created
Was this page helpful?