Skip to main content

List of 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)

Example (777654): 777654

Example (0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133): 0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133

from_genesis_block_height Block Height

Possible values: Value must match regular expression ^[0-9]+$

Bitcoin block height

Example: 777678

to_genesis_block_height Block Height

Possible values: Value must match regular expression ^[0-9]+$

Bitcoin block height

Example: 777678

from_genesis_timestamp Timestamp

Block UNIX epoch timestamp (milliseconds)

Example: 1677731361

to_genesis_timestamp Timestamp

Block UNIX epoch timestamp (milliseconds)

Example: 1677731361

from_sat_ordinal Ordinal Number

Possible values: value < 2099999997690000

Ordinal number that uniquely identifies a satoshi

Example: 257418248345364

to_sat_ordinal Ordinal Number

Possible values: value < 2099999997690000

Ordinal number that uniquely identifies a satoshi

Example: 257418248345364

from_sat_coinbase_height Block Height

Possible values: Value must match regular expression ^[0-9]+$

Bitcoin block height

Example: 777678

to_sat_coinbase_height Block Height

Possible values: Value must match regular expression ^[0-9]+$

Bitcoin block height

Example: 777678

from_number Inscription Number

Inscription number

Example: 10500

to_number Inscription Number

Inscription number

Example: 10500

id Inscription ID[]

Possible values: Value must match regular expression ^[a-fA-F0-9]{64}i[0-9]+$

Array of inscription IDs

Example: 38c46a8bf7ec90bc7f6b797e7dc84baa97f4e5fd4286b92fe1b50176d03b18dci0,e3af144354367de58c675e987febcb49f17d6c19e645728b833fe95408feab85i0

number Inscription Number[]

Array of inscription numbers

Example: 10500,65

output Transaction Output

Possible values: Value must match regular expression ^[a-fA-F0-9]{64}:[0-9]+$

An UTXO for a Bitcoin transaction

Example: 8f46f0d4ef685e650727e6faf7e30f23b851a7709714ec774f7909b3fb5e604c:0

address Address[]

Array of Bitcoin addresses

Example: bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5,bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj

genesis_address Address[]

Array of Bitcoin addresses

Example: bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5,bc1pscktlmn99gyzlvymvrezh6vwd0l4kg06tg5rvssw0czg8873gz5sdkteqj

mime_type MIME Type[]

Possible values: Value must match regular expression ^\w+\/[-.\w]+(?:\+[-.\w]+)?$

Array of inscription MIME types

Example: image/png,image/jpeg

rarity Rarity[]

Array of satoshi rarity values

Example: common,uncommon

recursive Recursive

Whether or not the inscription is recursive

cursed Cursed

Whether or not the inscription is cursed

offset Offset

Result offset

limit Limit

Possible values: 1 ≤ value ≤ 60

Results per page

order_by Order By

Parameter to order results by

order Order

Results order

Responses
200

Default Response

Schema OPTIONAL
limit integer
offset integer
total integer
results object[]
id string
number integer
address
genesis_address
genesis_block_height integer
genesis_block_hash string
genesis_tx_id string
genesis_fee string
genesis_timestamp integer
tx_id string
location string
output string
value
offset
sat_ordinal string
sat_rarity string
sat_coinbase_height integer
mime_type string
content_type string
content_length integer
timestamp integer
curse_type
recursive boolean
recursion_refs
404

Default Response

Schema OPTIONAL
error string

Possible values: [Not found]