# ord (inscriptions/runes)

SANDSHREW hosts a cluster of `ord` instances running in server mode with a consistent scheme to map a JSON-RPC method call to a REST query on the underlying `ord` service.

The scheme to map JSON-RPC to an `ord` server endpoint is consistent throughout the RPC.

For a JSON-RPC payload such as

```
{
  "method": "ord_inscriptions:block",
  "params": [
    "780286"
  ],
  "jsonrpc": "2.0",
  "id": 0
}
```

The component of the JSON-RPC method following the `ord_`namespace prefix is a colon-delimited list of components to the full REST path which is forwarded to the `ord` HTTP server. The list of parameters in the JSON-RPC payload are appended as additional components to construct the complete REST query.

Thus, the JSON-RPC method `ord_inscriptions:block` with parameters set to `["780286"]` maps to `GET /inscriptions/block/780286` on the ord service.

The complete schema for the `ord` server is available on the canonical `ord` repository. The exact line of code where this section begins is linked below:

{% embed url="<https://github.com/ordinals/ord/blob/master/src/subcommand/server.rs#L183>" %}

Responses from the `ord` REST server are forwarded back as a JSON-RPC response object with the exception of `ord_content` which will first base64 encode the data&#x20;

The methods are enumerated in greater detail in the sections below, but they can be ascertained using the aforementioned scheme and the list of REST endpoints supported by ord.

## Inscriptions

### Get Inscriptions

`ord_inscriptions` returns a specified number of inscription IDs, ordered by their `inscription number`.

{% tabs %}
{% tab title="curl" %}

```sh
curl -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_inscriptions",
    "params": [
      "802285"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`insc_num`**: string (optional) - Sets the starting point for the query based on the inscription number, a unique identifier assigned to each individual inscription, serving as a sequential reference point within the Bitcoin blockchain's ordinals space. The `insc_num` parameter represents the starting inscription number from which the query will begin fetching inscriptions. If left blank it returns the latest 100 inscriptions.

</details>

<details>

<summary>Response</summary>

<pre class="language-bash"><code class="lang-bash">{
<strong>  "jsonrpc":"2.0",
</strong><strong>  "id":1,
</strong><strong>  "result": {
</strong><strong>    "ids":[
</strong><strong>      "6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0"
</strong><strong>      ],
</strong><strong>    "more":false,
</strong><strong>    "page_index":802285
</strong><strong>  }
</strong><strong>}
</strong></code></pre>

</details>

### Inscription by Block Hash

`ord_block` retrieves all inscriptions associated with a specified block hash.

{% tabs %}
{% tab title="curl" %}

```sh
curl -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_block",
    "params": [
      "000000000000000000063a92390ee25a1f0b41ccaf4e675227acd864dc2eb3dd"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`block_hash`**: string (required) - The hash of the block for which inscriptions are to be returned.

</details>

<details>

<summary>Response</summary>

<pre><code>{
<strong>  "jsonrpc":"2.0",
</strong>  "id":1,
  "result":{
    "hash":"000000000000000000063a92390ee25a1f0b41ccaf4e675227acd864dc2eb3dd",
    "target":"00000000000000000009ed880000000000000000000000000000000000000000",
    "best_height":844799,
    "height":751374,
    "inscriptions":[]
  }
}
</code></pre>

</details>

### Inscription by Block Height

`ord_inscriptions:block` fetches all inscriptions associated with a block at a specified block height. This endpoint supports pagination.

{% tabs %}
{% tab title="curl" %}

```sh
curl -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_inscriptions:block",
    "params": [
      "780236"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`block_height`**: string (required) - Specifies the height of the block from which inscriptions are to be retrieved.

**`page`**: string (optional) - Determines the page number of results, enabling paged viewing of inscriptions.

</details>

<details>

<summary>Response</summary>

<pre><code>{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "000000000000000000046431775aab38aee784155ab30b2c592ec221617c7a52",
    "target": "0000000000000000000676810000000000000000000000000000000000000000",
    "best_height": 820065,
    "height": 780236,
    "inscriptions": [
      "c8eabc7a52044d5bd597d38566f5952ab3f18c57f6fe4978f1916f4f359e694ai0",
      "7691b42dc310bc71757684b04dd70c848724ee56c9a4655ef6be93af2bcf2003i0",
      "5bd289781c7c8d9ccef7cc77a9c77c2a1002cf2124bebd46fbe1e1eb8b70120di0",
      "779244caab97ff4f480a0545bbddcbac935af4e461d1889c05176ee1ea94251fi0",
      "711663cfb7edf890b18fdf00c188acddd8eb248d92036a7545ff3fb51cd1fe40i0",
      "9fd0e3556f39f70442dde8fef5bafa527529d0d511efd9145b8638d6ffb1554fi0",
      "f58036830ce913a1bd414b430061cfe25d913c8f3db08ccc4223ce6e06fcde60i0"
<strong>    ]
</strong>  }
}    
</code></pre>

</details>

### Inscription by Tx Output

Returns inscription and Sat information from a transaction output

{% tabs %}
{% tab title="curl" %}

```sh
curl -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_output",
    "params": [
      "22a0d4ad3fafb1eb53823b7655103bb7d6d7b61e9ac572e2f493bbdb8a371a09:0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`txid:vout`**: string (required) - Output transaction ID : The number of the transaction output

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "value": 6348,
    "script_pubkey": "OP_PUSHNUM_1 OP_PUSHBYTES_32 6d0247f995a3b2c5fbfa6594d1d23af277c5260d4c827b481c89206948ca332c",
    "address": "bc1pd5py07v45wevt7l6vk2dr5367fmu2fsdfjp8kjqu3ysxjjx2xvkquf5e7m",
    "transaction": "22a0d4ad3fafb1eb53823b7655103bb7d6d7b61e9ac572e2f493bbdb8a371a09",
    "sat_ranges": [
      [
        1596764664144241,
        1596764664150589
      ]
    ],
    "inscriptions": [
      "d1e0e792195d9da7be7ce46ec81fe31f7942e350a5da2baf4a7cffe91adb3fa1i0"
    ],
    "runes": {}
  }
}
```

</details>

### Inscription by ID

Returns inscription information based on an inscription ID.

{% tabs %}
{% tab title="curl" %}

```sh
curl -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_inscription",
    "params": [
      "640e8ee134ecf886a874bbfd555b9e5beaf70cdc93ffe52cc10f009c8ee1cc59i0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`inscription_id`**: string (required) - The inscription ID

</details>

<details>

<summary>Response</summary>

```json
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "address": "bc1p3d8rcefkztkvq9x54dhyh8d70n7wpxtm3z5lrrzacv70v8z39t2qd9396s",
        "children": [],
        "content_length": 190,
        "content_type": "image/png",
        "genesis_fee": 21513,
        "genesis_height": 822000,
        "inscription_id": "640e8ee134ecf886a874bbfd555b9e5beaf70cdc93ffe52cc10f009c8ee1cc59i0",
        "inscription_number": 49497279,
        "next": "eb770e58c1744a1750169f9e399c9889270a8d33141a242a596701c2cdf2b95ai0",
        "output_value": 546,
        "parent": null,
        "previous": "ef26436acccaa198baa5c6fa899ec4b8a4faabf61400e92cc3193dac33e30856i0",
        "rune": null,
        "sat": 621497399984255,
        "satpoint": "640e8ee134ecf886a874bbfd555b9e5beaf70cdc93ffe52cc10f009c8ee1cc59:0:0",
        "timestamp": 1703018855
    }
}
```

</details>

### Inscription by Number

Returns inscription information based on an inscription number.

{% tabs %}
{% tab title="curl" %}

```
curl -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_inscription",
    "params": [
      "802285"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`insc_num`**: string (required) - The inscription number

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "address": "bc1p2zzyghqct8ls7l0ash3xu57fm83djakepgyr8tuzmuaw995dpadsrn68q3",
    "children": [],
    "content_length": 50,
    "content_type": "text/plain;charset=utf-8",
    "genesis_fee": 848,
    "genesis_height": 783768,
    "inscription_id": "4a45b966dca8e28dc5f1c2a84911e7655e5a90e3bd72cff086cd6f9290e43c90i0",
    "inscription_number": 802285,
    "next": "212e180a7d1ef0951dc382a1aaf4233fa455bd32aaab28e65fc31a906b2fa290i0",
    "output_value": 546,
    "parent": null,
    "previous": "17aa0b96285cd2ba36c41d21d27e115e2484404684d21dbc687b88166859868ei0",
    "rune": null,
    "sat": 705392790218085,
    "satpoint": "4a45b966dca8e28dc5f1c2a84911e7655e5a90e3bd72cff086cd6f9290e43c90:0:0",
    "timestamp": 1680528792
  }
}
```

</details>

### Inscription Children

Returns the first 100 child inscription IDs for the specified inscription.

With the `page` parameter, it returns the set of 100 child inscriptions on `page`.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_r:children",
    "params": [
      "60bcf821240064a9c55225c4f01711b0ebbcab39aa3fafeefe4299ab158536fai0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`inscription_id`**: string (required) - The inscription ID

**`page`**: string (optional) - Return inscriptions from this page

</details>

<details>

<summary>Response</summary>

<pre><code>{
<strong>  "jsonrpc":"2.0",
</strong>  "id":1,
  "result":{
    "ids":[
      "7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i0",
      "7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i1",
      ...,
      "7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i99"
    ],
    "more":true,
    "page":0
  }
}
</code></pre>

</details>

### Inscription by Sat

Returns the inscription IDs for a specific Sat number.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_r:sat",
    "params": [
      "1596764664144241"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`sat_number`**: string (required) - Position number of Sat

</details>

<details>

<summary>Response</summary>

```json
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "ids": [
            "d1e0e792195d9da7be7ce46ec81fe31f7942e350a5da2baf4a7cffe91adb3fa1i0"
        ],
        "more": false,
        "page": 0
    }
}
```

</details>

### Inscription by Sat with Index

Returns the inscription ID at `index` from all inscriptions on the Sat.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_r:sat::at",
    "params": [
      "1596764664144241",
      "0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`sat_number`**: string (required) - Position number of sat

**`index`**: string (optional) - The index of the inscription. `index` may be a negative number to index from the back (`0` being the first and `-1` being the most recent).

</details>

<details>

<summary>Response</summary>

```json
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "id": "d1e0e792195d9da7be7ce46ec81fe31f7942e350a5da2baf4a7cffe91adb3fa1i0"
    }
}
```

</details>

## Sats

### Sat by Number

Returns a Sat by its integer position number within the entire bitcoin supply.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_sat",
    "params": [
      "1596764664144241"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`sat_number`**: string (required) - Position number of Sat

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": 1596764664144241,
    "decimal": "437411.914144241",
    "degree": "0°17411′1955″914144241‴",
    "name": "cnqughttwqi",
    "block": 437411,
    "cycle": 0,
    "epoch": 2,
    "period": 216,
    "offset": 914144241,
    "rarity": "common",
    "percentile": "76.03641266193728%",
    "satpoint": "22a0d4ad3fafb1eb53823b7655103bb7d6d7b61e9ac572e2f493bbdb8a371a09:0:0",
    "timestamp": 1478322980,
    "inscriptions": [
      "d1e0e792195d9da7be7ce46ec81fe31f7942e350a5da2baf4a7cffe91adb3fa1i0"
    ]
  }
}
```

</details>

### Sat by Decimal

Returns a Sat by decimal: its block and offset within that block.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_sat",
    "params": [
      "481824.0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`block.offset`**: string (required) - Block and offset of Sat

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": 481824,
    "decimal": "0.481824",
    "degree": "0°0′0″481824‴",
    "name": "nvtdijtvmrx",
    "block": 0,
    "cycle": 0,
    "epoch": 0,
    "period": 0,
    "offset": 481824,
    "rarity": "common",
    "percentile": "0.000000022944000025238412%",
    "satpoint": null,
    "timestamp": 1231006505,
    "inscriptions": []
  }
}
```

</details>

### Sat by Degree

Returns a Sat by degree: its cycle, blocks since the last halving, blocks since the last difficulty adjustment, and offset within their block.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_sat",
    "params": [
      "1°0′0″0‴"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`cycle`**`°`**`blocks_since_halving`**`′`**`blocks_since_adjustment`**`″`**`offset`**`‴`: string (required) - Cycle, blocks since the last halving, blocks since the last difficulty adjustment, and offset within  block

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": 2067187500000000,
    "decimal": "1260000.0",
    "degree": "1°0′0″0‴",
    "name": "fachfvytgb",
    "block": 1260000,
    "cycle": 1,
    "epoch": 6,
    "period": 625,
    "offset": 0,
    "rarity": "legendary",
    "percentile": "98.4375001082813%",
    "satpoint": null,
    "timestamp": 1965864846,
    "inscriptions": []
  }
}
```

</details>

### Sat by Name

Returns a Sat by its base 26 representation using the letters "a" through "z".

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_sat",
    "params": [
      "ahistorical"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`base26_name`**: string (required) - Base 26 representation of Sat

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": 1913358459708310,
    "decimal": "751373.334708310",
    "degree": "0°121373′1421″334708310‴",
    "name": "ahistorical",
    "block": 751373,
    "cycle": 0,
    "epoch": 3,
    "period": 372,
    "offset": 334708310,
    "rarity": "common",
    "percentile": "91.1123077053812%",
    "satpoint": null,
    "timestamp": 1661604907,
    "inscriptions": []
  }
}
```

</details>

### Sat by Percentile

Returns a Sat by its percentile: the percentage of bitcoin's supply that has been or will have been issued when they are mined

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_sat",
    "params": [
      "80%"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`percentile`**: string (required) - Sat percentile

</details>

<details>

<summary>Response</summary>

```
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": 1679999998151999,
    "decimal": "503999.1248151999",
    "degree": "0°83999′2015″1248151999‴",
    "name": "byifavydtly",
    "block": 503999,
    "cycle": 0,
    "epoch": 2,
    "period": 249,
    "offset": 1248151999,
    "rarity": "common",
    "percentile": "80%",
    "satpoint": null,
    "timestamp": 1515827472,
    "inscriptions": []
  }
}
```

</details>

## Ordinals

### Ord Content

Returns the Base-64 content of an ordinals inscription.

{% tabs %}
{% tab title="curl" %}

```json
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_content",
    "params": [
      "640e8ee134ecf886a874bbfd555b9e5beaf70cdc93ffe52cc10f009c8ee1cc59i0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`insc_num`**: string (required) - The inscription number

</details>

<details>

<summary>Response</summary>

{% code overflow="wrap" %}

```json
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "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"
}
```

{% endcode %}

</details>

### Ord Preview

Returns HTML for displaying ordinal content.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_preview",
    "params": [
      "640e8ee134ecf886a874bbfd555b9e5beaf70cdc93ffe52cc10f009c8ee1cc59i0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`inscription_id`**: string (required) - The inscription ID

</details>

<details>

<summary>Response</summary>

{% code overflow="wrap" %}

```
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "<!doctype html>\n<html lang=en>\n  <head>\n    <meta charset=utf-8>\n    <meta name=format-detection content='telephone=no'>\n    <style>\n      html {\n        background-color: #131516;\n        height: 100%;\n      }\n\n      body {\n        background-image: url(/content/85a3c4a4b94f2cd83db4b075553bd92011cefc5816cd76b36375ec34ecd4e57ei0);\n        background-position: center;\n        background-repeat: no-repeat;\n        background-size: contain;\n        height: 100%;\n        image-rendering: pixelated;\n        margin: 0;\n      }\n\n      img {\n        height: 100%;\n        opacity: 0;\n        width: 100%;\n      }\n    </style>\n  </head>\n  <body>\n    <img src=/content/85a3c4a4b94f2cd83db4b075553bd92011cefc5816cd76b36375ec34ecd4e57ei0></img>\n  </body>\n</html>\n"
}
```

{% endcode %}

</details>

##

## Recursive Methods

Recursive inscriptions facilitate the access and incorporation of existing inscription data into new inscriptions. By leveraging recursive inscriptions, users can effectively 'daisy-chain' data, pulling information from a series of interconnected inscriptions

More information can be found in our [Inscription Guide](https://docs.sandshrew.io/sandshrew-namespaces/broken-reference).

### Child Inscriptions

`ord_r:children` returns the first 100 child inscription IDs. If called with the optional page parameter, the set of 100 child inscriptions on `page` will be returned.

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_r:children",
    "params": [
      "60bcf821240064a9c55225c4f01711b0ebbcab39aa3fafeefe4299ab158536fai0",
      "2"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`inscription_id`**: string (required) - The inscription ID

**`page`**: string (optional) - The page number of the child inscriptions.

</details>

<details>

<summary>Response</summary>

<pre class="language-json" data-overflow="wrap"><code class="lang-json">{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "ids": [            "7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i82",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i83",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i84",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i85",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i86",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i87",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i88",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i89",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i90",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i91",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i92",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i93",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i94",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i95",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i96",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i97",
"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i98",
<strong>"7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i99"
</strong>        ],
        "more": true,
        "page": 0
    }
}
</code></pre>

</details>

### Sat Inscriptions

`ord_r:sat` returns the first 100 inscriptions at `sat_number`. If called with the optional page parameter, the set of 100 inscriptions on `page` will be returned.

`<sat_number>` only allows the actual number of a sat no other sat notations like degree, percentile or decimal.&#x20;

{% tabs %}
{% tab title="curl" %}

```
curl -s -XPOST https://mainnet.sandshrew.io/v1/<developer key> \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "ord_r:sat",
    "params": [
      "1897135510679085",
      "0"
    ]
}'
```

{% endtab %}
{% endtabs %}

<details>

<summary>Params</summary>

**`sat_number`**: string (required) - The inscription ID

**`page`**: string (optional) - The page number of the child inscriptions.

</details>

<details>

<summary>Response</summary>

{% code overflow="wrap" %}

```json
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "ids": [
            "7cd66b8e3a63dcd2fada917119830286bca0637267709d6df1ca78d98a1b4487i200"
        ],
        "more": false,
        "page": 0
    }
}
```

{% endcode %}

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sandshrew.io/sandshrew-namespaces/ord-inscriptions-runes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.