custom_bars_catalog - Meridian

Use custom_bars_catalog before querying custom bars when you do not already know the exact stored threshold or date range. The catalog is authoritative for current availability. Documentation examples show valid request shapes but do not promise that every threshold is materialized for every historical window.

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

{
  "exchange": "binance-futures",
  "product": "BTCUSDT",
  "bar_type": "dollar",
  "limit": 100
}

Catalog entry

Each entry identifies a stored configuration:

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