Skip to content

Minting

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.

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

{
"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.