Skip to content

Wallets

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 /wallets

Response: 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).