POST
/
v1
/
wallets
curl --request POST \
  --url https://api.privy.io/v1/wallets \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'privy-app-id: <privy-app-id>' \
  --data '{
  "chain_type": "ethereum"
}'
{
  "id": "id2tptkqrxd39qo9j423etij",
  "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
  "chain_type": "ethereum",
  "policy_ids": [],
  "additional_signers": [],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "created_at": 1741834854578
}

Authorizations

Authorization
string
header
required

App secret authentication

Headers

privy-app-id
string
required

ID of your Privy app

privy-authorization-signature
string

Request authorization signature. If multiple signatures are required, they should be comma separated.

Body

application/json
chain_type
enum<string>
required

Chain type of the wallet. 'Ethereum' supports any EVM-compatible network.

Available options:
solana,
ethereum
policy_ids
string[]

List of policy IDs for policies that should be enforced on the wallet. Currently, only one policy is supported per wallet.

owner
object | null

The P-256 public key of the owner of the wallet.

owner_id
string | null

The owner ID of the wallet.

additional_signers
object[]

Additional signers for the wallet.

Response

200 - application/json
Newly created wallet.
id
string
required

Unique ID of the wallet. This will be the primary identifier when using the wallet in the future.

address
string
required

Address of the wallet.

created_at
number
required

Unix timestamp of when the wallet was created in milliseconds.

chain_type
enum<string>
required

Chain type of the wallet. 'Ethereum' supports any EVM-compatible network.

Available options:
solana,
ethereum
policy_ids
string[]
required

List of policy IDs for policies that are enforced on the wallet.

owner_id
string
required

The owner of the wallet.

additional_signers
object[]
required

Additional signers for the wallet.

authorization_threshold
number

The number of authorization key signatures required to approve a transaction.