custom_bars - Meridian

custom_bars returns market-data bars generated from stored Binance Futures BTCUSDT individual aggTrades. Call custom_bars_catalog first when the application does not already know the stored threshold and date range. Current production tick-bar examples use threshold 1000; older test-only thresholds should not be assumed to exist.

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

{
  "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:

{
  "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.

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