@madeonsol/plugin-madeonsol 1.8.1 → 1.9.1

package/README.md

@@ -9,8 +9,12 @@
 
 ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading 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.
+> Real-time Solana trading intelligence: track 1,069 KOL wallets with <3s latency, score 23,000+ Pump.fun deployers, surface deshred deploy signals ~500ms before on-chain confirmation, detect multi-KOL coordination, and stream every DEX trade. Free tier: 200 requests/day at [madeonsol.com/pricing](https://madeonsol.com/pricing) — no credit card required.
 
+> **New in 1.9** — **Price alerts, scout leaderboard, coordination history, wallet derived stats.** `PRICE_ALERTS_*` actions (PRO=5, ULTRA=25 rules). `SCOUT_LEADERBOARD`, `KOL_CONSENSUS`, `PEAK_HISTORY`, `COORDINATION_HISTORY`. `WALLET_STATS` now returns `derived`: win_rate, roi, verdict, biggest_miss.
+>
+> **New in 1.8** — **Universal Wallet API.** `WALLET_STATS`, `WALLET_PNL`, `WALLET_POSITIONS`, `WALLET_TRADES` — FIFO cost-basis PnL and raw trades for any Solana wallet. PRO+. Cache hits free.
+>
 > **New in 1.7.0** *(2026-05-12)* — **Account introspection + token scanner actions.** Two new actions: `meAction` (`GET_MADEONSOL_ACCOUNT`) reports the caller's tier, daily/burst quota, and webhook / copy-trade / coord-rule slot counts; `tokensListAction` (`LIST_MADEONSOL_TOKENS`) scans the Solana token universe by MC, liquidity, 1h momentum, and primary DEX. New client methods: `client.getMe()` and `client.getTokensList(params)`. Token responses now expose **velocity / MEV-share enrichment** fields. The `/tokens` scanner applies a default `min_liq=2000` so the agent isn't drowned in dust pools by default. `/token/{mint}` HTTP 400s now return structured `code` / `reason` / `example` / `docs` so the agent can self-correct bad mints. Deprecated `avg_entry_mc_usd` has been removed from all leaderboard payloads.
 
 ## Quick start (10 seconds)
@@ -129,6 +133,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"
@@ -141,9 +186,9 @@ Your agent can then respond to queries like:
 
 | Tier | Price | Wallets tracked | Requests/day |
 |------|-------|-----------------|--------------|
-| Free | $0 | 10 | 200 |
-| Pro | $49/mo | 50 | 10,000 |
-| Ultra | $149/mo | 100 + WS events | 100,000 |
+| BASIC (free) | $0 | 10 | 200 |
+| PRO | $49/mo ($490/yr) | 50 | 10,000 |
+| ULTRA | $149/mo ($1,490/yr) | 100 + WS events | 100,000 |
 
 Free tier returns the full REST response shape on every endpoint — real wallets, TX signatures, full precision. Paid tiers unlock webhooks, WebSockets, rule engines, and ULTRA-only data depth. Get a key at [madeonsol.com/pricing](https://madeonsol.com/pricing).
 

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

@@ -19,7 +19,7 @@ export class MadeOnSolClient {
         this.authHeaders = {};
         if (options.apiKey) {
             this.authMode = "madeonsol";
-            this.authHeaders = { Authorization: `Bearer ${options.apiKey}` };
+            this.authHeaders = { Authorization: `Bearer ${options.apiKey}`, "User-Agent": "plugin-madeonsol/1.9.0" };
         }
         else if (options.fetchFn) {
             this.authMode = "x402";
@@ -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,7 +1,12 @@
 {
   "name": "@madeonsol/plugin-madeonsol",
-  "version": "1.8.1",
+  "version": "1.9.1",
   "description": "ElizaOS plugin for MadeOnSol — Solana KOL intelligence and deployer analytics via x402 micropayments",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LamboPoewert/plugin-madeonsol"
+  },
+  "homepage": "https://madeonsol.com/solana-api",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",