Runes - 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. 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

Terminology

[Used in this API for standardization] : [Terminology in Runes]

rune_name: Non-spaced unique Rune Name
deploy_txid: etching
decimals: divisibility
per_mint_amount: terms.amount (each mint event mints this amount for this rune)
mint_cnt: mints (count of mint events)
mint_cnt_limit: terms.cap (maximum allowed mint events for this rune)
premined_supply: premine (rune amount mined while deploying the rune)
total_minted_supply: premine + mint_cnt * per_mint_amount
circulating_supply: premine + mint_cnt * per_mint_amount - burned_supply
mintable: mint_cnt < mint_cnt_limit & (mint_start_block <= current_block < mint_end_block)
auto_upgrade: turbo (should ticker auto opt-in to new runes features)
output - <txid>:<output_index>
pkscript - bitcoin ScriptPubKey
avg_unit_price_in_sats - Calculated by taking the median unit price of sales in last 6 hrs. If there are not enough sale in last 6 hrs, it’ll look at latest several sales, if there is not enough sale on the ticker, it’ll return null. Note that this is scaled by decimals to make ordering more meaningful.
event_type - possible options are: input, new-allocation, mint, output, burn

Runes Testnet4 Faucet (only on testnet)

Included in: Basic, Pro, Dedicated GET https://testnet.api.bestinslot.xyz/v3/runes/testnet_faucet A testnet rune faucet that mints 1.0 (1_0000_0000) test rune to target address. NOTE: Limited with 10 request per 24 hours per key. Sample query: https://testnet.api.bestinslot.xyz/v3/runes/testnet_faucet?address=tb1qvhl8k0xu0stk956tjqx6q5ujp6tdyh24xcz0qq

Query Parameters

Name	Type	Description
address*	`string`	Testnet Bitcoin wallet address

Response

200: OK Success

{
    "mint_txid": "43cec273ded990afcc681eb64da2e4884f7dc8518db01f82620dff98beaa0e49"
}

Runes Tickers

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/tickers Returns information about runes tickers. NOTE: avg_unit_price_in_sats is scaled by decimals to make ordering more meaningful. Sample query: https://api.bestinslot.xyz/v3/runes/tickers?sort_by=rune_number&order=asc&offset=0&count=100

Query Parameters

Name	Type	Description
sort_by*	`string`	rune_id, rune_number, rune_name, mint_cnt, total_minted_supply, burned_supply, circulating_supply, mint_progress, deploy_ts, holder_count, event_count. PRO TIER: avg_unit_price_in_sats, min_listed_unit_price_in_sats, min_listed_unit_price_unisat, listed_supply, listed_supply_ratio, marketcap, total_volume
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 300
minting_status	`string`	(optional) set to “not_complete” for tickers with mintable = true, “completed” for mintable = false, leave unset to search all

Response

200: OK Success
429: Too Many Requests Rate limit exceeded

{
    "data": [
        {
            "rune_id": "840000:1",
            "rune_number": "1",
            "rune_name": "ZZZZZFEHUZZZZZ",
            "spaced_rune_name": "Z•Z•Z•Z•Z•FEHU•Z•Z•Z•Z•Z",
            "symbol": "ᚠ",
            "decimals": 2,
            "per_mint_amount": "100",
            "mint_cnt": "1111111",
            "mint_cnt_limit": "1111111",
            "premined_supply": "11000000000",
            "total_minted_supply": "11111111100",
            "burned_supply": "46300",
            "circulating_supply": "11111064800",
            "mint_progress": 100,
            "mint_start_block": null,
            "mint_end_block": null,
            "genesis_block": 840000,
            "deploy_ts": "2024-04-20T00:09:27.000Z",
            "deploy_txid": "2bb85f4b004be6da54f766c17c1e855187327112c231ef2ff35ebad0ea67c69e",
            "auto_upgrade": true,
            "holder_count": 22865,
            "event_count": 3033717,
            "mintable": false,
            "icon_inscr_id": "2bb85f4b004be6da54f766c17c1e855187327112c231ef2ff35ebad0ea67c69ei0",
            "icon_delegate_id": "e16b8b872584112c6e84c5a941e8ad91f9e428458605a0e9f582305dd12ef247i0",
            "icon_content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/e16b8b872584112c6e84c5a941e8ad91f9e428458605a0e9f582305dd12ef247i0",
            "icon_render_url": null,
            "avg_unit_price_in_sats": 30195.999999999996,
            "min_listed_unit_price_in_sats": 30233.581818181818,
            "min_listed_unit_price_unisat": 30233.582000000002,
            "listed_supply": "929250",
            "listed_supply_ratio": 0.00008363284858171289,
            "marketcap": 3355097127008,
            "total_sale_info": {
                "sale_count": 106570,
                "sale_count_3h": 0,
                "sale_count_6h": 1,
                "sale_count_9h": 1,
                "sale_count_12h": 73,
                "sale_count_1d": 205,
                "sale_count_3d": 413,
                "sale_count_7d": 1002,
                "sale_count_30d": 2583,
                "sale_amount": 77883929,
                "vol_3h": 0,
                "vol_6h": 126159,
                "vol_9h": 126159,
                "vol_12h": 1226131,
                "vol_1d": 4207823,
                "vol_3d": 16909211,
                "vol_7d": 51653484,
                "vol_30d": 220929558,
                "vol_total": 26566160622
            }
        },
        ...
    ],
    "block_height": 847620
}

Runes Ticker Count

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/ticker_cnt Returns count of all runes tickers and mintable runes tickers Sample query: https://api.bestinslot.xyz/v3/runes/ticker_cnt

200: OK Success

{
    "data": {
        "ticker_cnt": 70480,
        "minting_ticker_cnt": 14596
    },
    "block_height": 844739
}

Runes Single Ticker Info

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/ticker_info Returns information about given runes ticker.

avg_unit_price_in_sats, min_listed_unit_price_in_sats, listed_supply, listed_supply_ratio, marketcap and total_sale_info are only available in PRO tier.

Sample query: https://api.bestinslot.xyz/v3/runes/ticker_info?rune_name=UNCOMMONGOODS

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number

NOTE: One of rune_name, rune_id or rune_number must be specified Response

200: OK Success
429: Too Many Requests Rate limit exceeded

{
    "data": {
        "rune_id": "840000:1",
        "rune_number": "1",
        "rune_name": "ZZZZZFEHUZZZZZ",
        "spaced_rune_name": "Z•Z•Z•Z•Z•FEHU•Z•Z•Z•Z•Z",
        "symbol": "ᚠ",
        "decimals": 2,
        "per_mint_amount": "100",
        "mint_cnt": "1111111",
        "mint_cnt_limit": "1111111",
        "premined_supply": "11000000000",
        "total_minted_supply": "11111111100",
        "burned_supply": "46300",
        "circulating_supply": "11111064800",
        "mint_progress": 100,
        "mint_start_block": null,
        "mint_end_block": null,
        "genesis_block": 840000,
        "deploy_ts": "2024-04-20T00:09:27.000Z",
        "deploy_txid": "2bb85f4b004be6da54f766c17c1e855187327112c231ef2ff35ebad0ea67c69e",
        "auto_upgrade": true,
        "holder_count": 22865,
        "event_count": 3033717,
        "mintable": false,
        "icon_inscr_id": "2bb85f4b004be6da54f766c17c1e855187327112c231ef2ff35ebad0ea67c69ei0",
        "icon_delegate_id": "e16b8b872584112c6e84c5a941e8ad91f9e428458605a0e9f582305dd12ef247i0",
        "icon_content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/e16b8b872584112c6e84c5a941e8ad91f9e428458605a0e9f582305dd12ef247i0",
        "icon_render_url": null,
        "avg_unit_price_in_sats": 30195.999999999996,
        "min_listed_unit_price_in_sats": 30233.581818181818,
        "min_listed_unit_price_unisat": 30233.582000000002,
        "listed_supply": "929250",
        "listed_supply_ratio": 0.00008363284858171289,
        "marketcap": 3355097127008,
        "total_sale_info": {
            "sale_count": 106570,
            "sale_count_3h": 0,
            "sale_count_6h": 1,
            "sale_count_9h": 1,
            "sale_count_12h": 73,
            "sale_count_1d": 205,
            "sale_count_3d": 413,
            "sale_count_7d": 1002,
            "sale_count_30d": 2583,
            "sale_amount": 77883929,
            "vol_3h": 0,
            "vol_6h": 126159,
            "vol_9h": 126159,
            "vol_12h": 1226131,
            "vol_1d": 4207823,
            "vol_3d": 16909211,
            "vol_7d": 51653484,
            "vol_30d": 220929558,
            "vol_total": 26566160622
        }
    },
    "block_height": 847620
}

Get Runes Sales Information

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/sales_info Returns sales and volume information about a specific runes ticker. Sample query: https://api.bestinslot.xyz/v3/runes/sales_info?rune_name=SATOSHINAKAMOTO&marketplace_type=unisat

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
marketplace_type	`string`	(optional) Filter only by a given marketplace. You can find the allowed types on Constants Page.

NOTE: One of rune_name, rune_id or rune_number must be specified

200: OK Success

{
    "data": {
        "marketplace": "all",
        "vol_3h": 7579717,
        "vol_6h": 15354385,
        "vol_9h": 24536418,
        "vol_12h": 43035106,
        "vol_1d": 63367091,
        "vol_3d": 149531954,
        "vol_7d": 397417106,
        "vol_30d": 2320019379,
        "vol_total": 12611770343,
        "sale_count": 55463, // how many sales have happened
        "sale_count_3h": 32,
        "sale_count_6h": 78,
        "sale_count_9h": 158,
        "sale_count_12h": 265,
        "sale_count_1d": 361,
        "sale_count_3d": 925,
        "sale_count_7d": 1915,
        "sale_count_30d": 8374,
        "sale_amount": 19261486 // the total amount of tokens sold
    },
    "block_height": 862524
}

Get Runes Market Information

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/market_info Returns market information about a specific runes ticker. Sample query: https://api.bestinslot.xyz/v3/runes/market_info?rune_name=SATOSHINAKAMOTO

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number

NOTE: One of rune_name, rune_id or rune_number must be specified

200: OK Success

{
    "data": {
        "marketcap": 71876303181,
        "min_listed_unit_price_in_sats": 3308.5,
        "min_listed_unit_price_unisat": 3308.5,
        "listed_supply": "35785835289050",
        "listed_supply_ratio": 0.017041117391700833
    },
    "block_height": 841495
}

Runes Listings

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/listings Returns listing information of a given rune. Sample query: https://api.bestinslot.xyz/v3/runes/listings?rune_id=840000:3&sort_by=min_unit_price&order=asc&offset=0&count=100

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
sort_by*	`string`	output, min_price, unisat_price
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 100

NOTE: One of rune_name, rune_id or rune_number must be specified. Response

200: OK Success

{
    "data": [
        {
            "outpoint": "e03a893219770a198903430634e998c2e7ccaf4fb7a4e8713421f2020822f54c:2",
            "owner_wallet_addr": "bc1pp7sp50mpsew65ax6x6vjymv7ltsv88xjlzuxnlruca3vkggnggxs43tak5",
            "amount": 5000000,
            "min_price": 26875200,
            "min_unit_price": 5.37504,
            "unisat_price": 26875200,
            "unisat_unit_price": 5.37504
        },
        ...
    ],
    "block_height": 840350
}

Runes Holders

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/holders Returns balances of holders of a given runes ticker. Sample query: https://api.bestinslot.xyz/v3/runes/holders?rune_name=UNCOMMONGOODS&sort_by=balance&order=desc&count=500&offset=0

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	int	(optional) Rune Number
sort_by*	`string`	currently only option is `balance`
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 500 (5000 for PRO Keys)

NOTE: One of rune_name, rune_id or rune_number must be specified Response

200: OK Success

{
    "data": [
        {
            "pkscript": "5120851d39de85d2454d267c707d18970fc9dc680fc237e42d1d271a01db230a0195",
            "wallet_addr": "bc1ps5wnnh596fz56fnuwp7339c0e8wxsr7zxljz68f8rgqakgc2qx2stuz5yu",
            "rune_id": "1:0",
            "total_balance": "10000",
            "rune_name": "UNCOMMONGOODS",
            "spaced_rune_name": "UNCOMMON•GOODS",
            "decimals": 0
        },
        ...
    ],
    "block_height": 840523
}

Runes Single Output Info

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/output_info Returns runes information about given bitcoin output. Sample query: https://api.bestinslot.xyz/v3/runes/output_info?output=314e5e53024ec5860bd2fa2a4e85db2fc9097fcf58caa63f253bb4f86ad4b412:1

Query Parameters

Name	Type	Description
output*	`string`	Outpoint to check runes information

Response

200: OK Success

{
    "data": {
        "pkscript": "512024034ada955f1716ed7833d56744bd08119355cf5b1bbdbc48e66bc357bdb3b7",
        "wallet_addr": "bc1pysp54k54tut3dmtcx02kw39apqgex4w0tvdmm0zgue4ux4aakwms3pumq8",
        "output": "4ee2151d7010574cadc749ce85ae813599c33fc62148a0352eaa946f2da1d2be:0",
        "rune_ids": [
            "840000:22"
        ],
        "balances": [
            "190000000000"
        ],
        "spent": false,
        "rune_names": [
            "SATOSHINAKAMOTO"
        ],
        "spaced_rune_names": [
            "SATOSHI•NAKAMOTO"
        ],
        "decimals": [
            8
        ]
    },
    "block_height": 840523
}

Runes Batch Output Info

Included in: Basic, Pro, Dedicated POST https://api.bestinslot.xyz/v3/runes/batch_output_info Returns runes information about given bitcoin outputs. Sample query:
url:
https://api.bestinslot.xyz/v3/runes/batch_output_info data:

&#123; "queries": [ "314e5e53024ec5860bd2fa2a4e85db2fc9097fcf58caa63f253bb4f86ad4b412:1", "0979edfb33fa380fb8c80e53809e9d865169ac6857688b31446d577d5f6df869:1", "200380702f43b2a6403bd9576c48e74e7cf184d5ead280eaa25a2d71be9cb2c8:1" ] &#125;

headers:
{ "Content-Type":"application/json", "x-api-key":"...." }

Request Body

Name	Type	Description
queries*	`array`	Array of outpoint strings Max length: 100

Response

200: OK Success

{
    "data": [
        {
            "pkscript": "512024034ada955f1716ed7833d56744bd08119355cf5b1bbdbc48e66bc357bdb3b7",
            "wallet_addr": "bc1pysp54k54tut3dmtcx02kw39apqgex4w0tvdmm0zgue4ux4aakwms3pumq8",
            "output": "4ee2151d7010574cadc749ce85ae813599c33fc62148a0352eaa946f2da1d2be:0",
            "rune_ids": [
                "840000:22"
            ],
            "balances": [
                "190000000000"
            ],
            "spent": false,
            "rune_names": [
                "SATOSHINAKAMOTO"
            ],
            "spaced_rune_names": [
                "SATOSHI•NAKAMOTO"
            ],
            "decimals": [
                8
            ]
        },
        ...
    ],
    "block_height": 840350
}

Runes Wallet Balances

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/wallet_balances Returns runes balance information about given bitcoin wallet address or pkscript. NOTE: avg_unit_price_in_sats and min_listed_unit_price_in_sats is scaled by decimals. Sample query: https://api.bestinslot.xyz/v3/runes/wallet_balances?address=tb1pd368q84tuark4naym2u5382p59jkd27nw5vu5s44uz8dwdlrcwhqzdl2l2

Query Parameters

Name	Type	Description
address	`string`	(optional) Bitcoin wallet address
pkscript	`string`	(optional) Bitcoin script_pub_key

NOTE: One of address or pkscript must be specified Response

200: OK Success

{
    "data": [
        {
            "pkscript": "512024034ada955f1716ed7833d56744bd08119355cf5b1bbdbc48e66bc357bdb3b7",
            "wallet_addr": "bc1pysp54k54tut3dmtcx02kw39apqgex4w0tvdmm0zgue4ux4aakwms3pumq8",
            "rune_id": "840000:22",
            "total_balance": "4120000000000",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "avg_unit_price_in_sats": 3422.7299999999996,
            "min_listed_unit_price_in_sats": 3308.5,
            "min_listed_unit_price_unisat": 3308.5
        },
        ...
    ],
    "block_height": 840350
}

Runes Wallet Valid Outputs

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/wallet_valid_outputs Returns unspent output information of a given wallet. Sample query: https://api.bestinslot.xyz/v3/runes/wallet_valid_outputs?pkscript=51206c74701eabe7476acfa4dab9489d41a16566abd37519ca42b5e08ed737e3c3ae&sort_by=output&order=asc&offset=0&count=2000

Query Parameters

Name	Type	Description
address	`string`	(optional) Bitcoin wallet address
pkscript	`string`	(optional) Bitcoin script_pub_key
sort_by*	`string`	output, min_price, unisat_price
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 2000

NOTE: One of address or pkscript must be specified Response

200: OK Success

{
    "data": [
        {
            "pkscript": "5120ef4a9ffbb9a627f495a3f224f0d728476890198813d97935febbc539a4a6608e",
            "wallet_addr": "bc1paa9fl7ae5cnlf9dr7gj0p4egga5fqxvgz0vhjd07h0znnf9xvz8qfsw3e8",
            "output": "2d69dca0ce6ff19dcd1bddaf56e3760c106a62832d81611c5aa0501966af7aa2:1",
            "rune_ids": [
                "840000:3"
            ],
            "balances": [
                "173424909679"
            ],
            "min_price": 9533514,
            "unisat_price": 9533514,
            "rune_names": [
                "DOGGOTOTHEMOON"
            ],
            "spaced_rune_names": [
                "DOG•GO•TO•THE•MOON"
            ],
            "decimals": [
                5
            ]
        },
        ...
    ],
    "block_height": 840350
}

Runes Wallet Valid Outputs Single Rune

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/wallet_valid_outputs_single_rune Returns unspent output information of a given wallet of a given rune. Sample query: https://api.bestinslot.xyz/v3/runes/wallet_valid_outputs_single_rune?address=bc1paa9fl7ae5cnlf9dr7gj0p4egga5fqxvgz0vhjd07h0znnf9xvz8qfsw3e8&sort_by=min_price&order=asc&offset=0&count=2000&rune_id=840000:3

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
address	`string`	(optional) Bitcoin wallet address
pkscript	`string`	(optional) Bitcoin script_pub_key
sort_by*	`string`	output, min_price, unisat_price
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 2000

NOTE: One of address or pkscript must be specified, one of rune_name, rune_id or rune_number must be specified Response

200: OK Success

{
    "data": [
        {
            "pkscript": "5120ef4a9ffbb9a627f495a3f224f0d728476890198813d97935febbc539a4a6608e",
            "wallet_addr": "bc1paa9fl7ae5cnlf9dr7gj0p4egga5fqxvgz0vhjd07h0znnf9xvz8qfsw3e8",
            "output": "2d69dca0ce6ff19dcd1bddaf56e3760c106a62832d81611c5aa0501966af7aa2:1",
            "rune_ids": [
                "840000:3"
            ],
            "balances": [
                "173424909679"
            ],
            "balance_of_rune": "173424909679",
            "min_price": 9533514,
            "min_unit_price": 5.497199922229171,
            "unisat_price": 9533514,
            "unisat_unit_price": 5.497199927995356,
            "rune_names": [
                "DOGGOTOTHEMOON"
            ],
            "spaced_rune_names": [
                "DOG•GO•TO•THE•MOON"
            ],
            "decimals": [
                5
            ]
        },
        ...
    ],
    "block_height": 840350
}

Runes Valid Outputs

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/valid_outputs Returns unspent output information of a given ticker. Sample query: https://api.bestinslot.xyz/v3/runes/valid_outputs?rune_name=UNCOMMONGOODS&sort_by=output&order=asc&offset=0&count=2000

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
sort_by*	`string`	output, amount, min_price, min_unit_price, unisat_price, unisat_unit_price
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 2000

NOTE: One of rune_name, rune_id or rune_number must be specified Response

200: OK Success

{
    "data": [
        {
            "output": "ccb6b5af0499b6626928e2c7aa4c725307fea8ae6dd89fea1ee34bc6e58ecb78:2",
            "pkscript": "512059097d303921cee03ed48b99637ce90c446576b5c89ac85371a44a08a96c7860",
            "wallet_addr": "bc1ptyyh6vpey88wq0k53wvkxl8fp3zx2a44ezdvs5m3539q32tv0psq4k86ef",
            "rune_ids": [
                "840000:22"
            ],
            "balances": [
                "60000000000"
            ],
            "balance_of_rune": "60000000000",
            "min_price": 1985100,
            "min_unit_price": 3308.5,
            "unisat_price": 1985100,
            "unisat_unit_price": 3308.5,
            "rune_names": [
                "SATOSHINAKAMOTO"
            ],
            "spaced_rune_names": [
                "SATOSHI•NAKAMOTO"
            ],
            "decimals": [
                8
            ]
        },
        ...
    ],
    "block_height": 840523
}

Runes Wallet Activity

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/wallet_activity Returns runes activity of a given wallet. If the given wallet is involved in a runes transaction, all activity in the transaction will be returned (even if that activity is an input/output to a different wallet) The endpoint includes an optional rune filter. You can leave the parameters rune_name, rune_id, and rune_number blank to retrieve all wallet activity. Alternatively, you may supply at most one of these parameters to filter transactions where one of the events in the tx involves both the specified wallet and rune. If optional runes_filter_only_wallet parameter is set to true, the endpoint only returns the runes events with the selected wallet. Otherwise it also includes the other runes events in the transaction. Sample query: https://api.bestinslot.xyz/v3/runes/wallet_activity?pkscript=51206c74701eabe7476acfa4dab9489d41a16566abd37519ca42b5e08ed737e3c3ae&sort_by=ts&order=desc&offset=0&count=2000

Query Parameters

Name	Type	Description
address	`string`	(optional) Bitcoin wallet address
pkscript	`string`	(optional) Bitcoin script_pub_key
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
sort_by*	`string`	currently only option is `ts` (timestamp)
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 2000
runes_filter_only_wallet	`string`	(optional) “true” or “false”

NOTE: One of address or pkscript must be specified Response

200: OK Success

{
    "data": [
        {
            "event_type": "output",
            "txid": "6f77a8234c74559c2fa74b604bb8318a6811c288591b07e95adc381eb363320e",
            "outpoint": "6f77a8234c74559c2fa74b604bb8318a6811c288591b07e95adc381eb363320e:0",
            "pkscript": "512088de610b5857285c27fb45369ec8d4c56cf59b4b67ddebc9a7898987e7f82dcd",
            "wallet_addr": "bc1p3r0xzz6c2u59cflmg5mfajx5c4k0tx6tvlw7hjd83xyc0elc9hxslysx6c",
            "rune_id": "840000:22",
            "amount": "560000000000",
            "block_height": 840407,
            "block_timestamp": "2024-04-22T22:15:00.000Z",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "sale_info": null,
            "icon_content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/f753cefb770bf69369d33e93fbc9271f8dc877cb4819cbdd9d766f3509062e43i0",
            "icon_render_url": null
        },
        {
            "event_type": "input",
            "txid": "6f77a8234c74559c2fa74b604bb8318a6811c288591b07e95adc381eb363320e",
            "outpoint": "a914c7f595f6baac8e1d81b6cc3f0242607fa7686fabe04888f8c4f76927ab60:0",
            "pkscript": "512024034ada955f1716ed7833d56744bd08119355cf5b1bbdbc48e66bc357bdb3b7",
            "wallet_addr": "bc1pysp54k54tut3dmtcx02kw39apqgex4w0tvdmm0zgue4ux4aakwms3pumq8",
            "rune_id": "840000:22",
            "amount": "560000000000",
            "block_height": 840407,
            "block_timestamp": "2024-04-22T22:15:00.000Z",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "sale_info": {
                "sale_price": 42560000,
                "sold_to_pkscript": "512088de610b5857285c27fb45369ec8d4c56cf59b4b67ddebc9a7898987e7f82dcd",
                "sold_to_wallet_addr": "bc1p3r0xzz6c2u59cflmg5mfajx5c4k0tx6tvlw7hjd83xyc0elc9hxslysx6c",
                "marketplace": "okx"
            },
            "icon_content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/f753cefb770bf69369d33e93fbc9271f8dc877cb4819cbdd9d766f3509062e43i0",
            "icon_render_url": null
        },
        ...
    ],
    "block_height": 840350
}

Runes Activity of a Ticker

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/activity Returns activity of a given ticker. Sample query: https://api.bestinslot.xyz/v3/runes/activity?rune_name=UNCOMMONGOODS&sort_by=ts&order=desc&offset=0&count=2000

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
sort_by*	`string`	output, amount
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 2000

NOTE: One of rune_name, rune_id or rune_number must be specified Response

200: OK Success

{
    "data": [
        {
            "event_type": "output",
            "txid": "fa510ec0930c3eb4db1a92a84b237a10277db21e6fa4f3969c7bf8af5e73e4b6",
            "outpoint": "fa510ec0930c3eb4db1a92a84b237a10277db21e6fa4f3969c7bf8af5e73e4b6:1",
            "pkscript": "51209f8b1cf14c997a807d2c1509b39ff6f5f9d5b24cfd6dca5bba113ae995c840a1",
            "wallet_addr": "bc1pn793eu2vn9agqlfvz5ym88lk7huatvjvl4ku5ka6zyawn9wggzssv5n2ky",
            "rune_id": "840000:22",
            "amount": "200000000000",
            "block_height": 840350,
            "block_timestamp": "2024-04-22T13:46:20.000Z",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "sale_info": null
        },
        {
            "event_type": "input",
            "txid": "fa510ec0930c3eb4db1a92a84b237a10277db21e6fa4f3969c7bf8af5e73e4b6",
            "outpoint": "1512857dabb0f6b7b2cdf9dfa867aa3e96eaa38bdc23527878c8de1e9c6fe7e3:2",
            "pkscript": "5120242129034b44bcc2c806cbb04ea34c43fb26b74c7429991e233ccb6bf046c821",
            "wallet_addr": "bc1pyssjjq6tgj7v9jqxewcyag6vg0ajdd6vws5ej83r8n9khuzxeqssp55n7m",
            "rune_id": "840000:22",
            "amount": "200000000000",
            "block_height": 840350,
            "block_timestamp": "2024-04-22T13:46:20.000Z",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "sale_info": {
                "sale_price": 15754000,
                "sold_to_pkscript": "51209f8b1cf14c997a807d2c1509b39ff6f5f9d5b24cfd6dca5bba113ae995c840a1",
                "sold_to_wallet_addr": "bc1pn793eu2vn9agqlfvz5ym88lk7huatvjvl4ku5ka6zyawn9wggzssv5n2ky",
                "marketplace": "unisat"
            }
        },
        ...
    ],
    "block_height": 840350
}

Runes Activity in a Single Tx

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/events_on_tx Returns runes activity on a given bitcoin transaction. Sample query: https://api.bestinslot.xyz/v3/runes/events_on_tx?txid=e49f0912f94b915c0dd12b7970083b348945c2fc7bc01a21e0bfa403827607cf

Query Parameters

Name	Type	Description
txid*	`string`	Bitcoin txid

Response

200: OK Success

{
    "data": [
        {
            "event_type": "input",
            "txid": "34ff792cf5a50666fabfb8c2acc9ef8da9e5d180ab813713ad051d4117124333",
            "outpoint": "fa76b47040e0ed571030bff83713205167b6d1d2acba3bbb5f8fbaea09a4d4f9:0",
            "pkscript": "0014752451874597e90865c6e9b886b8640a36e82201",
            "wallet_addr": "bc1qw5j9rp69jl5ssewxaxugdwrypgmwsgspqhhttg",
            "rune_id": "840000:22",
            "amount": "20000000000",
            "block_height": 840336,
            "block_timestamp": "2024-04-22T11:47:44.000Z",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "sale_info": {
                "sale_price": 1573800,
                "sold_to_pkscript": "5120e571909d0434b191f33cfcd7eb99f06e42a808594839fa7221594e86e212433b",
                "sold_to_wallet_addr": "bc1pu4cep8gyxjcerueulnt7hx0sdep2szzefqul5u3pt98gdcsjgvas8gtgrk",
                "marketplace": "unisat"
            }
        },
        {
            "event_type": "output",
            "txid": "34ff792cf5a50666fabfb8c2acc9ef8da9e5d180ab813713ad051d4117124333",
            "outpoint": "34ff792cf5a50666fabfb8c2acc9ef8da9e5d180ab813713ad051d4117124333:1",
            "pkscript": "5120e571909d0434b191f33cfcd7eb99f06e42a808594839fa7221594e86e212433b",
            "wallet_addr": "bc1pu4cep8gyxjcerueulnt7hx0sdep2szzefqul5u3pt98gdcsjgvas8gtgrk",
            "rune_id": "840000:22",
            "amount": "20000000000",
            "block_height": 840336,
            "block_timestamp": "2024-04-22T11:47:44.000Z",
            "rune_name": "SATOSHINAKAMOTO",
            "spaced_rune_name": "SATOSHI•NAKAMOTO",
            "decimals": 8,
            "sale_info": null
        }
    ],
    "block_height": 840350
}

Runes Historical Total Supply

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/runes/historical_total_supply Returns historical total supply for selected rune in selected block height. Sample query: https://api.bestinslot.xyz/v3/runes/historical_total_supply?rune_name=UNCOMMONGOODS&block_height=860000

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
block_height*	`int`	Bitcoin block height

NOTE: One of rune_name, rune_id or rune_number must be specified Response

200: OK Success

{
    "data": {
        "total_supply": "26035948",
        "block_height": "860000",
        "rune_id": "1:0",
        "decimals": 0
    },
    "block_height": 889396
}

Runes All Activity on Block Height

Included in: Enterprise, Dedicated with Enterprise Endpoints GET https://api.bestinslot.xyz/v3/runes/activity_on_block Returns all runes activity in a given block height. Sample query: https://api.bestinslot.xyz/v3/runes/activity_on_block?block_height=840000

Query Parameters

Name	Type	Description
block_height*	`string`	Bitcoin block height

Response

200: OK Success

{
    "data": [
        {
            "event_type": "input",
            "txid": "e712da809a70f59067c3a65c16f7337079a1113e0072acbef50d96b4af9751a0",
            "outpoint": "6aea2e2992a65c1974c76a06a87412939b7629c884d07f1d8b09a531e45a32f9:1",
            "pkscript": "51201ac61709cc243d38f261a864fe9182e84b1b16df768a16077766e85942a9d1aa",
            "wallet_addr": "bc1prtrpwzwvys7n3unp4pj0ayvzap93k9klw69pvpmhvm59js4f6x4qy70yt8",
            "rune_id": "840000:453",
            "amount": "6666",
            "block_height": 840163,
            "block_timestamp": "2024-04-21T05:48:31.000Z",
            "rune_name": "ORDINALSAREDEAD",
            "spaced_rune_name": "ORDINALS•ARE•DEAD",
            "decimals": 0,
            "sale_info": {
                "sale_price": 79992,
                "sold_to_pkscript": "0014878ff1580d7ceedcd97e1b3cfa7cc0feef2b8f4d",
                "sold_to_wallet_addr": "bc1qs78lzkqd0nhdekt7rv705lxqlmhjhr6dggcdr4",
                "marketplace": "okx"
            }
        },
        {
            "event_type": "output",
            "txid": "e712da809a70f59067c3a65c16f7337079a1113e0072acbef50d96b4af9751a0",
            "outpoint": "e712da809a70f59067c3a65c16f7337079a1113e0072acbef50d96b4af9751a0:0",
            "pkscript": "0014878ff1580d7ceedcd97e1b3cfa7cc0feef2b8f4d",
            "wallet_addr": "bc1qs78lzkqd0nhdekt7rv705lxqlmhjhr6dggcdr4",
            "rune_id": "840000:453",
            "amount": "6666",
            "block_height": 840163,
            "block_timestamp": "2024-04-21T05:48:31.000Z",
            "rune_name": "ORDINALSAREDEAD",
            "spaced_rune_name": "ORDINALS•ARE•DEAD",
            "decimals": 0,
            "sale_info": null
        },
        {
            "event_type": "mint",
            "txid": "82a0b948440e0ba893211fb68805f32ce3f62106a7c688851790769dc8b99ecd",
            "outpoint": null,
            "pkscript": null,
            "wallet_addr": null,
            "rune_id": "840000:453",
            "amount": "6666",
            "block_height": 840163,
            "block_timestamp": "2024-04-21T05:48:31.000Z",
            "rune_name": "ORDINALSAREDEAD",
            "spaced_rune_name": "ORDINALS•ARE•DEAD",
            "decimals": 0,
            "sale_info": null
        },
        ...
    ],
    "block_height": 2585298
}

Runes All ID Name Pairs

Included in: Enterprise, Dedicated with Enterprise Endpoints GET https://api.bestinslot.xyz/v3/runes/all_id_name_pairs Returns all runes id-name pairs

If send_urls is set to true, we’ll also return content and render urls for rune icon. Response will include render_prefix, render_suffix, content_prefix, content_suffix and r and ic fields in data array. r denotes if render is available and urls are constructed using prefix + ic + suffix.

Sample query: https://api.bestinslot.xyz/v3/runes/all_id_name_pairs

Query Parameters

Name	Type	Description
send_urls	`string`	(optional) “true” or “false”

Response

200: OK Success

{
    "data": [
        {
            "i": "840076:2046",
            "n": "HONEYBADGERDONTCARE",
            "sn": "HONEY•BADGER•DONT•CARE"
        },
        {
            "i": "841393:349",
            "n": "BIRDFOURTWOZEROSEVEN",
            "sn": "BIRD•FOUR•TWO•ZERO•SEVEN"
        },
        ...
    ],
    "block_height": 862525
}

Runes Historical Prices

Included in: Dedicated GET https://api.bestinslot.xyz/v3/runes/historical_prices Returns all historical prices for selected rune If granularity is set to 1d, it’ll return the average price for the day. Sample query: https://api.bestinslot.xyz/v3/runes/historical_prices?sort_by=ts&order=desc&offset=0&count=2000&rune_id=1:0

Query Parameters

Name	Type	Description
rune_name	`string`	(optional) Non-Spaced name of Rune
rune_id	`string`	(optional) Rune ID
rune_number	`int`	(optional) Rune Number
sort_by*	`string`	ts
order*	`string`	asc, desc
offset*	`int`	0 <= offset
count*	`int`	20 <= count <= 2000
granularity	`string`	(Optional) “1h” or “1d”

NOTE: One of rune_name, rune_id or rune_number must be specified Response

200: OK Success

{
    "data": [
        {
            "timestamp": "2024-09-23T13:00:00.000Z",
            "price": 230.664,
            "volume": 119296
        },
        {
            "timestamp": "2024-09-23T12:00:00.000Z",
            "price": 231.1305896319747,
            "volume": 4266653
        },
        {
            "timestamp": "2024-09-23T11:00:00.000Z",
            "price": 235,
            "volume": 1031318
        },
        {
            "timestamp": "2024-09-23T10:00:00.000Z",
            "price": 235,
            "volume": 2650313
        },
        {
            "timestamp": "2024-09-23T09:00:00.000Z",
            "price": 235,
            "volume": 3747853
        },
        {
            "timestamp": "2024-09-23T08:00:00.000Z",
            "price": 238,
            "volume": 1376502
        },
        {
            "timestamp": "2024-09-23T07:00:00.000Z",
            "price": 238,
            "volume": 5254130
        },
        ...
    ],
    "block_height": 862525
}

​Terminology

​Runes Testnet4 Faucet (only on testnet)

​Query Parameters

​Runes Tickers

​Query Parameters

​Runes Ticker Count

​Runes Single Ticker Info

​Query Parameters

​Get Runes Sales Information

​Query Parameters

​Get Runes Market Information

​Query Parameters

​Runes Listings

​Query Parameters

​Runes Holders

​Query Parameters

​Runes Single Output Info

​Query Parameters

​Runes Batch Output Info

​Request Body

​Runes Wallet Balances

​Query Parameters

​Runes Wallet Valid Outputs

​Query Parameters

​Runes Wallet Valid Outputs Single Rune

​Query Parameters

​Runes Valid Outputs

​Query Parameters

​Runes Wallet Activity

​Query Parameters

​Runes Activity of a Ticker

​Query Parameters

​Runes Activity in a Single Tx

​Query Parameters

​Runes Historical Total Supply

​Query Parameters

​Runes All Activity on Block Height

​Query Parameters

​Runes All ID Name Pairs

​Query Parameters

​Runes Historical Prices

​Query Parameters

Terminology

Runes Testnet4 Faucet (only on testnet)

Query Parameters

Runes Tickers

Query Parameters

Runes Ticker Count

Runes Single Ticker Info

Query Parameters

Get Runes Sales Information

Query Parameters

Get Runes Market Information

Query Parameters

Runes Listings

Query Parameters

Runes Holders

Query Parameters

Runes Single Output Info

Query Parameters

Runes Batch Output Info

Request Body

Runes Wallet Balances

Query Parameters

Runes Wallet Valid Outputs

Query Parameters

Runes Wallet Valid Outputs Single Rune

Query Parameters

Runes Valid Outputs

Query Parameters

Runes Wallet Activity

Query Parameters

Runes Activity of a Ticker

Query Parameters

Runes Activity in a Single Tx

Query Parameters

Runes Historical Total Supply

Query Parameters

Runes All Activity on Block Height

Query Parameters

Runes All ID Name Pairs

Query Parameters

Runes Historical Prices

Query Parameters