solana-agent-kit-plugin-madeonsol 1.3.0 → 1.3.1
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 +34 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -71,6 +71,7 @@ const events = await agent.methods.walletTrackerTrades(agent, { limit: 50 });
|
|
|
71
71
|
| `MADEONSOL_DEPLOYER_ALERTS_ACTION` | "deployer alerts", "pump fun launches" |
|
|
72
72
|
| `MADEONSOL_KOL_PNL_ACTION` | "kol pnl", "kol profit", "wallet pnl" |
|
|
73
73
|
| `MADEONSOL_KOL_TRENDING_TOKENS_ACTION` | "kol trending tokens", "kol volume" |
|
|
74
|
+
| `MADEONSOL_KOL_FIRST_TOUCHES_ACTION` | "kol first touch", "first kol buyer", "scout signal" — backtested first-mover signal (new in 1.3) |
|
|
74
75
|
| `MADEONSOL_WALLET_TRACKER_WATCHLIST_ACTION` | "wallet watchlist", "tracked wallets" |
|
|
75
76
|
| `MADEONSOL_WALLET_TRACKER_ADD_ACTION` | "track wallet", "watch wallet", "add to watchlist" |
|
|
76
77
|
| `MADEONSOL_WALLET_TRACKER_REMOVE_ACTION` | "untrack wallet", "remove from watchlist" |
|
|
@@ -139,6 +140,39 @@ await agent.methods.coordinationAlertsDelete(agent, { rule_id: "uuid..." });
|
|
|
139
140
|
|
|
140
141
|
The v1.1 `kolCoordination()` response also includes `peak_kols`, `peak_buys`, `exited_count`, and `coordination_score` (0-100). Pass `{ min_score, window_minutes, include_majors }` to filter.
|
|
141
142
|
|
|
143
|
+
### KOL First-Touch Signal *(new in 1.3)*
|
|
144
|
+
|
|
145
|
+
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.
|
|
146
|
+
|
|
147
|
+
**Backtest:** S-tier scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys / 72,549 events). Public leaderboard at [madeonsol.com/kol/scouts](https://madeonsol.com/kol/scouts).
|
|
148
|
+
|
|
149
|
+
```ts
|
|
150
|
+
// REST query — also exposed as MADEONSOL_KOL_FIRST_TOUCHES_ACTION for the agent
|
|
151
|
+
const { events } = await agent.methods.kolFirstTouches(agent, {
|
|
152
|
+
preset: "scout",
|
|
153
|
+
min_scout_tier: "S",
|
|
154
|
+
limit: 20,
|
|
155
|
+
});
|
|
156
|
+
|
|
157
|
+
// Webhook subscription (Ultra only) — push delivery, HMAC-signed
|
|
158
|
+
const res = await agent.methods.firstTouchSubscriptionsCreate(agent, {
|
|
159
|
+
name: "S-tier scouts on pump tokens",
|
|
160
|
+
filters: { min_scout_tier: "S", mint_suffix: "pump" },
|
|
161
|
+
delivery_mode: "webhook",
|
|
162
|
+
webhook_url: "https://you.com/hooks/scout",
|
|
163
|
+
});
|
|
164
|
+
// store res.webhook_secret — shown ONCE
|
|
165
|
+
|
|
166
|
+
await agent.methods.firstTouchSubscriptionsList(agent);
|
|
167
|
+
await agent.methods.firstTouchSubscriptionsGet(agent, { subscription_id: "uuid..." });
|
|
168
|
+
await agent.methods.firstTouchSubscriptionsUpdate(agent, { subscription_id: "uuid...", updates: { is_active: false } });
|
|
169
|
+
await agent.methods.firstTouchSubscriptionsDelete(agent, { subscription_id: "uuid..." });
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
ULTRA only for subscriptions — up to 10 active per user.
|
|
173
|
+
|
|
174
|
+
> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
|
|
175
|
+
|
|
142
176
|
### Rate-limit headers
|
|
143
177
|
|
|
144
178
|
Every successful request populates a module-level `lastRateLimit` (limit / remaining / reset / requestId):
|
package/package.json
CHANGED