Runes

Endpoints related to Runes Protocol.

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 <= 100
minting_status	string	(optional) set to "not_complete" for searching only the tickers with mintable = true set to "completed" for searching only the tickers with mintable = false leave unset to search within all tickers

Response

200: OK Success

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

429: Too Many Requests Rate limit exceeded

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.

NOTE: 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

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

429: Too Many Requests Rate limit exceeded

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
}

429: Too Many Requests Rate limit exceeded

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
}

429: Too Many Requests Rate limit exceeded

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: { "queries": [ "314e5e53024ec5860bd2fa2a4e85db2fc9097fcf58caa63f253bb4f86ad4b412:1", "0979edfb33fa380fb8c80e53809e9d865169ac6857688b31446d577d5f6df869:1", "200380702f43b2a6403bd9576c48e74e7cf184d5ead280eaa25a2d71be9cb2c8:1" ] }

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.

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

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 All Activity on Block Height

Included in: Enterprise, Dedicated

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
}

200: OK Success

Runes All ID Name Pairs

Included in: Enterprise, Dedicated

GET https://api.bestinslot.xyz/v3/runes/all_id_name_pairs

Returns all runes id-name pairs

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

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

Sample query: https://api.bestinslot.xyz/v3/runes/historical_prices?sort_by=ts&order=desc&offset=0&count=2000&rune_id=1:0

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
}