Wallets

To use these endpoints on testnet4 or signet, send requests to https://testnet.api.bestinslot.xyz or https://signet_api.bestinslot.xyz respectively. Your existing API key works on all networks.

BTC Testnet4 Faucet

Included in: Basic, Pro, Dedicated GET https://testnet.api.bestinslot.xyz/v3/wallet/testnet_faucet Mints 0.01 tBTC to the specified testnet address. This endpoint is available on the testnet4 base URL only — it does not exist on mainnet.

This endpoint is rate-limited to 10 requests per 24 hours per API key.

address

string

required

Testnet Bitcoin wallet address to receive the tBTC.

{
  "data": {
    "transfer_txid": "d32bb47c7728dbe89289694a54827ecabd8052a5e6c1475ac5a126986e79be1b"
  },
  "block_height": 840000
}

Get Wallet Inscriptions

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/wallet/inscriptions Returns a paginated, ordered list of inscriptions held by a wallet.

last_sale_price is only populated on the Pro tier and above.

address

string

required

Bitcoin wallet address.

sort_by

string

required

Sort field. Accepted value: inscr_num.

order

string

required

Sort direction. Accepted values: asc, desc.

offset

int

required

Pagination offset. Must be a multiple of 20. Minimum: 0 (no upper limit).

count

int

required

Number of results to return. Must be a multiple of 20. Range: 20 to 2000.

exclude_brc20

bool

Set to true to exclude BRC-20 inscriptions from the results.

cursed_only

bool

Set to true to return only cursed inscriptions.

collection_slug

string

Filter results to a specific collection by slug.

{
  "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 a paginated, ordered list of inscriptions across up to 100 wallets in a single request.

addresses

array of strings

required

Bitcoin wallet addresses to query. Maximum: 100 addresses.

offset

int

required

Pagination offset. Must be a multiple of 20. Minimum: 0 (no upper limit).

count

int

required

Number of results to return. Must be a multiple of 20. Range: 20 to 2000.

sort_by

string

Sort field. Accepted value: inscr_num.

order

string

Sort direction. Accepted values: asc, desc. Defaults to desc.

exclude_brc20

string

Set to "true" (as a string) to exclude BRC-20 inscriptions from the results.

cursed_only

string

Set to "true" (as a 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 Collections

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/wallet/collections Returns an ordered list of collections held by a wallet, including per-collection floor price and volume data.

last_sale_price is only populated on the Pro tier and above.

address

string

required

Bitcoin wallet address.

sort_by

string

required

Sort field. Accepted values: slug, inscription_count.

order

string

required

Sort direction. Accepted values: asc, desc.

{
  "data": [
    {
      "collection_slug": "rune_pizza",
      "inscription_ids": [
        "a77c2fda458fc67028cb444b3b3fdcdf36b168d89ceb7286630d2fc76b21a714i292",
        "d8e56a07f5dc3b6ca8976502637aa50480f883ed89b46dedfcd3196a7e9e5b19i323",
        "3a94a50d3df80794c606fe1cca66d88cfcbacbe1ddafc2493d7da123ef19f4a6i771",
        "9fd85f3c8fdde5bd89525e4cfc0ad147555ef57a3f4afe01570905340e88699di1110"
      ],
      "collection_info": {
        "name": "Rune Piza",
        "slug": "rune_pizza",
        "inscription_icon_id": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/ord-rune_pizza_pfp_1713024144812.jpeg",
        "icon_url": "https://creator-hub-prod.s3.us-east-2.amazonaws.com/ord-rune_pizza_pfp_1713024144812.jpeg",
        "icon_render_url": null,
        "bis_url": "https://bestinslot.xyz/ordinals/collection/rune_pizza",
        "supply": "10892",
        "min_number": 68699615,
        "median_number": 68705556,
        "max_number": 68713500,
        "listed_count": 823,
        "floor_price": 1530,
        "floor_price_ordswap": null,
        "floor_price_magiceden": 1530,
        "floor_price_ordinalswallet": 811921,
        "floor_price_gammaio": null,
        "floor_price_ordynals": null,
        "floor_price_unisat": null,
        "floor_price_ordinalsmarket": null,
        "floor_price_okx": 6000,
        "vol_3h_in_btc": 0,
        "vol_24h_in_btc": 0,
        "vol_7d_in_btc": 0,
        "vol_30d_in_btc": 0,
        "sale_cnt_7d": 0,
        "vol_total_in_btc": 23.96608198,
        "sale_cnt_total": 4921,
        "marketcap": 16664760
      }
    }
  ],
  "block_height": 889397
}

Get Wallet Sats Names

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/wallet/sats_names Returns the list of verified Sats Names registered to a wallet.

address

string

required

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 an ordered list of active marketplace listings for a wallet.

address

string

required

Bitcoin wallet address.

sort_by

string

required

Sort field. Accepted values: min_price, ordswap_price, magiceden_price, ordinalswallet_price, gammaio_price, odynals_price, unisat_price, ordinalsmarket_price, okx_price.

order

string

required

Sort direction. Accepted values: asc, desc.

offset

int

required

Pagination offset. Must be a multiple of 20. Range: 0 to 5000.

count

int

required

Number of results to return. Must be a multiple of 20. Range: 20 to 100.

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

Included in: Pro, Dedicated GET https://api.bestinslot.xyz/v3/wallet/activity Returns a paginated, ordered list of inscription activity (inscribes, sales, and transfers) for a wallet. For combined inscription + BRC-20 + Runes activity, see Get Wallet Global Activity.

address

string

required

Bitcoin wallet address.

activity_filter

int

required

A bitmask controlling which event types to include:

1 — inscribed
2 — transferred
4 — sold

Combine with bitwise OR (e.g. 7 returns all three types).

sort_by

string

required

Sort field. Accepted value: ts.

order

string

required

Sort direction. Accepted values: asc, desc.

offset

int

required

Pagination offset. Must be a multiple of 20. Range: 0 to 5000.

count

int

required

Number of results to return. Must be a multiple of 20. Range: 20 to 100.

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

Included in: Dedicated GET https://api.bestinslot.xyz/v3/wallet/global_activity Returns a combined, time-ordered stream of inscription, BRC-20, and Runes activity for a wallet. This endpoint merges the data from /v3/wallet/activity, /v3/brc20/wallet_activity, and /v3/runes/wallet_activity into a single response. Because the three protocols require different fields, each item in the response array carries a different structure identified by its event_category field. Because a single Runes transaction can generate many events, the response may contain more items than count if the last transaction’s events do not fit exactly. This endpoint uses cursor-based pagination instead of offset. Pass the cursor value from the previous response to fetch the next page.

address

string

required

Bitcoin wallet address.

sort_by

string

required

Sort field. Accepted value: ts.

order

string

required

Sort direction. Accepted values: asc, desc.

count

int

required

Number of results to return. Must be a multiple of 20. Range: 20 to 500.

runes_filter_only_wallet

string

Set to "true" or "false" to filter Runes events to only those where the wallet is the primary actor.

cursor

string

Cursor token from the previous response. Omit on the first request.

Event structures

The result array contains mixed event types. Use the event_category field to distinguish them.

InscriptionStructure
BRC20Structure
RunesStructure

Field	Type	Description
`event_category`	string	Always `"inscription"`
`event_type`	string	`"inscribe"`, `"transfer"`, `"buy"`, or `"sell"`
`inscription_id`	string	Inscription ID
`tx_id`	string	Transaction ID
`new_satpoint`	string	New satpoint after the event
`from_wallet`	string	Sender wallet address
`to_wallet`	string	Recipient wallet address
`block_height`	int	Block height of the event
`ts`	string	ISO 8601 timestamp
`amount`	int	Always `1` for inscriptions
`sale_price`	int	Sale price in satoshis (`-1` if not a sale)
`unit_price`	int	Same as `sale_price` for this type
`marketplace_type`	string	Marketplace identifier
`inner_id`	int	Internal ID for debugging

Field	Type	Description
`event_category`	string	Always `"brc20"`
`event_type`	string	`"deploy-inscribe"`, `"mint-inscribe"`, `"transfer-inscribe"`, or `"transfer-transfer"`
`inscription_id`	string	Inscription ID
`tx_id`	string	Transaction ID
`new_satpoint`	string	New satpoint after the event
`from_wallet`	string	Sender wallet address
`to_wallet`	string	Recipient wallet address
`block_height`	int	Block height of the event
`ts`	string	ISO 8601 timestamp
`amount`	number	Token amount transferred
`sale_price`	int	Sale price in satoshis
`unit_price`	number	Price per token unit
`marketplace_type`	string	Marketplace identifier
`ticker`	string	BRC-20 ticker symbol
`inner_id`	int	Internal ID for debugging

Field	Type	Description
`event_category`	string	Always `"runes"`
`event_type`	string	`"input"`, `"new-allocation"`, `"mint"`, `"output"`, or `"burn"`
`outpoint`	string	UTXO outpoint (`txid:vout`)
`tx_id`	string	Transaction ID
`wallet_addr`	string	Wallet address involved in the event
`block_height`	int	Block height of the event
`ts`	string	ISO 8601 timestamp
`amount`	string	Rune amount (as a string to preserve precision)
`sale_price`	int	Sale price in satoshis (`null` if not a sale)
`sold_to_wallet_addr`	string	Buyer wallet address (`null` if not a sale)
`marketplace_type`	string	Marketplace identifier
`rune_id`	string	Rune identifier (`block:tx` format)
`rune_name`	string	Rune name without spacers
`spaced_rune_name`	string	Rune name with bullet spacers
`decimals`	int	Decimal precision of the rune
`inner_id`	int	Internal ID for debugging

{
  "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": 13122492
      }
    ]
  },
  "block_height": 847622
}

Get Wallet Metadata

Included in: Basic, Pro, Dedicated GET https://api.bestinslot.xyz/v3/wallet/metadata Returns summary metadata for a wallet: total inscription count, non-BRC-20 inscription count, and the block height of the most recent transfer.

address

string

required

Bitcoin wallet address.

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

Overview

Endpoints

BTC Testnet4 Faucet

Get Wallet Inscriptions

Get Batch Wallet Inscriptions

Get Wallet Collections

Get Wallet Sats Names

Get Wallet Listings

Get Wallet Activity

Get Wallet Global Activity

Event structures

Get Wallet Metadata

Overview

Endpoints

​BTC Testnet4 Faucet

​Get Wallet Inscriptions

​Get Batch Wallet Inscriptions

​Get Wallet Collections

​Get Wallet Sats Names

​Get Wallet Listings

​Get Wallet Activity

​Get Wallet Global Activity

​Event structures

​Get Wallet Metadata

BTC Testnet4 Faucet

Get Wallet Inscriptions

Get Batch Wallet Inscriptions

Get Wallet Collections

Get Wallet Sats Names

Get Wallet Listings

Get Wallet Activity

Get Wallet Global Activity

Event structures

Get Wallet Metadata