Get satoshi ordinal

Retrieves ordinal information for a single satoshi.

GET
/ordinals/v1/sats/{ordinal}

Path Parameters

ordinalOrdinal Number

Ordinal number that uniquely identifies a satoshi

Rangevalue < 2099999997690000

Response Body

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

coinbase_heightinteger
cycleinteger
decimalstring
degreestring
inscription_id?string
epochnumber
namestring
offsetnumber
percentilestring
periodinteger
raritystring & string & string & string & string & string

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring
Value in"Invalid satoshi ordinal number"
curl -X GET "https://api.hiro.so//ordinals/v1/sats/257418248345364"
fetch("https://api.hiro.so//ordinals/v1/sats/257418248345364")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//ordinals/v1/sats/257418248345364"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//ordinals/v1/sats/257418248345364"

response = requests.request("GET", url)

print(response.text)
{
  "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"
}
{
  "error": "Invalid satoshi ordinal number"
}