@madeonsol/plugin-madeonsol 1.13.0 → 1.14.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.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.
@@ -63,7 +65,8 @@ 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+) |

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/client.d.ts

@@ -503,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

@@ -345,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

@@ -12,6 +12,7 @@ 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";
@@ -21,5 +22,5 @@ export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
 export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };
-export { meAction, tokensListAction };
+export { meAction, tokensListAction, almostBondedAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/dist/index.js

@@ -11,6 +11,7 @@ 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 */
@@ -33,6 +34,7 @@ export const madeOnSolPlugin = {
         tokenFlowAction,
         meAction,
         tokensListAction,
+        almostBondedAction,
         walletStatsAction,
         walletPnlAction,
         walletPositionsAction,
@@ -85,5 +87,5 @@ export { MadeOnSolClient } from "./client.js";
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
 export { walletTrackerWatchlistAction, walletTrackerTradesAction };
 export { kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };
-export { meAction, tokensListAction };
+export { meAction, tokensListAction, almostBondedAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/package.json

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