@madeonsol/plugin-madeonsol 1.8.1 → 1.9.0

package/README.md

@@ -129,6 +129,47 @@ ULTRA only for subscriptions — up to 10 active. CRUD: `firstTouchSubscriptions
 
 > **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches`.
 
+### 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.
+
+| Action | Description |
+|---|---|
+| `PRICE_ALERTS_LIST` | List your price alert rules |
+| `PRICE_ALERTS_CREATE` | Create a dip/recovery alert rule |
+| `PRICE_ALERTS_DELETE` | Delete a price alert rule |
+
+```ts
+import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
+const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
+
+const { alert, webhook_secret } = await client.priceAlertsCreate({
+  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
+```
+
+Also available: `priceAlertsList()`, `priceAlertsGet(id)`, `priceAlertsUpdate(id, updates)`, `priceAlertsDelete(id)`.
+
+### Scout leaderboard & KOL consensus *(new in 1.9)*
+
+| Action | Description |
+|---|---|
+| `SCOUT_LEADERBOARD` | Top scout-tier KOLs ranked by first-touch follow-on rate, win rate, and ROI (PRO+) |
+| `KOL_CONSENSUS` | Tokens with the strongest KOL agreement signal (PRO+) |
+| `PEAK_HISTORY` | Historical peak-density windows for a token (PRO+) |
+| `COORDINATION_HISTORY` | Global coordination event log (PRO+) |
+
+### Wallet derived stats *(new in 1.9)*
+
+`WALLET_STATS` 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).
+
 Your agent can then respond to queries like:
 - "What are KOLs buying right now?"
 - "Show me the KOL leaderboard this week"

package/dist/client.d.ts

@@ -455,4 +455,74 @@ export declare class MadeOnSolClient {
         error?: string;
         status: number;
     }>;
+    priceAlertsList(): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    priceAlertsCreate(params: {
+        token_mint: string;
+        drop_pct: number;
+        recovery_pct?: number;
+        name?: string;
+        delivery_mode?: "webhook" | "websocket" | "both";
+        webhook_url?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    priceAlertsGet(id: number | string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    priceAlertsUpdate(id: number | string, updates: Record<string, unknown>): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    priceAlertsDelete(id: number | string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    priceAlertsEvents(params?: {
+        alert_id?: number;
+        event_type?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    scoutLeaderboard(params?: {
+        limit?: number;
+        scout_tier?: string;
+        sort?: string;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    coordinationHistory(params?: {
+        limit?: number;
+        since?: string;
+        min_score?: number;
+    }): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    kolConsensus(mint: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
+    peakHistory(mint: string): Promise<{
+        data?: unknown;
+        error?: string;
+        status: number;
+    }>;
 }

package/dist/client.js

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

package/package.json

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