Create buy offer

An API Key is required to interact with Launchpad APIs. Please contact us to get an API Key and get started.

This endpoint creates transaction to purchase an inscription from an active phase of a launchpad. Platform Cost: A platform fee is applied only when an ordinal is sold. It is not charged for listing an ordinal. The current fee is 1% of sale amount charged to the seller. A marketplace can also configure marketplace fee and/or launchpad fee for each sale, these are 0% by default.

Upon usage, it generates a Partially Signed Bitcoin Transaction (PSBT) encoded in base64. This PSBT must be signed by the payment wallet. The PSBT will only be created and returned for an active launchpad and only if the ordinal address of the buyer has an available allocation to buy in the currently active phase.

POST /launchpad/create-launch

POST https://api.ordinalsbot.com/launchpad/create-launch-offer

API Key is required in the header:

headers: { 'x-api-key': '<YOUR_API_KEY>', ...otherHeaders }

Example Request Body:

{
  "launchpadId": "65a123b789cdef0123456789",
  "buyerOrdinalAddress": "bc1p84ec5hn4asw90slszeje3yrnmzgapj0s9ern85zgh4kc9frqcl3q422dc2",
  "buyerPaymentAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "buyerPaymentPublicKey": "03a34b99f22c790c4e36b2b3c2c35a36db06226e41c692fc82b8b56ac1c540c5bd",
  "launchpadPhaseId": "65a123b789cdef0123456790"
}

Request Body

Name	Type	Description
launchpadId	String	Launchpad id
launchpadPhaseId	String	The phaseid of the active phase from which the buyer is buying an inscription
buyerOrdinalAddress	String	The ordinal address of the buyer, this address should also be in the allowlist of the active phase
buyerPaymentAddress	String	The payment wallet address of the buyer
buyerPaymentPublicKey	String	The Payment public key of the buyer payment wallet address

200: OK

// Returns phase and launch info along with a unsigned PSBT

 {
  "phase": {
    "_id": "65a123b789cdef0123456790",
    "isPublic": false,
    "price": 6000,
    "startDate": "1234123432",
    "endDate": "1234923432"
  },
  "ordinalId": "8f46149faff54a7efe0c5c73a633077a8009b374ebcf6d80609807eab8d73218i0",
  "launchpadPhase": "65a123b789cdef0123456790",
  "buyerInputIndices": [0, 1],
  "psbt": "cHNidP8BAHECAAAAAfPQ0OTWpSxwRJK...",
  "psbtHex": "70736..."
}

500: Internal Server Error

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