Wallets

Create wallets in batch

Changed on

Creates multiple wallets in a single request. Each wallet creation is independent; failures for one wallet do not affect others. Maximum batch size is 100 wallets.

post/v1/wallets/batch

Request

  • Base URL
    https://api.privy.io
  • URL
    https://api.privy.io/v1/wallets/batch
  • Auth
    HTTP basic

Headers

privy-app-idstring required

ID of your Privy app.

Request body

Example request

{
  "wallets": [
    {
      "chain_type": "ethereum"
    },
    {
      "chain_type": "solana"
    }
  ]
}

Response

Batch creation results. Always returns 200 with a results array containing success/failure status for each wallet.

Example response

{
  "results": [
    {
      "index": 0,
      "success": true,
      "wallet": {
        "id": "id2tptkqrxd39qo9j423etij",
        "address": "0xF1DBff66C993EE895C8cb176c30b07A559d76496",
        "display_name": "Treasury",
        "external_id": "my-order-123",
        "chain_type": "ethereum",
        "policy_ids": [],
        "additional_signers": [],
        "owner_id": "rkiz0ivz254drv1xw982v3jq",
        "parent_wallet_id": null,
        "entity": null,
        "created_at": 1741834854578,
        "exported_at": null,
        "imported_at": null,
        "archived_at": null
      }
    },
    {
      "index": 1,
      "success": false,
      "error": "Policy not found",
      "code": "not_found"
    }
  ]
}

Changes

    • warning

      added the new xrpl enum value to the //// response property for the response status

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new xrpl enum value to the request property //

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      the //// response's property pattern ^[a-zA-Z0-9_-]+$ was added for the status

    • info

      added the optional property //// to the response with the status