@madeonsol/plugin-madeonsol 1.2.0 → 1.3.1

package/README.md

@@ -87,6 +87,33 @@ const res = await client.coordinationAlertsCreate({
 
 PRO=5 rules, ULTRA=20. Also available: `coordinationAlertsList()`, `coordinationAlertsGet(id)`, `coordinationAlertsUpdate(id, updates)`, `coordinationAlertsDelete(id)`.
 
+### 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).
+
+```ts
+import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
+const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
+
+// REST query
+const { events } = await client.firstTouches({ preset: "scout", min_scout_tier: "S", limit: 20 });
+
+// Webhook subscription (Ultra) — push delivery, HMAC-signed
+const { subscription, webhook_secret } = await client.firstTouchSubscriptionsCreate({
+  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 webhook_secret — shown ONCE
+```
+
+ULTRA only for subscriptions — up to 10 active. CRUD: `firstTouchSubscriptionsList()`, `firstTouchSubscriptionsGet(id)`, `firstTouchSubscriptionsUpdate(id, updates)`, `firstTouchSubscriptionsDelete(id)`.
+
+> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches`.
+
 Your agent can then respond to queries like:
 - "What are KOLs buying right now?"
 - "Show me the KOL leaderboard this week"

package/dist/client.d.ts

@@ -337,6 +337,61 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    firstTouches(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<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    firstTouchSubscriptionsList(): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    firstTouchSubscriptionsCreate(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<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    firstTouchSubscriptionsGet(id: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    firstTouchSubscriptionsUpdate(id: string, updates: Record<string, unknown>): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    firstTouchSubscriptionsDelete(id: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
     copyTradeSignals(params?: {
         rule_id?: string;
         limit?: string;

package/dist/client.js

@@ -245,6 +245,31 @@ export class MadeOnSolClient {
     coordinationAlertsDelete(ruleId) {
         return this.restRequest("DELETE", `/kol/coordination/alerts/${encodeURIComponent(ruleId)}`);
     }
+    // ── First-touch signal ──
+    firstTouches(params) {
+        const qs = new URLSearchParams();
+        if (params)
+            for (const [k, v] of Object.entries(params))
+                if (v !== undefined)
+                    qs.set(k, String(v));
+        const query = qs.toString() ? `?${qs.toString()}` : "";
+        return this.restRequest("GET", `/kol/first-touches${query}`);
+    }
+    firstTouchSubscriptionsList() {
+        return this.restRequest("GET", "/kol/first-touches/subscriptions");
+    }
+    firstTouchSubscriptionsCreate(params) {
+        return this.restRequest("POST", "/kol/first-touches/subscriptions", params);
+    }
+    firstTouchSubscriptionsGet(id) {
+        return this.restRequest("GET", `/kol/first-touches/subscriptions/${encodeURIComponent(id)}`);
+    }
+    firstTouchSubscriptionsUpdate(id, updates) {
+        return this.restRequest("PATCH", `/kol/first-touches/subscriptions/${encodeURIComponent(id)}`, updates);
+    }
+    firstTouchSubscriptionsDelete(id) {
+        return this.restRequest("DELETE", `/kol/first-touches/subscriptions/${encodeURIComponent(id)}`);
+    }
     copyTradeSignals(params) {
         const qs = new URLSearchParams();
         if (params)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madeonsol/plugin-madeonsol",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",