# MadeOnSol KOL First-Touch Events API

> MadeOnSol KOL First-Touch Events API is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns every 'first KOL buy on a token mint' event, filterable by scout tier, KOL winrate, token age, and mint suffix, to identify early alpha signals in Solana token trading.

## Facts

- Endpoint: GET https://api.relai.fi/relay/1780517153303/kol/first-touches
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/madeonsol-kol-first-touch-events-api-a90da35a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jy2ST1NQKxpm-k8HvCRB3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability madeonsol-kol-first-touch-events-api-a90da35a
```

Example prompt: Pull the latest KOL first-touch events on MadeOnSol for tokens under 2 hours old, filtered to S and A tier scouts with a winrate above 60% — I want to see what the top scouts are buying first today.

## When to prefer this

Use this endpoint when you need structured, filterable KOL first-touch event data for Solana token mints and want to rank or backtest scout quality. Prefer the WebSocket channel `kol:first_touches` (PRO+) over this REST endpoint when latency is critical for live trading, as the median lead time before a second KOL buy is only 12 seconds. This endpoint is best for backtesting, building watchlists, or non-latency-sensitive analysis of top scout activity.

## Known failure modes

- Invalid or missing authentication returns 402 payment required
- Invalid scout tier filter value returns 400 bad request
- Unknown mint suffix format returns 400 bad request
- No events matching filters returns empty result set
- Rate limiting or quota exceeded returns 429 too many requests
- Stale or no data during low-activity market periods returns empty paginated result

## How this service works

Every 'first KOL buy on a token mint' event. Filterable by scout tier (S/A/B/C from `mv_kol_scout_score`), KOL winrate, token age, mint suffix. 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, subscribe to the `kol:first_touches` WebSocket channel (PRO+) rather than polling.

## Output

A paginated list of first KOL buy events per token mint, each including the token mint address, scout tier rating (S/A/B/C), KOL winrate, token age at time of first touch, mint suffix, and backtest-derived follow-on KOL metrics. Median lead time data (12s before second KOL) helps gauge urgency for trading decisions.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/madeonsol-kol-first-touch-events-api-a90da35a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)