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

package/README.md

@@ -13,6 +13,8 @@ Two options (in priority order):
 | **MadeOnSol API key** (recommended) | `MADEONSOL_API_KEY` | Developers — [get a free key](https://madeonsol.com/developer) |
 | x402 micropayments | `SVM_PRIVATE_KEY` | AI agents with Solana wallets |
 
+> **v1.0 breaking change:** RapidAPI auth (`RAPIDAPI_KEY`) has been removed. The MadeOnSol RapidAPI marketplace was retired on 2026-04-19. Get a free `msk_` key at [madeonsol.com/developer](https://madeonsol.com/developer).
+
 ## Install
 
 ```bash
@@ -61,6 +63,52 @@ const events = await agent.methods.walletTrackerTrades(agent, { limit: 50 });
 | `MADEONSOL_WALLET_TRACKER_TRADES_ACTION` | "wallet tracker trades", "watchlist activity" |
 | `MADEONSOL_WALLET_TRACKER_SUMMARY_ACTION` | "wallet tracker summary", "tracked wallet stats" |
 
+## Additional methods (v1.0+)
+
+These are exposed via `agent.methods.*` (no LLM action wrappers — call directly):
+
+### Alpha Wallet Intelligence
+
+Scored from 47,000+ early-buyer records (wallets seen in the first 20 buyers of Pump.fun tokens).
+
+```ts
+await agent.methods.alphaLeaderboard(agent, { limit: 100 });            // BASIC=25, PRO=100, ULTRA=500
+await agent.methods.alphaWallet(agent, { wallet: "WALLET" });           // ULTRA only — full breakdown + bot signals
+await agent.methods.alphaLinked(agent, { wallet: "WALLET" });           // ULTRA only — co-bought 3+ tokens within 2s
+```
+
+### Token Quality
+
+```ts
+await agent.methods.tokenCapTable(agent, { mint: "MINT" });             // PRO=10, ULTRA=20 first non-deployer buyers
+await agent.methods.tokenBuyerQuality(agent, { mint: "MINT" });         // 0–100 buyer-quality score (5-min cached)
+```
+
+### Copy-Trade Rules (PRO/ULTRA)
+
+Server-side rules that fire signals when a watched source wallet trades. Delivered via webhook (HMAC-signed) and/or WebSocket.
+
+```ts
+await agent.methods.copyTradeList(agent);
+await agent.methods.copyTradeCreate(agent, {
+  name: "Track Whale",
+  source_wallet: "WALLET",
+  delivery: "webhook",
+  webhook_url: "https://you.com/hook",
+});
+await agent.methods.copyTradeSignals(agent, { limit: 50 });             // up to 7 days
+```
+
+### Rate-limit headers
+
+Every successful request populates a module-level `lastRateLimit` (limit / remaining / reset / requestId):
+
+```ts
+import { lastRateLimit } from "solana-agent-kit-plugin-madeonsol";
+await agent.methods.kolFeed(agent, { limit: 10 });
+console.log(lastRateLimit); // { limit: "10000", remaining: "9999", reset: "...", requestId: "..." }
+```
+
 ## Tiers
 
 | Tier | Price | Wallets tracked | Requests/day |

package/dist/actions/deployerAlerts.d.ts

@@ -24,8 +24,8 @@ export declare const deployerAlertsAction: {
         tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
     }, {
         limit?: number | undefined;
-        offset?: number | undefined;
         since?: string | undefined;
+        offset?: number | undefined;
         tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/actions/kolAlertsRecent.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const kolAlertsRecentAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            window: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        window: z.ZodDefault<z.ZodEnum<["5m", "15m", "1h", "6h", "24h"]>>;
+        types: z.ZodOptional<z.ZodArray<z.ZodEnum<["consensus_cluster", "fresh_token_kol_buy", "heating_up"]>, "many">>;
+        min_severity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        window: "24h" | "1h" | "6h" | "5m" | "15m";
+        types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
+        min_severity?: "low" | "medium" | "high" | 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;
+    }>;
+    handler: (agent: unknown, input: {
+        window?: string;
+        types?: string[];
+        min_severity?: string;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolAlertsRecent.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { kolAlertsRecent } from "../tools/index.js";
+export const kolAlertsRecentAction = {
+    name: "MADEONSOL_KOL_ALERTS_RECENT_ACTION",
+    similes: ["kol alerts", "recent kol alerts", "kol signals", "live kol feed", "kol events"],
+    description: "Live KOL alert feed from MadeOnSol — consensus clusters, fresh-token KOL buys, and heating-up wallets unified into one stream. Sorted by detected_at DESC then severity.",
+    examples: [
+        [
+            { input: { window: "15m", limit: 20 }, output: { status: "success" }, explanation: "Show recent KOL alerts in the last 15 minutes" },
+        ],
+    ],
+    schema: z.object({
+        window: z.enum(["5m", "15m", "1h", "6h", "24h"]).default("15m").describe("Lookback window"),
+        types: z.array(z.enum(["consensus_cluster", "fresh_token_kol_buy", "heating_up"])).optional().describe("Filter to specific alert types"),
+        min_severity: z.enum(["low", "medium", "high"]).optional().describe("Minimum severity to include"),
+        limit: z.number().min(1).max(200).default(50).describe("Max alerts"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolAlertsRecent(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolCompare.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const kolCompareAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            wallets: string[];
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        wallets: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        wallets: string[];
+    }, {
+        wallets: string[];
+    }>;
+    handler: (agent: unknown, input: {
+        wallets: string[];
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolCompare.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { kolCompare } from "../tools/index.js";
+export const kolCompareAction = {
+    name: "MADEONSOL_KOL_COMPARE_ACTION",
+    similes: ["compare kols", "compare wallets", "kol comparison", "side by side kols"],
+    description: "Side-by-side comparison of 2-5 Solana KOL wallets on MadeOnSol — strategy, winrates, ROI, PnL percentiles. PRO+ adds overlap tokens (bought by 2+ in last 30d). BASIC=2, PRO=4, ULTRA=5.",
+    examples: [
+        [
+            { input: { wallets: ["WalletA", "WalletB"] }, output: { status: "success" }, explanation: "Compare two KOL wallets side-by-side" },
+        ],
+    ],
+    schema: z.object({
+        wallets: z.array(z.string()).min(2).max(5).describe("2-5 wallet addresses"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolCompare(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/kolFeed.d.ts

@@ -22,8 +22,8 @@ export declare const kolFeedAction: {
         action?: "buy" | "sell" | undefined;
         kol?: string | undefined;
     }, {
-        action?: "buy" | "sell" | undefined;
         limit?: number | undefined;
+        action?: "buy" | "sell" | undefined;
         kol?: string | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/actions/kolTokenEntryOrder.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export declare const kolTokenEntryOrderAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            mint: string;
+            limit: number;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        mint: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        mint: string;
+        limit: number;
+    }, {
+        mint: string;
+        limit?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        mint: string;
+        limit?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/kolTokenEntryOrder.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { kolTokenEntryOrder } from "../tools/index.js";
+export const kolTokenEntryOrderAction = {
+    name: "MADEONSOL_KOL_TOKEN_ENTRY_ORDER_ACTION",
+    similes: ["who bought first", "first kol buyers", "kol entry order", "token entry ranking"],
+    description: "Get the ranked order of KOL first-buyers for a specific Solana token. Each entry includes seconds_after_first relative to the first KOL entry. PRO+ adds percentile_pnl_7d per entry.",
+    examples: [
+        [{ input: { mint: "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU", limit: 20 }, output: { status: "success" }, explanation: "Who were the first 20 KOLs to buy this token?" }],
+    ],
+    schema: z.object({
+        mint: z.string().describe("Token mint address (base58)"),
+        limit: z.number().min(1).max(200).default(50).describe("Max ranked entries"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await kolTokenEntryOrder(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};

package/dist/actions/walletTracker.d.ts

@@ -116,10 +116,10 @@ export declare const walletTrackerTradesAction: {
         event_type?: "swap" | "transfer" | undefined;
         before?: number | undefined;
     }, {
+        limit?: number | undefined;
         wallet?: string | undefined;
         action?: "buy" | "sell" | "transfer_in" | "transfer_out" | undefined;
         event_type?: "swap" | "transfer" | undefined;
-        limit?: number | undefined;
         before?: number | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/index.d.ts

@@ -5,7 +5,10 @@ import { deployerAlertsAction } from "./actions/deployerAlerts.js";
 import { kolPnlAction } from "./actions/kolPnl.js";
 import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
 import { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction } from "./actions/walletTracker.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "./tools/index.js";
+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";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -15,6 +18,9 @@ declare const MadeOnSolPlugin: {
         deployerAlerts: typeof deployerAlerts;
         kolPnl: typeof kolPnl;
         kolTrendingTokens: typeof kolTrendingTokens;
+        kolTokenEntryOrder: typeof kolTokenEntryOrder;
+        kolCompare: typeof kolCompare;
+        kolAlertsRecent: typeof kolAlertsRecent;
         createWebhook: typeof createWebhook;
         listWebhooks: typeof listWebhooks;
         deleteWebhook: typeof deleteWebhook;
@@ -25,6 +31,17 @@ declare const MadeOnSolPlugin: {
         walletTrackerRemove: typeof walletTrackerRemove;
         walletTrackerTrades: typeof walletTrackerTrades;
         walletTrackerSummary: typeof walletTrackerSummary;
+        alphaLeaderboard: typeof alphaLeaderboard;
+        alphaWallet: typeof alphaWallet;
+        alphaLinked: typeof alphaLinked;
+        tokenCapTable: typeof tokenCapTable;
+        tokenBuyerQuality: typeof tokenBuyerQuality;
+        copyTradeList: typeof copyTradeList;
+        copyTradeCreate: typeof copyTradeCreate;
+        copyTradeGet: typeof copyTradeGet;
+        copyTradeUpdate: typeof copyTradeUpdate;
+        copyTradeDelete: typeof copyTradeDelete;
+        copyTradeSignals: typeof copyTradeSignals;
     };
     actions: ({
         name: string;
@@ -49,8 +66,8 @@ declare const MadeOnSolPlugin: {
             action?: "buy" | "sell" | undefined;
             kol?: string | undefined;
         }, {
-            action?: "buy" | "sell" | undefined;
             limit?: number | undefined;
+            action?: "buy" | "sell" | undefined;
             kol?: string | undefined;
         }>;
         handler: (agent: unknown, input: {
@@ -167,8 +184,8 @@ declare const MadeOnSolPlugin: {
             tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
         }, {
             limit?: number | undefined;
-            offset?: number | undefined;
             since?: string | undefined;
+            offset?: number | undefined;
             tier?: "elite" | "good" | "moderate" | "rising" | "cold" | undefined;
         }>;
         handler: (agent: unknown, input: {
@@ -375,10 +392,10 @@ declare const MadeOnSolPlugin: {
             event_type?: "swap" | "transfer" | undefined;
             before?: number | undefined;
         }, {
+            limit?: number | undefined;
             wallet?: string | undefined;
             action?: "buy" | "sell" | "transfer_in" | "transfer_out" | undefined;
             event_type?: "swap" | "transfer" | undefined;
-            limit?: number | undefined;
             before?: number | undefined;
         }>;
         handler: (agent: unknown, input: {
@@ -431,10 +448,121 @@ declare const MadeOnSolPlugin: {
             message: string;
             result?: undefined;
         }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                mint: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            mint: import("zod").ZodString;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            mint: string;
+            limit: number;
+        }, {
+            mint: string;
+            limit?: number | undefined;
+        }>;
+        handler: (agent: unknown, input: {
+            mint: string;
+            limit?: number;
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                wallets: string[];
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            wallets: import("zod").ZodArray<import("zod").ZodString, "many">;
+        }, "strip", import("zod").ZodTypeAny, {
+            wallets: string[];
+        }, {
+            wallets: string[];
+        }>;
+        handler: (agent: unknown, input: {
+            wallets: string[];
+        }) => Promise<{
+            status: string;
+            result: any;
+            message?: undefined;
+        } | {
+            status: string;
+            message: string;
+            result?: undefined;
+        }>;
+    } | {
+        name: string;
+        similes: string[];
+        description: string;
+        examples: {
+            input: {
+                window: string;
+                limit: number;
+            };
+            output: {
+                status: string;
+            };
+            explanation: string;
+        }[][];
+        schema: import("zod").ZodObject<{
+            window: import("zod").ZodDefault<import("zod").ZodEnum<["5m", "15m", "1h", "6h", "24h"]>>;
+            types: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<["consensus_cluster", "fresh_token_kol_buy", "heating_up"]>, "many">>;
+            min_severity: import("zod").ZodOptional<import("zod").ZodEnum<["low", "medium", "high"]>>;
+            limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        }, "strip", import("zod").ZodTypeAny, {
+            limit: number;
+            window: "24h" | "1h" | "6h" | "5m" | "15m";
+            types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
+            min_severity?: "low" | "medium" | "high" | 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;
+        }>;
+        handler: (agent: unknown, input: {
+            window?: string;
+            types?: string[];
+            min_severity?: string;
+            limit?: number;
+        }) => 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, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };
+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 { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/index.js

@@ -5,7 +5,10 @@ import { deployerAlertsAction } from "./actions/deployerAlerts.js";
 import { kolPnlAction } from "./actions/kolPnl.js";
 import { kolTrendingTokensAction } from "./actions/kolTrendingTokens.js";
 import { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction } from "./actions/walletTracker.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary } from "./tools/index.js";
+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";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -15,6 +18,9 @@ const MadeOnSolPlugin = {
         deployerAlerts,
         kolPnl,
         kolTrendingTokens,
+        kolTokenEntryOrder,
+        kolCompare,
+        kolAlertsRecent,
         createWebhook,
         listWebhooks,
         deleteWebhook,
@@ -25,6 +31,17 @@ const MadeOnSolPlugin = {
         walletTrackerRemove,
         walletTrackerTrades,
         walletTrackerSummary,
+        alphaLeaderboard,
+        alphaWallet,
+        alphaLinked,
+        tokenCapTable,
+        tokenBuyerQuality,
+        copyTradeList,
+        copyTradeCreate,
+        copyTradeGet,
+        copyTradeUpdate,
+        copyTradeDelete,
+        copyTradeSignals,
     },
     actions: [
         kolFeedAction,
@@ -33,6 +50,9 @@ const MadeOnSolPlugin = {
         deployerAlertsAction,
         kolPnlAction,
         kolTrendingTokensAction,
+        kolTokenEntryOrderAction,
+        kolCompareAction,
+        kolAlertsRecentAction,
         walletTrackerWatchlistAction,
         walletTrackerAddAction,
         walletTrackerRemoveAction,
@@ -44,6 +64,6 @@ const MadeOnSolPlugin = {
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary };
-export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction };
+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 { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };

package/dist/tools/index.d.ts

@@ -1,9 +1,20 @@
 /**
  * Tool functions — pure logic that calls MadeOnSol API.
- * Auth priority: MADEONSOL_API_KEY > RAPIDAPI_KEY > SVM_PRIVATE_KEY (x402).
- * These are called by Action handlers and can also be used directly via agent.methods.
+ * Auth priority: MADEONSOL_API_KEY > SVM_PRIVATE_KEY (x402).
+ *
+ * v1.0 breaking change: RAPIDAPI_KEY support has been removed
+ * (MadeOnSol RapidAPI marketplace was retired 2026-04-19).
+ * Get a free `msk_` key at https://madeonsol.com/developer.
  */
 type Agent = any;
+export interface RateLimitInfo {
+    limit?: string;
+    remaining?: string;
+    reset?: string;
+    requestId?: string;
+}
+/** Most recent rate-limit headers, populated by every successful API request. */
+export declare let lastRateLimit: RateLimitInfo;
 export declare function initAuth(agent: Agent): Promise<void>;
 /** @deprecated Use initAuth instead */
 export declare function initPaidFetch(agent: Agent): Promise<typeof fetch>;
@@ -47,6 +58,19 @@ export declare function kolTrendingTokens(agent: Agent, params?: {
     min_kols?: number;
     limit?: number;
 }): Promise<any>;
+export declare function kolTokenEntryOrder(agent: Agent, params: {
+    mint: string;
+    limit?: number;
+}): Promise<any>;
+export declare function kolCompare(agent: Agent, params: {
+    wallets: string[];
+}): Promise<any>;
+export declare function kolAlertsRecent(agent: Agent, params?: {
+    window?: string;
+    types?: string[];
+    min_severity?: string;
+    limit?: number;
+}): Promise<any>;
 export declare function kolPnl(agent: Agent, params: {
     wallet: string;
     period?: string;
@@ -90,4 +114,45 @@ export declare function walletTrackerSummary(agent: Agent, params?: {
     period?: string;
     wallet?: string;
 }): Promise<any>;
+export declare function alphaLeaderboard(agent: Agent, params?: {
+    limit?: number;
+    min_tokens?: number;
+    min_pnl?: number;
+}): Promise<any>;
+export declare function alphaWallet(agent: Agent, params: {
+    wallet: string;
+}): Promise<any>;
+export declare function alphaLinked(agent: Agent, params: {
+    wallet: string;
+}): Promise<any>;
+export declare function tokenCapTable(agent: Agent, params: {
+    mint: string;
+}): Promise<any>;
+export declare function tokenBuyerQuality(agent: Agent, params: {
+    mint: string;
+}): Promise<any>;
+export declare function copyTradeList(agent: Agent): Promise<any>;
+export declare function copyTradeCreate(agent: Agent, params: {
+    name: string;
+    source_wallet: string;
+    is_active?: boolean;
+    webhook_url?: string;
+    delivery?: "webhook" | "websocket" | "both";
+    filters?: Record<string, unknown>;
+}): Promise<any>;
+export declare function copyTradeGet(agent: Agent, params: {
+    rule_id: string;
+}): Promise<any>;
+export declare function copyTradeUpdate(agent: Agent, params: {
+    rule_id: string;
+    updates: Record<string, unknown>;
+}): Promise<any>;
+export declare function copyTradeDelete(agent: Agent, params: {
+    rule_id: string;
+}): Promise<any>;
+export declare function copyTradeSignals(agent: Agent, params?: {
+    rule_id?: string;
+    limit?: number;
+    since?: string;
+}): Promise<any>;
 export {};

package/dist/tools/index.js

@@ -1,13 +1,25 @@
 /**
  * Tool functions — pure logic that calls MadeOnSol API.
- * Auth priority: MADEONSOL_API_KEY > RAPIDAPI_KEY > SVM_PRIVATE_KEY (x402).
- * These are called by Action handlers and can also be used directly via agent.methods.
+ * Auth priority: MADEONSOL_API_KEY > SVM_PRIVATE_KEY (x402).
+ *
+ * v1.0 breaking change: RAPIDAPI_KEY support has been removed
+ * (MadeOnSol RapidAPI marketplace was retired 2026-04-19).
+ * Get a free `msk_` key at https://madeonsol.com/developer.
  */
 const BASE_URL = "https://madeonsol.com";
-const RAPIDAPI_HOST = "madeonsol-solana-kol-tracker-tools-api.p.rapidapi.com";
 let _authMode = null;
 let _authHeaders = {};
 let _paidFetch = null;
+/** Most recent rate-limit headers, populated by every successful API request. */
+export let lastRateLimit = {};
+function captureRateLimit(res) {
+    lastRateLimit = {
+        limit: res.headers.get("X-RateLimit-Limit") ?? undefined,
+        remaining: res.headers.get("X-RateLimit-Remaining") ?? undefined,
+        reset: res.headers.get("X-RateLimit-Reset") ?? undefined,
+        requestId: res.headers.get("X-Request-Id") ?? undefined,
+    };
+}
 function getConfig(agent, key) {
     return agent.config?.[key] || agent.config?.OTHER_API_KEYS?.[key];
 }
@@ -15,7 +27,6 @@ export async function initAuth(agent) {
     if (_authMode)
         return;
     const apiKey = getConfig(agent, "MADEONSOL_API_KEY");
-    const rapidApiKey = getConfig(agent, "RAPIDAPI_KEY");
     const privateKey = getConfig(agent, "SVM_PRIVATE_KEY");
     if (apiKey) {
         _authMode = "madeonsol";
@@ -23,12 +34,6 @@ export async function initAuth(agent) {
         _paidFetch = fetch;
         console.log("[madeonsol] Using MadeOnSol API key (Bearer auth)");
     }
-    else if (rapidApiKey) {
-        _authMode = "rapidapi";
-        _authHeaders = { "x-rapidapi-key": rapidApiKey, "x-rapidapi-host": RAPIDAPI_HOST };
-        _paidFetch = fetch;
-        console.log("[madeonsol] Using RapidAPI key");
-    }
     else if (privateKey) {
         const { wrapFetchWithPayment } = await import("@x402/fetch");
         const { x402Client } = await import("@x402/core/client");
@@ -45,7 +50,7 @@ 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), RAPIDAPI_KEY, or SVM_PRIVATE_KEY.");
+        console.warn("[madeonsol] No auth configured. Set MADEONSOL_API_KEY (free at madeonsol.com/developer) or SVM_PRIVATE_KEY.");
     }
 }
 /** @deprecated Use initAuth instead */
@@ -67,6 +72,7 @@ async function query(path, params) {
     const res = _authMode === "x402"
         ? await _paidFetch(url.toString())
         : await fetch(url.toString(), { headers: _authHeaders });
+    captureRateLimit(res);
     if (!res.ok) {
         const body = await res.text().catch(() => "");
         throw new Error(`MadeOnSol API error ${res.status}: ${body}`);
@@ -106,6 +112,23 @@ export async function kolTrendingTokens(agent, params = {}) {
     await initAuth(agent);
     return query("/api/x402/kol/tokens/trending", params);
 }
+export async function kolTokenEntryOrder(agent, params) {
+    await initAuth(agent);
+    const { mint, ...rest } = params;
+    return query(`/api/x402/kol/tokens/${encodeURIComponent(mint)}/entry-order`, rest);
+}
+export async function kolCompare(agent, params) {
+    await initAuth(agent);
+    return query("/api/x402/kol/compare", { wallets: params.wallets.join(",") });
+}
+export async function kolAlertsRecent(agent, params = {}) {
+    await initAuth(agent);
+    const { types, ...rest } = params;
+    const flat = { ...rest };
+    if (types && types.length > 0)
+        flat.types = types.join(",");
+    return query("/api/x402/kol/alerts/recent", flat);
+}
 export async function kolPnl(agent, params) {
     const qs = params.period ? `?period=${params.period}` : "";
     return restQuery(agent, "GET", `/kol/${params.wallet}/pnl${qs}`);
@@ -117,11 +140,11 @@ export async function kolTiming(agent, params) {
 export async function deployerTrajectory(agent, params) {
     return restQuery(agent, "GET", `/deployer-hunter/${params.wallet}/trajectory`);
 }
-// ── Webhook & Streaming (requires API key or RapidAPI key) ──
+// ── REST helper (webhooks, streaming, alpha, copy-trade, wallet-tracker) ──
 async function restQuery(agent, method, path, body) {
     await initAuth(agent);
-    if (_authMode !== "madeonsol" && _authMode !== "rapidapi") {
-        throw new Error("API key or RapidAPI key required for webhook/streaming features. Get a free key at madeonsol.com/developer");
+    if (_authMode !== "madeonsol") {
+        throw new Error("MadeOnSol API key required for this endpoint. Get a free `msk_` key at madeonsol.com/developer");
     }
     const res = await fetch(`${BASE_URL}/api/v1${path}`, {
         method,
@@ -131,6 +154,7 @@ async function restQuery(agent, method, path, body) {
         },
         ...(body ? { body: JSON.stringify(body) } : {}),
     });
+    captureRateLimit(res);
     if (!res.ok) {
         const text = await res.text().catch(() => "");
         throw new Error(`MadeOnSol API error ${res.status}: ${text}`);
@@ -163,30 +187,68 @@ export async function walletTrackerRemove(agent, params) {
     return restQuery(agent, "DELETE", `/wallet-tracker/watchlist/${encodeURIComponent(params.wallet_address)}`);
 }
 export async function walletTrackerTrades(agent, params = {}) {
-    await initAuth(agent);
-    const url = new URL(`${BASE_URL}/api/v1/wallet-tracker/trades`);
+    const qs = new URLSearchParams();
     for (const [k, v] of Object.entries(params)) {
         if (v !== undefined)
-            url.searchParams.set(k, String(v));
-    }
-    const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ..._authHeaders } });
-    if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        throw new Error(`MadeOnSol API error ${res.status}: ${text}`);
+            qs.set(k, String(v));
     }
-    return res.json();
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/wallet-tracker/trades${query}`);
 }
 export async function walletTrackerSummary(agent, params = {}) {
-    await initAuth(agent);
-    const url = new URL(`${BASE_URL}/api/v1/wallet-tracker/summary`);
+    const qs = new URLSearchParams();
+    if (params.period)
+        qs.set("period", params.period);
+    if (params.wallet)
+        qs.set("wallet", params.wallet);
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/wallet-tracker/summary${query}`);
+}
+// ── Alpha Wallet Intelligence ──
+export async function alphaLeaderboard(agent, params = {}) {
+    const qs = new URLSearchParams();
     for (const [k, v] of Object.entries(params)) {
         if (v !== undefined)
-            url.searchParams.set(k, v);
+            qs.set(k, String(v));
     }
-    const res = await fetch(url.toString(), { headers: { "Content-Type": "application/json", ..._authHeaders } });
-    if (!res.ok) {
-        const text = await res.text().catch(() => "");
-        throw new Error(`MadeOnSol API error ${res.status}: ${text}`);
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/alpha/leaderboard${query}`);
+}
+export async function alphaWallet(agent, params) {
+    return restQuery(agent, "GET", `/alpha/wallet/${encodeURIComponent(params.wallet)}`);
+}
+export async function alphaLinked(agent, params) {
+    return restQuery(agent, "GET", `/alpha/wallet/${encodeURIComponent(params.wallet)}/linked`);
+}
+// ── Token Quality ──
+export async function tokenCapTable(agent, params) {
+    return restQuery(agent, "GET", `/token/${encodeURIComponent(params.mint)}/cap-table`);
+}
+export async function tokenBuyerQuality(agent, params) {
+    return restQuery(agent, "GET", `/token/${encodeURIComponent(params.mint)}/buyer-quality`);
+}
+// ── Copy-Trade Rules (PRO/ULTRA) ──
+export async function copyTradeList(agent) {
+    return restQuery(agent, "GET", "/copy-trade/rules");
+}
+export async function copyTradeCreate(agent, params) {
+    return restQuery(agent, "POST", "/copy-trade/rules", params);
+}
+export async function copyTradeGet(agent, params) {
+    return restQuery(agent, "GET", `/copy-trade/rules/${encodeURIComponent(params.rule_id)}`);
+}
+export async function copyTradeUpdate(agent, params) {
+    return restQuery(agent, "PATCH", `/copy-trade/rules/${encodeURIComponent(params.rule_id)}`, params.updates);
+}
+export async function copyTradeDelete(agent, params) {
+    return restQuery(agent, "DELETE", `/copy-trade/rules/${encodeURIComponent(params.rule_id)}`);
+}
+export async function copyTradeSignals(agent, params = {}) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            qs.set(k, String(v));
     }
-    return res.json();
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/copy-trade/signals${query}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-agent-kit-plugin-madeonsol",
-  "version": "0.6.1",
+  "version": "1.0.0",
   "description": "Solana Agent Kit plugin for MadeOnSol — KOL intelligence and deployer analytics via x402 micropayments",
   "type": "module",
   "main": "dist/index.js",