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

200: OK Normal Response

{
  "2009": {
    "amount": 24417855,
    "baseFee": 50000,
    "count": 33,
    "maxSize": 4812114,
    "minSize": 526
  },
  "2010": {
    "amount": 10215796,
    "baseFee": 30000,
    "count": 130,
    "maxSize": 616822,
    "minSize": 516
  },
  "2011": {
    "amount": 18998180,
    "baseFee": 20000,
    "count": 189,
    "maxSize": 998200,
    "minSize": 385
  },
  "block490": {
    "amount": 0,
    "baseFee": 25000,
    "count": 0,
    "maxSize": 0,
    "minSize": 100000000
  },
  "block78": {
    "amount": 6280406,
    "baseFee": 25000,
    "count": 1,
    "maxSize": 1000000,
    "minSize": 5502
  },
  "block9": {
    "amount": 5010920,
    "baseFee": 25000,
    "count": 14,
    "maxSize": 1000000,
    "minSize": 546
  },
  "block940": {
    "amount": 1402536,
    "baseFee": 25000,
    "count": 1,
    "maxSize": 695417,
    "minSize": 11702
  },
  "btcmachines_glam": {
    "amount": 8261264,
    "baseFee": 178787,
    "count": 3,
    "maxSize": 872758,
    "minSize": 3780
  },
  "pizza": {
    "amount": 5994604,
    "baseFee": 25000,
    "count": 1,
    "maxSize": 1000000,
    "minSize": 49996
  },
  "rare_1": {
    "amount": 125087769,
    "baseFee": 3000000,
    "count": 15,
    "maxSize": 5000000,
    "minSize": 9500
  },
  "updatedAt": 1690389598311
}

200: OK Error Response with Cause

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

500: Internal Server Error Server side error

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