madeonsol 1.0.1 → 1.2.0
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.
- package/LICENSE +21 -21
- package/README.md +363 -377
- package/dist/index.d.ts +21 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +49 -31
- package/dist/index.js.map +1 -1
- package/package.json +57 -59
- package/llms.txt +0 -60
package/README.md
CHANGED
|
@@ -1,377 +1,363 @@
|
|
|
1
|
-
# madeonsol
|
|
2
|
-
|
|
3
|
-
[](https://www.npmjs.com/package/madeonsol)
|
|
4
|
-
[ — 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)
|
|
1
|
+
# madeonsol
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/madeonsol)
|
|
4
|
+
[](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 946 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/solana-api) · [Website](https://madeonsol.com) · [RapidAPI listing](https://rapidapi.com/ClaudeTools/api/madeonsol-solana-kol-tracker-tools-api)
|
|
15
|
+
|
|
16
|
+
## Authentication
|
|
17
|
+
|
|
18
|
+
| Method | Format | Best for |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| **MadeOnSol API key** (recommended) | `msk_...` | Developers — [get a free key](https://madeonsol.com/developer) |
|
|
21
|
+
| RapidAPI key | Standard RapidAPI key | RapidAPI subscribers |
|
|
22
|
+
|
|
23
|
+
The SDK auto-detects the key type by the `msk_` prefix.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Install
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npm install madeonsol
|
|
31
|
+
# or
|
|
32
|
+
yarn add madeonsol
|
|
33
|
+
# or
|
|
34
|
+
pnpm add madeonsol
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Requires **Node.js ≥ 18** (uses native `fetch`). Works out of the box in Cloudflare Workers, Vercel Edge, and Bun.
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Quick start
|
|
42
|
+
|
|
43
|
+
```ts
|
|
44
|
+
import { MadeOnSol } from "madeonsol";
|
|
45
|
+
|
|
46
|
+
// With MadeOnSol API key (recommended — get one free at madeonsol.com/developer)
|
|
47
|
+
const client = new MadeOnSol({ apiKey: "msk_your_api_key_here" });
|
|
48
|
+
|
|
49
|
+
// Or with RapidAPI key
|
|
50
|
+
// const client = new MadeOnSol({ apiKey: "your-rapidapi-key" });
|
|
51
|
+
|
|
52
|
+
// Latest KOL buy trades
|
|
53
|
+
const { trades } = await client.kol.feed({ limit: 10, action: "buy" });
|
|
54
|
+
console.log(trades[0].kol_name, "bought", trades[0].token_symbol);
|
|
55
|
+
|
|
56
|
+
// Elite deployer leaderboard
|
|
57
|
+
const { deployers } = await client.deployer.leaderboard({ tier: "elite" });
|
|
58
|
+
|
|
59
|
+
// Recent deploy alerts
|
|
60
|
+
const { alerts } = await client.deployer.alerts({ limit: 5 });
|
|
61
|
+
|
|
62
|
+
// Search Solana tools
|
|
63
|
+
const { tools } = await client.tools.search({ q: "trading", limit: 10 });
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## API Reference
|
|
69
|
+
|
|
70
|
+
### KOL Tracker — `client.kol`
|
|
71
|
+
|
|
72
|
+
#### `client.kol.feed(params?)`
|
|
73
|
+
|
|
74
|
+
Live feed of trades made by tracked KOL wallets.
|
|
75
|
+
|
|
76
|
+
```ts
|
|
77
|
+
const { trades, count } = await client.kol.feed({
|
|
78
|
+
limit: 50, // 1–100, default 50
|
|
79
|
+
action: "buy", // "buy" | "sell"
|
|
80
|
+
kol: "7xKX...", // filter by specific wallet
|
|
81
|
+
});
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Returns: `KolFeedResponse` — `{ trades: KolTrade[], count: number }`
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
#### `client.kol.leaderboard(params?)`
|
|
89
|
+
|
|
90
|
+
KOL PnL leaderboard ranked by realized profit.
|
|
91
|
+
|
|
92
|
+
```ts
|
|
93
|
+
const { leaderboard, period } = await client.kol.leaderboard({
|
|
94
|
+
period: "7d", // "today" | "7d" | "30d", default "7d"
|
|
95
|
+
});
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Returns: `KolLeaderboardResponse`
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
#### `client.kol.wallet(wallet, params?)`
|
|
103
|
+
|
|
104
|
+
Full profile for a single KOL wallet, including trade history and optional per-token PnL breakdown.
|
|
105
|
+
|
|
106
|
+
```ts
|
|
107
|
+
const profile = await client.kol.wallet("7xKX...", {
|
|
108
|
+
include: "pnl_by_token",
|
|
109
|
+
});
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
Returns: `KolWalletProfile`
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
#### `client.kol.coordination(params?)`
|
|
117
|
+
|
|
118
|
+
Detect tokens where multiple KOLs are buying simultaneously — a strong signal of coordinated pumps.
|
|
119
|
+
|
|
120
|
+
```ts
|
|
121
|
+
const { tokens } = await client.kol.coordination({
|
|
122
|
+
period: "24h", // "1h" | "6h" | "24h" | "7d", default "24h"
|
|
123
|
+
min_kols: 3, // 2–50, default 3
|
|
124
|
+
limit: 20, // 1–50, default 20
|
|
125
|
+
});
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
Returns: `KolCoordinationResponse`
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
#### `client.kol.token(mint)`
|
|
133
|
+
|
|
134
|
+
KOL buy/sell activity for a specific token mint.
|
|
135
|
+
|
|
136
|
+
```ts
|
|
137
|
+
const activity = await client.kol.token("EPjFW...");
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
Returns: `KolTokenActivity`
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
### Deployer Hunter — `client.deployer`
|
|
145
|
+
|
|
146
|
+
#### `client.deployer.stats()`
|
|
147
|
+
|
|
148
|
+
Global statistics across all tracked deployer wallets.
|
|
149
|
+
|
|
150
|
+
```ts
|
|
151
|
+
const stats = await client.deployer.stats();
|
|
152
|
+
console.log(stats.overall_bonding_rate); // e.g. 0.043
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
Returns: `DeployerStats`
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
#### `client.deployer.leaderboard(params?)`
|
|
160
|
+
|
|
161
|
+
Deployers ranked by bonding rate or recent performance.
|
|
162
|
+
|
|
163
|
+
```ts
|
|
164
|
+
const { deployers } = await client.deployer.leaderboard({
|
|
165
|
+
tier: "elite", // "elite" | "good" | "moderate" | "rising" | "cold"
|
|
166
|
+
sort: "bonding_rate", // "bonding_rate" | "recent_bond_rate" | "total_bonded" | "last_deploy_at"
|
|
167
|
+
limit: 20, // 1–50, default 20
|
|
168
|
+
offset: 0,
|
|
169
|
+
});
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
Returns: `DeployerLeaderboardResponse`
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
#### `client.deployer.profile(wallet)`
|
|
177
|
+
|
|
178
|
+
Full profile for a single deployer wallet.
|
|
179
|
+
|
|
180
|
+
```ts
|
|
181
|
+
const deployer = await client.deployer.profile("3xAB...");
|
|
182
|
+
console.log(deployer.tier, deployer.bonding_rate);
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
Returns: `DeployerProfile`
|
|
186
|
+
|
|
187
|
+
---
|
|
188
|
+
|
|
189
|
+
#### `client.deployer.tokens(wallet, params?)`
|
|
190
|
+
|
|
191
|
+
All tokens deployed by a specific wallet.
|
|
192
|
+
|
|
193
|
+
```ts
|
|
194
|
+
const { tokens } = await client.deployer.tokens("3xAB...", {
|
|
195
|
+
limit: 20,
|
|
196
|
+
offset: 0,
|
|
197
|
+
});
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
Returns: `DeployerTokensResponse`
|
|
201
|
+
|
|
202
|
+
---
|
|
203
|
+
|
|
204
|
+
#### `client.deployer.alerts(params?)`
|
|
205
|
+
|
|
206
|
+
Real-time deploy alerts — fired when a tracked deployer launches a new token.
|
|
207
|
+
|
|
208
|
+
```ts
|
|
209
|
+
const { alerts } = await client.deployer.alerts({
|
|
210
|
+
since: "2025-01-01T00:00:00Z", // ISO 8601
|
|
211
|
+
limit: 20,
|
|
212
|
+
offset: 0,
|
|
213
|
+
});
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
Returns: `DeployerAlertsResponse`
|
|
217
|
+
|
|
218
|
+
---
|
|
219
|
+
|
|
220
|
+
#### `client.deployer.alertStats(params?)`
|
|
221
|
+
|
|
222
|
+
Aggregated alert statistics by tier.
|
|
223
|
+
|
|
224
|
+
```ts
|
|
225
|
+
const stats = await client.deployer.alertStats({ period: "7d" });
|
|
226
|
+
// "7d" | "30d" | "all", default "all"
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
Returns: `DeployerAlertStats`
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
#### `client.deployer.bestTokens(params?)`
|
|
234
|
+
|
|
235
|
+
Top-performing tokens from tracked deployers by peak market cap.
|
|
236
|
+
|
|
237
|
+
```ts
|
|
238
|
+
const { tokens } = await client.deployer.bestTokens({
|
|
239
|
+
period: "7d", // "7d" | "30d" | "all", default "7d"
|
|
240
|
+
limit: 5, // 1–20, default 5
|
|
241
|
+
});
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
Returns: `BestTokensResponse`
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
#### `client.deployer.recentBonds(params?)`
|
|
249
|
+
|
|
250
|
+
Most recently bonded tokens from tracked deployers.
|
|
251
|
+
|
|
252
|
+
```ts
|
|
253
|
+
const { bonds } = await client.deployer.recentBonds({ limit: 20 });
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
Returns: `RecentBondsResponse`
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
### Tool Directory — `client.tools`
|
|
261
|
+
|
|
262
|
+
#### `client.tools.search(params?)`
|
|
263
|
+
|
|
264
|
+
Search 950+ Solana tools indexed on MadeOnSol.
|
|
265
|
+
|
|
266
|
+
```ts
|
|
267
|
+
const { tools, count } = await client.tools.search({
|
|
268
|
+
q: "trading bot", // full-text search
|
|
269
|
+
category: "trading", // category slug filter
|
|
270
|
+
limit: 20, // 1–50, default 20
|
|
271
|
+
});
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
Returns: `ToolsSearchResponse`
|
|
275
|
+
|
|
276
|
+
---
|
|
277
|
+
|
|
278
|
+
## Error handling
|
|
279
|
+
|
|
280
|
+
All methods throw `MadeOnSolError` on non-2xx responses.
|
|
281
|
+
|
|
282
|
+
```ts
|
|
283
|
+
import { MadeOnSol, MadeOnSolError } from "madeonsol";
|
|
284
|
+
|
|
285
|
+
try {
|
|
286
|
+
const profile = await client.kol.wallet("invalid-wallet");
|
|
287
|
+
} catch (err) {
|
|
288
|
+
if (err instanceof MadeOnSolError) {
|
|
289
|
+
console.error(err.message); // human-readable message
|
|
290
|
+
console.error(err.status); // HTTP status code, e.g. 404
|
|
291
|
+
console.error(err.body); // raw response body
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
```
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
|
|
298
|
+
## Exported types
|
|
299
|
+
|
|
300
|
+
All types are exported from the main entry point:
|
|
301
|
+
|
|
302
|
+
```ts
|
|
303
|
+
import type {
|
|
304
|
+
// Errors
|
|
305
|
+
MadeOnSolError,
|
|
306
|
+
|
|
307
|
+
// KOL
|
|
308
|
+
KolTrade,
|
|
309
|
+
KolFeedParams,
|
|
310
|
+
KolFeedResponse,
|
|
311
|
+
KolLeaderboardParams,
|
|
312
|
+
KolLeaderboardResponse,
|
|
313
|
+
KolLeaderboardEntry,
|
|
314
|
+
KolWalletParams,
|
|
315
|
+
KolWalletProfile,
|
|
316
|
+
KolCoordinationParams,
|
|
317
|
+
KolCoordinationResponse,
|
|
318
|
+
CoordinatedToken,
|
|
319
|
+
KolTokenActivity,
|
|
320
|
+
KolPnlByToken,
|
|
321
|
+
|
|
322
|
+
// Deployer
|
|
323
|
+
DeployerStats,
|
|
324
|
+
DeployerLeaderboardParams,
|
|
325
|
+
DeployerLeaderboardResponse,
|
|
326
|
+
DeployerLeaderboardEntry,
|
|
327
|
+
DeployerProfile,
|
|
328
|
+
DeployerToken,
|
|
329
|
+
DeployerTokensParams,
|
|
330
|
+
DeployerTokensResponse,
|
|
331
|
+
DeployerAlertsParams,
|
|
332
|
+
DeployerAlertsResponse,
|
|
333
|
+
DeployerAlert,
|
|
334
|
+
DeployerAlertStatsParams,
|
|
335
|
+
DeployerAlertStats,
|
|
336
|
+
BestTokensParams,
|
|
337
|
+
BestTokensResponse,
|
|
338
|
+
BestToken,
|
|
339
|
+
RecentBondsParams,
|
|
340
|
+
RecentBondsResponse,
|
|
341
|
+
RecentBond,
|
|
342
|
+
|
|
343
|
+
// Tools
|
|
344
|
+
ToolsSearchParams,
|
|
345
|
+
ToolsSearchResponse,
|
|
346
|
+
Tool,
|
|
347
|
+
|
|
348
|
+
// Enums / unions
|
|
349
|
+
KolAction,
|
|
350
|
+
LeaderboardPeriod,
|
|
351
|
+
CoordinationPeriod,
|
|
352
|
+
DeployerTier,
|
|
353
|
+
DeployerSortField,
|
|
354
|
+
AlertPeriod,
|
|
355
|
+
BestTokensPeriod,
|
|
356
|
+
} from "madeonsol";
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
---
|
|
360
|
+
|
|
361
|
+
## License
|
|
362
|
+
|
|
363
|
+
MIT © [MadeOnSol](https://madeonsol.com)
|