solana-agent-kit-plugin-madeonsol 1.8.1 → 1.9.0

package/README.md

@@ -188,6 +188,55 @@ ULTRA only for subscriptions — up to 10 active per user.
 
 > **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
 
+### Price Alerts *(new in 1.9)*
+
+CRUD for token dip/recovery price alerts. Fires when a token's market cap crosses your threshold. PRO=5 rules, ULTRA=25.
+
+```ts
+const { alert, webhook_secret } = await agent.methods.priceAlertsCreate(agent, {
+  name: "SOL dip buy",
+  token_mint: "So11111111111111111111111111111111111111112",
+  condition: "below",
+  threshold_mc_usd: 5_000_000_000,
+  cooldown_min: 120,
+  delivery_mode: "both",
+  webhook_url: "https://you.com/hooks/price",
+});
+// store webhook_secret — shown ONCE
+
+await agent.methods.priceAlertsList(agent);
+await agent.methods.priceAlertsGet(agent, { alert_id: "uuid..." });
+await agent.methods.priceAlertsUpdate(agent, { alert_id: "uuid...", updates: { is_active: false } });
+await agent.methods.priceAlertsDelete(agent, { alert_id: "uuid..." });
+```
+
+Also exposed as `MADEONSOL_PRICE_ALERTS_LIST_ACTION` ("my price alerts") and `MADEONSOL_PRICE_ALERTS_CREATE_ACTION` ("alert me when token dips below").
+
+### Scout Leaderboard & KOL Consensus *(new in 1.9)*
+
+| Method / Action | Description |
+|---|---|
+| `agent.methods.scoutLeaderboard(agent, params)` | Top scout-tier KOLs ranked by first-touch follow-on rate, win rate, and ROI (PRO+) |
+| `agent.methods.kolConsensus(agent, params)` | Tokens with the strongest KOL agreement signal (PRO+) |
+| `agent.methods.peakHistory(agent, { mint })` | Historical peak-density windows for a token (PRO+) |
+| `agent.methods.coordinationHistory(agent, params)` | Global coordination event log (PRO+) |
+
+```ts
+const { leaderboard } = await agent.methods.scoutLeaderboard(agent, { period: "30d", limit: 25 });
+const { tokens } = await agent.methods.kolConsensus(agent, { min_kols: 5, period: "24h" });
+```
+
+Also exposed as `MADEONSOL_SCOUT_LEADERBOARD_ACTION` and `MADEONSOL_KOL_CONSENSUS_ACTION`.
+
+### Wallet Derived Stats *(new in 1.9)*
+
+`walletStats` now returns a `stats` object with derived fields: `win_rate` (0-1), `roi`, `verdict` ("strong" | "profitable" | "neutral" | "losing"), and `biggest_miss` (token with the highest post-exit gain the wallet missed).
+
+```ts
+const { stats } = await agent.methods.walletStats(agent, { address: "WALLET_ADDRESS" });
+// stats.win_rate, stats.roi, stats.verdict, stats.biggest_miss
+```
+
 ### Rate-limit headers
 
 Every successful request populates a module-level `lastRateLimit` (limit / remaining / reset / requestId):

package/dist/index.d.ts

@@ -11,7 +11,7 @@ import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.js";
 import { kolFirstTouchesAction } from "./actions/kolFirstTouches.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokensList.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList } from "./tools/index.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList } from "./tools/index.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
 declare const MadeOnSolPlugin: {
     name: string;
@@ -57,6 +57,16 @@ declare const MadeOnSolPlugin: {
         firstTouchSubscriptionsGet: typeof firstTouchSubscriptionsGet;
         firstTouchSubscriptionsUpdate: typeof firstTouchSubscriptionsUpdate;
         firstTouchSubscriptionsDelete: typeof firstTouchSubscriptionsDelete;
+        priceAlertsList: typeof priceAlertsList;
+        priceAlertsCreate: typeof priceAlertsCreate;
+        priceAlertsGet: typeof priceAlertsGet;
+        priceAlertsUpdate: typeof priceAlertsUpdate;
+        priceAlertsDelete: typeof priceAlertsDelete;
+        priceAlertsEvents: typeof priceAlertsEvents;
+        scoutLeaderboard: typeof scoutLeaderboard;
+        coordinationHistory: typeof coordinationHistory;
+        kolConsensus: typeof kolConsensus;
+        peakHistory: typeof peakHistory;
         me: typeof me;
         tokensList: typeof tokensList;
         walletStats: typeof walletStats;
@@ -843,7 +853,7 @@ declare const MadeOnSolPlugin: {
     initialize(_agent: unknown): void;
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, };
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, kolFirstTouchesAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/dist/index.js

@@ -11,7 +11,7 @@ import { kolAlertsRecentAction } from "./actions/kolAlertsRecent.js";
 import { kolFirstTouchesAction } from "./actions/kolFirstTouches.js";
 import { meAction } from "./actions/me.js";
 import { tokensListAction } from "./actions/tokensList.js";
-import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, } from "./tools/index.js";
+import { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, } from "./tools/index.js";
 import { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction } from "./actions/wallet.js";
 const MadeOnSolPlugin = {
     name: "madeonsol",
@@ -57,6 +57,16 @@ const MadeOnSolPlugin = {
         firstTouchSubscriptionsGet,
         firstTouchSubscriptionsUpdate,
         firstTouchSubscriptionsDelete,
+        priceAlertsList,
+        priceAlertsCreate,
+        priceAlertsGet,
+        priceAlertsUpdate,
+        priceAlertsDelete,
+        priceAlertsEvents,
+        scoutLeaderboard,
+        coordinationHistory,
+        kolConsensus,
+        peakHistory,
         me,
         tokensList,
         walletStats,
@@ -92,7 +102,7 @@ const MadeOnSolPlugin = {
     },
 };
 export default MadeOnSolPlugin;
-export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, };
+export { kolFeed, kolCoordination, kolLeaderboard, deployerAlerts, kolPnl, kolTrendingTokens, kolTokenEntryOrder, kolCompare, kolAlertsRecent, createWebhook, listWebhooks, deleteWebhook, testWebhook, getStreamToken, walletTrackerWatchlist, walletTrackerAdd, walletTrackerRemove, walletTrackerTrades, walletTrackerSummary, alphaLeaderboard, alphaWallet, alphaLinked, tokenCapTable, tokenBuyerQuality, copyTradeList, copyTradeCreate, copyTradeGet, copyTradeUpdate, copyTradeDelete, copyTradeSignals, coordinationAlertsList, coordinationAlertsCreate, coordinationAlertsGet, coordinationAlertsUpdate, coordinationAlertsDelete, kolFirstTouches, firstTouchSubscriptionsList, firstTouchSubscriptionsCreate, firstTouchSubscriptionsGet, firstTouchSubscriptionsUpdate, firstTouchSubscriptionsDelete, priceAlertsList, priceAlertsCreate, priceAlertsGet, priceAlertsUpdate, priceAlertsDelete, priceAlertsEvents, scoutLeaderboard, coordinationHistory, kolConsensus, peakHistory, walletStats, walletPnl, walletPositions, walletTrades, me, tokensList, };
 export { kolFeedAction, kolCoordinationAction, kolLeaderboardAction, deployerAlertsAction, kolPnlAction, kolTrendingTokensAction, kolTokenEntryOrderAction, kolCompareAction, kolAlertsRecentAction, kolFirstTouchesAction };
 export { walletTrackerWatchlistAction, walletTrackerAddAction, walletTrackerRemoveAction, walletTrackerTradesAction, walletTrackerSummaryAction };
 export { walletStatsAction, walletPnlAction, walletPositionsAction, walletTradesAction };

package/dist/tools/index.d.ts

@@ -288,4 +288,45 @@ export declare function copyTradeSignals(agent: Agent, params?: {
     limit?: number;
     since?: string;
 }): Promise<any>;
+export declare function priceAlertsList(agent: Agent): Promise<any>;
+export declare function priceAlertsCreate(agent: Agent, params: {
+    token_mint: string;
+    drop_pct: number;
+    recovery_pct?: number;
+    name?: string;
+    delivery_mode?: "webhook" | "websocket" | "both";
+    webhook_url?: string;
+}): Promise<any>;
+export declare function priceAlertsGet(agent: Agent, params: {
+    id: number;
+}): Promise<any>;
+export declare function priceAlertsUpdate(agent: Agent, params: {
+    id: number;
+    updates: Record<string, unknown>;
+}): Promise<any>;
+export declare function priceAlertsDelete(agent: Agent, params: {
+    id: number;
+}): Promise<any>;
+export declare function priceAlertsEvents(agent: Agent, params?: {
+    alert_id?: number;
+    event_type?: "dip" | "recovery";
+    since?: string;
+    limit?: number;
+}): Promise<any>;
+export declare function scoutLeaderboard(agent: Agent, params?: {
+    limit?: number;
+    scout_tier?: "S" | "A" | "B" | "C";
+    sort?: string;
+}): Promise<any>;
+export declare function coordinationHistory(agent: Agent, params?: {
+    limit?: number;
+    since?: string;
+    min_score?: number;
+}): Promise<any>;
+export declare function kolConsensus(agent: Agent, params: {
+    mint: string;
+}): Promise<any>;
+export declare function peakHistory(agent: Agent, params: {
+    mint: string;
+}): Promise<any>;
 export {};

package/dist/tools/index.js

@@ -362,3 +362,53 @@ export async function copyTradeSignals(agent, params = {}) {
     const query = qs.toString() ? `?${qs.toString()}` : "";
     return restQuery(agent, "GET", `/copy-trade/signals${query}`);
 }
+// ── Price Alerts (PRO/ULTRA, v1.9) ──
+export async function priceAlertsList(agent) {
+    return restQuery(agent, "GET", "/price-alerts");
+}
+export async function priceAlertsCreate(agent, params) {
+    return restQuery(agent, "POST", "/price-alerts", params);
+}
+export async function priceAlertsGet(agent, params) {
+    return restQuery(agent, "GET", `/price-alerts/${params.id}`);
+}
+export async function priceAlertsUpdate(agent, params) {
+    return restQuery(agent, "PATCH", `/price-alerts/${params.id}`, params.updates);
+}
+export async function priceAlertsDelete(agent, params) {
+    return restQuery(agent, "DELETE", `/price-alerts/${params.id}`);
+}
+export async function priceAlertsEvents(agent, params = {}) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            qs.set(k, String(v));
+    }
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/price-alerts/events${query}`);
+}
+// ── v1.9 new endpoints ──
+export async function scoutLeaderboard(agent, params = {}) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            qs.set(k, String(v));
+    }
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/kol/scouts/leaderboard${query}`);
+}
+export async function coordinationHistory(agent, params = {}) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            qs.set(k, String(v));
+    }
+    const query = qs.toString() ? `?${qs.toString()}` : "";
+    return restQuery(agent, "GET", `/kol/coordination/history${query}`);
+}
+export async function kolConsensus(agent, params) {
+    return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/kol-consensus`);
+}
+export async function peakHistory(agent, params) {
+    return restQuery(agent, "GET", `/tokens/${encodeURIComponent(params.mint)}/peak-history`);
+}

package/package.json

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