Runes

Endpoints related with Runes Protocol.

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

NOTE: Mainnet endpoints are now enabled. To use on testnet/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 Testnet 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

NameTypeDescription

address*

string

Testnet Bitcoin wallet address

Response

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

NameTypeDescription

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

{
    "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": 88671,
                "sale_amount": 60515487,
                "vol_3h": 46883666,
                "vol_6h": 55076692,
                "vol_9h": 69955096,
                "vol_12h": 79814633,
                "vol_1d": 155351235,
                "vol_3d": 383191133,
                "vol_7d": 834465365,
                "vol_30d": 4641117038,
                "vol_total": 23437969791
            }
        },
        ...
    ],
    "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

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

NameTypeDescription

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

{
    "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": 88671,
            "sale_amount": 60515487,
            "vol_3h": 46883666,
            "vol_6h": 55076692,
            "vol_9h": 69955096,
            "vol_12h": 79814633,
            "vol_1d": 155351235,
            "vol_3d": 383191133,
            "vol_7d": 834465365,
            "vol_30d": 4641117038,
            "vol_total": 23437969791
        }
    },
    "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

NameTypeDescription

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

{
    "data": {
        "marketplace": "all",
        "vol_3h": 713900245,
        "vol_6h": 1459898195,
        "vol_9h": 2256294639,
        "vol_12h": 2933104567,
        "vol_1d": 6890341581,
        "vol_3d": 35832513900,
        "vol_7d": 35832513900,
        "vol_30d": 35832513900,
        "vol_total": 35832513900,
        "sale_count": 25952, // how many sales have happened
        "sale_amount": 435369556720037 // the total amount of tokens sold
    },
    "block_height": 840338
}

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

NameTypeDescription

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

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

NameTypeDescription

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

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

NameTypeDescription

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

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

NameTypeDescription

output*

string

Outpoint to check runes information

Response

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

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

Request Body

NameTypeDescription

queries*

array

Array of outpoint strings Max length: 100

Response

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

NameTypeDescription

address

string

(optional) Bitcoin wallet address

pkscript

string

(optional) Bitcoin script_pub_key

NOTE: One of address or pkscript must be specified

Response

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

NameTypeDescription

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

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

NameTypeDescription

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

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

NameTypeDescription

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

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

NameTypeDescription

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

{
    "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
        },
        {
            "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"
            }
        },
        ...
    ],
    "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

NameTypeDescription

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

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

NameTypeDescription

txid*

string

Bitcoin txid

Response

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

NameTypeDescription

block_height*

string

Bitcoin block height

Response

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

Last updated