@madeonsol/plugin-madeonsol 1.11.0 → 1.12.1

package/README.md

@@ -11,6 +11,8 @@ ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading int
 
 > Real-time Solana trading intelligence: track 1,069 KOL wallets with <3s latency, score 23,000+ Pump.fun deployers, surface deshred deploy signals ~500ms before on-chain confirmation, detect multi-KOL coordination, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/pricing](https://madeonsol.com/pricing) — no credit card required.
 
+> **New in 1.12.0** — **Token OHLCV candles.** New action `GET_TOKEN_CANDLES` + `client.getTokenCandles(mint, { tf, limit, from, to })` — historical price candles (1m/5m/15m/1h/4h/1d) aggregated from the on-chain trade firehose. Each candle has `t/open/high/low/close/volume_usd/trades/market_cap_usd`. PRO returns OHLCV for the last 30 days; ULTRA adds buy/sell volume + count splits, net flow, MEV volume, open/close liquidity, high/low MC, and full history. PRO/ULTRA only.
+>
 > **New in 1.11.0** — **Token risk score.** New action `GET_TOKEN_RISK` + `client.getTokenRisk(mint)` — a transparent 0–100 rug-risk/safety score (higher = riskier) with a `band` (safe/caution/danger), an explainable `factors[]` array, and the raw `inputs` (mint/freeze authority, liquidity, liq-to-MC ratio, transfer fee, launch cohort, deployer bond rate, KOL signal, blacklist). PRO/ULTRA only.
 >
 > **New in 1.10.0** — `client.getTokensList()` gains three new filter params: `min_liq_mc_ratio`, `max_liq_mc_ratio`, and `deployer_tier`. Response items now include `liquidity_to_mc_ratio` and `deployer_tier`. KOL leaderboard entries now include `median_hold_minutes_30d` and `percentile_early_entry_30d`. Token endpoints now return `liquidity_to_mc_ratio`, `launch_cohort_sol`, and `launch_cohort_size`.
@@ -65,6 +67,7 @@ Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
 | `WALLET_POSITIONS` | **New 1.8** · Open positions with live unrealized SOL from market-cap tracker (PRO+) |
 | `WALLET_TRADES` | **New 1.8** · Recent trades for any wallet, filtered by action (PRO+) |
 | `GET_TOKEN_RISK` | **New 1.11** · Transparent 0–100 rug-risk/safety score with band + explainable factors (PRO+) |
+| `GET_TOKEN_CANDLES` | **New 1.12** · Historical OHLCV candles (1m–1d). PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, full history (PRO+) |
 
 ## Install
 

package/dist/actions/token-candles.d.ts

@@ -0,0 +1,2 @@
+import type { Action } from "@elizaos/core";
+export declare const tokenCandlesAction: Action;

package/dist/actions/token-candles.js

@@ -0,0 +1,56 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+const MINT_RE = /\b([1-9A-HJ-NP-Za-km-z]{32,44})\b/;
+const TF_RE = /\b(1m|5m|15m|1h|4h|1d)\b/i;
+export const tokenCandlesAction = {
+    name: "GET_TOKEN_CANDLES",
+    description: "Get historical OHLCV price candles for a Solana token from MadeOnSol (1m/5m/15m/1h/4h/1d). Each candle has t/open/high/low/close/volume_usd/trades/market_cap_usd. PRO=OHLCV 30d; ULTRA adds net flow, liquidity delta, and full history. PRO+.",
+    similes: [
+        "token candles",
+        "ohlc",
+        "ohlcv",
+        "price chart",
+        "candlestick",
+        "price history",
+        "candle data",
+    ],
+    validate: async (_runtime, message) => {
+        const text = message.content?.text || "";
+        return /\b(candle|chart|ohlc|ohlcv|candlestick)\b/i.test(text) && MINT_RE.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = message.content?.text || "";
+        const mint = text.match(MINT_RE)?.[1];
+        if (!mint) {
+            callback?.({ text: "Please include a token mint address." });
+            return undefined;
+        }
+        const tf = text.match(TF_RE)?.[1]?.toLowerCase();
+        const result = await client.getTokenCandles(mint, tf ? { tf } : undefined);
+        if (result.error) {
+            callback?.({ text: result.status === 402
+                    ? "Authentication required. Set MADEONSOL_API_KEY — free at https://madeonsol.com/pricing — or SVM_PRIVATE_KEY."
+                    : `Error: ${result.error}` });
+            return undefined;
+        }
+        const data = result.data;
+        const candles = data.candles || [];
+        const latest = candles.slice(-5);
+        const lines = latest.map((c) => `• ${c.t} — O ${c.open} H ${c.high} L ${c.low} C ${c.close} (vol $${Math.round(c.volume_usd).toLocaleString()})`);
+        callback?.({
+            text: `${data.timeframe} candles for ${mint.slice(0, 8)}… (${data.count} total)${lines.length ? `\nLatest:\n${lines.join("\n")}` : ""}`,
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "Show me the 1h candles for 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" } },
+            { name: "assistant", content: { text: "Here's the OHLCV candle history for that token..." } },
+        ],
+    ],
+};

package/dist/client.d.ts

@@ -285,6 +285,17 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    /** Historical OHLCV candles (1m/5m/15m/1h/4h/1d) aggregated from the trade firehose. PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, full history. PRO+. */
+    getTokenCandles(mint: string, params?: {
+        tf?: string;
+        limit?: number;
+        from?: string;
+        to?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
     /** Bulk buyer-quality scoring for up to 50 mints. Shares the single-mint 5-min LRU cache. */
     getTokenBuyerQualityBatch(mints: string[]): Promise<{
         data?: unknown;
@@ -309,12 +320,18 @@ export declare class MadeOnSolClient {
         status: number;
     }>;
     copyTradeCreate(params: {
-        name: string;
-        source_wallet: string;
-        is_active?: boolean;
+        /** 1-50 wallets to copy trades from. */
+        source_wallets: string[];
+        /** Required. Fixed SOL amount, proportional multiplier, or percent of source — per sizing_mode. */
+        sizing_amount: number;
+        name?: string;
+        min_trade_sol?: number;
+        only_action?: "buy" | "sell" | "both";
+        sizing_mode?: "fixed" | "proportional" | "percent_source";
+        delivery_mode?: "webhook" | "websocket" | "both";
         webhook_url?: string;
-        delivery?: "webhook" | "websocket" | "both";
-        filters?: Record<string, unknown>;
+        min_mc_usd?: number | null;
+        max_mc_usd?: number | null;
     }): Promise<{
         data?: unknown;
         error?: string;

package/dist/client.js

@@ -215,7 +215,7 @@ export class MadeOnSolClient {
         return this.restRequest("GET", `/alpha/leaderboard${query}`);
     }
     getAlphaWallet(wallet) {
-        return this.restRequest("GET", `/alpha/wallet/${encodeURIComponent(wallet)}`);
+        return this.restRequest("GET", `/alpha/${encodeURIComponent(wallet)}`);
     }
     getAlphaLinked(wallet) {
         return this.restRequest("GET", `/alpha/${encodeURIComponent(wallet)}/linked`);
@@ -231,6 +231,20 @@ export class MadeOnSolClient {
     getTokenRisk(mint) {
         return this.restRequest("GET", `/tokens/${encodeURIComponent(mint)}/risk`);
     }
+    /** Historical OHLCV candles (1m/5m/15m/1h/4h/1d) aggregated from the trade firehose. PRO=OHLCV 30d; ULTRA=+net flow, liquidity delta, full history. PRO+. */
+    getTokenCandles(mint, params) {
+        const qs = new URLSearchParams();
+        if (params?.tf)
+            qs.set("tf", params.tf);
+        if (params?.limit !== undefined)
+            qs.set("limit", String(params.limit));
+        if (params?.from)
+            qs.set("from", params.from);
+        if (params?.to)
+            qs.set("to", params.to);
+        const query = qs.toString() ? `?${qs.toString()}` : "";
+        return this.restRequest("GET", `/tokens/${encodeURIComponent(mint)}/candles${query}`);
+    }
     /** Bulk buyer-quality scoring for up to 50 mints. Shares the single-mint 5-min LRU cache. */
     getTokenBuyerQualityBatch(mints) {
         return this.restRequest("POST", "/tokens/batch/buyer-quality", { mints });
@@ -246,19 +260,19 @@ export class MadeOnSolClient {
     }
     // ── Copy-Trade Rules (PRO/ULTRA) ──
     copyTradeList() {
-        return this.restRequest("GET", "/copy-trade/rules");
+        return this.restRequest("GET", "/copytrade/subscriptions");
     }
     copyTradeCreate(params) {
-        return this.restRequest("POST", "/copy-trade/rules", params);
+        return this.restRequest("POST", "/copytrade/subscriptions", params);
     }
     copyTradeGet(ruleId) {
-        return this.restRequest("GET", `/copy-trade/rules/${encodeURIComponent(ruleId)}`);
+        return this.restRequest("GET", `/copytrade/subscriptions/${encodeURIComponent(ruleId)}`);
     }
     copyTradeUpdate(ruleId, updates) {
-        return this.restRequest("PATCH", `/copy-trade/rules/${encodeURIComponent(ruleId)}`, updates);
+        return this.restRequest("PATCH", `/copytrade/subscriptions/${encodeURIComponent(ruleId)}`, updates);
     }
     copyTradeDelete(ruleId) {
-        return this.restRequest("DELETE", `/copy-trade/rules/${encodeURIComponent(ruleId)}`);
+        return this.restRequest("DELETE", `/copytrade/subscriptions/${encodeURIComponent(ruleId)}`);
     }
     // ── Coordination alerts (PRO/ULTRA, v1.1) ──
     coordinationAlertsList() {
@@ -329,7 +343,7 @@ export class MadeOnSolClient {
                 if (v !== undefined)
                     qs.set(k, v);
         const query = qs.toString() ? `?${qs.toString()}` : "";
-        return this.restRequest("GET", `/copy-trade/signals${query}`);
+        return this.restRequest("GET", `/copytrade/signals${query}`);
     }
     // ── Price alerts (PRO/ULTRA, v1.9) ──
     priceAlertsList() {

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { kolTokenEntryOrderAction } from "./actions/kol-token-entry-order.js";
 import { kolCompareAction } from "./actions/kol-compare.js";
 import { kolAlertsRecentAction } from "./actions/kol-alerts-recent.js";
 import { tokenRiskAction } from "./actions/token-risk.js";
+import { tokenCandlesAction } from "./actions/token-candles.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokens-list.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
@@ -18,6 +19,6 @@ export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
-export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction };
+export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction };
 export { meAction, tokensListAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/dist/index.js

@@ -7,6 +7,7 @@ import { kolTokenEntryOrderAction } from "./actions/kol-token-entry-order.js";
 import { kolCompareAction } from "./actions/kol-compare.js";
 import { kolAlertsRecentAction } from "./actions/kol-alerts-recent.js";
 import { tokenRiskAction } from "./actions/token-risk.js";
+import { tokenCandlesAction } from "./actions/token-candles.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokens-list.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
@@ -27,6 +28,7 @@ export const madeOnSolPlugin = {
         kolCompareAction,
         kolAlertsRecentAction,
         tokenRiskAction,
+        tokenCandlesAction,
         meAction,
         tokensListAction,
         walletStatsAction,
@@ -80,6 +82,6 @@ export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
-export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction };
+export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction };
 export { meAction, tokensListAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madeonsol/plugin-madeonsol",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
   "repository": {
     "type": "git",