solana-agent-kit-plugin-madeonsol 1.16.1 → 1.17.0

package/README.md

@@ -9,8 +9,12 @@
 
 [Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit) plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL intelligence, deployer analytics, bundle-cohort held-% signals, and wallet tracking.
 
-> 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, every endpoint — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
+> Real-time Solana trading intelligence: track 1,069 KOL wallets with <3s latency, score 23,000+ Pump.fun deployers, verify any wallet's CURRENT on-chain holdings straight from its token accounts, surface deshred deploy signals ~500ms before on-chain confirmation, detect multi-KOL coordination, and stream every DEX trade. Free tier: 200 requests/day, every endpoint — no signup payment. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
+> **New in 1.17.0** — **Verified on-chain wallet holdings.** New tool `walletHoldings()` + action `MADEONSOL_WALLET_HOLDINGS_ACTION` — the wallet's CURRENT holdings read straight from chain: its actual SPL + Token-2022 token accounts and SOL balance, each enriched with `price_usd` / `value_usd` / `market_cap_usd` / `name` / `symbol` / `is_bonded`, plus `transfer_delta` (on-chain amount − trade-derived net position — exposes non-swap flows like airdrops, insider funding, wallet-hopping). Distinct from `walletPositions()` (trade-derived FIFO): this is what the wallet *actually* holds right now. Params: `limit` (1–500, default 200), `min_value_usd` (default 0). Returns `{ address, sol_balance, holdings[], summary, verified_at, trade_window_days, cache_hit, ttl_seconds }`. ULTRA only.
+>
+> **New in 1.16.2** — **Per-venue liquidity map + deployer reputation history.** New tool `tokenPools()` + action `MADEONSOL_TOKEN_POOLS_ACTION` — every DEX pool a token trades in (live vs parked), with fragmentation and top-pool share. Returns a `pools[]` list (`pool_address`, `dex`, `quote_mint`, `liquidity_usd`, `last_price_sol`, `last_swap_at`, `amm_id`, `is_active`) and a `summary` (`pool_count`, `active_pool_count`, `dex_count`, `dexes`, `total_liquidity_usd`, `primary_pool`, `primary_dex`, `top_pool_share_pct`). New tool `deployerHistory()` + action `MADEONSOL_DEPLOYER_HISTORY_ACTION` — a deployer's daily reputation time-series to backtest "was this deployer elite when it launched token X?" without look-ahead bias. Returns `{ is_deployer, wallet, snapshots[] }` where each snapshot has `date`, `tier`, `is_tracked`, `total_deployed`, `total_bonded`, `bonding_rate`, `recent_bond_rate`, `avg_peak_mc`, `best_token_peak_mc` (`limit` = 1–365 days, default 90). Both PRO/ULTRA only.
+>
 > **New in 1.16.0** — **Bundle-cohort holdings.** New tool `tokenBundle()` + action `MADEONSOL_TOKEN_BUNDLE_ACTION` — which same-slot "bundle" wallets (≥3 buying in one slot) bought a token and how much of supply they STILL hold, from confirmed on-chain data. Returns a `bundle` summary (`wallet_count`, `bundle_kind` [`atomic_tx`/`same_slot`/`none`], `held_ratio`, **`held_pct_of_supply`** [the headline rug/insider signal], `fully_exited`, `buy_volume`, `tokens_held`) plus a `wallets[]` list (`rank`, `wallet`, `held_ratio`, `has_sold`, `atomic`, `is_kol`). BASIC get the `bundle` block only (`wallets: []`); PRO gets top-10 flags-only; ULTRA adds full holdings + wallet identity (`kol_name`, `win_rate`, `bot_confidence`, `tokens_held`). PRO/ULTRA only.
 >
 > **New in 1.15.0** — **Batch risk scoring + WebSocket session control.** New tool `tokenRiskBatch()` + action `MADEONSOL_TOKEN_RISK_BATCH_ACTION` — bulk 0–100 rug-risk/safety scoring for 1–50 mints in one call (`{ tokens, count }`, same per-mint shape as `tokenRisk()` plus an `as_of` ISO string; untracked mints come back as `{ mint, error: "not_tracked" }` without failing the batch; counts as one request). New tools `streamSessions()` / `streamSessionKill({ id })` + actions `MADEONSOL_STREAM_SESSIONS_ACTION` / `MADEONSOL_STREAM_SESSION_KILL_ACTION` — list your live ws-streaming/dex-stream sessions (`id`, `service`, `tier`, `channels[]`, `connected_at`, `remote_ip`, `messages_sent`) and evict one by id to free a connection slot. PRO/ULTRA only.
@@ -112,11 +116,14 @@ const events = await agent.methods.walletTrackerTrades(agent, { limit: 50 });
 | `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_HOLDINGS_ACTION` | **New 1.17** · "wallet holdings", "current holdings", "what does wallet actually hold" — verified CURRENT on-chain holdings (real SPL + Token-2022 accounts + SOL) enriched with price/MC/name, plus `transfer_delta` vs trade-derived position (ULTRA only) |
 | `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+) |
 | `MADEONSOL_TOKEN_RISK_BATCH_ACTION` | **New 1.15** · "batch token risk", "bulk rug risk", "score many tokens" — rug-risk scoring for 1–50 mints in one call; untracked mints don't fail the batch (PRO+) |
 | `MADEONSOL_STREAM_SESSIONS_ACTION` | **New 1.15** · "list stream sessions", "live websocket sessions", "active ws sessions" — your live ws-streaming/dex-stream sessions (PRO+) |
 | `MADEONSOL_STREAM_SESSION_KILL_ACTION` | **New 1.15** · "kill stream session", "evict session", "free a connection slot" — evict a live streaming session by id (PRO+) |
+| `MADEONSOL_TOKEN_POOLS_ACTION` | **New 1.16.2** · "token pools", "liquidity map", "which dex pools", "pool fragmentation" — per-venue liquidity map (live vs parked pools) + top-pool share (PRO+) |
+| `MADEONSOL_DEPLOYER_HISTORY_ACTION` | **New 1.16.2** · "deployer history", "deployer reputation over time", "was this deployer elite" — a deployer's daily reputation time-series, backtest without look-ahead bias (PRO+) |
 
 ## Additional methods (v1.0+)
 
@@ -140,9 +147,11 @@ await agent.methods.tokenBuyerQuality(agent, { mint: "MINT" });         // 0–1
 await agent.methods.tokenRisk(agent, { mint: "MINT" });                 // PRO+ 0–100 rug-risk/safety score + band + factors
 await agent.methods.tokenRiskBatch(agent, { mints: ["MINT_A", "MINT_B"] }); // PRO+ bulk rug-risk for 1–50 mints → { tokens, count }; one request
 await agent.methods.tokenBundle(agent, { mint: "MINT" });               // PRO+ bundle-cohort holdings: held_pct_of_supply signal; ULTRA=+wallet identity
+await agent.methods.tokenPools(agent, { mint: "MINT" });                // PRO+ per-venue liquidity map: live vs parked pools, fragmentation, top-pool share
 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
+await agent.methods.deployerHistory(agent, { wallet: "WALLET", limit: 90 }); // PRO+ deployer daily reputation time-series (1–365d): tier, bonding_rate, peak MC — no look-ahead
 ```
 
 > 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).
@@ -304,6 +313,8 @@ console.log(lastRateLimit); // { limit: "10000", remaining: "9999", reset: "..."
 
 Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 
+New customers get a 5-day free trial of Pro or Ultra when you pay by card — full access, nothing charged during the trial, cancel anytime. Start at https://madeonsol.com/pricing
+
 ## Also Available
 
 | Platform | Package |

package/dist/actions/deployerHistory.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export declare const deployerHistoryAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            wallet: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        wallet: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        wallet: string;
+    }, {
+        wallet: string;
+        limit?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        wallet: string;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/deployerHistory.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { deployerHistory } from "../tools/index.js";
+export const deployerHistoryAction = {
+    name: "MADEONSOL_DEPLOYER_HISTORY_ACTION",
+    similes: ["deployer history", "deployer reputation over time", "was this deployer elite", "deployer tier time-series", "backtest deployer reputation", "deployer daily snapshots"],
+    description: "Get a deployer's daily reputation time-series — backtest \"was this deployer elite when it launched token X?\" without look-ahead bias. Returns `{ is_deployer, wallet, snapshots[] }` where each snapshot has `date`, `tier`, `is_tracked`, `total_deployed`, `total_bonded`, `bonding_rate`, `recent_bond_rate`, `avg_peak_mc`, `best_token_peak_mc`. `limit` is the number of days of history (1–365, default 90). PRO/ULTRA only — BASIC receives HTTP 403.",
+    examples: [
+        [{ input: { wallet: "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1", limit: 90 }, output: { status: "success" }, explanation: "What was this deployer's reputation tier over the last 90 days?" }],
+    ],
+    schema: z.object({
+        wallet: z.string().describe("Deployer wallet address (base58)"),
+        limit: z.number().min(1).max(365).default(90).describe("Days of history to return (1–365)"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await deployerHistory(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/tokenPools.d.ts

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

package/dist/actions/tokenPools.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { tokenPools } from "../tools/index.js";
+export const tokenPoolsAction = {
+    name: "MADEONSOL_TOKEN_POOLS_ACTION",
+    similes: ["token pools", "liquidity map", "which dex pools", "pool fragmentation", "where does this token trade", "top pool share"],
+    description: "Get the per-venue liquidity map for a Solana token — every DEX pool the token trades in (live vs parked), plus how fragmented its liquidity is and what share sits in the top pool. Returns a `pools[]` list (`pool_address`, `dex`, `quote_mint`, `liquidity_usd`, `last_price_sol`, `last_swap_at`, `amm_id`, `is_active`) and a `summary` (`pool_count`, `active_pool_count`, `dex_count`, `dexes`, `total_liquidity_usd`, `primary_pool`, `primary_dex`, `top_pool_share_pct`). PRO/ULTRA only — BASIC receives HTTP 403.",
+    examples: [
+        [{ input: { mint: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" }, output: { status: "success" }, explanation: "Which DEX pools does this token trade in, and how fragmented is its liquidity?" }],
+    ],
+    schema: z.object({
+        mint: z.string().describe("Token mint address (base58)"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await tokenPools(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/wallet.d.ts

@@ -95,6 +95,48 @@ export declare const walletPositionsAction: {
         result?: undefined;
     }>;
 };
+export declare const walletHoldingsAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            address: string;
+            limit: number;
+            min_value_usd: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        address: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        min_value_usd: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+        limit?: number | undefined;
+        min_value_usd?: number | undefined;
+    }, {
+        address: string;
+        limit?: number | undefined;
+        min_value_usd?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        address: string;
+        limit?: number;
+        min_value_usd?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
 export declare const walletTradesAction: {
     name: string;
     similes: string[];

package/dist/actions/wallet.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { walletStats, walletPnl, walletPositions, walletTrades } from "../tools/index.js";
+import { walletStats, walletPnl, walletPositions, walletHoldings, walletTrades } from "../tools/index.js";
 export const walletStatsAction = {
     name: "MADEONSOL_WALLET_STATS_ACTION",
     similes: [
@@ -100,6 +100,41 @@ export const walletPositionsAction = {
         }
     },
 };
+export const walletHoldingsAction = {
+    name: "MADEONSOL_WALLET_HOLDINGS_ACTION",
+    similes: [
+        "wallet holdings",
+        "current holdings",
+        "on-chain holdings",
+        "what does wallet actually hold",
+        "verified holdings",
+        "wallet token balances",
+    ],
+    description: "Verified CURRENT on-chain holdings for any Solana wallet — the wallet's actual SPL + Token-2022 token accounts and SOL balance read straight from chain, enriched with price_usd, value_usd, market_cap_usd, name, symbol, is_bonded, plus transfer_delta (on-chain amount − trade-derived net position, which exposes non-swap flows: airdrops, insider funding, wallet-hopping). Distinct from MADEONSOL_WALLET_POSITIONS_ACTION (trade-derived FIFO) — this is what the wallet actually holds right now. Returns { address, sol_balance, holdings[], summary, verified_at, trade_window_days, cache_hit, ttl_seconds }. ULTRA only.",
+    examples: [
+        [
+            {
+                input: { address: "ASVzakePP6GNg9r95d4LPZHJDMXun6L6E4um4pu5ybJk", limit: 50, min_value_usd: 10 },
+                output: { status: "success" },
+                explanation: "List the wallet's verified on-chain holdings worth at least $10",
+            },
+        ],
+    ],
+    schema: z.object({
+        address: z.string().describe("Solana wallet address"),
+        limit: z.number().min(1).max(500).optional().describe("Max holdings to return (1-500, default 200)"),
+        min_value_usd: z.number().min(0).optional().describe("Only return holdings worth at least this many USD (default 0)"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletHoldings(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
 export const walletTradesAction = {
     name: "MADEONSOL_WALLET_TRADES_ACTION",
     similes: [

package/dist/index.d.ts

@@ -14,12 +14,14 @@ import { tokensListAction } from "./actions/tokensList.js";
 import { almostBondedAction } from "./actions/almostBonded.js";
 import { tokenRiskAction } from "./actions/tokenRisk.js";
 import { tokenBundleAction } from "./actions/tokenBundle.js";
+import { tokenPoolsAction } from "./actions/tokenPools.js";
+import { deployerHistoryAction } from "./actions/deployerHistory.js";
 import { tokenCandlesAction } from "./actions/tokenCandles.js";
 import { tokenFlowAction } from "./actions/tokenFlow.js";
 import { tokenRiskBatchAction } from "./actions/tokenRiskBatch.js";
 import { streamSessionsAction, streamSessionKillAction } from "./actions/streamSessions.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, 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";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, tokenPools, tokenCandles, tokenFlow, deployerHistory, 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, walletHoldings, walletTrades, me, tokensList, almostBonded } from "./tools/index.js";
+import { walletStatsAction, walletPnlAction, walletPositionsAction, walletHoldingsAction, walletTradesAction } from "./actions/wallet.js";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -52,8 +54,10 @@ declare const MadeOnSolPlugin: {
         tokenRisk: typeof tokenRisk;
         tokenRiskBatch: typeof tokenRiskBatch;
         tokenBundle: typeof tokenBundle;
+        tokenPools: typeof tokenPools;
         tokenCandles: typeof tokenCandles;
         tokenFlow: typeof tokenFlow;
+        deployerHistory: typeof deployerHistory;
         copyTradeList: typeof copyTradeList;
         copyTradeCreate: typeof copyTradeCreate;
         copyTradeGet: typeof copyTradeGet;
@@ -87,6 +91,7 @@ declare const MadeOnSolPlugin: {
         walletStats: typeof walletStats;
         walletPnl: typeof walletPnl;
         walletPositions: typeof walletPositions;
+        walletHoldings: typeof walletHoldings;
         walletTrades: typeof walletTrades;
     };
     actions: ({
@@ -886,6 +891,42 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                wallet: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            wallet: import("zod").ZodString;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            limit: number;
+            wallet: string;
+        }, {
+            wallet: string;
+            limit?: number | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            wallet: string;
+            limit?: number;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
     } | {
         name: string;
         similes: string[];
@@ -1063,6 +1104,47 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                address: string;
+                limit: number;
+                min_value_usd: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            address: import("zod").ZodString;
+            limit: import("zod").ZodOptional<import("zod").ZodNumber>;
+            min_value_usd: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            address: string;
+            limit?: number | undefined;
+            min_value_usd?: number | undefined;
+        }, {
+            address: string;
+            limit?: number | undefined;
+            min_value_usd?: number | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            address: string;
+            limit?: number;
+            min_value_usd?: number;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
     } | {
         name: string;
         similes: string[];
@@ -1124,8 +1206,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, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, 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 { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, tokenPools, tokenCandles, tokenFlow, deployerHistory, 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, walletHoldings, 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, almostBondedAction, tokenRiskAction, tokenRiskBatchAction, tokenBundleAction, tokenCandlesAction, tokenFlowAction, streamSessionsAction, streamSessionKillAction };
+export { walletStatsAction, walletPnlAction, walletPositionsAction, walletHoldingsAction, walletTradesAction };
+export { meAction, tokensListAction, almostBondedAction, tokenRiskAction, tokenRiskBatchAction, tokenBundleAction, tokenPoolsAction, deployerHistoryAction, tokenCandlesAction, tokenFlowAction, streamSessionsAction, streamSessionKillAction };

package/dist/index.js

@@ -14,12 +14,14 @@ import { tokensListAction } from "./actions/tokensList.js";
 import { almostBondedAction } from "./actions/almostBonded.js";
 import { tokenRiskAction } from "./actions/tokenRisk.js";
 import { tokenBundleAction } from "./actions/tokenBundle.js";
+import { tokenPoolsAction } from "./actions/tokenPools.js";
+import { deployerHistoryAction } from "./actions/deployerHistory.js";
 import { tokenCandlesAction } from "./actions/tokenCandles.js";
 import { tokenFlowAction } from "./actions/tokenFlow.js";
 import { tokenRiskBatchAction } from "./actions/tokenRiskBatch.js";
 import { streamSessionsAction, streamSessionKillAction } from "./actions/streamSessions.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, 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";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, tokenPools, tokenCandles, tokenFlow, deployerHistory, 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, walletHoldings, walletTrades, me, tokensList, almostBonded, } from "./tools/index.js";
+import { walletStatsAction, walletPnlAction, walletPositionsAction, walletHoldingsAction, walletTradesAction } from "./actions/wallet.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -52,8 +54,10 @@ const MadeOnSolPlugin = {
         tokenRisk,
         tokenRiskBatch,
         tokenBundle,
+        tokenPools,
         tokenCandles,
         tokenFlow,
+        deployerHistory,
         copyTradeList,
         copyTradeCreate,
         copyTradeGet,
@@ -87,6 +91,7 @@ const MadeOnSolPlugin = {
         walletStats,
         walletPnl,
         walletPositions,
+        walletHoldings,
         walletTrades,
     },
     actions: [
@@ -111,6 +116,8 @@ const MadeOnSolPlugin = {
         tokenRiskAction,
         tokenRiskBatchAction,
         tokenBundleAction,
+        tokenPoolsAction,
+        deployerHistoryAction,
         tokenCandlesAction,
         tokenFlowAction,
         streamSessionsAction,
@@ -118,6 +125,7 @@ const MadeOnSolPlugin = {
         walletStatsAction,
         walletPnlAction,
         walletPositionsAction,
+        walletHoldingsAction,
         walletTradesAction,
     ],
     initialize(_agent) {
@@ -125,8 +133,8 @@ const MadeOnSolPlugin = {
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, 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 { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, streamSessions, streamSessionKill, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, tokenRisk, tokenRiskBatch, tokenBundle, tokenPools, tokenCandles, tokenFlow, deployerHistory, 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, walletHoldings, 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, almostBondedAction, tokenRiskAction, tokenRiskBatchAction, tokenBundleAction, tokenCandlesAction, tokenFlowAction, streamSessionsAction, streamSessionKillAction };
+export { walletStatsAction, walletPnlAction, walletPositionsAction, walletHoldingsAction, walletTradesAction };
+export { meAction, tokensListAction, almostBondedAction, tokenRiskAction, tokenRiskBatchAction, tokenBundleAction, tokenPoolsAction, deployerHistoryAction, tokenCandlesAction, tokenFlowAction, streamSessionsAction, streamSessionKillAction };

package/dist/tools/index.d.ts

@@ -100,6 +100,16 @@ export declare function kolTiming(agent: Agent, params: {
 export declare function deployerTrajectory(agent: Agent, params: {
     wallet: string;
 }): Promise<any>;
+/**
+ * A deployer's daily reputation time-series — backtest "was this deployer elite when it launched token X?"
+ * without look-ahead bias. Returns `{ is_deployer, wallet, snapshots[] }` where each snapshot has
+ * `date`, `tier`, `is_tracked`, `total_deployed`, `total_bonded`, `bonding_rate`, `recent_bond_rate`,
+ * `avg_peak_mc`, `best_token_peak_mc`. `limit` is days of history (1..365, default 90). PRO/ULTRA only.
+ */
+export declare function deployerHistory(agent: Agent, params: {
+    wallet: string;
+    limit?: number;
+}): Promise<any>;
 export declare function createWebhook(agent: Agent, params: {
     url: string;
     events: string[];
@@ -154,6 +164,19 @@ export declare function walletPnl(agent: Agent, params: {
 export declare function walletPositions(agent: Agent, params: {
     address: string;
 }): Promise<any>;
+/**
+ * Verified CURRENT on-chain holdings for any wallet — the wallet's actual SPL + Token-2022 token
+ * accounts and SOL balance read straight from chain, enriched with price/MC/name/symbol, plus
+ * `transfer_delta` (on-chain amount − trade-derived net position, exposing non-swap flows like
+ * airdrops, insider funding, wallet-hopping). Distinct from `walletPositions` (trade-derived FIFO):
+ * holdings = what the wallet actually holds right now. `limit` 1–500 (default 200); `min_value_usd`
+ * ≥0 (default 0). ULTRA only.
+ */
+export declare function walletHoldings(agent: Agent, params: {
+    address: string;
+    limit?: number;
+    min_value_usd?: number;
+}): Promise<any>;
 export declare function walletTrades(agent: Agent, params: {
     address: string;
     limit?: number;
@@ -188,6 +211,10 @@ export declare function tokenRisk(agent: Agent, params: {
 export declare function tokenBundle(agent: Agent, params: {
     mint: string;
 }): Promise<any>;
+/** Per-venue liquidity map: every DEX pool a token trades in (live vs parked), plus fragmentation + top-pool share. Returns `pools[]` ({ pool_address, dex, quote_mint, liquidity_usd, last_price_sol, last_swap_at, amm_id, is_active }) and a `summary` ({ pool_count, active_pool_count, dex_count, dexes, total_liquidity_usd, primary_pool, primary_dex, top_pool_share_pct }). PRO/ULTRA only. */
+export declare function tokenPools(agent: Agent, params: {
+    mint: string;
+}): Promise<any>;
 /** 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/ULTRA only. */
 export declare function tokenCandles(agent: Agent, params: {
     mint: string;

package/dist/tools/index.js

@@ -6,6 +6,7 @@
  * (MadeOnSol RapidAPI marketplace was retired 2026-04-19).
  * Get a free `msk_` key at https://madeonsol.com/pricing.
  */
+import { VERSION } from "../version.js";
 const BASE_URL = "https://madeonsol.com";
 let _authMode = null;
 let _authHeaders = {};
@@ -30,7 +31,7 @@ export async function initAuth(agent) {
     const privateKey = getConfig(agent, "SVM_PRIVATE_KEY");
     if (apiKey) {
         _authMode = "madeonsol";
-        _authHeaders = { Authorization: `Bearer ${apiKey}`, "User-Agent": "solana-agent-kit-plugin-madeonsol/1.16.1" };
+        _authHeaders = { Authorization: `Bearer ${apiKey}`, "User-Agent": `solana-agent-kit-plugin-madeonsol/${VERSION}` };
         _paidFetch = fetch;
         console.log("[madeonsol] Using MadeOnSol API key (Bearer auth)");
     }
@@ -146,6 +147,16 @@ export async function kolTiming(agent, params) {
 export async function deployerTrajectory(agent, params) {
     return restQuery(agent, "GET", `/deployer-hunter/${params.wallet}/trajectory`);
 }
+/**
+ * A deployer's daily reputation time-series — backtest "was this deployer elite when it launched token X?"
+ * without look-ahead bias. Returns `{ is_deployer, wallet, snapshots[] }` where each snapshot has
+ * `date`, `tier`, `is_tracked`, `total_deployed`, `total_bonded`, `bonding_rate`, `recent_bond_rate`,
+ * `avg_peak_mc`, `best_token_peak_mc`. `limit` is days of history (1..365, default 90). PRO/ULTRA only.
+ */
+export async function deployerHistory(agent, params) {
+    const qs = params.limit !== undefined ? `?limit=${params.limit}` : "";
+    return restQuery(agent, "GET", `/deployer-hunter/${encodeURIComponent(params.wallet)}/history${qs}`);
+}
 // ── REST helper (webhooks, streaming, alpha, copy-trade, wallet-tracker) ──
 async function restQuery(agent, method, path, body) {
     await initAuth(agent);
@@ -235,6 +246,23 @@ export async function walletPnl(agent, params) {
 export async function walletPositions(agent, params) {
     return restQuery(agent, "GET", `/wallet/${encodeURIComponent(params.address)}/positions`);
 }
+/**
+ * Verified CURRENT on-chain holdings for any wallet — the wallet's actual SPL + Token-2022 token
+ * accounts and SOL balance read straight from chain, enriched with price/MC/name/symbol, plus
+ * `transfer_delta` (on-chain amount − trade-derived net position, exposing non-swap flows like
+ * airdrops, insider funding, wallet-hopping). Distinct from `walletPositions` (trade-derived FIFO):
+ * holdings = what the wallet actually holds right now. `limit` 1–500 (default 200); `min_value_usd`
+ * ≥0 (default 0). ULTRA only.
+ */
+export async function walletHoldings(agent, params) {
+    const qs = new URLSearchParams();
+    if (params.limit !== undefined)
+        qs.set("limit", String(params.limit));
+    if (params.min_value_usd !== undefined)
+        qs.set("min_value_usd", String(params.min_value_usd));
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/wallet/${encodeURIComponent(params.address)}/holdings${query}`);
+}
 export async function walletTrades(agent, params) {
     const qs = new URLSearchParams();
     if (params.limit !== undefined)
@@ -283,6 +311,10 @@ export async function tokenRisk(agent, params) {
 export async function tokenBundle(agent, params) {
     return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/bundle`);
 }
+/** Per-venue liquidity map: every DEX pool a token trades in (live vs parked), plus fragmentation + top-pool share. Returns `pools[]` ({ pool_address, dex, quote_mint, liquidity_usd, last_price_sol, last_swap_at, amm_id, is_active }) and a `summary` ({ pool_count, active_pool_count, dex_count, dexes, total_liquidity_usd, primary_pool, primary_dex, top_pool_share_pct }). PRO/ULTRA only. */
+export async function tokenPools(agent, params) {
+    return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/pools`);
+}
 /** 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/ULTRA only. */
 export async function tokenCandles(agent, params) {
     const qs = new URLSearchParams();

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "1.17.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+// AUTO-GENERATED by ../gen-version.mjs (npm prebuild) from package.json. Do not edit.
+export const VERSION = "1.17.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-agent-kit-plugin-madeonsol",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,7 @@
     "README.md"
   ],
   "scripts": {
+    "prebuild": "node ../gen-version.mjs",
     "build": "tsc",
     "preflight": "bash ../../scripts/preflight-publish.sh",
     "prepublishOnly": "npm run preflight && npm run build"