> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bestinslot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Sats Names

> API endpoints for Sats Names lookup and activity on Best in Slot.

<Note>
  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.
</Note>

## 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

<ParamField query="inscription_id" type="string" required>
  The inscription ID to check.
</ParamField>

### Response

```json theme={null}
{
    "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

<ParamField query="sats_name" type="string" required>
  The Sats Name to resolve (e.g., `penguins.sats`).
</ParamField>

### Response

```json theme={null}
{
    "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

<ParamField query="address" type="string" required>
  Bitcoin wallet address to look up.
</ParamField>

### Response

```json theme={null}
{
    "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

<ParamField query="activity_filter" type="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.
</ParamField>

<ParamField query="sort_by" type="string" required>
  Sort field: `ts`.
</ParamField>

<ParamField query="order" type="string" required>
  Sort direction: `asc` or `desc`.
</ParamField>

<ParamField query="offset" type="integer" required>
  Pagination offset. Must be between `0` and `5000` inclusive.
</ParamField>

<ParamField query="count" type="integer" required>
  Number of results to return. Must be between `20` and `100` inclusive.
</ParamField>

### Response

```json theme={null}
{
    "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
}
```