solana-agent-kit-plugin-madeonsol 0.7.0 → 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/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 } 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 } from "./tools/index.js";
 declare const MadeOnSolPlugin: {
     name: string;
     methods: {
@@ -31,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;
@@ -173,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: {
@@ -552,6 +563,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 };
+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

@@ -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 } 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, } from "./tools/index.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
     methods: {
@@ -31,6 +31,17 @@ const MadeOnSolPlugin = {
         walletTrackerRemove,
         walletTrackerTrades,
         walletTrackerSummary,
+        alphaLeaderboard,
+        alphaWallet,
+        alphaLinked,
+        tokenCapTable,
+        tokenBuyerQuality,
+        copyTradeList,
+        copyTradeCreate,
+        copyTradeGet,
+        copyTradeUpdate,
+        copyTradeDelete,
+        copyTradeSignals,
     },
     actions: [
         kolFeedAction,
@@ -53,6 +64,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 };
+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>;
@@ -103,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}`);
@@ -134,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,
@@ -148,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}`);
@@ -180,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));
+            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}`);
-    }
-    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.7.0",
+  "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",