Skip to main content
POST
CreateDepositWallet
Creates a deposit address bound to your business reference. Idempotent on (API token, network, ref): repeated calls return the same address, so it is safe to retry. An EVM address works on all five chains.
If you only use one EVM chain, a ref like arbitrum_<user_uuid> makes wallets easy to tell apart.
Sweep uses a separate API token issued by MPCVault - see the Sweep Overview.

Errors

All errors return a JSON object with code, error, and reason fields:

Authorizations

x-mtoken
string
header
required

Your API token. Required for all API requests.

Body

application/json
network
string
required

Logical network. EVM or SOLANA, case-insensitive.

Example:

"EVM"

ref
string
required

Unique business reference, 1-128 characters, no : < > ;. <network>_<account_id> recommended.

Example:

"customer-wallet-001"

Response

200 - application/json

Success

address
string

The deposit address. An EVM address works on all five supported chains.

Example:

"0x59b4a4Fd7bC1BAA0e6BB65cBFe3e2E4dbFa5E0a1"

network
string

Logical network of the address.

Example:

"EVM"

ref
string

The business reference the address is bound to.

Example:

"customer-wallet-001"