---
title: 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**

```http
POST /wallets
```

**Response: `201 Created`**

```json
{
  "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). |