Get inscriptions
Retrieves a list of inscriptions with options to filter and sort results.
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
Range
value < 2099999997690000to_sat_ordinal?Ordinal Number
Ordinal number that uniquely identifies a satoshi
Range
value < 2099999997690000from_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
Range
1 <= value <= 60order_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>
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"
}