---
title: Minting
---

## Check mintable QUARTZ

`GET /wallets/{address}/mintable`

Returns the amount of QUARTZ the wallet can mint from trading profit at the time of the snapshot. No token is required.

**Request**

```http
GET /wallets/01a1f8d3-ea7b-7a12-8b34-56789abcdef0/mintable
```

| Input | Meaning and format |
| --- | --- |
| `address` | Wallet address on the selected network. Lowercase UUIDv7. |

**Response: `200 OK`**

```json
{
  "meta": {
    "network": "bubblegum",
    "at": "2026-11-22T12:00:00.123456789Z"
  },
  "data": {
    "public": {
      "asset": { "id": "QUARTZ", "units": "0.002" }
    }
  }
}
```

| Output | Meaning and format |
| --- | --- |
| `asset.id` | `QUARTZ`. |
| `asset.units` | Synthetic USD cash above the wallet’s lifetime mined USD, expressed in QUARTZ. Decimal string with up to 18 decimal places. Returns `"0"` when the wallet has no eligible profit. |
| `network` | Selected network. String. |
| `at` | Snapshot time. RFC 3339, UTC, with nine fractional digits. Reads can reuse the same amount and timestamp for 10 ms. |

An unknown wallet on the selected network returns `404`. An unavailable read returns `503`.

## Mint QUARTZ

`POST /wallets/{address}/trades`

Minting consumes the same amount of trading profit in synthetic USD as it credits in QUARTZ. Fractional amounts are valid up to 18 decimal places. The API checks the available profit when the request executes. If the amount exceeds that profit, it returns `409`.

```http
POST /wallets/01a1f8d3-ea7b-7a12-8b34-56789abcdef0/trades
Authorization: Bearer <trade-token>
Idempotency-Key: <mint-idempotency-key>
Content-Type: application/json

{
  "operation": "mint",
  "asset": {
    "id": "QUARTZ",
    "units": "0.0015"
  }
}
```

| Input | Meaning and format |
| --- | --- |
| `address` | Wallet address on the selected network. Lowercase UUIDv7. |
| `Authorization` | Bearer token. Use the wallet’s trade token. |
| `Idempotency-Key` | Client-generated UUIDv4 or UUIDv7. Unique per wallet across trades and transfers. Reuse for retries. Expires 3 hours after acceptance. |
| `operation` | `mint`. |
| `asset.id` | `QUARTZ`. |
| `asset.units` | Amount to mint. Positive plain decimal string of up to 64 characters, exactly representable with 18 decimal places. Maximum `340282366920938463463.374607431768211455`. |
| `quote` | Omit this field. |

**Response: `201 Created`**

```json
{
  "meta": {
    "network": "bubblegum",
    "at": "2026-11-20T15:22:00.124000000Z"
  },
  "data": {
    "public": {
      "transaction": "01a1f98c-da3b-7300-87a1-000000000002",
      "operation": "mint",
      "asset": {
        "id": "QUARTZ",
        "units": "0.0015"
      },
      "quote": {
        "currency": "USD",
        "price_per_unit": "1",
        "amount": "0.0015"
      }
    }
  }
}
```

| Output | Meaning and format |
| --- | --- |
| `transaction` | Transaction for the QUARTZ credit. Lowercase UUIDv7. |
| `operation` | `mint`. |
| `asset.id` | `QUARTZ`. |
| `asset.units` | QUARTZ credited. Decimal string with up to 18 decimal places and no trailing fractional zeros. |
| `quote.currency` | `USD`. |
| `quote.price_per_unit` | `"1"` synthetic USD per QUARTZ. |
| `quote.amount` | Synthetic USD spent. Equals `asset.units`. |
| `network` | Selected network. |
| `at` | Response time. RFC 3339, UTC, with nine fractional digits. |