Inscriptions

Endpoints related to Inscription Details.

Endpoints' API-Key-Tier availabilities are written for each endpoint.

To use on testnet4/signet, use your current api-key and send the request to https://testnet.api.bestinslot.xyz / https://signet_api.bestinslot.xyz

Get Inscription Information

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/inscription/single_info_id

Returns detailed information about a specific inscription.

Sample query: https://api.bestinslot.xyz/v3/inscription/single_info_id?inscription_id=6d1cefe69ad686d6153bd1a6d34c6d55c6e3162cb2fac9b58a8d9d9e9fda13c6i0

NOTE: last_sale_price, listing prices and collection_floor_price is only available on Pro Tier.

Query Parameters

Name

Type

Description

inscription_id*

string

inscription id

{
    "data": {
        "inscription_name": "Runestone",
        "inscription_id": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci19",
        "inscription_number": 64362443,
        "metadata": {
            "name": "Runestone"
        },
        "wallet": "12dSsr8sFs21kpWaD2spSweFmyNzkZ8eRu",
        "mime_type": "model/gltf+json",
        "media_length": 0,
        "genesis_ts": 1710447063,
        "genesis_height": 834708,
        "genesis_fee": 1345,
        "output_value": 546,
        "satpoint": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152c:20:0",
        "last_sale_price": null,
        "collection_name": "Runestone",
        "collection_slug": "runestone",
        "last_transfer_block_height": 834708,
        "utxo": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152c:20",
        "parent_ids": [
            "fdb2df5d2b16db1ebcbf09e2d23b3f4e417db44b58e712c99b61f26b52c7cbb5i0"
        ],
        "collection_floor_price": 3950000,
        "min_price": null,
        "ordswap_price": null,
        "magiceden_price": null,
        "ordinalswallet_price": null,
        "gammaio_price": null,
        "nostr_price": null,
        "odynals_price": null,
        "unisat_price": null,
        "ordinalsmarket_price": null,
        "okx_price": null,
        "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci19",
        "bis_url": "https://bestinslot.xyz/ordinals/inscription/5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci19",
        "render_url": null,
        "byte_size": 0,
        "bitmap_number": null,
        "delegate": {
            "delegate_id": "ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
            "render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0.png",
            "mime_type": "model/gltf+json",
            "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
            "bis_url": "https://bestinslot.xyz/ordinals/inscription/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0"
        }
    },
    "block_height": 836798
}

Get Batch Inscription Information

Included in: Basic, Pro, Dedicated

POST https://api.bestinslot.xyz/v3/inscription/batch_info

Returns detailed information about several inscriptions (up to 100).

Sample query: url: https://api.bestinslot.xyz/v3/inscription/batch_info data: {"queries":["0", 1, "123", 17458374, -123, 32478238472934]} headers: { "Content-Type":"application/json", "x-api-key":"...." }

NOTE: last_sale_price, listing prices and collection_floor_price is only available on Pro Tier.

Request Body

Name

Type

Description

queries*

JSON Array

can be a list of inscription id, inscription number or location (txid:index), however all types must be the same. Max length is 100.

{
    "data": [
        {
            "query": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci1",
            "result": {
                "inscription_name": "Runestone",
                "inscription_id": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci1",
                "inscription_number": 64362425,
                "metadata": {
                    "name": "Runestone"
                },
                "wallet": "113zRn6gi97iAriKbXTFtkgqSeVmAD32uA",
                "mime_type": "model/gltf+json",
                "media_length": 0,
                "genesis_ts": 1710447063,
                "genesis_height": 834708,
                "genesis_fee": 1345,
                "output_value": 546,
                "satpoint": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152c:2:0",
                "last_sale_price": null,
                "collection_name": "Runestone",
                "collection_slug": "runestone",
                "last_transfer_block_height": 834708,
                "utxo": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152c:2",
                "parent_ids": [
                    "fdb2df5d2b16db1ebcbf09e2d23b3f4e417db44b58e712c99b61f26b52c7cbb5i0"
                ],
                "genesis_block_hash": "00000000000000000000292964b4b00d1d414583bd18d1ebea7a8041d4409c6d",
                "collection_floor_price": 3950000,
                "min_price": null,
                "ordswap_price": null,
                "magiceden_price": null,
                "ordinalswallet_price": null,
                "gammaio_price": null,
                "nostr_price": null,
                "odynals_price": null,
                "unisat_price": null,
                "ordinalsmarket_price": null,
                "okx_price": null,
                "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci1",
                "bis_url": "https://bestinslot.xyz/ordinals/inscription/5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci1",
                "render_url": null,
                "byte_size": 0,
                "bitmap_number": null,
                "delegate": {
                    "delegate_id": "ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
                    "render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0.png",
                    "mime_type": "model/gltf+json",
                    "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
                    "bis_url": "https://bestinslot.xyz/ordinals/inscription/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0"
                }
            }
        },
        ...
    ],
    "block_height": 804350
}

Get Global Inscription Information

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/inscription/global_info

Returns information about global inscriptions.

Sample query: https://api.bestinslot.xyz/v3/inscription/global_info

{
    "data": [
        {
            "text_cnt": 24513963,
            "image_cnt": 1118329,
            "application_cnt": 299961,
            "video_cnt": 1932,
            "model_cnt": 469,
            "audio_cnt": 666,
            "max_inscription_number": 25935380
        }
    ],
    "block_height": 804350
}

Request render refresh

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/inscription/render_refresh

Requests render refresh for given inscription.

Sample query: https://api.bestinslot.xyz/v3/inscription/render_refresh?inscription_id=8e9cdfb606db7abd839fdbc5eb1678ee60c9d6b1b008790ed1052ddadac12877i71

NOTE: returns already-in-queue or added-to-queue.

Query Parameters

Name

Type

Description

inscription_id*

string

inscription id

{
    "data": "added-to-queue",
    "block_height": 889397
}

Get Inscription Activity

Included in: Pro, Dedicated

GET https://api.bestinslot.xyz/v3/inscription/activity

Returns ordered list of inscribes, sales and transfers of a single inscription.

Sample query: https://api.bestinslot.xyz/v3/inscription/activity?inscription_id=2f1d51c67998d981055e94dba30d3d1199aa9714049801d7cd35c72066c586abi0&activity_filter=7&sort_by=ts&order=desc&offset=0&count=100

Query Parameters

Name

Type

Description

sort_by*

string

order*

string

asc, desc

offset*

int

0 <= offset <= 5k

count*

int

20 <= count <= 100

inscription_id*

string

inscription id

activity_filter*

int

1 -> inscribed 2 -> transferred 4 -> sold combine with or operator (e.g. sold & transferred: 2 | 4 = 6)

{
    "data": [
        {
            "inscription_id": "daf55547be8fd88f242ce24b3af11ec9f4d602b0c05b4b23967dfcd160ac719di0",
            "from_wallet": "bc1pm2grfjnvhrfjff965cs63gma5ze02v3572wks9mdl7kxjyt2q58q5es97l",
            "to_wallet": "bc1pdly22tta7wx56j9xhygzg5dwnd4a3xnj7qyt9ewrajn9hvmha9msfpm3sd",
            "block_height": 795034,
            "sale_price": -1,
            "new_satpoint": "5cd78b9bf19d80a1d525564ef7df775b65f0cc15e5f7bbafcb724c1b8995615c:0:0",
            "ts": "2023-06-19T09:30:18.000Z",
            "marketplace_type": "magiceden",
            "tx_id": "5cd78b9bf19d80a1d525564ef7df775b65f0cc15e5f7bbafcb724c1b8995615c"
        },
        ...
    ],
    "block_height": 795035
}

Get Inscriptions in Transaction

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/inscription/in_transaction

Returns inscription ids that move in a given transaction.

Sample query: https://api.bestinslot.xyz/v3/inscription/in_transaction?tx_id=5c709dbe85c44935384a3d68d10f9212b1ee315bba422cb8b5944803b521a3db

Query Parameters

Name

Type

Description

tx_id*

string

Bitcoin Transaction Id

{
    "data": [
        {
            "inscription_id": "7fd3aca38fd8acb22efe231ef5d5439e391c0394be3967ee07484cffc1b792fai0"
        },
        {
            "inscription_id": "251c744ceb0ad4c6e1ee0d391cfa0451d958065e73605b543190cda62723f6f8i0"
        },
        {
            "inscription_id": "b089b8df8392d0ac3b47b8e51fb008aa40442b6bb250ad2a1d8d60d88cc65585i0"
        },
        {
            "inscription_id": "ec9570ada981607bd93a5a7e6fd99760faaa8fc87989aa6646fe8c9b2aab494ei0"
        },
        {
            "inscription_id": "7c679ba4a2b8460fb60d62912e812206a031abeef19983564953c14bb4e091d5i0"
        },
        {
            "inscription_id": "9c233d4b62e1fde06c1a238fcef26e398eaee5a9abf32a6de8eef12cd4e523dai0"
        }
    ],
    "block_height": 815901
}

Get Inscription Activity in Block

Included in: Enterprise, Dedicated with Enterprise Endpoints

GET https://api.bestinslot.xyz/v3/inscription/activity_on_block

Returns the inscription activity on a given block_height

NOTE: block_height at the response is not the queried block height. It is the final indexed block height of our indexer.

Sample query: https://api.bestinslot.xyz/v3/inscription/activity_on_block?block_height=802397

https://api.bestinslot.xyz/v3/inscription/activity_on_block?block_height=802397&sort_by=ts&order=asc&activity_filter=4

Query Parameters

Name

Type

Description

block_height*

int

block height, must not be bigger than current bitcoin block height

order

string

asc, desc

sort_by

string

activity_filter

int

1 -> inscribed 2 -> transferred 4 -> sold combine with or operator (e.g. sold & transferred: 2 | 4 = 6)

{
    "data": [
        {
            "inscription_id": "b4f3838eecc0600531264e3dfcffbe997c73d77c7aa6fb7e9afc7cc20fad2fa9i0",
            "from_wallet": "bc1pz5sdw9zqek9vhc52w7du4yskwk8rmcz0m7wmqhfv24gv5tdqqzcqpwvdt0",
            "to_wallet": "bc1pk6t7u08vtpx7r79m8hhxrhsd9s7xpqck9aa75hlgq3fm8ww83n9s8hex94",
            "block_height": 805002,
            "sale_price": 417950,
            "new_satpoint": "fab1dbe521900e73a87b2410c84559320cbdf7b21415fbfc57a1d5dfbed662de:1:0",
            "ts": "2023-08-27T04:12:43.000Z",
            "marketplace_type": "magiceden",
            "inscription_name": "Ordinal Insider #29",
            "inscription_number": 921122,
            "collection_name": "Ordinal Insiders",
            "collection_slug": "ordinal-insiders",
            "tx_id": "fab1dbe521900e73a87b2410c84559320cbdf7b21415fbfc57a1d5dfbed662de"
        },
        ...
    ],
    "block_height": 815969
}

Get New Inscriptions in Block

Included in: Enterprise, Dedicated with Enterprise Endpoints

GET https://api.bestinslot.xyz/v3/inscription/new_inscriptions_in_block

Returns the inscriptions that are inscribed in a given block_height

NOTE: block_height at the response is not the queried block height. It is the final indexed block height of our indexer.

Sample query: https://api.bestinslot.xyz/v3/inscription/new_inscriptions_in_block?block_height=802397

Query Parameters

Name

Type

Description

block_height*

int

block height, must not be bigger than current bitcoin block height

{
    "data": [
        {
            "inscription_name": "Runestone",
            "inscription_id": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci0",
            "inscription_number": 64362424,
            "metadata": {
                "name": "Runestone"
            },
            "wallet": "1111111111111111111114oLvT2",
            "mime_type": "model/gltf+json",
            "media_length": 0,
            "genesis_ts": 1710447063,
            "genesis_height": 834708,
            "genesis_fee": 1345,
            "output_value": 546,
            "satpoint": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152c:1:0",
            "last_sale_price": null,
            "collection_name": "Runestone",
            "collection_slug": "runestone",
            "last_transfer_block_height": 834708,
            "parent_ids": [
                "fdb2df5d2b16db1ebcbf09e2d23b3f4e417db44b58e712c99b61f26b52c7cbb5i0"
            ],
            "collection_floor_price": 3950000,
            "min_price": null,
            "ordswap_price": null,
            "magiceden_price": null,
            "ordinalswallet_price": null,
            "gammaio_price": null,
            "nostr_price": null,
            "odynals_price": null,
            "unisat_price": null,
            "ordinalsmarket_price": null,
            "okx_price": null,
            "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci0",
            "bis_url": "https://bestinslot.xyz/ordinals/inscription/5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci0",
            "render_url": null,
            "byte_size": 0,
            "bitmap_number": null,
            "delegate": {
                "delegate_id": "ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
                "render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0.png",
                "mime_type": "model/gltf+json",
                "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
                "bis_url": "https://bestinslot.xyz/ordinals/inscription/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0"
            }
        },
        ...
    ],
    "block_height": 804496
}

PreviousWallets NextSats Names

Last updated 8 months ago

hashtagGet Inscription Information

hashtagQuery Parameters

hashtagGet Batch Inscription Information

hashtagRequest Body

hashtagGet Global Inscription Information

hashtagRequest render refresh

hashtagQuery Parameters

hashtagGet Inscription Activity

hashtagQuery Parameters

hashtagGet Inscriptions in Transaction

hashtagQuery Parameters

hashtagGet Inscription Activity in Block

hashtagQuery Parameters

hashtagGet New Inscriptions in Block

hashtagQuery Parameters

Get Inscription Information

Query Parameters

Get Batch Inscription Information

Request Body

Get Global Inscription Information

Request render refresh

Query Parameters

Get Inscription Activity

Query Parameters

Get Inscriptions in Transaction

Query Parameters

Get Inscription Activity in Block

Query Parameters

Get New Inscriptions in Block

Query Parameters