Skip to main content
POST
/
wallets
Create a wallet
curl --request POST \
  --url https://api.zetmoney.co/v1/wallets \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "externalUserId": "user_abc123",
  "chain": "base",
  "metadata": {
    "email": "user@example.com",
    "tier": "premium"
  }
}
'
{
  "success": true,
  "data": {
    "id": "wal_01H8X3...",
    "externalUserId": "user_abc123",
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "chain": "base",
    "isDeployed": {
      "base": true,
      "bsc": false
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

Authorizations

​
x-api-key
string
header
required

Your Zet API key. Contact zetdotmoney@gmail.com to obtain your keys.

Body

application/json
​
externalUserId
string
required

Your unique identifier for this user. Used to link the wallet back to your system.

Example:

"user_abc123"

​
chain
enum<string>
default:base

Primary chain for the wallet. The same wallet address is deterministically available on all supported chains.

Available options:
base,
bsc
​
metadata
object

Arbitrary key-value pairs to store with the wallet.

Example:
{
  "email": "user@example.com",
  "tier": "premium"
}

Response

Wallet created successfully.

​
success
boolean
Example:

true

​
data
object