Documentation | Wallets › Transactions

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.

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.

path Parameters

wallet_id: string

ID of the wallet.

query Parameters

asset:

UnionMember0 = "usdc" | "eth"

UnionMember1 = Array<"usdc" | "eth">

chain:

"base"

cursor: string

Optional

(minLength: 1)

limit: number

Optional

(maximum: 100)

Response fields

next_cursor: string

transactions: Array<{ caip2, created_at, details, 4 more... }>

Request example

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

200Example

{
  "next_cursor": null,
  "transactions": [
    {
      "caip2": "eip155:8453",
      "created_at": 1746920539240,
      "details": {
        "asset": "eth",
        "chain": "base",
        "display_values": {
          "eth": "0.000000000000000001"
        },
        "raw_value": "1",
        "raw_value_decimals": 18,
        "recipient": "0x38bc05d7b69f63d05337829fa5dc4896f179b5fa",
        "recipient_privy_user_id": "cmakymbpt000te63uaj85d9r6",
        "sender": "0xa24c8d74c913e5dba36e45236c478f37c8bba20e",
        "sender_privy_user_id": "rkiz0ivz254drv1xw982v3jq",
        "type": "transfer_sent"
      },
      "privy_transaction_id": "au6wxoyhbw4yhwbn1s5v9gs9",
      "status": "confirmed",
      "transaction_hash": "0x03fe1b0fd11a74d277a5b7a68b762de906503b82cbce2fc791250fd2b77cf137",
      "wallet_id": "xs76o3pi0v5syd62ui1wmijw"
    }
  ]
}