ord_getSat RPC Method - Ordinals & Runes API

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

Parameters

sat

integer

REQUIRED

Loading...

Returns

ids

array

Loading...

more

boolean

Loading...

page

integer

Loading...

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
    "block": 25173,
5
    "charms": [],
6
    "cycle": 0,
7
    "decimal": "25173.1034480298",
8
    "degree": "0°25173′981″1034480298‴",
9
    "epoch": 0,
10
    "inscriptions": [
11
      "a860baeecae8c2d9fb95f09608d3b3e2bbaf207f25a6361e0d07a326906f8be6i0"
12
    ],
13
    "name": "myokjwtpouh",
14
    "number": 125866034480298,
15
    "offset": 1034480298,
16
    "percentile": "5.993620696130986%",
17
    "period": 12,
18
    "rarity": "common",
19
    "satpoint": "a860baeecae8c2d9fb95f09608d3b3e2bbaf207f25a6361e0d07a326906f8be6:0:0",
20
    "timestamp": 1255789391
21
  },
22
  "jsonrpc": "2.0"
23
}

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free