solana-agent-kit-plugin-madeonsol 1.1.1 → 1.3.0

package/README.md

@@ -164,6 +164,7 @@ Free tier returns the full REST response shape on every endpoint — real wallet
 | Platform | Package |
 |---|---|
 | TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
+| Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
 | Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
 | MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
 | ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |

package/dist/actions/kolAlertsRecent.d.ts

@@ -22,12 +22,12 @@ export declare const kolAlertsRecentAction: {
         limit: number;
         window: "24h" | "1h" | "6h" | "5m" | "15m";
         types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
-        min_severity?: "low" | "medium" | "high" | 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;
-        min_severity?: "low" | "medium" | "high" | undefined;
+        min_severity?: "high" | "medium" | "low" | undefined;
     }>;
     handler: (agent: unknown, input: {
         window?: string;

package/dist/actions/kolFirstTouches.d.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+export declare const kolFirstTouchesAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            preset: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        limit: z.ZodDefault<z.ZodNumber>;
+        since: z.ZodOptional<z.ZodString>;
+        before: z.ZodOptional<z.ZodString>;
+        kol: z.ZodOptional<z.ZodString>;
+        min_kol_winrate_7d: z.ZodOptional<z.ZodNumber>;
+        min_scout_tier: z.ZodOptional<z.ZodEnum<["S", "A", "B", "C"]>>;
+        min_n_touches: z.ZodOptional<z.ZodNumber>;
+        strategy: z.ZodOptional<z.ZodEnum<["scalper", "day_trader", "swing_trader", "hodler", "mixed"]>>;
+        token_age_max_min: z.ZodOptional<z.ZodNumber>;
+        min_first_buy_sol: z.ZodOptional<z.ZodNumber>;
+        mint_suffix: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<["scout", "fresh_launch"]>>;
+        include: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        before?: string | undefined;
+        since?: string | undefined;
+        kol?: string | undefined;
+        min_kol_winrate_7d?: number | undefined;
+        min_scout_tier?: "S" | "A" | "B" | "C" | undefined;
+        min_n_touches?: number | undefined;
+        strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed" | undefined;
+        token_age_max_min?: number | undefined;
+        min_first_buy_sol?: number | undefined;
+        mint_suffix?: string | undefined;
+        preset?: "scout" | "fresh_launch" | undefined;
+        include?: string | undefined;
+    }, {
+        limit?: number | undefined;
+        before?: string | undefined;
+        since?: string | undefined;
+        kol?: string | undefined;
+        min_kol_winrate_7d?: number | undefined;
+        min_scout_tier?: "S" | "A" | "B" | "C" | undefined;
+        min_n_touches?: number | undefined;
+        strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed" | undefined;
+        token_age_max_min?: number | undefined;
+        min_first_buy_sol?: number | undefined;
+        mint_suffix?: string | undefined;
+        preset?: "scout" | "fresh_launch" | undefined;
+        include?: string | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        limit?: number;
+        since?: string;
+        before?: string;
+        kol?: string;
+        min_kol_winrate_7d?: number;
+        min_scout_tier?: "S" | "A" | "B" | "C";
+        min_n_touches?: number;
+        strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed";
+        token_age_max_min?: number;
+        min_first_buy_sol?: number;
+        mint_suffix?: string;
+        preset?: "scout" | "fresh_launch";
+        include?: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolFirstTouches.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { kolFirstTouches } from "../tools/index.js";
+export const kolFirstTouchesAction = {
+    name: "MADEONSOL_KOL_FIRST_TOUCHES_ACTION",
+    similes: [
+        "kol first touch",
+        "first kol buyer",
+        "scout signal",
+        "smart money first buyer",
+        "kol scout alert",
+        "first buy by kol",
+    ],
+    description: "Get the most recent first-KOL-touch events on Solana tokens — the moment a tracked KOL was the first to buy a given mint. Filterable by scout tier (S/A/B/C from mv_kol_scout_score), KOL winrate, token age, mint suffix. Backtest: top scouts attract >=3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline.",
+    examples: [
+        [
+            {
+                input: { preset: "scout", limit: 10 },
+                output: { status: "success" },
+                explanation: "Fetch 10 recent first-touch events from B-tier-or-better scouts on tokens younger than 60 minutes",
+            },
+        ],
+    ],
+    schema: z.object({
+        limit: z.number().min(1).max(100).default(20).describe("Number of events (1-100)"),
+        since: z.string().optional().describe("ISO timestamp — events strictly newer than this"),
+        before: z.string().optional().describe("ISO timestamp — events strictly older than this (pagination cursor)"),
+        kol: z.string().optional().describe("Single KOL wallet address (base58)"),
+        min_kol_winrate_7d: z.number().min(0).max(100).optional(),
+        min_scout_tier: z.enum(["S", "A", "B", "C"]).optional().describe("Scout tier S/A/B/C (S = highest)"),
+        min_n_touches: z.number().min(1).optional(),
+        strategy: z.enum(["scalper", "day_trader", "swing_trader", "hodler", "mixed"]).optional(),
+        token_age_max_min: z.number().min(1).optional().describe("Only events on tokens younger than N minutes"),
+        min_first_buy_sol: z.number().min(0).optional(),
+        mint_suffix: z.string().optional().describe("Suffix-filter the token mint (e.g. 'pump')"),
+        preset: z.enum(["scout", "fresh_launch"]).optional(),
+        include: z.string().optional().describe("Comma-separated includes — currently 'followers_4h'"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolFirstTouches(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/index.d.ts

@@ -8,7 +8,8 @@ import { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemo
 import { kolTokenEntryOrderAction } from "./actions/kolTokenEntryOrder.js";
 import { kolCompareAction } from "./actions/kolCompare.js";
 import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete } from "./tools/index.js";
+import { kolFirstTouchesAction } from "./actions/kolFirstTouches.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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete } from "./tools/index.js";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -47,6 +48,12 @@ declare const MadeOnSolPlugin: {
         coordinationAlertsGet: typeof coordinationAlertsGet;
         coordinationAlertsUpdate: typeof coordinationAlertsUpdate;
         coordinationAlertsDelete: typeof coordinationAlertsDelete;
+        kolFirstTouches: typeof kolFirstTouches;
+        firstTouchSubscriptionsList: typeof firstTouchSubscriptionsList;
+        firstTouchSubscriptionsCreate: typeof firstTouchSubscriptionsCreate;
+        firstTouchSubscriptionsGet: typeof firstTouchSubscriptionsGet;
+        firstTouchSubscriptionsUpdate: typeof firstTouchSubscriptionsUpdate;
+        firstTouchSubscriptionsDelete: typeof firstTouchSubscriptionsDelete;
     };
     actions: ({
         name: string;
@@ -543,12 +550,12 @@ declare const MadeOnSolPlugin: {
             limit: number;
             window: "24h" | "1h" | "6h" | "5m" | "15m";
             types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
-            min_severity?: "low" | "medium" | "high" | 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;
-            min_severity?: "low" | "medium" | "high" | undefined;
+            min_severity?: "high" | "medium" | "low" | undefined;
         }>;
         handler: (agent: unknown, input: {
             window?: string;
@@ -564,10 +571,90 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                preset: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+            since: import("zod").ZodOptional<import("zod").ZodString>;
+            before: import("zod").ZodOptional<import("zod").ZodString>;
+            kol: import("zod").ZodOptional<import("zod").ZodString>;
+            min_kol_winrate_7d: import("zod").ZodOptional<import("zod").ZodNumber>;
+            min_scout_tier: import("zod").ZodOptional<import("zod").ZodEnum<["S", "A", "B", "C"]>>;
+            min_n_touches: import("zod").ZodOptional<import("zod").ZodNumber>;
+            strategy: import("zod").ZodOptional<import("zod").ZodEnum<["scalper", "day_trader", "swing_trader", "hodler", "mixed"]>>;
+            token_age_max_min: import("zod").ZodOptional<import("zod").ZodNumber>;
+            min_first_buy_sol: import("zod").ZodOptional<import("zod").ZodNumber>;
+            mint_suffix: import("zod").ZodOptional<import("zod").ZodString>;
+            preset: import("zod").ZodOptional<import("zod").ZodEnum<["scout", "fresh_launch"]>>;
+            include: import("zod").ZodOptional<import("zod").ZodString>;
+        }, "strip", import("zod").ZodTypeAny, {
+            limit: number;
+            before?: string | undefined;
+            since?: string | undefined;
+            kol?: string | undefined;
+            min_kol_winrate_7d?: number | undefined;
+            min_scout_tier?: "S" | "A" | "B" | "C" | undefined;
+            min_n_touches?: number | undefined;
+            strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed" | undefined;
+            token_age_max_min?: number | undefined;
+            min_first_buy_sol?: number | undefined;
+            mint_suffix?: string | undefined;
+            preset?: "scout" | "fresh_launch" | undefined;
+            include?: string | undefined;
+        }, {
+            limit?: number | undefined;
+            before?: string | undefined;
+            since?: string | undefined;
+            kol?: string | undefined;
+            min_kol_winrate_7d?: number | undefined;
+            min_scout_tier?: "S" | "A" | "B" | "C" | undefined;
+            min_n_touches?: number | undefined;
+            strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed" | undefined;
+            token_age_max_min?: number | undefined;
+            min_first_buy_sol?: number | undefined;
+            mint_suffix?: string | undefined;
+            preset?: "scout" | "fresh_launch" | undefined;
+            include?: string | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            limit?: number;
+            since?: string;
+            before?: string;
+            kol?: string;
+            min_kol_winrate_7d?: number;
+            min_scout_tier?: "S" | "A" | "B" | "C";
+            min_n_touches?: number;
+            strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed";
+            token_age_max_min?: number;
+            min_first_buy_sol?: number;
+            mint_suffix?: string;
+            preset?: "scout" | "fresh_launch";
+            include?: string;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
     })[];
     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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
+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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, kolFirstTouchesAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/index.js

@@ -8,7 +8,8 @@ import { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemo
 import { kolTokenEntryOrderAction } from "./actions/kolTokenEntryOrder.js";
 import { kolCompareAction } from "./actions/kolCompare.js";
 import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, } from "./tools/index.js";
+import { kolFirstTouchesAction } from "./actions/kolFirstTouches.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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, } from "./tools/index.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -47,6 +48,12 @@ const MadeOnSolPlugin = {
         coordinationAlertsGet,
         coordinationAlertsUpdate,
         coordinationAlertsDelete,
+        kolFirstTouches,
+        firstTouchSubscriptionsList,
+        firstTouchSubscriptionsCreate,
+        firstTouchSubscriptionsGet,
+        firstTouchSubscriptionsUpdate,
+        firstTouchSubscriptionsDelete,
     },
     actions: [
         kolFeedAction,
@@ -58,6 +65,7 @@ const MadeOnSolPlugin = {
         kolTokenEntryOrderAction,
         kolCompareAction,
         kolAlertsRecentAction,
+        kolFirstTouchesAction,
         walletTrackerWatchlistAction,
         walletTrackerAddAction,
         walletTrackerRemoveAction,
@@ -69,6 +77,6 @@ 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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
+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, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, kolFirstTouchesAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/tools/index.d.ts

@@ -20,8 +20,14 @@ export declare function initAuth(agent: Agent): Promise<void>;
 export declare function initPaidFetch(agent: Agent): Promise<typeof fetch>;
 export declare function kolFeed(agent: Agent, params?: {
     limit?: number;
+    before?: string;
     action?: string;
     kol?: string;
+    min_sol?: number;
+    token_age_max_min?: number;
+    exclude_sells?: boolean;
+    min_kol_winrate?: number;
+    strategy?: string;
 }): Promise<any>;
 export declare function kolCoordination(agent: Agent, params?: {
     period?: string;
@@ -48,8 +54,12 @@ export declare function kolLeaderboard(agent: Agent, params?: {
 export declare function deployerAlerts(agent: Agent, params?: {
     limit?: number;
     since?: string;
+    before?: string;
     offset?: number;
     tier?: "elite" | "good" | "moderate" | "rising" | "cold";
+    alert_type?: string;
+    priority?: "high" | "medium" | "low";
+    min_kol_buys?: number;
 }): Promise<any>;
 export declare function kolPairs(agent: Agent, params?: {
     period?: string;
@@ -139,6 +149,18 @@ export declare function tokenCapTable(agent: Agent, params: {
 export declare function tokenBuyerQuality(agent: Agent, params: {
     mint: string;
 }): 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[];
+}): Promise<any>;
+/** Comprehensive per-mint snapshot: price, MC, 24h volume, deployer reputation, KOL activity, age, blacklist status. */
+export declare function tokenGet(agent: Agent, params: {
+    mint: string;
+}): Promise<any>;
+/** Bulk token snapshot for up to 50 mints — same per-mint shape as tokenGet(). 10-20× cheaper than N sequential calls. */
+export declare function tokenBatch(agent: Agent, params: {
+    mints: string[];
+}): Promise<any>;
 export declare function copyTradeList(agent: Agent): Promise<any>;
 export declare function copyTradeCreate(agent: Agent, params: {
     name: string;
@@ -180,6 +202,44 @@ export declare function coordinationAlertsUpdate(agent: Agent, params: {
 export declare function coordinationAlertsDelete(agent: Agent, params: {
     rule_id: string;
 }): Promise<any>;
+export declare function kolFirstTouches(agent: Agent, params?: {
+    since?: string;
+    before?: string;
+    limit?: number;
+    kol?: string;
+    min_kol_winrate_7d?: number;
+    min_scout_tier?: "S" | "A" | "B" | "C";
+    min_n_touches?: number;
+    strategy?: "scalper" | "day_trader" | "swing_trader" | "hodler" | "mixed";
+    token_age_max_min?: number;
+    min_first_buy_sol?: number;
+    mint_suffix?: string;
+    preset?: "scout" | "fresh_launch";
+    include?: string;
+}): Promise<any>;
+export declare function firstTouchSubscriptionsList(agent: Agent): Promise<any>;
+export declare function firstTouchSubscriptionsCreate(agent: Agent, params: {
+    name?: string;
+    filters?: {
+        kol?: string;
+        mint_suffix?: string;
+        min_first_buy_sol?: number;
+        min_scout_tier?: "S" | "A" | "B" | "C";
+        min_n_touches?: number;
+    };
+    delivery_mode?: "websocket" | "webhook" | "both";
+    webhook_url?: string;
+}): Promise<any>;
+export declare function firstTouchSubscriptionsGet(agent: Agent, params: {
+    subscription_id: string;
+}): Promise<any>;
+export declare function firstTouchSubscriptionsUpdate(agent: Agent, params: {
+    subscription_id: string;
+    updates: Record<string, unknown>;
+}): Promise<any>;
+export declare function firstTouchSubscriptionsDelete(agent: Agent, params: {
+    subscription_id: string;
+}): Promise<any>;
 export declare function copyTradeSignals(agent: Agent, params?: {
     rule_id?: string;
     limit?: number;

package/dist/tools/index.js

@@ -221,17 +221,30 @@ export async function alphaLeaderboard(agent, params = {}) {
     return restQuery(agent, "GET", `/alpha/leaderboard${query}`);
 }
 export async function alphaWallet(agent, params) {
-    return restQuery(agent, "GET", `/alpha/wallet/${encodeURIComponent(params.wallet)}`);
+    return restQuery(agent, "GET", `/alpha/${encodeURIComponent(params.wallet)}`);
 }
 export async function alphaLinked(agent, params) {
-    return restQuery(agent, "GET", `/alpha/wallet/${encodeURIComponent(params.wallet)}/linked`);
+    return restQuery(agent, "GET", `/alpha/${encodeURIComponent(params.wallet)}/linked`);
 }
 // ── Token Quality ──
 export async function tokenCapTable(agent, params) {
-    return restQuery(agent, "GET", `/token/${encodeURIComponent(params.mint)}/cap-table`);
+    return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/cap-table`);
 }
 export async function tokenBuyerQuality(agent, params) {
-    return restQuery(agent, "GET", `/token/${encodeURIComponent(params.mint)}/buyer-quality`);
+    return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/buyer-quality`);
+}
+/** 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 });
+}
+// ── Token Intelligence (/token/{mint}) ──
+/** Comprehensive per-mint snapshot: price, MC, 24h volume, deployer reputation, KOL activity, age, blacklist status. */
+export async function tokenGet(agent, params) {
+    return restQuery(agent, "GET", `/token/${encodeURIComponent(params.mint)}`);
+}
+/** Bulk token snapshot for up to 50 mints — same per-mint shape as tokenGet(). 10-20× cheaper than N sequential calls. */
+export async function tokenBatch(agent, params) {
+    return restQuery(agent, "POST", "/token/batch", { mints: params.mints });
 }
 // ── Copy-Trade Rules (PRO/ULTRA) ──
 export async function copyTradeList(agent) {
@@ -265,6 +278,31 @@ export async function coordinationAlertsUpdate(agent, params) {
 export async function coordinationAlertsDelete(agent, params) {
     return restQuery(agent, "DELETE", `/kol/coordination/alerts/${encodeURIComponent(params.rule_id)}`);
 }
+// ── First-Touch Signal ──
+export async function kolFirstTouches(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", `/kol/first-touches${query}`);
+}
+export async function firstTouchSubscriptionsList(agent) {
+    return restQuery(agent, "GET", "/kol/first-touches/subscriptions");
+}
+export async function firstTouchSubscriptionsCreate(agent, params) {
+    return restQuery(agent, "POST", "/kol/first-touches/subscriptions", params);
+}
+export async function firstTouchSubscriptionsGet(agent, params) {
+    return restQuery(agent, "GET", `/kol/first-touches/subscriptions/${encodeURIComponent(params.subscription_id)}`);
+}
+export async function firstTouchSubscriptionsUpdate(agent, params) {
+    return restQuery(agent, "PATCH", `/kol/first-touches/subscriptions/${encodeURIComponent(params.subscription_id)}`, params.updates);
+}
+export async function firstTouchSubscriptionsDelete(agent, params) {
+    return restQuery(agent, "DELETE", `/kol/first-touches/subscriptions/${encodeURIComponent(params.subscription_id)}`);
+}
 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.1.1",
+  "version": "1.3.0",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",