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