LogoLogo
Back to AppHelp Center
  • Getting Started
    • Welcome
  • OrdinalsBot API
    • Overview
    • Libraries
    • Template-App
    • Signet
    • Testnet
    • Fractal
    • Getting Prices
      • Getting Prices (Legacy)
    • Create a Direct Inscription Order
    • Create a Managed Inscription Order
    • Get Order Status
    • Create a Collection
    • Create a Collection Order
    • Create Text Inscription Order
    • Search Inscriptions
    • Check Rare Sats Inventory
    • Referral Scheme
    • Transaction Accelerator
    • Burning Assets
    • Webhooks
    • Order States
    • Order Types
  • Runes
    • Etch
    • Mint
    • Direct Mint
      • 1. Generate Direct Mint PSBT
      • 2. Direct Rune Mint Process PSBT
    • Launchpad
      • Create
      • Mint
      • Get Launchpad
    • Airdrop
  • Token Pay
    • What is TokenPay?
    • API Docs
      • API reference
        • Order
        • Create payment psbt
        • Create burn rune psbt
        • Validate burn rune tx
        • Create burn inscription psbt
        • Utils
          • Checktx
          • Submittx
          • Finalize psbt
        • User
          • Withdrawal
          • Order
            • Rune
          • Account
            • Withdraw
            • Balance
      • Specification
  • Marketplace
    • User Guide: Pre-Inscribed Launchpad API
    • API Docs
    • Editions Launchpad
  • Launchpad API
    • Create Marketplace
    • Create a new Launchpad
    • Retrieve Launch PSBT
    • Confirm Launch
    • Check Allocation
    • Check for Padding Outputs
    • Setup Padding Outputs
    • Create buy offer
    • Confirm buy offer
    • Get Launch Info
  • Sat Scanner API
    • Find Special Ranges
    • Find Special Ranges UTXO
    • Supported Satributes
  • Sat Extractor
    • Extract
  • BRC20 / BRC2.0PROG
    • OPI API
    • Bitcoin Remix
  • SNS API
    • SNS API
  • Mempool API
    • Mempool API
  • TAP PROTOCOL
    • Tap Reader API
  • UTXO
    • Split
  • User Guide
    • Inscribe your first Ordinal
    • Receiving Payments
  • Knowledge Base
    • Ordinals
      • What is an Ordinal?
      • Satoshi Rarity
      • What are BRC-20 Tokens?
      • Image Optimisation
      • Pixel Art
    • Bitcoin
      • Unspent Transaction Output (UTXO)
  • Official Links
    • Twitter
    • Discord
Powered by GitBook
On this page
  • POST a new mint order
  • Mint from launchpad
  1. Runes
  2. Launchpad

Mint

Use this endpoint to mint from a launchpad

  • 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.

POST a new mint order

Mint from launchpad

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

Request Body

Name
Type
Description

id*

String

The launchpad id

count*

Number

How many items you want to mint

fee*

Number

The chain fee per vbyte for the order

receiveAddress*

String

Address to send the minted runes

referral

String

Referral code to earn up to %15 of the order base 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.

Note: additionalFee is added per saleMultiplier.

webhookUrl

String

Webhook URL to receive a POST payload for order updates.

postage

Number

Set custom postage for the order's asset: minimum 330 sats, maximum 10,000 sats.

(default=546)

{
    "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"
    }
}
{
    status: 'error',
    error: 'error reason'
}

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

PreviousCreateNextGet Launchpad

Last updated 26 days ago

Refer to for format of the webhook payload.

Webhooks