bykaranteli-mcp 0.34.2 → 0.34.4

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 Notable changes to the `bykaranteli-mcp` package. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Dates are UTC and come from the git tag of each release (the version commit where no tag exists). The tool count is the number of tools the server registers in that release.
 
+## [0.34.4] - 2026-10-09
+
+67 tools. README only; the server code is the same as 0.34.3.
+
+### Changed
+
+- README plan table and x402 paragraph follow the 2026-10-09 plan ladder: Builder includes 1,000 x402 catalog calls a month over the last 90 days at up to 5,000 rows a call, with raw record routes paid per call; Business 10,000 a month over the last 365 days with raw records; Scale has no monthly ceiling and reads the whole archive. A call past the ceiling, before the window or on a raw record route below Business answers with the way to pay per call (a prepaid key in `x-api-key`, or a wallet without the account key) or to move up a plan.
+- README bulk exports line names its window: Business the last 365 days, Scale the whole archive (Scale listed "daily raw" exports, which the plan never carried).
+
+## [0.34.3] - 2026-10-08
+
+67 tools.
+
+### Fixed
+
+- `chart_url` of `get_liquidations` and `get_etf_flows` opens the symbol or asset the call filtered on (the dataset path carried no filter, so every link opened BTCUSDT).
+- `chart_url` of `get_options_snapshot` with a venue sets the options levels' own key (`lvv`), not the OI and funding panes' venue (`v`), so the chart draws the same venue's levels the answer reports.
+
 ## [0.34.2] - 2026-10-08
 
 67 tools.

package/README.md

@@ -179,9 +179,9 @@ Server: MIT. Data: personal and research use with attribution "ByKaranteli (byka
 |---|---|---|---|
 | Free API | 30 / min | 15,000 | public pages |
 | Terminal | 60 / min | 150,000 | public pages |
-| Builder | 300 / min | 1,000,000 fair use | member depth, x402 catalog included, each call counts as 10 requests of the monthly fair use |
-| Business | 1,200 / min | 3,000,000 fair use | member depth, commercial licence, x402 catalog included, each call counts as 10 requests of the monthly fair use, monthly bulk |
-| Scale | 3,000 / min | 10,000,000 fair use | member depth, derived redistribution, x402 catalog included, each call counts as 10 requests of the monthly fair use, daily raw |
+| Builder | 300 / min | 1,000,000 fair use | member depth, x402 catalog: 1,000 calls a month included over the last 90 days at up to 5,000 rows a call, summary series only, raw record routes paid per call |
+| Business | 1,200 / min | 3,000,000 fair use | member depth, commercial licence, x402 catalog: 10,000 calls a month included over the last 365 days with raw records, monthly bulk exports over the same window |
+| Scale | 3,000 / min | 10,000,000 fair use | member depth, derived redistribution, x402 catalog with no monthly ceiling over the whole archive with raw records, monthly bulk exports over the whole archive |
 
 Prices: https://bykaranteli.com/pricing
 
@@ -195,4 +195,7 @@ raw records beyond the live snapshots, bykaranteli.com also exposes pay-per-call
 x402 endpoints for anonymous agents (USDC on Solana or Base, priced per call,
 no account): <https://bykaranteli.com/developers#x402> · machine catalog:
 <https://bykaranteli.com/api/x402>. Builder, Business and Scale keys call those
-routes unpaid; each call counts as 10 requests of the monthly fair use.
+routes unpaid within the plan's catalog allowance (table above); each included
+call also counts as 10 requests of the monthly fair use. A call the plan does not
+include answers `x402_allowance_used`, `history_window` or `raw_tier_required`:
+pay it with a prepaid key in `x-api-key`, or without the account key from a wallet.

package/dist/provenance.js

@@ -63,12 +63,13 @@ function chartSymbol(q) {
         return "BTCUSDT";
     return /USDT$|USD$|PERP$/.test(raw) ? raw : `${raw}USDT`;
 }
-/** The venue and the window of the request as chart keys (empty when the request names neither). */
-function chartExtras(q, periodMs) {
+/** The venue and the window of the request as chart keys (empty when the request names neither). `venueKey` is the
+ * chart key the venue belongs to: v for the OI and funding panes, lvv for the options levels (2026-10-08). */
+function chartExtras(q, periodMs, venueKey = "v") {
     let out = "";
     const venue = (q.get("venue") ?? "").toLowerCase().replace(/[^a-z0-9]/g, "");
-    if (venue && venue !== "binance" && venue !== "all")
-        out += `&v=${venue}`;
+    if (venue && venue !== "all" && (venueKey === "lvv" || venue !== "binance"))
+        out += `&${venueKey}=${venue}`;
     const toRaw = q.get("to");
     const fromRaw = q.get("from");
     const to = toRaw ? Date.parse(toRaw) : NaN;
@@ -95,7 +96,7 @@ export function chartUrlForApiPath(path) {
         return `${CHART_BASE}?s=${s}&panes=liquidations,oi&heat=1&pr=1&rv=1${x}`;
     }
     if (clean.startsWith("/api/public/options"))
-        return `${CHART_BASE}?s=${s}&panes=oi&lv=1&heat=1&pr=0${x}`;
+        return `${CHART_BASE}?s=${s}&panes=oi&lv=1&heat=1&pr=0${chartExtras(q, 0, "lvv")}`;
     if (clean.startsWith("/api/public/funding") || clean.startsWith("/api/public/heatmap"))
         return `${CHART_BASE}?s=${s}&panes=funding,oi&heat=1&pr=0${x}`;
     if (clean.startsWith("/api/public/oi"))

package/dist/tools.js

@@ -234,7 +234,7 @@ export function registerByKaranteliTools(server, options) {
                     ? `rows is capped at ${MAX_ROWS} of ${filtered.length} matching rows (largest first). Use summary.totals and summary.by_date for complete figures, or pass a symbol filter. ` + baseNote
                     : baseNote,
                 source: `${PUBLIC_URL}/liquidations`,
-                provenance: provenanceFor(d, "/api/v1/public/datasets/liquidations-daily.json", "/liquidations"),
+                provenance: provenanceFor(d, `/api/v1/public/datasets/liquidations-daily.json${wantSymbol ? `?symbol=${wantSymbol}` : ""}`, "/liquidations"),
             });
         }
         catch (err) {
@@ -273,7 +273,7 @@ export function registerByKaranteliTools(server, options) {
                 truncated: dates.length < new Set(filtered.map((r) => String(r.date))).size,
                 note: "Finalized US trading days only; a positive net_inflow_usd means the funds bought more of the asset than they sold that day. window_net_inflow_usd sums the returned window per asset.",
                 source: `${PUBLIC_URL}/etf`,
-                provenance: provenanceFor(d, "/api/v1/public/datasets/etf-flows.json", "/etf"),
+                provenance: provenanceFor(d, `/api/v1/public/datasets/etf-flows.json${asset ? `?asset=${asset}` : ""}`, "/etf"),
             });
         }
         catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bykaranteli-mcp",
-  "version": "0.34.2",
+  "version": "0.34.4",
   "description": "MCP server for live crypto derivatives data from bykaranteli.com: funding rates, funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance. 67 read-only and account tools (the alert and watchlist tools act on your own account), free account key, paid depth via plans or x402.",
   "type": "module",
   "bin": {