Create

Use this endpoint to create a rune launchpad

• Creating a rune launchpad requires a pre-payment for splitting the rune tokens

• The pre-payment details are in the charge field returned by the endpoint

• You will also need to send us the premined tokens, the address and amount for the premined tokens are in the tokenCharge field

• Make sure to send the bitcoin pre-payment in a single transaction and UTXO

• Make sure to send the rune transfer in a single transfer transaction

• After bitcoin payment and the rune tokens are received, we will initiate a splitting transaction. The details of this transaction are available in the runeSplitParameters field, the txid will appear in the txid field there

• Only after this splitting transaction is confirmed the launchapd will enter into a state ready. This means that the launchapd is ready and waiting to be started.

• Ask an ordinalsbot team member to start the launchpad by moving it into state minting or allowlist

• As of right now salesCap is limited to 10,000, ask us privately if you need an increase

POST a new rune launchpad order

Create a rune launchpad

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

Request Body

Name	Type	Description
id*	String	Human-readable launchpad id
rune*	String	The name of rune you want to sell (with spacers)
creatorAddress*	String	The bitcoin address where we will send the proceeds from the sale
saleSize*	Number	We will sell this many tokens per batch (equivalent to terms.amount in runestone)
salesCap*	Number	The number of available batches for sale (equivalent to terms.cap in runestone)
totalTokensForSale*	Number	The total amount of tokens that are available for sale on the launchpad. Must equal saleSize * salesCap
price*	Number	Price per token
splittingFee*	Number	Chain fee in sat/vb for the splitting transaction required before starting the launchpad
publicAllocation	Number	Publicly available allocation of tokens
allowList	Object	The allowlist
accessRules	Array	Array of objects that set rules on who can claim tokens from the launchpad. e.g. [{"api": "brc20", "token": "TRIO", "allocation":10}] This will check user address balance for brc20 TRIO tokens and allow them to claim 10 rune launchpad tokens per TRIO they hold.
metadata	Object	Any metatada you wish for your collection you can pass it as any type of JS object here. Max size 10kb.

200: OK

{
    "id": "f5c055a5-05c7-4208-b911-beb6191a8068",
    "charge": {
        "address": "bc1qrt6u67my3ucgjj0lmvvtwgkvcnx3dq3yeupdz0",
        "amount": 5450200
    },
    "tokenCharge": {
        "address": "bc1qcqpyymhqq5sqpxz3c9ws20lqg6t2gxsnt83jpa",
        "amount": 1000000,
        "rune": "TRIO•ORDINALSBOT"
    },
    "runeSplitParameters": {
        "rune": "TRIO•ORDINALSBOT",
        "splitsNumber": 1000,
        "splitSize": 1000,
        "fee": 5450200,
        "executed": false
    },
    "rune": "TRIO•ORDINALSBOT",
    "creatorAddress": "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3",
    "saleSize": 1000,
    "salesCap": 1000,
    "totalTokensForSale": 1000000,
    "price": 1,
    "publicAllocation": 0,
    "state": "waiting-prepayment",
    "paidItemCount": 0,
    "allocatedItemCount": 0,
    "mintedItemCount": 0,
    "createdAt": {
        ".sv": "timestamp"
    }
}

500: Internal Server Error

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

400: Bad Request

// Here's a sample payload you can POST to create a rune order
{
    "splittingFee": 100,
    "rune": "TRIO•ORDINALSBOT",
    "creatorAddress": "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3",
    "price": 1,
    "saleSize": 1000,
    "salesCap": 1000,
    "totalTokensForSale": 1000000
}