@madeonsol/plugin-madeonsol 1.11.0 → 1.12.0

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;

package/dist/client.js

@@ -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 });

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.0",
   "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
   "repository": {
     "type": "git",