madeonsol-x402 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 +36 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -135,6 +135,42 @@ const { rule, webhook_secret } = await rest.coordinationAlertsCreate({
|
|
|
135
135
|
|
|
136
136
|
**The `kolCoordination()` response** now includes v1.1 fields: `peak_window_start/end`, `peak_kols`, `peak_buys` (the busiest slice within the period), `exited_count` + per-KOL `exited` flag (net-flow-negative wallets), and `coordination_score` (0-100). Pass `min_score`, `window_minutes`, `include_majors` to filter.
|
|
137
137
|
|
|
138
|
+
### KOL first-touch signal *(new in 1.3)*
|
|
139
|
+
|
|
140
|
+
Every "first KOL buy on a token mint" event — the moment 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.
|
|
141
|
+
|
|
142
|
+
**Backtest:** top scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline (38d / 491k buys / 72,549 events). Live leaderboard at [madeonsol.com/kol/scouts](https://madeonsol.com/kol/scouts).
|
|
143
|
+
|
|
144
|
+
```ts
|
|
145
|
+
import { MadeOnSolREST } from "madeonsol-x402";
|
|
146
|
+
const rest = new MadeOnSolREST({ apiKey: process.env.MADEONSOL_API_KEY! });
|
|
147
|
+
|
|
148
|
+
// S-tier scouts on tokens younger than 1h
|
|
149
|
+
const { events } = await rest.firstTouches({ preset: "scout", min_scout_tier: "S" });
|
|
150
|
+
|
|
151
|
+
for (const e of events) {
|
|
152
|
+
console.log(e.first_kol.name, "scouted", e.token_symbol, `(scout_score=${e.first_kol.scout_score}%)`);
|
|
153
|
+
}
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
Filter knobs: `since`, `before`, `limit`, `kol`, `min_kol_winrate_7d`, `min_scout_tier` (`"S"|"A"|"B"|"C"`), `min_n_touches`, `strategy`, `token_age_max_min`, `min_first_buy_sol`, `mint_suffix` (`"pump"`, `"bonk"`, …), `preset` (`"scout"`/`"fresh_launch"`), `include` (`"followers_4h"`).
|
|
157
|
+
|
|
158
|
+
> **Don't poll — push.** Median lead time before the second KOL is **12 seconds**. REST polling will miss the swarm. Subscribe to the `kol:first_touches` WebSocket channel (PRO+) or, on Ultra, create an HMAC-signed webhook subscription.
|
|
159
|
+
|
|
160
|
+
**Webhook subscriptions (Ultra)** — up to 10 active per user, mirrors `coordinationAlerts`:
|
|
161
|
+
|
|
162
|
+
```ts
|
|
163
|
+
const { subscription, webhook_secret } = await rest.firstTouchSubscriptionsCreate({
|
|
164
|
+
name: "S-tier scouts on pump tokens",
|
|
165
|
+
filters: { min_scout_tier: "S", mint_suffix: "pump" },
|
|
166
|
+
delivery_mode: "webhook",
|
|
167
|
+
webhook_url: "https://my.bot/hooks/scout",
|
|
168
|
+
});
|
|
169
|
+
// → store webhook_secret — shown ONCE
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
`firstTouchSubscriptionsList`, `firstTouchSubscriptionsGet(id)`, `firstTouchSubscriptionsUpdate(id, params)`, `firstTouchSubscriptionsDelete(id)` round out the CRUD.
|
|
173
|
+
|
|
138
174
|
### Copy-trade rules
|
|
139
175
|
|
|
140
176
|
Server-side rules that fire signals when one of your watched source wallets trades. Delivered via webhook (HMAC-signed) and/or WebSocket. PRO=3 rules × 5 source wallets each; ULTRA=20 × 50.
|