Get inscriptions

Retrieves a list of inscriptions with options to filter and sort results.

GET
/ordinals/v1/inscriptions

Query Parameters

genesis_block?Block Identifier

Bitcoin block identifier (height or hash)

from_genesis_block_height?Block Height

Bitcoin block height

Pattern"^[0-9]+$"
to_genesis_block_height?Block Height

Bitcoin block height

Pattern"^[0-9]+$"
from_genesis_timestamp?Timestamp

Block UNIX epoch timestamp (milliseconds)

to_genesis_timestamp?Timestamp

Block UNIX epoch timestamp (milliseconds)

from_sat_ordinal?Ordinal Number

Ordinal number that uniquely identifies a satoshi

Rangevalue < 2099999997690000
to_sat_ordinal?Ordinal Number

Ordinal number that uniquely identifies a satoshi

Rangevalue < 2099999997690000
from_sat_coinbase_height?Block Height

Bitcoin block height

Pattern"^[0-9]+$"
to_sat_coinbase_height?Block Height

Bitcoin block height

Pattern"^[0-9]+$"
from_number?Inscription Number

Inscription number

to_number?Inscription Number

Inscription number

id?Inscription IDs

Array of inscription IDs

number?Inscription Numbers

Array of inscription numbers

output?Transaction Output

An UTXO for a Bitcoin transaction

Pattern"^[a-fA-F0-9]{64}:[0-9]+$"
address?Addresses

Array of Bitcoin addresses

genesis_address?Addresses

Array of Bitcoin addresses

mime_type?MIME Types

Array of inscription MIME types

rarity?Rarity

Array of satoshi rarity values

recursive?Recursive

Whether or not the inscription is recursive

cursed?Cursed

Whether or not the inscription is cursed

offset?Offset

Result offset

limit?Limit

Results per page

Range1 <= value <= 60
order_by?Order By

Parameter to order results by

order?Order

Results order

Response Body

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger
offsetinteger
totalinteger
resultsarray<Inscription Response>

@minItems 0

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring
Value in"Not found"
curl -X GET "https://api.hiro.so//ordinals/v1/inscriptions?genesis_block=0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133&from_genesis_block_height=777678&to_genesis_block_height=777678&from_genesis_timestamp=1677731361&to_genesis_timestamp=1677731361&from_sat_ordinal=257418248345364&to_sat_ordinal=257418248345364&from_sat_coinbase_height=777678&to_sat_coinbase_height=777678&from_number=10500&to_number=10500&id=38c46a8bf7ec90bc7f6b797e7dc84baa97f4e5fd4286b92fe1b50176d03b18dci0&id=e3af144354367de58c675e987febcb49f17d6c19e645728b833fe95408feab85i0&number=10500&number=65&output=8f46f0d4ef685e650727e6faf7e30f23b851a7709714ec774f7909b3fb5e604c%3A0&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&genesis_address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&genesis_address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&mime_type=image%2Fpng&mime_type=image%2Fjpeg&rarity=common&rarity=uncommon&recursive=false&cursed=false&offset=0&limit=1&order_by=number&order=asc"
fetch("https://api.hiro.so//ordinals/v1/inscriptions?genesis_block=0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133&from_genesis_block_height=777678&to_genesis_block_height=777678&from_genesis_timestamp=1677731361&to_genesis_timestamp=1677731361&from_sat_ordinal=257418248345364&to_sat_ordinal=257418248345364&from_sat_coinbase_height=777678&to_sat_coinbase_height=777678&from_number=10500&to_number=10500&id=38c46a8bf7ec90bc7f6b797e7dc84baa97f4e5fd4286b92fe1b50176d03b18dci0&id=e3af144354367de58c675e987febcb49f17d6c19e645728b833fe95408feab85i0&number=10500&number=65&output=8f46f0d4ef685e650727e6faf7e30f23b851a7709714ec774f7909b3fb5e604c%3A0&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&genesis_address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&genesis_address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&mime_type=image%2Fpng&mime_type=image%2Fjpeg&rarity=common&rarity=uncommon&recursive=false&cursed=false&offset=0&limit=1&order_by=number&order=asc")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//ordinals/v1/inscriptions?genesis_block=0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133&from_genesis_block_height=777678&to_genesis_block_height=777678&from_genesis_timestamp=1677731361&to_genesis_timestamp=1677731361&from_sat_ordinal=257418248345364&to_sat_ordinal=257418248345364&from_sat_coinbase_height=777678&to_sat_coinbase_height=777678&from_number=10500&to_number=10500&id=38c46a8bf7ec90bc7f6b797e7dc84baa97f4e5fd4286b92fe1b50176d03b18dci0&id=e3af144354367de58c675e987febcb49f17d6c19e645728b833fe95408feab85i0&number=10500&number=65&output=8f46f0d4ef685e650727e6faf7e30f23b851a7709714ec774f7909b3fb5e604c%3A0&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&genesis_address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&genesis_address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&mime_type=image%2Fpng&mime_type=image%2Fjpeg&rarity=common&rarity=uncommon&recursive=false&cursed=false&offset=0&limit=1&order_by=number&order=asc"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//ordinals/v1/inscriptions?genesis_block=0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133&from_genesis_block_height=777678&to_genesis_block_height=777678&from_genesis_timestamp=1677731361&to_genesis_timestamp=1677731361&from_sat_ordinal=257418248345364&to_sat_ordinal=257418248345364&from_sat_coinbase_height=777678&to_sat_coinbase_height=777678&from_number=10500&to_number=10500&id=38c46a8bf7ec90bc7f6b797e7dc84baa97f4e5fd4286b92fe1b50176d03b18dci0&id=e3af144354367de58c675e987febcb49f17d6c19e645728b833fe95408feab85i0&number=10500&number=65&output=8f46f0d4ef685e650727e6faf7e30f23b851a7709714ec774f7909b3fb5e604c%3A0&address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&genesis_address=bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5&genesis_address=bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj&mime_type=image%2Fpng&mime_type=image%2Fjpeg&rarity=common&rarity=uncommon&recursive=false&cursed=false&offset=0&limit=1&order_by=number&order=asc"

response = requests.request("GET", url)

print(response.text)
{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0",
      "number": 248751,
      "address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "genesis_address": "bc1pvwh2dl6h388x65rqq47qjzdmsqgkatpt4hye6daf7yxvl0z3xjgq247aq8",
      "genesis_block_height": 778921,
      "genesis_block_hash": "0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133",
      "genesis_tx_id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218",
      "genesis_fee": "3179",
      "genesis_timestamp": 0,
      "tx_id": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218",
      "location": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218:0:0",
      "output": "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218:0",
      "value": "546",
      "offset": "0",
      "sat_ordinal": "1232735286933201",
      "sat_rarity": "common",
      "sat_coinbase_height": 430521,
      "mime_type": "text/plain",
      "content_type": "text/plain;charset=utf-8",
      "content_length": 59,
      "timestamp": 1677733170000,
      "curse_type": "p2wsh",
      "recursive": true,
      "recursion_refs": [
        "1463d48e9248159084929294f64bda04487503d30ce7ab58365df1dc6fd58218i0"
      ]
    }
  ]
}
{
  "error": "Not found"
}