POST /wallets
Each request creates a new empty wallet. The API returns its trade token, transfer token, and recovery phrase only at creation. Store them privately with the wallet’s network and address.
Request
POST /walletsResponse: 201 Created
{ "meta": { "network": "bubblegum", "at": "2026-11-20T12:00:00.124000000Z" }, "data": { "public": { "address": "01a1f8d3-ea7b-7a12-8b34-56789abcdef0", "created_at": "2026-11-20T12:00:00.123000000Z" }, "private": { "tokens": { "trade": "<trade-token>", "transfer": "<transfer-token>" }, "recovery": "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon art" } }}| Output | Meaning and format |
|---|---|
address |
Wallet address. UUIDv7 (RFC 9562), lowercase, 36 characters. |
tokens.trade |
Token for buying, selling and minting. sk-{network}-{lookup}-{secret}. Independent OS CSPRNG values, lowercase hex: lookup has 128-bit entropy (32 characters); secret has 256-bit entropy (64 characters). |
tokens.transfer |
Transfer-only token. sk-{network}-{lookup}-{secret}. Independent OS CSPRNG values, lowercase hex: lookup has 128-bit entropy (32 characters); secret has 256-bit entropy (64 characters). |
recovery |
Recovery phrase. 24 lowercase English BIP-39 words, single spaces; 256-bit OS CSPRNG entropy. Keep private. Recovery is not available yet. |
created_at |
Creation time. RFC 3339 (ISO 8601 profile), UTC (Z), exactly 9 fractional digits (nanoseconds). |
network |
Selected network. String. |
at |
Response time. RFC 3339 (ISO 8601 profile), UTC (Z), exactly 9 fractional digits (nanoseconds). |