madeonsol_kol_first_touches
Read-onlyIdempotent
Retrieve real-time events when a tracked KOL is the first buyer of a newly minted token. Filter by scout tier, winrate, and token age to identify early signals with high follow-on rates.
Instructions
Recent first-KOL-touch events — every time a tracked KOL was the first to buy a token mint. Filterable by scout tier (S/A/B/C from mv_kol_scout_score), KOL winrate, token age, etc. Backtest: top scouts attract ≥3 follow-on KOLs within 4h ~50% of the time vs ~14% baseline. Median lead time before second KOL is 12s — for trading this signal, use the WebSocket channel rather than polling.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kol | No | Filter to a single KOL wallet address (base58) | |
| limit | No | Number of events to return (1-100, default 50) | |
| since | No | ISO timestamp — events strictly newer than this. Polling cursor. | |
| before | No | ISO timestamp — events strictly older than this. Pagination cursor. | |
| preset | No | Shortcut filter: 'scout' = min_scout_tier=B + min_n_touches=30 + token_age_max_min=60. 'fresh_launch' = token_age_max_min=15. | |
| include | No | Comma-separated includes — currently 'followers_4h' (computed for events >=4h old) | |
| strategy | No | Filter by first-touch KOL's auto-tagged strategy | |
| mint_suffix | No | Suffix-filter the token mint (e.g. 'pump', 'bonk') | |
| min_n_touches | No | Lower the minimum sample size for scout scoring (default 30) | |
| min_scout_tier | No | Restrict to first-touch KOLs of this scout tier or better. Requires n_first_touches_30d >= 30. | |
| min_first_buy_sol | No | Minimum size of the first KOL buy in SOL | |
| token_age_max_min | No | Only events on tokens younger than N minutes (uses token_first_seen) | |
| min_kol_winrate_7d | No | Minimum 7d winrate of the first-touch KOL (0-100) |