Wallets

Endpoints related to Bitcoin Wallets.

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

BTC Testnet4 Faucet (only on testnet)

Included in: Basic, Pro, Dedicated

GET https://testnet.api.bestinslot.xyz/v3/wallet/testnet_faucet

A testnet BTC faucet that mints 0.01 tBTC to target address.

NOTE: Limited with 10 request per 24 hours per key.

Sample query: https://testnet.api.bestinslot.xyz/v3/wallet/testnet_faucet?address=tb1p9ts4eu2s4adgjwumdmcu9qfw0hcavrh8m54tyrd39lkk7h4940yq2dmvzx

Query Parameters

Name
Type
Description

address*

string

Testnet Bitcoin wallet address

Response

{
    "transfer_txid": "d32bb47c7728dbe89289694a54827ecabd8052a5e6c1475ac5a126986e79be1b"
}

Get Wallet Inscriptions

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/wallet/inscriptions

Returns ordered list of inscriptions of a wallet.

Sample query: https://api.bestinslot.xyz/v3/wallet/inscriptions?address=bc1p9ckplx7pesuh396he7nk0qzxrhyewd2ytrz9s2444dkl2c8gerdsrq7xjd&sort_by=inscr_num&order=desc&offset=0&count=2000&exclude_brc20=true&cursed_only=true

NOTE: last_sale_price is only available on Pro Tier.

Query Parameters

Name
Type
Description

sort_by*

string

inscr_num

order*

string

asc, desc

offset*

int

0 <= offset

count*

int

20 <= count <= 2000

address*

string

bitcoin wallet address

exclude_brc20

bool

(optional) set to true to exclude brc-20 inscriptions

cursed_only

bool

(optional) set to true to return only cursed inscriptions

{
    "data": [
        {
            "inscription_name": "Runestone",
            "inscription_id": "c1731231b40c1bf0a7d5c06659067f276e6d4db2980bdc29f18938c7dbfd256ai1135",
            "inscription_number": 64542114,
            "parent_ids": [
                "fdb2df5d2b16db1ebcbf09e2d23b3f4e417db44b58e712c99b61f26b52c7cbb5i0"
            ],
            "output_value": 330,
            "genesis_block_hash": "000000000000000000018ddf8a6484db391fb85c9f9ddc384f03a92729423aaf",
            "genesis_ts": "2024-04-13T04:25:01.000Z",
            "metadata": {
                "name": "Runestone"
            },
            "owner_wallet_addr": "bc1pp5xk5dxklrfxk4yzdkel09yeqqczk5s3425zg9fj6p8qpm8axdes94yhu7",
            "mime_type": "model/gltf+json",
            "last_sale_price": 3950000,
            "slug": "runestone",
            "collection_name": "Runestone",
            "satpoint": "b5567d810d09a61a373f8cbec32322a4c42aa5ff2c163d5eb284aa52c9a0ffff:7:0",
            "last_transfer_block_height": 836794,
            "genesis_height": 834864,
            "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/c1731231b40c1bf0a7d5c06659067f276e6d4db2980bdc29f18938c7dbfd256ai1135",
            "bis_url": "https://bestinslot.xyz/ordinals/inscription/c1731231b40c1bf0a7d5c06659067f276e6d4db2980bdc29f18938c7dbfd256ai1135",
            "render_url": null,
            "bitmap_number": null,
            "delegate": {
                "delegate_id": "ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
                "render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0.png",
                "mime_type": "model/gltf+json",
                "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0",
                "bis_url": "https://bestinslot.xyz/ordinals/inscription/ed76bf35918948b8b78be0e6397ad4916d926dd3d65679a8b7e67d8699a672a0i0"
            }
        },
        ...
    ],
    "block_height": 795034
}

Get Batch Wallet Inscriptions

Included in: Pro, Dedicated

POST https://api.bestinslot.xyz/v3/wallet/inscriptions_batch

Returns ordered list of inscriptions of given wallets (up to 100 wallet).

Sample query: url: https://api.bestinslot.xyz/v3/wallet/inscriptions_batch data: {"addresses":["bc1pfxhh3yh5pp4s8pf6wjthe5dwsl6nva04n8zdsw4wsnq76kpy2fsqxgse5d","bc1psrvymaz9gx4ljw0x4lpsscrsh2xy8u4yx0ru9z8spdjsgp99qchsaawzw4","bc1pqvkxuvy6cquv0x9kggy0c3skavmwh2arr22xghxae6pqwq4jk4gqw6dpu9"],"offset":0,"count":2000,"sort_by":"inscr_num","order":"desc"} headers: { "Content-Type":"application/json", "x-api-key":"...." }

Query Parameters

Name
Type
Description

sort_by

string

(optional) inscr_num

order

string

(optional) asc, desc (default: desc)

offset*

int

0 <= offset

count*

int

20 <= count <= 2000

addresses*

array of strings

bitcoin wallet addresses

exclude_brc20

string

(optional) set to "true" (string) to exclude brc-20 inscriptions

cursed_only

string

(optional) set to "true" (string) to return only cursed inscriptions

{
    "data": [
        {
            "inscription_name": "ExO Recruits #18240",
            "inscription_id": "4b0eb4278a1e65ccf9be4935bc2f9cfded27c27ce809b8227792553492053ce1i351",
            "inscription_number": 70590889,
            "parent_ids": [
                "9d71fc47daede70dde1dd4af7cdfffac18627f797d7542880ec6db2107ad62b6i0"
            ],
            "output_value": 330,
            "genesis_block_hash": "0000000000000000000042ca43ef13023e048bc83f634778dc737c5f9506e122",
            "genesis_ts": "2024-08-19T03:12:01.000Z",
            "metadata": {
                "name": "ExO Recruits #18240",
                "attributes": [
                    {
                        "value": "The Mad Scientist",
                        "trait_type": "Recruit name"
                    },
                    {
                        "value": "14",
                        "trait_type": "batch"
                    }
                ]
            },
            "owner_wallet_addr": "bc1pp5xk5dxklrfxk4yzdkel09yeqqczk5s3425zg9fj6p8qpm8axdes94yhu7",
            "mime_type": "text/plain;charset=utf-8",
            "last_sale_price": null,
            "slug": "exo_recruits",
            "collection_name": "ExO Recruits",
            "satpoint": "4b0eb4278a1e65ccf9be4935bc2f9cfded27c27ce809b8227792553492053ce1:352:0",
            "last_transfer_block_height": 841691,
            "genesis_height": 841691,
            "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/4b0eb4278a1e65ccf9be4935bc2f9cfded27c27ce809b8227792553492053ce1i351",
            "bis_url": "https://bestinslot.xyz/ordinals/inscription/4b0eb4278a1e65ccf9be4935bc2f9cfded27c27ce809b8227792553492053ce1i351",
            "render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/4b0eb4278a1e65ccf9be4935bc2f9cfded27c27ce809b8227792553492053ce1i351.png",
            "bitmap_number": null,
            "delegate": {
                "delegate_id": "68dddf6c9fbede5b4f6e014149946517685c4aea79250051575cb68136e8d3d9i0",
                "render_url": "https://bis-ord-renders.fra1.cdn.digitaloceanspaces.com/renders/68dddf6c9fbede5b4f6e014149946517685c4aea79250051575cb68136e8d3d9i0.png",
                "mime_type": "text/html;charset=utf-8",
                "content_url": "https://bis-ord-content.fra1.cdn.digitaloceanspaces.com/ordinals/68dddf6c9fbede5b4f6e014149946517685c4aea79250051575cb68136e8d3d9i0",
                "bis_url": "https://bestinslot.xyz/ordinals/inscription/68dddf6c9fbede5b4f6e014149946517685c4aea79250051575cb68136e8d3d9i0"
            }
        },
        ...
    ],
    "block_height": 849817
}

Get Wallet Verified Sats

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/wallet/sats_names

Returns list of verified sats names of a wallet.

Sample query: https://api.bestinslot.xyz/v3/wallet/sats_names?address=bc1p4wj6n9c80zvrjwq3lke2n8esuv8rzw6ch0jlqfrlpanlyn3ftx2s6dgwec

Query Parameters

Name
Type
Description

address*

string

bitcoin wallet address

{
    "data": [
        {
            "name": "aui.sats",
            "inscription_id": "8279ab4057df0fcee4eb7c0047acc2f3de3fbd84bd149b0d8f5e4af95988fe13i0",
            "inscription_number": 264143
        },
        ...
    ],
    "block_height": 795034
}

Get Wallet Listings

Included in: Pro, Dedicated

GET https://api.bestinslot.xyz/v3/wallet/listings

Returns ordered list of listings of a bitcoin wallet.

Sample query: https://api.bestinslot.xyz/v3/wallet/listings?address=bc1par0t76nmjf55wp0rpzu58p97mzz6tf3cd67js077a2qx5ez8knlqfnccjq&sort_by=min_price&order=asc&offset=0&count=100

Query Parameters

Name
Type
Description

sort_by*

string

min_price, ordswap_price, magiceden_price, ordinalswallet_price, gammaio_price, odynals_price, unisat_price, ordinalsmarket_price, okx_price

order*

string

asc, desc

offset*

int

0 <= offset <= 5k

count*

int

20 <= count <= 100

address*

string

bitcoin wallet address

{
    "data": [
        {
            "inscription_id": "2506d91d5f9827da5aa604dcf38918317ad58e884be269e823706ebd330758cfi0",
            "min_price": 999993,
            "ordswap_price": null,
            "magiceden_price": null,
            "ordinalswallet_price": 999993,
            "gammaio_price": null,
            "nostr_price": null,
            "odynals_price": null,
            "unisat_price": null,
            "ordinalsmarket_price": null,
            "okx_price": null,
            "owner_wallet_addr": "bc1par0t76nmjf55wp0rpzu58p97mzz6tf3cd67js077a2qx5ez8knlqfnccjq"
        },
        ...
    ],
    "block_height": 795035
}

Get Wallet Activity (Inscriptions Only)

Included in: Pro, Dedicated

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

Returns ordered list of inscribes, sales and transfers of a bitcoin wallet.

Sample query: https://api.bestinslot.xyz/v3/wallet/activity?address=bc1par0t76nmjf55wp0rpzu58p97mzz6tf3cd67js077a2qx5ez8knlqfnccjq&activity_filter=7&sort_by=ts&order=desc&offset=0&count=100

Query Parameters

Name
Type
Description

sort_by*

string

ts

order*

string

asc, desc

offset*

int

0 <= offset <= 5k

count*

int

20 <= count <= 100

address*

string

bitcoin wallet address

activity_filter*

int

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

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

Get Wallet Global Activity (Inscriptions, BRC20 and Runes)

Included in: Dedicated

GET https://api.bestinslot.xyz/v3/wallet/global_activity

Returns ordered list of inscription, brc20 and runes activities of bitcoin wallet. This endpoint is the combined view of: /v3/wallet/activity, /v3/brc20/wallet_activity and /v3/runes/wallet_activity

Response will have mixed structures since different protocols require different fields.

InscriptionStructure: {
  event_category: 'inscription',
  event_type: 'inscribe' | 'transfer' | 'buy' | 'sell',
  inscription_id,
  tx_id,
  new_satpoint,
  from_wallet, to_wallet,
  block_height, ts,
  amount: 1,
  sale_price,
  unit_price: same as sale_price for this type,
  marketplace_type: marketplace_type on Constants tab,
  inner_id: for debugging purposes
}
BRC20Structure: {
  event_category: 'brc20',
  event_type: 'deploy-inscribe' | 'mint-inscribe' | 'transfer-inscribe' | 'transfer-transfer',
  inscription_id,
  tx_id,
  new_satpoint,
  from_wallet, to_wallet,
  block_height, ts,
  amount,
  sale_price,
  unit_price,
  marketplace_type: marketplace_type on Constants tab,
  ticker,
  inner_id: for debugging purposes
}
RunesStructure: {
  event_category: 'runes',
  event_type: 'input' | 'new-allocation' | 'mint' | 'output' | 'burn',
  outpoint,
  tx_id,
  wallet_addr,
  block_height, ts,
  amount,
  sale_price,
  sold_to_wallet_addr,
  marketplace_type: marketplace_type on Constants tab,
  rune_id, rune_name, spaced_rune_name, decimals,
  inner_id: for debugging purposes
}

For runes events response structure, please check /v3/runes/wallet_activity endpoint details.

Since a single runes transaction can have a lot of runes events, if the last runes event does not fit into count, the endpoint will return all events in the tx anyway. So, the response may have more elements than count.

Sample query: https://api.bestinslot.xyz/v3/wallet/global_activity?address=bc1pg7j3rwqnjfsrj66gcgtfx99c6l3vnrs9v7arx3kpjmh9ukmv47wq0jdgg0&sort_by=ts&order=desc&count=500&cursor=384298391__14396391

Query Parameters

Name
Type
Description

sort_by*

string

ts

order*

string

asc, desc

count*

int

20 <= count <= 500

address*

string

bitcoin wallet address

cursor

string

to continue fetching data, use the cursor on last response

{
    "data": {
        "cursor": "1117389_32620821_11504547",
        "result": [
            {
                "event_category": "inscription",
                "event_type": "transfer",
                "inscription_id": "382c9ce1b42bec9fff3c20cd450ea22f0f7c538824dcebb16e09028b486bf5a4i530",
                "tx_id": "f9b6dbe3012fb83eebd4f475d3802650f54192226d40d8dab8ef8645586cda82",
                "new_satpoint": "f9b6dbe3012fb83eebd4f475d3802650f54192226d40d8dab8ef8645586cda82:0:0",
                "from_wallet": "bc1pjlqse9nd2q45lauevagerrka3vnmq5ksnph7muztuhkl0d26kgusj9n42c",
                "to_wallet": "bc1pg7j3rwqnjfsrj66gcgtfx99c6l3vnrs9v7arx3kpjmh9ukmv47wq0jdgg0",
                "block_height": 842074,
                "ts": "2024-05-04T15:29:49.000Z",
                "amount": 1,
                "sale_price": -1,
                "unit_price": -1,
                "marketplace_type": "",
                "inner_id": 379499237
            },
            {
                "event_category": "runes",
                "event_type": "output",
                "outpoint": "592ce71f4c962a18565c1d7db5336f956d5af48d2b46b21d19c001b79272d565:0",
                "tx_id": "592ce71f4c962a18565c1d7db5336f956d5af48d2b46b21d19c001b79272d565",
                "wallet_addr": "bc1pg7j3rwqnjfsrj66gcgtfx99c6l3vnrs9v7arx3kpjmh9ukmv47wq0jdgg0",
                "block_height": 841974,
                "ts": "2024-05-03T22:37:46.000Z",
                "amount": "2280",
                "sale_price": null,
                "sold_to_wallet_addr": null,
                "marketplace_type": "unindexed",
                "rune_id": "841599:714",
                "rune_name": "BUTTERNUTTHEHELLCAT",
                "spaced_rune_name": "BUTTERNUT•THE•HELL•CAT",
                "decimals": 0,
                "inner_id": 13122494
            },
            {
                "event_category": "runes",
                "event_type": "input",
                "outpoint": "6c7ebb818b94bc3c68e6681fde4bfc4a726a9bf002ca7400fb703cb9f0fe3539:2",
                "tx_id": "592ce71f4c962a18565c1d7db5336f956d5af48d2b46b21d19c001b79272d565",
                "wallet_addr": "bc1p9gvz9w89j60y2xy9pycmfls5xl5y0kklgdcfxf7tqyhfdre9wdeq8etlru",
                "block_height": 841974,
                "ts": "2024-05-03T22:37:46.000Z",
                "amount": "1140",
                "sale_price": 502146,
                "sold_to_wallet_addr": "bc1pg7j3rwqnjfsrj66gcgtfx99c6l3vnrs9v7arx3kpjmh9ukmv47wq0jdgg0",
                "marketplace_type": "magiceden",
                "rune_id": "841599:714",
                "rune_name": "BUTTERNUTTHEHELLCAT",
                "spaced_rune_name": "BUTTERNUT•THE•HELL•CAT",
                "decimals": 0,
                "inner_id": 13122493
            },
            {
                "event_category": "runes",
                "event_type": "input",
                "outpoint": "6c7ebb818b94bc3c68e6681fde4bfc4a726a9bf002ca7400fb703cb9f0fe3539:1",
                "tx_id": "592ce71f4c962a18565c1d7db5336f956d5af48d2b46b21d19c001b79272d565",
                "wallet_addr": "bc1p9gvz9w89j60y2xy9pycmfls5xl5y0kklgdcfxf7tqyhfdre9wdeq8etlru",
                "block_height": 841974,
                "ts": "2024-05-03T22:37:46.000Z",
                "amount": "1140",
                "sale_price": 502146,
                "sold_to_wallet_addr": "bc1pg7j3rwqnjfsrj66gcgtfx99c6l3vnrs9v7arx3kpjmh9ukmv47wq0jdgg0",
                "marketplace_type": "magiceden",
                "rune_id": "841599:714",
                "rune_name": "BUTTERNUTTHEHELLCAT",
                "spaced_rune_name": "BUTTERNUT•THE•HELL•CAT",
                "decimals": 0,
                "inner_id": 13122492
            },
            ...
        ]
    },
    "block_height": 847622
}

Get Wallet Metadata

Included in: Basic, Pro, Dedicated

GET https://api.bestinslot.xyz/v3/wallet/metadata

Returns inscription_count, nonbrc20_inscription_count and last_transfer_block_height for a given wallet address.

Sample query: https://api.bestinslot.xyz/v3/wallet/metadata?address=bc1p4wj6n9c80zvrjwq3lke2n8esuv8rzw6ch0jlqfrlpanlyn3ftx2s6dgwec

Query Parameters

Name
Type
Description

address*

string

bitcoin wallet address

{
    "data": {
        "inscription_count": 5,
        "nonbrc20_inscription_count": 5,
        "last_transfer_block_height": 779081
    },
    "block_height": 801647
}
PreviousCollectionsNextInscriptions

Last updated