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

address

string

Loading...

block

integer

Loading...

charms

array

Loading...

cycle

integer

Loading...

decimal

string

Loading...

degree

string

Loading...

epoch

integer

Loading...

inscriptions

array

Loading...

name

string

Loading...

number

integer

Loading...

offset

integer

Loading...

percentile

string

Loading...

period

integer

Loading...

rarity

string

Loading...

satpoint

string

Loading...

timestamp

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
    "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