Collections - Best in Slot

Retired. These endpoints are no longer served. Run OPI instead — see the introduction. Kept for historical reference.

Endpoints’ API-Key-Tier availabilities are written for each endpoint. NOTE: sub1k and sub10k meta-collection information can be retrieved by using these as slug. 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 collections

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/collections Returns ordered list of collections with detailed information about them. Sample query: https://api.bestinslot.xyz/v3/collection/collections?sort_by=median_number&order=asc&offset=100&count=100

inscription_icon_id may be a URL for some collections

listed_count, floor_price, floor_price_ordswap, floor_price_magiceden, floor_price_ordinalswallet, floor_price_gammaio, floor_price_ordynals, floor_price_ordinalsmarket, floor_price_okx, vol_24h_in_btc, vol_7d_in_btc, sale_cnt_7d, vol_total_in_btc, sale_cnt_total, marketcap is only available on Pro Tier.

Query Parameters

Name	Type	Description
sort_by*	string	supply, min_number, median_number, max_number PRO TIER: listed_count, floor_price, floor_price_ordswap, floor_price_magiceden, floor_price_ordinalswallet, floor_price_gammaio, floor_price_ordynals, floor_price_ordinalsmarket, floor_price_unisat, floor_price_okx, vol_24h_in_btc, vol_7d_in_btc, sale_cnt_7d, vol_total_in_btc, sale_cnt_total, marketcap
order*	string	asc, desc
offset*	int	0 <= offset
count*	int	20 <= count <= 100

200: OK Success

{
    "data": [
        {
            "name": "Quantum Cats",
            "slug": "quantum_cats",
            "inscription_icon_id": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/ord-taproot_wizards_presents_pfp_1706542390359.png",
            "icon_url": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/ord-taproot_wizards_presents_pfp_1706542390359.png",
            "icon_render_url": null,
            "bis_url": "https://bestinslot.xyz/ordinals/collection/quantum_cats",
            "supply": "3333",
            "min_number": 53785860,
            "median_number": 53788086,
            "max_number": 53790617,
            "listed_count": 132,
            "floor_price": 12136980,
            "floor_price_ordswap": null,
            "floor_price_magiceden": 12136980,
            "floor_price_ordinalswallet": null,
            "floor_price_gammaio": null,
            "floor_price_ordynals": null,
            "floor_price_unisat": null,
            "floor_price_ordinalsmarket": 199000000,
            "floor_price_okx": 20000000,
            "vol_3h_in_btc": 0.20895894,
            "vol_24h_in_btc": 0.20895894,
            "vol_7d_in_btc": 16.14854946,
            "vol_30d_in_btc": 92.46122358,
            "sale_cnt_7d": 139,
            "vol_total_in_btc": 1683.87253749,
            "sale_cnt_total": 6352,
            "marketcap": 40452554340
        },
        ...
    ],
    "block_height": 889392
}

Get Collection Information

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/info Returns detailed information about a specific collection. Sample query: https://api.bestinslot.xyz/v3/collection/info?slug=degods

inscription_icon_id may be a link for some collections

Query Parameters

Name	Type	Description
slug*	string	Collection slug

200: OK Success

{
    "data": {
        "name": "Strokes by zond",
        "twitter_link": "https://twitter.com/imgdotart",
        "discord_link": "https://discord.gg/nzQvtTfGJY",
        "website_link": "",
        "description": "",
        "supply": "16",
        "inscription_icon_id": "facd59ddb3d1822b6433eb297a1c4e11d46b75bb98559e3167f4f12e367da28ei0",
        "min_number": 131639,
        "median_number": 131647,
        "max_number": 131654,
        "icon_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/facd59ddb3d1822b6433eb297a1c4e11d46b75bb98559e3167f4f12e367da28ei0",
        "icon_render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/facd59ddb3d1822b6433eb297a1c4e11d46b75bb98559e3167f4f12e367da28ei0.png",
        "bis_url": "https://bestinslot.xyz/ordinals/collection/strokes-by-zond"
    },
    "block_height": 836797
}

Get Collection Holders

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/holders Returns an array with holder information. Each entry has a wallet address and collected inscription ids. Sample query: https://api.bestinslot.xyz/v3/collection/holders?slug=degods\ https://api.bestinslot.xyz/v3/collection/holders?slug=degods&sort_by=wallet_addr&order=asc&offset=0&count=100

Query Parameters

Name	Type	Description
slug*	string	Collection slug
sort_by	string	(optional) “wallet_addr”
order	string	(optional) “asc”, “desc”
offset	int	(optional) 0 <= offset
count	int	(optional) 20 <= count <= 100

200: OK Success

{
    "data": [
        {
            "wallet": "bc1phw8w74ghl05k2h8lfxsmf45cygw4h6jhl7etm8qn5jjctpgyaxusl94w8s",
            "inscription_ids": [
                "22c8afa20c013499e278318e30e4745fbaa7b613e8b9a954d6d3661322c66816i0",
                "48c922a1d013c7d179c291f39dd0f2b3bc2c194a0bc464fdd16f52f11da4ad1ei0",
                "c8548df15991a6bd2dfb89cc421f0d4256cebf197768ec4c8183276e125237fbi0",
                "885c64b7d183330186cb20cd4bfeba4209e8f3c17939a0188634ddd7ebe34455i0",
                "2a285972320858c90c7ae2477c55ec106f9cc50caa9a4fa6d456cbfbaf2fac6di0",
                "faacc3092fd920711515f40997ea273a4c08967d6d2e7404ab73e2064d2ccd88i0"
            ]
        },
        ...
    ],
    "block_height": 795035
}

Get Collection Inscriptions

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/inscriptions Returns ordered list of inscriptions of a specific collection. Sample query: https://api.bestinslot.xyz/v3/collection/inscriptions?slug=bitcoin-frogs&sort_by=inscr_num&order=asc&offset=100&count=100

last_sale_price is only available on Pro Tier.

Query Parameters

Name	Type	Description
sort_by*	string	inscr_num
order*	string	asc, desc
offset*	int	0 <= offset
count*	int	20 <= count <= 100
slug*	string	collection slug

200: OK Success

{
    "data": [
        {
            "name": "Runestone",
            "inscription_id": "5f3dafcdd142358b332e0939d37174b76472735df8df29325901d2c7d18a152ci19",
            "inscription_number": 64362443,
            "metadata": {
                "name": "Runestone"
            },
            "owner_wallet_addr": "12dSsr8sFs21kpWaD2spSweFmyNzkZ8eRu",
            "mime_type": "model/gltf+json",
            "last_transfer_block_height": 834708,
            "parent_ids": [
                "fdb2df5d2b16db1ebcbf09e2d23b3f4e417db44b58e712c99b61f26b52c7cbb5i0"
            ],
            "genesis_height": 834708,
            "last_sale_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,
            "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": 799055
}

Get Collection Sales Information

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/sales_info Returns sales and volume information about a specific collection. Sample query: https://api.bestinslot.xyz/v3/collection/sales_info?slug=bitcoin-frogs&marketplace_type=magiceden

Query Parameters

Name	Type	Description
slug*	string	Collection slug
marketplace_type	string	Optional parameter to filter only by a given marketplace. You can find the allowed types on Constants Page.

200: OK Success

{
    "data": {
        "vol_3h": "9970000",
        "vol_6h": "45228879",
        "vol_9h": "82738348",
        "vol_12h": "94525896",
        "vol_1d": "140485613",
        "vol_3d": "995189800",
        "vol_7d": "2282078504",
        "vol_30d": "20435090360",
        "vol_total": "49541749144",
        "sale_count": 12274,
        "marketplace": "all"
    },
    "block_height": 795035
}

Get Collection Market Information

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/market_info Returns market information like marketcap, listed count, floor price about a specific collection. Sample query: https://api.bestinslot.xyz/v3/collection/market_info?slug=omb

Query Parameters

Name	Type	Description
slug*	string	Collection slug

200: OK Success

{
    "data": {
        "listed_count": 311,
        "floor_price": 20706000,
        "floor_price_ordswap": null,
        "floor_price_magiceden": 20706000,
        "floor_price_ordinalswallet": 300000000,
        "floor_price_gammaio": null,
        "floor_price_unisat": 100500000,
        "floor_price_ordynals": null,
        "floor_price_ordinalsmarket": null,
        "floor_price_okx": 57899999,
        "supply": "5243",
        "marketcap": 108561558000
    },
    "block_height": 849817
}

Get Collection Listings

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/listings Returns ordered list of listings of a specific collection. Sample query: https://api.bestinslot.xyz/v3/collection/listings?slug=bitcoin-frogs&sort_by=min_price&order=asc&offset=0&count=100

Query Parameters

Name	Type	Description
sort_by*	string	min_price, ordswap_price, magiceden_price, ordinalswallet_price, gammaio_price, odynals_price, unisat_price, ordinalsmarket_price, okx_price
order*	string	asc, desc
offset*	int	0 <= offset <= 5k
count*	int	20 <= count <= 100
slug*	string	collection slug

200: OK Success

{
    "data": [
        {
            "inscription_id": "02696786f173f05e55b457d12ef41bfcc905acd6ee5c0c61b80d8679a4ea91c9i0",
            "min_price": 4284000,
            "ordswap_price": null,
            "magiceden_price": 4284000,
            "ordinalswallet_price": null,
            "gammaio_price": null,
            "nostr_price": null,
            "odynals_price": null,
            "unisat_price": null,
            "ordinalsmarket_price": null,
            "okx_price": null,
            "owner_wallet_addr": "bc1pg95hedhcnrv9gu595n7ysy4apu6c0cz9vrs08dxd59p7kn5zyv0s6zdv0p"
        },
        ...
    ],
    "block_height": 803265
}

Get Collection Activity

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/collection/activity Returns ordered list of inscribes, sales and transfers of a specific collection.

Use last_new_satpoint to continue fetching the activity from where you’ve left off. new_satpoint uniquely addresses a single inscription transfer, so by setting order to asc, and last_new_satpoint to the latest new_satpoint value that you’ve received, you can retrieve the new activities.

Sample query: https://api.bestinslot.xyz/v3/collection/activity?slug=degods&activity_filter=7&sort_by=ts&order=asc&offset=0&count=100&last_new_satpoint=32b63c4844db4f704a8df0cf27fcf6ee966a716ea5410e598fe40734b1a7027f:1:0

Query Parameters

Name	Type	Description
sort_by*	string	ts
order*	string	asc, desc
offset*	int	0 <= offset <= 5k
count*	int	20 <= count <= 100
slug*	string	collection slug
activity_filter*	int	1 -> inscribed 2 -> transferred 4 -> sold combine with or operator (e.g. sold & transferred: 2	4 = 6)
last_new_satpoint	string	(optional) use this with offset 0 to continue from a known transfer

200: OK Success

{
    "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 collections

​Query Parameters

​Get Collection Information

​Query Parameters

​Get Collection Holders

​Query Parameters

​Get Collection Inscriptions

​Query Parameters

​Get Collection Sales Information

​Query Parameters

​Get Collection Market Information

​Query Parameters

​Get Collection Listings

​Query Parameters

​Get Collection Activity

​Query Parameters

Get collections

Query Parameters

Get Collection Information

Query Parameters

Get Collection Holders

Query Parameters

Get Collection Inscriptions

Query Parameters

Get Collection Sales Information

Query Parameters

Get Collection Market Information

Query Parameters

Get Collection Listings

Query Parameters

Get Collection Activity

Query Parameters