madeonsol 1.0.0 → 1.0.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.
Files changed (4) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +377 -352
  3. package/llms.txt +60 -0
  4. package/package.json +59 -57
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 MadeOnSol
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 MadeOnSol
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,352 +1,377 @@
1
- # madeonsol
2
-
3
- [![npm version](https://img.shields.io/npm/v/madeonsol?style=flat-square)](https://www.npmjs.com/package/madeonsol)
4
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
5
-
6
- Official TypeScript/JavaScript SDK for the **MadeOnSol Solana API** — zero dependencies, fully typed, works in Node.js ≥ 18 and edge runtimes.
7
-
8
- | Feature | Description |
9
- |---|---|
10
- | **KOL Tracker** | Real-time trade feed, PnL leaderboard, coordination detection, and per-wallet profiles for 463 tracked KOL wallets |
11
- | **Deployer Hunter** | Pump.fun deployer scoring, tier leaderboard, deploy alerts, and bonding intelligence |
12
- | **Tool Directory** | Search 950+ Solana tools and dApps indexed on MadeOnSol |
13
-
14
- **Links:** [Full docs](https://madeonsol.com/api-docs) · [Website](https://madeonsol.com) · [RapidAPI listing](https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api)
15
-
16
- ---
17
-
18
- ## Install
19
-
20
- ```bash
21
- npm install madeonsol
22
- # or
23
- yarn add madeonsol
24
- # or
25
- pnpm add madeonsol
26
- ```
27
-
28
- Requires **Node.js ≥ 18** (uses native `fetch`). Works out of the box in Cloudflare Workers, Vercel Edge, and Bun.
29
-
30
- ---
31
-
32
- ## Quick start
33
-
34
- ```ts
35
- import { MadeOnSol } from "madeonsol";
36
-
37
- const client = new MadeOnSol({ apiKey: "your-rapidapi-key" });
38
-
39
- // Latest KOL buy trades
40
- const { trades } = await client.kol.feed({ limit: 10, action: "buy" });
41
- console.log(trades[0].kol_name, "bought", trades[0].token_symbol);
42
-
43
- // Elite deployer leaderboard
44
- const { deployers } = await client.deployer.leaderboard({ tier: "elite" });
45
-
46
- // Recent deploy alerts
47
- const { alerts } = await client.deployer.alerts({ limit: 5 });
48
-
49
- // Search Solana tools
50
- const { tools } = await client.tools.search({ q: "trading", limit: 10 });
51
- ```
52
-
53
- Get your API key at [RapidAPI](https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api).
54
-
55
- ---
56
-
57
- ## API Reference
58
-
59
- ### KOL Tracker — `client.kol`
60
-
61
- #### `client.kol.feed(params?)`
62
-
63
- Live feed of trades made by tracked KOL wallets.
64
-
65
- ```ts
66
- const { trades, count } = await client.kol.feed({
67
- limit: 50, // 1–100, default 50
68
- action: "buy", // "buy" | "sell"
69
- kol: "7xKX...", // filter by specific wallet
70
- });
71
- ```
72
-
73
- Returns: `KolFeedResponse` — `{ trades: KolTrade[], count: number }`
74
-
75
- ---
76
-
77
- #### `client.kol.leaderboard(params?)`
78
-
79
- KOL PnL leaderboard ranked by realized profit.
80
-
81
- ```ts
82
- const { leaderboard, period } = await client.kol.leaderboard({
83
- period: "7d", // "today" | "7d" | "30d", default "7d"
84
- });
85
- ```
86
-
87
- Returns: `KolLeaderboardResponse`
88
-
89
- ---
90
-
91
- #### `client.kol.wallet(wallet, params?)`
92
-
93
- Full profile for a single KOL wallet, including trade history and optional per-token PnL breakdown.
94
-
95
- ```ts
96
- const profile = await client.kol.wallet("7xKX...", {
97
- include: "pnl_by_token",
98
- });
99
- ```
100
-
101
- Returns: `KolWalletProfile`
102
-
103
- ---
104
-
105
- #### `client.kol.coordination(params?)`
106
-
107
- Detect tokens where multiple KOLs are buying simultaneously — a strong signal of coordinated pumps.
108
-
109
- ```ts
110
- const { tokens } = await client.kol.coordination({
111
- period: "24h", // "1h" | "6h" | "24h" | "7d", default "24h"
112
- min_kols: 3, // 2–50, default 3
113
- limit: 20, // 1–50, default 20
114
- });
115
- ```
116
-
117
- Returns: `KolCoordinationResponse`
118
-
119
- ---
120
-
121
- #### `client.kol.token(mint)`
122
-
123
- KOL buy/sell activity for a specific token mint.
124
-
125
- ```ts
126
- const activity = await client.kol.token("EPjFW...");
127
- ```
128
-
129
- Returns: `KolTokenActivity`
130
-
131
- ---
132
-
133
- ### Deployer Hunter — `client.deployer`
134
-
135
- #### `client.deployer.stats()`
136
-
137
- Global statistics across all tracked deployer wallets.
138
-
139
- ```ts
140
- const stats = await client.deployer.stats();
141
- console.log(stats.overall_bonding_rate); // e.g. 0.043
142
- ```
143
-
144
- Returns: `DeployerStats`
145
-
146
- ---
147
-
148
- #### `client.deployer.leaderboard(params?)`
149
-
150
- Deployers ranked by bonding rate or recent performance.
151
-
152
- ```ts
153
- const { deployers } = await client.deployer.leaderboard({
154
- tier: "elite", // "elite" | "good" | "moderate" | "rising" | "cold"
155
- sort: "bonding_rate", // "bonding_rate" | "recent_bond_rate" | "total_bonded" | "last_deploy_at"
156
- limit: 20, // 1–50, default 20
157
- offset: 0,
158
- });
159
- ```
160
-
161
- Returns: `DeployerLeaderboardResponse`
162
-
163
- ---
164
-
165
- #### `client.deployer.profile(wallet)`
166
-
167
- Full profile for a single deployer wallet.
168
-
169
- ```ts
170
- const deployer = await client.deployer.profile("3xAB...");
171
- console.log(deployer.tier, deployer.bonding_rate);
172
- ```
173
-
174
- Returns: `DeployerProfile`
175
-
176
- ---
177
-
178
- #### `client.deployer.tokens(wallet, params?)`
179
-
180
- All tokens deployed by a specific wallet.
181
-
182
- ```ts
183
- const { tokens } = await client.deployer.tokens("3xAB...", {
184
- limit: 20,
185
- offset: 0,
186
- });
187
- ```
188
-
189
- Returns: `DeployerTokensResponse`
190
-
191
- ---
192
-
193
- #### `client.deployer.alerts(params?)`
194
-
195
- Real-time deploy alerts — fired when a tracked deployer launches a new token.
196
-
197
- ```ts
198
- const { alerts } = await client.deployer.alerts({
199
- since: "2025-01-01T00:00:00Z", // ISO 8601
200
- limit: 20,
201
- offset: 0,
202
- });
203
- ```
204
-
205
- Returns: `DeployerAlertsResponse`
206
-
207
- ---
208
-
209
- #### `client.deployer.alertStats(params?)`
210
-
211
- Aggregated alert statistics by tier.
212
-
213
- ```ts
214
- const stats = await client.deployer.alertStats({ period: "7d" });
215
- // "7d" | "30d" | "all", default "all"
216
- ```
217
-
218
- Returns: `DeployerAlertStats`
219
-
220
- ---
221
-
222
- #### `client.deployer.bestTokens(params?)`
223
-
224
- Top-performing tokens from tracked deployers by peak market cap.
225
-
226
- ```ts
227
- const { tokens } = await client.deployer.bestTokens({
228
- period: "7d", // "7d" | "30d" | "all", default "7d"
229
- limit: 5, // 1–20, default 5
230
- });
231
- ```
232
-
233
- Returns: `BestTokensResponse`
234
-
235
- ---
236
-
237
- #### `client.deployer.recentBonds(params?)`
238
-
239
- Most recently bonded tokens from tracked deployers.
240
-
241
- ```ts
242
- const { bonds } = await client.deployer.recentBonds({ limit: 20 });
243
- ```
244
-
245
- Returns: `RecentBondsResponse`
246
-
247
- ---
248
-
249
- ### Tool Directory — `client.tools`
250
-
251
- #### `client.tools.search(params?)`
252
-
253
- Search 950+ Solana tools indexed on MadeOnSol.
254
-
255
- ```ts
256
- const { tools, count } = await client.tools.search({
257
- q: "trading bot", // full-text search
258
- category: "trading", // category slug filter
259
- limit: 20, // 1–50, default 20
260
- });
261
- ```
262
-
263
- Returns: `ToolsSearchResponse`
264
-
265
- ---
266
-
267
- ## Error handling
268
-
269
- All methods throw `MadeOnSolError` on non-2xx responses.
270
-
271
- ```ts
272
- import { MadeOnSol, MadeOnSolError } from "madeonsol";
273
-
274
- try {
275
- const profile = await client.kol.wallet("invalid-wallet");
276
- } catch (err) {
277
- if (err instanceof MadeOnSolError) {
278
- console.error(err.message); // human-readable message
279
- console.error(err.status); // HTTP status code, e.g. 404
280
- console.error(err.body); // raw response body
281
- }
282
- }
283
- ```
284
-
285
- ---
286
-
287
- ## Exported types
288
-
289
- All types are exported from the main entry point:
290
-
291
- ```ts
292
- import type {
293
- // Errors
294
- MadeOnSolError,
295
-
296
- // KOL
297
- KolTrade,
298
- KolFeedParams,
299
- KolFeedResponse,
300
- KolLeaderboardParams,
301
- KolLeaderboardResponse,
302
- KolLeaderboardEntry,
303
- KolWalletParams,
304
- KolWalletProfile,
305
- KolCoordinationParams,
306
- KolCoordinationResponse,
307
- CoordinatedToken,
308
- KolTokenActivity,
309
- KolPnlByToken,
310
-
311
- // Deployer
312
- DeployerStats,
313
- DeployerLeaderboardParams,
314
- DeployerLeaderboardResponse,
315
- DeployerLeaderboardEntry,
316
- DeployerProfile,
317
- DeployerToken,
318
- DeployerTokensParams,
319
- DeployerTokensResponse,
320
- DeployerAlertsParams,
321
- DeployerAlertsResponse,
322
- DeployerAlert,
323
- DeployerAlertStatsParams,
324
- DeployerAlertStats,
325
- BestTokensParams,
326
- BestTokensResponse,
327
- BestToken,
328
- RecentBondsParams,
329
- RecentBondsResponse,
330
- RecentBond,
331
-
332
- // Tools
333
- ToolsSearchParams,
334
- ToolsSearchResponse,
335
- Tool,
336
-
337
- // Enums / unions
338
- KolAction,
339
- LeaderboardPeriod,
340
- CoordinationPeriod,
341
- DeployerTier,
342
- DeployerSortField,
343
- AlertPeriod,
344
- BestTokensPeriod,
345
- } from "madeonsol";
346
- ```
347
-
348
- ---
349
-
350
- ## License
351
-
352
- MIT © [MadeOnSol](https://madeonsol.com)
1
+ # madeonsol
2
+
3
+ [![npm version](https://img.shields.io/npm/v/madeonsol?style=flat-square)](https://www.npmjs.com/package/madeonsol)
4
+ [![npm downloads](https://img.shields.io/npm/dm/madeonsol?style=flat-square)](https://www.npmjs.com/package/madeonsol)
5
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.4+-blue?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
6
+ [![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen?style=flat-square)](package.json)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
8
+
9
+ Official TypeScript/JavaScript SDK for the **[MadeOnSol](https://madeonsol.com) Solana API** — zero dependencies, fully typed, works in Node.js ≥ 18 and edge runtimes.
10
+
11
+ > **Build Solana trading bots, analytics dashboards, KOL copy-trading tools, deployer sniper bots, and ecosystem browsers.**
12
+
13
+ | Feature | Description |
14
+ |---|---|
15
+ | **KOL Tracker** | Real-time trade feed, PnL leaderboard, coordination detection, and per-wallet profiles for 463 tracked KOL wallets |
16
+ | **Deployer Hunter** | Pump.fun deployer scoring, tier leaderboard, deploy alerts, and bonding intelligence |
17
+ | **Tool Directory** | Search 950+ Solana tools and dApps indexed on MadeOnSol |
18
+
19
+ **Links:** [Full API docs](https://madeonsol.com/solana-api) · [Website](https://madeonsol.com) · [RapidAPI listing](https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api)
20
+
21
+ ---
22
+
23
+ ## Install
24
+
25
+ ```bash
26
+ npm install madeonsol
27
+ # or
28
+ yarn add madeonsol
29
+ # or
30
+ pnpm add madeonsol
31
+ ```
32
+
33
+ Requires **Node.js ≥ 18** (uses native `fetch`). Works out of the box in Cloudflare Workers, Vercel Edge, and Bun.
34
+
35
+ ---
36
+
37
+ ## Quick start
38
+
39
+ ```ts
40
+ import { MadeOnSol } from "madeonsol";
41
+
42
+ const client = new MadeOnSol({ apiKey: "your-rapidapi-key" });
43
+
44
+ // Latest KOL buy trades
45
+ const { trades } = await client.kol.feed({ limit: 10, action: "buy" });
46
+ console.log(trades[0].kol_name, "bought", trades[0].token_symbol);
47
+
48
+ // Elite deployer leaderboard
49
+ const { deployers } = await client.deployer.leaderboard({ tier: "elite" });
50
+
51
+ // Recent deploy alerts
52
+ const { alerts } = await client.deployer.alerts({ limit: 5 });
53
+
54
+ // Search Solana tools
55
+ const { tools } = await client.tools.search({ q: "trading", limit: 10 });
56
+ ```
57
+
58
+ Get your API key at [RapidAPI](https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api).
59
+
60
+ ---
61
+
62
+ ## Use cases
63
+
64
+ - **Copy-trading bot** — stream KOL buys via `client.kol.feed()` and mirror trades
65
+ - **Deployer sniper** — monitor `client.deployer.alerts()` for elite-tier launches
66
+ - **Coordination detector** flag tokens with `client.kol.coordination({ min_kols: 3 })`
67
+ - **Analytics dashboard** — combine leaderboard, PnL, and tool data
68
+ - **Telegram/Discord bot** pipe alerts into chat with formatted messages
69
+ - **Portfolio tracker** use `client.kol.wallet()` to follow specific KOL positions
70
+
71
+ ---
72
+
73
+ ## API Reference
74
+
75
+ ### KOL Tracker — `client.kol`
76
+
77
+ #### `client.kol.feed(params?)`
78
+
79
+ Live feed of trades made by tracked KOL wallets.
80
+
81
+ ```ts
82
+ const { trades, count } = await client.kol.feed({
83
+ limit: 50, // 1–100, default 50
84
+ action: "buy", // "buy" | "sell"
85
+ kol: "7xKX...", // filter by specific wallet
86
+ });
87
+ ```
88
+
89
+ Returns: `KolFeedResponse` — `{ trades: KolTrade[], count: number }`
90
+
91
+ ---
92
+
93
+ #### `client.kol.leaderboard(params?)`
94
+
95
+ KOL PnL leaderboard ranked by realized profit.
96
+
97
+ ```ts
98
+ const { leaderboard, period } = await client.kol.leaderboard({
99
+ period: "7d", // "today" | "7d" | "30d", default "7d"
100
+ });
101
+ ```
102
+
103
+ Returns: `KolLeaderboardResponse`
104
+
105
+ ---
106
+
107
+ #### `client.kol.wallet(wallet, params?)`
108
+
109
+ Full profile for a single KOL wallet, including trade history and optional per-token PnL breakdown.
110
+
111
+ ```ts
112
+ const profile = await client.kol.wallet("7xKX...", {
113
+ include: "pnl_by_token",
114
+ });
115
+ ```
116
+
117
+ Returns: `KolWalletProfile`
118
+
119
+ ---
120
+
121
+ #### `client.kol.coordination(params?)`
122
+
123
+ Detect tokens where multiple KOLs are buying simultaneously — a strong signal of coordinated pumps.
124
+
125
+ ```ts
126
+ const { tokens } = await client.kol.coordination({
127
+ period: "24h", // "1h" | "6h" | "24h" | "7d", default "24h"
128
+ min_kols: 3, // 2–50, default 3
129
+ limit: 20, // 1–50, default 20
130
+ });
131
+ ```
132
+
133
+ Returns: `KolCoordinationResponse`
134
+
135
+ ---
136
+
137
+ #### `client.kol.token(mint)`
138
+
139
+ KOL buy/sell activity for a specific token mint.
140
+
141
+ ```ts
142
+ const activity = await client.kol.token("EPjFW...");
143
+ ```
144
+
145
+ Returns: `KolTokenActivity`
146
+
147
+ ---
148
+
149
+ ### Deployer Hunter — `client.deployer`
150
+
151
+ #### `client.deployer.stats()`
152
+
153
+ Global statistics across all tracked deployer wallets.
154
+
155
+ ```ts
156
+ const stats = await client.deployer.stats();
157
+ console.log(stats.overall_bonding_rate); // e.g. 0.043
158
+ ```
159
+
160
+ Returns: `DeployerStats`
161
+
162
+ ---
163
+
164
+ #### `client.deployer.leaderboard(params?)`
165
+
166
+ Deployers ranked by bonding rate or recent performance.
167
+
168
+ ```ts
169
+ const { deployers } = await client.deployer.leaderboard({
170
+ tier: "elite", // "elite" | "good" | "moderate" | "rising" | "cold"
171
+ sort: "bonding_rate", // "bonding_rate" | "recent_bond_rate" | "total_bonded" | "last_deploy_at"
172
+ limit: 20, // 1–50, default 20
173
+ offset: 0,
174
+ });
175
+ ```
176
+
177
+ Returns: `DeployerLeaderboardResponse`
178
+
179
+ ---
180
+
181
+ #### `client.deployer.profile(wallet)`
182
+
183
+ Full profile for a single deployer wallet.
184
+
185
+ ```ts
186
+ const deployer = await client.deployer.profile("3xAB...");
187
+ console.log(deployer.tier, deployer.bonding_rate);
188
+ ```
189
+
190
+ Returns: `DeployerProfile`
191
+
192
+ ---
193
+
194
+ #### `client.deployer.tokens(wallet, params?)`
195
+
196
+ All tokens deployed by a specific wallet.
197
+
198
+ ```ts
199
+ const { tokens } = await client.deployer.tokens("3xAB...", {
200
+ limit: 20,
201
+ offset: 0,
202
+ });
203
+ ```
204
+
205
+ Returns: `DeployerTokensResponse`
206
+
207
+ ---
208
+
209
+ #### `client.deployer.alerts(params?)`
210
+
211
+ Real-time deploy alerts fired when a tracked deployer launches a new token.
212
+
213
+ ```ts
214
+ const { alerts } = await client.deployer.alerts({
215
+ since: "2025-01-01T00:00:00Z", // ISO 8601
216
+ limit: 20,
217
+ offset: 0,
218
+ });
219
+ ```
220
+
221
+ Returns: `DeployerAlertsResponse`
222
+
223
+ ---
224
+
225
+ #### `client.deployer.alertStats(params?)`
226
+
227
+ Aggregated alert statistics by tier.
228
+
229
+ ```ts
230
+ const stats = await client.deployer.alertStats({ period: "7d" });
231
+ // "7d" | "30d" | "all", default "all"
232
+ ```
233
+
234
+ Returns: `DeployerAlertStats`
235
+
236
+ ---
237
+
238
+ #### `client.deployer.bestTokens(params?)`
239
+
240
+ Top-performing tokens from tracked deployers by peak market cap.
241
+
242
+ ```ts
243
+ const { tokens } = await client.deployer.bestTokens({
244
+ period: "7d", // "7d" | "30d" | "all", default "7d"
245
+ limit: 5, // 1–20, default 5
246
+ });
247
+ ```
248
+
249
+ Returns: `BestTokensResponse`
250
+
251
+ ---
252
+
253
+ #### `client.deployer.recentBonds(params?)`
254
+
255
+ Most recently bonded tokens from tracked deployers.
256
+
257
+ ```ts
258
+ const { bonds } = await client.deployer.recentBonds({ limit: 20 });
259
+ ```
260
+
261
+ Returns: `RecentBondsResponse`
262
+
263
+ ---
264
+
265
+ ### Tool Directory — `client.tools`
266
+
267
+ #### `client.tools.search(params?)`
268
+
269
+ Search 950+ Solana tools indexed on MadeOnSol.
270
+
271
+ ```ts
272
+ const { tools, count } = await client.tools.search({
273
+ q: "trading bot", // full-text search
274
+ category: "trading", // category slug filter
275
+ limit: 20, // 1–50, default 20
276
+ });
277
+ ```
278
+
279
+ Returns: `ToolsSearchResponse`
280
+
281
+ ---
282
+
283
+ ## Error handling
284
+
285
+ All methods throw `MadeOnSolError` on non-2xx responses.
286
+
287
+ ```ts
288
+ import { MadeOnSol, MadeOnSolError } from "madeonsol";
289
+
290
+ try {
291
+ const profile = await client.kol.wallet("invalid-wallet");
292
+ } catch (err) {
293
+ if (err instanceof MadeOnSolError) {
294
+ console.error(err.message); // human-readable message
295
+ console.error(err.status); // HTTP status code, e.g. 404
296
+ console.error(err.body); // raw response body
297
+ }
298
+ }
299
+ ```
300
+
301
+ ---
302
+
303
+ ## Exported types
304
+
305
+ All types are exported from the main entry point:
306
+
307
+ ```ts
308
+ import type {
309
+ // Errors
310
+ MadeOnSolError,
311
+
312
+ // KOL
313
+ KolTrade,
314
+ KolFeedParams,
315
+ KolFeedResponse,
316
+ KolLeaderboardParams,
317
+ KolLeaderboardResponse,
318
+ KolLeaderboardEntry,
319
+ KolWalletParams,
320
+ KolWalletProfile,
321
+ KolCoordinationParams,
322
+ KolCoordinationResponse,
323
+ CoordinatedToken,
324
+ KolTokenActivity,
325
+ KolPnlByToken,
326
+
327
+ // Deployer
328
+ DeployerStats,
329
+ DeployerLeaderboardParams,
330
+ DeployerLeaderboardResponse,
331
+ DeployerLeaderboardEntry,
332
+ DeployerProfile,
333
+ DeployerToken,
334
+ DeployerTokensParams,
335
+ DeployerTokensResponse,
336
+ DeployerAlertsParams,
337
+ DeployerAlertsResponse,
338
+ DeployerAlert,
339
+ DeployerAlertStatsParams,
340
+ DeployerAlertStats,
341
+ BestTokensParams,
342
+ BestTokensResponse,
343
+ BestToken,
344
+ RecentBondsParams,
345
+ RecentBondsResponse,
346
+ RecentBond,
347
+
348
+ // Tools
349
+ ToolsSearchParams,
350
+ ToolsSearchResponse,
351
+ Tool,
352
+
353
+ // Enums / unions
354
+ KolAction,
355
+ LeaderboardPeriod,
356
+ CoordinationPeriod,
357
+ DeployerTier,
358
+ DeployerSortField,
359
+ AlertPeriod,
360
+ BestTokensPeriod,
361
+ } from "madeonsol";
362
+ ```
363
+
364
+ ---
365
+
366
+ ## Related
367
+
368
+ - [MadeOnSol website](https://madeonsol.com) — Browse 950+ Solana tools
369
+ - [API documentation](https://madeonsol.com/solana-api) — Interactive endpoint reference
370
+ - [RapidAPI listing](https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api) — Subscribe and get your API key
371
+ - [MadeOnSol on GitHub](https://github.com/LamboPoewert/madeonsol) — Main project repository
372
+
373
+ ---
374
+
375
+ ## License
376
+
377
+ MIT © [MadeOnSol](https://madeonsol.com)
package/llms.txt ADDED
@@ -0,0 +1,60 @@
1
+ # MadeOnSol SDK
2
+
3
+ > Official TypeScript/JavaScript SDK for the MadeOnSol Solana API
4
+
5
+ ## What is MadeOnSol?
6
+
7
+ MadeOnSol (https://madeonsol.com) is the largest Solana ecosystem tool directory with 950+ indexed tools and dApps. The API provides programmatic access to:
8
+
9
+ - **KOL Tracker**: Real-time trade feed for 463+ tracked Solana KOL (Key Opinion Leader) wallets, PnL leaderboards, coordination detection, and per-wallet profiles.
10
+ - **Deployer Hunter**: Pump.fun deployer wallet scoring, tier-based leaderboards, deploy alerts, and bonding curve intelligence.
11
+ - **Tool Directory**: Search and browse 950+ Solana tools and dApps.
12
+
13
+ ## Installation
14
+
15
+ ```
16
+ npm install madeonsol
17
+ ```
18
+
19
+ ## Authentication
20
+
21
+ Get your API key at: https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api
22
+
23
+ ```typescript
24
+ import { MadeOnSol } from "madeonsol";
25
+ const client = new MadeOnSol({ apiKey: "your-rapidapi-key" });
26
+ ```
27
+
28
+ ## Available Methods
29
+
30
+ ### KOL Tracker (client.kol)
31
+ - `client.kol.feed(params?)` - Live KOL trade feed (buy/sell, filter by wallet)
32
+ - `client.kol.leaderboard(params?)` - PnL leaderboard (today, 7d, 30d)
33
+ - `client.kol.wallet(wallet, params?)` - Single KOL wallet profile + PnL breakdown
34
+ - `client.kol.coordination(params?)` - Detect coordinated KOL buying (pump signals)
35
+ - `client.kol.token(mint)` - KOL activity for a specific token
36
+
37
+ ### Deployer Hunter (client.deployer)
38
+ - `client.deployer.stats()` - Global deployer statistics
39
+ - `client.deployer.leaderboard(params?)` - Deployers ranked by bonding rate
40
+ - `client.deployer.profile(wallet)` - Single deployer profile
41
+ - `client.deployer.tokens(wallet, params?)` - Tokens deployed by a wallet
42
+ - `client.deployer.alerts(params?)` - Real-time deploy alerts
43
+ - `client.deployer.alertStats(params?)` - Alert statistics by tier
44
+ - `client.deployer.bestTokens(params?)` - Top tokens by peak market cap
45
+ - `client.deployer.recentBonds(params?)` - Recently bonded tokens
46
+
47
+ ### Tool Directory (client.tools)
48
+ - `client.tools.search(params?)` - Search 950+ Solana tools (full-text + category filter)
49
+
50
+ ## Error Handling
51
+
52
+ All methods throw `MadeOnSolError` with `.message`, `.status`, and `.body` properties.
53
+
54
+ ## Links
55
+
56
+ - Documentation: https://madeonsol.com/solana-api
57
+ - Website: https://madeonsol.com
58
+ - RapidAPI: https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api
59
+ - GitHub: https://github.com/LamboPoewert/madeonsol-sdk
60
+ - npm: https://www.npmjs.com/package/madeonsol
package/package.json CHANGED
@@ -1,57 +1,59 @@
1
- {
2
- "name": "madeonsol",
3
- "version": "1.0.0",
4
- "description": "Official SDK for the MadeOnSol Solana API KOL wallet tracking, Pump.fun deployer intelligence, and tool directory",
5
- "type": "module",
6
- "main": "dist/index.js",
7
- "types": "dist/index.d.ts",
8
- "exports": {
9
- ".": {
10
- "types": "./dist/index.d.ts",
11
- "default": "./dist/index.js"
12
- }
13
- },
14
- "files": [
15
- "dist"
16
- ],
17
- "scripts": {
18
- "build": "tsc"
19
- },
20
- "keywords": [
21
- "solana",
22
- "api",
23
- "sdk",
24
- "kol",
25
- "kol-tracker",
26
- "trading",
27
- "pump.fun",
28
- "pumpfun",
29
- "deployer",
30
- "deployer-hunter",
31
- "wallet-tracking",
32
- "defi",
33
- "web3",
34
- "blockchain",
35
- "solana-tools",
36
- "token",
37
- "madeonsol",
38
- "rapidapi",
39
- "bonding-curve",
40
- "smart-money"
41
- ],
42
- "license": "MIT",
43
- "repository": {
44
- "type": "git",
45
- "url": "https://github.com/LamboPoewert/madeonsol-sdk.git"
46
- },
47
- "homepage": "https://madeonsol.com/solana-api",
48
- "bugs": {
49
- "url": "https://github.com/LamboPoewert/madeonsol-sdk/issues"
50
- },
51
- "engines": {
52
- "node": ">=18"
53
- },
54
- "devDependencies": {
55
- "typescript": "^5.4.0"
56
- }
57
- }
1
+ {
2
+ "name": "madeonsol",
3
+ "version": "1.0.1",
4
+ "description": "Official SDK for the MadeOnSol Solana API — KOL wallet tracking, Pump.fun deployer intelligence, and tool directory",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "types": "./dist/index.d.ts",
11
+ "default": "./dist/index.js"
12
+ }
13
+ },
14
+ "files": [
15
+ "dist",
16
+ "llms.txt"
17
+ ],
18
+ "scripts": {
19
+ "build": "tsc"
20
+ },
21
+ "keywords": [
22
+ "solana",
23
+ "api",
24
+ "sdk",
25
+ "kol",
26
+ "kol-tracker",
27
+ "trading",
28
+ "pump.fun",
29
+ "pumpfun",
30
+ "deployer",
31
+ "deployer-hunter",
32
+ "wallet-tracking",
33
+ "defi",
34
+ "web3",
35
+ "blockchain",
36
+ "solana-tools",
37
+ "token",
38
+ "madeonsol",
39
+ "rapidapi",
40
+ "bonding-curve",
41
+ "smart-money"
42
+ ],
43
+ "license": "MIT",
44
+ "repository": {
45
+ "type": "git",
46
+ "url": "https://github.com/LamboPoewert/madeonsol-sdk.git"
47
+ },
48
+ "homepage": "https://madeonsol.com/solana-api",
49
+ "bugs": {
50
+ "url": "https://github.com/LamboPoewert/madeonsol-sdk/issues"
51
+ },
52
+ "engines": {
53
+ "node": ">=18"
54
+ },
55
+ "devDependencies": {
56
+ "typescript": "^5.4.0"
57
+ },
58
+ "funding": "https://madeonsol.com"
59
+ }