solana-agent-kit-plugin-madeonsol 0.3.3 → 0.5.0

package/README.md

@@ -54,8 +54,8 @@ const trades = await agent.methods.kolFeed(agent, { limit: 10, action: "buy" });
 |---|---|
 | `MADEONSOL_KOL_FEED_ACTION` | "kol trades", "what are kols buying" |
 | `MADEONSOL_KOL_COORDINATION_ACTION` | "kol convergence", "tokens kols accumulating" |
-| `MADEONSOL_KOL_LEADERBOARD_ACTION` | "top kols", "kol rankings", "best kol" |
-| `MADEONSOL_DEPLOYER_ALERTS_ACTION` | "deployer alerts", "pump fun launches" |
+| `MADEONSOL_KOL_LEADERBOARD_ACTION` | "top kols", "kol rankings", "best kol" — periods: today, 7d, 30d, 90d, 180d (180-day retention) |
+| `MADEONSOL_DEPLOYER_ALERTS_ACTION` | "deployer alerts", "pump fun launches" — PRO/ULTRA: filter by tier (elite/good/moderate/rising/cold) |
 | `MADEONSOL_TOKEN_INFO_ACTION` | "token info", "token price", "what is this token" |
 
 ## Also Available

package/dist/actions/deployerAlerts.d.ts

@@ -16,19 +16,23 @@ export declare const deployerAlertsAction: {
         limit: z.ZodDefault<z.ZodNumber>;
         offset: z.ZodDefault<z.ZodNumber>;
         since: z.ZodOptional<z.ZodString>;
+        tier: z.ZodOptional<z.ZodEnum<["elite", "good", "moderate", "rising", "cold"]>>;
     }, "strip", z.ZodTypeAny, {
         limit: number;
         offset: number;
         since?: string | undefined;
+        tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
     }, {
         limit?: number | undefined;
         offset?: number | undefined;
         since?: string | undefined;
+        tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
     }>;
     handler: (agent: unknown, input: {
         limit?: number;
         offset?: number;
         since?: string;
+        tier?: "elite" | "good" | "moderate" | "rising" | "cold";
     }) => Promise<{
         status: string;
         result: any;

package/dist/actions/deployerAlerts.js

@@ -11,6 +11,10 @@ export const deployerAlertsAction = {
         limit: z.number().min(1).max(100).default(10).describe("Number of alerts"),
         offset: z.number().min(0).default(0).describe("Pagination offset"),
         since: z.string().optional().describe("ISO8601 timestamp to filter alerts after"),
+        tier: z
+            .enum(["elite", "good", "moderate", "rising", "cold"])
+            .optional()
+            .describe("Filter by deployer tier. PRO/ULTRA subscribers only — BASIC callers receive 403."),
     }),
     handler: async (agent, input) => {
         try {

package/dist/actions/kolFeed.js

@@ -3,7 +3,7 @@ import { kolFeed } from "../tools/index.js";
 export const kolFeedAction = {
     name: "MADEONSOL_KOL_FEED_ACTION",
     similes: ["kol trades", "what are kols buying", "kol feed", "smart money trades", "kol activity"],
-    description: "Get real-time Solana KOL trades from 946 tracked wallets via MadeOnSol x402 API. Costs $0.005 USDC per request.",
+    description: "Get real-time Solana KOL trades from 1,000+ tracked wallets via MadeOnSol x402 API. Costs $0.005 USDC per request.",
     examples: [
         [{ input: { limit: 10, action: "buy" }, output: { status: "success" }, explanation: "Fetch the 10 most recent KOL buy trades" }],
     ],

package/dist/actions/kolPnl.d.ts

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

package/dist/actions/kolPnl.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { kolPnl } from "../tools/index.js";
+export const kolPnlAction = {
+    name: "MADEONSOL_KOL_PNL_ACTION",
+    similes: ["kol pnl", "kol profit", "kol performance", "wallet pnl", "kol win rate", "kol drawdown"],
+    description: "Get deep per-wallet PnL breakdown — realized PnL, win rate, profit factor, max drawdown, daily equity curve, and per-token positions via MadeOnSol API.",
+    examples: [
+        [{ input: { wallet: "ABC...xyz", period: "30d" }, output: { status: "success" }, explanation: "Get 30-day PnL breakdown for a KOL wallet" }],
+    ],
+    schema: z.object({
+        wallet: z.string().describe("KOL wallet address (base58)"),
+        period: z.enum(["7d", "30d", "90d", "180d"]).default("30d").describe("Time period"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolPnl(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolTrendingTokens.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const kolTrendingTokensAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            period: string;
+            min_kols: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        period: z.ZodDefault<z.ZodEnum<["5m", "15m", "30m", "1h", "2h", "4h", "12h"]>>;
+        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 | undefined;
+        period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | undefined;
+        min_kols?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        period?: string;
+        min_kols?: number;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolTrendingTokens.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { kolTrendingTokens } from "../tools/index.js";
+export const kolTrendingTokensAction = {
+    name: "MADEONSOL_KOL_TRENDING_TOKENS_ACTION",
+    similes: ["trending tokens", "kol volume", "what are kols buying now", "hot buys", "kol capital flow"],
+    description: "Get tokens ranked by KOL buy volume — pure capital-flow signal. Sub-hour periods (5m/15m/30m) require PRO/ULTRA. Costs $0.005 USDC per request.",
+    examples: [
+        [{ input: { period: "1h", min_kols: 2 }, output: { status: "success" }, explanation: "Get tokens with highest KOL buy volume in the last hour, with at least 2 KOLs buying" }],
+    ],
+    schema: z.object({
+        period: z.enum(["5m", "15m", "30m", "1h", "2h", "4h", "12h"]).default("1h").describe("Time window"),
+        min_kols: z.number().min(1).max(20).default(1).describe("Minimum KOL buyers"),
+        limit: z.number().min(1).max(50).default(20).describe("Number of tokens"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolTrendingTokens(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/index.d.ts

@@ -2,7 +2,9 @@ import { kolFeedAction } from "./actions/kolFeed.js";
 import { kolCoordinationAction } from "./actions/kolCoordination.js";
 import { kolLeaderboardAction } from "./actions/kolLeaderboard.js";
 import { deployerAlertsAction } from "./actions/deployerAlerts.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
+import { kolPnlAction } from "./actions/kolPnl.js";
+import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -10,6 +12,8 @@ declare const MadeOnSolPlugin: {
         kolCoordination: typeof kolCoordination;
         kolLeaderboard: typeof kolLeaderboard;
         deployerAlerts: typeof deployerAlerts;
+        kolPnl: typeof kolPnl;
+        kolTrendingTokens: typeof kolTrendingTokens;
         createWebhook: typeof createWebhook;
         listWebhooks: typeof listWebhooks;
         deleteWebhook: typeof deleteWebhook;
@@ -149,19 +153,99 @@ declare const MadeOnSolPlugin: {
             limit: import("zod").ZodDefault<import("zod").ZodNumber>;
             offset: import("zod").ZodDefault<import("zod").ZodNumber>;
             since: import("zod").ZodOptional<import("zod").ZodString>;
+            tier: import("zod").ZodOptional<import("zod").ZodEnum<["elite", "good", "moderate", "rising", "cold"]>>;
         }, "strip", import("zod").ZodTypeAny, {
             limit: number;
             offset: number;
             since?: string | undefined;
+            tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
         }, {
             limit?: number | undefined;
             offset?: number | undefined;
             since?: string | undefined;
+            tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
         }>;
         handler: (agent: unknown, input: {
             limit?: number;
             offset?: number;
             since?: string;
+            tier?: "elite" | "good" | "moderate" | "rising" | "cold";
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                wallet: string;
+                period: string;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            wallet: import("zod").ZodString;
+            period: import("zod").ZodDefault<import("zod").ZodEnum<["7d", "30d", "90d", "180d"]>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            period: "7d" | "30d" | "90d" | "180d";
+            wallet: string;
+        }, {
+            wallet: string;
+            period?: "7d" | "30d" | "90d" | "180d" | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            wallet: string;
+            period?: string;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                period: string;
+                min_kols: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            period: import("zod").ZodDefault<import("zod").ZodEnum<["5m", "15m", "30m", "1h", "2h", "4h", "12h"]>>;
+            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 | undefined;
+            period?: "1h" | "5m" | "15m" | "30m" | "2h" | "4h" | "12h" | undefined;
+            min_kols?: number | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            period?: string;
+            min_kols?: number;
+            limit?: number;
         }) => Promise<{
             status: string;
             result: any;
@@ -175,5 +259,5 @@ declare const MadeOnSolPlugin: {
     initialize(_agent: unknown): void;
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };

package/dist/index.js

@@ -2,7 +2,9 @@ import { kolFeedAction } from "./actions/kolFeed.js";
 import { kolCoordinationAction } from "./actions/kolCoordination.js";
 import { kolLeaderboardAction } from "./actions/kolLeaderboard.js";
 import { deployerAlertsAction } from "./actions/deployerAlerts.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
+import { kolPnlAction } from "./actions/kolPnl.js";
+import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken } from "./tools/index.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -10,6 +12,8 @@ const MadeOnSolPlugin = {
         kolCoordination,
         kolLeaderboard,
         deployerAlerts,
+        kolPnl,
+        kolTrendingTokens,
         createWebhook,
         listWebhooks,
         deleteWebhook,
@@ -21,11 +25,13 @@ const MadeOnSolPlugin = {
         kolCoordinationAction,
         kolLeaderboardAction,
         deployerAlertsAction,
+        kolPnlAction,
+        kolTrendingTokensAction,
     ],
     initialize(_agent) {
         // No-op — payment setup is lazy in tool functions
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken };
+export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };

package/dist/tools/index.d.ts

@@ -21,10 +21,16 @@ export declare function kolLeaderboard(agent: Agent, params?: {
     period?: string;
     limit?: number;
 }): Promise<any>;
+/**
+ * Get Pump.fun deployer alerts with KOL buy enrichment.
+ * The `tier` filter (elite/good/moderate/rising/cold) is PRO/ULTRA only —
+ * BASIC callers passing it receive HTTP 403.
+ */
 export declare function deployerAlerts(agent: Agent, params?: {
     limit?: number;
     since?: string;
     offset?: number;
+    tier?: "elite" | "good" | "moderate" | "rising" | "cold";
 }): Promise<any>;
 export declare function kolPairs(agent: Agent, params?: {
     period?: string;
@@ -36,6 +42,15 @@ export declare function kolHotTokens(agent: Agent, params?: {
     min_kols?: number;
     limit?: number;
 }): Promise<any>;
+export declare function kolTrendingTokens(agent: Agent, params?: {
+    period?: string;
+    min_kols?: number;
+    limit?: number;
+}): Promise<any>;
+export declare function kolPnl(agent: Agent, params: {
+    wallet: string;
+    period?: string;
+}): Promise<any>;
 export declare function kolTiming(agent: Agent, params: {
     wallet: string;
     period?: string;

package/dist/tools/index.js

@@ -85,6 +85,11 @@ export async function kolLeaderboard(agent, params = {}) {
     await initAuth(agent);
     return query("/api/x402/kol/leaderboard", params);
 }
+/**
+ * Get Pump.fun deployer alerts with KOL buy enrichment.
+ * The `tier` filter (elite/good/moderate/rising/cold) is PRO/ULTRA only —
+ * BASIC callers passing it receive HTTP 403.
+ */
 export async function deployerAlerts(agent, params = {}) {
     await initAuth(agent);
     return query("/api/x402/deployer-hunter/alerts", params);
@@ -97,6 +102,14 @@ export async function kolHotTokens(agent, params = {}) {
     await initAuth(agent);
     return query("/api/x402/kol/tokens/hot", params);
 }
+export async function kolTrendingTokens(agent, params = {}) {
+    await initAuth(agent);
+    return query("/api/x402/kol/tokens/trending", params);
+}
+export async function kolPnl(agent, params) {
+    const qs = params.period ? `?period=${params.period}` : "";
+    return restQuery(agent, "GET", `/kol/${params.wallet}/pnl${qs}`);
+}
 export async function kolTiming(agent, params) {
     const qs = params.period ? `?period=${params.period}` : "";
     return restQuery(agent, "GET", `/kol/${params.wallet}/timing${qs}`);

package/package.json

@@ -1,40 +1,40 @@
-{
-  "name": "solana-agent-kit-plugin-madeonsol",
-  "version": "0.3.3",
-  "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": ""
-  },
-  "keywords": [
-    "solana",
-    "agent-kit",
-    "x402",
-    "kol",
-    "trading",
-    "madeonsol"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/LamboPoewert/solana-agent-kit-plugin-madeonsol"
-  },
-  "peerDependencies": {
-    "solana-agent-kit": ">=2.0.0",
-    "@x402/fetch": ">=0.1.0",
-    "@x402/core": ">=0.1.0",
-    "@x402/svm": ">=0.1.0",
-    "@solana/kit": ">=2.0.0",
-    "@scure/base": ">=1.0.0"
-  },
-  "dependencies": {
-    "zod": "^3.24.0"
-  }
-}
+{
+  "name": "solana-agent-kit-plugin-madeonsol",
+  "version": "0.5.0",
+  "description": "Solana Agent Kit plugin for MadeOnSol \u00e2\u20ac\u201d KOL intelligence and deployer analytics via x402 micropayments",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": ""
+  },
+  "keywords": [
+    "solana",
+    "agent-kit",
+    "x402",
+    "kol",
+    "trading",
+    "madeonsol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LamboPoewert/solana-agent-kit-plugin-madeonsol"
+  },
+  "peerDependencies": {
+    "solana-agent-kit": ">=2.0.0",
+    "@x402/fetch": ">=0.1.0",
+    "@x402/core": ">=0.1.0",
+    "@x402/svm": ">=0.1.0",
+    "@solana/kit": ">=2.0.0",
+    "@scure/base": ">=1.0.0"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  }
+}