LogoLogo
Back to AppHelp Center
  • Getting Started
    • Welcome
  • OrdinalsBot API
    • Overview
    • Libraries
    • Template-App
    • Signet
    • Testnet
    • Fractal
    • Getting Prices
      • Getting Prices (Legacy)
    • Create a Direct Inscription Order
    • Create a Managed Inscription Order
    • Get Order Status
    • Create a Collection
    • Create a Collection Order
    • Create Text Inscription Order
    • Search Inscriptions
    • Check Rare Sats Inventory
    • Referral Scheme
    • Transaction Accelerator
    • Burning Assets
    • Webhooks
    • Order States
    • Order Types
  • Runes
    • Etch
    • Mint
    • Direct Mint
      • 1. Generate Direct Mint PSBT
      • 2. Direct Rune Mint Process PSBT
    • Launchpad
      • Create
      • Mint
      • Get Launchpad
    • Airdrop
  • Token Pay
    • What is TokenPay?
    • API Docs
      • API reference
        • Order
        • Create payment psbt
        • Create burn rune psbt
        • Validate burn rune tx
        • Create burn inscription psbt
        • Utils
          • Checktx
          • Submittx
          • Finalize psbt
        • User
          • Withdrawal
          • Order
            • Rune
          • Account
            • Withdraw
            • Balance
      • Specification
  • Marketplace
    • User Guide: Pre-Inscribed Launchpad API
    • API Docs
    • Editions Launchpad
  • Launchpad API
    • Create Marketplace
    • Create a new Launchpad
    • Retrieve Launch PSBT
    • Confirm Launch
    • Check Allocation
    • Check for Padding Outputs
    • Setup Padding Outputs
    • Create buy offer
    • Confirm buy offer
    • Get Launch Info
  • Sat Scanner API
    • Find Special Ranges
    • Find Special Ranges UTXO
    • Supported Satributes
  • Sat Extractor
    • Extract
  • BRC20 / BRC2.0PROG
    • OPI API
    • Bitcoin Remix
  • SNS API
    • SNS API
  • Mempool API
    • Mempool API
  • TAP PROTOCOL
    • Tap Reader API
  • UTXO
    • Split
  • User Guide
    • Inscribe your first Ordinal
    • Receiving Payments
  • Knowledge Base
    • Ordinals
      • What is an Ordinal?
      • Satoshi Rarity
      • What are BRC-20 Tokens?
      • Image Optimisation
      • Pixel Art
    • Bitcoin
      • Unspent Transaction Output (UTXO)
  • Official Links
    • Twitter
    • Discord
Powered by GitBook
On this page
  • POST Create a new marketplace
  • Create Marketplace
  1. Launchpad API

Create Marketplace

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

Use this endpoint to register a new Marketplace. Having a marketplace registered allows the marketplace to specify marketplace fees and launchpad fees for buying and selling ordinals. Marketplace fees are paid out when an ordinal is sold. Fees are transferred to the address specified in a trustless way as part of the purchase transaction. This endpoint can also be used to specify launchpad configuration to create a launchpad. marketplace fees and launchpad fees are separate

POST Create a new marketplace

Create Marketplace

POST https://api.ordinalsbot.com/legacy-marketplace/create-marketplace

API Key is required in the header:

headers: { 'x-api-key': '<YOUR_API_KEY>', ...otherHeaders } Example Request Body: { "name" : "Marketplace Name", "sellerFee" : 500, "buyerFee" : 500, "btcFeePayoutAddress" : "3En...38L", "url" : "https://www.marketplace.com", "launchpadBuyerFee": 100, "launchpadSellerFee": 500, "launchpadBtcFeePayoutAddress": "2Mx...Erx" "description" : "This is a test marketPlace" }

Request Body

Name
Type
Description

sellerFee

Number

Fees to be charged to the seller when listing an ordinal for sale on the marketplace. Fees should be specified in basis points for example 10% would be 1000

buyerFee

Number

Fees that will be charged to the buyer when an ordinal is sold on the marketplace. Fees should be specified in basis points for example 10% would be 1000

btcFeePayoutAddress

String

The address for paying out marketplace fees

name*

String

Name for the marketplace

url

String

URL for the marketplace

description

String

Short description for the marketplace

launchpadBuyerFee

Number

Fees that will be charged to the buyer when buying from launchpad. Fees should be specified in basis points for example 10% would be 1000

launchpadSellerFee

Number

Fees that will be charged to the seller when an inscription is listed on launchpad. Fees should be specified in basis points for example 10% would be 1000

launchpadBtcFeePayoutAddress

String

The address for paying out launchpad fees


{
    "marketPlaceId": "123abce79a817d55d0e7123", // your new marketplace id
    "apiKey": "366e7416-9e95-459f-bee9-fe8abbf4591b" // the api key you provided
}
{
    status: 'error',
    error: 'error reason'
}
PreviousEditions LaunchpadNextCreate a new Launchpad

Last updated 7 months ago