@guiie/buda-mcp 1.2.2 → 1.4.0

package/dist/tools/spread.js

@@ -4,8 +4,10 @@ import { CACHE_TTL } from "../cache.js";
 import { validateMarketId } from "../validation.js";
 export const toolSchema = {
     name: "get_spread",
-    description: "Calculate the bid/ask spread for a Buda.com market. " +
-        "Returns the best bid, best ask, absolute spread, and spread as a percentage of the ask price.",
+    description: "Returns the best bid, best ask, absolute spread, and spread percentage for a Buda.com market. " +
+        "All prices are floats in the quote currency (e.g. CLP). spread_percentage is a float in percent " +
+        "(e.g. 0.15 means 0.15%). Use this to evaluate liquidity before placing a large order. " +
+        "Example: 'Is BTC-CLP liquid enough to buy 10M CLP without significant slippage?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -52,12 +54,12 @@ export function register(server, client, cache) {
             const spreadPct = (spreadAbs / ask) * 100;
             const result = {
                 market_id: ticker.market_id,
-                currency,
-                best_bid: bid.toString(),
-                best_ask: ask.toString(),
-                spread_absolute: spreadAbs.toFixed(2),
-                spread_percentage: spreadPct.toFixed(4) + "%",
-                last_price: ticker.last_price[0],
+                price_currency: currency,
+                best_bid: bid,
+                best_ask: ask,
+                spread_absolute: parseFloat(spreadAbs.toFixed(2)),
+                spread_percentage: parseFloat(spreadPct.toFixed(4)),
+                last_price: parseFloat(ticker.last_price[0]),
             };
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }],

package/dist/tools/technical_indicators.d.ts

@@ -0,0 +1,39 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+            period: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type TechnicalIndicatorsArgs = {
+    market_id: string;
+    period: "1h" | "4h" | "1d";
+    limit?: number;
+};
+export declare function handleTechnicalIndicators(args: TechnicalIndicatorsArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=technical_indicators.d.ts.map

package/dist/tools/technical_indicators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"technical_indicators.d.ts","sourceRoot":"","sources":["../../src/tools/technical_indicators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA6BtB,CAAC;AAsGF,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CA2GhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAyBpE"}

package/dist/tools/technical_indicators.js

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateMarketId } from "../validation.js";
+import { aggregateTradesToCandles } from "../utils.js";
+export const toolSchema = {
+    name: "get_technical_indicators",
+    description: "Computes RSI (14), MACD (12/26/9), Bollinger Bands (20, 2σ), SMA 20, and SMA 50 " +
+        "from Buda trade history — no external data or libraries. " +
+        "Uses at least 500 trades for reliable results (set limit=1000 for maximum depth). " +
+        "Returns latest indicator values and signal interpretations (overbought/oversold, crossover, band position). " +
+        "If fewer than 50 candles are available after aggregation, returns a structured warning instead. " +
+        "Example: 'Is BTC-CLP RSI overbought on the 4-hour chart?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            period: {
+                type: "string",
+                description: "Candle period: '1h', '4h', or '1d'. Default: '1h'.",
+            },
+            limit: {
+                type: "number",
+                description: "Number of raw trades to fetch (default: 500, max: 1000). " +
+                    "More trades = more candles = more reliable indicators.",
+            },
+        },
+        required: ["market_id"],
+    },
+};
+// ---- Pure math helpers ----
+function sma(values, n) {
+    const slice = values.slice(-n);
+    return slice.reduce((sum, v) => sum + v, 0) / slice.length;
+}
+function ema(values, period) {
+    if (values.length < period)
+        return [];
+    const k = 2 / (period + 1);
+    const result = [];
+    // Seed with SMA of first `period` values
+    result.push(values.slice(0, period).reduce((s, v) => s + v, 0) / period);
+    for (let i = period; i < values.length; i++) {
+        result.push(values[i] * k + result[result.length - 1] * (1 - k));
+    }
+    return result;
+}
+function rsi(closes, period = 14) {
+    if (closes.length < period + 1)
+        return null;
+    const gains = [];
+    const losses = [];
+    for (let i = 1; i < closes.length; i++) {
+        const diff = closes[i] - closes[i - 1];
+        gains.push(diff > 0 ? diff : 0);
+        losses.push(diff < 0 ? -diff : 0);
+    }
+    // Use simple average for initial, then Wilder's smoothing
+    let avgGain = gains.slice(0, period).reduce((s, v) => s + v, 0) / period;
+    let avgLoss = losses.slice(0, period).reduce((s, v) => s + v, 0) / period;
+    for (let i = period; i < gains.length; i++) {
+        avgGain = (avgGain * (period - 1) + gains[i]) / period;
+        avgLoss = (avgLoss * (period - 1) + losses[i]) / period;
+    }
+    if (avgLoss === 0)
+        return 100;
+    const rs = avgGain / avgLoss;
+    return parseFloat((100 - 100 / (1 + rs)).toFixed(2));
+}
+function macd(closes, fast = 12, slow = 26, signalPeriod = 9) {
+    if (closes.length < slow + signalPeriod)
+        return null;
+    const ema12 = ema(closes, fast);
+    const ema26 = ema(closes, slow);
+    // Align: ema26 starts at index (slow-1) of closes; ema12 starts at index (fast-1)
+    // The MACD line length = ema26.length (shorter)
+    const offset = slow - fast;
+    const macdLine = ema26.map((e26, i) => ema12[i + offset] - e26);
+    const signalLine = ema(macdLine, signalPeriod);
+    if (signalLine.length === 0)
+        return null;
+    const lastMacd = macdLine[macdLine.length - 1];
+    const lastSignal = signalLine[signalLine.length - 1];
+    const histogram = lastMacd - lastSignal;
+    const prevHistogram = macdLine.length > 1 && signalLine.length > 1
+        ? macdLine[macdLine.length - 2] - signalLine[signalLine.length - 2]
+        : null;
+    return {
+        line: parseFloat(lastMacd.toFixed(2)),
+        signal: parseFloat(lastSignal.toFixed(2)),
+        histogram: parseFloat(histogram.toFixed(2)),
+        prev_histogram: prevHistogram !== null ? parseFloat(prevHistogram.toFixed(2)) : null,
+    };
+}
+function bollingerBands(closes, period = 20, stdMult = 2) {
+    if (closes.length < period)
+        return null;
+    const slice = closes.slice(-period);
+    const mid = slice.reduce((s, v) => s + v, 0) / period;
+    const variance = slice.reduce((s, v) => s + (v - mid) ** 2, 0) / period;
+    const std = Math.sqrt(variance);
+    return {
+        upper: parseFloat((mid + stdMult * std).toFixed(2)),
+        mid: parseFloat(mid.toFixed(2)),
+        lower: parseFloat((mid - stdMult * std).toFixed(2)),
+    };
+}
+// ---- Tool handler ----
+const MIN_CANDLES = 50;
+export async function handleTechnicalIndicators(args, client) {
+    const { market_id, period, limit } = args;
+    const validationError = validateMarketId(market_id);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const id = market_id.toLowerCase();
+        const tradesLimit = Math.max(limit ?? 500, 500);
+        const data = await client.get(`/markets/${id}/trades`, { limit: tradesLimit });
+        const candles = aggregateTradesToCandles(data.trades.entries, period);
+        const closes = candles.map((c) => c.close);
+        if (candles.length < MIN_CANDLES) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            market_id: market_id.toUpperCase(),
+                            period,
+                            indicators: null,
+                            warning: "insufficient_data",
+                            candles_available: candles.length,
+                            minimum_required: MIN_CANDLES,
+                        }),
+                    },
+                ],
+            };
+        }
+        const rsiValue = rsi(closes, 14);
+        const macdResult = macd(closes, 12, 26, 9);
+        const bbResult = bollingerBands(closes, 20, 2);
+        const sma20 = parseFloat(sma(closes, 20).toFixed(2));
+        const sma50 = parseFloat(sma(closes, 50).toFixed(2));
+        const lastClose = closes[closes.length - 1];
+        // Signal interpretations
+        const rsiSignal = rsiValue !== null && rsiValue > 70
+            ? "overbought"
+            : rsiValue !== null && rsiValue < 30
+                ? "oversold"
+                : "neutral";
+        let macdSignal = "neutral";
+        if (macdResult && macdResult.prev_histogram !== null) {
+            if (macdResult.histogram > 0 && macdResult.prev_histogram <= 0) {
+                macdSignal = "bullish_crossover";
+            }
+            else if (macdResult.histogram < 0 && macdResult.prev_histogram >= 0) {
+                macdSignal = "bearish_crossover";
+            }
+        }
+        const bbSignal = bbResult && lastClose > bbResult.upper
+            ? "above_upper"
+            : bbResult && lastClose < bbResult.lower
+                ? "below_lower"
+                : "within_bands";
+        const result = {
+            market_id: market_id.toUpperCase(),
+            period,
+            candles_used: candles.length,
+            indicators: {
+                rsi: rsiValue,
+                macd: macdResult
+                    ? { line: macdResult.line, signal: macdResult.signal, histogram: macdResult.histogram }
+                    : null,
+                bollinger_bands: bbResult,
+                sma_20: sma20,
+                sma_50: sma50,
+            },
+            signals: {
+                rsi_signal: rsiSignal,
+                macd_signal: macdSignal,
+                bb_signal: bbSignal,
+            },
+            disclaimer: "Technical indicators are computed from Buda trade history. Not investment advice.",
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
+        period: z
+            .enum(["1h", "4h", "1d"])
+            .default("1h")
+            .describe("Candle period: '1h', '4h', or '1d'. Default: '1h'."),
+        limit: z
+            .number()
+            .int()
+            .min(500)
+            .max(1000)
+            .optional()
+            .describe("Number of raw trades to fetch (default: 500, max: 1000). " +
+            "More trades = more candles = more reliable indicators."),
+    }, (args) => handleTechnicalIndicators(args, client));
+}
+//# sourceMappingURL=technical_indicators.js.map

package/dist/tools/ticker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/tools/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAwCxF"}
+{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/tools/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAKrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA6DxF"}

package/dist/tools/ticker.js

@@ -2,10 +2,13 @@ import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { CACHE_TTL } from "../cache.js";
 import { validateMarketId } from "../validation.js";
+import { flattenAmount } from "../utils.js";
 export const toolSchema = {
     name: "get_ticker",
-    description: "Get the current ticker for a Buda.com market: last traded price, best bid/ask, " +
-        "24h volume, and price change over 24h and 7d.",
+    description: "Returns the current market snapshot for a Buda.com market: last traded price, best bid, " +
+        "best ask, 24h volume, and price change over 24h and 7d. All prices are floats in the quote " +
+        "currency (e.g. CLP for BTC-CLP). price_variation_24h is a decimal fraction (0.012 = +1.2%). " +
+        "Example: 'What is the current Bitcoin price in Chilean pesos?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -33,8 +36,26 @@ export function register(server, client, cache) {
             }
             const id = market_id.toLowerCase();
             const data = await cache.getOrFetch(`ticker:${id}`, CACHE_TTL.TICKER, () => client.get(`/markets/${id}/ticker`));
+            const t = data.ticker;
+            const lastPrice = flattenAmount(t.last_price);
+            const minAsk = flattenAmount(t.min_ask);
+            const maxBid = flattenAmount(t.max_bid);
+            const volume = flattenAmount(t.volume);
+            const result = {
+                market_id: t.market_id,
+                last_price: lastPrice.value,
+                last_price_currency: lastPrice.currency,
+                min_ask: minAsk.value,
+                min_ask_currency: minAsk.currency,
+                max_bid: maxBid.value,
+                max_bid_currency: maxBid.currency,
+                volume: volume.value,
+                volume_currency: volume.currency,
+                price_variation_24h: parseFloat(t.price_variation_24h),
+                price_variation_7d: parseFloat(t.price_variation_7d),
+            };
             return {
-                content: [{ type: "text", text: JSON.stringify(data.ticker, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

package/dist/tools/trades.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../src/tools/trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAwBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAyDzF"}
+{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../src/tools/trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA0BtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAsEzF"}

package/dist/tools/trades.js

@@ -3,8 +3,10 @@ import { BudaApiError } from "../client.js";
 import { validateMarketId } from "../validation.js";
 export const toolSchema = {
     name: "get_trades",
-    description: "Get recent trade history for a Buda.com market. Each entry contains " +
-        "[timestamp_ms, amount, price, direction]. Direction is 'buy' or 'sell'.",
+    description: "Returns recent trade history for a Buda.com market as typed objects. Each entry has " +
+        "timestamp_ms (integer), amount (float, base currency), price (float, quote currency), " +
+        "and direction ('buy' or 'sell'). " +
+        "Example: 'What was the last executed price for BTC-CLP and was it a buy or sell?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -56,8 +58,20 @@ export function register(server, client, _cache) {
             if (timestamp !== undefined)
                 params.timestamp = timestamp;
             const data = await client.get(`/markets/${market_id.toLowerCase()}/trades`, Object.keys(params).length > 0 ? params : undefined);
+            const t = data.trades;
+            const result = {
+                timestamp: t.timestamp,
+                last_timestamp: t.last_timestamp,
+                market_id: t.market_id,
+                entries: t.entries.map(([tsMs, amount, price, direction]) => ({
+                    timestamp_ms: parseInt(tsMs, 10),
+                    amount: parseFloat(amount),
+                    price: parseFloat(price),
+                    direction,
+                })),
+            };
             return {
-                content: [{ type: "text", text: JSON.stringify(data.trades, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

package/dist/tools/volume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/tools/volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAqCzF"}
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/tools/volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAgBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAwDzF"}

package/dist/tools/volume.js

@@ -1,10 +1,12 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { validateMarketId } from "../validation.js";
+import { flattenAmount } from "../utils.js";
 export const toolSchema = {
     name: "get_market_volume",
-    description: "Get 24h and 7-day transacted volume for a Buda.com market. " +
-        "Returns ask (sell) and bid (buy) volumes in the market's base currency.",
+    description: "Returns 24h and 7-day transacted volume for a Buda.com market, split by buy (bid) and sell (ask) side. " +
+        "All volume values are floats in the base currency (e.g. BTC for BTC-CLP). " +
+        "Example: 'How much Bitcoin was sold on BTC-CLP in the last 24 hours?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -31,8 +33,24 @@ export function register(server, client, _cache) {
                 };
             }
             const data = await client.get(`/markets/${market_id.toLowerCase()}/volume`);
+            const v = data.volume;
+            const ask24 = flattenAmount(v.ask_volume_24h);
+            const ask7d = flattenAmount(v.ask_volume_7d);
+            const bid24 = flattenAmount(v.bid_volume_24h);
+            const bid7d = flattenAmount(v.bid_volume_7d);
+            const result = {
+                market_id: v.market_id,
+                ask_volume_24h: ask24.value,
+                ask_volume_24h_currency: ask24.currency,
+                ask_volume_7d: ask7d.value,
+                ask_volume_7d_currency: ask7d.currency,
+                bid_volume_24h: bid24.value,
+                bid_volume_24h_currency: bid24.currency,
+                bid_volume_7d: bid7d.value,
+                bid_volume_7d_currency: bid7d.currency,
+            };
             return {
-                content: [{ type: "text", text: JSON.stringify(data.volume, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

package/dist/types.d.ts

@@ -99,4 +99,13 @@ export interface OrdersResponse {
         total_pages: number;
     };
 }
+export interface OhlcvCandle {
+    time: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    trade_count: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,23 @@
+import type { Amount, OhlcvCandle } from "./types.js";
+/**
+ * Flattens a Buda API Amount tuple [value_string, currency] into a typed object.
+ * All numeric strings are cast to float via parseFloat.
+ */
+export declare function flattenAmount(amount: Amount): {
+    value: number;
+    currency: string;
+};
+/**
+ * Returns a liquidity rating based on the bid/ask spread percentage.
+ * < 0.3%  → "high"
+ * 0.3–1%  → "medium"
+ * > 1%    → "low"
+ */
+export declare function getLiquidityRating(spreadPct: number): "high" | "medium" | "low";
+/**
+ * Aggregates raw Buda trade entries (newest-first) into OHLCV candles for the given period.
+ * Entries must be in the format [timestamp_ms, amount, price, direction].
+ * Returns candles sorted ascending by bucket start time.
+ */
+export declare function aggregateTradesToCandles(entries: [string, string, string, string][], period: string): OhlcvCandle[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAI/E;AAQD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAC3C,MAAM,EAAE,MAAM,GACb,WAAW,EAAE,CAoCf"}

package/dist/utils.js

@@ -0,0 +1,68 @@
+/**
+ * Flattens a Buda API Amount tuple [value_string, currency] into a typed object.
+ * All numeric strings are cast to float via parseFloat.
+ */
+export function flattenAmount(amount) {
+    return { value: parseFloat(amount[0]), currency: amount[1] };
+}
+/**
+ * Returns a liquidity rating based on the bid/ask spread percentage.
+ * < 0.3%  → "high"
+ * 0.3–1%  → "medium"
+ * > 1%    → "low"
+ */
+export function getLiquidityRating(spreadPct) {
+    if (spreadPct < 0.3)
+        return "high";
+    if (spreadPct <= 1.0)
+        return "medium";
+    return "low";
+}
+const PERIOD_MS = {
+    "1h": 60 * 60 * 1000,
+    "4h": 4 * 60 * 60 * 1000,
+    "1d": 24 * 60 * 60 * 1000,
+};
+/**
+ * Aggregates raw Buda trade entries (newest-first) into OHLCV candles for the given period.
+ * Entries must be in the format [timestamp_ms, amount, price, direction].
+ * Returns candles sorted ascending by bucket start time.
+ */
+export function aggregateTradesToCandles(entries, period) {
+    const periodMs = PERIOD_MS[period];
+    if (!periodMs)
+        throw new Error(`Unknown period: ${period}`);
+    const sorted = [...entries].sort(([a], [b]) => parseInt(a, 10) - parseInt(b, 10));
+    const buckets = new Map();
+    for (const [tsMs, amount, price] of sorted) {
+        const ts = parseInt(tsMs, 10);
+        const bucketStart = Math.floor(ts / periodMs) * periodMs;
+        const p = parseFloat(price);
+        const v = parseFloat(amount);
+        if (!buckets.has(bucketStart)) {
+            buckets.set(bucketStart, {
+                time: new Date(bucketStart).toISOString(),
+                open: p,
+                high: p,
+                low: p,
+                close: p,
+                volume: v,
+                trade_count: 1,
+            });
+        }
+        else {
+            const candle = buckets.get(bucketStart);
+            if (p > candle.high)
+                candle.high = p;
+            if (p < candle.low)
+                candle.low = p;
+            candle.close = p;
+            candle.volume = parseFloat((candle.volume + v).toFixed(8));
+            candle.trade_count++;
+        }
+    }
+    return Array.from(buckets.entries())
+        .sort(([a], [b]) => a - b)
+        .map(([, candle]) => candle);
+}
+//# sourceMappingURL=utils.js.map

package/marketplace/README.md

@@ -1,4 +1,4 @@
-# Marketplace Submission Assets — v1.2.0
+# Marketplace Submission Assets — v1.4.0
 
 Ready-to-use assets for submitting buda-mcp to every major AI marketplace.
 Replace `gtorreal` / `gtorreal` with your actual handles before submitting.