> For the complete documentation index, see [llms.txt](https://docs.ordinalsbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ordinalsbot.com/runes/launchpad/mint.md).

# Mint

Use this endpoint to mint from a launchpad

{% hint style="info" %}

* During high demand mints it is possible that we cannot mint the requested `count` due to orders that came before you. In this case we will mint less than the requested count.
* The final mint count will always be contained in the field finalMintCount, refer to this field to see how much of your order has completed
* In high demand scneraios, if your order was paid but the launchpad minted out before processing your order we will add the `error` `rune minted out to your order`. Reach out for refund in this scenario.
  {% endhint %}

### `POST` a new mint order

## Mint from launchpad

<mark style="color:green;">`POST`</mark> `https://api.ordinalsbot.com/runes/launchpad/mint`

#### Request Body

<table><thead><tr><th width="168">Name</th><th width="106">Type</th><th>Description</th></tr></thead><tbody><tr><td>id<mark style="color:red;">*</mark></td><td>String</td><td>The launchpad id</td></tr><tr><td>count<mark style="color:red;">*</mark></td><td>Number</td><td>How many items you want to mint</td></tr><tr><td>fee<mark style="color:red;">*</mark></td><td>Number</td><td>The chain fee per vbyte for the order</td></tr><tr><td>receiveAddress<mark style="color:red;">*</mark></td><td>String</td><td>Address to send the minted runes</td></tr><tr><td>referral</td><td>String</td><td>Referral code to earn up to %15 of the order base fee.</td></tr><tr><td>additionalFee</td><td>Number</td><td><p>Amount of satoshis to charge extra for this order that will be added to "referral" account.</p><p>Needs to be used together with "referral" parameter.</p><p><strong>Note: additionalFee is added per saleMultiplier.</strong></p></td></tr><tr><td>webhookUrl</td><td>String</td><td><p>Webhook URL to receive a POST payload for order updates.</p><p>Refer to <a href="https://docs.ordinalsbot.com/api/webhooks">Webhooks</a> for format of the webhook payload.</p></td></tr><tr><td>postage</td><td>Number</td><td><p>Set custom postage for the order's asset: minimum 330 sats, maximum 10,000 sats.</p><p></p><p>(default=546)</p></td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "charge": {
        "id": "41d6df1a-ca2b-4915-84f8-757d8fa80f7d",
        "description": "shitcoin•paradise",
        "desc_hash": false,
        "created_at": 1714736914,
        "status": "unpaid",
        "amount": 124376,
        "success_url": null,
        "hosted_checkout_url": "https://checkout.opennode.com/41d6df1a-ca2b-4915-84f8-757d8fa80f7d",
        "order_id": null,
        "currency": "BTC",
        "source_fiat_value": 124376,
        "fiat_value": 68.46,
        "auto_settle": false,
        "notif_email": null,
        "address": "3QxHEA3qS4pQXCk17b9Kuhuh5MRxtiLAzy",
        "metadata": {},
        "chain_invoice": {
            "address": "3QxHEA3qS4pQXCk17b9Kuhuh5MRxtiLAzy"
        },
        "uri": "bitcoin:3QxHEA3qS4pQXCk17b9Kuhuh5MRxtiLAzy?amount=0.00124376&label=shitcoin%E2%80%A2paradise&lightning=lnbc1243760n1pnrfncjpp5j2vtfylxrn88v2cskms9nyezgccq8j7x6aq3en727chxrk8cv9xqdqlwd5xjarrda5kac5q5fcxzunpv35hxegcqzzsxqy8ayqsp55ej6qufnfm78f4wp2h8hj8q98vq7wj3tfe4hhk5kwyv69jga53ts9qyyssq4f2258nazp0y5nr8hsz0rdypuxsep5m59tke0g8el422cfpkelz8s2ywhclglnd30gwfe0qn0xclapt4kl433u9tev437cj9s36e0ecpk89jh4",
        "ttl": 4320,
        "lightning_invoice": {
            "expires_at": 1714996114,
            "payreq": "lnbc1243760n1pnrfncjpp5j2vtfylxrn88v2cskms9nyezgccq8j7x6aq3en727chxrk8cv9xqdqlwd5xjarrda5kac5q5fcxzunpv35hxegcqzzsxqy8ayqsp55ej6qufnfm78f4wp2h8hj8q98vq7wj3tfe4hhk5kwyv69jga53ts9qyyssq4f2258nazp0y5nr8hsz0rdypuxsep5m59tke0g8el422cfpkelz8s2ywhclglnd30gwfe0qn0xclapt4kl433u9tev437cj9s36e0ecpk89jh4"
        }
    },
    "launchpadId": "shitcoin•paradise",
    "fee": 30,
    "serviceFee": 9000,
    "price": 1,
    "count": 800,
    "postage": 546,
    "chainFee": 48000,
    "amount": 124376,
    "receiveAddress": "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3",
    "orderType": "rune-launchpad-mint",
    "id": "fc7f852d-31ff-4c32-a2c3-e8f6f47e797d",
    "additionalFee": null,
    "referral": null,
    "webhookUrl": null,
    "status": "ok",
    "state": "waiting-payment",
    "createdAt": {
        ".sv": "timestamp"
    }
}
```

{% endtab %}

{% tab title="500: Internal Server Error " %}

```json
{
    status: 'error',
    error: 'error reason'
}
```

{% endtab %}

{% tab title="400: Bad Request " %}

{% endtab %}
{% endtabs %}

```json
// Here's a sample payload you can POST to create a launchpad mint order
{
    "fee": 30,
    "count": 800,
    "id": "shitcoin•paradise",
    "receiveAddress": "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3"
}
```
