Check mintable QUARTZ
Section titled “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
GET /wallets/01a1f8d3-ea7b-7a12-8b34-56789abcdef0/mintable| Input | Meaning and format |
|---|---|
address |
Wallet address on the selected network. Lowercase UUIDv7. |
Response: 200 OK
{ "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
Section titled “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.
POST /wallets/01a1f8d3-ea7b-7a12-8b34-56789abcdef0/tradesAuthorization: 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
{ "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. |