API Docs

Marketplace for inscriptions, runes, brc20 and everything else!

Onboard a new collection

post

Onboard a new NFT collection with detailed metadata and item information.

Body

metaobjectoptional

dataobject[]optional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/collection/onboard' \
  --header 'Content-Type: application/json' \
  --data '{
    "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"
    },
    "data": [
      {
        "id": "8e7ba76e0c06ff5f43f50371bce849ae4e88dd36e1c0629e1a6f4383d1b0e679i0",
        "meta": {
          "attributes": [
            {
              "trait_type": "background",
              "value": "orange"
            }
          ],
          "name": "Satoshibles: The Ordinals #1"
        }
      }
    ]
  }'

200

200

{
  "message": "Collection onboarded successfully"
}

Collection onboarded successfully

Get collection details by slug. Returns up to 1k items!

get

Retrieve metadata and items for a specific NFT collection based on the provided slug. Returns up to 1k items!

Path parameters

slugstringrequired

The slug of the collection to retrieve.

Example: satoshibles-the-ordinals

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ordinalsbot.com/marketplace/collection/{slug}'

200

404

200

{
  "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"
  },
  "data": [
    {
      "id": "8e7ba76e0c06ff5f43f50371bce849ae4e88dd36e1c0629e1a6f4383d1b0e679i0",
      "meta": {
        "attributes": [
          {
            "trait_type": "background",
            "value": "orange"
          }
        ],
        "name": "Satoshibles: The Ordinals #1"
      }
    }
  ]
}

Collection details retrieved successfully

Create a marketplace

post

Creates a new marketplace with configurable fees and payout addresses.

Header parameters

x-api-keystringrequired

API key for authorization.

Example: your-api-key

Body

sellerFeenumber · floatoptional

Seller fee percentage as a non-negative float.

Example: 1.5

buyerFeenumber · floatoptional

Buyer fee percentage as a non-negative float.

Example: 1

btcFeePayoutAddressstringoptional

BTC address where fees will be paid.

Example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

launchpadSellerFeenumber · floatoptional

Seller fee percentage specifically for launchpad as a non-negative float.

Example: 2

launchpadBuyerFeenumber · floatoptional

Buyer fee percentage specifically for launchpad as a non-negative float.

Example: 1.8

launchpadBtcFeePayoutAddressstringoptional

BTC address where launchpad fees will be paid.

Example: 1BoatSLRHtKNngkdXEeobR76b53LETtpyT

marketPlaceMakerFeenumber · floatoptional

Maker fee percentage for marketplace as a non-negative float.

Example: 0.5

marketPlaceTakerFeenumber · floatoptional

Taker fee percentage for marketplace as a non-negative float.

Example: 0.75

marketPlaceFeeBtcAddressstringoptional

BTC address for marketplace fees.

Example: 1Examp1eBTCAddr3ssPlaceTakerFee

launchpadMakerFeenumber · floatoptional

Maker fee percentage for launchpad as a non-negative float.

Example: 0.4

launchpadTakerFeenumber · floatoptional

Taker fee percentage for launchpad as a non-negative float.

Example: 0.6

launchpadFeeBtcAddressstringoptional

BTC address for launchpad fees.

Example: 1LaunchBTCAddr3ssFee

urlstring · urioptional

URL for the marketplace.

Example: https://example.com

descriptionstringoptional

A brief description of the marketplace.

Example: A marketplace for digital assets.

rateLimitLevelinteger · int32optional

Rate limit level as a non-negative integer.

Example: 5

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/marketplaces/create' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "sellerFee": 1.5,
    "buyerFee": 1,
    "btcFeePayoutAddress": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "launchpadSellerFee": 2,
    "launchpadBuyerFee": 1.8,
    "launchpadBtcFeePayoutAddress": "1BoatSLRHtKNngkdXEeobR76b53LETtpyT",
    "marketPlaceMakerFee": 0.5,
    "marketPlaceTakerFee": 0.75,
    "marketPlaceFeeBtcAddress": "1Examp1eBTCAddr3ssPlaceTakerFee",
    "launchpadMakerFee": 0.4,
    "launchpadTakerFee": 0.6,
    "launchpadFeeBtcAddress": "1LaunchBTCAddr3ssFee",
    "url": "https://example.com",
    "description": "A marketplace for digital assets.",
    "rateLimitLevel": 5
  }'

201

400

201

{
  "message": "Marketplace created successfully"
}

Marketplace created successfully

Retrieve marketplace details

get

Retrieves information about the marketplace. Requires an API key for access.

Header parameters

x-api-keystringrequired

API key required for accessing marketplace details.

Example: your-api-key

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ordinalsbot.com/marketplace/marketplaces' \
  --header 'x-api-key: text'

200

401

200

{
  "id": "3b32e70e-6802-42e7-a7d3-056ad909ebd7",
  "api_key": "9571e8be-a77e-41c4-afcb-76440fd27a48",
  "name": "Test marketplace 04",
  "marketplace_maker_fee": 499,
  "marketplace_taker_fee": 499,
  "marketplace_fee_btc_address_id": 1,
  "launchpad_maker_fee": 599,
  "launchpad_taker_fee": 599,
  "launchpad_fee_btc_address_id": 1,
  "url": "https://domain.com",
  "description": "abc",
  "rate_limit_level": null
}

Marketplace details retrieved successfully

Get all listings

post

Retrieves a list of listings based on filter, pagination, and sorting options.

Body

filterobjectoptional

pageinteger · min: 1optional

The page number for pagination (optional)

Example: 1

itemsPerPageinteger · min: 1optional

Number of items per page (optional)

Example: 10

sortstring · enumoptional

Sort listings by this field (optional)

Example: price

Options: price, name, date

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/listings' \
  --header 'Content-Type: application/json' \
  --data '{
    "filter": {
      "status": "broadcast"
    },
    "page": 1,
    "itemsPerPage": 10,
    "sort": "price"
  }'

200

401

200

{
  "results": [
    {
      "id": 1,
      "utxo_id": 1,
      "price": 1,
      "psbt": "text",
      "side": "text",
      "maker_payment_address_id": 1,
      "maker_ordinal_address_id": 1,
      "merged_psbt": "text",
      "status": "text",
      "maker_output_value": 1,
      "index_in_maker_psbt": 1,
      "marketplace_id": "text",
      "marketplace_maker_fee": 1,
      "marketplace_taker_fee": 1,
      "platform_maker_fee": 1,
      "platform_taker_fee": 1,
      "platform_fee_btc_address_id": 1,
      "marketplace_fee_btc_address_id": 1,
      "timestamp": "2025-03-31T00:28:27.473Z",
      "maker_payment": {
        "id": 1,
        "address": "text",
        "public_key": "text"
      },
      "utxos": {
        "utxo": "text",
        "utxo_contents": [
          {
            "inscriptions": {
              "inscription_id": "text"
            }
          }
        ]
      }
    }
  ],
  "count": 1,
  "currentPage": 1,
  "totalPages": 1,
  "totalItems": 1
}

Successfully retrieved the listings.

Create listings for sale

post

List one or more items for sale on the marketplace. The endpoint returns a Partially Signed Bitcoin Transaction (PSBT) for the owner to sign. The buyer must supply a UTXO covering the listing price and any applicable fees. The seller's signature is required only during listing creation, while only the buyer's signature is needed to complete the purchase.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

makerPaymentAddressstringoptional

Bitcoin address for receiving payments.

Example: 2NA......V75C

makerPaymentPublicKeystringoptional

Public key associated with the payment address.

Example: 029......cf37

makerOrdinalAddressstringoptional

Ordinal address for the maker.

Example: e58......88a26

makerOrdinalPublicKeystringoptional

Public key associated with the Ordinal.

Example: 594......702e

utxosobject[]optional

List of unspent transaction outputs (UTXOs) and prices for each listing.

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/listings/create' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "makerPaymentAddress": "2NA......V75C",
    "makerPaymentPublicKey": "029......cf37",
    "makerOrdinalAddress": "e58......88a26",
    "makerOrdinalPublicKey": "594......702e",
    "utxos": [
      {
        "utxo": "ead......63d8:1",
        "price": "1520"
      }
    ]
  }'

200

400

401

200

{
  "psbt": "cHni.....AAAAA=",
  "listingIds": [
    1,
    2,
    3
  ]
}

Listings created successfully with a PSBT for the owner to sign.

Confirm listings with signed PSBT

put

Confirms a listing by saving the signed Partially Signed Bitcoin Transaction (PSBT) in the listing database. This is the final step in the listing creation process after signing the PSBT returned by the listings/create endpoint.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

listingIdsinteger[]optional

Array of listing IDs to confirm.

Example: [1,2,3]

signedPSBTstringoptional

Signed Partially Signed Bitcoin Transaction.

Example: cHNi.....ZUEAAA==

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.ordinalsbot.com/marketplace/listings/confirm' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "listingIds": [
      1,
      2,
      3
    ],
    "signedPSBT": "cHNi.....ZUEAAA=="
  }'

200

401

200

{
  "message": "Signed PSBT is updated successfully"
}

Confirmation successful, PSBT is updated.

Update listing price

post

Updates the price of a listing on the marketplace. Returns a Partially Signed Bitcoin Transaction (PSBT) for the owner to sign.

Path parameters

idintegerrequired

The unique identifier of the listing to update.

Example: 1

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

priceintegeroptional

New price for the listing in Satoshis.

Example: 15

signedPSBTstringoptional

Signed Partially Signed Bitcoin Transaction.

Example: cHNi.....ZUEAAA==

makerPaymentAddressstringoptional

Bitcoin address for receiving payments.

Example: 2NA......V75C

makerPaymentPublicKeystringoptional

Public key associated with the payment address.

Example: 029......cf37

makerOrdinalPublicKeystringoptional

Public key associated with the Ordinal.

Example: 594......702e

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/listings/{id}/relist' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "price": 15,
    "signedPSBT": "cHNi.....ZUEAAA==",
    "makerPaymentAddress": "2NA......V75C",
    "makerPaymentPublicKey": "029......cf37",
    "makerOrdinalPublicKey": "594......702e"
  }'

200

400

401

200

{
  "psbt": "cHni.....AAAAA=",
  "listingId": 1
}

Listing updated successfully, with a PSBT for the owner to sign.

Delete a listing from the marketplace

delete

Removes a listing from the marketplace and returns a Partially Signed Bitcoin Transaction (PSBT) that must be signed by the owner.

Path parameters

idintegerrequired

The unique identifier of the listing to delete.

Example: 1

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

makerPaymentAddressstringoptional

Bitcoin address for receiving payments.

Example: 2NA......V75C

makerPaymentPublicKeystringoptional

Public key associated with the payment address.

Example: 029......cf37

feeRateintegeroptional

Fee rate in Satoshis per byte (optional).

Example: 3

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.ordinalsbot.com/marketplace/listings/{id}' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "makerPaymentAddress": "2NA......V75C",
    "makerPaymentPublicKey": "029......cf37",
    "feeRate": 3
  }'

200

500

200

{
  "psbtBase64": "cHni.....AAAAA=",
  "makerOrdinalInputIndices": [
    0
  ],
  "makerPaymentInputIndices": [
    1,
    2
  ]
}

Listing deleted successfully with a PSBT for the owner to sign.

Confirm the deletion of a listing

put

Finalize the deletion of a listing by saving the signed Partially Signed Bitcoin Transaction (PSBT) and removing the listing from the database. This is the final step in the deletion process after signing the PSBT returned by the marketplace/listings/{id} endpoint.

Path parameters

idintegerrequired

The unique identifier of the listing to confirm deletion.

Example: 1

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

makerPaymentAddressstringoptional

Bitcoin address for receiving payments.

Example: 2NA......V75C

signedPSBTstringoptional

Signed Partially Signed Bitcoin Transaction.

Example: cHNi.....ZUEAAA==

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.ordinalsbot.com/marketplace/listings/{id}/confirm-delist' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "makerPaymentAddress": "2NA......V75C",
    "signedPSBT": "cHNi.....ZUEAAA=="
  }'

200

500

200

{
  "txId": "aa1c27........2767",
  "message": "Record successfully delisted"
}

Listing delisted successfully.

Create a buy offer for a listing

post

Creates a transaction to purchase a listing on the marketplace. Returns a base64-encoded Partially Signed Bitcoin Transaction (PSBT) and input indices that the buyer must sign to complete the purchase.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

idsarrayoptional

Unique identifiers of the listing to purchase.

Example: [1,2]

takerPaymentAddressstringoptional

Bitcoin address for the buyer's payment.

Example: 2N6......nbKL

takerPaymentPublicKeystringoptional

Public key associated with the buyer's payment address.

Example: 033......5c05

takerOrdinalAddressstringoptional

Ordinal address for the buyer.

Example: e58......88a26

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/listings/offers' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      1,
      2
    ],
    "takerPaymentAddress": "2N6......nbKL",
    "takerPaymentPublicKey": "033......5c05",
    "takerOrdinalAddress": "e58......88a26"
  }'

200

400

401

200

{
  "psbt": "cHni.....AAAAA=",
  "inputIndices": [
    0,
    1,
    3,
    4
  ]
}

Buy offer created successfully, with a PSBT for the buyer to sign.

Broadcast transaction and update listing status

post

Broadcasts the transaction to the network and updates the listing status.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

idsinteger[]optional

Array of listing IDs to broadcast.

Example: [1,2]

psbtstringoptional

Base64-encoded Partially Signed Bitcoin Transaction (PSBT) to broadcast.

Example: cHNi.....ZUEAAA

takerPaymentAddressstringoptional

Bitcoin address for the buyer's payment.

Example: 2N6......nbKL

takerOrdinalAddressstringoptional

Ordinal address for the buyer.

Example: e58......88a26

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/listings/broadcast' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      1,
      2
    ],
    "psbt": "cHNi.....ZUEAAA",
    "takerPaymentAddress": "2N6......nbKL",
    "takerOrdinalAddress": "e58......88a26"
  }'

200

500

200

{
  "txId": "aa1c27........2767"
}

Transaction broadcast successfully, with updated listing status.

Transfer one or more ordinals

post

Transfers one or more ordinals, generating a Partially Signed Bitcoin Transaction (PSBT) that must be signed by the owner.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

transferobject[]optional

List of ordinal transfers with receiver addresses.

makerPaymentAddressstringoptional

Bitcoin address for the maker's payment.

Example: 2N6.....nbKL

makerPaymentPublicKeystringoptional

Public key associated with the maker's payment address.

Example: 033.....5c05

makerOrdinalPublicKeystringoptional

Public key associated with the maker's ordinal.

Example: e58.....88a26

feeRateintegeroptional

Fee rate in Satoshis per byte.

Example: 28

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/inscriptions/transfer' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "transfer": [
      {
        "ordinalId": "8c5.....2ci0",
        "receiverOrdinalAddress": "tb1.....3yk3"
      }
    ],
    "makerPaymentAddress": "2N6.....nbKL",
    "makerPaymentPublicKey": "033.....5c05",
    "makerOrdinalPublicKey": "e58.....88a26",
    "feeRate": 28
  }'

200

500

200

{
  "psbtBase64": "cHni.....AAAAA=",
  "makerOrdinalInputIndices": [
    0
  ],
  "makerPaymentInputIndices": [
    1,
    2
  ]
}

Ordinal transfer transaction created successfully, with a PSBT for the owner to sign.

Check for padding outputs

put

Checks if padding outputs exist for a given Bitcoin address.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

addressstringoptional

Bitcoin address to check for padding outputs.

Example: 2N6......bKL

numberOfOutputsintegeroptional

Optional number of outputs to create.

Example: 3

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.ordinalsbot.com/marketplace/inscriptions/confirm-padding' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "2N6......bKL",
    "numberOfOutputs": 3
  }'

200

500

200

{
  "paddingOutputsExist": true,
  "requiredDummyOutputs": 3,
  "additionalOutputsNeeded": 0
}

Check completed successfully, indicating if padding outputs are present.

Select padding outputs

post

Selects padding outputs associated with a given Bitcoin address.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

addressstringoptional

Bitcoin address to select padding outputs.

Example: 2N6......bKL

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/inscriptions/select-padding' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "2N6......bKL"
  }'

200

500

200

[
  {
    "txid": "f50......1b38b",
    "vout": 0,
    "status": {
      "confirmed": true,
      "block_height": 3124442,
      "block_hash": "000.....589ae",
      "block_time": 1728662165
    },
    "value": 600
  }
]

List of selected padding outputs.

Setup padding outputs

post

Sets up padding outputs for a given Bitcoin address.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

addressstringoptional

Bitcoin address to set up padding outputs.

Example: 2N6......bKL

publicKeystringoptional

Public key associated with the Bitcoin address.

Example: 033......05c05

feeRateintegeroptional

Fee rate in Satoshis per byte.

Example: 28

numberOfOutputsintegeroptional

Optional number of outputs to create.

Example: 3

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/inscriptions/setup-padding' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "2N6......bKL",
    "publicKey": "033......05c05",
    "feeRate": 28,
    "numberOfOutputs": 3
  }'

200

500

200

{
  "psbt": "cHNid......AAAAAAA=",
  "inputIndices": [
    0,
    1
  ]
}

Padding outputs setup successfully, returning a PSBT and input indices.

Create a new launchpad

post

Creates a new launchpad with specified phases and configuration.

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

slugstringrequired

The slug of the launchpad.

Example: satoshibles-the-ordinals

makerPaymentAddressstringrequired

Bitcoin address for receiving payments

Example: 2N6ZePLQrKtix9bJBfznsykxKX1XtirnbKL

makerPaymentPublicKeystringrequired

Public key associated with the payment address

Example: 033528dc4c9fd062e63d2a8d5f8b2e3c3b8312ae7c1d3c4a41a9dc4eefa4205c05

makerOrdinalAddressstringrequired

Maker ordinal address

Example: bc1q...

makerOrdinalPublicKeystringrequired

Public key associated with the ordinals

Example: e581edf3a948470930171a3e676490a8f7953a3698044c14b4d75ffeabc88a26

dataobject[]optional

metaobjectoptional

phasesobject[]required

Array of launch phases

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/create' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "slug": "satoshibles-the-ordinals",
    "makerPaymentAddress": "2N6ZePLQrKtix9bJBfznsykxKX1XtirnbKL",
    "makerPaymentPublicKey": "033528dc4c9fd062e63d2a8d5f8b2e3c3b8312ae7c1d3c4a41a9dc4eefa4205c05",
    "makerOrdinalAddress": "bc1q...",
    "makerOrdinalPublicKey": "e581edf3a948470930171a3e676490a8f7953a3698044c14b4d75ffeabc88a26",
    "data": [
      {
        "id": "8e7ba76e0c06ff5f43f50371bce849ae4e88dd36e1c0629e1a6f4383d1b0e679i0",
        "meta": {
          "attributes": [
            {
              "trait_type": "background",
              "value": "orange"
            }
          ],
          "name": "Satoshibles: The Ordinals #1"
        }
      }
    ],
    "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"
    },
    "phases": [
      {
        "name": "Whitelist Sale",
        "startDate": 1712044800,
        "endDate": 1712131200,
        "price": 100000,
        "isPublic": false,
        "allowList": [
          {
            "address": "bc1q...",
            "allocation": 5
          }
        ]
      }
    ]
  }'

200

400

200

{
  "launchpadId": 1,
  "status": "pending"
}

Launchpad created successfully

Get PSBT status for a launchpad

get

Retrieves the current PSBT status and data for a specific launchpad.

Path parameters

idintegerrequired

The unique identifier of the launchpad phase psbt.

Header parameters

x-api-keystringrequired

API key required for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/psbt/{id}' \
  --header 'x-api-key: text'

200

404

200

{
  "id": 1,
  "phase_id": 1,
  "batch_number": 1,
  "status": "unsigned",
  "inscription_count": 2,
  "psbt": "cHNi.....ZUEAAA=="
}

PSBT status retrieved successfully.

Confirm and sign PSBT for a launchpad

put

Confirms and updates the signed PSBT for a specific launchpad.

Path parameters

idintegerrequired

The unique identifier of the launchpad phase psbt.

Header parameters

x-api-keystringrequired

API key required for authorization.

Body

signedPSBTstringoptional

Base64-encoded signed PSBT.

Example: cHNi.....ZUEAAA==

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/psbt/{id}/confirm' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "signedPSBT": "cHNi.....ZUEAAA=="
  }'

200

200

{
  "message": "Signed PSBT is updated successfully"
}

PSBT signed successfully.

Create a buy offer for a launchpad inscription

post

Creates a new buy offer for an inscription in an active launchpad phase.

Header parameters

x-api-keystringrequired

API key required for authorization.

Body

idintegeroptional

Launchpad ID.

Example: 1

takerPaymentAddressstringoptional

Bitcoin address for receiving change.

Example: bc1q...

takerPaymentPublicKeystringoptional

Public key for the payment address.

Example: 02ab...

takerOrdinalAddressstringoptional

Bitcoin address for receiving the inscription.

Example: bc1q...

feeRateinteger · min: 1optional

Fee rate in sats/vB.

Example: 5

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/offers' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": 1,
    "takerPaymentAddress": "bc1q...",
    "takerPaymentPublicKey": "02ab...",
    "takerOrdinalAddress": "bc1q...",
    "feeRate": 5
  }'

200

200

{
  "id": 1,
  "phaseId": 1,
  "batchId": 1,
  "psbt": "text",
  "inputIndices": [
    1
  ]
}

Offer created successfully.

Submit a signed buy offer to complete the purchase

put

Completes the purchase of a launchpad listing by submitting a signed Partially Signed Bitcoin Transaction (PSBT) to the marketplace.

Path parameters

idintegerrequired

The unique identifier of the buy offer to submit.

Example: 1

Header parameters

x-api-keystringrequired

API key required for authorization.

Example: your-api-key

Body

signedPSBTstringoptional

Base64-encoded signed Partially Signed Bitcoin Transaction (PSBT) for the purchase.

Example: cHNi.....ZUEAAA==

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/offers/{id}/submit' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "signedPSBT": "cHNi.....ZUEAAA=="
  }'

200

500

200

{
  "txId": "aa1c27........2767"
}

Purchase completed successfully.

Get allocation for a specific address

get

Retrieves the allocation details for a given address in a launchpad phase.

Path parameters

idintegerrequired

Launchpad ID.

takerOrdinalAddressstringrequired

Bitcoin address to check allocation for.

Header parameters

x-api-keystringrequired

API key required for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/{id}/allocation/{takerOrdinalAddress}' \
  --header 'x-api-key: text'

200

200

{
  "status": "success",
  "message": "Phases fetched successfully",
  "phases": [
    {
      "id": 2,
      "is_public": 0,
      "total_allocation": 5,
      "remaining_allocation": 5
    }
  ],
  "has_public_phases": true
}

Allocation details retrieved successfully.

Get launchpad details

get

Retrieves detailed information about a specific launchpad.

Path parameters

idintegerrequired

Launchpad ID.

Header parameters

x-api-keystringrequired

API key required for authorization.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.ordinalsbot.com/marketplace/launchpads/{id}' \
  --header 'x-api-key: text'

200

200

{
  "id": 1,
  "maker_payment_address_id": 1,
  "marketplace_id": "text",
  "status": "text",
  "failed_reason": "text",
  "total_inscriptions": 1,
  "remaining_inscriptions": 1,
  "meta_data": "text",
  "phases": [
    {
      "id": 1,
      "launchpad_id": 1,
      "name": "text",
      "phase_number": 1,
      "start_date": 1729621800,
      "end_date": 1729621810,
      "status": "text",
      "is_public": true,
      "price": 1,
      "psbts": [
        {
          "id": 1,
          "status": "text",
          "phase_id": 1,
          "batch_number": 1,
          "inscription_count": 1
        }
      ]
    }
  ]
}

Launchpad details retrieved successfully.

Get all launchpads

post

Retrieves a list of all launchpads with optional filtering.

Header parameters

x-api-keystringrequired

API key required for authorization.

Body

filterobjectoptional

pageinteger · min: 1optional

The page number for pagination (optional)

Example: 1

itemsPerPageinteger · min: 1optional

Number of items per page (optional)

Example: 10

sortstring · enumoptional

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.