Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Wallets

Create custodial wallet

Create a new wallet custodied by a third-party provider.

post/v1/custodial_wallets

Headers

privy-app-idstring required

ID of your Privy app.

privy-idempotency-keystring

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

Request body

chain_type'ethereum' | 'solana' required

The chain type of the custodial wallet.

policy_idsstring[]

An optional list of up to one policy ID to enforce on the wallet.

provider'bridge' required

The provider of the custodial wallet.

provider_user_idstring required

The resource ID of the beneficiary of the custodial wallet, given by the licensing provider.

Example request

{
  "chain_type": "ethereum",
  "provider": "bridge",
  "provider_user_id": "1234567890"
}

Response

Newly created custodial wallet.

addressstring required
chain_type'ethereum' | 'solana' required

The chain type of the custodial wallet.

idstring required
owner_idstring cuid2 required

A unique identifier for a key quorum.

policy_idsstring[]

Example response

{
  "additional_signers": [],
  "address": "0xB00F0759DbeeF5E543Cc3E3B07A6442F5f3928a2",
  "chain_type": "ethereum",
  "custody": {
    "provider": "bridge",
    "provider_user_id": "1234567890"
  },
  "id": "id2tptkqrxd39qo9j423etij",
  "owner_id": null,
  "policy_ids": []
}