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

> Query stored BTCUSDT dollar, volume, tick, and imbalance bars.

`custom_bars` returns market-data bars generated from stored Binance Futures BTCUSDT individual aggTrades.

## Arguments

| Argument             | Type      | Required | Description                                                                  |
| -------------------- | --------- | -------- | ---------------------------------------------------------------------------- |
| `exchange`           | string    | Yes      | `binance` or `binance-futures`                                               |
| `product`            | string    | Yes      | Initially `BTCUSDT`                                                          |
| `bar_type`           | string    | Yes      | `dollar`, `volume`, `tick`, or `imbalance`                                   |
| `begin`              | timestamp | Yes      | Inclusive start                                                              |
| `end`                | timestamp | Yes      | Exclusive end                                                                |
| `threshold`          | number    | No       | Exact stored threshold filter                                                |
| `threshold_key`      | string    | No       | Exact configuration key returned by the catalog                              |
| `limit`              | integer   | No       | 1 to 10,000 rows; default 5,000                                              |
| `cursor`             | string    | No       | Integer page offset                                                          |
| `include`            | object    | No       | Coverage, provenance, column metadata, and optional redacted source manifest |
| `return_next_cursor` | boolean   | No       | MCP-only explicit pagination switch; defaults to false                       |

## Example arguments

```json theme={null}
{
  "exchange": "binance-futures",
  "product": "BTCUSDT",
  "bar_type": "tick",
  "begin": "2026-01-01T00:00:00Z",
  "end": "2026-01-02T00:00:00Z",
  "threshold": 1000,
  "limit": 100,
  "include": {
    "coverage": true,
    "provenance": true,
    "column_metadata": true,
    "source_manifest": false
  }
}
```

## Exact no-results behavior

A valid exact query can complete with zero rows:

```json theme={null}
{
  "query_complete": true,
  "data_gap": false,
  "retry_recommended": false,
  "alternative_query_required": false,
  "result_status": "no_results",
  "no_results_reason": "no_stored_rows_matched_request",
  "rows": []
}
```

This is a complete answer for the requested filters. Do not automatically remove the threshold, widen the date range, or fetch alternatives unless the user asks.

<Warning>
  Custom bars are market-data observations, not BUY, SELL, ENTER, or execution instructions.
</Warning>