Editions Launchpad

Create a new editions launchpad

Creates a new editions launchpad with the specified details.

post

/editions/create

Body

editionInscriptionIdstringrequired

The ID of the edition inscription.

Example: 38165c2a5a2b573196d079acbccccc3723534da4271f4be49f78e9d7ef4d5dd6i486

makerPaymentAddressstringrequired

The Bitcoin payment address of the maker.

Example: bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3

numberOfEditionsintegerrequired

The number of editions to create.

Example: 3

priceinteger

price per edition.

Example: 10000

slugstringrequired

The slug of the launchpad.

Example: satoshibles-the-ordinals

metaDataobject

Additional metadata for the launchpad.

signaturestring

A signature in the format "{inscriptionId}:{currentUTCTimestamp}:{bitcoinAddress}:{sign('{inscriptionId}:{currentUTCTimestamp}', bitcoinAddress)}"; sign('{inscriptionId}:{currentUTCTimestamp}', bitcoinAddress) must be in base64 format.

metaobject

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/editions/create' \
  --header 'Content-Type: application/json' \
  --data '{"editionInscriptionId":"38165c2a5a2b573196d079acbccccc3723534da4271f4be49f78e9d7ef4d5dd6i486","makerPaymentAddress":"bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3","numberOfEditions":3,"price":10000,"slug":"satoshibles-the-ordinals","metaData":{},"meta":{"description":"Satoshi has come home to Bitcoin! The Ordinals collection by OG NFT project Satoshibles are a limited edition collection of 100 ordinals, featuring all new traits from the original artist Ayyoub Bouzerda. This collection is a tribute to Satoshi and the enduring legacy of Bitcoin. Don't miss your chance to own a piece of history!","discord_link":"https://discord.com/invite/7Wm9Jg8MkW","icon":"https://turbo.ordinalswallet.com/inscription/preview/3542f12dbe5fe3bd7fd622d1bb54994432e9a9184d24ff62ceb83234383b558ei0","inscription_icon":"3542f12dbe5fe3bd7fd622d1bb54994432e9a9184d24ff62ceb83234383b558ei0","name":"Satoshibles: The Ordinals","slug":"satoshibles-the-ordinals","twitter_link":"https://twitter.com/satoshibles","website_link":"https://satoshibles.com","banner_image":"https://example.com/banner.jpg"}}'

200

400

200

{
  "id": "26c82416-e450-4661-b192-ada4f700bc83"
}

Editions launchpad created successfully

Create a new order for editions minting

Creates a new order for editions minting with the specified details.

post

/editions/mint

Body

launchpadIdinteger

The ID of the launchpad.

Example: 1

numberOfEditionsinteger

The number of editions to mint.

Example: 3

receiveAddresstring

The Bitcoin address to receive the minted editions.

Example: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh

feeRateinteger

The fee rate for the transaction.

Example: 5

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/editions/mint' \
  --header 'Content-Type: application/json' \
  --data '{"launchpadId":1,"numberOfEditions":3,"receiveAddres":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh","feeRate":5}'

200

400

200

{
  "id": "72ed4cde-ae61-4cbc-985f-1040d2656cd1",
  "charge": {
    "address": "bc1pmzsy06zwx5hc4shenex6ck90nnmlz5keps7c4frsype0j7n6fp4szv5w7k",
    "amount": 26678,
    "callback_url": ""
  },
  "receiveAddress": "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3",
  "pricingBreakdown": {
    "additionalFee": 2000,
    "additionalFeeCharged": 10000,
    "baseFee": 2000,
    "chainFee": 3948,
    "postage": 546,
    "serviceFee": 22730,
    "platformFee": 1000,
    "itemPrice": 1000,
    "amount": 26678
  }
}

Order created successfully

Get all launchpads

Retrieves a list of all launchpads with optional filtering.

post

/launchpads

Header parameters

x-api-keystringrequired

API key required for authorization.

Body

filterobject

pageinteger

The page number for pagination (optional)

Example: 1

itemsPerPageinteger

Number of items per page (optional)

Example: 10

sortenum

Sort listings by this field (optional)

Example: id

Options: id, created_at

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{"filter":{"status":"active"},"page":1,"itemsPerPage":10,"sort":"id"}'

200

200

{
  "data": [
    {
      "id": 1,
      "status": "text",
      "phases": []
    }
  ],
  "count": 1
}

List of launchpads retrieved successfully.