POST
/
2022-06-09
/
wallets

Headers

X-API-KEY
string
required

API key required for authentication

x-idempotency-key
string

Unique key to prevent duplicate wallet creation

Body

application/json

EVM smart wallet creation input

type
enum<string>
required
Available options:
evm-smart-wallet
config
object
linkedUser
string

A user locator can be of the format:

  • email:<email>
  • userId:<userId>
  • phoneNumber:<phoneNumber>
  • twitter:<handle>
  • x:<handle>

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

type
enum<string>
required

The type of wallet configuration

Available options:
evm-smart-wallet
config
object
required

EVM smart wallet type specific configuration settings

address
string
required

The onchain address of the wallet

linkedUser
string

The user that is linked to this wallet in format <locatorType>:<value>

createdAt
number

ISO timestamp of when the wallet was created