Wallets

Endpoints related with Bitcoin Wallets.

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

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

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

NameTypeDescription

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"
            ],
            "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 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

NameTypeDescription

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

NameTypeDescription

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

NameTypeDescription

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

NameTypeDescription

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

NameTypeDescription

address*

string

bitcoin wallet address

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

Last updated