Mint

Use this endpoint to mint an existing rune as defined in https://docs.ordinals.com/runes.html#minting

  • Runes are available on testnet only until block height 840000.

  • We allow the execution of n mints per order, dictated by the field numberOfMints

  • n mints will create n transactions

  • Minting transaction ids will appear in the order in the field mintingTxs

  • For every mint transaction the counter executedMints will be incremented

POST a new rune mint order

Mint Rune

POST https://api.ordinalsbot.com/runes/mint

Request Body

NameTypeDescription

rune*

String

Rune name

receiveAddress*

String

A single Bitcoin address to receive the rune balance for the whole order

fee*

Number

Miner fee that will be paid while inscribing the ordinals in sats/byte.

numberOfMints

Number

Number of times provided rune should be minted to receive address. (default=1)

referral

String

Referral code to earn up to %15 of the order service fee.

additionalFee

Number

Amount of satoshis to charge extra for this order that will be added to "referral" account.

Needs to be used together with "referral" parameter.

{
    "charge": {
        "id": "0128d9cd-5821-4f2e-b042-9124f8027b0f",
        "description": "e3124086-4f86-4b73-be2b-f5bcceea7d0b",
        "desc_hash": false,
        "created_at": 1713286060,
        "status": "unpaid",
        "amount": 24200,
        "success_url": null,
        "hosted_checkout_url": "https://checkout.dev.opennode.com/0128d9cd-5821-4f2e-b042-9124f8027b0f",
        "order_id": null,
        "currency": "BTC",
        "source_fiat_value": 24200,
        "fiat_value": 15.03,
        "auto_settle": false,
        "notif_email": null,
        "address": "2NG1xF8STPUhwtaTJyKUdGMai8GXs5mK8sy",
        "metadata": {},
        "chain_invoice": {
            "address": "2NG1xF8STPUhwtaTJyKUdGMai8GXs5mK8sy"
        },
        "uri": "bitcoin:2NG1xF8STPUhwtaTJyKUdGMai8GXs5mK8sy?amount=0.000242&label=e3124086-4f86-4b73-be2b-f5bcceea7d0b&lightning=lntb242u1pnpa2avpp5jh0f855vgg2zakshfce6zua8q7jfj3dkejwak93d52073c7vjevqdp6v5enzv35xqurvtf5vcurvtf5vgmnxttzv5exyttxx43xxcm9v4snwepsvgcqzzsxqy8ayqsp5ug9pp67ed0tq3064vu8fjhghmwwvq7w3zwyjk5mnmqukgjxjayws9qyyssq8kgsw4d6drsy346kag3jsxlzmzlkqr0fnpp0gy6f27kj9nmss4wx40r9qrmafc64kexe8tat6lj94y39cezay8drg9qtw4qyx57mg9qq4nfknr",
        "ttl": 4320,
        "lightning_invoice": {
            "expires_at": 1713545260,
            "payreq": "lntb242u1pnpa2avpp5jh0f855vgg2zakshfce6zua8q7jfj3dkejwak93d52073c7vjevqdp6v5enzv35xqurvtf5vcurvtf5vgmnxttzv5exyttxx43xxcm9v4snwepsvgcqzzsxqy8ayqsp5ug9pp67ed0tq3064vu8fjhghmwwvq7w3zwyjk5mnmqukgjxjayws9qyyssq8kgsw4d6drsy346kag3jsxlzmzlkqr0fnpp0gy6f27kj9nmss4wx40r9qrmafc64kexe8tat6lj94y39cezay8drg9qtw4qyx57mg9qq4nfknr"
        }
    },
    "paylink": {
        "id": "66xxx16", // visit https://app.hel.io/pay/66xxx16 to pay
    },
    "rune": "BITCOIN•HAS•A•CAT",
    "receiveAddress": "tb1qwejhagpav9rkrwpk55ul6pes6f89glpkpds487",
    "fee": 10,
    "chainFee": 2000,
    "serviceFee": 22200,
    "baseFee": 12000,
    "rareSatsFee": 0,
    "postage": 10000,
    "additionalFee": null,
    "numberOfMints": 1,
    "id": "e3124086-4f86-4b73-be2b-f5bcceea7d0b",
    "orderType": "rune-mint",
    "state": "waiting-payment",
    "createdAt": {
        ".sv": "timestamp"
    },
    "executedMints": 0,
    "mintingTxs": []
}
// Here's a sample payload you can POST to create a rune mint order
{
    "rune": "MEGA•MEME•COIN",
    "fee": 8,
    "receiveAddress": "tb1pqwh3dxhg3k4szt9zm5kt8p0m97nl7k7zlmplehmr6alc4ut8xd5qams63p",
    "numberOfMints": 2,
}

Last updated