Skip to main content
POST
Create Wallet

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

Aptos wallet creation input

chainType
enum<string>
required
Available options:
aptos
config
any
owner
string

A user locator can be of the format:

  • email:<email>
  • userId:<userId>
  • phoneNumber:<phoneNumber>
  • twitter:<handle>
  • x:<handle>
type
enum<string>
default:mpc
Available options:
mpc

Response

Returns an existing wallet (200) if one already exists for the provided owner 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

address
string
required

The onchain address of the wallet

Example:

"0x1234567890123456789012345678901234567890"

chainType
enum<string>
required

The blockchain type of the wallet

Available options:
aptos
type
enum<string>
required

The wallet type (smart or mpc)

Available options:
mpc,
smart
Example:

"smart"

alias
string

The wallet alias

Example:

"my-usdc-wallet"

config
any

Aptos wallet type specific configuration settings

createdAt

ISO timestamp of when the wallet was created

owner
string

The user that owns this wallet in format :

Example:

"email:test@example.com"