@madeonsol/plugin-madeonsol 1.12.1 → 1.13.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.13.0** — **Token net flow.** New action `GET_TOKEN_FLOW` + `client.getTokenFlow(mint, { window })` — net buy/sell flow over a rolling window (`1h` default, or `24h`): `unique_wallets`, `unique_buyers`, `unique_sellers`, `buy_count`, `sell_count`, `total_trades`, `buy_sol`, `sell_sol`, `net_sol`, `trades_per_wallet`. PRO+. Deployer alerts now also surface `deployer_sol_balance` — the deployer wallet's SOL balance at alert time (`null` for historical rows).
+>
 > **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.
@@ -68,6 +70,7 @@ Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
 | `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+) |
+| `GET_TOKEN_FLOW` | **New 1.13** · Net buy/sell flow over a 1h/24h window — unique wallets/buyers/sellers, buy/sell counts, buy/sell/net SOL, trades-per-wallet (PRO+) |
 
 ## Install
 
@@ -182,6 +185,22 @@ Also available: `priceAlertsList()`, `priceAlertsGet(id)`, `priceAlertsUpdate(id
 | `PEAK_HISTORY` | Historical peak-density windows for a token (PRO+) |
 | `COORDINATION_HISTORY` | Global coordination event log (PRO+) |
 
+### Token net flow *(new in 1.13)*
+
+`GET_TOKEN_FLOW` (or `client.getTokenFlow(mint, { window })`) returns net buy/sell flow over a rolling `1h` (default) or `24h` window. PRO+.
+
+```ts
+import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
+const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
+
+const { data } = await client.getTokenFlow("7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", { window: "24h" });
+// { mint, window, from, unique_wallets, unique_buyers, unique_sellers,
+//   buy_count, sell_count, total_trades, buy_sol, sell_sol, net_sol, trades_per_wallet }
+console.log(`Net ${data.net_sol} SOL across ${data.unique_wallets} wallets`);
+```
+
+> Deployer alerts (`GET_DEPLOYER_ALERTS` / `client.getDeployerAlerts()`) now include `deployer_sol_balance` — the deployer wallet's SOL balance at alert time (`null` for historical rows).
+
 ### Wallet derived stats *(new in 1.9)*
 
 `WALLET_STATS` now returns a `stats` object with derived fields: `win_rate` (0-1), `roi`, `verdict` ("strong" | "profitable" | "neutral" | "losing"), and `biggest_miss` (token with the highest post-exit gain the wallet missed).

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

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

package/dist/actions/token-flow.js

@@ -0,0 +1,57 @@
+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 WINDOW_RE = /\b(1h|24h)\b/i;
+export const tokenFlowAction = {
+    name: "GET_TOKEN_FLOW",
+    description: "Get net buy/sell flow for a Solana token over a rolling window (1h or 24h) from MadeOnSol. Returns unique wallet/buyer/seller counts, buy/sell trade counts, buy/sell/net SOL, and trades-per-wallet. PRO+.",
+    similes: [
+        "token flow",
+        "net flow",
+        "buy sell flow",
+        "buy pressure",
+        "sell pressure",
+        "net sol flow",
+        "money flow",
+    ],
+    validate: async (_runtime, message) => {
+        const text = message.content?.text || "";
+        return /\b(flow|net buy|net sell|buy pressure|sell pressure|money flow)\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 window = text.match(WINDOW_RE)?.[1]?.toLowerCase();
+        const result = await client.getTokenFlow(mint, window ? { window } : 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 net = data.net_sol >= 0 ? `+${data.net_sol.toFixed(2)}` : data.net_sol.toFixed(2);
+        const summary = [
+            `Net flow (${data.window}) for ${mint.slice(0, 8)}…`,
+            `• Net SOL: ${net} (buy ${data.buy_sol.toFixed(2)} / sell ${data.sell_sol.toFixed(2)})`,
+            `• Trades: ${data.total_trades} (${data.buy_count} buys / ${data.sell_count} sells)`,
+            `• Wallets: ${data.unique_wallets} (${data.unique_buyers} buyers / ${data.unique_sellers} sellers, ${data.trades_per_wallet.toFixed(1)}/wallet)`,
+        ].join("\n");
+        callback?.({ text: summary, content: { ...data } });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "What's the 24h net flow for 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" } },
+            { name: "assistant", content: { text: "Here's the buy/sell flow for that token..." } },
+        ],
+    ],
+};

package/dist/client.d.ts

@@ -18,6 +18,22 @@ export interface RateLimitInfo {
     reset?: string;
     requestId?: string;
 }
+/** Net buy/sell flow for a token over a rolling window. Returned by `getTokenFlow`. */
+export interface TokenFlow {
+    mint: string;
+    window: "1h" | "24h";
+    from: number;
+    unique_wallets: number;
+    unique_buyers: number;
+    unique_sellers: number;
+    buy_count: number;
+    sell_count: number;
+    total_trades: number;
+    buy_sol: number;
+    sell_sol: number;
+    net_sol: number;
+    trades_per_wallet: number;
+}
 export declare class MadeOnSolClient {
     private baseUrl;
     private fetchFn;
@@ -296,6 +312,18 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    /**
+     * Net buy/sell flow for a token over a rolling window (1h or 24h). Returns unique
+     * wallet/buyer/seller counts, buy/sell trade counts, buy/sell/net SOL, and trades-per-wallet.
+     * Default window is "1h". PRO+.
+     */
+    getTokenFlow(mint: string, params?: {
+        window?: "1h" | "24h";
+    }): Promise<{
+        data?: TokenFlow | undefined;
+        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

@@ -245,6 +245,15 @@ export class MadeOnSolClient {
         const query = qs.toString() ? `?${qs.toString()}` : "";
         return this.restRequest("GET", `/tokens/${encodeURIComponent(mint)}/candles${query}`);
     }
+    /**
+     * Net buy/sell flow for a token over a rolling window (1h or 24h). Returns unique
+     * wallet/buyer/seller counts, buy/sell trade counts, buy/sell/net SOL, and trades-per-wallet.
+     * Default window is "1h". PRO+.
+     */
+    getTokenFlow(mint, params) {
+        const qs = params?.window ? `?window=${params.window}` : "";
+        return this.restRequest("GET", `/tokens/${encodeURIComponent(mint)}/flow${qs}`);
+    }
     /** 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

@@ -9,6 +9,7 @@ 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 { tokenFlowAction } from "./actions/token-flow.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokens-list.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
@@ -19,6 +20,6 @@ export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
-export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction };
+export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };
 export { meAction, tokensListAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/dist/index.js

@@ -8,6 +8,7 @@ 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 { tokenFlowAction } from "./actions/token-flow.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokens-list.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
@@ -29,6 +30,7 @@ export const madeOnSolPlugin = {
         kolAlertsRecentAction,
         tokenRiskAction,
         tokenCandlesAction,
+        tokenFlowAction,
         meAction,
         tokensListAction,
         walletStatsAction,
@@ -82,6 +84,6 @@ export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
-export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction };
+export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };
 export { meAction, tokensListAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/package.json

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