solana-agent-kit-plugin-madeonsol 1.0.0 → 1.1.0

package/README.md

@@ -4,6 +4,20 @@
 
 > Real-time Solana trading intelligence: track 1,000+ KOL wallets with <3s latency, score 6,700+ Pump.fun deployers by reputation, detect multi-KOL coordination signals, monitor any Solana wallet for swaps and transfers, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/developer](https://madeonsol.com/developer) — no credit card required.
 
+## Quick start (10 seconds)
+
+```bash
+npm install solana-agent-kit-plugin-madeonsol
+```
+
+```ts
+import { SolanaAgentKit } from "solana-agent-kit";
+import MadeOnSolPlugin from "solana-agent-kit-plugin-madeonsol";
+const agent = new SolanaAgentKit(privateKey, rpcUrl, { MADEONSOL_API_KEY: "msk_..." }); // free key: https://madeonsol.com/developer
+agent.use(MadeOnSolPlugin);
+const trades = await agent.methods.kolFeed(agent, { limit: 5, action: "buy" });
+```
+
 ## Authentication
 
 Two options (in priority order):
@@ -99,6 +113,32 @@ await agent.methods.copyTradeCreate(agent, {
 await agent.methods.copyTradeSignals(agent, { limit: 50 });             // up to 7 days
 ```
 
+### KOL Coordination Alerts (PRO/ULTRA — v1.1 push signals)
+
+Real-time push alerts when a KOL cluster co-buys the same token. Fires within ~1s of the triggering trade (pg_notify push, not polling). Delivered via WebSocket (`kol:coordination` channel, user-scoped) and/or HMAC-signed webhook. PRO=5 rules, ULTRA=20.
+
+```ts
+const res = await agent.methods.coordinationAlertsCreate(agent, {
+  name: "fresh pump cluster",
+  min_kols: 4,
+  window_minutes: 15,     // peak-density window (1-60)
+  min_score: 70,          // 0-100 composite score cutoff
+  include_majors: false,  // filter WIF/BONK/POPCAT
+  cooldown_min: 60,
+  score_jump_break: 10,
+  delivery_mode: "both",
+  webhook_url: "https://you.com/hooks/coord",
+});
+// store res.webhook_secret — shown ONCE
+
+await agent.methods.coordinationAlertsList(agent);
+await agent.methods.coordinationAlertsGet(agent, { rule_id: "uuid..." });
+await agent.methods.coordinationAlertsUpdate(agent, { rule_id: "uuid...", updates: { is_active: false } });
+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.
+
 ### Rate-limit headers
 
 Every successful request populates a module-level `lastRateLimit` (limit / remaining / reset / requestId):
@@ -115,7 +155,7 @@ console.log(lastRateLimit); // { limit: "10000", remaining: "9999", reset: "..."
 |------|-------|-----------------|--------------|
 | BASIC | Free | 10 | 200 |
 | PRO | $49/mo | 50 | 10,000 |
-| ULTRA | $199/mo | 100 + WS events | 100,000 |
+| ULTRA | $149/mo | 100 + WS events | 100,000 |
 
 Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
 

package/dist/actions/kolCoordination.d.ts

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

package/dist/actions/kolLeaderboard.d.ts

@@ -17,11 +17,11 @@ export declare const kolLeaderboardAction: {
         period: z.ZodDefault<z.ZodEnum<["today", "7d", "30d"]>>;
         limit: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        limit: number;
         period: "7d" | "today" | "30d";
+        limit: number;
     }, {
-        limit?: number | undefined;
         period?: "7d" | "today" | "30d" | undefined;
+        limit?: number | undefined;
     }>;
     handler: (agent: unknown, input: {
         period?: string;

package/dist/actions/kolPnl.d.ts

@@ -17,8 +17,8 @@ export declare const kolPnlAction: {
         wallet: z.ZodString;
         period: z.ZodDefault<z.ZodEnum<["7d", "30d", "90d", "180d"]>>;
     }, "strip", z.ZodTypeAny, {
-        wallet: string;
         period: "7d" | "30d" | "90d" | "180d";
+        wallet: string;
     }, {
         wallet: string;
         period?: "7d" | "30d" | "90d" | "180d" | undefined;

package/dist/actions/kolTokenEntryOrder.d.ts

@@ -17,8 +17,8 @@ export declare const kolTokenEntryOrderAction: {
         mint: z.ZodString;
         limit: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        mint: string;
         limit: number;
+        mint: string;
     }, {
         mint: string;
         limit?: number | undefined;

package/dist/actions/kolTrendingTokens.d.ts

@@ -18,13 +18,13 @@ export declare const kolTrendingTokensAction: {
         min_kols: z.ZodDefault<z.ZodNumber>;
         limit: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        limit: number;
         period: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h";
         min_kols: number;
+        limit: number;
     }, {
-        limit?: number | undefined;
         period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | undefined;
         min_kols?: number | undefined;
+        limit?: number | undefined;
     }>;
     handler: (agent: unknown, input: {
         period?: string;

package/dist/actions/walletTracker.d.ts

@@ -158,8 +158,8 @@ export declare const walletTrackerSummaryAction: {
         period: "24h" | "7d" | "30d";
         wallet?: string | undefined;
     }, {
-        wallet?: string | undefined;
         period?: "24h" | "7d" | "30d" | undefined;
+        wallet?: string | undefined;
     }>;
     handler: (agent: unknown, input: {
         period?: string;

package/dist/index.d.ts

@@ -8,7 +8,7 @@ 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 } from "./tools/index.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";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -42,6 +42,11 @@ declare const MadeOnSolPlugin: {
         copyTradeUpdate: typeof copyTradeUpdate;
         copyTradeDelete: typeof copyTradeDelete;
         copyTradeSignals: typeof copyTradeSignals;
+        coordinationAlertsList: typeof coordinationAlertsList;
+        coordinationAlertsCreate: typeof coordinationAlertsCreate;
+        coordinationAlertsGet: typeof coordinationAlertsGet;
+        coordinationAlertsUpdate: typeof coordinationAlertsUpdate;
+        coordinationAlertsDelete: typeof coordinationAlertsDelete;
     };
     actions: ({
         name: string;
@@ -102,13 +107,13 @@ declare const MadeOnSolPlugin: {
             min_kols: import("zod").ZodDefault<import("zod").ZodNumber>;
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
-            limit: number;
             period: "24h" | "1h" | "6h" | "7d";
             min_kols: number;
+            limit: number;
         }, {
-            limit?: number | undefined;
             period?: "24h" | "1h" | "6h" | "7d" | undefined;
             min_kols?: number | undefined;
+            limit?: number | undefined;
         }>;
         handler: (agent: unknown, input: {
             period?: string;
@@ -141,11 +146,11 @@ declare const MadeOnSolPlugin: {
             period: import("zod").ZodDefault<import("zod").ZodEnum<["today", "7d", "30d"]>>;
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
-            limit: number;
             period: "7d" | "today" | "30d";
+            limit: number;
         }, {
-            limit?: number | undefined;
             period?: "7d" | "today" | "30d" | undefined;
+            limit?: number | undefined;
         }>;
         handler: (agent: unknown, input: {
             period?: string;
@@ -220,8 +225,8 @@ declare const MadeOnSolPlugin: {
             wallet: import("zod").ZodString;
             period: import("zod").ZodDefault<import("zod").ZodEnum<["7d", "30d", "90d", "180d"]>>;
         }, "strip", import("zod").ZodTypeAny, {
-            wallet: string;
             period: "7d" | "30d" | "90d" | "180d";
+            wallet: string;
         }, {
             wallet: string;
             period?: "7d" | "30d" | "90d" | "180d" | undefined;
@@ -257,13 +262,13 @@ declare const MadeOnSolPlugin: {
             min_kols: import("zod").ZodDefault<import("zod").ZodNumber>;
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
-            limit: number;
             period: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h";
             min_kols: number;
+            limit: number;
         }, {
-            limit?: number | undefined;
             period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | undefined;
             min_kols?: number | undefined;
+            limit?: number | undefined;
         }>;
         handler: (agent: unknown, input: {
             period?: string;
@@ -433,8 +438,8 @@ declare const MadeOnSolPlugin: {
             period: "24h" | "7d" | "30d";
             wallet?: string | undefined;
         }, {
-            wallet?: string | undefined;
             period?: "24h" | "7d" | "30d" | undefined;
+            wallet?: string | undefined;
         }>;
         handler: (agent: unknown, input: {
             period?: string;
@@ -466,8 +471,8 @@ declare const MadeOnSolPlugin: {
             mint: import("zod").ZodString;
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
         }, "strip", import("zod").ZodTypeAny, {
-            mint: string;
             limit: number;
+            mint: string;
         }, {
             mint: string;
             limit?: number | undefined;
@@ -563,6 +568,6 @@ declare const MadeOnSolPlugin: {
     initialize(_agent: unknown): void;
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, };
+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 { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/index.js

@@ -8,7 +8,7 @@ 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, } from "./tools/index.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";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -42,6 +42,11 @@ const MadeOnSolPlugin = {
         copyTradeUpdate,
         copyTradeDelete,
         copyTradeSignals,
+        coordinationAlertsList,
+        coordinationAlertsCreate,
+        coordinationAlertsGet,
+        coordinationAlertsUpdate,
+        coordinationAlertsDelete,
     },
     actions: [
         kolFeedAction,
@@ -64,6 +69,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, };
+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 { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/tools/index.d.ts

@@ -27,6 +27,14 @@ export declare function kolCoordination(agent: Agent, params?: {
     period?: string;
     min_kols?: number;
     limit?: number;
+    min_avg_winrate?: number;
+    unique_strategies?: number;
+    /** v1.1 — include WIF/BONK/POPCAT etc. Default false. */
+    include_majors?: boolean;
+    /** v1.1 — peak-density window in minutes (1-60, default 15). */
+    window_minutes?: number;
+    /** v1.1 — minimum composite coordination_score (0-100). */
+    min_score?: number;
 }): Promise<any>;
 export declare function kolLeaderboard(agent: Agent, params?: {
     period?: string;
@@ -150,6 +158,28 @@ export declare function copyTradeUpdate(agent: Agent, params: {
 export declare function copyTradeDelete(agent: Agent, params: {
     rule_id: string;
 }): Promise<any>;
+export declare function coordinationAlertsList(agent: Agent): Promise<any>;
+export declare function coordinationAlertsCreate(agent: Agent, params: {
+    name?: string;
+    min_kols?: number;
+    window_minutes?: number;
+    min_score?: number;
+    include_majors?: boolean;
+    cooldown_min?: number;
+    score_jump_break?: number;
+    delivery_mode?: "websocket" | "webhook" | "both";
+    webhook_url?: string;
+}): Promise<any>;
+export declare function coordinationAlertsGet(agent: Agent, params: {
+    rule_id: string;
+}): Promise<any>;
+export declare function coordinationAlertsUpdate(agent: Agent, params: {
+    rule_id: string;
+    updates: Record<string, unknown>;
+}): Promise<any>;
+export declare function coordinationAlertsDelete(agent: Agent, params: {
+    rule_id: string;
+}): Promise<any>;
 export declare function copyTradeSignals(agent: Agent, params?: {
     rule_id?: string;
     limit?: number;

package/dist/tools/index.js

@@ -50,7 +50,9 @@ export async function initAuth(agent) {
     else {
         _authMode = "none";
         _paidFetch = fetch;
-        console.warn("[madeonsol] No auth configured. Set MADEONSOL_API_KEY (free at madeonsol.com/developer) or SVM_PRIVATE_KEY.");
+        console.warn("\n[madeonsol] No auth configured — every API call will fail.\n" +
+            "  → Get a free MADEONSOL_API_KEY (200 req/day, no card) at https://madeonsol.com/developer\n" +
+            "  → Or set SVM_PRIVATE_KEY for x402 micropayments.\n");
     }
 }
 /** @deprecated Use initAuth instead */
@@ -85,7 +87,11 @@ export async function kolFeed(agent, params = {}) {
 }
 export async function kolCoordination(agent, params = {}) {
     await initAuth(agent);
-    return query("/api/x402/kol/coordination", params);
+    const { include_majors, ...rest } = params;
+    const flat = { ...rest };
+    if (include_majors !== undefined)
+        flat.include_majors = include_majors ? "true" : "false";
+    return query("/api/x402/kol/coordination", flat);
 }
 export async function kolLeaderboard(agent, params = {}) {
     await initAuth(agent);
@@ -243,6 +249,22 @@ export async function copyTradeUpdate(agent, params) {
 export async function copyTradeDelete(agent, params) {
     return restQuery(agent, "DELETE", `/copy-trade/rules/${encodeURIComponent(params.rule_id)}`);
 }
+// ── Coordination Alerts (PRO/ULTRA, v1.1) ──
+export async function coordinationAlertsList(agent) {
+    return restQuery(agent, "GET", "/kol/coordination/alerts");
+}
+export async function coordinationAlertsCreate(agent, params) {
+    return restQuery(agent, "POST", "/kol/coordination/alerts", params);
+}
+export async function coordinationAlertsGet(agent, params) {
+    return restQuery(agent, "GET", `/kol/coordination/alerts/${encodeURIComponent(params.rule_id)}`);
+}
+export async function coordinationAlertsUpdate(agent, params) {
+    return restQuery(agent, "PATCH", `/kol/coordination/alerts/${encodeURIComponent(params.rule_id)}`, params.updates);
+}
+export async function coordinationAlertsDelete(agent, params) {
+    return restQuery(agent, "DELETE", `/kol/coordination/alerts/${encodeURIComponent(params.rule_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.0.0",
+  "version": "1.1.0",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",
@@ -37,4 +37,4 @@
   "dependencies": {
     "zod": "^3.24.0"
   }
-}
+}