Docs • rebar labs
X / TwitterContact
  • Introduction
  • Mission
  • Rebar Shield
    • Introduction
      • Shield Overview
      • Quick Start Guide
    • Developer Guide
      • Fee Management
      • Mining Considerations
      • Security Best Practices
    • API
      • Authentication
      • API Reference
      • Rate Limits & Quotas
      • Error Codes
      • Change Log
    • FAQ
    • Glossary
    • Troubleshooting
  • Rebar Data
    • Introduction
    • Developer Guide
    • API
      • Runes
        • Etchings
        • Activity
        • Balances
      • Ordinals & BRC20s
        • Inscriptions
        • Satoshis
        • BRC 20
        • Statistics
    • RPC
      • Alkanes
      • Bitcoin
  • Resources
    • Contact
Powered by GitBook
LogoLogo

Legal

  • Terms of Service

Resources

  • Github
  • Media Kit

© 2025 Rebar Labs Inc

On this page
Export as PDF
  1. Rebar Data
  2. API
  3. Ordinals & BRC20s

Satoshis

PreviousInscriptionsNextBRC 20

Endpoints to query Satoshi ordinal and rarity information

Satoshi Ordinal

get

Retrieves ordinal information for a single satoshi

Path parameters
ordinalintegerRequired

Ordinal number that uniquely identifies a satoshi

Example: 257418248345364
Responses
200
Default Response
application/json
400
Default Response
application/json
get
GET /ordinals/v1/sats/{ordinal} HTTP/1.1
Host: api.rebarlabs.io
Accept: */*
{
  "coinbase_height": 752860,
  "cycle": 0,
  "decimal": "752860.20444193",
  "degree": "0°122860′892″20444193‴",
  "inscription_id": "ff4503ab9048d6d0ff4e23def81b614d5270d341ce993992e93902ceb0d4ed79i0",
  "epoch": 3,
  "name": "ahehcbywzae",
  "offset": 20444193,
  "percentile": "91.15654869285287%",
  "period": 373,
  "rarity": "common"
}

Satoshi Inscriptions

get

Retrieves all inscriptions associated with a single satoshi

Path parameters
ordinalintegerRequired

Ordinal number that uniquely identifies a satoshi

Example: 257418248345364
Query parameters
offsetintegerOptional

Result offset

limitinteger · min: 1 · max: 60Optional

Results per page

Responses
200
Default Response
application/json
400
Default Response
application/json
get
GET /ordinals/v1/sats/{ordinal}/inscriptions HTTP/1.1
Host: api.rebarlabs.io
Accept: */*
{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0",
      "number": 248751,
      "address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "genesis_address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "genesis_block_height": 778921,
      "genesis_block_hash": "0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133",
      "genesis_tx_id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218",
      "genesis_fee": "3179",
      "genesis_timestamp": 1,
      "tx_id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218",
      "location": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218:0:0",
      "output": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218:0",
      "value": "546",
      "offset": "0",
      "sat_ordinal": "1232735286933201",
      "sat_rarity": "common",
      "sat_coinbase_height": 430521,
      "mime_type": "text/plain",
      "content_type": "text/plain;charset=utf-8",
      "content_length": 59,
      "timestamp": 1677733170000,
      "curse_type": "p2wsh",
      "recursive": true,
      "recursion_refs": [
        "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0"
      ],
      "parent": null,
      "parent_refs": [
        "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0"
      ],
      "delegate": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0",
      "metadata": null,
      "meta_protocol": "brc20",
      "charms": [
        "coin"
      ]
    }
  ]
}
  • GETSatoshi Ordinal
  • GETSatoshi Inscriptions