solana-agent-kit-plugin-madeonsol 1.2.0 → 1.3.1

package/README.md

@@ -71,6 +71,7 @@ const events = await agent.methods.walletTrackerTrades(agent, { limit: 50 });
 | `MADEONSOL_DEPLOYER_ALERTS_ACTION` | "deployer alerts", "pump fun launches" |
 | `MADEONSOL_KOL_PNL_ACTION` | "kol pnl", "kol profit", "wallet pnl" |
 | `MADEONSOL_KOL_TRENDING_TOKENS_ACTION` | "kol trending tokens", "kol volume" |
+| `MADEONSOL_KOL_FIRST_TOUCHES_ACTION` | "kol first touch", "first kol buyer", "scout signal" — backtested first-mover signal (new in 1.3) |
 | `MADEONSOL_WALLET_TRACKER_WATCHLIST_ACTION` | "wallet watchlist", "tracked wallets" |
 | `MADEONSOL_WALLET_TRACKER_ADD_ACTION` | "track wallet", "watch wallet", "add to watchlist" |
 | `MADEONSOL_WALLET_TRACKER_REMOVE_ACTION` | "untrack wallet", "remove from watchlist" |
@@ -139,6 +140,39 @@ await agent.methods.coordinationAlertsDelete(agent, { rule_id: "uuid..." });
 
 The v1.1 `kolCoordination()` response also includes `peak_kols`, `peak_buys`, `exited_count`, and `coordination_score` (0-100). Pass `{ min_score, window_minutes, include_majors }` to filter.
 
+### KOL First-Touch Signal *(new in 1.3)*
+
+Every "first KOL buy on a token mint" event — when a tracked KOL is the first of the cohort to touch a token. Filterable by **scout tier** (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix.
+
+**Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys / 72,549 events). Public leaderboard at [madeonsol.com/kol/scouts](https://madeonsol.com/kol/scouts).
+
+```ts
+// REST query — also exposed as MADEONSOL_KOL_FIRST_TOUCHES_ACTION for the agent
+const { events } = await agent.methods.kolFirstTouches(agent, {
+  preset: "scout",
+  min_scout_tier: "S",
+  limit: 20,
+});
+
+// Webhook subscription (Ultra only) — push delivery, HMAC-signed
+const res = await agent.methods.firstTouchSubscriptionsCreate(agent, {
+  name: "S-tier scouts on pump tokens",
+  filters: { min_scout_tier: "S", mint_suffix: "pump" },
+  delivery_mode: "webhook",
+  webhook_url: "https://you.com/hooks/scout",
+});
+// store res.webhook_secret — shown ONCE
+
+await agent.methods.firstTouchSubscriptionsList(agent);
+await agent.methods.firstTouchSubscriptionsGet(agent, { subscription_id: "uuid..." });
+await agent.methods.firstTouchSubscriptionsUpdate(agent, { subscription_id: "uuid...", updates: { is_active: false } });
+await agent.methods.firstTouchSubscriptionsDelete(agent, { subscription_id: "uuid..." });
+```
+
+ULTRA only for subscriptions — up to 10 active per user.
+
+> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
+
 ### Rate-limit headers
 
 Every successful request populates a module-level `lastRateLimit` (limit / remaining / reset / requestId):

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;
@@ -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

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

@@ -278,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.2.0",
+  "version": "1.3.1",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",