@madeonsol/plugin-madeonsol 1.12.1 → 1.14.0

package/README.md

@@ -11,6 +11,10 @@ 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.14.0** — **Almost-bonded discovery + trending sorts.** New action `MADEONSOL_ALMOST_BONDED` + `client.getAlmostBonded(params)` — pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min): "95% and accelerating" beats "92% stalled". Each token carries `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `real_sol_reserves`, `market_cap_usd`, `liquidity_usd`, `authorities_revoked`, `deployer_tier`, and `age_minutes`. Params: `min_progress`, `max_progress`, `min_velocity_pct_per_min`, `max_age_minutes`, `deployer_tier`, `authority_revoked`, `min_liq`, `sort` (velocity_desc / progress_desc / eta_asc), `limit`. PRO/ULTRA only. Plus `client.getTokensList({ sort })` gains four momentum sorts — `mc_change_5m_desc`, `mc_change_1h_desc`, `volume_1h_desc`, and `trending` (composite recent-volume × positive-momentum rank).
+>
+> **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.
@@ -61,13 +65,15 @@ Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
 | `WALLET_TRACKER_WATCHLIST` | List your tracked wallets and remaining capacity |
 | `WALLET_TRACKER_TRADES` | Recent swaps and transfers from your watchlist |
 | `GET_MADEONSOL_ACCOUNT` | Your tier, daily quota, burst limit, and slot usage *(new in 1.7.0)* |
-| `LIST_MADEONSOL_TOKENS` | Scan tokens by MC, liquidity, 1h momentum, primary DEX *(new in 1.7.0)* |
+| `LIST_MADEONSOL_TOKENS` | Scan tokens by MC, liquidity, 1h momentum, primary DEX, plus momentum sorts (`mc_change_5m_desc`/`mc_change_1h_desc`/`volume_1h_desc`/`trending`) *(new in 1.7.0)* |
+| `MADEONSOL_ALMOST_BONDED` | **New 1.14** · Pre-bond pump.fun tokens near graduation, ranked by velocity — `progress_pct`, `velocity_pct_per_min`, `eta_minutes`, `stalled`, `deployer_tier` (PRO+) |
 | `WALLET_STATS` | **New 1.8** · Stats + cross-product flags (is_kol, is_alpha_tracked + bot_confidence, is_deployer) for any wallet (PRO+) |
 | `WALLET_PNL` | **New 1.8** · Full FIFO PnL — realized + unrealized, profit factor, drawdown, hold times, top winners (PRO+) |
 | `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+) |
+| `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 +188,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/almost-bonded.d.ts

@@ -0,0 +1,7 @@
+import type { Action } from "@elizaos/core";
+/**
+ * Scan pre-bond pump.fun tokens approaching graduation, ranked by velocity.
+ * Heuristics pulled from the user prompt: "fast"/"accelerating" → sort by
+ * velocity, "soon"/"closest" → sort by ETA, "elite deployer" → deployer_tier.
+ */
+export declare const almostBondedAction: Action;

package/dist/actions/almost-bonded.js

@@ -0,0 +1,69 @@
+import { MadeOnSolClient } from "../client.js";
+import { MADEONSOL_CLIENT_KEY } from "../index.js";
+function getClient(runtime) {
+    return runtime[MADEONSOL_CLIENT_KEY] ?? new MadeOnSolClient();
+}
+/**
+ * Scan pre-bond pump.fun tokens approaching graduation, ranked by velocity.
+ * Heuristics pulled from the user prompt: "fast"/"accelerating" → sort by
+ * velocity, "soon"/"closest" → sort by ETA, "elite deployer" → deployer_tier.
+ */
+export const almostBondedAction = {
+    name: "MADEONSOL_ALMOST_BONDED",
+    description: "Find pre-bond pump.fun tokens near graduation, ranked by velocity (Δprogress/min). Returns mint, symbol, bonding progress %, velocity, ETA-to-bond, stalled flag, and deployer tier. PRO/ULTRA only.",
+    similes: [
+        "almost bonded",
+        "about to graduate",
+        "near graduation",
+        "tokens about to bond",
+        "almost graduated",
+        "pre-bond tokens",
+    ],
+    validate: async (_runtime, message) => {
+        const text = (message.content?.text || "").toLowerCase();
+        return /\b(almost bonded|about to graduate|near graduation|about to bond|pre-?bond|almost graduated)\b/.test(text);
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+        const client = getClient(runtime);
+        const text = (message.content?.text || "").toLowerCase();
+        const params = { limit: "10" };
+        if (/soon|closest|fastest to bond|eta/.test(text))
+            params.sort = "eta_asc";
+        else if (/accelerat|fast|velocity|momentum/.test(text))
+            params.sort = "velocity_desc";
+        if (/elite/.test(text))
+            params.deployer_tier = "elite";
+        const result = await client.getAlmostBonded(params);
+        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 tokens = (data.tokens || []).slice(0, 10);
+        const lines = tokens.map((t, i) => {
+            const label = t.symbol || t.name || "?";
+            const prog = t.progress_pct != null && isFinite(t.progress_pct) ? `${t.progress_pct.toFixed(1)}%` : "?";
+            const vel = t.velocity_pct_per_min != null && isFinite(t.velocity_pct_per_min)
+                ? ` @ ${t.velocity_pct_per_min >= 0 ? "+" : ""}${t.velocity_pct_per_min.toFixed(2)}%/min`
+                : "";
+            const eta = t.eta_minutes != null && isFinite(t.eta_minutes) ? ` (ETA ~${t.eta_minutes}m)` : "";
+            const tier = t.deployer_tier ? ` [${t.deployer_tier}]` : "";
+            return `${i + 1}. ${label} ${t.mint.slice(0, 8)}… — ${prog} bonded${vel}${eta}${tier}`;
+        });
+        callback?.({
+            text: tokens.length
+                ? `Almost-bonded pump.fun tokens:\n${lines.join("\n")}`
+                : "No pre-bond tokens matched those filters.",
+            content: data,
+        });
+        return undefined;
+    },
+    examples: [
+        [
+            { name: "user1", content: { text: "Show me pump.fun tokens about to graduate, fastest first" } },
+            { name: "assistant", content: { text: "Here are the almost-bonded tokens ranked by velocity..." } },
+        ],
+    ],
+};

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;
@@ -475,6 +503,28 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    /**
+     * v1.14 — Pre-bond pump.fun tokens approaching graduation, ranked by velocity
+     * (Δprogress/min): "95% and accelerating" beats "92% stalled". Each token is
+     * enriched with its deployer's reputation tier. `progress_pct` is from on-chain
+     * real_token_reserves; `velocity_pct_per_min` is null until a 5m snapshot exists;
+     * `eta_minutes` is a linear projection. PRO/ULTRA only.
+     */
+    getAlmostBonded(params?: {
+        min_progress?: string;
+        max_progress?: string;
+        min_velocity_pct_per_min?: string;
+        max_age_minutes?: string;
+        deployer_tier?: string;
+        authority_revoked?: string;
+        min_liq?: string;
+        sort?: string;
+        limit?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
     copyTradeSignals(params?: {
         rule_id?: string;
         limit?: string;

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 });
@@ -336,6 +345,24 @@ export class MadeOnSolClient {
         const query = qs.toString() ? `?${qs.toString()}` : "";
         return this.restRequest("GET", `/tokens${query}`);
     }
+    /**
+     * v1.14 — Pre-bond pump.fun tokens approaching graduation, ranked by velocity
+     * (Δprogress/min): "95% and accelerating" beats "92% stalled". Each token is
+     * enriched with its deployer's reputation tier. `progress_pct` is from on-chain
+     * real_token_reserves; `velocity_pct_per_min` is null until a 5m snapshot exists;
+     * `eta_minutes` is a linear projection. PRO/ULTRA only.
+     */
+    getAlmostBonded(params) {
+        const qs = new URLSearchParams();
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    qs.set(k, v);
+            }
+        }
+        const query = qs.toString() ? `?${qs.toString()}` : "";
+        return this.restRequest("GET", `/tokens/almost-bonded${query}`);
+    }
     copyTradeSignals(params) {
         const qs = new URLSearchParams();
         if (params)

package/dist/index.d.ts

@@ -9,8 +9,10 @@ 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 { almostBondedAction } from "./actions/almost-bonded.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
 /** Key used to store the initialized client on the runtime */
 export declare const MADEONSOL_CLIENT_KEY = "madeonsol:client";
@@ -19,6 +21,6 @@ export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
-export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction };
-export { meAction, tokensListAction };
+export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };
+export { meAction, tokensListAction, almostBondedAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/dist/index.js

@@ -8,8 +8,10 @@ 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 { almostBondedAction } from "./actions/almost-bonded.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
 import { MadeOnSolClient } from "./client.js";
 /** Key used to store the initialized client on the runtime */
@@ -29,8 +31,10 @@ export const madeOnSolPlugin = {
         kolAlertsRecentAction,
         tokenRiskAction,
         tokenCandlesAction,
+        tokenFlowAction,
         meAction,
         tokensListAction,
+        almostBondedAction,
         walletStatsAction,
         walletPnlAction,
         walletPositionsAction,
@@ -82,6 +86,6 @@ export default madeOnSolPlugin;
 export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
-export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction };
-export { meAction, tokensListAction };
+export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };
+export { meAction, tokensListAction, almostBondedAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/package.json

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