---
title: "Initialize new wallet with randomly generated seed"
method: POST
path: "/wallet/init"
tags: ["wallet"]
---

# Initialize new wallet with randomly generated seed

`POST /wallet/init`

Initializes a brand new wallet by generating a fresh BIP-39 mnemonic seed phrase on the server.
The seed is encrypted on disk with `pass` and the returned mnemonic is the ONLY copy — the caller
must back it up, the node will not show it again. Fails if a wallet file already exists;
use `/wallet/restore` to overwrite from a known mnemonic instead.

## Request body

- InitWallet
  - `pass` string, required — Spending password used to encrypt the wallet secret storage on disk. Required on every /wallet/unlock afterwards. Not recoverable — losing it means restoring from the mnemonic.
  - `mnemonicPass` string — Optional BIP-39 passphrase (a.k.a. 25th word) that is mixed into the seed derivation. Distinct from `pass`: it is NOT stored by the node and MUST be supplied again on restore. Empty/omitted means no passphrase.

## Response `200`

New wallet with randomly generated seed created successfully

- InitWalletResult
  - `mnemonic` string, required — Mnemonic seed phrase

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/ergoplatform/apis/ergo-node-api.md) · [All operations](https://skmtc.dev/ergoplatform/apis/ergo-node-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ergoplatform/ergo-node-api/revisions/a731602272c6/schema)