solana-agent-kit-plugin-madeonsol 1.7.2 → 1.8.0

package/README.md

@@ -1,5 +1,12 @@
 # solana-agent-kit-plugin-madeonsol
 
+[![npm version](https://img.shields.io/npm/v/solana-agent-kit-plugin-madeonsol?style=flat-square)](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol)
+[![npm downloads](https://img.shields.io/npm/dm/solana-agent-kit-plugin-madeonsol?style=flat-square)](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol)
+[![SAK](https://img.shields.io/badge/Solana%20Agent%20Kit-plugin-blueviolet?style=flat-square)](https://github.com/sendaifun/solana-agent-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
+
+> 📚 **[API docs](https://madeonsol.com/api-docs)** · 💰 **[Free API key](https://madeonsol.com/pricing)** · 🤖 **[Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit)**
+
 [Solana Agent Kit](https://github.com/sendaifun/solana-agent-kit) plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL intelligence, deployer analytics, and wallet tracking.
 
 > 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/pricing](https://madeonsol.com/pricing) — no credit card required.
@@ -81,6 +88,10 @@ const events = await agent.methods.walletTrackerTrades(agent, { limit: 50 });
 | `MADEONSOL_WALLET_TRACKER_SUMMARY_ACTION` | "wallet tracker summary", "tracked wallet stats" |
 | `MADEONSOL_ME_ACTION` | "my api account", "api quota", "remaining requests" — tier + quota introspection (new in 1.7) |
 | `MADEONSOL_TOKENS_LIST_ACTION` | "filter tokens", "tokens by market cap", "scan tokens" — filtered/sortable token directory, PRO+ (new in 1.7) |
+| `MADEONSOL_WALLET_STATS_ACTION` | **New 1.8** · "wallet stats", "wallet info", "check wallet" — aggregate 90d stats + cross-product flags (KOL/alpha/deployer) for any Solana wallet (PRO+) |
+| `MADEONSOL_WALLET_PNL_ACTION` | **New 1.8** · "wallet pnl", "wallet profit", "wallet performance" — FIFO cost-basis PnL with profit factor, drawdown, daily curve, closed + open positions (PRO+) |
+| `MADEONSOL_WALLET_POSITIONS_ACTION` | **New 1.8** · "wallet positions", "wallet bags", "open positions" — open lots with live unrealized SOL (PRO+) |
+| `MADEONSOL_WALLET_TRADES_ACTION` | **New 1.8** · "wallet trades", "wallet history" — cursor-paginated raw trades with filters (PRO+) |
 
 ## Additional methods (v1.0+)
 
@@ -204,7 +215,7 @@ Free tier returns the full REST response shape on every endpoint — real wallet
 | TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
 | Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
 | Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
-| MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
+| MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) · [Smithery](https://smithery.ai/servers/madeonsol/solana-kol-intelligence) · [Glama](https://glama.ai/mcp/servers/LamboPoewert/mcp-server-madeonsol) |
 | ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
 
 ## License

package/dist/actions/kolAlertsRecent.d.ts

@@ -20,13 +20,13 @@ export declare const kolAlertsRecentAction: {
         limit: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         limit: number;
-        window: "24h" | "1h" | "6h" | "5m" | "15m";
+        window: "15m" | "5m" | "1h" | "6h" | "24h";
         types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
         min_severity?: "high" | "medium" | "low" | undefined;
     }, {
         limit?: number | undefined;
         types?: ("consensus_cluster" | "fresh_token_kol_buy" | "heating_up")[] | undefined;
-        window?: "24h" | "1h" | "6h" | "5m" | "15m" | undefined;
+        window?: "15m" | "5m" | "1h" | "6h" | "24h" | undefined;
         min_severity?: "high" | "medium" | "low" | undefined;
     }>;
     handler: (agent: unknown, input: {

package/dist/actions/kolCoordination.d.ts

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

package/dist/actions/kolTrendingTokens.d.ts

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

package/dist/actions/wallet.d.ts

@@ -0,0 +1,155 @@
+import { z } from "zod";
+export declare const walletStatsAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            address: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+    }, {
+        address: string;
+    }>;
+    handler: (agent: unknown, input: {
+        address: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletPnlAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            address: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+    }, {
+        address: string;
+    }>;
+    handler: (agent: unknown, input: {
+        address: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletPositionsAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            address: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+    }, {
+        address: string;
+    }>;
+    handler: (agent: unknown, input: {
+        address: string;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};
+export declare const walletTradesAction: {
+    name: string;
+    similes: string[];
+    description: string;
+    examples: {
+        input: {
+            address: string;
+            limit: number;
+            action: string;
+        };
+        output: {
+            status: string;
+        };
+        explanation: string;
+    }[][];
+    schema: z.ZodObject<{
+        address: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodEnum<["buy", "sell"]>>;
+        token_mint: z.ZodOptional<z.ZodString>;
+        since: z.ZodOptional<z.ZodNumber>;
+        until: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        address: string;
+        limit?: number | undefined;
+        action?: "buy" | "sell" | undefined;
+        cursor?: string | undefined;
+        token_mint?: string | undefined;
+        since?: number | undefined;
+        until?: number | undefined;
+    }, {
+        address: string;
+        limit?: number | undefined;
+        action?: "buy" | "sell" | undefined;
+        cursor?: string | undefined;
+        token_mint?: string | undefined;
+        since?: number | undefined;
+        until?: number | undefined;
+    }>;
+    handler: (agent: unknown, input: {
+        address: string;
+        limit?: number;
+        cursor?: string;
+        action?: "buy" | "sell";
+        token_mint?: string;
+        since?: number;
+        until?: number;
+    }) => Promise<{
+        status: string;
+        result: any;
+        message?: undefined;
+    } | {
+        status: string;
+        message: string;
+        result?: undefined;
+    }>;
+};

package/dist/actions/wallet.js

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { walletStats, walletPnl, walletPositions, walletTrades } from "../tools/index.js";
+export const walletStatsAction = {
+    name: "MADEONSOL_WALLET_STATS_ACTION",
+    similes: [
+        "wallet stats",
+        "wallet info",
+        "wallet profile",
+        "check wallet",
+        "wallet cross-product flags",
+        "is wallet a kol or deployer",
+    ],
+    description: "Get aggregate stats for any Solana wallet over the last 90 days (trade count, buys/sells split, SOL in/out, unique tokens) plus cross-product flags from kol_wallets, mv_alpha_wallets (incl. bot_confidence), and deployers. Works on any wallet — not just curated KOLs. PRO+.",
+    examples: [
+        [
+            {
+                input: { address: "ASVzakePP6GNg9r95d4LPZHJDMXun6L6E4um4pu5ybJk" },
+                output: { status: "success" },
+                explanation: "Get stats + flags for a wallet",
+            },
+        ],
+    ],
+    schema: z.object({
+        address: z.string().describe("Solana wallet address (base58, 32-44 chars)"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletStats(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletPnlAction = {
+    name: "MADEONSOL_WALLET_PNL_ACTION",
+    similes: [
+        "wallet pnl",
+        "wallet profit and loss",
+        "is wallet profitable",
+        "wallet performance",
+        "wallet win rate",
+        "wallet equity curve",
+        "wallet best trades",
+    ],
+    description: "Get full FIFO cost-basis PnL for any Solana wallet: realized + unrealized SOL, profit factor, max drawdown, avg + median hold minutes, daily UTC PnL curve, closed positions sorted by pnl desc (with ROI %, hold time, win/loss/breakeven), and open positions hydrated with current prices from the market-cap tracker. Cached in wallet_analyses with dynamic TTL (5min/1h/24h based on activity). Cache hits don't count against your daily quota. Cost basis only observable in the 90-day data window — overflow sells are silently discarded rather than fabricated. PRO+.",
+    examples: [
+        [
+            {
+                input: { address: "ASVzakePP6GNg9r95d4LPZHJDMXun6L6E4um4pu5ybJk" },
+                output: { status: "success" },
+                explanation: "Full PnL breakdown for the wallet",
+            },
+        ],
+    ],
+    schema: z.object({
+        address: z.string().describe("Solana wallet address"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletPnl(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletPositionsAction = {
+    name: "MADEONSOL_WALLET_POSITIONS_ACTION",
+    similes: [
+        "wallet positions",
+        "wallet holdings",
+        "wallet open bags",
+        "what does wallet hold",
+        "wallet active positions",
+        "wallet unrealized pnl",
+    ],
+    description: "Open positions only for any Solana wallet — lighter slice of MADEONSOL_WALLET_PNL_ACTION for use cases that don't need the full PnL summary or curve. Each position carries token_mint, token_amount, cost_basis_sol, avg_entry_price_sol, current_price_sol (live from mc-tracker; null if delisted), current_value_sol, unrealized_sol, unrealized_pct, first_buy_at. Shares the /pnl cache. PRO+.",
+    examples: [
+        [
+            {
+                input: { address: "ASVzakePP6GNg9r95d4LPZHJDMXun6L6E4um4pu5ybJk" },
+                output: { status: "success" },
+                explanation: "List the wallet's open positions",
+            },
+        ],
+    ],
+    schema: z.object({
+        address: z.string().describe("Solana wallet address"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletPositions(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};
+export const walletTradesAction = {
+    name: "MADEONSOL_WALLET_TRADES_ACTION",
+    similes: [
+        "wallet trades",
+        "wallet trade history",
+        "wallet activity",
+        "recent trades of wallet",
+        "paginated wallet trades",
+    ],
+    description: "Cursor-paginated raw trades for any Solana wallet. Filter by action (buy/sell), token_mint, and time window (since/until Unix seconds; default last 90 days). Cursor encodes (block_time, id) for stable DESC pagination — pass next_cursor from the previous response to fetch older trades. Limit 1-500 (default 100). PRO+.",
+    examples: [
+        [
+            {
+                input: { address: "ASVzakePP6GNg9r95d4LPZHJDMXun6L6E4um4pu5ybJk", limit: 50, action: "buy" },
+                output: { status: "success" },
+                explanation: "Get 50 recent buys for the wallet",
+            },
+        ],
+    ],
+    schema: z.object({
+        address: z.string().describe("Solana wallet address"),
+        limit: z.number().min(1).max(500).optional().describe("Trades per page (1-500, default 100)"),
+        cursor: z.string().optional().describe("Cursor from previous response's next_cursor field"),
+        action: z.enum(["buy", "sell"]).optional().describe("Filter to buys or sells only"),
+        token_mint: z.string().optional().describe("Filter to a single token mint"),
+        since: z.number().optional().describe("Unix epoch seconds — default now-90d"),
+        until: z.number().optional().describe("Unix epoch seconds — default now"),
+    }),
+    handler: async (agent, input) => {
+        try {
+            const data = await walletTrades(agent, input);
+            return { status: "success", result: data };
+        }
+        catch (err) {
+            return { status: "error", message: err.message };
+        }
+    },
+};