Documentation | Wallets

API Reference

Wallets

wallets

Methods

Obtain A User Session Signer To Enable Wallet Access -> { encrypted_authorization_key, expires_at, wallets } | { authorization_key, expires_at, wallets }

post/v1/user_signers/authenticate

Obtain a user session signer to enable wallet access.

Create Wallet ->

Wallet

post/v1/wallets

Create a new wallet.

Create Wallets With An Associated Recovery User -> { recovery_user_id, wallets }

post/v1/wallets_with_recovery

Create wallets with an associated recovery user.

Get Wallet ->

Wallet

get/v1/wallets/{wallet_id}

Get a wallet by wallet ID.

Get All Wallets -> Cursor<

Wallet

get/v1/wallets

Get all wallets in your app.

Get Wallet ->

Wallet

get/v1/wallets/{wallet_id}

Get a wallet by wallet ID.

path Parameters

wallet_id: string

ID of the wallet.

Response fields

Wallet

Request example

curl https://api.privy.io/v1/wallets/$WALLET_ID \
    -H "Authorization: Basic $PRIVY_APP_ID:$PRIVY_APP_SECRET"

200Example

{
  "id": "id2tptkqrxd39qo9j423etij",
  "additional_signers": [
    {
      "signer_id": "signer_id"
    }
  ],
  "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
  "chain_type": "ethereum",
  "created_at": 1741834854578,
  "policy_ids": [
    "string"
  ],
  "owner_id": "rkiz0ivz254drv1xw982v3jq",
  "public_key": "public_key"
}

Create A Signature Or Transaction -> { data, method } | { method, data, error } | { data, method } | 5 more...

post/v1/wallets/{wallet_id}/rpc

Sign a message or transaction with a wallet by wallet ID.

Update Wallet ->

Wallet

patch/v1/wallets/{wallet_id}

Update a wallet's policies or authorization key configuration.

Domain types

Wallet = { id, additional_signers, address, 5 more... }

Wallets

Balance

wallets.balance

Methods

Get Balance -> { balances }

get/v1/wallets/{wallet_id}/balance

Get the balance of a wallet by wallet ID.

Wallets

Transactions

wallets.transactions

Methods

Get Transactions -> { next_cursor, transactions }

get/v1/wallets/{wallet_id}/transactions

Get incoming and outgoing transactions of a wallet by wallet ID.