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
    • 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 API
    • OPI API
  • 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
  1. Token Pay
  2. API Docs
  3. API reference

Create burn inscription psbt

PreviousValidate burn rune txNextUtils

Create a burn inscription PSBT

post

Handles the creation of a burn inscription PSBT.

Body
inscriptionIdstringOptional

The inscription id that needs to be burned.

Example: bcea50b5c826ebb48215d56325b46cd35511a4c6e166d48f8db750dbf8188727i63
utxostringOptional

The utxo that includes the inscription to be burned.

Example: 8bfcb8240f34bdc57627ac0727fe37bb7746a104f169aad422a0ec7ad2e67cc4:0
paymentAddressstringOptional

The payment address.

Example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
paymentPublicKeystringOptional

The payment public key.

Example: 02b463a1e6b8e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1
ordinalAddressstringOptional

The ordinal address.

Example: bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080
ordinalPublicKeystringOptional

The ordinal public key.

Example: 03b463a1e6b8e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1
feeRatenumberOptional

The fee rate for the transaction in sats/vbyte.

Example: 2
metadatastringOptional

The metadata to be included in the burn metadata field of the inscription.

Example: Max 80 bytes
Responses
200
Successfully created the burn inscription PSBT.
application/json
400
Bad request. Invalid input parameters.
application/json
500
Internal server error.
application/json
post
POST /tokenpay/create-burn-inscription-psbt HTTP/1.1
Host: api.ordinalsbot.com
Content-Type: application/json
Accept: */*
Content-Length: 481

{
  "inscriptionId": "bcea50b5c826ebb48215d56325b46cd35511a4c6e166d48f8db750dbf8188727i63",
  "utxo": "8bfcb8240f34bdc57627ac0727fe37bb7746a104f169aad422a0ec7ad2e67cc4:0",
  "paymentAddress": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "paymentPublicKey": "02b463a1e6b8e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1",
  "ordinalAddress": "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080",
  "ordinalPublicKey": "03b463a1e6b8e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1e1a1",
  "feeRate": 2,
  "metadata": "Max 80 bytes"
}
{
  "psbtBase64": "cHNidP8BAFICAAAA...",
  "runeInputs": {
    "indices": [
      0
    ],
    "address": "tb1pzq63cpltakkeegqaqje9zc9k5v92ud540tuwvymef4rul00y5mzqg5mvdc"
  },
  "paymentInputs": {
    "indices": [
      1
    ],
    "address": "2N4v1yyB5arLfQ3wHgAroRYmb49LVedkkYg"
  },
  "psbtHex": "70736274ff0100af02..."
}