@madeonsol/plugin-madeonsol 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +71 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,6 +4,20 @@ ElizaOS plugin for [MadeOnSol](https://madeonsol.com) — Solana KOL trading int
|
|
|
4
4
|
|
|
5
5
|
> 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/developer](https://madeonsol.com/developer) — no credit card required.
|
|
6
6
|
|
|
7
|
+
> **New in 1.6.0** *(2026-05-09)* — **Market-cap filtering everywhere.** Pass `min_mc_usd` / `max_mc_usd` to `kolFeed`, `kolCoordination`, `kolFirstTouches`, and `copytradeSignals` action handlers — the agent can scope its alpha hunt to a specific MC band ("only sub-$50K", "skip the moonshots"). Same fields land on `coordinationAlerts` + `firstTouchSubscriptions` create/update params so persistent rules carry the band. Deprecated `avg_entry_mc_usd` removed from leaderboards.
|
|
8
|
+
|
|
9
|
+
## Quick start (10 seconds)
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install @madeonsol/plugin-madeonsol
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import { madeOnSolPlugin } from "@madeonsol/plugin-madeonsol";
|
|
17
|
+
const agent = { plugins: [madeOnSolPlugin], settings: { MADEONSOL_API_KEY: "msk_..." } }; // free key: https://madeonsol.com/developer
|
|
18
|
+
// Then ask the agent: "What are KOLs buying right now?"
|
|
19
|
+
```
|
|
20
|
+
|
|
7
21
|
## Authentication
|
|
8
22
|
|
|
9
23
|
Three options (in priority order):
|
|
@@ -20,7 +34,7 @@ Gives your ElizaOS agent access to MadeOnSol's Solana intelligence API.
|
|
|
20
34
|
| Action | Description |
|
|
21
35
|
|--------|-------------|
|
|
22
36
|
| `GET_KOL_FEED` | Real-time KOL trade feed (1,000+ wallets) |
|
|
23
|
-
| `GET_KOL_COORDINATION` | Multi-KOL convergence
|
|
37
|
+
| `GET_KOL_COORDINATION` | Multi-KOL convergence (v1.1 — peak-density, exits, 0-100 score) |
|
|
24
38
|
| `GET_KOL_LEADERBOARD` | KOL PnL/win-rate rankings (180 days of history) |
|
|
25
39
|
| `GET_DEPLOYER_ALERTS` | Pump.fun deployer alerts with KOL enrichment |
|
|
26
40
|
| `WALLET_TRACKER_WATCHLIST` | List your tracked wallets and remaining capacity |
|
|
@@ -51,6 +65,57 @@ const agent = {
|
|
|
51
65
|
};
|
|
52
66
|
```
|
|
53
67
|
|
|
68
|
+
### v1.1 Coordination alerts (programmatic)
|
|
69
|
+
|
|
70
|
+
The `GET_KOL_COORDINATION` action surfaces the v1.1 `coordination_score`, `peak_kols`, and `exited_count` fields. For **push alerts** (fires within ~1s of a qualifying trade via WS `kol:coordination` channel + HMAC-signed webhook), use the client directly from a custom action:
|
|
71
|
+
|
|
72
|
+
```ts
|
|
73
|
+
import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
|
|
74
|
+
|
|
75
|
+
const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
|
|
76
|
+
const res = await client.coordinationAlertsCreate({
|
|
77
|
+
name: "fresh pump cluster",
|
|
78
|
+
min_kols: 4,
|
|
79
|
+
window_minutes: 15,
|
|
80
|
+
min_score: 70,
|
|
81
|
+
include_majors: false,
|
|
82
|
+
cooldown_min: 60,
|
|
83
|
+
score_jump_break: 10,
|
|
84
|
+
delivery_mode: "both",
|
|
85
|
+
webhook_url: "https://you.com/hooks/coord",
|
|
86
|
+
});
|
|
87
|
+
// store res.data.webhook_secret — shown ONCE
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
PRO=5 rules, ULTRA=20. Also available: `coordinationAlertsList()`, `coordinationAlertsGet(id)`, `coordinationAlertsUpdate(id, updates)`, `coordinationAlertsDelete(id)`.
|
|
91
|
+
|
|
92
|
+
### First-touch signal *(new in 1.3)*
|
|
93
|
+
|
|
94
|
+
Every "first KOL buy on a token mint" event — when a tracked KOL is the first of the cohort to touch a token. Filterable by **scout tier** (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix.
|
|
95
|
+
|
|
96
|
+
**Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys).
|
|
97
|
+
|
|
98
|
+
```ts
|
|
99
|
+
import { MadeOnSolClient } from "@madeonsol/plugin-madeonsol";
|
|
100
|
+
const client = new MadeOnSolClient({ apiKey: process.env.MADEONSOL_API_KEY });
|
|
101
|
+
|
|
102
|
+
// REST query
|
|
103
|
+
const { events } = await client.firstTouches({ preset: "scout", min_scout_tier: "S", limit: 20 });
|
|
104
|
+
|
|
105
|
+
// Webhook subscription (Ultra) — push delivery, HMAC-signed
|
|
106
|
+
const { subscription, webhook_secret } = await client.firstTouchSubscriptionsCreate({
|
|
107
|
+
name: "S-tier scouts on pump tokens",
|
|
108
|
+
filters: { min_scout_tier: "S", mint_suffix: "pump" },
|
|
109
|
+
delivery_mode: "webhook",
|
|
110
|
+
webhook_url: "https://you.com/hooks/scout",
|
|
111
|
+
});
|
|
112
|
+
// store webhook_secret — shown ONCE
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
ULTRA only for subscriptions — up to 10 active. CRUD: `firstTouchSubscriptionsList()`, `firstTouchSubscriptionsGet(id)`, `firstTouchSubscriptionsUpdate(id, updates)`, `firstTouchSubscriptionsDelete(id)`.
|
|
116
|
+
|
|
117
|
+
> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches`.
|
|
118
|
+
|
|
54
119
|
Your agent can then respond to queries like:
|
|
55
120
|
- "What are KOLs buying right now?"
|
|
56
121
|
- "Show me the KOL leaderboard this week"
|
|
@@ -63,17 +128,18 @@ Your agent can then respond to queries like:
|
|
|
63
128
|
|
|
64
129
|
| Tier | Price | Wallets tracked | Requests/day |
|
|
65
130
|
|------|-------|-----------------|--------------|
|
|
66
|
-
|
|
|
67
|
-
|
|
|
68
|
-
|
|
|
131
|
+
| Free | $0 | 10 | 200 |
|
|
132
|
+
| Pro | $49/mo | 50 | 10,000 |
|
|
133
|
+
| Ultra | $149/mo | 100 + WS events | 100,000 |
|
|
69
134
|
|
|
70
|
-
Get a key at [madeonsol.com/developer](https://madeonsol.com/developer).
|
|
135
|
+
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/developer](https://madeonsol.com/developer).
|
|
71
136
|
|
|
72
137
|
## Also Available
|
|
73
138
|
|
|
74
139
|
| Platform | Package |
|
|
75
140
|
|---|---|
|
|
76
141
|
| TypeScript SDK | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
|
|
142
|
+
| Rust SDK | [`madeonsol`](https://crates.io/crates/madeonsol) on crates.io |
|
|
77
143
|
| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
|
|
78
144
|
| MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
|
|
79
145
|
| Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
|
package/package.json
CHANGED