WalletsTech API Documentation

Creates the user and derives one wallet per configured chain from a single bip39 mnemonic, atomically.

⚠️ The mnemonic is returned exactly once and is never stored in plaintext. Persist it before you discard the response — /seed export is permanently disabled.

The password (minimum 8 characters) encrypts the keystore entries with AES-256-GCM. It is unrecoverable and is required by /send and /extend.

Only chains the deployment is configured for are created, so a partial address map is normal in development. Chains configured later are backfilled with /extend.

Creates the user and derives **one wallet per configured chain** from a single bip39 mnemonic, atomically. ⚠️ **The `mnemonic` is returned exactly once and is never stored in plaintext.** Persist it before you discard the response — `/seed` export is permanently disabled. The `password` (minimum 8 characters) encrypts the keystore entries with AES-256-GCM. It is unrecoverable and is required by `/send` and `/extend`. Only chains the deployment is configured for are created, so a partial address map is normal in development. Chains configured later are backfilled with `/extend`.

Authentication

AuthorizationBearer

A 15-minute token from /auth. Required on every endpoint except /auth.

Request

This endpoint expects an object.

passwordstringRequired>=8 characters

Keystore password (AES-256-GCM, scrypt KDF). Unrecoverable — required by /send and /extend.

existingSeedstringOptional

bip39 seed phrase, validated with bip39.validateMnemonic.

Response

resultobject

requestIdstring

Echo of the inbound X-Request-Id, or a generated one.

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

503

Service Unavailable Error

$	curl -X POST https://your-endpoint.example.com/create \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"password": "changeme123"
>	}'

1	{
2	"result": {
3	"userId": "66b1f0c23d4e4a5b9c6d7e8f",
4	"addresses": {
5	"BITCOIN": "bc1q5psk2q8t4x495ap75zghxmyvlmk59lr2u93r6j",
6	"BNB": "0xc0c548339ee2af89c078200cabd1b7c7b47d911a",
7	"ETHEREUM": "0xc0c548339ee2af89c078200cabd1b7c7b47d911a",
8	"POLYGON": "0xc0c548339ee2af89c078200cabd1b7c7b47d911a",
9	"SOLANA": "EB81pobCpSX16xKeuwYyNMDuZEcpWuHcmimQ9LbdT63d",
10	"TRON": "THxvJmtZghePy5XqDE7HKawvFAsAgxcWZt"
11	},
12	"mnemonic": "<your 12-word seed phrase — returned once, never again>"
13	},
14	"requestId": "b7a1f0c2-3d4e-4a5b-9c6d-7e8f90a1b2c3"
15	}

Create a user

Authentication

Headers

Request

Response

Errors