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

Parameters

sat

integer

REQUIRED

The SAT number for which you want to retrieve the SAT value

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 --location 'https://docs-demo.btc.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "method": "ord_getSat",
5
    "params": [
6
        125866034480298
7
    ],
8
    "id": 1,
9
    "jsonrpc": "2.0"
10
}'

1
curl --location 'https://docs-demo.btc.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "method": "ord_getSat",
5
    "params": [
6
        125866034480298
7
    ],
8
    "id": 1,
9
    "jsonrpc": "2.0"
10
}'

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
const raw = JSON.stringify({
5
  "method": "ord_getSat",
6
  "params": [
7
    125866034480298
8
  ],
9
  "id": 1,
10
  "jsonrpc": "2.0"
11
});
12

13
const requestOptions = {
14
  method: "POST",
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: "follow"
18
};
19

20
fetch("https://docs-demo.btc.quiknode.pro/", requestOptions)
21
  .then((response) => response.text())
22
  .then((result) => console.log(result))
23
  .catch((error) => console.error(error));

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
const raw = JSON.stringify({
5
  "method": "ord_getSat",
6
  "params": [
7
    125866034480298
8
  ],
9
  "id": 1,
10
  "jsonrpc": "2.0"
11
});
12

13
const requestOptions = {
14
  method: "POST",
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: "follow"
18
};
19

20
fetch("https://docs-demo.btc.quiknode.pro/", requestOptions)
21
  .then((response) => response.text())
22
  .then((result) => console.log(result))
23
  .catch((error) => console.error(error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "ord_getSat",
8
  "params": [
9
    125866034480298
10
  ],
11
  "id": 1,
12
  "jsonrpc": "2.0"
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)
21

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "ord_getSat",
8
  "params": [
9
    125866034480298
10
  ],
11
  "id": 1,
12
  "jsonrpc": "2.0"
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)
21

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

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

7
http = Net::HTTP.new(url.host, url.port);
8
request = Net::HTTP::Post.new(url)
9
request["Content-Type"] = "application/json"
10
request.body = JSON.dump({
11
  "method": "ord_getSat",
12
  "params": [
13
    125866034480298
14
  ],
15
  "id": 1,
16
  "jsonrpc": "2.0"
17
})
18

19
response = http.request(request)
20
puts response.read_body
21

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

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

7
http = Net::HTTP.new(url.host, url.port);
8
request = Net::HTTP::Post.new(url)
9
request["Content-Type"] = "application/json"
10
request.body = JSON.dump({
11
  "method": "ord_getSat",
12
  "params": [
13
    125866034480298
14
  ],
15
  "id": 1,
16
  "jsonrpc": "2.0"
17
})
18

19
response = http.request(request)
20
puts response.read_body
21

Response

1
{
2
  "id": 1,
3
  "result": {
4
    "address": "bc1pxc8nr2zu8uxy5u4la94vxn2zskdn0yg5fhgx96k94vy0579xttvshku6ug",
5
    "block": 25173,
6
    "charms": [],
7
    "cycle": 0,
8
    "decimal": "25173.1034480298",
9
    "degree": "0°25173′981″1034480298‴",
10
    "epoch": 0,
11
    "inscriptions": [
12
      "a860baeecae8c2d9fb95f09608d3b3e2bbaf207f25a6361e0d07a326906f8be6i0"
13
    ],
14
    "name": "myokjwtpouh",
15
    "number": 125866034480298,
16
    "offset": 1034480298,
17
    "percentile": "5.993620696130986%",
18
    "period": 12,
19
    "rarity": "common",
20
    "satpoint": "a860baeecae8c2d9fb95f09608d3b3e2bbaf207f25a6361e0d07a326906f8be6:0:0",
21
    "timestamp": 1255789391
22
  },
23
  "jsonrpc": "2.0"
24
}

1
{
2
  "id": 1,
3
  "result": {
4
    "address": "bc1pxc8nr2zu8uxy5u4la94vxn2zskdn0yg5fhgx96k94vy0579xttvshku6ug",
5
    "block": 25173,
6
    "charms": [],
7
    "cycle": 0,
8
    "decimal": "25173.1034480298",
9
    "degree": "0°25173′981″1034480298‴",
10
    "epoch": 0,
11
    "inscriptions": [
12
      "a860baeecae8c2d9fb95f09608d3b3e2bbaf207f25a6361e0d07a326906f8be6i0"
13
    ],
14
    "name": "myokjwtpouh",
15
    "number": 125866034480298,
16
    "offset": 1034480298,
17
    "percentile": "5.993620696130986%",
18
    "period": 12,
19
    "rarity": "common",
20
    "satpoint": "a860baeecae8c2d9fb95f09608d3b3e2bbaf207f25a6361e0d07a326906f8be6:0:0",
21
    "timestamp": 1255789391
22
  },
23
  "jsonrpc": "2.0"
24
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free