# madeonsol
[](https://crates.io/crates/madeonsol)
[](https://docs.rs/madeonsol)
[](LICENSE)
Official Rust SDK for the **[MadeOnSol](https://madeonsol.com) Solana API** — typed,
async, `tokio`-based, `rustls`-only.
> 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, and stream every DEX trade across 9+ programs.
>
> **Free tier: 200 requests/day at <https://madeonsol.com/developer> — no credit card required.**
## Get an API key
1. Visit **<https://madeonsol.com/developer>**
2. Sign in with email or Solana wallet
3. Copy your `msk_…` key (free tier is unlocked instantly — 200 req/day, 10/min)
Paid tiers unlock higher rate limits, sub-hour windows, WebSocket streaming,
webhooks, and the all-DEX firehose:
| **Free** | $0 | 200 | — | — | — | — |
| **PRO** | $49/mo | 10,000 | ✅ | ✅ | 3 | — |
| **ULTRA** | $149/mo | 100,000 | ✅ | ✅ | 10 | ✅ |
Annual: PRO $490/yr, ULTRA $1990/yr (2 months free).
## Install
```toml
[dependencies]
madeonsol = "0.1"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
```
Requires Rust 1.75+. Uses `reqwest` with `rustls-tls` (no OpenSSL dependency).
## Quick start
```rust
use madeonsol::{MadeOnSol, types::{KolFeedParams, KolAction}};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// Free key — get one at https://madeonsol.com/developer
let client = MadeOnSol::new(std::env::var("MADEONSOL_API_KEY")?)?;
let feed = client.kol.feed(&KolFeedParams {
limit: Some(10),
action: Some(KolAction::Buy),
..Default::default()
}).await?;
for trade in feed.trades {
let mc = trade.market_cap_usd_at_trade
.map(|m| format!(" @ MC ${:.0}", m))
.unwrap_or_default();
println!("{:?} bought {:?} for {} SOL{}",
trade.kol_name, trade.token_symbol, trade.sol_amount, mc);
}
Ok(())
}
```
Run the bundled examples:
```sh
export MADEONSOL_API_KEY=msk_...
cargo run --example kol_feed
cargo run --example deployer_alerts
```
## Namespaces
The `MadeOnSol` client exposes namespaced sub-clients:
| `client.kol` | KOL feed, leaderboard, coordination, PnL, trending tokens, alerts, compare, **first_touches** |
| `client.deployer` | Pump.fun deployer leaderboard, alerts, trajectory, bonded tokens |
| `client.alpha` | Alpha-wallet leaderboard, profiles, cap tables, buyer quality |
| `client.wallet_tracker` | Track arbitrary Solana wallets — watchlist CRUD, swap/transfer history |
| `client.coordination_alerts` | Push alerts on coordinated buying (PRO/ULTRA) |
| `client.first_touch_subscriptions` | Push alerts on first-KOL-touch events (ULTRA) |
| `client.tools` | Solana tool directory search |
| `client.stream` | Issue 24h WebSocket streaming tokens |
| `client.webhooks` | Webhook CRUD (PRO/ULTRA) |
Full reference: <https://docs.rs/madeonsol> · Interactive API docs: <https://madeonsol.com/api-docs>.
## Use cases
- **Copy-trading bot** — stream KOL buys via `client.kol.feed()` and mirror trades
- **DEX trade sniping** — subscribe to the all-DEX stream filtered by token / wallet
- **Deployer sniper** — monitor `client.deployer.alerts()` for elite-tier launches
- **Coordination detector** — flag tokens with `client.kol.coordination()` or push alerts
- **Scout signal** — track first-KOL-touch events filtered to S/A-tier scouts via `client.kol.first_touches()` (backtested: ~50% swarm rate vs 14% baseline)
- **Analytics dashboard** — combine leaderboard, PnL, and tool data
- **Telegram/Discord bot** — pipe alerts via webhooks into chat
- **Portfolio tracker** — use `client.kol.wallet()` to follow specific KOL positions
## Error handling
All methods return `Result<T, madeonsol::Error>`. The `Error::Api` variant exposes
HTTP status, server message, and the raw JSON body:
```rust
use madeonsol::{MadeOnSol, Error};
# async fn run(client: MadeOnSol) -> Result<(), Error> {
match client.kol.token("invalid-mint").await {
Ok(activity) => println!("{:?}", activity),
Err(Error::Api { status, message, .. }) => {
eprintln!("API error {}: {}", status, message);
}
Err(other) => return Err(other),
}
# Ok(())
# }
```
`Error::MissingApiKey` is returned by `MadeOnSol::new` if the key is empty or
doesn't start with `msk_` — the error message and a stderr hint both link to
<https://madeonsol.com/developer>.
## First-touch signal *(new in 0.4)*
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.
**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 <https://madeonsol.com/kol/scouts>.
```rust
use madeonsol::{FirstTouchPreset, FirstTouchesParams, ScoutTier};
let res = client
.kol
.first_touches(&FirstTouchesParams {
preset: Some(FirstTouchPreset::Scout),
min_scout_tier: Some(ScoutTier::S),
limit: Some(20),
..Default::default()
})
.await?;
for e in res.events {
println!(
"{} scouted {} (scout_score={:?}%)",
e.first_kol.name.unwrap_or_default(),
e.token_symbol.unwrap_or_default(),
e.first_kol.scout_score
);
}
```
**Webhook subscriptions** (Ultra, up to 10 active per user) — push delivery, HMAC-SHA256 signed:
```rust
use madeonsol::{FirstTouchSubscriptionCreateParams, FirstTouchSubscriptionFilters, ScoutTier, CoordinationDeliveryMode};
let res = client
.first_touch_subscriptions
.create(&FirstTouchSubscriptionCreateParams {
name: Some("S-tier scouts on pump tokens".into()),
filters: Some(FirstTouchSubscriptionFilters {
min_scout_tier: Some(ScoutTier::S),
mint_suffix: Some("pump".into()),
..Default::default()
}),
delivery_mode: Some(CoordinationDeliveryMode::Webhook),
webhook_url: Some("https://you.com/hooks/scout".into()),
})
.await?;
// store res.webhook_secret — shown ONCE
```
> **Don't poll — push.** Median lead time before the second KOL is 12 seconds. WebSocket channel: `kol:first_touches` (PRO+).
## WebSocket streams (PRO/ULTRA)
This crate does **not** ship a WebSocket client — `client.stream.get_token()`
returns the URL + token, and you connect with any WS library
(`tokio-tungstenite` recommended):
```rust
# async fn run(client: madeonsol::MadeOnSol) -> Result<(), Box<dyn std::error::Error>> {
let token = client.stream.get_token().await?;
let ws_url = format!("{}?token={}", token.ws_url, token.token);
// then: tokio_tungstenite::connect_async(&ws_url).await
# Ok(())
# }
```
The DEX firehose URL (`token.dex_ws_url`) is only present for ULTRA subscribers.
See <https://madeonsol.com/api-docs> for the full subscribe/unsubscribe protocol.
## Also available
| TypeScript / Node | [`madeonsol`](https://www.npmjs.com/package/madeonsol) on npm |
| Python (LangChain, CrewAI) | [`madeonsol-x402`](https://pypi.org/project/madeonsol-x402/) on PyPI |
| MCP Server (Claude, Cursor) | [`mcp-server-madeonsol`](https://www.npmjs.com/package/mcp-server-madeonsol) |
| ElizaOS | [`@madeonsol/plugin-madeonsol`](https://www.npmjs.com/package/@madeonsol/plugin-madeonsol) |
| Solana Agent Kit | [`solana-agent-kit-plugin-madeonsol`](https://www.npmjs.com/package/solana-agent-kit-plugin-madeonsol) |
## Links
- API docs: <https://madeonsol.com/api-docs> (interactive try-it-now)
- OpenAPI 3.1 spec: <https://madeonsol.com/api/v1/openapi.json>
- Postman collection: <https://madeonsol.com/api/v1/postman.json>
- Pricing & free key: <https://madeonsol.com/developer>
- Issues: <https://github.com/LamboPoewert/madeonsol-rs/issues>
## License
MIT © [MadeOnSol](https://madeonsol.com)