Please note that this REST method requires the Ordinals & Runes API enabled on your Quicknode endpoint.

Path Parameters

sat

integer

REQUIRED

The satoshi number to look up.

Returns

address

string

The Bitcoin address currently holding the satoshi

block

integer

The block height where the satoshi was mined

charms

array

Array of charms associated with the satoshi

cycle

integer

The cycle number of the satoshi

decimal

string

Decimal notation of the satoshi (block.offset)

degree

string

Degree notation of the satoshi

epoch

integer

The epoch of the satoshi

inscriptions

array

Array of inscription IDs on this satoshi

name

string

The alphabetic name of the satoshi

number

integer

The satoshi number

offset

integer

Offset within the block

percentile

string

The satoshi's position as a percentile of total supply

period

integer

The difficulty adjustment period

rarity

string

The rarity of the satoshi (common, uncommon, rare, epic, legendary, mythic)

satpoint

string

The current satpoint location

timestamp

integer

Unix timestamp of when the satoshi was mined

Request

1
curl -X GET "https://docs-demo.btc.quiknode.pro/sat/1965919619127" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.btc.quiknode.pro/sat/1965919619127" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/sat/1965919619127', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/sat/1965919619127', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/sat/1965919619127"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/sat/1965919619127"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.btc.quiknode.pro/sat/1965919619127")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.btc.quiknode.pro/sat/1965919619127")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

Response

1
{
2
  "address": null,
3
  "block": 393,
4
  "charms": [],
5
  "cycle": 0,
6
  "decimal": "393.919619127",
7
  "degree": "0°393′393″919619127‴",
8
  "epoch": 0,
9
  "inscriptions": [],
10
  "name": "nvjsolnmkkg",
11
  "number": 1965919619127,
12
  "offset": 919619127,
13
  "percentile": "0.09361522006140535%",
14
  "period": 0,
15
  "rarity": "common",
16
  "satpoint": null,
17
  "timestamp": 1231897603
18
}

1
{
2
  "address": null,
3
  "block": 393,
4
  "charms": [],
5
  "cycle": 0,
6
  "decimal": "393.919619127",
7
  "degree": "0°393′393″919619127‴",
8
  "epoch": 0,
9
  "inscriptions": [],
10
  "name": "nvjsolnmkkg",
11
  "number": 1965919619127,
12
  "offset": 919619127,
13
  "percentile": "0.09361522006140535%",
14
  "period": 0,
15
  "rarity": "common",
16
  "satpoint": null,
17
  "timestamp": 1231897603
18
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free