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
  1. OrdinalsBot API

Check Rare Sats Inventory

Use this endpoint to check any rare, special, vintage sats available to be used in individual or collection inscriptions.

Check Rare Sats Inventory

GET https://api.ordinalsbot.com/inventory

Check for available special sats that are available to be inscribed on. This endpoint will return their available count, price and max file size that can be handled.

Each property can be used as input when creating inscription orders, for instance: rareSats: block9

{
  "black": {
    "amount": 42609880,
    "baseFee": 40000,
    "commonCount": 135,
    "count": 152,
    "maxSize": 5000000,
    "minSize": 546
  },
  "block286": {
    "amount": 24424386,
    "baseFee": 1000,
    "commonCount": 110,
    "count": 58,
    "maxSize": 5000000,
    "minSize": 1003
  },
  "block78": {
    "amount": 50639419,
    "baseFee": 5000,
    "commonCount": 116,
    "count": 61,
    "maxSize": 5000000,
    "minSize": 865
  },
  "block9": {
    "amount": 44980304,
    "baseFee": 10000,
    "commonCount": 156,
    "count": 49,
    "maxSize": 5000000,
    "minSize": 1003
  },
  "block9450x": {
    "amount": 107593233,
    "baseFee": 10000,
    "commonCount": 136,
    "count": 76,
    "maxSize": 5000000,
    "minSize": 1001
  },
  "block999": {
    "amount": 61977315,
    "baseFee": 10000,
    "commonCount": 169,
    "count": 52,
    "maxSize": 5000000,
    "minSize": 400
  },
  "hitman": {
    "amount": 60275513,
    "baseFee": 5000,
    "commonCount": 199,
    "count": 138,
    "maxSize": 5000000,
    "minSize": 586
  },
  "jpeg": {
    "amount": 34628652,
    "baseFee": 5000,
    "commonCount": 98,
    "count": 94,
    "maxSize": 5000000,
    "minSize": 543
  },
  "legacy": {
    "amount": 10500000,
    "baseFee": 5000,
    "commonCount": 44,
    "count": 0,
    "maxSize": 5000000,
    "minSize": 100000
  },
  "nakamoto": {
    "amount": 61662759,
    "baseFee": 5000,
    "commonCount": 185,
    "count": 524,
    "maxSize": 5000000,
    "minSize": 553
  },
  "pizza": {
    "amount": 107901654,
    "baseFee": 2500,
    "commonCount": 379,
    "count": 156,
    "maxSize": 5000000,
    "minSize": 839
  },
  "silkroad": {
    "amount": 11011389,
    "baseFee": 5000,
    "commonCount": 48,
    "count": 10,
    "maxSize": 5000000,
    "minSize": 1000
  },
  "uncommon": {
    "amount": 75441924,
    "baseFee": 80000,
    "commonCount": 98,
    "count": 2,
    "maxSize": 5000000,
    "minSize": 546
  },
  "vintage": {
    "amount": 75494656,
    "baseFee": 9000,
    "commonCount": 136,
    "count": 65,
    "maxSize": 5000000,
    "minSize": 878
  }
}
{
    status: 'error', 
    error: 'error reason'
}
{
    status: 'error',
    reason: 'server error'
}
PreviousSearch InscriptionsNextReferral Scheme

Last updated 3 months ago