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
{
"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": []
}
Custom bars are market-data observations, not BUY, SELL, ENTER, or execution instructions.