nansen-cli 1.10.0 → 1.11.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/CHANGELOG.md +34 -0
- package/README.md +2 -2
- package/package.json +3 -2
- package/src/api.js +13 -9
- package/src/cli.js +31 -164
- package/src/index.js +4 -4
- package/src/schema.json +1684 -0
- package/src/trading.js +121 -134
- package/src/wallet.js +32 -39
package/src/schema.json
ADDED
|
@@ -0,0 +1,1684 @@
|
|
|
1
|
+
{
|
|
2
|
+
"commands": {
|
|
3
|
+
"research": {
|
|
4
|
+
"description": "Research and analytics commands",
|
|
5
|
+
"subcommands": {
|
|
6
|
+
"smart-money": {
|
|
7
|
+
"description": "Smart Money analytics - track sophisticated market participants",
|
|
8
|
+
"subcommands": {
|
|
9
|
+
"netflow": {
|
|
10
|
+
"description": "Net capital flows (inflows vs outflows)",
|
|
11
|
+
"options": {
|
|
12
|
+
"chain": {
|
|
13
|
+
"type": "string",
|
|
14
|
+
"default": "solana",
|
|
15
|
+
"description": "Blockchain to query"
|
|
16
|
+
},
|
|
17
|
+
"chains": {
|
|
18
|
+
"type": "array",
|
|
19
|
+
"description": "Multiple chains as JSON array"
|
|
20
|
+
},
|
|
21
|
+
"limit": {
|
|
22
|
+
"type": "number",
|
|
23
|
+
"description": "Number of results"
|
|
24
|
+
},
|
|
25
|
+
"labels": {
|
|
26
|
+
"type": "string|array",
|
|
27
|
+
"description": "Smart Money label filter"
|
|
28
|
+
},
|
|
29
|
+
"sort": {
|
|
30
|
+
"type": "string",
|
|
31
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
32
|
+
},
|
|
33
|
+
"filters": {
|
|
34
|
+
"type": "object",
|
|
35
|
+
"description": "Additional filters as JSON"
|
|
36
|
+
},
|
|
37
|
+
"page": {
|
|
38
|
+
"type": "number",
|
|
39
|
+
"description": "Page number for paginated results (default: 1)"
|
|
40
|
+
}
|
|
41
|
+
},
|
|
42
|
+
"returns": [
|
|
43
|
+
"token_address",
|
|
44
|
+
"token_symbol",
|
|
45
|
+
"net_flow_1h_usd",
|
|
46
|
+
"net_flow_24h_usd",
|
|
47
|
+
"net_flow_7d_usd",
|
|
48
|
+
"net_flow_30d_usd",
|
|
49
|
+
"chain",
|
|
50
|
+
"token_sectors",
|
|
51
|
+
"trader_count",
|
|
52
|
+
"token_age_days",
|
|
53
|
+
"market_cap_usd"
|
|
54
|
+
]
|
|
55
|
+
},
|
|
56
|
+
"dex-trades": {
|
|
57
|
+
"description": "Real-time DEX trading activity",
|
|
58
|
+
"options": {
|
|
59
|
+
"chain": {
|
|
60
|
+
"type": "string",
|
|
61
|
+
"default": "solana"
|
|
62
|
+
},
|
|
63
|
+
"chains": {
|
|
64
|
+
"type": "array"
|
|
65
|
+
},
|
|
66
|
+
"limit": {
|
|
67
|
+
"type": "number"
|
|
68
|
+
},
|
|
69
|
+
"labels": {
|
|
70
|
+
"type": "string|array"
|
|
71
|
+
},
|
|
72
|
+
"sort": {
|
|
73
|
+
"type": "string"
|
|
74
|
+
},
|
|
75
|
+
"filters": {
|
|
76
|
+
"type": "object"
|
|
77
|
+
},
|
|
78
|
+
"page": {
|
|
79
|
+
"type": "number",
|
|
80
|
+
"description": "Page number for paginated results (default: 1)"
|
|
81
|
+
}
|
|
82
|
+
},
|
|
83
|
+
"returns": [
|
|
84
|
+
"chain",
|
|
85
|
+
"block_timestamp",
|
|
86
|
+
"transaction_hash",
|
|
87
|
+
"trader_address",
|
|
88
|
+
"trader_address_label",
|
|
89
|
+
"token_bought_address",
|
|
90
|
+
"token_sold_address",
|
|
91
|
+
"token_bought_amount",
|
|
92
|
+
"token_sold_amount",
|
|
93
|
+
"token_bought_symbol",
|
|
94
|
+
"token_sold_symbol",
|
|
95
|
+
"token_bought_age_days",
|
|
96
|
+
"token_sold_age_days",
|
|
97
|
+
"token_bought_market_cap",
|
|
98
|
+
"token_sold_market_cap",
|
|
99
|
+
"trade_value_usd"
|
|
100
|
+
]
|
|
101
|
+
},
|
|
102
|
+
"perp-trades": {
|
|
103
|
+
"description": "Perpetual trading on Hyperliquid",
|
|
104
|
+
"options": {
|
|
105
|
+
"limit": {
|
|
106
|
+
"type": "number"
|
|
107
|
+
},
|
|
108
|
+
"labels": {
|
|
109
|
+
"type": "string|array",
|
|
110
|
+
"description": "Smart Money label filter"
|
|
111
|
+
},
|
|
112
|
+
"only-new-positions": {
|
|
113
|
+
"type": "boolean",
|
|
114
|
+
"description": "Show only position-opening trades (Open Long, Open Short)"
|
|
115
|
+
},
|
|
116
|
+
"sort": {
|
|
117
|
+
"type": "string"
|
|
118
|
+
},
|
|
119
|
+
"filters": {
|
|
120
|
+
"type": "object"
|
|
121
|
+
},
|
|
122
|
+
"page": {
|
|
123
|
+
"type": "number",
|
|
124
|
+
"description": "Page number for paginated results (default: 1)"
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
"returns": [
|
|
128
|
+
"trader_address_label",
|
|
129
|
+
"trader_address",
|
|
130
|
+
"token_symbol",
|
|
131
|
+
"side",
|
|
132
|
+
"action",
|
|
133
|
+
"token_amount",
|
|
134
|
+
"price_usd",
|
|
135
|
+
"value_usd",
|
|
136
|
+
"type",
|
|
137
|
+
"block_timestamp",
|
|
138
|
+
"transaction_hash"
|
|
139
|
+
]
|
|
140
|
+
},
|
|
141
|
+
"holdings": {
|
|
142
|
+
"description": "Aggregated token balances",
|
|
143
|
+
"options": {
|
|
144
|
+
"chain": {
|
|
145
|
+
"type": "string",
|
|
146
|
+
"default": "solana"
|
|
147
|
+
},
|
|
148
|
+
"chains": {
|
|
149
|
+
"type": "array"
|
|
150
|
+
},
|
|
151
|
+
"limit": {
|
|
152
|
+
"type": "number"
|
|
153
|
+
},
|
|
154
|
+
"labels": {
|
|
155
|
+
"type": "string|array"
|
|
156
|
+
},
|
|
157
|
+
"page": {
|
|
158
|
+
"type": "number",
|
|
159
|
+
"description": "Page number for paginated results (default: 1)"
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
"returns": [
|
|
163
|
+
"chain",
|
|
164
|
+
"token_address",
|
|
165
|
+
"token_symbol",
|
|
166
|
+
"token_sectors",
|
|
167
|
+
"value_usd",
|
|
168
|
+
"balance_24h_percent_change",
|
|
169
|
+
"holders_count",
|
|
170
|
+
"share_of_holdings_percent",
|
|
171
|
+
"token_age_days",
|
|
172
|
+
"market_cap_usd"
|
|
173
|
+
]
|
|
174
|
+
},
|
|
175
|
+
"dcas": {
|
|
176
|
+
"description": "DCA strategies on Jupiter",
|
|
177
|
+
"options": {
|
|
178
|
+
"limit": {
|
|
179
|
+
"type": "number"
|
|
180
|
+
},
|
|
181
|
+
"filters": {
|
|
182
|
+
"type": "object"
|
|
183
|
+
},
|
|
184
|
+
"page": {
|
|
185
|
+
"type": "number",
|
|
186
|
+
"description": "Page number for paginated results (default: 1)"
|
|
187
|
+
}
|
|
188
|
+
},
|
|
189
|
+
"returns": [
|
|
190
|
+
"dca_created_at",
|
|
191
|
+
"dca_updated_at",
|
|
192
|
+
"trader_address",
|
|
193
|
+
"transaction_hash",
|
|
194
|
+
"trader_address_label",
|
|
195
|
+
"dca_vault_address",
|
|
196
|
+
"input_token_address",
|
|
197
|
+
"output_token_address",
|
|
198
|
+
"deposit_token_amount",
|
|
199
|
+
"token_spent_amount",
|
|
200
|
+
"output_token_redeemed_amount",
|
|
201
|
+
"dca_status",
|
|
202
|
+
"input_token_symbol",
|
|
203
|
+
"output_token_symbol",
|
|
204
|
+
"deposit_value_usd"
|
|
205
|
+
]
|
|
206
|
+
},
|
|
207
|
+
"historical-holdings": {
|
|
208
|
+
"description": "Historical holdings over time",
|
|
209
|
+
"options": {
|
|
210
|
+
"chain": {
|
|
211
|
+
"type": "string",
|
|
212
|
+
"default": "solana"
|
|
213
|
+
},
|
|
214
|
+
"chains": {
|
|
215
|
+
"type": "array"
|
|
216
|
+
},
|
|
217
|
+
"days": {
|
|
218
|
+
"type": "number",
|
|
219
|
+
"default": 30
|
|
220
|
+
},
|
|
221
|
+
"limit": {
|
|
222
|
+
"type": "number"
|
|
223
|
+
},
|
|
224
|
+
"page": {
|
|
225
|
+
"type": "number",
|
|
226
|
+
"description": "Page number for paginated results (default: 1)"
|
|
227
|
+
}
|
|
228
|
+
},
|
|
229
|
+
"returns": [
|
|
230
|
+
"date",
|
|
231
|
+
"chain",
|
|
232
|
+
"token_address",
|
|
233
|
+
"token_symbol",
|
|
234
|
+
"token_sectors",
|
|
235
|
+
"smart_money_labels",
|
|
236
|
+
"balance",
|
|
237
|
+
"value_usd",
|
|
238
|
+
"balance_24h_percent_change",
|
|
239
|
+
"holders_count",
|
|
240
|
+
"share_of_holdings_percent",
|
|
241
|
+
"token_age_days",
|
|
242
|
+
"market_cap_usd"
|
|
243
|
+
]
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
},
|
|
247
|
+
"profiler": {
|
|
248
|
+
"description": "Wallet profiling - detailed information about any blockchain address",
|
|
249
|
+
"subcommands": {
|
|
250
|
+
"balance": {
|
|
251
|
+
"description": "Current token holdings",
|
|
252
|
+
"options": {
|
|
253
|
+
"address": {
|
|
254
|
+
"type": "string",
|
|
255
|
+
"required": true,
|
|
256
|
+
"description": "Wallet address to query"
|
|
257
|
+
},
|
|
258
|
+
"chain": {
|
|
259
|
+
"type": "string",
|
|
260
|
+
"default": "ethereum"
|
|
261
|
+
},
|
|
262
|
+
"entity": {
|
|
263
|
+
"type": "string",
|
|
264
|
+
"description": "Entity name instead of address"
|
|
265
|
+
}
|
|
266
|
+
},
|
|
267
|
+
"returns": [
|
|
268
|
+
"chain",
|
|
269
|
+
"address",
|
|
270
|
+
"token_address",
|
|
271
|
+
"token_symbol",
|
|
272
|
+
"token_name",
|
|
273
|
+
"token_amount",
|
|
274
|
+
"price_usd",
|
|
275
|
+
"value_usd"
|
|
276
|
+
]
|
|
277
|
+
},
|
|
278
|
+
"labels": {
|
|
279
|
+
"description": "Behavioral and entity labels",
|
|
280
|
+
"options": {
|
|
281
|
+
"address": {
|
|
282
|
+
"type": "string",
|
|
283
|
+
"required": true
|
|
284
|
+
},
|
|
285
|
+
"chain": {
|
|
286
|
+
"type": "string",
|
|
287
|
+
"default": "ethereum"
|
|
288
|
+
}
|
|
289
|
+
},
|
|
290
|
+
"returns": [
|
|
291
|
+
"label",
|
|
292
|
+
"category"
|
|
293
|
+
]
|
|
294
|
+
},
|
|
295
|
+
"transactions": {
|
|
296
|
+
"description": "Transaction history",
|
|
297
|
+
"options": {
|
|
298
|
+
"address": {
|
|
299
|
+
"type": "string",
|
|
300
|
+
"required": true
|
|
301
|
+
},
|
|
302
|
+
"chain": {
|
|
303
|
+
"type": "string",
|
|
304
|
+
"default": "ethereum"
|
|
305
|
+
},
|
|
306
|
+
"date": {
|
|
307
|
+
"type": "string",
|
|
308
|
+
"required": false,
|
|
309
|
+
"description": "Date or date range"
|
|
310
|
+
},
|
|
311
|
+
"limit": {
|
|
312
|
+
"type": "number"
|
|
313
|
+
},
|
|
314
|
+
"days": {
|
|
315
|
+
"type": "number",
|
|
316
|
+
"default": 30
|
|
317
|
+
},
|
|
318
|
+
"page": {
|
|
319
|
+
"type": "number",
|
|
320
|
+
"description": "Page number for paginated results (default: 1)"
|
|
321
|
+
},
|
|
322
|
+
"sort": {
|
|
323
|
+
"type": "string",
|
|
324
|
+
"description": "Sort field:direction (e.g., block_timestamp:desc)"
|
|
325
|
+
},
|
|
326
|
+
"filters": {
|
|
327
|
+
"type": "object",
|
|
328
|
+
"description": "Additional filters as JSON"
|
|
329
|
+
}
|
|
330
|
+
},
|
|
331
|
+
"returns": [
|
|
332
|
+
"chain",
|
|
333
|
+
"method",
|
|
334
|
+
"tokens_sent",
|
|
335
|
+
"tokens_received",
|
|
336
|
+
"volume_usd",
|
|
337
|
+
"block_timestamp",
|
|
338
|
+
"transaction_hash",
|
|
339
|
+
"source_type"
|
|
340
|
+
]
|
|
341
|
+
},
|
|
342
|
+
"pnl": {
|
|
343
|
+
"description": "PnL and trade performance",
|
|
344
|
+
"options": {
|
|
345
|
+
"address": {
|
|
346
|
+
"type": "string",
|
|
347
|
+
"required": true
|
|
348
|
+
},
|
|
349
|
+
"chain": {
|
|
350
|
+
"type": "string",
|
|
351
|
+
"default": "ethereum"
|
|
352
|
+
},
|
|
353
|
+
"date": {
|
|
354
|
+
"type": "string",
|
|
355
|
+
"description": "Date or date range"
|
|
356
|
+
},
|
|
357
|
+
"days": {
|
|
358
|
+
"type": "number",
|
|
359
|
+
"default": 30
|
|
360
|
+
},
|
|
361
|
+
"limit": {
|
|
362
|
+
"type": "number"
|
|
363
|
+
},
|
|
364
|
+
"page": {
|
|
365
|
+
"type": "number",
|
|
366
|
+
"description": "Page number for paginated results (default: 1)"
|
|
367
|
+
},
|
|
368
|
+
"sort": {
|
|
369
|
+
"type": "string",
|
|
370
|
+
"description": "Sort field:direction (e.g., pnl_usd_realised:desc)"
|
|
371
|
+
},
|
|
372
|
+
"filters": {
|
|
373
|
+
"type": "object",
|
|
374
|
+
"description": "Additional filters as JSON"
|
|
375
|
+
}
|
|
376
|
+
},
|
|
377
|
+
"returns": [
|
|
378
|
+
"token_address",
|
|
379
|
+
"token_symbol",
|
|
380
|
+
"token_price",
|
|
381
|
+
"roi_percent_realised",
|
|
382
|
+
"pnl_usd_realised",
|
|
383
|
+
"pnl_usd_unrealised",
|
|
384
|
+
"roi_percent_unrealised",
|
|
385
|
+
"bought_amount",
|
|
386
|
+
"bought_usd",
|
|
387
|
+
"cost_basis_usd",
|
|
388
|
+
"sold_amount",
|
|
389
|
+
"sold_usd",
|
|
390
|
+
"avg_sold_price_usd",
|
|
391
|
+
"holding_amount",
|
|
392
|
+
"holding_usd",
|
|
393
|
+
"nof_buys",
|
|
394
|
+
"nof_sells",
|
|
395
|
+
"max_balance_held",
|
|
396
|
+
"max_balance_held_usd"
|
|
397
|
+
]
|
|
398
|
+
},
|
|
399
|
+
"search": {
|
|
400
|
+
"description": "Search for entities by name",
|
|
401
|
+
"options": {
|
|
402
|
+
"query": {
|
|
403
|
+
"type": "string",
|
|
404
|
+
"required": true,
|
|
405
|
+
"description": "Search query"
|
|
406
|
+
},
|
|
407
|
+
"limit": {
|
|
408
|
+
"type": "number"
|
|
409
|
+
},
|
|
410
|
+
"page": {
|
|
411
|
+
"type": "number",
|
|
412
|
+
"description": "Page number for paginated results (default: 1)"
|
|
413
|
+
}
|
|
414
|
+
},
|
|
415
|
+
"returns": [
|
|
416
|
+
"entity_name"
|
|
417
|
+
]
|
|
418
|
+
},
|
|
419
|
+
"historical-balances": {
|
|
420
|
+
"description": "Historical balances over time",
|
|
421
|
+
"options": {
|
|
422
|
+
"address": {
|
|
423
|
+
"type": "string",
|
|
424
|
+
"required": true
|
|
425
|
+
},
|
|
426
|
+
"chain": {
|
|
427
|
+
"type": "string",
|
|
428
|
+
"default": "ethereum"
|
|
429
|
+
},
|
|
430
|
+
"days": {
|
|
431
|
+
"type": "number",
|
|
432
|
+
"default": 30
|
|
433
|
+
},
|
|
434
|
+
"limit": {
|
|
435
|
+
"type": "number"
|
|
436
|
+
},
|
|
437
|
+
"page": {
|
|
438
|
+
"type": "number",
|
|
439
|
+
"description": "Page number for paginated results (default: 1)"
|
|
440
|
+
},
|
|
441
|
+
"sort": {
|
|
442
|
+
"type": "string",
|
|
443
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
444
|
+
},
|
|
445
|
+
"filters": {
|
|
446
|
+
"type": "object",
|
|
447
|
+
"description": "Additional filters as JSON"
|
|
448
|
+
}
|
|
449
|
+
},
|
|
450
|
+
"returns": [
|
|
451
|
+
"block_timestamp",
|
|
452
|
+
"token_address",
|
|
453
|
+
"chain",
|
|
454
|
+
"token_amount",
|
|
455
|
+
"value_usd",
|
|
456
|
+
"token_symbol"
|
|
457
|
+
]
|
|
458
|
+
},
|
|
459
|
+
"related-wallets": {
|
|
460
|
+
"description": "Find wallets related to an address",
|
|
461
|
+
"options": {
|
|
462
|
+
"address": {
|
|
463
|
+
"type": "string",
|
|
464
|
+
"required": true
|
|
465
|
+
},
|
|
466
|
+
"chain": {
|
|
467
|
+
"type": "string",
|
|
468
|
+
"default": "ethereum"
|
|
469
|
+
},
|
|
470
|
+
"limit": {
|
|
471
|
+
"type": "number"
|
|
472
|
+
},
|
|
473
|
+
"page": {
|
|
474
|
+
"type": "number",
|
|
475
|
+
"description": "Page number for paginated results (default: 1)"
|
|
476
|
+
},
|
|
477
|
+
"sort": {
|
|
478
|
+
"type": "string",
|
|
479
|
+
"description": "Sort field:direction (e.g., order:desc)"
|
|
480
|
+
}
|
|
481
|
+
},
|
|
482
|
+
"returns": [
|
|
483
|
+
"address",
|
|
484
|
+
"address_label",
|
|
485
|
+
"relation",
|
|
486
|
+
"transaction_hash",
|
|
487
|
+
"block_timestamp",
|
|
488
|
+
"order",
|
|
489
|
+
"chain"
|
|
490
|
+
]
|
|
491
|
+
},
|
|
492
|
+
"counterparties": {
|
|
493
|
+
"description": "Top counterparties by volume",
|
|
494
|
+
"options": {
|
|
495
|
+
"address": {
|
|
496
|
+
"type": "string",
|
|
497
|
+
"required": true
|
|
498
|
+
},
|
|
499
|
+
"chain": {
|
|
500
|
+
"type": "string",
|
|
501
|
+
"default": "ethereum"
|
|
502
|
+
},
|
|
503
|
+
"days": {
|
|
504
|
+
"type": "number",
|
|
505
|
+
"default": 30
|
|
506
|
+
},
|
|
507
|
+
"limit": {
|
|
508
|
+
"type": "number"
|
|
509
|
+
},
|
|
510
|
+
"page": {
|
|
511
|
+
"type": "number",
|
|
512
|
+
"description": "Page number for paginated results (default: 1)"
|
|
513
|
+
},
|
|
514
|
+
"sort": {
|
|
515
|
+
"type": "string",
|
|
516
|
+
"description": "Sort field:direction (e.g., total_volume_usd:desc)"
|
|
517
|
+
},
|
|
518
|
+
"filters": {
|
|
519
|
+
"type": "object",
|
|
520
|
+
"description": "Additional filters as JSON"
|
|
521
|
+
}
|
|
522
|
+
},
|
|
523
|
+
"returns": [
|
|
524
|
+
"counterparty_address",
|
|
525
|
+
"counterparty_address_label",
|
|
526
|
+
"interaction_count",
|
|
527
|
+
"total_volume_usd",
|
|
528
|
+
"volume_in_usd",
|
|
529
|
+
"volume_out_usd",
|
|
530
|
+
"tokens_info"
|
|
531
|
+
]
|
|
532
|
+
},
|
|
533
|
+
"pnl-summary": {
|
|
534
|
+
"description": "Summarized PnL metrics",
|
|
535
|
+
"options": {
|
|
536
|
+
"address": {
|
|
537
|
+
"type": "string",
|
|
538
|
+
"required": true
|
|
539
|
+
},
|
|
540
|
+
"chain": {
|
|
541
|
+
"type": "string",
|
|
542
|
+
"default": "ethereum"
|
|
543
|
+
},
|
|
544
|
+
"days": {
|
|
545
|
+
"type": "number",
|
|
546
|
+
"default": 30
|
|
547
|
+
}
|
|
548
|
+
},
|
|
549
|
+
"returns": [
|
|
550
|
+
"pagination",
|
|
551
|
+
"top5_tokens[realized_pnl, realized_roi, token_address, token_symbol, chain]",
|
|
552
|
+
"traded_token_count",
|
|
553
|
+
"traded_times",
|
|
554
|
+
"realized_pnl_usd",
|
|
555
|
+
"realized_pnl_percent",
|
|
556
|
+
"win_rate"
|
|
557
|
+
]
|
|
558
|
+
},
|
|
559
|
+
"perp-positions": {
|
|
560
|
+
"description": "Current perpetual positions",
|
|
561
|
+
"options": {
|
|
562
|
+
"address": {
|
|
563
|
+
"type": "string",
|
|
564
|
+
"required": true
|
|
565
|
+
},
|
|
566
|
+
"limit": {
|
|
567
|
+
"type": "number"
|
|
568
|
+
},
|
|
569
|
+
"page": {
|
|
570
|
+
"type": "number",
|
|
571
|
+
"description": "Page number for paginated results (default: 1)"
|
|
572
|
+
},
|
|
573
|
+
"sort": {
|
|
574
|
+
"type": "string",
|
|
575
|
+
"description": "Sort field:direction (e.g., position_value_usd:desc)"
|
|
576
|
+
},
|
|
577
|
+
"filters": {
|
|
578
|
+
"type": "object",
|
|
579
|
+
"description": "Additional filters as JSON"
|
|
580
|
+
}
|
|
581
|
+
},
|
|
582
|
+
"returns": [
|
|
583
|
+
"assetPositions",
|
|
584
|
+
"crossMaintenanceMarginUsed",
|
|
585
|
+
"cross_margin_summary_account_value_usd",
|
|
586
|
+
"cross_margin_summary_total_margin_used_usd",
|
|
587
|
+
"cross_margin_summary_total_net_liquidation_position_on_usd",
|
|
588
|
+
"cross_margin_summary_total_raw_usd",
|
|
589
|
+
"margin_summary_account_value_usd",
|
|
590
|
+
"margin_summary_total_margin_used_usd",
|
|
591
|
+
"margin_summary_total_net_liquidation_position_usd",
|
|
592
|
+
"margin_summary_total_raw_usd",
|
|
593
|
+
"time",
|
|
594
|
+
"withdrawable"
|
|
595
|
+
]
|
|
596
|
+
},
|
|
597
|
+
"perp-trades": {
|
|
598
|
+
"description": "Perpetual trading history",
|
|
599
|
+
"options": {
|
|
600
|
+
"address": {
|
|
601
|
+
"type": "string",
|
|
602
|
+
"required": true
|
|
603
|
+
},
|
|
604
|
+
"days": {
|
|
605
|
+
"type": "number",
|
|
606
|
+
"default": 30
|
|
607
|
+
},
|
|
608
|
+
"limit": {
|
|
609
|
+
"type": "number"
|
|
610
|
+
},
|
|
611
|
+
"page": {
|
|
612
|
+
"type": "number",
|
|
613
|
+
"description": "Page number for paginated results (default: 1)"
|
|
614
|
+
},
|
|
615
|
+
"sort": {
|
|
616
|
+
"type": "string",
|
|
617
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
618
|
+
},
|
|
619
|
+
"filters": {
|
|
620
|
+
"type": "object",
|
|
621
|
+
"description": "Additional filters as JSON"
|
|
622
|
+
}
|
|
623
|
+
},
|
|
624
|
+
"returns": [
|
|
625
|
+
"timestamp",
|
|
626
|
+
"side",
|
|
627
|
+
"action",
|
|
628
|
+
"block_number",
|
|
629
|
+
"token_symbol",
|
|
630
|
+
"price",
|
|
631
|
+
"size",
|
|
632
|
+
"value_usd",
|
|
633
|
+
"start_position",
|
|
634
|
+
"closed_pnl",
|
|
635
|
+
"crossed",
|
|
636
|
+
"fee_usd",
|
|
637
|
+
"fee_token_symbol",
|
|
638
|
+
"transaction_hash",
|
|
639
|
+
"user",
|
|
640
|
+
"oid"
|
|
641
|
+
]
|
|
642
|
+
},
|
|
643
|
+
"batch": {
|
|
644
|
+
"description": "Batch profile multiple addresses",
|
|
645
|
+
"options": {
|
|
646
|
+
"addresses": {
|
|
647
|
+
"type": "string",
|
|
648
|
+
"description": "Comma-separated addresses"
|
|
649
|
+
},
|
|
650
|
+
"file": {
|
|
651
|
+
"type": "string",
|
|
652
|
+
"description": "File with one address per line"
|
|
653
|
+
},
|
|
654
|
+
"chain": {
|
|
655
|
+
"type": "string",
|
|
656
|
+
"default": "ethereum"
|
|
657
|
+
},
|
|
658
|
+
"include": {
|
|
659
|
+
"type": "string",
|
|
660
|
+
"default": "labels,balance",
|
|
661
|
+
"description": "Comma-separated: labels,balance,pnl"
|
|
662
|
+
},
|
|
663
|
+
"delay": {
|
|
664
|
+
"type": "number",
|
|
665
|
+
"default": 1000,
|
|
666
|
+
"description": "Delay between requests in ms"
|
|
667
|
+
}
|
|
668
|
+
},
|
|
669
|
+
"returns": [
|
|
670
|
+
"address",
|
|
671
|
+
"chain",
|
|
672
|
+
"labels",
|
|
673
|
+
"balance",
|
|
674
|
+
"pnl",
|
|
675
|
+
"error"
|
|
676
|
+
]
|
|
677
|
+
},
|
|
678
|
+
"trace": {
|
|
679
|
+
"description": "Multi-hop counterparty trace (BFS)",
|
|
680
|
+
"options": {
|
|
681
|
+
"address": {
|
|
682
|
+
"type": "string",
|
|
683
|
+
"required": true
|
|
684
|
+
},
|
|
685
|
+
"chain": {
|
|
686
|
+
"type": "string",
|
|
687
|
+
"default": "ethereum"
|
|
688
|
+
},
|
|
689
|
+
"depth": {
|
|
690
|
+
"type": "number",
|
|
691
|
+
"default": 2,
|
|
692
|
+
"description": "Max hops (1-5)"
|
|
693
|
+
},
|
|
694
|
+
"width": {
|
|
695
|
+
"type": "number",
|
|
696
|
+
"default": 10,
|
|
697
|
+
"description": "Top N counterparties per hop"
|
|
698
|
+
},
|
|
699
|
+
"days": {
|
|
700
|
+
"type": "number",
|
|
701
|
+
"default": 30
|
|
702
|
+
},
|
|
703
|
+
"delay": {
|
|
704
|
+
"type": "number",
|
|
705
|
+
"default": 1000,
|
|
706
|
+
"description": "Delay between requests in ms"
|
|
707
|
+
}
|
|
708
|
+
},
|
|
709
|
+
"returns": [
|
|
710
|
+
"root",
|
|
711
|
+
"chain",
|
|
712
|
+
"depth",
|
|
713
|
+
"nodes",
|
|
714
|
+
"edges",
|
|
715
|
+
"stats"
|
|
716
|
+
]
|
|
717
|
+
},
|
|
718
|
+
"compare": {
|
|
719
|
+
"description": "Compare two wallets (shared counterparties, tokens)",
|
|
720
|
+
"options": {
|
|
721
|
+
"addresses": {
|
|
722
|
+
"type": "string",
|
|
723
|
+
"required": true,
|
|
724
|
+
"description": "Two comma-separated addresses"
|
|
725
|
+
},
|
|
726
|
+
"chain": {
|
|
727
|
+
"type": "string",
|
|
728
|
+
"default": "ethereum"
|
|
729
|
+
},
|
|
730
|
+
"days": {
|
|
731
|
+
"type": "number",
|
|
732
|
+
"default": 30
|
|
733
|
+
}
|
|
734
|
+
},
|
|
735
|
+
"returns": [
|
|
736
|
+
"addresses",
|
|
737
|
+
"chain",
|
|
738
|
+
"shared_counterparties",
|
|
739
|
+
"shared_tokens",
|
|
740
|
+
"balances"
|
|
741
|
+
]
|
|
742
|
+
}
|
|
743
|
+
}
|
|
744
|
+
},
|
|
745
|
+
"token": {
|
|
746
|
+
"description": "Token God Mode - deep analytics for any token",
|
|
747
|
+
"subcommands": {
|
|
748
|
+
"indicators": {
|
|
749
|
+
"description": "Risk and reward indicators for a token (Nansen Score)",
|
|
750
|
+
"options": {
|
|
751
|
+
"token": {
|
|
752
|
+
"type": "string",
|
|
753
|
+
"required": true,
|
|
754
|
+
"description": "Token address"
|
|
755
|
+
},
|
|
756
|
+
"chain": {
|
|
757
|
+
"type": "string",
|
|
758
|
+
"default": "ethereum"
|
|
759
|
+
}
|
|
760
|
+
},
|
|
761
|
+
"returns": [
|
|
762
|
+
"token_address",
|
|
763
|
+
"chain",
|
|
764
|
+
"token_info",
|
|
765
|
+
"risk_indicators[indicator_type, score, signal, signal_percentile, last_trigger_on]",
|
|
766
|
+
"reward_indicators[indicator_type, score, signal, signal_percentile, last_trigger_on]"
|
|
767
|
+
]
|
|
768
|
+
},
|
|
769
|
+
"ohlcv": {
|
|
770
|
+
"description": "OHLCV candle data for a token",
|
|
771
|
+
"options": {
|
|
772
|
+
"token": {
|
|
773
|
+
"type": "string",
|
|
774
|
+
"required": true,
|
|
775
|
+
"description": "Token address"
|
|
776
|
+
},
|
|
777
|
+
"chain": {
|
|
778
|
+
"type": "string",
|
|
779
|
+
"default": "solana"
|
|
780
|
+
},
|
|
781
|
+
"timeframe": {
|
|
782
|
+
"type": "string",
|
|
783
|
+
"default": "1h",
|
|
784
|
+
"enum": [
|
|
785
|
+
"1m",
|
|
786
|
+
"5m",
|
|
787
|
+
"15m",
|
|
788
|
+
"30m",
|
|
789
|
+
"1h",
|
|
790
|
+
"2h",
|
|
791
|
+
"4h",
|
|
792
|
+
"1d",
|
|
793
|
+
"1w",
|
|
794
|
+
"1M"
|
|
795
|
+
],
|
|
796
|
+
"description": "Candle timeframe (e.g., 1h, 4h, 1d)"
|
|
797
|
+
}
|
|
798
|
+
},
|
|
799
|
+
"returns": [
|
|
800
|
+
"interval_start",
|
|
801
|
+
"open",
|
|
802
|
+
"high",
|
|
803
|
+
"low",
|
|
804
|
+
"close",
|
|
805
|
+
"volume",
|
|
806
|
+
"volume_usd",
|
|
807
|
+
"market_cap"
|
|
808
|
+
]
|
|
809
|
+
},
|
|
810
|
+
"info": {
|
|
811
|
+
"description": "Get detailed information for a specific token",
|
|
812
|
+
"options": {
|
|
813
|
+
"token": {
|
|
814
|
+
"type": "string",
|
|
815
|
+
"required": true,
|
|
816
|
+
"description": "Token address"
|
|
817
|
+
},
|
|
818
|
+
"chain": {
|
|
819
|
+
"type": "string",
|
|
820
|
+
"default": "solana"
|
|
821
|
+
},
|
|
822
|
+
"timeframe": {
|
|
823
|
+
"type": "string",
|
|
824
|
+
"default": "1d",
|
|
825
|
+
"enum": [
|
|
826
|
+
"5m",
|
|
827
|
+
"1h",
|
|
828
|
+
"6h",
|
|
829
|
+
"12h",
|
|
830
|
+
"1d",
|
|
831
|
+
"7d"
|
|
832
|
+
]
|
|
833
|
+
}
|
|
834
|
+
},
|
|
835
|
+
"returns": [
|
|
836
|
+
"name",
|
|
837
|
+
"symbol",
|
|
838
|
+
"contract_address",
|
|
839
|
+
"logo",
|
|
840
|
+
"token_details",
|
|
841
|
+
"spot_metrics"
|
|
842
|
+
]
|
|
843
|
+
},
|
|
844
|
+
"screener": {
|
|
845
|
+
"description": "Discover and filter tokens",
|
|
846
|
+
"options": {
|
|
847
|
+
"chain": {
|
|
848
|
+
"type": "string",
|
|
849
|
+
"default": "solana"
|
|
850
|
+
},
|
|
851
|
+
"chains": {
|
|
852
|
+
"type": "array"
|
|
853
|
+
},
|
|
854
|
+
"timeframe": {
|
|
855
|
+
"type": "string",
|
|
856
|
+
"default": "24h",
|
|
857
|
+
"enum": [
|
|
858
|
+
"5m",
|
|
859
|
+
"10m",
|
|
860
|
+
"1h",
|
|
861
|
+
"6h",
|
|
862
|
+
"24h",
|
|
863
|
+
"7d",
|
|
864
|
+
"30d"
|
|
865
|
+
]
|
|
866
|
+
},
|
|
867
|
+
"smart-money": {
|
|
868
|
+
"type": "boolean",
|
|
869
|
+
"description": "Filter for Smart Money only"
|
|
870
|
+
},
|
|
871
|
+
"search": {
|
|
872
|
+
"type": "string",
|
|
873
|
+
"description": "Filter results by token symbol or name (client-side)"
|
|
874
|
+
},
|
|
875
|
+
"limit": {
|
|
876
|
+
"type": "number"
|
|
877
|
+
},
|
|
878
|
+
"sort": {
|
|
879
|
+
"type": "string",
|
|
880
|
+
"description": "Sort field:direction (e.g., volume_usd:desc)"
|
|
881
|
+
},
|
|
882
|
+
"filters": {
|
|
883
|
+
"type": "object",
|
|
884
|
+
"description": "Additional filters as JSON"
|
|
885
|
+
},
|
|
886
|
+
"page": {
|
|
887
|
+
"type": "number",
|
|
888
|
+
"description": "Page number for paginated results (default: 1)"
|
|
889
|
+
}
|
|
890
|
+
},
|
|
891
|
+
"returns": [
|
|
892
|
+
"chain",
|
|
893
|
+
"token_address",
|
|
894
|
+
"token_symbol",
|
|
895
|
+
"token_age_days",
|
|
896
|
+
"market_cap_usd",
|
|
897
|
+
"liquidity",
|
|
898
|
+
"price_usd",
|
|
899
|
+
"price_change",
|
|
900
|
+
"fdv",
|
|
901
|
+
"fdv_mc_ratio",
|
|
902
|
+
"buy_volume",
|
|
903
|
+
"inflow_fdv_ratio",
|
|
904
|
+
"outflow_fdv_ratio",
|
|
905
|
+
"sell_volume",
|
|
906
|
+
"volume",
|
|
907
|
+
"netflow"
|
|
908
|
+
]
|
|
909
|
+
},
|
|
910
|
+
"holders": {
|
|
911
|
+
"description": "Token holder analysis",
|
|
912
|
+
"options": {
|
|
913
|
+
"token": {
|
|
914
|
+
"type": "string",
|
|
915
|
+
"required": true
|
|
916
|
+
},
|
|
917
|
+
"chain": {
|
|
918
|
+
"type": "string",
|
|
919
|
+
"default": "solana"
|
|
920
|
+
},
|
|
921
|
+
"smart-money": {
|
|
922
|
+
"type": "boolean"
|
|
923
|
+
},
|
|
924
|
+
"limit": {
|
|
925
|
+
"type": "number"
|
|
926
|
+
},
|
|
927
|
+
"sort": {
|
|
928
|
+
"type": "string",
|
|
929
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
930
|
+
},
|
|
931
|
+
"filters": {
|
|
932
|
+
"type": "object",
|
|
933
|
+
"description": "Additional filters as JSON"
|
|
934
|
+
},
|
|
935
|
+
"page": {
|
|
936
|
+
"type": "number",
|
|
937
|
+
"description": "Page number for paginated results (default: 1)"
|
|
938
|
+
}
|
|
939
|
+
},
|
|
940
|
+
"returns": [
|
|
941
|
+
"address",
|
|
942
|
+
"address_label",
|
|
943
|
+
"token_amount",
|
|
944
|
+
"total_outflow",
|
|
945
|
+
"total_inflow",
|
|
946
|
+
"balance_change_24h",
|
|
947
|
+
"balance_change_7d",
|
|
948
|
+
"balance_change_30d",
|
|
949
|
+
"ownership_percentage",
|
|
950
|
+
"value_usd"
|
|
951
|
+
]
|
|
952
|
+
},
|
|
953
|
+
"flows": {
|
|
954
|
+
"description": "Token flow metrics",
|
|
955
|
+
"options": {
|
|
956
|
+
"token": {
|
|
957
|
+
"type": "string",
|
|
958
|
+
"required": true
|
|
959
|
+
},
|
|
960
|
+
"chain": {
|
|
961
|
+
"type": "string",
|
|
962
|
+
"default": "solana"
|
|
963
|
+
},
|
|
964
|
+
"date": {
|
|
965
|
+
"type": "string",
|
|
966
|
+
"required": false,
|
|
967
|
+
"description": "Date or date range"
|
|
968
|
+
},
|
|
969
|
+
"days": {
|
|
970
|
+
"type": "number",
|
|
971
|
+
"default": 30
|
|
972
|
+
},
|
|
973
|
+
"limit": {
|
|
974
|
+
"type": "number"
|
|
975
|
+
},
|
|
976
|
+
"sort": {
|
|
977
|
+
"type": "string",
|
|
978
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
979
|
+
},
|
|
980
|
+
"filters": {
|
|
981
|
+
"type": "object",
|
|
982
|
+
"description": "Additional filters as JSON"
|
|
983
|
+
},
|
|
984
|
+
"page": {
|
|
985
|
+
"type": "number",
|
|
986
|
+
"description": "Page number for paginated results (default: 1)"
|
|
987
|
+
}
|
|
988
|
+
},
|
|
989
|
+
"returns": [
|
|
990
|
+
"date",
|
|
991
|
+
"price_usd",
|
|
992
|
+
"token_amount",
|
|
993
|
+
"value_usd",
|
|
994
|
+
"holders_count",
|
|
995
|
+
"total_inflows_count",
|
|
996
|
+
"total_outflows_count"
|
|
997
|
+
]
|
|
998
|
+
},
|
|
999
|
+
"dex-trades": {
|
|
1000
|
+
"description": "DEX trading activity",
|
|
1001
|
+
"options": {
|
|
1002
|
+
"token": {
|
|
1003
|
+
"type": "string",
|
|
1004
|
+
"required": true
|
|
1005
|
+
},
|
|
1006
|
+
"chain": {
|
|
1007
|
+
"type": "string",
|
|
1008
|
+
"default": "solana"
|
|
1009
|
+
},
|
|
1010
|
+
"smart-money": {
|
|
1011
|
+
"type": "boolean"
|
|
1012
|
+
},
|
|
1013
|
+
"days": {
|
|
1014
|
+
"type": "number",
|
|
1015
|
+
"default": 30
|
|
1016
|
+
},
|
|
1017
|
+
"limit": {
|
|
1018
|
+
"type": "number"
|
|
1019
|
+
},
|
|
1020
|
+
"sort": {
|
|
1021
|
+
"type": "string",
|
|
1022
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
1023
|
+
},
|
|
1024
|
+
"filters": {
|
|
1025
|
+
"type": "object",
|
|
1026
|
+
"description": "Additional filters as JSON"
|
|
1027
|
+
},
|
|
1028
|
+
"page": {
|
|
1029
|
+
"type": "number",
|
|
1030
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1031
|
+
}
|
|
1032
|
+
},
|
|
1033
|
+
"returns": [
|
|
1034
|
+
"block_timestamp",
|
|
1035
|
+
"transaction_hash",
|
|
1036
|
+
"trader_address",
|
|
1037
|
+
"trader_address_label",
|
|
1038
|
+
"action",
|
|
1039
|
+
"token_address",
|
|
1040
|
+
"token_name",
|
|
1041
|
+
"token_amount",
|
|
1042
|
+
"traded_token_address",
|
|
1043
|
+
"traded_token_name",
|
|
1044
|
+
"traded_token_amount",
|
|
1045
|
+
"estimated_swap_price_usd",
|
|
1046
|
+
"estimated_value_usd"
|
|
1047
|
+
]
|
|
1048
|
+
},
|
|
1049
|
+
"pnl": {
|
|
1050
|
+
"description": "PnL leaderboard",
|
|
1051
|
+
"options": {
|
|
1052
|
+
"token": {
|
|
1053
|
+
"type": "string",
|
|
1054
|
+
"required": true
|
|
1055
|
+
},
|
|
1056
|
+
"chain": {
|
|
1057
|
+
"type": "string",
|
|
1058
|
+
"default": "solana"
|
|
1059
|
+
},
|
|
1060
|
+
"days": {
|
|
1061
|
+
"type": "number",
|
|
1062
|
+
"default": 30
|
|
1063
|
+
},
|
|
1064
|
+
"limit": {
|
|
1065
|
+
"type": "number"
|
|
1066
|
+
},
|
|
1067
|
+
"sort": {
|
|
1068
|
+
"type": "string",
|
|
1069
|
+
"description": "Sort field:direction (e.g., total_pnl_usd:desc)"
|
|
1070
|
+
},
|
|
1071
|
+
"filters": {
|
|
1072
|
+
"type": "object",
|
|
1073
|
+
"description": "Additional filters as JSON"
|
|
1074
|
+
},
|
|
1075
|
+
"page": {
|
|
1076
|
+
"type": "number",
|
|
1077
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1078
|
+
}
|
|
1079
|
+
},
|
|
1080
|
+
"returns": [
|
|
1081
|
+
"trader_address",
|
|
1082
|
+
"trader_address_label",
|
|
1083
|
+
"price_usd",
|
|
1084
|
+
"pnl_usd_realised",
|
|
1085
|
+
"pnl_usd_unrealised",
|
|
1086
|
+
"holding_amount",
|
|
1087
|
+
"holding_usd",
|
|
1088
|
+
"max_balance_held",
|
|
1089
|
+
"max_balance_held_usd",
|
|
1090
|
+
"still_holding_balance_ratio",
|
|
1091
|
+
"netflow_amount_usd",
|
|
1092
|
+
"netflow_amount",
|
|
1093
|
+
"roi_percent_total",
|
|
1094
|
+
"roi_percent_realised",
|
|
1095
|
+
"roi_percent_unrealised",
|
|
1096
|
+
"pnl_usd_total",
|
|
1097
|
+
"nof_trades"
|
|
1098
|
+
]
|
|
1099
|
+
},
|
|
1100
|
+
"who-bought-sold": {
|
|
1101
|
+
"description": "Recent buyers and sellers",
|
|
1102
|
+
"options": {
|
|
1103
|
+
"token": {
|
|
1104
|
+
"type": "string",
|
|
1105
|
+
"required": true
|
|
1106
|
+
},
|
|
1107
|
+
"chain": {
|
|
1108
|
+
"type": "string",
|
|
1109
|
+
"default": "solana"
|
|
1110
|
+
},
|
|
1111
|
+
"date": {
|
|
1112
|
+
"type": "string",
|
|
1113
|
+
"required": false,
|
|
1114
|
+
"description": "Date or date range"
|
|
1115
|
+
},
|
|
1116
|
+
"days": {
|
|
1117
|
+
"type": "number",
|
|
1118
|
+
"default": 30
|
|
1119
|
+
},
|
|
1120
|
+
"limit": {
|
|
1121
|
+
"type": "number"
|
|
1122
|
+
},
|
|
1123
|
+
"sort": {
|
|
1124
|
+
"type": "string",
|
|
1125
|
+
"description": "Sort field:direction (e.g., trade_volume_usd:desc)"
|
|
1126
|
+
},
|
|
1127
|
+
"filters": {
|
|
1128
|
+
"type": "object",
|
|
1129
|
+
"description": "Additional filters as JSON"
|
|
1130
|
+
},
|
|
1131
|
+
"page": {
|
|
1132
|
+
"type": "number",
|
|
1133
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1134
|
+
}
|
|
1135
|
+
},
|
|
1136
|
+
"returns": [
|
|
1137
|
+
"address",
|
|
1138
|
+
"address_label",
|
|
1139
|
+
"bought_token_volume",
|
|
1140
|
+
"sold_token_volume",
|
|
1141
|
+
"token_trade_volume",
|
|
1142
|
+
"bought_volume_usd",
|
|
1143
|
+
"sold_volume_usd",
|
|
1144
|
+
"trade_volume_usd"
|
|
1145
|
+
]
|
|
1146
|
+
},
|
|
1147
|
+
"flow-intelligence": {
|
|
1148
|
+
"description": "Detailed flow intelligence by label",
|
|
1149
|
+
"options": {
|
|
1150
|
+
"token": {
|
|
1151
|
+
"type": "string",
|
|
1152
|
+
"required": true
|
|
1153
|
+
},
|
|
1154
|
+
"chain": {
|
|
1155
|
+
"type": "string",
|
|
1156
|
+
"default": "solana"
|
|
1157
|
+
},
|
|
1158
|
+
"days": {
|
|
1159
|
+
"type": "number",
|
|
1160
|
+
"default": 30
|
|
1161
|
+
}
|
|
1162
|
+
},
|
|
1163
|
+
"returns": [
|
|
1164
|
+
"public_figure_net_flow_usd",
|
|
1165
|
+
"public_figure_avg_flow_usd",
|
|
1166
|
+
"public_figure_wallet_count",
|
|
1167
|
+
"top_pnl_net_flow_usd",
|
|
1168
|
+
"top_pnl_avg_flow_usd",
|
|
1169
|
+
"top_pnl_wallet_count",
|
|
1170
|
+
"whale_net_flow_usd",
|
|
1171
|
+
"whale_avg_flow_usd",
|
|
1172
|
+
"whale_wallet_count",
|
|
1173
|
+
"smart_trader_net_flow_usd",
|
|
1174
|
+
"smart_trader_avg_flow_usd",
|
|
1175
|
+
"smart_trader_wallet_count",
|
|
1176
|
+
"exchange_net_flow_usd",
|
|
1177
|
+
"exchange_avg_flow_usd",
|
|
1178
|
+
"exchange_wallet_count",
|
|
1179
|
+
"fresh_wallets_net_flow_usd",
|
|
1180
|
+
"fresh_wallets_avg_flow_usd",
|
|
1181
|
+
"fresh_wallets_wallet_count"
|
|
1182
|
+
]
|
|
1183
|
+
},
|
|
1184
|
+
"transfers": {
|
|
1185
|
+
"description": "Token transfer history",
|
|
1186
|
+
"options": {
|
|
1187
|
+
"token": {
|
|
1188
|
+
"type": "string",
|
|
1189
|
+
"required": true
|
|
1190
|
+
},
|
|
1191
|
+
"chain": {
|
|
1192
|
+
"type": "string",
|
|
1193
|
+
"default": "solana"
|
|
1194
|
+
},
|
|
1195
|
+
"days": {
|
|
1196
|
+
"type": "number",
|
|
1197
|
+
"default": 30
|
|
1198
|
+
},
|
|
1199
|
+
"limit": {
|
|
1200
|
+
"type": "number"
|
|
1201
|
+
},
|
|
1202
|
+
"from": {
|
|
1203
|
+
"type": "string",
|
|
1204
|
+
"description": "Filter by sender address"
|
|
1205
|
+
},
|
|
1206
|
+
"to": {
|
|
1207
|
+
"type": "string",
|
|
1208
|
+
"description": "Filter by recipient address"
|
|
1209
|
+
},
|
|
1210
|
+
"enrich": {
|
|
1211
|
+
"type": "boolean",
|
|
1212
|
+
"description": "Enrich addresses with Nansen labels"
|
|
1213
|
+
},
|
|
1214
|
+
"sort": {
|
|
1215
|
+
"type": "string",
|
|
1216
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
1217
|
+
},
|
|
1218
|
+
"filters": {
|
|
1219
|
+
"type": "object",
|
|
1220
|
+
"description": "Additional filters as JSON"
|
|
1221
|
+
},
|
|
1222
|
+
"page": {
|
|
1223
|
+
"type": "number",
|
|
1224
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1225
|
+
}
|
|
1226
|
+
},
|
|
1227
|
+
"returns": [
|
|
1228
|
+
"block_timestamp",
|
|
1229
|
+
"transaction_hash",
|
|
1230
|
+
"from_address",
|
|
1231
|
+
"to_address",
|
|
1232
|
+
"from_address_label",
|
|
1233
|
+
"to_address_label",
|
|
1234
|
+
"transaction_type",
|
|
1235
|
+
"transfer_amount",
|
|
1236
|
+
"transfer_value_usd"
|
|
1237
|
+
]
|
|
1238
|
+
},
|
|
1239
|
+
"jup-dca": {
|
|
1240
|
+
"description": "Jupiter DCA orders for token",
|
|
1241
|
+
"options": {
|
|
1242
|
+
"token": {
|
|
1243
|
+
"type": "string",
|
|
1244
|
+
"required": true
|
|
1245
|
+
},
|
|
1246
|
+
"limit": {
|
|
1247
|
+
"type": "number"
|
|
1248
|
+
},
|
|
1249
|
+
"sort": {
|
|
1250
|
+
"type": "string",
|
|
1251
|
+
"description": "Sort field:direction (e.g., total_input:desc)"
|
|
1252
|
+
},
|
|
1253
|
+
"filters": {
|
|
1254
|
+
"type": "object",
|
|
1255
|
+
"description": "Additional filters as JSON"
|
|
1256
|
+
},
|
|
1257
|
+
"page": {
|
|
1258
|
+
"type": "number",
|
|
1259
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1260
|
+
}
|
|
1261
|
+
},
|
|
1262
|
+
"returns": [
|
|
1263
|
+
"since_timestamp",
|
|
1264
|
+
"last_timestamp",
|
|
1265
|
+
"trader_address",
|
|
1266
|
+
"creation_hash",
|
|
1267
|
+
"trader_label",
|
|
1268
|
+
"dca_vault_address",
|
|
1269
|
+
"input_mint_address",
|
|
1270
|
+
"output_mint_address",
|
|
1271
|
+
"deposit_amount",
|
|
1272
|
+
"deposit_spent",
|
|
1273
|
+
"other_token_redeemed",
|
|
1274
|
+
"status",
|
|
1275
|
+
"token_input",
|
|
1276
|
+
"token_output",
|
|
1277
|
+
"deposit_usd_value"
|
|
1278
|
+
]
|
|
1279
|
+
},
|
|
1280
|
+
"perp-trades": {
|
|
1281
|
+
"description": "Perp trades by token symbol",
|
|
1282
|
+
"options": {
|
|
1283
|
+
"symbol": {
|
|
1284
|
+
"type": "string",
|
|
1285
|
+
"required": true,
|
|
1286
|
+
"description": "Token symbol (e.g., BTC, ETH)"
|
|
1287
|
+
},
|
|
1288
|
+
"days": {
|
|
1289
|
+
"type": "number",
|
|
1290
|
+
"default": 30
|
|
1291
|
+
},
|
|
1292
|
+
"limit": {
|
|
1293
|
+
"type": "number"
|
|
1294
|
+
},
|
|
1295
|
+
"sort": {
|
|
1296
|
+
"type": "string",
|
|
1297
|
+
"description": "Sort field:direction (e.g., value_usd:desc)"
|
|
1298
|
+
},
|
|
1299
|
+
"filters": {
|
|
1300
|
+
"type": "object",
|
|
1301
|
+
"description": "Additional filters as JSON"
|
|
1302
|
+
},
|
|
1303
|
+
"page": {
|
|
1304
|
+
"type": "number",
|
|
1305
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1306
|
+
}
|
|
1307
|
+
},
|
|
1308
|
+
"returns": [
|
|
1309
|
+
"trader_address_label",
|
|
1310
|
+
"trader_address",
|
|
1311
|
+
"token_symbol",
|
|
1312
|
+
"side",
|
|
1313
|
+
"action",
|
|
1314
|
+
"token_amount",
|
|
1315
|
+
"price_usd",
|
|
1316
|
+
"value_usd",
|
|
1317
|
+
"type",
|
|
1318
|
+
"block_timestamp",
|
|
1319
|
+
"transaction_hash"
|
|
1320
|
+
]
|
|
1321
|
+
},
|
|
1322
|
+
"perp-positions": {
|
|
1323
|
+
"description": "Open perp positions by token symbol",
|
|
1324
|
+
"options": {
|
|
1325
|
+
"symbol": {
|
|
1326
|
+
"type": "string",
|
|
1327
|
+
"required": true
|
|
1328
|
+
},
|
|
1329
|
+
"limit": {
|
|
1330
|
+
"type": "number"
|
|
1331
|
+
},
|
|
1332
|
+
"sort": {
|
|
1333
|
+
"type": "string",
|
|
1334
|
+
"description": "Sort field:direction (e.g., unrealized_pnl:desc)"
|
|
1335
|
+
},
|
|
1336
|
+
"filters": {
|
|
1337
|
+
"type": "object",
|
|
1338
|
+
"description": "Additional filters as JSON"
|
|
1339
|
+
},
|
|
1340
|
+
"page": {
|
|
1341
|
+
"type": "number",
|
|
1342
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1343
|
+
}
|
|
1344
|
+
},
|
|
1345
|
+
"returns": [
|
|
1346
|
+
"address",
|
|
1347
|
+
"address_label",
|
|
1348
|
+
"side",
|
|
1349
|
+
"position_value_usd",
|
|
1350
|
+
"position_size",
|
|
1351
|
+
"leverage",
|
|
1352
|
+
"leverage_type",
|
|
1353
|
+
"entry_price",
|
|
1354
|
+
"mark_price",
|
|
1355
|
+
"liquidation_price",
|
|
1356
|
+
"funding_usd",
|
|
1357
|
+
"upnl_usd"
|
|
1358
|
+
]
|
|
1359
|
+
},
|
|
1360
|
+
"perp-pnl-leaderboard": {
|
|
1361
|
+
"description": "Perp PnL leaderboard by token",
|
|
1362
|
+
"options": {
|
|
1363
|
+
"symbol": {
|
|
1364
|
+
"type": "string",
|
|
1365
|
+
"required": true
|
|
1366
|
+
},
|
|
1367
|
+
"days": {
|
|
1368
|
+
"type": "number",
|
|
1369
|
+
"default": 30
|
|
1370
|
+
},
|
|
1371
|
+
"limit": {
|
|
1372
|
+
"type": "number"
|
|
1373
|
+
},
|
|
1374
|
+
"sort": {
|
|
1375
|
+
"type": "string",
|
|
1376
|
+
"description": "Sort field:direction (e.g., total_pnl:desc)"
|
|
1377
|
+
},
|
|
1378
|
+
"filters": {
|
|
1379
|
+
"type": "object",
|
|
1380
|
+
"description": "Additional filters as JSON"
|
|
1381
|
+
},
|
|
1382
|
+
"page": {
|
|
1383
|
+
"type": "number",
|
|
1384
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1385
|
+
}
|
|
1386
|
+
},
|
|
1387
|
+
"returns": [
|
|
1388
|
+
"trader_address",
|
|
1389
|
+
"trader_address_label",
|
|
1390
|
+
"price_usd",
|
|
1391
|
+
"pnl_usd_realised",
|
|
1392
|
+
"pnl_usd_unrealised",
|
|
1393
|
+
"holding_amount",
|
|
1394
|
+
"position_value_usd",
|
|
1395
|
+
"max_balance_held",
|
|
1396
|
+
"max_balance_held_usd",
|
|
1397
|
+
"still_holding_balance_ratio",
|
|
1398
|
+
"netflow_amount_usd",
|
|
1399
|
+
"netflow_amount",
|
|
1400
|
+
"roi_percent_total",
|
|
1401
|
+
"roi_percent_realised",
|
|
1402
|
+
"roi_percent_unrealised",
|
|
1403
|
+
"pnl_usd_total",
|
|
1404
|
+
"nof_trades"
|
|
1405
|
+
]
|
|
1406
|
+
}
|
|
1407
|
+
}
|
|
1408
|
+
},
|
|
1409
|
+
"search": {
|
|
1410
|
+
"description": "Search for tokens and entities across Nansen",
|
|
1411
|
+
"options": {
|
|
1412
|
+
"query": {
|
|
1413
|
+
"type": "string",
|
|
1414
|
+
"required": true,
|
|
1415
|
+
"description": "Search query (token name, symbol, address, or entity)"
|
|
1416
|
+
},
|
|
1417
|
+
"type": {
|
|
1418
|
+
"type": "string",
|
|
1419
|
+
"default": "any",
|
|
1420
|
+
"enum": [
|
|
1421
|
+
"token",
|
|
1422
|
+
"entity",
|
|
1423
|
+
"any"
|
|
1424
|
+
],
|
|
1425
|
+
"description": "Result type filter"
|
|
1426
|
+
},
|
|
1427
|
+
"chain": {
|
|
1428
|
+
"type": "string",
|
|
1429
|
+
"description": "Filter by chain (e.g., ethereum, solana)"
|
|
1430
|
+
},
|
|
1431
|
+
"limit": {
|
|
1432
|
+
"type": "number",
|
|
1433
|
+
"default": 25,
|
|
1434
|
+
"description": "Max results (1-50)"
|
|
1435
|
+
},
|
|
1436
|
+
"page": {
|
|
1437
|
+
"type": "number",
|
|
1438
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1439
|
+
}
|
|
1440
|
+
},
|
|
1441
|
+
"returns": [
|
|
1442
|
+
"tokens[name, symbol, chain, address, price]",
|
|
1443
|
+
"entities[name, tags, rank]",
|
|
1444
|
+
"total_results"
|
|
1445
|
+
]
|
|
1446
|
+
},
|
|
1447
|
+
"perp": {
|
|
1448
|
+
"description": "Perpetual futures analytics",
|
|
1449
|
+
"subcommands": {
|
|
1450
|
+
"screener": {
|
|
1451
|
+
"description": "Screen perpetual futures contracts",
|
|
1452
|
+
"options": {
|
|
1453
|
+
"days": {
|
|
1454
|
+
"type": "number",
|
|
1455
|
+
"default": 30
|
|
1456
|
+
},
|
|
1457
|
+
"limit": {
|
|
1458
|
+
"type": "number"
|
|
1459
|
+
},
|
|
1460
|
+
"sort": {
|
|
1461
|
+
"type": "string"
|
|
1462
|
+
},
|
|
1463
|
+
"filters": {
|
|
1464
|
+
"type": "object"
|
|
1465
|
+
},
|
|
1466
|
+
"page": {
|
|
1467
|
+
"type": "number",
|
|
1468
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1469
|
+
}
|
|
1470
|
+
},
|
|
1471
|
+
"returns": [
|
|
1472
|
+
"volume",
|
|
1473
|
+
"buy_volume",
|
|
1474
|
+
"sell_volume",
|
|
1475
|
+
"buy_sell_pressure",
|
|
1476
|
+
"trader_count",
|
|
1477
|
+
"token_symbol",
|
|
1478
|
+
"mark_price",
|
|
1479
|
+
"funding",
|
|
1480
|
+
"open_interest",
|
|
1481
|
+
"previous_price_usd"
|
|
1482
|
+
]
|
|
1483
|
+
},
|
|
1484
|
+
"leaderboard": {
|
|
1485
|
+
"description": "Perpetual futures PnL leaderboard",
|
|
1486
|
+
"options": {
|
|
1487
|
+
"days": {
|
|
1488
|
+
"type": "number",
|
|
1489
|
+
"default": 30
|
|
1490
|
+
},
|
|
1491
|
+
"limit": {
|
|
1492
|
+
"type": "number"
|
|
1493
|
+
},
|
|
1494
|
+
"sort": {
|
|
1495
|
+
"type": "string"
|
|
1496
|
+
},
|
|
1497
|
+
"filters": {
|
|
1498
|
+
"type": "object"
|
|
1499
|
+
},
|
|
1500
|
+
"page": {
|
|
1501
|
+
"type": "number",
|
|
1502
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1503
|
+
}
|
|
1504
|
+
},
|
|
1505
|
+
"returns": [
|
|
1506
|
+
"trader_address",
|
|
1507
|
+
"trader_address_label",
|
|
1508
|
+
"total_pnl",
|
|
1509
|
+
"roi",
|
|
1510
|
+
"account_value"
|
|
1511
|
+
]
|
|
1512
|
+
}
|
|
1513
|
+
}
|
|
1514
|
+
},
|
|
1515
|
+
"portfolio": {
|
|
1516
|
+
"description": "Portfolio analytics",
|
|
1517
|
+
"subcommands": {
|
|
1518
|
+
"defi": {
|
|
1519
|
+
"description": "DeFi holdings across protocols",
|
|
1520
|
+
"options": {
|
|
1521
|
+
"wallet": {
|
|
1522
|
+
"type": "string",
|
|
1523
|
+
"required": true,
|
|
1524
|
+
"description": "Wallet address"
|
|
1525
|
+
}
|
|
1526
|
+
},
|
|
1527
|
+
"returns": [
|
|
1528
|
+
"protocol_name",
|
|
1529
|
+
"chain",
|
|
1530
|
+
"total_value_usd",
|
|
1531
|
+
"total_assets_usd",
|
|
1532
|
+
"total_debts_usd",
|
|
1533
|
+
"total_rewards_usd",
|
|
1534
|
+
"tokens"
|
|
1535
|
+
]
|
|
1536
|
+
}
|
|
1537
|
+
}
|
|
1538
|
+
},
|
|
1539
|
+
"points": {
|
|
1540
|
+
"description": "Nansen Points analytics",
|
|
1541
|
+
"subcommands": {
|
|
1542
|
+
"leaderboard": {
|
|
1543
|
+
"description": "Points leaderboard",
|
|
1544
|
+
"options": {
|
|
1545
|
+
"tier": {
|
|
1546
|
+
"type": "string",
|
|
1547
|
+
"description": "Filter by tier"
|
|
1548
|
+
},
|
|
1549
|
+
"limit": {
|
|
1550
|
+
"type": "number"
|
|
1551
|
+
},
|
|
1552
|
+
"page": {
|
|
1553
|
+
"type": "number",
|
|
1554
|
+
"description": "Page number for paginated results (default: 1)"
|
|
1555
|
+
}
|
|
1556
|
+
},
|
|
1557
|
+
"returns": [
|
|
1558
|
+
"rank",
|
|
1559
|
+
"address",
|
|
1560
|
+
"address_label",
|
|
1561
|
+
"points",
|
|
1562
|
+
"tier"
|
|
1563
|
+
]
|
|
1564
|
+
}
|
|
1565
|
+
}
|
|
1566
|
+
}
|
|
1567
|
+
}
|
|
1568
|
+
},
|
|
1569
|
+
"trade": {
|
|
1570
|
+
"description": "DEX trading commands",
|
|
1571
|
+
"subcommands": {
|
|
1572
|
+
"quote": {
|
|
1573
|
+
"description": "Get a DEX swap quote (chain, tokens, amount)",
|
|
1574
|
+
"options": {
|
|
1575
|
+
"chain": {
|
|
1576
|
+
"type": "string",
|
|
1577
|
+
"default": "base",
|
|
1578
|
+
"description": "Blockchain (solana or base)"
|
|
1579
|
+
},
|
|
1580
|
+
"from": {
|
|
1581
|
+
"type": "string",
|
|
1582
|
+
"required": true,
|
|
1583
|
+
"description": "Token to sell (address or symbol)"
|
|
1584
|
+
},
|
|
1585
|
+
"to": {
|
|
1586
|
+
"type": "string",
|
|
1587
|
+
"required": true,
|
|
1588
|
+
"description": "Token to buy (address or symbol)"
|
|
1589
|
+
},
|
|
1590
|
+
"amount": {
|
|
1591
|
+
"type": "string",
|
|
1592
|
+
"required": true,
|
|
1593
|
+
"description": "Amount to swap"
|
|
1594
|
+
},
|
|
1595
|
+
"wallet": {
|
|
1596
|
+
"type": "string",
|
|
1597
|
+
"description": "Wallet name (or \"walletconnect\"/\"wc\" for WalletConnect, EVM only). A configured wallet is required — run `nansen wallet create` if you haven't set one up yet."
|
|
1598
|
+
}
|
|
1599
|
+
},
|
|
1600
|
+
"prerequisites": [
|
|
1601
|
+
"A local wallet must be configured. Run: nansen wallet create"
|
|
1602
|
+
]
|
|
1603
|
+
},
|
|
1604
|
+
"execute": {
|
|
1605
|
+
"description": "Sign and broadcast a quoted trade",
|
|
1606
|
+
"options": {
|
|
1607
|
+
"chain": {
|
|
1608
|
+
"type": "string",
|
|
1609
|
+
"default": "base",
|
|
1610
|
+
"description": "Blockchain (solana or base)"
|
|
1611
|
+
},
|
|
1612
|
+
"wallet": {
|
|
1613
|
+
"type": "string",
|
|
1614
|
+
"description": "Wallet name, or \"walletconnect\"/\"wc\" for WalletConnect (EVM only)"
|
|
1615
|
+
}
|
|
1616
|
+
}
|
|
1617
|
+
}
|
|
1618
|
+
}
|
|
1619
|
+
}
|
|
1620
|
+
},
|
|
1621
|
+
"globalOptions": {
|
|
1622
|
+
"pretty": {
|
|
1623
|
+
"type": "boolean",
|
|
1624
|
+
"description": "Format JSON output for readability"
|
|
1625
|
+
},
|
|
1626
|
+
"table": {
|
|
1627
|
+
"type": "boolean",
|
|
1628
|
+
"description": "Format output as human-readable table"
|
|
1629
|
+
},
|
|
1630
|
+
"fields": {
|
|
1631
|
+
"type": "string",
|
|
1632
|
+
"description": "Comma-separated list of fields to include in output"
|
|
1633
|
+
},
|
|
1634
|
+
"no-retry": {
|
|
1635
|
+
"type": "boolean",
|
|
1636
|
+
"description": "Disable automatic retry on rate limits/errors"
|
|
1637
|
+
},
|
|
1638
|
+
"retries": {
|
|
1639
|
+
"type": "number",
|
|
1640
|
+
"default": 3,
|
|
1641
|
+
"description": "Max retry attempts"
|
|
1642
|
+
},
|
|
1643
|
+
"format": {
|
|
1644
|
+
"type": "string",
|
|
1645
|
+
"enum": [
|
|
1646
|
+
"json",
|
|
1647
|
+
"csv"
|
|
1648
|
+
],
|
|
1649
|
+
"description": "Output format (default: json)"
|
|
1650
|
+
},
|
|
1651
|
+
"x402-payment-signature": {
|
|
1652
|
+
"type": "string",
|
|
1653
|
+
"description": "Pre-signed x402 payment signature header"
|
|
1654
|
+
}
|
|
1655
|
+
},
|
|
1656
|
+
"chains": [
|
|
1657
|
+
"ethereum",
|
|
1658
|
+
"solana",
|
|
1659
|
+
"base",
|
|
1660
|
+
"bnb",
|
|
1661
|
+
"arbitrum",
|
|
1662
|
+
"polygon",
|
|
1663
|
+
"optimism",
|
|
1664
|
+
"avalanche",
|
|
1665
|
+
"linea",
|
|
1666
|
+
"scroll",
|
|
1667
|
+
"mantle",
|
|
1668
|
+
"ronin",
|
|
1669
|
+
"sei",
|
|
1670
|
+
"plasma",
|
|
1671
|
+
"sonic",
|
|
1672
|
+
"monad",
|
|
1673
|
+
"hyperevm",
|
|
1674
|
+
"iotaevm"
|
|
1675
|
+
],
|
|
1676
|
+
"smartMoneyLabels": [
|
|
1677
|
+
"Fund",
|
|
1678
|
+
"Smart Trader",
|
|
1679
|
+
"30D Smart Trader",
|
|
1680
|
+
"90D Smart Trader",
|
|
1681
|
+
"180D Smart Trader",
|
|
1682
|
+
"Smart HL Perps Trader"
|
|
1683
|
+
]
|
|
1684
|
+
}
|