Skip to main content
POST
/
v1
/
wallets
Create wallet
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",
  "external_id": "my-order-123"
}
'
{
  "id": "id2tptkqrxd39qo9j423etij",
  "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
  "display_name": "Treasury",
  "external_id": "my-order-123",
  "chain_type": "ethereum",
  "policy_ids": [],
  "additional_signers": [],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "created_at": 1741834854578,
  "exported_at": null,
  "imported_at": null
}

​
SDK methods

Learn more about creating wallets using our SDKs here.

Authorizations

​
Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

​
privy-app-id
string
required

ID of your Privy app.

​
privy-idempotency-key
string

Idempotency keys ensure API requests are executed only once within a 24-hour window.

Body

application/json
​
chain_type
enum<string>
required

The wallet chain types.

Available options:
ethereum,
solana,
cosmos,
stellar,
sui,
aptos,
movement,
tron,
bitcoin-segwit,
bitcoin-taproot,
near,
ton,
starknet,
spark
​
display_name
string

A human-readable label for the wallet.

Maximum string length: 100
​
external_id
string

A customer-provided identifier for mapping to external systems. URL-safe characters only ([a-zA-Z0-9_-]), max 64 chars. Write-once: cannot be changed after creation.

Maximum string length: 64
Pattern: ^[a-zA-Z0-9_-]+$
​
policy_ids
string<cuid2>[]

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

Maximum array length: 1
Required string length: 24
​
owner
OwnerInputUser · object

Owner input specifying a Privy user ID.

​
owner_id
string<cuid2> | null

The key quorum ID to set as the owner of the resource. If you provide this, do not specify an owner.

​
additional_signers
AdditionalSignerItemInput · object[]

Additional signers for the wallet.

Response

200 - application/json

Newly created wallet.

A wallet managed by Privy's wallet infrastructure.

​
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

The wallet chain types.

Available options:
ethereum,
solana,
cosmos,
stellar,
sui,
aptos,
movement,
tron,
bitcoin-segwit,
bitcoin-taproot,
near,
ton,
starknet,
spark
​
policy_ids
string[]
required

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

​
owner_id
string<cuid2> | null
required

The key quorum ID of the owner of the wallet.

​
additional_signers
WalletAdditionalSignerItem · object[]
required

Additional signers for the wallet.

​
exported_at
number | null
required

Unix timestamp of when the wallet was exported in milliseconds, if the wallet was exported.

​
imported_at
number | null
required

Unix timestamp of when the wallet was imported in milliseconds, if the wallet was imported.

​
display_name
string

A human-readable label for the wallet.

​
external_id
string

A customer-provided identifier for mapping to external systems. Write-once, set only at creation.

​
public_key
string

The compressed, raw public key for the wallet along the chain cryptographic curve.

​
authorization_threshold
number

The number of keys that must sign for an action to be valid.

​
custody
WalletCustodian · object

Information about the custodian managing this wallet.