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

# custom_bars_catalog

> Discover stored custom-bar configurations, thresholds, ranges, and source runs.

Use `custom_bars_catalog` before querying custom bars when you do not already know the exact stored threshold or date range.

## Arguments

| Argument   | Type    | Required | Description                                             |
| ---------- | ------- | -------- | ------------------------------------------------------- |
| `exchange` | string  | No       | `binance` or `binance-futures`                          |
| `product`  | string  | No       | Initially `BTCUSDT`                                     |
| `bar_type` | string  | No       | `dollar`, `volume`, `tick`, or `imbalance`              |
| `limit`    | integer | No       | Catalog entries to return, from 1 to 5,000; default 500 |
| `cursor`   | string  | No       | Integer offset returned by an earlier page              |

## Example arguments

```json theme={null}
{
  "exchange": "binance-futures",
  "product": "BTCUSDT",
  "bar_type": "dollar",
  "limit": 100
}
```

## Catalog entry

Each entry identifies a stored configuration:

```json theme={null}
{
  "exchange": "binance-futures",
  "product": "BTCUSDT",
  "bar_type": "dollar",
  "threshold_key": "...",
  "threshold": 5000000,
  "begin": "...",
  "end": "...",
  "row_count": 12345,
  "sources": ["binance_vision_aggtrades"],
  "provenance_types": ["native_backfilled"],
  "source_run_ids": ["..."]
}
```

The catalog is read-only. It does not download archives, build bars, or trigger a historical job.