GET /sat/{sat} - Ordinals REST API

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

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