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

# Overview

> Base URLs, authentication, and common conventions for the Best in Slot API.

## Base URLs

| Network  | Base URL                             |
| -------- | ------------------------------------ |
| Mainnet  | `https://api.bestinslot.xyz`         |
| Testnet4 | `https://testnet.api.bestinslot.xyz` |
| Signet   | `https://signet_api.bestinslot.xyz`  |

To target testnet4 or signet, swap the base URL in your requests. Your API key works across all three networks.

## Authentication

Include your API key in every request using the `x-api-key` header.

```bash theme={null}
curl 'https://api.bestinslot.xyz/v3/brc20/ticker_info?ticker=ordi' \
  --header 'x-api-key: YOUR_API_KEY'
```

<Note>
  All plans require an API key, including the free and trial tiers. To obtain a
  key, submit a request via the [Best in Slot API request
  form](https://coda.io/form/Best-in-Slot-API-Request-Form_dbtfCuBhaEy).
</Note>

## Response Format

Every response wraps its payload in a consistent envelope:

```json theme={null}
{
  "data": ...,
  "block_height": 805712
}
```

The `block_height` field reflects the **latest indexed block** at the time of the response — not necessarily the block relevant to your query.

## Pagination

Endpoints that return lists support `offset` and `count` pagination parameters.

| Rule             | Detail                                                                                        |
| ---------------- | --------------------------------------------------------------------------------------------- |
| Multiples of 20  | Both `offset` and `count` must be multiples of 20                                             |
| Maximum `offset` | 5,000 for most endpoints (some endpoints differ — check individual parameter tables)          |
| Maximum `count`  | 100 for most endpoints (some endpoints allow up to 2,000 — check individual parameter tables) |

## Plan Tiers

Endpoints are gated by API key tier. The four tiers are:

* **Basic** — entry-level access to core read endpoints
* **Pro** — adds pricing data, activity feeds, and wallet listings
* **Enterprise** — adds block-level data streams
* **Dedicated** — full access including all mempool and global activity endpoints

Each endpoint in this reference notes which plans include it. Expired API keys automatically downgrade to the Free tier.

<Tip>
  Rate limit categories and current pricing are listed at
  [bestinslot.xyz/api](https://bestinslot.xyz/api/). Free and trial keys use
  daily limits; all paid plans use monthly limits.
</Tip>