data timeout fixes; research agent improvements

gateway/knowledge/usage-examples.md

@@ -1,3 +1,7 @@
+---
+description: "Example research scripts showing common patterns for data retrieval, statistical analysis, and visualization."
+---
+
 # Research Script API Usage
 
 See [`api-reference.md`](api-reference.md) for the full DataAPI and ChartingAPI source with all method signatures and docstrings. See [`pandas-ta-reference.md`](pandas-ta-reference.md) for the indicator catalog.
@@ -75,11 +79,16 @@ print(df.head())
 
 ### Available Extra Columns
 
-- `"volume"` - Total volume
-- `"buy_vol"` - Buy-side volume
-- `"sell_vol"` - Sell-side volume
-- `"open_time"`, `"high_time"`, `"low_time"`, `"close_time"` - Timestamps for each price point
-- `"open_interest"` - Open interest (for futures)
+All columns below are fully populated for Binance data. Other exchanges provide only `volume`.
+
+- `"volume"` - Total base-asset volume
+- `"buy_vol"` - Taker buy volume (base asset) — order flow long pressure
+- `"sell_vol"` - Taker sell volume (base asset) — order flow short pressure
+- `"quote_volume"` - Total quote-asset volume (e.g. USDT traded)
+- `"num_trades"` - Number of individual trades in the candle
+- `"open_time"`, `"close_time"` - Exact candle open/close timestamps (Binance only)
+- `"high_time"`, `"low_time"` - Not provided by any exchange (always null)
+- `"open_interest"` - Open interest (futures only)
 - `"ticker"` - Market identifier
 - `"period_seconds"` - Period in seconds