Skip to main content
To use these endpoints on testnet4 or signet, send your request to https://testnet.api.bestinslot.xyz or https://signet_api.bestinslot.xyz respectively, using your existing API key.

​
Sats validity check

Available on: Basic, Pro, Dedicated 
GET https://api.bestinslot.xyz/v3/sats/validity_check
Returns validity details about a specific inscription, indicating whether it is a valid Sats Name and, if not, which inscription holds the canonical registration.

​
Parameters

​
inscription_id
string
required
The inscription ID to check.

​
Response

{
    "data": {
        "sats_name": "penguins.sats",
        "original_id": "b8cd5daeb8859410c4cc01d88bfa5afe6c508713882af7099b45b5d583c270d7i0",
        "is_valid": false
    },
    "block_height": 795034
}

​
Sats forward lookup

Available on: Basic, Pro, Dedicated 
GET https://api.bestinslot.xyz/v3/sats/forward_lookup
Resolves a Sats Name to the Bitcoin wallet address that currently holds it.

​
Parameters

​
sats_name
string
required
The Sats Name to resolve (e.g., penguins.sats).

​
Response

{
    "data": {
        "wallet": "bc1prjglj0tcff20fe4rkwlfj6rjpgjgp3c9k252gsrwysmc7uuk9dcqm40l8k",
        "bis_url": "https://bestinslot.xyz/bc1prjglj0tcff20fe4rkwlfj6rjpgjgp3c9k252gsrwysmc7uuk9dcqm40l8k"
    },
    "block_height": 795034
}

​
Sats reverse lookup

Available on: Basic, Pro, Dedicated 
GET https://api.bestinslot.xyz/v3/sats/reverse_lookup
Resolves a Bitcoin wallet address to the primary Sats Name associated with it. The primary name is determined by the valid Sats Name with the lowest inscription number held by that address.

​
Parameters

​
address
string
required
Bitcoin wallet address to look up.

​
Response

{
    "data": {
        "name": "cindi.sats",
        "bis_url": "https://bestinslot.xyz/cindi.sats"
    },
    "block_height": 795034
}

​
Get Sats activity

Available on: Pro, Dedicated 
GET https://api.bestinslot.xyz/v3/sats/activity
Returns an ordered stream of events (inscribes, transfers, and sales) across all Sats Names.

​
Parameters

​
activity_filter
integer
required
Bitmask controlling which event types are returned. Combine values with a bitwise OR:
  • 1 — inscribed
  • 2 — transferred
  • 4 — sold
Example: 6 returns transfers and sales (2 | 4). 7 returns all event types.
​
sort_by
string
required
Sort field: ts.
​
order
string
required
Sort direction: asc or desc.
​
offset
integer
required
Pagination offset. Must be between 0 and 5000 inclusive.
​
count
integer
required
Number of results to return. Must be between 20 and 100 inclusive.

​
Response

{
    "data": [
        {
            "inscription_id": "04a5e6e80d49eae28b6da1185eae2566acf438f52957ca214a262ff1a398d469i0",
            "from_wallet": "bc1qzfcrcx5xtsc25dkzls9smmr45fztfpwyznnmzh",
            "to_wallet": "bc1pnvfmyadyqy6ggdhqaktm7crs3tgpnvadc9rnt973axfr6twend6qexd5qz",
            "block_height": 801580,
            "sale_price": 3531,
            "new_satpoint": "a54d450288ae6ea1165ea02ac3e60b69d56b172ea9fb77ab2011b15cbeb6eeb3:1:0",
            "ts": "2023-08-04T01:10:16.000Z",
            "marketplace_type": "magiceden",
            "tx_id": "a54d450288ae6ea1165ea02ac3e60b69d56b172ea9fb77ab2011b15cbeb6eeb3"
        }
    ],
    "block_height": 801585
}