hive-intelligence 1.12.1 → 1.13.0

package/README.md

@@ -42,7 +42,7 @@ provider keys.
 - Bundled agent skills that teach assistants the right Hive workflow:
   discovery -> schema lookup -> bounded execution -> evidence receipt.
 - A broad provider catalog remains available behind discovery for agents that
-  need a long-tail endpoint. The current catalog contains 432 tools, but that
+  need a long-tail endpoint. The current catalog contains 428 tools, but that
   coverage is not the primary product contract.
 
 ## Quickstart

package/agent-skills/packs/hive-build/SKILL.md

@@ -85,7 +85,7 @@ async def briefing():
         prices, tvl, oi = await asyncio.gather(
             h.execute("get_price",         {"ids": "bitcoin,ethereum"}),
             h.execute("get_protocol_tvl",  {}),
-            h.execute("get_open_interest", {"exchange": "binance"}),
+            h.execute("get_open_interest", {"exchange": "bybit", "symbol": "BTC/USDT:USDT"}),
         )
         return {"prices": prices, "tvl": tvl[:5], "oi": oi}
     finally:

package/build/{chunk-4GBOUVUD.js → chunk-V7TBL47R.js}

@@ -7,7 +7,7 @@ import {
   getSupabaseAdmin,
   resolveEndpoint,
   secureLogger
-} from "./chunk-PFX4AJNR.js";
+} from "./chunk-ZRAW5MXW.js";
 
 // src/services/wallet-service.ts
 async function consumeCredits(args) {

package/build/{chunk-PFX4AJNR.js → chunk-ZRAW5MXW.js}

@@ -18081,7 +18081,7 @@ var wrapper = {
       tool: {
         name: "get_funding_rate",
         oldToolName: "ccxt_fetch_funding_rate",
-        description: "Fetch current funding rate for a perpetual futures contract",
+        description: "Fetch the current funding rate for one perpetual contract. fundingRate is a raw fraction for one funding interval, and interval says which interval (for example 8h, 4h or 1h). interval is null where the venue does not report it, as on Binance, so do not annualize a null-interval rate or compare it across venues. Deribit's rate is the realized rate over the trailing 8 hours, not a forecast",
         inputSchema: {
           type: "object",
           properties: {
@@ -18104,7 +18104,7 @@ var wrapper = {
       tool: {
         name: "get_funding_rate_history",
         oldToolName: "ccxt_fetch_funding_rate_history",
-        description: "Fetch funding rate history for perpetual futures contracts",
+        description: "Fetch settled funding rate history for a perpetual contract. Each row is the rate for one funding period ending at its timestamp. Rows carry no interval (interval is null), so read the period from the gap between consecutive timestamps. Deribit is refused because its hourly rows each carry a trailing 8-hour rate, which overstates funding about 8x when summed",
         inputSchema: {
           type: "object",
           properties: {
@@ -18227,7 +18227,7 @@ var wrapper = {
       tool: {
         name: "get_funding_rates",
         oldToolName: "ccxt_fetch_funding_rates",
-        description: "Fetch funding rates for multiple or all perpetual futures contracts",
+        description: "Fetch current funding rates for a list of perpetual contracts on one venue. Each rate is a raw fraction for one funding interval; each record's interval says which, and is null where the venue does not report it (Binance)",
         inputSchema: {
           type: "object",
           properties: {
@@ -18388,7 +18388,7 @@ var wrapper = {
       tool: {
         name: "get_open_interest",
         oldToolName: "ccxt_fetch_open_interest",
-        description: "Fetch current open interest for a derivatives contract",
+        description: "Fetch current open interest for one derivatives contract. Venues count it differently, so each record names its units. openInterestAmountUnit is base (Binance USDT-margined, Hyperliquid), base_both_sides (Bybit, which counts both sides of the book: halve it for one side) or contracts (OKX, HTX, Binance coin-margined: multiply by contractSize, which is in the base coin for linear contracts and in USD for inverse ones). openInterestValueUnit is usd, quote or usd_both_sides. A null unit is not verified for that venue, so do not compare it across venues. Bybit's figure can be up to an hour old",
         inputSchema: {
           type: "object",
           properties: {
@@ -18411,7 +18411,7 @@ var wrapper = {
       tool: {
         name: "get_open_interest_history",
         oldToolName: "ccxt_fetch_open_interest_history",
-        description: "Fetch historical open interest data for a derivatives contract",
+        description: "Fetch open-interest history for one derivatives contract. Each row names its units as get_open_interest does: Binance base and quote, Bybit base counted on both sides, Gate contracts and USD, HTX base and quote. Refused: OKX, which reports a whole currency rather than the contract, and Binance coin-margined contracts, which come back empty",
         inputSchema: {
           type: "object",
           properties: {
@@ -18522,7 +18522,7 @@ var wrapper = {
       tool: {
         name: "get_leverage_tiers",
         oldToolName: "ccxt_fetch_leverage_tiers",
-        description: "Fetch leverage tier information for trading pairs showing max leverage, maintenance margin rates, and notional value brackets",
+        description: "Fetch leverage tier information for trading pairs showing max leverage, maintenance margin rates, and notional value brackets. minNotional and maxNotional are in each tier's currency, the contract's settle currency",
         inputSchema: {
           type: "object",
           properties: {
@@ -27694,7 +27694,8 @@ Error Handling:
       },
       symbol: {
         type: "string",
-        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)"
+        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)",
+        examples: ["BTC/USDT"]
       }
     },
     required: ["exchange", "symbol"]
@@ -27770,7 +27771,8 @@ Error Handling:
         items: {
           type: "string"
         },
-        description: "Required array of 1-100 trading pair symbols."
+        description: "Required array of 1-100 trading pair symbols.",
+        examples: [["BTC/USDT"]]
       }
     },
     required: ["exchange"]
@@ -27847,7 +27849,8 @@ Error Handling:
       },
       symbol: {
         type: "string",
-        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)"
+        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)",
+        examples: ["BTC/USDT"]
       },
       limit: {
         type: "number",
@@ -27928,7 +27931,8 @@ Error Handling:
       },
       symbol: {
         type: "string",
-        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)"
+        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)",
+        examples: ["BTC/USDT"]
       },
       since: {
         type: "number",
@@ -28011,7 +28015,8 @@ Error Handling:
       },
       symbol: {
         type: "string",
-        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)"
+        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)",
+        examples: ["BTC/USDT"]
       },
       timeframe: {
         type: "string",
@@ -28059,7 +28064,8 @@ Returns:
     "symbol": string,                  // Contract symbol
     "timestamp": number,               // Data timestamp
     "datetime": string,                // ISO datetime
-    "fundingRate": number,             // Current funding rate (e.g., 0.0001 = 0.01%)
+    "fundingRate": number,             // Raw fraction for one funding interval (0.0001 = 0.01%)
+    "interval": string | null,         // That interval, e.g. "8h"; null where the venue does not report it (Binance)
     "fundingTimestamp": number,        // Next funding time
     "fundingDatetime": string,
     "markPrice": number,               // Current mark price
@@ -28092,11 +28098,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a perpetuals venue: bybit, binance, okx, bitget, gate, htx, hyperliquid, deribit, krakenfutures, kucoinfutures, mexc",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Perpetual contract symbol (e.g., BTC/USDT:USDT)"
+        description: "Perpetual contract symbol (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       }
     },
     required: ["exchange", "symbol"]
@@ -28123,7 +28131,7 @@ var fetchFundingRateHistoryTool = {
 Returns historical funding rate records useful for analyzing funding trends and calculating historical costs.
 
 Args:
-  - exchange (string, required): Exchange ID with perpetual futures. Options: "binance", "bybit", "okx", "bitget", "gate".
+  - exchange (string, required): Exchange ID with perpetual futures. Options: "binance", "bybit", "okx", "bitget", "gate". Deribit is refused: its hourly rows each carry a trailing 8-hour rate, so a sum overstates funding about 8x.
   - symbol (string, optional): Perpetual contract symbol. If omitted, may fetch all contracts (exchange-dependent).
   - since (number, optional): Timestamp in milliseconds to fetch history since.
   - limit (number, optional): Number of funding rate records to return.
@@ -28134,7 +28142,8 @@ Returns:
     "symbol": string,                  // Contract symbol
     "timestamp": number,               // Funding timestamp
     "datetime": string,                // ISO datetime
-    "fundingRate": number,             // Funding rate at that time
+    "fundingRate": number,             // Rate for the funding period ending at timestamp
+    "interval": null,                  // Rows carry no interval; the gap between timestamps is the period
     "info": {...}                      // Raw exchange response
   }]
 
@@ -28161,11 +28170,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a perpetuals venue: bybit, binance, okx, bitget, gate, htx, hyperliquid, kucoinfutures, mexc. Deribit is refused: its hourly rows each carry a trailing 8-hour rate",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Perpetual contract symbol (optional)"
+        description: "Perpetual contract symbol (optional)",
+        examples: ["BTC/USDT:USDT"]
       },
       since: {
         type: "number",
@@ -28240,14 +28251,16 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID. Venues that serve best bid/ask in Hive's CCXT build: binance, bybit, coinbase, mexc, kucoinfutures",
+        examples: ["bybit"]
       },
       symbols: {
         type: "array",
         items: {
           type: "string"
         },
-        description: "Required array of 1-100 trading pair symbols."
+        description: "Required array of 1-100 trading pair symbols.",
+        examples: [["BTC/USDT"]]
       }
     },
     required: ["exchange"]
@@ -28308,7 +28321,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID. Venues that report status in Hive's CCXT build include binance, bybit, kraken, okx, kucoin, htx and mexc"
       }
     },
     required: ["exchange"]
@@ -28425,11 +28438,12 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID. Venues that serve L2 depth in Hive's CCXT build include binance, kraken, bybit, okx, kucoin, bitget and gate (not coinbase)"
       },
       symbol: {
         type: "string",
-        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)"
+        description: "Trading pair symbol (e.g., BTC/USDT, ETH/USD)",
+        examples: ["BTC/USDT"]
       },
       limit: {
         type: "number",
@@ -28470,7 +28484,8 @@ Returns:
       "symbol": string,
       "timestamp": number,
       "datetime": string,
-      "fundingRate": number,
+      "fundingRate": number,         // Raw fraction for one funding interval
+      "interval": string | null,     // e.g. "8h"; null where the venue does not report it
       "fundingTimestamp": number,
       "markPrice": number,
       "indexPrice": number,
@@ -28493,21 +28508,22 @@ Don't use when:
   - You need historical rates (use ccxt_fetch_funding_rate_history)
 
 Error Handling:
-  - Not all exchanges support batch funding rate queries
-  - Falls back to individual queries if needed`,
+  - Not all exchanges support batch funding rate queries`,
   inputSchema: {
     type: "object",
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a perpetuals venue: bybit, binance, okx, bitget, gate, htx, hyperliquid, krakenfutures",
+        examples: ["bybit"]
       },
       symbols: {
         type: "array",
         items: {
           type: "string"
         },
-        description: "Required array of 1-100 perpetual contract symbols."
+        description: "Required array of 1-100 perpetual contract symbols.",
+        examples: [["BTC/USDT:USDT"]]
       }
     },
     required: ["exchange"]
@@ -28566,11 +28582,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a derivatives venue: bybit, binance, okx, bitget, gate, htx, kucoinfutures, mexc",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Index symbol (e.g., BTC/USDT)"
+        description: "Contract symbol whose index to read (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       },
       timeframe: {
         type: "string",
@@ -28641,11 +28659,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a derivatives venue: bybit, binance, okx, bitget, gate, htx, kucoinfutures, mexc, krakenfutures, bingx",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Perpetual contract symbol (e.g., BTC/USDT:USDT)"
+        description: "Perpetual contract symbol (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       },
       timeframe: {
         type: "string",
@@ -28716,11 +28736,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a perpetuals venue with a premium index: bybit, binance, htx, kucoinfutures (not okx)",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Perpetual contract symbol (e.g., BTC/USDT:USDT)"
+        description: "Perpetual contract symbol (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       },
       timeframe: {
         type: "string",
@@ -28797,7 +28819,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID. Live fee schedules need an exchange account on most venues; without one Hive returns CCXT's static default schedule, marked fallback"
       }
     },
     required: ["exchange"]
@@ -28830,7 +28852,7 @@ var fetchOpenInterestTool = {
 Returns the total number of outstanding derivative contracts (futures/perpetuals) that have not been settled.
 
 Args:
-  - exchange (string, required): Exchange ID with derivatives. Top exchanges: "binance", "bybit", "okx", "bitget", "gate".
+  - exchange (string, required): Exchange ID with derivatives. Top exchanges: "binance", "bybit", "okx", "htx", "hyperliquid".
   - symbol (string, required): Derivatives contract symbol (e.g., "BTC/USDT:USDT", "ETH/USDT:USDT").
 
 Returns:
@@ -28839,8 +28861,11 @@ Returns:
     "symbol": string,                  // Contract symbol
     "timestamp": number,               // Unix timestamp in ms
     "datetime": string,                // ISO datetime
-    "openInterestAmount": number,      // Open interest in contracts
-    "openInterestValue": number,       // Open interest in quote currency (USD value)
+    "openInterestAmount": number,      // Units vary by venue: see openInterestAmountUnit
+    "openInterestValue": number,       // Units vary by venue: see openInterestValueUnit
+    "openInterestAmountUnit": "base" | "base_both_sides" | "contracts" | null,
+    "openInterestValueUnit": "usd" | "quote" | "usd_both_sides" | null,
+    "contractSize": number,            // Present when the amount is in contracts
     "baseVolume": number,              // Volume in base currency
     "quoteVolume": number,             // Volume in quote currency
     "info": {...}                      // Raw exchange response
@@ -28870,11 +28895,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a derivatives venue: bybit, binance, okx, htx, hyperliquid, deribit, bitget, kucoinfutures, bingx (not gate)",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Derivatives contract symbol (e.g., BTC/USDT:USDT)"
+        description: "Derivatives contract symbol (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       }
     },
     required: ["exchange", "symbol"]
@@ -28907,9 +28934,9 @@ var fetchOpenInterestHistoryTool = {
 Returns time-series open interest data for analyzing trends in derivatives market participation.
 
 Args:
-  - exchange (string, required): Exchange ID with derivatives. Top exchanges: "binance", "bybit", "okx", "bitget".
+  - exchange (string, required): Exchange ID with derivatives. Top exchanges: "binance", "bybit", "gate", "htx". OKX is refused: it reports a whole currency, not the contract.
   - symbol (string, required): Derivatives contract symbol (e.g., "BTC/USDT:USDT", "ETH/USDT:USDT").
-  - timeframe (string, optional): Data interval. Options: "5m", "15m", "30m", "1h", "2h", "4h", "1d". Default: "1h".
+  - timeframe (string, optional): Data interval, default "1h". binance 5m to 1d (about 30 days back), bybit 5m, 15m, 30m, 1h, 4h, 1d.
   - params (object, optional): Exchange-specific params.
 
 Returns:
@@ -28918,8 +28945,10 @@ Returns:
     "symbol": string,                  // Contract symbol
     "timestamp": number,               // Unix timestamp in ms
     "datetime": string,                // ISO datetime
-    "openInterestAmount": number,      // Open interest in contracts
-    "openInterestValue": number,       // Open interest in quote currency
+    "openInterestAmount": number,      // Units vary by venue: see openInterestAmountUnit
+    "openInterestValue": number,       // Units vary by venue: see openInterestValueUnit
+    "openInterestAmountUnit": "base" | "base_both_sides" | "contracts" | null,
+    "openInterestValueUnit": "usd" | "quote" | "usd_both_sides" | null,
     "info": {...}                      // Raw exchange response
   }]
 
@@ -28946,15 +28975,17 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a derivatives venue: binance, bybit, gate, htx, kucoinfutures. OKX is refused: it reports a whole currency, not the contract",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Derivatives contract symbol (e.g., BTC/USDT:USDT)"
+        description: "Derivatives contract symbol (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       },
       timeframe: {
         type: "string",
-        description: "Data interval (e.g., 5m, 15m, 1h, 4h, 1d)"
+        description: "Data interval, default 1h. binance 5m to 1d (about 30 days back), bybit 5m, 15m, 30m, 1h, 4h, 1d, gate 5m to 1d, htx 1h, 4h, 12h, 1d"
       },
       since: {
         type: "number",
@@ -29007,9 +29038,7 @@ Returns:
     "symbol": string,                  // Contract symbol
     "timestamp": number,               // Unix timestamp in ms
     "datetime": string,                // ISO datetime
-    "longShortRatio": number,          // Ratio of longs to shorts
-    "longAccount": number,             // Percentage of long accounts
-    "shortAccount": number,            // Percentage of short accounts
+    "longShortRatio": number,          // Ratio of longs to shorts (each venue defines its own sample)
     "info": {...}                      // Raw exchange response
   }
 
@@ -29037,11 +29066,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, coinbase, kraken, bybit, okx. 100+ exchanges supported via CCXT."
+        description: "Exchange ID of a derivatives venue: binance, bybit, okx, bitget (read through the ratio history)",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: "Derivatives contract symbol (e.g., BTC/USDT:USDT)"
+        description: "Derivatives contract symbol (e.g., BTC/USDT:USDT)",
+        examples: ["BTC/USDT:USDT"]
       },
       timeframe: {
         type: "string",
@@ -29160,7 +29191,7 @@ var fetchLeverageTiersTool = {
 Returns leverage tiers showing maximum leverage, maintenance margin rates, and notional value brackets for derivatives trading pairs. Essential for understanding position sizing limits and margin requirements.
 
 Args:
-  - exchange (string, required): Exchange ID. Options: "binance", "coinbase", "kraken", "bybit", "okx", "kucoin", "bitget", "gate", "htx", "mexc".
+  - exchange (string, required): Exchange ID. Options: "bybit", "gate", "bitget", "htx", "kucoinfutures", "mexc". Binance needs an exchange account.
   - symbol (string, required): Trading pair symbol (e.g., "BTC/USDT:USDT"). Use ccxt_fetch_leverage_tiers_all for all symbols.
 
 Returns:
@@ -29168,7 +29199,7 @@ Returns:
   {
     "BTC/USDT:USDT": [{
       "tier": 1,
-      "currency": "USDT",
+      "currency": "USDT",            // Notional currency (the settle currency)
       "minNotional": 0,
       "maxNotional": 50000,
       "maintenanceMarginRate": 0.004,
@@ -29178,8 +29209,8 @@ Returns:
   }
 
 Examples:
-  - Get BTC leverage tiers on Binance: {"exchange": "binance", "symbol": "BTC/USDT:USDT"}
-  - Get ETH tiers on OKX: {"exchange": "okx", "symbol": "ETH/USDT:USDT"}
+  - Get BTC leverage tiers on Bybit: {"exchange": "bybit", "symbol": "BTC/USDT:USDT"}
+  - Get ETH tiers on Gate: {"exchange": "gate", "symbol": "ETH/USDT:USDT"}
 
 Use when:
   - You need to check maximum leverage for a trading pair
@@ -29201,11 +29232,13 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Top exchanges: binance, bybit, okx, bitget, gate."
+        description: "Exchange ID of a derivatives venue: bybit, gate, bitget, htx, kucoinfutures, mexc. Binance needs an exchange account",
+        examples: ["bybit"]
       },
       symbol: {
         type: "string",
-        description: 'Trading pair symbol (e.g., "BTC/USDT:USDT"). Required for fetchMarketLeverageTiers.'
+        description: 'Trading pair symbol (e.g., "BTC/USDT:USDT"). Required for fetchMarketLeverageTiers.',
+        examples: ["BTC/USDT:USDT"]
       }
     },
     required: ["exchange", "symbol"]
@@ -29302,7 +29335,7 @@ var fetchMarkPricesTool = {
 Returns the mark price used by exchanges for margin calculations and liquidations. Mark prices are derived from index prices and are less susceptible to manipulation than last traded prices.
 
 Args:
-  - exchange (string, required): Exchange ID with derivatives. Supported: "binance", "bybit", "okx", "bitget", "gate".
+  - exchange (string, required): Exchange ID with derivatives. Supported: "binance", "okx", "kucoinfutures", "bingx".
   - symbols (array, required): Array of 1-100 contract symbols (e.g., ["BTC/USDT:USDT", "ETH/USDT:USDT"]).
 
 Returns:
@@ -29322,7 +29355,7 @@ Returns:
   }
 
 Examples:
-  - Get specific mark prices: {"exchange": "bybit", "symbols": ["BTC/USDT:USDT", "ETH/USDT:USDT"]}
+  - Get specific mark prices: {"exchange": "binance", "symbols": ["BTC/USDT:USDT", "ETH/USDT:USDT"]}
 
 Use when:
   - You need mark prices for liquidation/margin calculations
@@ -29344,7 +29377,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Derivatives exchanges: binance, bybit, okx, bitget, gate."
+        description: "Exchange ID. Derivatives exchanges with batch mark prices: binance, okx, kucoinfutures, bingx."
       },
       symbols: {
         type: "array",
@@ -29376,7 +29409,7 @@ var fetchOpenInterestsTool = {
 Returns the total number of outstanding derivative contracts (futures/perpetuals) that have not been settled. More efficient than calling fetchOpenInterest per symbol.
 
 Args:
-  - exchange (string, required): Exchange ID with derivatives. Supported: "binance", "bybit", "okx", "bitget", "gate".
+  - exchange (string, required): Exchange ID with derivatives. Supported: "okx", "htx", "hyperliquid", "kucoinfutures".
   - symbols (array, required): Array of 1-100 contract symbols (e.g., ["BTC/USDT:USDT"]).
 
 Returns:
@@ -29386,15 +29419,18 @@ Returns:
       "symbol": string,
       "timestamp": number,
       "datetime": string,
-      "openInterestAmount": number,
-      "openInterestValue": number,
+      "openInterestAmount": number,  // Units vary by venue: see openInterestAmountUnit
+      "openInterestValue": number,   // Units vary by venue: see openInterestValueUnit
+      "openInterestAmountUnit": "base" | "base_both_sides" | "contracts" | null,
+      "openInterestValueUnit": "usd" | "quote" | "usd_both_sides" | null,
+      "contractSize": number,        // Present when the amount is in contracts
       "info": {...}
     },
     ...
   }
 
 Examples:
-  - Get specific OI: {"exchange": "bybit", "symbols": ["BTC/USDT:USDT", "ETH/USDT:USDT"]}
+  - Get specific OI: {"exchange": "okx", "symbols": ["BTC/USDT:USDT", "ETH/USDT:USDT"]}
 
 Use when:
   - You need open interest across many contracts at once
@@ -29416,7 +29452,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Derivatives exchanges: binance, bybit, okx, bitget, gate."
+        description: "Exchange ID. Derivatives exchanges with batch open interest: okx, htx, hyperliquid, kucoinfutures."
       },
       symbols: {
         type: "array",
@@ -29525,7 +29561,7 @@ var fetchLongShortRatioHistoryTool = {
 Returns time-series long/short ratio data showing how the balance between long and short positions has changed over time. Useful for identifying sentiment shifts and contrarian signals.
 
 Args:
-  - exchange (string, required): Exchange ID with derivatives. Supported: "binance", "bybit", "okx".
+  - exchange (string, required): Exchange ID with derivatives. Supported: "binance", "bybit", "okx", "bitget".
   - symbol (string, required): Derivatives contract symbol (e.g., "BTC/USDT:USDT").
   - timeframe (string, optional): Data interval. Options: "5m", "15m", "30m", "1h", "4h", "1d". Default: "1h".
   - since (number, optional): Unix timestamp in milliseconds to start from.
@@ -29538,10 +29574,8 @@ Returns:
     "symbol": string,
     "timestamp": number,
     "datetime": string,
-    "longShortRatio": number,
-    "longAccount": number,
-    "shortAccount": number,
-    "info": {...}
+    "longShortRatio": number,      // Each venue defines its own sample (accounts or positions)
+    "info": {...}                  // Venue fields, e.g. Binance's longAccount and shortAccount
   }]
 
 Examples:
@@ -29568,7 +29602,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Derivatives exchanges: binance, bybit, okx."
+        description: "Exchange ID. Derivatives exchanges: binance, bybit, okx, bitget."
       },
       symbol: {
         type: "string",
@@ -29694,7 +29728,7 @@ var fetchLeverageTiersAllTool = {
 Returns leverage tier brackets for all markets showing max leverage at each notional value bracket. Uses the batch fetchLeverageTiers method (not fetchMarketLeverageTiers which is per-symbol).
 
 Args:
-  - exchange (string, required): Exchange ID with derivatives. Supported: "binance", "bybit", "okx", "bitget", "gate".
+  - exchange (string, required): Exchange ID with derivatives. Supported: "bybit", "htx", "kucoinfutures", "mexc", "krakenfutures". Binance needs an exchange account; gate is refused (CCXT builds its bulk tiers from market metadata). Use get_leverage_tiers per symbol on gate.
   - symbols (array, required): Array of 1-100 contract symbols.
 
 Returns:
@@ -29702,7 +29736,7 @@ Returns:
   {
     "BTC/USDT:USDT": [{
       "tier": 1,
-      "currency": "USDT",
+      "currency": "USDT",          // Notional currency (the settle currency)
       "minNotional": 0,
       "maxNotional": 50000,
       "maintenanceMarginRate": 0.004,
@@ -29735,7 +29769,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Derivatives exchanges: binance, bybit, okx, bitget, gate."
+        description: "Exchange ID. Derivatives exchanges: bybit, htx, kucoinfutures, mexc, krakenfutures."
       },
       symbols: {
         type: "array",
@@ -29842,7 +29876,7 @@ var fetchOptionChainTool = {
 Returns all available option contracts (calls and puts) for a given underlying asset, organized by expiry and strike price.
 
 Args:
-  - exchange (string, required): Exchange ID with options trading. Supported: "binance", "bybit", "okx".
+  - exchange (string, required): Exchange ID with options trading. Supported: "bybit", "okx", "gate", "deribit".
   - code (string, required): Underlying asset code (e.g., "BTC", "ETH").
 
 Returns:
@@ -29890,7 +29924,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Options exchanges: bybit, okx, binance."
+        description: "Exchange ID. Options exchanges: bybit, okx, gate, deribit."
       },
       code: {
         type: "string",
@@ -29997,7 +30031,7 @@ var fetchUnderlyingAssetsTool = {
 Returns the list of assets (e.g., BTC, ETH) that have options contracts available for trading.
 
 Args:
-  - exchange (string, required): Exchange ID with options trading. Supported: "binance", "bybit", "okx".
+  - exchange (string, required): Exchange ID with options trading. Supported: "okx", "gate".
 
 Returns:
   JSON array or object of underlying assets:
@@ -30009,8 +30043,8 @@ Returns:
   }
 
 Examples:
-  - Get Bybit underlying assets: {"exchange": "bybit"}
   - Get OKX underlying assets: {"exchange": "okx"}
+  - Get Gate underlying assets: {"exchange": "gate"}
 
 Use when:
   - You need to discover which assets have options available
@@ -30031,7 +30065,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Options exchanges: bybit, okx, binance."
+        description: "Exchange ID. Options exchanges: okx, gate."
       }
     },
     required: ["exchange"]
@@ -30065,7 +30099,7 @@ var fetchVolatilityHistoryTool = {
 Returns time-series implied volatility data showing how the market's expectation of future volatility has changed over time.
 
 Args:
-  - exchange (string, required): Exchange ID with options. Supported: "binance", "bybit", "okx".
+  - exchange (string, required): Exchange ID with options. Supported: "bybit", "deribit".
   - code (string, required): Underlying asset code (e.g., "BTC", "ETH").
 
 Returns:
@@ -30079,7 +30113,7 @@ Returns:
 
 Examples:
   - Get BTC IV history: {"exchange": "bybit", "code": "BTC"}
-  - Get ETH IV history: {"exchange": "okx", "code": "ETH"}
+  - Get ETH IV history: {"exchange": "deribit", "code": "ETH"}
 
 Use when:
   - You need to analyze IV trends over time
@@ -30101,7 +30135,7 @@ Error Handling:
     properties: {
       exchange: {
         type: "string",
-        description: "Exchange ID. Options exchanges: bybit, okx, binance."
+        description: "Exchange ID. Options exchanges: bybit, deribit."
       },
       code: {
         type: "string",
@@ -30783,7 +30817,7 @@ var multiVenueInputSchema = {
     },
     symbol: {
       type: "string",
-      description: 'Unified derivatives symbol including its settle currency, e.g. "BTC/USDT:USDT". Venues quoting a different settle currency (e.g. hyperliquid uses BTC/USDC:USDC) return an invalid_input row instead of failing the batch.'
+      description: 'Unified derivatives symbol including its settle currency, e.g. "BTC/USDT:USDT". Venues quoting a different settle currency (e.g. hyperliquid uses BTC/USDC:USDC) return an error row instead of failing the batch.'
     }
   },
   required: ["venues", "symbol"],
@@ -30822,7 +30856,7 @@ Returns:
     "rows": [{
       "exchange": string,
       "runtime_status": "ok" | "invalid_input" | "rate_limited" | "degraded" | "failing" | ...,
-      "data"?: {...},           // unified CCXT funding-rate record when ok
+      "data"?: {...},           // unified CCXT funding-rate record when ok, with its interval
       "error"?: string          // actionable provider error otherwise
     }]
   }
@@ -30830,6 +30864,8 @@ Returns:
 Examples:
   - Compare BTC funding on three venues: {"venues":["binance","bybit","okx"],"symbol":"BTC/USDT:USDT"}
 
+Each rate is a raw fraction for one funding interval, and intervals differ by venue (1h on Hyperliquid and Kraken Futures, 4h or 8h on Binance, 8h on most others). Compare rows only after converting each by its own interval; a row whose interval is null (Binance) cannot be converted.
+
 Use when:
   - You are hunting cross-venue funding divergence / carry for one market
   - You want funding for the same perp on several CEXes without N separate calls
@@ -30968,7 +31004,7 @@ var handlers2 = {
     example: { exchange: "binance", symbol: "BTC/USDT:USDT", limit: 100 }
   }),
   fetchBidsAsks: createHandler2("fetchBidsAsks", {
-    suggestion: "Not all exchanges support this. May fall back to tickers.",
+    suggestion: "Use a venue that serves best bid/ask: binance, bybit, coinbase, mexc, kucoinfutures.",
     alternatives: [
       "ccxt_fetch_tickers - Get full ticker data",
       "ccxt_fetch_orderbook - Get full depth"
@@ -30986,7 +31022,7 @@ var handlers2 = {
     example: { exchange: "binance" }
   }),
   fetchL2OrderBook: createHandler2("fetchL2OrderBook", {
-    suggestion: "Falls back to regular order book if L2 not supported.",
+    suggestion: "Not every venue serves L2 depth (coinbase does not); use get_orderbook there.",
     alternatives: ["ccxt_fetch_orderbook - Get order book"],
     example: { exchange: "binance", symbol: "BTC/USDT", limit: 20 }
   }),
@@ -31085,12 +31121,12 @@ var handlers2 = {
     example: { exchange: "binance", symbol: "BTC/USDT:USDT", limit: 50 }
   }),
   fetchMarketLeverageTiers: createHandler2("fetchMarketLeverageTiers", {
-    suggestion: "Mainly supported on futures exchanges (Binance, Bybit, OKX). Symbol must include settle currency for derivatives.",
+    suggestion: "Supported on bybit, gate, bitget, htx, kucoinfutures and mexc; binance needs an exchange account. Symbol must include settle currency for derivatives.",
     alternatives: [
       "ccxt_fetch_markets - Get market info",
       "ccxt_fetch_funding_rate - Get funding rates"
     ],
-    example: { exchange: "binance", symbol: "BTC/USDT:USDT" }
+    example: { exchange: "bybit", symbol: "BTC/USDT:USDT" }
   }),
   fetchLastPrices: createHandler2("fetchLastPrices", {
     suggestion: "Not all exchanges support fetchLastPrices. Try ccxt_fetch_tickers as fallback.",
@@ -31114,7 +31150,7 @@ var handlers2 = {
       "ccxt_fetch_open_interest - Get single symbol OI",
       "ccxt_fetch_open_interest_history - Get historical OI"
     ],
-    example: { exchange: "binance", symbols: ["BTC/USDT:USDT"] }
+    example: { exchange: "okx", symbols: ["BTC/USDT:USDT"] }
   }),
   fetchFundingIntervals: createHandler2("fetchFundingIntervals", {
     suggestion: "Not all exchanges expose funding intervals. Try checking the funding rate data directly.",
@@ -31148,7 +31184,7 @@ var handlers2 = {
       "ccxt_fetch_leverage_tiers - Get single market tiers",
       "ccxt_fetch_markets - Get market info"
     ],
-    example: { exchange: "binance", symbols: ["BTC/USDT:USDT"] }
+    example: { exchange: "bybit", symbols: ["BTC/USDT:USDT"] }
   }),
   fetchGreeks: createHandler2("fetchGreeks", {
     suggestion: "Very few exchanges support options. Use ccxt_fetch_option_chain to find valid symbols first.",
@@ -31178,7 +31214,7 @@ var handlers2 = {
     example: { exchange: "binance", symbol: "BTC/USDT:USDT" }
   }),
   fetchOptionChain: createHandler2("fetchOptionChain", {
-    suggestion: "Very few exchanges support options (Bybit, OKX, Binance). Use ccxt_fetch_underlying_assets to check availability first.",
+    suggestion: "Options chains are served on bybit, okx, gate and deribit. Use ccxt_fetch_underlying_assets to check availability first.",
     alternatives: [
       "ccxt_fetch_option - Get single option",
       "ccxt_fetch_underlying_assets - Check available assets"
@@ -31194,12 +31230,12 @@ var handlers2 = {
     example: { exchange: "bybit", symbol: "BTC/USDT:USDT-250328-80000-C" }
   }),
   fetchUnderlyingAssets: createHandler2("fetchUnderlyingAssets", {
-    suggestion: "Very few exchanges support options trading. Try Bybit, OKX, or Binance.",
+    suggestion: "Underlying assets are served on okx and gate.",
     alternatives: [
       "ccxt_fetch_option_chain - Get options for an asset",
       "ccxt_fetch_markets - Get all markets including options"
     ],
-    example: { exchange: "bybit" }
+    example: { exchange: "okx" }
   }),
   fetchVolatilityHistory: createHandler2("fetchVolatilityHistory", {
     suggestion: "Very limited exchange support. Only major underlyings (BTC, ETH) typically available.",
@@ -31229,7 +31265,7 @@ var handlers2 = {
     suggestion: "Not all exchanges support convert quotes. Some require amount parameter.",
     alternatives: [
       "ccxt_fetch_ticker - Get spot rate for comparison",
-      "ccxt_fetch_convert_currencies - Check available currencies"
+      "ccxt_fetch_currencies - Check listed currencies"
     ],
     example: {
       exchange: "binance",
@@ -42140,7 +42176,7 @@ Use when:
   - You are correlating OI changes with funding or liquidation events across venues
 
 Don't use when:
-  - You need CURRENT open interest (use ccxt_fetch_open_interest_multi or get_open_interest)
+  - You need CURRENT open interest (use get_open_interest)
   - You need one venue's own OI history endpoint shape (use get_open_interest_history via CCXT)`,
         inputSchema: historyInputSchema(
           'Base asset ticker to fetch open-interest snapshots for, e.g. "ETH". Required.'
@@ -42251,8 +42287,7 @@ Use when:
   - You need liquidation context around a historical funding/OI/basis move
 
 Don't use when:
-  - You need LIVE liquidations (use get_liquidations via CCXT)
-  - You need aggregate liquidation totals per venue right now (live venue tools)`,
+  - You need liquidations from the last hour (the archive updates hourly; Hive has no live liquidation feed)`,
         inputSchema: historyInputSchema(
           'Base asset ticker to fetch liquidation events for, e.g. "BTC". Required.'
         ),
@@ -46217,7 +46252,7 @@ function buildExampleArgs(name, inputSchema) {
   const example = {};
   const required = new Set(inputSchema?.required ?? []);
   for (const [paramName, schema] of Object.entries(props)) {
-    if (!required.has(paramName) && Object.keys(example).length >= (required.size || 1))
+    if (!required.has(paramName) && !Array.isArray(schema.examples) && Object.keys(example).length >= (required.size || 1))
       continue;
     example[paramName] = getExampleValue(paramName, schema, name);
   }
@@ -46227,6 +46262,8 @@ function buildExampleArgs(name, inputSchema) {
 function getExampleValue(paramName, schema, toolName) {
   if (schema.enum && schema.enum.length > 0) return schema.enum[0];
   if (schema.default !== void 0) return schema.default;
+  if (Array.isArray(schema.examples) && schema.examples.length > 0)
+    return schema.examples[0];
   const lowerParam = paramName.toLowerCase();
   const type = schema.type ?? "string";
   if (type === "boolean") return true;
@@ -47545,6 +47582,7 @@ var MORALIS_TOKEN_SCORE_NONE = "No replacement for the Moralis token score. Use
 var MORALIS_WALLET_CHAINS = "Use get_wallet_balances across networks, or alchemy_get_tokens_by_wallet with several networks, to see which chains hold assets; Hive has no first and last activity per chain.";
 var CCXT_PRIVATE = "because every exchange that serves it requires an authenticated exchange account";
 var CCXT_BORROW_REPLACEMENT = "Use ccxt_fetch_borrow_rate_history or ccxt_fetch_borrow_rate_histories (public) and read the latest point.";
+var CCXT_WRONG_DATA_DATE = "2026-10-22";
 var UNSERVABLE_TOOLS = {
   get_coin_circulating_supply_chart: {
     reason: COINGECKO_ENTERPRISE,
@@ -47622,6 +47660,26 @@ var UNSERVABLE_TOOLS = {
     reason: CCXT_PRIVATE,
     replacement: CCXT_BORROW_REPLACEMENT
   },
+  get_liquidations: {
+    reason: "because it served wrong data: none of the venues it named supports liquidations in Hive's CCXT build, Gate reports the opposite side and returns nothing for any start time, HTX reports contract counts as base amounts, and Deribit returns bankruptcy settlements",
+    replacement: "Use archive_get_liquidations_history for liquidation events across venues, updated hourly since April 2025.",
+    date: CCXT_WRONG_DATA_DATE
+  },
+  ccxt_fetch_open_interest_multi: {
+    reason: "because it put open interest measured in different units side by side: base coin on Binance and Hyperliquid, contracts on OKX and HTX, and both sides of the book on Bybit",
+    replacement: "Call get_open_interest once per venue; each record now names its units. Use archive_get_open_interest_history for cross-venue history.",
+    date: CCXT_WRONG_DATA_DATE
+  },
+  ccxt_fetch_funding_intervals: {
+    reason: "because it documented fields CCXT does not return and called 8 hours the norm, while most Binance contracts settle every 4 hours",
+    replacement: "Use get_funding_rate, whose interval field is the contract's current funding interval (null where the venue does not report it), or archive_get_funding_history, whose rows carry each settlement's interval.",
+    date: CCXT_WRONG_DATA_DATE
+  },
+  ccxt_fetch_convert_currencies: {
+    reason: "because every venue it named needs an exchange account, so it answered with every listed currency, or an empty list reported as success",
+    replacement: "No replacement: convert listings need an exchange account. Use get_exchange_currencies for the currencies an exchange lists.",
+    date: CCXT_WRONG_DATA_DATE
+  },
   alchemy_simulate_asset_changes: {
     reason: ALCHEMY_SIMULATION_SUNSET,
     replacement: ALCHEMY_SIMULATION_REPLACEMENT,
@@ -48820,7 +48878,6 @@ var ToolRegistry = [
       "get_open_interest",
       "get_open_interest_history",
       "get_long_short_ratio",
-      "get_liquidations",
       "get_stablecoin_dominance",
       "get_leverage_tiers",
       // CEX exchange data (moved from On-Chain DEX — these are centralized exchange tools)
@@ -48842,7 +48899,6 @@ var ToolRegistry = [
       "ccxt_fetch_last_prices",
       "ccxt_fetch_mark_prices",
       "ccxt_fetch_open_interests",
-      "ccxt_fetch_funding_intervals",
       "ccxt_fetch_long_short_ratio_history",
       "ccxt_fetch_deposit_withdraw_fees",
       "ccxt_fetch_leverage_tiers_all",
@@ -48856,12 +48912,10 @@ var ToolRegistry = [
       "ccxt_fetch_underlying_assets",
       "ccxt_fetch_volatility_history",
       "ccxt_fetch_settlement_history",
-      "ccxt_fetch_convert_currencies",
       "ccxt_fetch_convert_quote",
       "ccxt_fetch_borrow_rate_history",
       "ccxt_fetch_borrow_rate_histories",
       "ccxt_fetch_funding_rates_multi",
-      "ccxt_fetch_open_interest_multi",
       "alchemy_get_token_prices_by_symbol",
       "alchemy_get_token_prices_by_address",
       "alchemy_get_historical_token_prices",
@@ -53660,7 +53714,7 @@ var TASK_TOOLSET_CATALOG = [
       "get_recent_trades",
       "get_funding_rates",
       "get_open_interest",
-      "get_liquidations",
+      "archive_get_liquidations_history",
       "get_options_overview",
       "hyperliquid_get_perp_volume_leaderboard",
       "hyperliquid_get_predicted_fundings",
@@ -53676,7 +53730,6 @@ var TASK_TOOLSET_CATALOG = [
       "ccxt_fetch_adl_rank",
       "ccxt_fetch_borrow_rate_history",
       "ccxt_fetch_funding_rates_multi",
-      "ccxt_fetch_open_interest_multi",
       "alchemy_solana_get_compressed_mint_token_holders",
       "alchemy_get_token_prices_by_symbol",
       "alchemy_get_token_prices_by_address",
@@ -58615,6 +58668,68 @@ var PUBLIC_BORROW_HISTORY_METHODS = /* @__PURE__ */ new Set([
   "fetchBorrowRateHistories"
 ]);
 var PUBLIC_BORROW_HISTORY_EXCHANGES = /* @__PURE__ */ new Set(["okx", "myokx", "okxus"]);
+var VENUE_ALIASES = {
+  binanceusdm: "binance",
+  binancecoinm: "binance",
+  myokx: "okx",
+  okxus: "okx"
+};
+var OPEN_INTEREST_UNITS = {
+  current: {
+    binance: { linear: ["base", null], inverse: ["contracts", null] },
+    bybit: {
+      linear: ["base_both_sides", null],
+      inverse: [null, "usd_both_sides"]
+    },
+    okx: { linear: ["contracts", "usd"], inverse: ["contracts", "usd"] },
+    htx: { linear: ["contracts", "quote"], inverse: ["contracts", null] },
+    hyperliquid: { linear: ["base", null] },
+    deribit: { inverse: [null, "usd"] }
+  },
+  history: {
+    binance: { linear: ["base", "quote"] },
+    bybit: {
+      linear: ["base_both_sides", null],
+      inverse: [null, "usd_both_sides"]
+    },
+    gate: { linear: ["contracts", "usd"] },
+    // HTX history is requested in coins (amount_type 2), unlike current OI.
+    htx: { linear: ["base", "quote"] }
+  }
+};
+function labelOpenInterest(record, call, venue, market) {
+  if (!record || typeof record !== "object") return record;
+  const type = market?.inverse ? "inverse" : market?.linear ? "linear" : null;
+  const units = type ? OPEN_INTEREST_UNITS[call][venue]?.[type] : void 0;
+  const amountUnit = record.openInterestAmount == null ? null : units?.[0] ?? null;
+  return {
+    ...record,
+    openInterestAmountUnit: amountUnit,
+    openInterestValueUnit: record.openInterestValue == null ? null : units?.[1] ?? null,
+    ...amountUnit === "contracts" ? { contractSize: market?.contractSize ?? null } : {}
+  };
+}
+var MARKET_LABELLED_METHODS = /* @__PURE__ */ new Set([
+  "fetchOpenInterest",
+  "fetchOpenInterestHistory",
+  "fetchMarketLeverageTiers"
+]);
+var TIER_CURRENCY_FIX_VENUES = /* @__PURE__ */ new Set(["gate", "bybit"]);
+function refusedCall(method, venue, market) {
+  if (method === "fetchOpenInterestHistory" && venue === "okx") {
+    return "Invalid arguments: okx open-interest history is not served. OKX reports it for a whole currency (every swap and future on it, in USD), not for the contract you asked for. Use get_open_interest on okx for the current figure, or get_open_interest_history on binance or bybit.";
+  }
+  if (method === "fetchOpenInterestHistory" && venue === "binance" && market?.inverse) {
+    return "Invalid arguments: binance open-interest history for coin-margined (inverse) contracts comes back empty in Hive's CCXT build. Use the USDT-margined contract (e.g. BTC/USDT:USDT) or bybit.";
+  }
+  if (method === "fetchFundingRateHistory" && venue === "deribit") {
+    return "Invalid arguments: deribit funding history is not served. CCXT returns hourly rows that each carry the trailing 8-hour rate, so the rows overlap and summing them overstates funding about 8x. Use get_funding_rate on deribit for the current trailing 8-hour rate, or archive_get_funding_history for settled Deribit funding.";
+  }
+  if (method === "fetchLeverageTiers" && venue === "gate") {
+    return "Invalid arguments: gate bulk leverage tiers are not served. CCXT builds them from market metadata (2 tiers where Gate has 19). Call get_leverage_tiers per symbol on gate.";
+  }
+  return null;
+}
 function isGeoBlockedError(err) {
   if (!(err instanceof Error)) return false;
   const msg = err.message.toLowerCase();
@@ -58870,6 +58985,71 @@ var CCXTClient = class {
         return { handled: false };
     }
   }
+  /** The CCXT market for a symbol, or undefined when it does not resolve. */
+  async _market(exchange, symbol) {
+    if (typeof symbol !== "string") return void 0;
+    const ex = exchange;
+    try {
+      await ex.loadMarkets();
+      return ex.market(symbol);
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * Labels what CCXT leaves ambiguous: the funding interval (null when the
+   * venue does not report it), open-interest units, and the symbol and
+   * notional currency of Gate and Bybit leverage tiers, which the pinned
+   * build gets wrong (upstream fixed them in 4.5.89).
+   */
+  _label(method, venue, exchange, market, result2) {
+    const marketOf = (symbol) => {
+      try {
+        return exchange.market(
+          symbol
+        );
+      } catch {
+        return void 0;
+      }
+    };
+    const withInterval = (rate) => rate && typeof rate === "object" ? { ...rate, interval: rate.interval ?? null } : rate;
+    const eachRow = (fn) => Array.isArray(result2) ? result2.map(fn) : result2;
+    const bySymbol = (fn) => result2 && typeof result2 === "object" && !Array.isArray(result2) ? Object.fromEntries(
+      Object.entries(result2).map(([symbol, value]) => [
+        symbol,
+        fn(value, symbol)
+      ])
+    ) : result2;
+    const tiersOf = (tiers, tierMarket) => Array.isArray(tiers) ? tiers.map((tier) => ({
+      ...tier,
+      symbol: tierMarket?.symbol ?? tier.symbol,
+      currency: tierMarket?.settle ?? null
+    })) : tiers;
+    switch (method) {
+      case "fetchFundingRate":
+        return withInterval(result2);
+      case "fetchFundingRates":
+        return bySymbol(withInterval);
+      case "fetchFundingRateHistory":
+        return eachRow(withInterval);
+      case "fetchOpenInterest":
+        return labelOpenInterest(result2, "current", venue, market);
+      case "fetchOpenInterests":
+        return bySymbol(
+          (record, symbol) => labelOpenInterest(record, "current", venue, marketOf(symbol))
+        );
+      case "fetchOpenInterestHistory":
+        return eachRow(
+          (record) => labelOpenInterest(record, "history", venue, market)
+        );
+      case "fetchMarketLeverageTiers":
+        return TIER_CURRENCY_FIX_VENUES.has(venue) ? tiersOf(result2, market) : result2;
+      case "fetchLeverageTiers":
+        return TIER_CURRENCY_FIX_VENUES.has(venue) ? bySymbol((tiers, symbol) => tiersOf(tiers, marketOf(symbol))) : result2;
+      default:
+        return result2;
+    }
+  }
   /**
    * Execute a CCXT method on a specific exchange (no fallback logic here).
    */
@@ -58883,6 +59063,10 @@ var CCXTClient = class {
       }
       const exchange = await this.getExchange(exchangeId);
       let result2;
+      const venue = VENUE_ALIASES[exchangeId] ?? exchangeId;
+      const market = MARKET_LABELLED_METHODS.has(method) ? await this._market(exchange, methodParams.symbol) : void 0;
+      const refusal = refusedCall(method, venue, market);
+      if (refusal) throw new Error(refusal);
       const hasCapability = exchange.has;
       if (hasCapability && hasCapability[method] !== true && hasCapability[method] !== "emulated") {
         const fallback = await this._tryPublicFallback(
@@ -58905,7 +59089,7 @@ var CCXTClient = class {
           return result2;
         }
         throw new Error(
-          `${exchangeId} does not support ${method}. Try a different exchange (e.g., kraken, coinbase, okx).`
+          `${exchangeId} does not support ${method} in Hive's CCXT build. Try another exchange; the tool description names venues that do.`
         );
       }
       switch (method) {
@@ -59119,7 +59303,8 @@ var CCXTClient = class {
           }
           result2 = await exchange.fetchLongShortRatioHistory(
             methodParams.symbol,
-            methodParams.timeframe,
+            // The documented default; CCXT's own leaves Binance on daily rows.
+            methodParams.timeframe || "1h",
             methodParams.since,
             methodParams.limit,
             methodParams.params
@@ -59258,6 +59443,7 @@ var CCXTClient = class {
             `Method '${method}' is not supported. Supported methods: fetchTicker, fetchTickers, fetchOHLCV, fetchOrderBook, fetchTrades, fetchMarkets, fetchCurrencies, fetchFundingRate, etc.`
           );
       }
+      result2 = this._label(method, venue, exchange, market, result2);
       secureLogger.toolCall(`CCXT:${method}`, true, Date.now() - startTime, {
         exchange: exchangeId,
         params: Object.keys(methodParams)
@@ -59951,11 +60137,6 @@ var TOOL_PROBE_ARGS = {
     exchange: CCXT_SPOT_EXCHANGE,
     symbols: [CCXT_SPOT_SYMBOL]
   },
-  get_liquidations: {
-    exchange: "gate",
-    symbol: CCXT_SWAP_SYMBOL,
-    limit: 10
-  },
   get_leverage_tiers: {
     exchange: CCXT_DERIVATIVES_EXCHANGE,
     symbol: CCXT_SWAP_SYMBOL
@@ -59992,10 +60173,6 @@ var TOOL_PROBE_ARGS = {
     exchange: "okx",
     symbols: [CCXT_SWAP_SYMBOL]
   },
-  ccxt_fetch_funding_intervals: {
-    exchange: "bitget",
-    symbols: [CCXT_SWAP_SYMBOL]
-  },
   ccxt_fetch_long_short_ratio_history: {
     exchange: CCXT_DERIVATIVES_EXCHANGE,
     symbol: CCXT_SWAP_SYMBOL,
@@ -60015,7 +60192,6 @@ var TOOL_PROBE_ARGS = {
     symbol: CCXT_SWAP_SYMBOL,
     limit: 10
   },
-  ccxt_fetch_convert_currencies: { exchange: "bybit" },
   ccxt_fetch_convert_quote: {
     exchange: "bybit",
     fromCode: "BTC",
@@ -60042,10 +60218,6 @@ var TOOL_PROBE_ARGS = {
     venues: ["binance", "okx"],
     symbol: CCXT_SWAP_SYMBOL
   },
-  ccxt_fetch_open_interest_multi: {
-    venues: ["binance", "okx"],
-    symbol: CCXT_SWAP_SYMBOL
-  },
   // HIP-3 builder-dex reads require an explicit dex; "xyz" is the flagship
   // equity-perp builder DEX. Kept out of the provider defaults so main-DEX
   // probes stay unscoped.

package/build/cli.js

@@ -3453,7 +3453,7 @@ program2.hook("preAction", (thisCommand) => {
   setCliFlags({ apiKey: opts.apiKey, noRetry: opts.retry === false });
 });
 program2.action(async () => {
-  const { startStdio } = await import("./serve-JNZIXB55.js");
+  const { startStdio } = await import("./serve-47QIM7OD.js");
   await startStdio(program2.opts().envFile);
 });
 program2.command("serve").description(
@@ -3471,10 +3471,10 @@ program2.command("serve").description(
       );
       process.exit(ExitCode.INVALID_ARGS);
     }
-    const { startHttp } = await import("./serve-JNZIXB55.js");
+    const { startHttp } = await import("./serve-47QIM7OD.js");
     await startHttp(port, program2.opts().envFile);
   } else {
-    const { startStdio } = await import("./serve-JNZIXB55.js");
+    const { startStdio } = await import("./serve-47QIM7OD.js");
     await startStdio(program2.opts().envFile, { local: opts.local });
   }
 });
@@ -3742,7 +3742,7 @@ program2.command("doctor").description("Diagnose environment and server connecti
   "--fix",
   "Rewrite stale Hive entries in MCP client configs (backs each file up first)"
 ).action(async (opts) => {
-  const { runDoctor } = await import("./doctor-SKJANP76.js");
+  const { runDoctor } = await import("./doctor-DUXJWV3F.js");
   await runDoctor(opts);
 });
 program2.command("upgrade").description("Update Hive to the latest published version").action(async () => {
@@ -3790,7 +3790,7 @@ program2.command("usage").description("Show your API usage and plan limits").act
   await runUsage();
 });
 program2.command("status").description("Quick health and version check").action(async () => {
-  const { runStatus } = await import("./doctor-SKJANP76.js");
+  const { runStatus } = await import("./doctor-DUXJWV3F.js");
   await runStatus();
 });
 program2.command("open [target]").description("Open Hive dashboard, docs, status, or GitHub in browser").action(async (target) => {

package/build/{doctor-SKJANP76.js → doctor-DUXJWV3F.js}

@@ -296,7 +296,7 @@ ${fails === 0 ? "All checks passed" : `${fails} issues found`}${warns ? ` (${war
   if (fails > 0) process.exit(1);
 }
 async function runStatus() {
-  const { SERVER_VERSION } = await import("./mcpServer-TKLG6IOW.js");
+  const { SERVER_VERSION } = await import("./mcpServer-NWKQ4LCN.js");
   const { resolveApiKey, resolveApiUrl } = await import("./config-dir-2QLA5PXD.js");
   const { getActiveProfile, maskKey } = await import("./auth-6XVL5CE3.js");
   const apiUrl = resolveApiUrl();

package/build/{mcpServer-TKLG6IOW.js → mcpServer-NWKQ4LCN.js}

@@ -9,7 +9,7 @@ import {
   getToolsForScope,
   memoizedJsonSchemaToZodInputSchema,
   memoizedJsonSchemaToZodOutputSchema
-} from "./chunk-PFX4AJNR.js";
+} from "./chunk-ZRAW5MXW.js";
 import "./chunk-QYK3EWTE.js";
 import "./chunk-EPF36Q3Z.js";
 import {

package/build/monitor-worker.js

@@ -4,7 +4,7 @@ import {
   executeToolByName,
   refundCredits,
   refundSettled
-} from "./chunk-4GBOUVUD.js";
+} from "./chunk-V7TBL47R.js";
 import {
   HyperliquidAPI,
   MIN_MONITOR_CADENCE_MS,
@@ -17,7 +17,7 @@ import {
   monitorCadenceIntervalMs,
   runScheduledHealthCanaries,
   secureLogger
-} from "./chunk-PFX4AJNR.js";
+} from "./chunk-ZRAW5MXW.js";
 import "./chunk-QYK3EWTE.js";
 import "./chunk-EPF36Q3Z.js";
 import "./chunk-ZXKFJQDE.js";

package/build/release.json

@@ -1,8 +1,8 @@
 {
   "package": "hive-intelligence",
-  "version": "1.12.1",
-  "buildSha": "bb47e637ee6445ab8d7a79280b71bf8fdec93b92",
-  "imageDigest": "sha256:fb28943da2081be56b56b5086361f6dd4c41ade2c8b5c1ea3e9ea46c605fd92c",
+  "version": "1.13.0",
+  "buildSha": "97bb981841e65ba3c48c31bf14ae02fdecd7b502",
+  "imageDigest": "sha256:17ebc81537ba98c83bb68acbf974e0a4d2c96990cbf70a7632a4fd9d78f5b657",
   "deployedUrl": "https://mcp.hiveintelligence.xyz",
-  "manifest": "https://raw.githubusercontent.com/hive-intel/hive-sdk/v1.12.1/releases/v1.12.1.json"
+  "manifest": "https://raw.githubusercontent.com/hive-intel/hive-sdk/v1.13.0/releases/v1.13.0.json"
 }

package/build/{serve-JNZIXB55.js → serve-47QIM7OD.js}

@@ -49,7 +49,7 @@ async function startStdio(envFile, opts = {}) {
   console.log = (...args) => console.error("[LOG]", ...args);
   if (resolveStdioMode(opts) === "proxy") return startStdioProxy();
   const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
-  const { createHiveMcpServer, SERVER_NAME, SERVER_VERSION } = await import("./mcpServer-TKLG6IOW.js");
+  const { createHiveMcpServer, SERVER_NAME, SERVER_VERSION } = await import("./mcpServer-NWKQ4LCN.js");
   const { getPendingUpdateVersion } = await import("./update-check-36QU6PKA.js");
   const transport = new StdioServerTransport();
   const pendingUpdate = getPendingUpdateVersion();

package/build/server.js

@@ -8,7 +8,7 @@ import {
   getWalletStatus,
   refundCredits,
   refundSettled
-} from "./chunk-4GBOUVUD.js";
+} from "./chunk-V7TBL47R.js";
 import {
   CategoryEndpoints,
   HERO_TOOL_NAMES,
@@ -105,7 +105,7 @@ import {
   validateEndpointArgs,
   verifyApiKey,
   waitForRedisAvailability
-} from "./chunk-PFX4AJNR.js";
+} from "./chunk-ZRAW5MXW.js";
 import {
   HIVE_AGENT_SKILLS
 } from "./chunk-QYK3EWTE.js";

package/build/stdio.js

@@ -6,7 +6,7 @@ import {
 import {
   createHiveMcpServer,
   secureLogger
-} from "./chunk-PFX4AJNR.js";
+} from "./chunk-ZRAW5MXW.js";
 import "./chunk-QYK3EWTE.js";
 import "./chunk-EPF36Q3Z.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hive-intelligence",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "Evidence-backed crypto due diligence for AI agents, with sources, freshness, and a runtime receipt on every call.",
   "mcpName": "xyz.hiveintelligence/mcp",
   "type": "module",