Editions Launchpad

Create a new editions launchpad

Creates a new editions launchpad with the specified details.

POSThttps://api.ordinalsbot.com/marketplace/editions/create

Body

application/json

editionInscriptionId*string

The ID of the edition inscription.

Example: "38165c2a5a2b573196d079acbccccc3723534da4271f4be49f78e9d7ef4d5dd6i486"

makerPaymentAddress*string

The Bitcoin payment address of the maker.

Example: "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3"

numberOfEditions*integer

The number of editions to create.

Example: 3

slug*string

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

Response

200400

Editions launchpad created successfully

Body

application/json

idstring

The ID of the created launchpad.

Example: "26c82416-e450-4661-b192-ada4f700bc83"

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordinalsbot.com/marketplace/editions/create', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "editionInscriptionId": "38165c2a5a2b573196d079acbccccc3723534da4271f4be49f78e9d7ef4d5dd6i486",
      "makerPaymentAddress": "bc1pgnwmg7wplc09cm9fctgmgalu7l4synjh7khwzre9qlcvg5xy0k5qz9mwe3",
      "numberOfEditions": 3,
      "slug": "satoshibles-the-ordinals"
    }),
});
const data = await response.json();

Response

200400

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

Create a new order for editions minting

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

POSThttps://api.ordinalsbot.com/marketplace/editions/mint

Body

application/json

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

Response

200400

Order created successfully

Body

application/json

orderIdstring

The ID of the created order.

Example: "26c82416-e450-4661-b192-ada4f700bc83"

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordinalsbot.com/marketplace/editions/mint', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400

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

Get all launchpads

Retrieves a list of all launchpads with optional filtering.

POSThttps://api.ordinalsbot.com/marketplace/launchpads

Header parameters

Body

application/json

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"

idcreated_at

Response

200

List of launchpads retrieved successfully.

Body

application/json

dataarray of object

countinteger

Total number of results.

Request

JavaScriptCurlPython

const response = await fetch('https://api.ordinalsbot.com/marketplace/launchpads', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

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