solana-agent-kit-plugin-madeonsol 1.12.1 → 1.14.0

package/README.md

@@ -11,6 +11,10 @@
 
 > 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 tool `almostBonded()` + action `MADEONSOL_ALMOST_BONDED_ACTION` — 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 `tokensList({ 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 tool `tokenFlow()` + action `MADEONSOL_TOKEN_FLOW_ACTION` — 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/ULTRA only. 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 tool `tokenCandles()` + action `MADEONSOL_TOKEN_CANDLES_ACTION` — 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 tool `tokenRisk()` + action `MADEONSOL_TOKEN_RISK_ACTION` — 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.
@@ -101,11 +105,13 @@ const events = await agent.methods.walletTrackerTrades(agent, { limit: 50 });
 | `MADEONSOL_WALLET_TRACKER_TRADES_ACTION` | "wallet tracker trades", "watchlist activity" |
 | `MADEONSOL_WALLET_TRACKER_SUMMARY_ACTION` | "wallet tracker summary", "tracked wallet stats" |
 | `MADEONSOL_ME_ACTION` | "my api account", "api quota", "remaining requests" — tier + quota introspection (new in 1.7) |
-| `MADEONSOL_TOKENS_LIST_ACTION` | "filter tokens", "tokens by market cap", "scan tokens" — filtered/sortable token directory, PRO+ (new in 1.7) |
+| `MADEONSOL_TOKENS_LIST_ACTION` | "filter tokens", "tokens by market cap", "scan tokens" — filtered/sortable token directory + momentum/trending sorts, PRO+ (new in 1.7) |
+| `MADEONSOL_ALMOST_BONDED_ACTION` | **New 1.14** · "almost bonded", "about to graduate", "near graduation" — pre-bond pump.fun tokens ranked by velocity (Δprogress/min): progress, ETA, stalled, deployer tier (PRO+) |
 | `MADEONSOL_WALLET_STATS_ACTION` | **New 1.8** · "wallet stats", "wallet info", "check wallet" — aggregate 90d stats + cross-product flags (KOL/alpha/deployer) for any Solana wallet (PRO+) |
 | `MADEONSOL_WALLET_PNL_ACTION` | **New 1.8** · "wallet pnl", "wallet profit", "wallet performance" — FIFO cost-basis PnL with profit factor, drawdown, daily curve, closed + open positions (PRO+) |
 | `MADEONSOL_WALLET_POSITIONS_ACTION` | **New 1.8** · "wallet positions", "wallet bags", "open positions" — open lots with live unrealized SOL (PRO+) |
 | `MADEONSOL_WALLET_TRADES_ACTION` | **New 1.8** · "wallet trades", "wallet history" — cursor-paginated raw trades with filters (PRO+) |
+| `MADEONSOL_TOKEN_FLOW_ACTION` | **New 1.13** · "token flow", "net flow", "buy/sell pressure" — net buy/sell flow over a 1h/24h window (PRO+) |
 
 ## Additional methods (v1.0+)
 
@@ -128,8 +134,12 @@ await agent.methods.tokenCapTable(agent, { mint: "MINT" });             // PRO=1
 await agent.methods.tokenBuyerQuality(agent, { mint: "MINT" });         // 0–100 buyer-quality score (5-min cached)
 await agent.methods.tokenRisk(agent, { mint: "MINT" });                 // PRO+ 0–100 rug-risk/safety score + band + factors
 await agent.methods.tokenCandles(agent, { mint: "MINT", tf: "1h" });    // PRO+ OHLCV candles (1m–1d); ULTRA=+net flow, liquidity, full history
+await agent.methods.tokenFlow(agent, { mint: "MINT", window: "24h" });  // PRO+ net buy/sell flow (1h/24h): unique wallets, buy/sell/net SOL, trades-per-wallet
+await agent.methods.almostBonded(agent, { min_progress: 90, sort: "eta_asc" }); // PRO+ pre-bond pump.fun tokens by velocity: progress, ETA, stalled, deployer tier
 ```
 
+> Deployer alerts (`MADEONSOL_DEPLOYER_ALERTS_ACTION` / `agent.methods.deployerAlerts()`) now include `deployer_sol_balance` — the deployer wallet's SOL balance at alert time (`null` for historical rows).
+
 ### Copy-Trade Rules (PRO/ULTRA)
 
 Server-side rules that fire signals when a watched source wallet trades. Delivered via webhook (HMAC-signed) and/or WebSocket.

package/dist/actions/almostBonded.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+export declare const almostBondedAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            min_progress: number;
+            min_velocity_pct_per_min: number;
+            deployer_tier: string;
+            sort: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        min_progress: z.ZodOptional<z.ZodNumber>;
+        max_progress: z.ZodOptional<z.ZodNumber>;
+        min_velocity_pct_per_min: z.ZodOptional<z.ZodNumber>;
+        max_age_minutes: z.ZodOptional<z.ZodNumber>;
+        deployer_tier: z.ZodOptional<z.ZodEnum<["elite", "good", "moderate", "rising", "cold", "unranked"]>>;
+        authority_revoked: z.ZodOptional<z.ZodBoolean>;
+        min_liq: z.ZodOptional<z.ZodNumber>;
+        sort: z.ZodOptional<z.ZodEnum<["velocity_desc", "progress_desc", "eta_asc"]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        sort?: "velocity_desc" | "progress_desc" | "eta_asc" | undefined;
+        min_liq?: number | undefined;
+        authority_revoked?: boolean | undefined;
+        deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked" | undefined;
+        min_progress?: number | undefined;
+        max_progress?: number | undefined;
+        min_velocity_pct_per_min?: number | undefined;
+        max_age_minutes?: number | undefined;
+    }, {
+        sort?: "velocity_desc" | "progress_desc" | "eta_asc" | undefined;
+        limit?: number | undefined;
+        min_liq?: number | undefined;
+        authority_revoked?: boolean | undefined;
+        deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked" | undefined;
+        min_progress?: number | undefined;
+        max_progress?: number | undefined;
+        min_velocity_pct_per_min?: number | undefined;
+        max_age_minutes?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        min_progress?: number;
+        max_progress?: number;
+        min_velocity_pct_per_min?: number;
+        max_age_minutes?: number;
+        deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
+        authority_revoked?: boolean;
+        min_liq?: number;
+        sort?: "velocity_desc" | "progress_desc" | "eta_asc";
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/almostBonded.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { almostBonded } from "../tools/index.js";
+export const almostBondedAction = {
+    name: "MADEONSOL_ALMOST_BONDED_ACTION",
+    similes: [
+        "almost bonded",
+        "about to graduate",
+        "near graduation",
+        "tokens about to bond",
+        "pre-bond tokens",
+        "almost graduated pumpfun",
+    ],
+    description: "Pre-bond pump.fun tokens approaching graduation (PRO+), ranked by velocity (Δprogress/min). Returns mint, symbol, progress_pct, velocity_pct_per_min, eta_minutes, stalled, deployer_tier. '95% and accelerating' beats '92% stalled'.",
+    examples: [
+        [
+            {
+                input: { min_progress: 90, min_velocity_pct_per_min: 0.5, deployer_tier: "elite", sort: "eta_asc", limit: 25 },
+                output: { status: "success" },
+                explanation: "Tokens >90% bonded, accelerating, from an elite deployer, soonest-to-bond first",
+            },
+        ],
+    ],
+    schema: z.object({
+        min_progress: z.number().min(0).max(100).optional().describe("Lower bound on bonding progress % (default 80)"),
+        max_progress: z.number().min(0).max(100).optional().describe("Upper bound on bonding progress % (default 99.99 — already-bonded excluded)"),
+        min_velocity_pct_per_min: z.number().optional().describe("Minimum Δprogress/min; drops tokens without a 5m snapshot"),
+        max_age_minutes: z.number().min(1).optional().describe("Max minutes since deploy (post-filter)"),
+        deployer_tier: z.enum(["elite", "good", "moderate", "rising", "cold", "unranked"]).optional().describe("Filter by deployer reputation tier"),
+        authority_revoked: z.boolean().optional().describe("Only tokens with mint+freeze authorities revoked"),
+        min_liq: z.number().min(0).optional().describe("Minimum liquidity USD"),
+        sort: z.enum(["velocity_desc", "progress_desc", "eta_asc"]).optional().describe("Sort axis (default velocity_desc)"),
+        limit: z.number().min(1).max(100).default(20).describe("Number of tokens (max 100)"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await almostBonded(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolAlertsRecent.d.ts

@@ -20,13 +20,13 @@ export declare const kolAlertsRecentAction: {
         limit: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         limit: number;
-        window: "24h" | "1h" | "6h" | "5m" | "15m";
+        window: "1h" | "24h" | "6h" | "5m" | "15m";
         types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
         min_severity?: "high" | "medium" | "low" | undefined;
     }, {
         limit?: number | undefined;
         types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
-        window?: "24h" | "1h" | "6h" | "5m" | "15m" | undefined;
+        window?: "1h" | "24h" | "6h" | "5m" | "15m" | undefined;
         min_severity?: "high" | "medium" | "low" | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/actions/kolCoordination.d.ts

@@ -18,11 +18,11 @@ export declare const kolCoordinationAction: {
         min_kols: z.ZodDefault<z.ZodNumber>;
         limit: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        period: "24h" | "1h" | "6h" | "7d";
+        period: "1h" | "24h" | "6h" | "7d";
         min_kols: number;
         limit: number;
     }, {
-        period?: "24h" | "1h" | "6h" | "7d" | undefined;
+        period?: "1h" | "24h" | "6h" | "7d" | undefined;
         min_kols?: number | undefined;
         limit?: number | undefined;
     }>;

package/dist/actions/tokenFlow.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export declare const tokenFlowAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            mint: string;
+            window: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        mint: z.ZodString;
+        window: z.ZodOptional<z.ZodEnum<["1h", "24h"]>>;
+    }, "strip", z.ZodTypeAny, {
+        mint: string;
+        window?: "1h" | "24h" | undefined;
+    }, {
+        mint: string;
+        window?: "1h" | "24h" | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        mint: string;
+        window?: "1h" | "24h";
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/tokenFlow.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { tokenFlow } from "../tools/index.js";
+export const tokenFlowAction = {
+    name: "MADEONSOL_TOKEN_FLOW_ACTION",
+    similes: ["token flow", "net flow", "buy sell flow", "buy pressure", "sell pressure", "net sol flow"],
+    description: "Get net buy/sell flow for a Solana 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/ULTRA only — BASIC receives HTTP 403.",
+    examples: [
+        [{ input: { mint: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", window: "24h" }, output: { status: "success" }, explanation: "Get the 24h net buy/sell flow for this token." }],
+    ],
+    schema: z.object({
+        mint: z.string().describe("Token mint address (base58)"),
+        window: z.enum(["1h", "24h"]).optional().describe("Rolling window (default 1h)"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await tokenFlow(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/tokensList.d.ts

@@ -32,12 +32,12 @@ export declare const tokensListAction: {
         min_liq_mc_ratio: z.ZodOptional<z.ZodNumber>;
         max_liq_mc_ratio: z.ZodOptional<z.ZodNumber>;
         deployer_tier: z.ZodOptional<z.ZodEnum<["elite", "good", "moderate", "rising", "cold", "unranked"]>>;
-        sort: z.ZodOptional<z.ZodEnum<["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc"]>>;
+        sort: z.ZodOptional<z.ZodEnum<["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc", "mc_change_5m_desc", "mc_change_1h_desc", "volume_1h_desc", "trending"]>>;
         limit: z.ZodDefault<z.ZodNumber>;
         offset: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         limit: number;
-        sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | undefined;
+        sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending" | undefined;
         min_mc?: number | undefined;
         max_mc?: number | undefined;
         min_liq?: number | undefined;
@@ -55,7 +55,7 @@ export declare const tokensListAction: {
         deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked" | undefined;
         offset?: number | undefined;
     }, {
-        sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | undefined;
+        sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending" | undefined;
         limit?: number | undefined;
         min_mc?: number | undefined;
         max_mc?: number | undefined;
@@ -90,7 +90,7 @@ export declare const tokensListAction: {
         min_liq_mc_ratio?: number;
         max_liq_mc_ratio?: number;
         deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
-        sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc";
+        sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending";
         limit?: number;
         offset?: number;
     }) => Promise<{

package/dist/actions/tokensList.js

@@ -42,9 +42,9 @@ export const tokensListAction = {
         max_liq_mc_ratio: z.number().min(0).optional().describe("Maximum liquidity-to-MC ratio"),
         deployer_tier: z.enum(["elite", "good", "moderate", "rising", "cold", "unranked"]).optional().describe("Filter by deployer reputation tier"),
         sort: z
-            .enum(["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc"])
+            .enum(["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc", "mc_change_5m_desc", "mc_change_1h_desc", "volume_1h_desc", "trending"])
             .optional()
-            .describe("Sort order"),
+            .describe("Sort order. Momentum sorts: mc_change_5m_desc, mc_change_1h_desc, volume_1h_desc, trending (composite recent-volume × positive-momentum rank)"),
         limit: z.number().min(1).max(100).default(20).describe("Number of tokens (max 100)"),
         offset: z.number().min(0).optional().describe("Pagination offset"),
     }),

package/dist/index.d.ts

@@ -11,9 +11,11 @@ import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.js";
 import { kolFirstTouchesAction } from "./actions/kolFirstTouches.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokensList.js";
+import { almostBondedAction } from "./actions/almostBonded.js";
 import { tokenRiskAction } from "./actions/tokenRisk.js";
 import { tokenCandlesAction } from "./actions/tokenCandles.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList } from "./tools/index.js";
+import { tokenFlowAction } from "./actions/tokenFlow.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, tokenFlow, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, almostBonded } from "./tools/index.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
 declare const MadeOnSolPlugin: {
     name: string;
@@ -44,6 +46,7 @@ declare const MadeOnSolPlugin: {
         tokenBuyerQuality: typeof tokenBuyerQuality;
         tokenRisk: typeof tokenRisk;
         tokenCandles: typeof tokenCandles;
+        tokenFlow: typeof tokenFlow;
         copyTradeList: typeof copyTradeList;
         copyTradeCreate: typeof copyTradeCreate;
         copyTradeGet: typeof copyTradeGet;
@@ -73,6 +76,7 @@ declare const MadeOnSolPlugin: {
         peakHistory: typeof peakHistory;
         me: typeof me;
         tokensList: typeof tokensList;
+        almostBonded: typeof almostBonded;
         walletStats: typeof walletStats;
         walletPnl: typeof walletPnl;
         walletPositions: typeof walletPositions;
@@ -137,11 +141,11 @@ declare const MadeOnSolPlugin: {
             min_kols: import("zod").ZodDefault<import("zod").ZodNumber>;
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
-            period: "24h" | "1h" | "6h" | "7d";
+            period: "1h" | "24h" | "6h" | "7d";
             min_kols: number;
             limit: number;
         }, {
-            period?: "24h" | "1h" | "6h" | "7d" | undefined;
+            period?: "1h" | "24h" | "6h" | "7d" | undefined;
             min_kols?: number | undefined;
             limit?: number | undefined;
         }>;
@@ -550,13 +554,13 @@ declare const MadeOnSolPlugin: {
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
             limit: number;
-            window: "24h" | "1h" | "6h" | "5m" | "15m";
+            window: "1h" | "24h" | "6h" | "5m" | "15m";
             types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
             min_severity?: "high" | "medium" | "low" | undefined;
         }, {
             limit?: number | undefined;
             types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
-            window?: "24h" | "1h" | "6h" | "5m" | "15m" | undefined;
+            window?: "1h" | "24h" | "6h" | "5m" | "15m" | undefined;
             min_severity?: "high" | "medium" | "low" | undefined;
         }>;
         handler: (agent: unknown, input: {
@@ -707,12 +711,12 @@ declare const MadeOnSolPlugin: {
             min_liq_mc_ratio: import("zod").ZodOptional<import("zod").ZodNumber>;
             max_liq_mc_ratio: import("zod").ZodOptional<import("zod").ZodNumber>;
             deployer_tier: import("zod").ZodOptional<import("zod").ZodEnum<["elite", "good", "moderate", "rising", "cold", "unranked"]>>;
-            sort: import("zod").ZodOptional<import("zod").ZodEnum<["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc"]>>;
+            sort: import("zod").ZodOptional<import("zod").ZodEnum<["mc_desc", "mc_asc", "last_trade_desc", "liquidity_desc", "cumulative_volume_desc", "mc_change_5m_desc", "mc_change_1h_desc", "volume_1h_desc", "trending"]>>;
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
             offset: import("zod").ZodOptional<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
             limit: number;
-            sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | undefined;
+            sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending" | undefined;
             min_mc?: number | undefined;
             max_mc?: number | undefined;
             min_liq?: number | undefined;
@@ -730,7 +734,7 @@ declare const MadeOnSolPlugin: {
             deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked" | undefined;
             offset?: number | undefined;
         }, {
-            sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | undefined;
+            sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending" | undefined;
             limit?: number | undefined;
             min_mc?: number | undefined;
             max_mc?: number | undefined;
@@ -765,7 +769,7 @@ declare const MadeOnSolPlugin: {
             min_liq_mc_ratio?: number;
             max_liq_mc_ratio?: number;
             deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
-            sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc";
+            sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending";
             limit?: number;
             offset?: number;
         }) => Promise<{
@@ -777,6 +781,73 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                min_progress: number;
+                min_velocity_pct_per_min: number;
+                deployer_tier: string;
+                sort: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            min_progress: import("zod").ZodOptional<import("zod").ZodNumber>;
+            max_progress: import("zod").ZodOptional<import("zod").ZodNumber>;
+            min_velocity_pct_per_min: import("zod").ZodOptional<import("zod").ZodNumber>;
+            max_age_minutes: import("zod").ZodOptional<import("zod").ZodNumber>;
+            deployer_tier: import("zod").ZodOptional<import("zod").ZodEnum<["elite", "good", "moderate", "rising", "cold", "unranked"]>>;
+            authority_revoked: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            min_liq: import("zod").ZodOptional<import("zod").ZodNumber>;
+            sort: import("zod").ZodOptional<import("zod").ZodEnum<["velocity_desc", "progress_desc", "eta_asc"]>>;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            limit: number;
+            sort?: "velocity_desc" | "progress_desc" | "eta_asc" | undefined;
+            min_liq?: number | undefined;
+            authority_revoked?: boolean | undefined;
+            deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked" | undefined;
+            min_progress?: number | undefined;
+            max_progress?: number | undefined;
+            min_velocity_pct_per_min?: number | undefined;
+            max_age_minutes?: number | undefined;
+        }, {
+            sort?: "velocity_desc" | "progress_desc" | "eta_asc" | undefined;
+            limit?: number | undefined;
+            min_liq?: number | undefined;
+            authority_revoked?: boolean | undefined;
+            deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked" | undefined;
+            min_progress?: number | undefined;
+            max_progress?: number | undefined;
+            min_velocity_pct_per_min?: number | undefined;
+            max_age_minutes?: number | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            min_progress?: number;
+            max_progress?: number;
+            min_velocity_pct_per_min?: number;
+            max_age_minutes?: number;
+            deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
+            authority_revoked?: boolean;
+            min_liq?: number;
+            sort?: "velocity_desc" | "progress_desc" | "eta_asc";
+            limit?: number;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
     } | {
         name: string;
         similes: string[];
@@ -856,6 +927,42 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                mint: string;
+                window: string;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            mint: import("zod").ZodString;
+            window: import("zod").ZodOptional<import("zod").ZodEnum<["1h", "24h"]>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            mint: string;
+            window?: "1h" | "24h" | undefined;
+        }, {
+            mint: string;
+            window?: "1h" | "24h" | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            mint: string;
+            window?: "1h" | "24h";
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
     } | {
         name: string;
         similes: string[];
@@ -948,8 +1055,8 @@ declare const MadeOnSolPlugin: {
     initialize(_agent: unknown): void;
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, tokenFlow, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, almostBonded, };
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, kolFirstTouchesAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };
-export { meAction, tokensListAction, tokenRiskAction, tokenCandlesAction };
+export { meAction, tokensListAction, almostBondedAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };

package/dist/index.js

@@ -11,9 +11,11 @@ import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.js";
 import { kolFirstTouchesAction } from "./actions/kolFirstTouches.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokensList.js";
+import { almostBondedAction } from "./actions/almostBonded.js";
 import { tokenRiskAction } from "./actions/tokenRisk.js";
 import { tokenCandlesAction } from "./actions/tokenCandles.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, } from "./tools/index.js";
+import { tokenFlowAction } from "./actions/tokenFlow.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, tokenFlow, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, almostBonded, } from "./tools/index.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
@@ -44,6 +46,7 @@ const MadeOnSolPlugin = {
         tokenBuyerQuality,
         tokenRisk,
         tokenCandles,
+        tokenFlow,
         copyTradeList,
         copyTradeCreate,
         copyTradeGet,
@@ -73,6 +76,7 @@ const MadeOnSolPlugin = {
         peakHistory,
         me,
         tokensList,
+        almostBonded,
         walletStats,
         walletPnl,
         walletPositions,
@@ -96,8 +100,10 @@ const MadeOnSolPlugin = {
         walletTrackerSummaryAction,
         meAction,
         tokensListAction,
+        almostBondedAction,
         tokenRiskAction,
         tokenCandlesAction,
+        tokenFlowAction,
         walletStatsAction,
         walletPnlAction,
         walletPositionsAction,
@@ -108,8 +114,8 @@ const MadeOnSolPlugin = {
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenCandles, tokenFlow, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, almostBonded, };
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, kolFirstTouchesAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };
-export { meAction, tokensListAction, tokenRiskAction, tokenCandlesAction };
+export { meAction, tokensListAction, almostBondedAction, tokenRiskAction, tokenCandlesAction, tokenFlowAction };

package/dist/tools/index.d.ts

@@ -179,6 +179,14 @@ export declare function tokenCandles(agent: Agent, params: {
     from?: string;
     to?: string;
 }): Promise<any>;
+/**
+ * Net buy/sell flow for a token over a rolling window (`1h` default, or `24h`). Returns unique
+ * wallet/buyer/seller counts, buy/sell trade counts, buy/sell/net SOL, and trades-per-wallet. PRO/ULTRA only.
+ */
+export declare function tokenFlow(agent: Agent, params: {
+    mint: string;
+    window?: "1h" | "24h";
+}): Promise<any>;
 /** Bulk buyer-quality scoring for up to 50 mints. Shares the 5-min LRU cache with the single-mint endpoint. */
 export declare function tokenBuyerQualityBatch(agent: Agent, params: {
     mints: string[];
@@ -303,10 +311,28 @@ export declare function tokensList(agent: Agent, params?: {
     max_liq_mc_ratio?: number;
     /** v1.10 — filter by deployer tier. */
     deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
-    sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc";
+    sort?: "mc_desc" | "mc_asc" | "last_trade_desc" | "liquidity_desc" | "cumulative_volume_desc" | "mc_change_5m_desc" | "mc_change_1h_desc" | "volume_1h_desc" | "trending";
     limit?: number;
     offset?: number;
 }): Promise<any>;
+/**
+ * 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.
+ */
+export declare function almostBonded(agent: Agent, params?: {
+    min_progress?: number;
+    max_progress?: number;
+    min_velocity_pct_per_min?: number;
+    max_age_minutes?: number;
+    deployer_tier?: "elite" | "good" | "moderate" | "rising" | "cold" | "unranked";
+    authority_revoked?: boolean;
+    min_liq?: number;
+    sort?: "velocity_desc" | "progress_desc" | "eta_asc";
+    limit?: number;
+}): Promise<any>;
 export declare function copyTradeSignals(agent: Agent, params?: {
     rule_id?: string;
     limit?: number;

package/dist/tools/index.js

@@ -278,6 +278,14 @@ export async function tokenCandles(agent, params) {
     const query = qs.toString() ? `?${qs.toString()}` : "";
     return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/candles${query}`);
 }
+/**
+ * Net buy/sell flow for a token over a rolling window (`1h` default, or `24h`). Returns unique
+ * wallet/buyer/seller counts, buy/sell trade counts, buy/sell/net SOL, and trades-per-wallet. PRO/ULTRA only.
+ */
+export async function tokenFlow(agent, params) {
+    const qs = params.window !== undefined ? `?window=${params.window}` : "";
+    return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/flow${qs}`);
+}
 /** Bulk buyer-quality scoring for up to 50 mints. Shares the 5-min LRU cache with the single-mint endpoint. */
 export async function tokenBuyerQualityBatch(agent, params) {
     return restQuery(agent, "POST", "/tokens/batch/buyer-quality", { mints: params.mints });
@@ -371,6 +379,22 @@ export async function tokensList(agent, params = {}) {
     const query = qs.toString() ? `?${qs.toString()}` : "";
     return restQuery(agent, "GET", `/tokens${query}`);
 }
+/**
+ * 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.
+ */
+export async function almostBonded(agent, params = {}) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            qs.set(k, String(v));
+    }
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/tokens/almost-bonded${query}`);
+}
 export async function copyTradeSignals(agent, params = {}) {
     const qs = new URLSearchParams();
     for (const [k, v] of Object.entries(params)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-agent-kit-plugin-madeonsol",
-  "version": "1.12.1",
+  "version": "1.14.0",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",