madeonsol 2.17.0 → 2.18.0

package/llms.txt

@@ -1,101 +1,102 @@
-# MadeOnSol SDK
-
-> Official TypeScript/JavaScript SDK for the MadeOnSol Solana API
-
-## What is MadeOnSol?
-
-MadeOnSol (https://madeonsol.com) is the largest Solana ecosystem tool directory with 950+ indexed tools and dApps. The API provides programmatic access to:
-
-- **KOL Tracker**: Real-time trade feed for 946 tracked Solana KOL (Key Opinion Leader) wallets, PnL leaderboards, coordination detection, and per-wallet profiles.
-- **Deployer Hunter**: Pump.fun deployer wallet scoring, tier-based leaderboards, deploy alerts, and bonding curve intelligence.
-- **DEX Trade Stream**: Real-time WebSocket stream of ALL Solana DEX trades across 9 programs (Ultra only). Filter by token, wallet, program, trade size, or direction.
-- **Wallet Tracker**: Track up to 100 Solana wallets for real-time swap and transfer events. Webhooks + WebSocket (ULTRA) delivery.
-- **Webhooks**: Push notifications for KOL trades, deployer alerts, coordination signals, and wallet tracker events (Pro/Ultra).
-- **Tool Directory**: Search and browse 950+ Solana tools and dApps.
-
-## Installation
-
-```
-npm install madeonsol
-```
-
-## Authentication
-
-Get a free API key at: https://madeonsol.com/pricing
-
-```typescript
-import { MadeOnSol } from "madeonsol";
-const client = new MadeOnSol({ apiKey: "msk_your_api_key_here" });
-```
-
-## Available Methods
-
-### KOL Tracker (client.kol)
-- `client.kol.feed(params?)` - Live KOL trade feed (buy/sell, filter by wallet)
-- `client.kol.leaderboard(params?)` - PnL leaderboard (today, 7d, 30d, 90d, 180d). Per-entry: `median_hold_minutes_30d`, `percentile_early_entry_30d`.
-- `client.kol.wallet(wallet, params?)` - Single KOL wallet profile + PnL breakdown
-- `client.kol.coordination(params?)` - Detect coordinated KOL buying (pump signals)
-- `client.kol.token(mint)` - KOL activity for a specific token
-- `client.kol.pnl(wallet, params?)` - Deep per-wallet PnL: equity curve, profit factor, drawdown, positions (7d/30d/90d/180d)
-- `client.kol.trendingTokens(params?)` - Tokens ranked by KOL buy volume (5m–12h windows)
-- `client.kol.pairs(params?)` - KOL affinity pairs — which KOLs co-trade the same tokens
-- `client.kol.timing(wallet, params?)` - Entry/exit timing profile (hold duration, activity hours)
-- `client.kol.hotTokens(params?)` - Tokens with accelerating KOL buy interest
-
-### Deployer Hunter (client.deployer)
-- `client.deployer.stats()` - Global deployer statistics
-- `client.deployer.leaderboard(params?)` - Deployers ranked by bonding rate
-- `client.deployer.profile(wallet)` - Single deployer profile
-- `client.deployer.tokens(wallet, params?)` - Tokens deployed by a wallet
-- `client.deployer.alerts(params?)` - Real-time deploy alerts
-- `client.deployer.alertStats(params?)` - Alert statistics by tier
-- `client.deployer.bestTokens(params?)` - Top tokens by peak market cap
-- `client.deployer.recentBonds(params?)` - Recently bonded tokens
-
-### Token Intelligence (client.token)
-- `client.token.get(mint)` - Per-mint snapshot: price, MC, volume, deployer rep, KOL activity, blacklist flags, velocity windows (5m/15m/1h/2h/4h with mc_change_pct + volume_usd + mev_volume_pct), is_blacklisted, history_age_seconds, `liquidity_to_mc_ratio` (liquidity_usd ÷ market_cap depth gauge), `launch_cohort_sol` (total SOL from first-20 buyers), `launch_cohort_size` (0–20). Invalid mints return structured 400 with code/reason/example/docs.
-- `client.token.batch(mints)` - Batch lookup up to 50 mints (same shape as get(), 10-20x cheaper). Includes `liquidity_to_mc_ratio`, `launch_cohort_sol`, `launch_cohort_size`.
-- `client.token.list(params?)` - **v1.7 / PRO+** filtered token directory. Server-side filters: min_mc, max_mc, min_liq (default 2000), active_h, primary_dex, authority_revoked, exclude_token2022, min_lp_burnt_pct. Computed post-filters (over-fetches 3x): min_volume_1h_usd, max_mev_share_pct, mc_change_1h_min_pct, mc_change_1h_max_pct, `min_liq_mc_ratio`, `max_liq_mc_ratio`, `deployer_tier` (elite|good|moderate|rising|cold|unranked). Sort: mc_desc/mc_asc/last_trade_desc/liquidity_desc/cumulative_volume_desc. Returns tokens[] with mev_share_pct + organic_volume_1h_usd + mc_change_1h_pct + `liquidity_to_mc_ratio` + `deployer_tier`.
-- `client.token.batchBuyerQuality(mints)` - Batch buyer-quality scoring (shares LRU cache with alpha.buyerQuality)
-- `client.token.batchRisk(mints)` - **v2.17 / PRO+** Batch token risk scoring for up to 50 mints in one request (counts as 1 against quota). Each item is the same shape as `alpha.risk(mint)` (band/factors/inputs/score_version/as_of). Untracked mints return `{ mint, error: "not_tracked" }` without failing the batch. Returns `{ tokens, count }` in de-duplicated input order.
-- `client.alpha.risk(mint)` - **v2.13 / PRO+** Transparent 0–100 token rug-risk score (higher = riskier). Returns `band` (safe/caution/danger), explainable `factors[]` (key/label/status/points/detail), and raw `inputs` (mint_authority_revoked, freeze_authority_revoked, liquidity_usd, liquidity_to_mc_ratio, transfer_fee_bps, is_token_2022, burn_detected, launch_cohort_sol, launch_cohort_size, deployer_bonding_rate, deployer_total_deployed, kol_signal, is_blacklisted), plus `score_version` + `as_of`.
-
-### Account (client.me) — all tiers
-- `client.me()` - **v1.7** Self-inspect quota and feature usage. Returns tier, subscription block (status, billing_cycle, current_period_end), quota.daily (limit/used/remaining/resets_at), quota.burst (limit/used/remaining/window_seconds), and features (webhooks, copytrade_wallets, copytrade_rules, coordination_rules, first_touch_subscriptions, ws_connections, dex_connections, wallet_tracker_watchlist). Use for self-throttling without parsing rate-limit headers.
-
-### Signal Performance
-- `client.getSignalPerformance(name)` - Signal performance stats for a named signal (e.g. `'dump_cluster_count'`, `'runner_rate'`): hit rate by bucket, lift over base, sample size, confidence window. Use to weight signals programmatically.
-
-### Tool Directory (client.tools)
-- `client.tools.search(params?)` - Search 950+ Solana tools (full-text + category filter)
-
-### WebSocket Streaming (client.stream) — Pro/Ultra
-- `client.stream.getToken()` - Get 24h WebSocket token. Returns ws_url (KOL/deployer events) and dex_ws_url (all-DEX trades, Ultra only)
-- `client.stream.sessions()` - **v2.17 / PRO+** List your live WebSocket sessions across ws-streaming + dex-stream. Each: id, service, tier, channels[], connected_at, remote_ip, messages_sent. Returns `{ sessions, count }`.
-- `client.stream.deleteSession(id)` - **v2.17 / PRO+** Force-close (evict) a live session by id to free a connection slot held by a ghost socket. Returns `{ evicted: true, id }`; 404 if no live session with that id, 400 if id is not a positive integer.
-
-### Wallet Tracker (client.walletTracker)
-- `client.walletTracker.watchlist()` - List tracked wallets with labels and remaining capacity (BASIC: 10, PRO: 50, ULTRA: 100)
-- `client.walletTracker.addToWatchlist(params)` - Add a wallet (wallet_address, label?). Returns 409 if already tracked or limit reached.
-- `client.walletTracker.removeFromWatchlist(address)` - Remove a wallet
-- `client.walletTracker.updateLabel(address, params)` - Update a wallet's label (label: string | null)
-- `client.walletTracker.trades(params?)` - Historical swap/transfer events (wallet, action, event_type, limit max 200, before cursor)
-- `client.walletTracker.summary(params?)` - Per-wallet stats: swap counts, SOL bought/sold, last activity (period: 24h/7d/30d)
-
-### Webhooks (client.webhooks) — Pro/Ultra
-- `client.webhooks.list()` - List all webhooks
-- `client.webhooks.create(params)` - Create webhook (url, events, filters)
-- `client.webhooks.update(id, params)` - Update webhook
-- `client.webhooks.delete(id)` - Delete webhook
-- `client.webhooks.test(id)` - Send test payload
-
-## Error Handling
-
-All methods throw `MadeOnSolError` with `.message`, `.status`, and `.body` properties.
-
-## Links
-
-- Documentation: https://madeonsol.com/api-docs
-- Website: https://madeonsol.com
-- GitHub: https://github.com/LamboPoewert/madeonsol-sdk
-- npm: https://www.npmjs.com/package/madeonsol
+# MadeOnSol SDK
+
+> Official TypeScript/JavaScript SDK for the MadeOnSol Solana API
+
+## What is MadeOnSol?
+
+MadeOnSol (https://madeonsol.com) is the largest Solana ecosystem tool directory with 950+ indexed tools and dApps. The API provides programmatic access to:
+
+- **KOL Tracker**: Real-time trade feed for 946 tracked Solana KOL (Key Opinion Leader) wallets, PnL leaderboards, coordination detection, and per-wallet profiles.
+- **Deployer Hunter**: Pump.fun deployer wallet scoring, tier-based leaderboards, deploy alerts, and bonding curve intelligence.
+- **DEX Trade Stream**: Real-time WebSocket stream of ALL Solana DEX trades across 9 programs (Ultra only). Filter by token, wallet, program, trade size, or direction.
+- **Wallet Tracker**: Track up to 100 Solana wallets for real-time swap and transfer events. Webhooks + WebSocket (ULTRA) delivery.
+- **Webhooks**: Push notifications for KOL trades, deployer alerts, coordination signals, and wallet tracker events (Pro/Ultra).
+- **Tool Directory**: Search and browse 950+ Solana tools and dApps.
+
+## Installation
+
+```
+npm install madeonsol
+```
+
+## Authentication
+
+Get a free API key at: https://madeonsol.com/pricing
+
+```typescript
+import { MadeOnSol } from "madeonsol";
+const client = new MadeOnSol({ apiKey: "msk_your_api_key_here" });
+```
+
+## Available Methods
+
+### KOL Tracker (client.kol)
+- `client.kol.feed(params?)` - Live KOL trade feed (buy/sell, filter by wallet)
+- `client.kol.leaderboard(params?)` - PnL leaderboard (today, 7d, 30d, 90d, 180d). Per-entry: `median_hold_minutes_30d`, `percentile_early_entry_30d`.
+- `client.kol.wallet(wallet, params?)` - Single KOL wallet profile + PnL breakdown
+- `client.kol.coordination(params?)` - Detect coordinated KOL buying (pump signals)
+- `client.kol.token(mint)` - KOL activity for a specific token
+- `client.kol.pnl(wallet, params?)` - Deep per-wallet PnL: equity curve, profit factor, drawdown, positions (7d/30d/90d/180d)
+- `client.kol.trendingTokens(params?)` - Tokens ranked by KOL buy volume (5m–12h windows)
+- `client.kol.pairs(params?)` - KOL affinity pairs — which KOLs co-trade the same tokens
+- `client.kol.timing(wallet, params?)` - Entry/exit timing profile (hold duration, activity hours)
+- `client.kol.hotTokens(params?)` - Tokens with accelerating KOL buy interest
+
+### Deployer Hunter (client.deployer)
+- `client.deployer.stats()` - Global deployer statistics
+- `client.deployer.leaderboard(params?)` - Deployers ranked by bonding rate
+- `client.deployer.profile(wallet)` - Single deployer profile
+- `client.deployer.tokens(wallet, params?)` - Tokens deployed by a wallet
+- `client.deployer.alerts(params?)` - Real-time deploy alerts
+- `client.deployer.alertStats(params?)` - Alert statistics by tier
+- `client.deployer.bestTokens(params?)` - Top tokens by peak market cap
+- `client.deployer.recentBonds(params?)` - Recently bonded tokens
+
+### Token Intelligence (client.token)
+- `client.token.get(mint)` - Per-mint snapshot: price, MC, volume, deployer rep, KOL activity, blacklist flags, velocity windows (5m/15m/1h/2h/4h with mc_change_pct + volume_usd + mev_volume_pct), is_blacklisted, history_age_seconds, `liquidity_to_mc_ratio` (liquidity_usd ÷ market_cap depth gauge), `launch_cohort_sol` (total SOL from first-20 buyers), `launch_cohort_size` (0–20). Invalid mints return structured 400 with code/reason/example/docs.
+- `client.token.batch(mints)` - Batch lookup up to 50 mints (same shape as get(), 10-20x cheaper). Includes `liquidity_to_mc_ratio`, `launch_cohort_sol`, `launch_cohort_size`.
+- `client.token.list(params?)` - **v1.7 / PRO+** filtered token directory. Server-side filters: min_mc, max_mc, min_liq (default 2000), active_h, primary_dex, authority_revoked, exclude_token2022, min_lp_burnt_pct. Computed post-filters (over-fetches 3x): min_volume_1h_usd, max_mev_share_pct, mc_change_1h_min_pct, mc_change_1h_max_pct, `min_liq_mc_ratio`, `max_liq_mc_ratio`, `deployer_tier` (elite|good|moderate|rising|cold|unranked). Sort: mc_desc/mc_asc/last_trade_desc/liquidity_desc/cumulative_volume_desc. Returns tokens[] with mev_share_pct + organic_volume_1h_usd + mc_change_1h_pct + `liquidity_to_mc_ratio` + `deployer_tier`.
+- `client.token.batchBuyerQuality(mints)` - Batch buyer-quality scoring (shares LRU cache with alpha.buyerQuality)
+- `client.token.batchRisk(mints)` - **v2.17 / PRO+** Batch token risk scoring for up to 50 mints in one request (counts as 1 against quota). Each item is the same shape as `alpha.risk(mint)` (band/factors/inputs/score_version/as_of). Untracked mints return `{ mint, error: "not_tracked" }` without failing the batch. Returns `{ tokens, count }` in de-duplicated input order.
+- `client.alpha.risk(mint)` - **v2.13 / PRO+** Transparent 0–100 token rug-risk score (higher = riskier). Returns `band` (safe/caution/danger), explainable `factors[]` (key/label/status/points/detail), and raw `inputs` (mint_authority_revoked, freeze_authority_revoked, liquidity_usd, liquidity_to_mc_ratio, transfer_fee_bps, is_token_2022, burn_detected, launch_cohort_sol, launch_cohort_size, deployer_bonding_rate, deployer_total_deployed, kol_signal, is_blacklisted), plus `score_version` + `as_of`.
+- `client.alpha.bundle(mint)` - **v2.18** `GET /tokens/{mint}/bundle`. Bundle-cohort holdings — wallets that bought together (atomic tx or same slot) and how much of supply they still hold. `bundle` summary (all tiers): `held_pct_of_supply` (0–1 of supply, HEADLINE), `bundle_kind` (atomic_tx/same_slot/none), `wallet_count`, `held_ratio`, `fully_exited`, `buy_volume`, `tokens_held`. Tier-gated `wallets[]`: BASIC/TRADER → `[]`; PRO → top-10 flags (rank/wallet/held_ratio/has_sold/atomic/is_kol); ULTRA → full cohort + identity (kol_name/win_rate/bot_confidence) + per-wallet tokens_held.
+
+### Account (client.me) — all tiers
+- `client.me()` - **v1.7** Self-inspect quota and feature usage. Returns tier, subscription block (status, billing_cycle, current_period_end), quota.daily (limit/used/remaining/resets_at), quota.burst (limit/used/remaining/window_seconds), and features (webhooks, copytrade_wallets, copytrade_rules, coordination_rules, first_touch_subscriptions, ws_connections, dex_connections, wallet_tracker_watchlist). Use for self-throttling without parsing rate-limit headers.
+
+### Signal Performance
+- `client.getSignalPerformance(name)` - Signal performance stats for a named signal (e.g. `'dump_cluster_count'`, `'runner_rate'`): hit rate by bucket, lift over base, sample size, confidence window. Use to weight signals programmatically.
+
+### Tool Directory (client.tools)
+- `client.tools.search(params?)` - Search 950+ Solana tools (full-text + category filter)
+
+### WebSocket Streaming (client.stream) — Pro/Ultra
+- `client.stream.getToken()` - Get 24h WebSocket token. Returns ws_url (KOL/deployer events) and dex_ws_url (all-DEX trades, Ultra only)
+- `client.stream.sessions()` - **v2.17 / PRO+** List your live WebSocket sessions across ws-streaming + dex-stream. Each: id, service, tier, channels[], connected_at, remote_ip, messages_sent. Returns `{ sessions, count }`.
+- `client.stream.deleteSession(id)` - **v2.17 / PRO+** Force-close (evict) a live session by id to free a connection slot held by a ghost socket. Returns `{ evicted: true, id }`; 404 if no live session with that id, 400 if id is not a positive integer.
+
+### Wallet Tracker (client.walletTracker)
+- `client.walletTracker.watchlist()` - List tracked wallets with labels and remaining capacity (BASIC: 10, PRO: 50, ULTRA: 100)
+- `client.walletTracker.addToWatchlist(params)` - Add a wallet (wallet_address, label?). Returns 409 if already tracked or limit reached.
+- `client.walletTracker.removeFromWatchlist(address)` - Remove a wallet
+- `client.walletTracker.updateLabel(address, params)` - Update a wallet's label (label: string | null)
+- `client.walletTracker.trades(params?)` - Historical swap/transfer events (wallet, action, event_type, limit max 200, before cursor)
+- `client.walletTracker.summary(params?)` - Per-wallet stats: swap counts, SOL bought/sold, last activity (period: 24h/7d/30d)
+
+### Webhooks (client.webhooks) — Pro/Ultra
+- `client.webhooks.list()` - List all webhooks
+- `client.webhooks.create(params)` - Create webhook (url, events, filters)
+- `client.webhooks.update(id, params)` - Update webhook
+- `client.webhooks.delete(id)` - Delete webhook
+- `client.webhooks.test(id)` - Send test payload
+
+## Error Handling
+
+All methods throw `MadeOnSolError` with `.message`, `.status`, and `.body` properties.
+
+## Links
+
+- Documentation: https://madeonsol.com/api-docs
+- Website: https://madeonsol.com
+- GitHub: https://github.com/madeonsol/madeonsol-sdk
+- npm: https://www.npmjs.com/package/madeonsol

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "madeonsol",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "description": "Official SDK for the MadeOnSol Solana API — KOL wallet tracking, Pump.fun deployer intelligence, and tool directory",
   "type": "module",
   "main": "dist/index.js",
@@ -55,11 +55,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/LamboPoewert/madeonsol-sdk.git"
+    "url": "https://github.com/madeonsol/madeonsol-sdk.git"
   },
   "homepage": "https://madeonsol.com/solana-api",
   "bugs": {
-    "url": "https://github.com/LamboPoewert/madeonsol-sdk/issues"
+    "url": "https://github.com/madeonsol/madeonsol-sdk/issues"
   },
   "engines": {
     "node": ">=18"