nansen-cli 1.43.0 → 1.44.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 +80 -0
- package/README.md +34 -0
- package/package.json +3 -3
- package/src/api.js +184 -23
- package/src/bridge.js +103 -5
- package/src/cli.js +47 -53
- package/src/commands/completion.js +652 -0
- package/src/commands/mcp.js +19 -3
- package/src/commands/research.js +199 -25
- package/src/hl-client.js +20 -8
- package/src/limit-order.js +31 -20
- package/src/mcp-verify.js +66 -1
- package/src/perp.js +72 -24
- package/src/query-options.js +32 -0
- package/src/schema.json +631 -131
- package/src/semver.js +26 -0
- package/src/telemetry.js +118 -19
- package/src/trading.js +196 -22
- package/src/transfer.js +4 -1
- package/src/update-check.js +13 -6
- package/src/wallet.js +10 -6
- package/src/x402.js +8 -1
package/src/schema.json
CHANGED
|
@@ -419,7 +419,9 @@
|
|
|
419
419
|
"description": "DeFi holdings across protocols",
|
|
420
420
|
"options": {
|
|
421
421
|
"wallet": {
|
|
422
|
-
"
|
|
422
|
+
"type": "string",
|
|
423
|
+
"required": true,
|
|
424
|
+
"description": "Wallet address to fetch DeFi positions for"
|
|
423
425
|
}
|
|
424
426
|
}
|
|
425
427
|
}
|
|
@@ -433,7 +435,9 @@
|
|
|
433
435
|
"description": "Net capital flows (inflows vs outflows)",
|
|
434
436
|
"options": {
|
|
435
437
|
"chain": {
|
|
436
|
-
"
|
|
438
|
+
"type": "string",
|
|
439
|
+
"default": "solana",
|
|
440
|
+
"description": "Chain to query"
|
|
437
441
|
}
|
|
438
442
|
}
|
|
439
443
|
},
|
|
@@ -442,7 +446,9 @@
|
|
|
442
446
|
"description": "Real-time DEX trading activity",
|
|
443
447
|
"options": {
|
|
444
448
|
"chain": {
|
|
445
|
-
"
|
|
449
|
+
"type": "string",
|
|
450
|
+
"default": "solana",
|
|
451
|
+
"description": "Chain to query"
|
|
446
452
|
}
|
|
447
453
|
}
|
|
448
454
|
},
|
|
@@ -459,7 +465,9 @@
|
|
|
459
465
|
"description": "Aggregated token balances",
|
|
460
466
|
"options": {
|
|
461
467
|
"chain": {
|
|
462
|
-
"
|
|
468
|
+
"type": "string",
|
|
469
|
+
"default": "solana",
|
|
470
|
+
"description": "Chain to query"
|
|
463
471
|
}
|
|
464
472
|
}
|
|
465
473
|
},
|
|
@@ -468,10 +476,14 @@
|
|
|
468
476
|
"description": "Historical holdings over time",
|
|
469
477
|
"options": {
|
|
470
478
|
"chain": {
|
|
471
|
-
"
|
|
479
|
+
"type": "string",
|
|
480
|
+
"default": "solana",
|
|
481
|
+
"description": "Chain to query"
|
|
472
482
|
},
|
|
473
483
|
"days": {
|
|
474
|
-
"
|
|
484
|
+
"type": "number",
|
|
485
|
+
"default": 30,
|
|
486
|
+
"description": "Lookback window in days"
|
|
475
487
|
}
|
|
476
488
|
}
|
|
477
489
|
}
|
|
@@ -485,13 +497,19 @@
|
|
|
485
497
|
"description": "Transaction history",
|
|
486
498
|
"options": {
|
|
487
499
|
"address": {
|
|
488
|
-
"
|
|
500
|
+
"type": "string",
|
|
501
|
+
"required": true,
|
|
502
|
+
"description": "Wallet address to profile"
|
|
489
503
|
},
|
|
490
504
|
"chain": {
|
|
491
|
-
"
|
|
505
|
+
"type": "string",
|
|
506
|
+
"default": "ethereum",
|
|
507
|
+
"description": "Chain to profile the address on"
|
|
492
508
|
},
|
|
493
509
|
"days": {
|
|
494
|
-
"
|
|
510
|
+
"type": "number",
|
|
511
|
+
"default": 30,
|
|
512
|
+
"description": "Lookback window in days"
|
|
495
513
|
}
|
|
496
514
|
}
|
|
497
515
|
},
|
|
@@ -500,13 +518,19 @@
|
|
|
500
518
|
"description": "Summarized PnL metrics",
|
|
501
519
|
"options": {
|
|
502
520
|
"address": {
|
|
503
|
-
"
|
|
521
|
+
"type": "string",
|
|
522
|
+
"required": true,
|
|
523
|
+
"description": "Wallet address to profile"
|
|
504
524
|
},
|
|
505
525
|
"chain": {
|
|
506
|
-
"
|
|
526
|
+
"type": "string",
|
|
527
|
+
"default": "ethereum",
|
|
528
|
+
"description": "Chain to profile the address on"
|
|
507
529
|
},
|
|
508
530
|
"days": {
|
|
509
|
-
"
|
|
531
|
+
"type": "number",
|
|
532
|
+
"default": 30,
|
|
533
|
+
"description": "Lookback window in days"
|
|
510
534
|
}
|
|
511
535
|
}
|
|
512
536
|
},
|
|
@@ -515,10 +539,14 @@
|
|
|
515
539
|
"description": "Current token holdings",
|
|
516
540
|
"options": {
|
|
517
541
|
"address": {
|
|
518
|
-
"
|
|
542
|
+
"type": "string",
|
|
543
|
+
"required": true,
|
|
544
|
+
"description": "Wallet address to profile"
|
|
519
545
|
},
|
|
520
546
|
"chain": {
|
|
521
|
-
"
|
|
547
|
+
"type": "string",
|
|
548
|
+
"default": "ethereum",
|
|
549
|
+
"description": "Chain to profile the address on"
|
|
522
550
|
}
|
|
523
551
|
}
|
|
524
552
|
},
|
|
@@ -527,13 +555,19 @@
|
|
|
527
555
|
"description": "Top counterparties by volume",
|
|
528
556
|
"options": {
|
|
529
557
|
"address": {
|
|
530
|
-
"
|
|
558
|
+
"type": "string",
|
|
559
|
+
"required": true,
|
|
560
|
+
"description": "Wallet address to profile"
|
|
531
561
|
},
|
|
532
562
|
"chain": {
|
|
533
|
-
"
|
|
563
|
+
"type": "string",
|
|
564
|
+
"default": "ethereum",
|
|
565
|
+
"description": "Chain to profile the address on"
|
|
534
566
|
},
|
|
535
567
|
"days": {
|
|
536
|
-
"
|
|
568
|
+
"type": "number",
|
|
569
|
+
"default": 30,
|
|
570
|
+
"description": "Lookback window in days"
|
|
537
571
|
}
|
|
538
572
|
}
|
|
539
573
|
},
|
|
@@ -542,13 +576,19 @@
|
|
|
542
576
|
"description": "Historical balances over time",
|
|
543
577
|
"options": {
|
|
544
578
|
"address": {
|
|
545
|
-
"
|
|
579
|
+
"type": "string",
|
|
580
|
+
"required": true,
|
|
581
|
+
"description": "Wallet address to profile"
|
|
546
582
|
},
|
|
547
583
|
"chain": {
|
|
548
|
-
"
|
|
584
|
+
"type": "string",
|
|
585
|
+
"default": "ethereum",
|
|
586
|
+
"description": "Chain to profile the address on"
|
|
549
587
|
},
|
|
550
588
|
"days": {
|
|
551
|
-
"
|
|
589
|
+
"type": "number",
|
|
590
|
+
"default": 30,
|
|
591
|
+
"description": "Lookback window in days"
|
|
552
592
|
}
|
|
553
593
|
}
|
|
554
594
|
},
|
|
@@ -557,10 +597,14 @@
|
|
|
557
597
|
"description": "Find wallets related to an address",
|
|
558
598
|
"options": {
|
|
559
599
|
"address": {
|
|
560
|
-
"
|
|
600
|
+
"type": "string",
|
|
601
|
+
"required": true,
|
|
602
|
+
"description": "Wallet address to profile"
|
|
561
603
|
},
|
|
562
604
|
"chain": {
|
|
563
|
-
"
|
|
605
|
+
"type": "string",
|
|
606
|
+
"default": "ethereum",
|
|
607
|
+
"description": "Chain to profile the address on"
|
|
564
608
|
}
|
|
565
609
|
}
|
|
566
610
|
},
|
|
@@ -569,7 +613,9 @@
|
|
|
569
613
|
"description": "Find the first wallet that funded an EVM address",
|
|
570
614
|
"options": {
|
|
571
615
|
"address": {
|
|
572
|
-
"
|
|
616
|
+
"type": "string",
|
|
617
|
+
"required": true,
|
|
618
|
+
"description": "Address whose first funder to find"
|
|
573
619
|
}
|
|
574
620
|
}
|
|
575
621
|
},
|
|
@@ -578,13 +624,19 @@
|
|
|
578
624
|
"description": "PnL and trade performance",
|
|
579
625
|
"options": {
|
|
580
626
|
"address": {
|
|
581
|
-
"
|
|
627
|
+
"type": "string",
|
|
628
|
+
"required": true,
|
|
629
|
+
"description": "Wallet address to profile"
|
|
582
630
|
},
|
|
583
631
|
"chain": {
|
|
584
|
-
"
|
|
632
|
+
"type": "string",
|
|
633
|
+
"default": "ethereum",
|
|
634
|
+
"description": "Chain to profile the address on"
|
|
585
635
|
},
|
|
586
636
|
"days": {
|
|
587
|
-
"
|
|
637
|
+
"type": "number",
|
|
638
|
+
"default": 30,
|
|
639
|
+
"description": "Lookback window in days"
|
|
588
640
|
}
|
|
589
641
|
}
|
|
590
642
|
},
|
|
@@ -593,10 +645,14 @@
|
|
|
593
645
|
"description": "Behavioral and entity labels",
|
|
594
646
|
"options": {
|
|
595
647
|
"address": {
|
|
596
|
-
"
|
|
648
|
+
"type": "string",
|
|
649
|
+
"required": true,
|
|
650
|
+
"description": "Wallet address to profile"
|
|
597
651
|
},
|
|
598
652
|
"chain": {
|
|
599
|
-
"
|
|
653
|
+
"type": "string",
|
|
654
|
+
"default": "ethereum",
|
|
655
|
+
"description": "Chain to profile the address on"
|
|
600
656
|
}
|
|
601
657
|
}
|
|
602
658
|
},
|
|
@@ -605,7 +661,9 @@
|
|
|
605
661
|
"description": "Current perpetual positions",
|
|
606
662
|
"options": {
|
|
607
663
|
"address": {
|
|
608
|
-
"
|
|
664
|
+
"type": "string",
|
|
665
|
+
"required": true,
|
|
666
|
+
"description": "Hyperliquid trader address"
|
|
609
667
|
}
|
|
610
668
|
}
|
|
611
669
|
},
|
|
@@ -614,10 +672,14 @@
|
|
|
614
672
|
"description": "Perpetual trading history",
|
|
615
673
|
"options": {
|
|
616
674
|
"address": {
|
|
617
|
-
"
|
|
675
|
+
"type": "string",
|
|
676
|
+
"required": true,
|
|
677
|
+
"description": "Hyperliquid trader address"
|
|
618
678
|
},
|
|
619
679
|
"days": {
|
|
620
|
-
"
|
|
680
|
+
"type": "number",
|
|
681
|
+
"default": 30,
|
|
682
|
+
"description": "Lookback window in days"
|
|
621
683
|
}
|
|
622
684
|
}
|
|
623
685
|
},
|
|
@@ -626,13 +688,19 @@
|
|
|
626
688
|
"description": "DEX trade history for a wallet",
|
|
627
689
|
"options": {
|
|
628
690
|
"address": {
|
|
629
|
-
"
|
|
691
|
+
"type": "string",
|
|
692
|
+
"required": true,
|
|
693
|
+
"description": "Wallet address to profile"
|
|
630
694
|
},
|
|
631
695
|
"chain": {
|
|
632
|
-
"
|
|
696
|
+
"type": "string",
|
|
697
|
+
"default": "ethereum",
|
|
698
|
+
"description": "Chain to profile the address on"
|
|
633
699
|
},
|
|
634
700
|
"days": {
|
|
635
|
-
"
|
|
701
|
+
"type": "number",
|
|
702
|
+
"default": 30,
|
|
703
|
+
"description": "Lookback window in days"
|
|
636
704
|
}
|
|
637
705
|
}
|
|
638
706
|
},
|
|
@@ -641,7 +709,9 @@
|
|
|
641
709
|
"description": "Search for entities by name",
|
|
642
710
|
"options": {
|
|
643
711
|
"query": {
|
|
644
|
-
"
|
|
712
|
+
"type": "string",
|
|
713
|
+
"required": true,
|
|
714
|
+
"description": "Entity or label name to search for"
|
|
645
715
|
}
|
|
646
716
|
}
|
|
647
717
|
},
|
|
@@ -649,13 +719,19 @@
|
|
|
649
719
|
"description": "Batch profile multiple addresses",
|
|
650
720
|
"options": {
|
|
651
721
|
"chain": {
|
|
652
|
-
"
|
|
722
|
+
"type": "string",
|
|
723
|
+
"default": "ethereum",
|
|
724
|
+
"description": "Chain to profile every address on"
|
|
653
725
|
},
|
|
654
726
|
"include": {
|
|
655
|
-
"
|
|
727
|
+
"type": "string",
|
|
728
|
+
"default": "labels,balance",
|
|
729
|
+
"description": "Comma-separated sections to fetch per address: labels, balance, pnl"
|
|
656
730
|
},
|
|
657
731
|
"delay": {
|
|
658
|
-
"
|
|
732
|
+
"type": "number",
|
|
733
|
+
"default": 1000,
|
|
734
|
+
"description": "Delay in milliseconds between API calls"
|
|
659
735
|
}
|
|
660
736
|
}
|
|
661
737
|
},
|
|
@@ -663,22 +739,34 @@
|
|
|
663
739
|
"description": "Multi-hop counterparty trace (BFS)",
|
|
664
740
|
"options": {
|
|
665
741
|
"address": {
|
|
666
|
-
"
|
|
742
|
+
"type": "string",
|
|
743
|
+
"required": true,
|
|
744
|
+
"description": "Address to start tracing from"
|
|
667
745
|
},
|
|
668
746
|
"chain": {
|
|
669
|
-
"
|
|
747
|
+
"type": "string",
|
|
748
|
+
"default": "ethereum",
|
|
749
|
+
"description": "Chain to profile the address on"
|
|
670
750
|
},
|
|
671
751
|
"depth": {
|
|
672
|
-
"
|
|
752
|
+
"type": "number",
|
|
753
|
+
"default": 2,
|
|
754
|
+
"description": "Hops to follow from the starting address (1-5)"
|
|
673
755
|
},
|
|
674
756
|
"width": {
|
|
675
|
-
"
|
|
757
|
+
"type": "number",
|
|
758
|
+
"default": 10,
|
|
759
|
+
"description": "Counterparties to follow at each hop"
|
|
676
760
|
},
|
|
677
761
|
"days": {
|
|
678
|
-
"
|
|
762
|
+
"type": "number",
|
|
763
|
+
"default": 30,
|
|
764
|
+
"description": "Lookback window in days at each hop"
|
|
679
765
|
},
|
|
680
766
|
"delay": {
|
|
681
|
-
"
|
|
767
|
+
"type": "number",
|
|
768
|
+
"default": 1000,
|
|
769
|
+
"description": "Delay in milliseconds between API calls"
|
|
682
770
|
}
|
|
683
771
|
}
|
|
684
772
|
},
|
|
@@ -686,13 +774,19 @@
|
|
|
686
774
|
"description": "Compare two wallets (shared counterparties, tokens)",
|
|
687
775
|
"options": {
|
|
688
776
|
"addresses": {
|
|
689
|
-
"
|
|
777
|
+
"type": "string",
|
|
778
|
+
"required": true,
|
|
779
|
+
"description": "Comma-separated list (or JSON array) of wallet addresses to compare"
|
|
690
780
|
},
|
|
691
781
|
"chain": {
|
|
692
|
-
"
|
|
782
|
+
"type": "string",
|
|
783
|
+
"default": "ethereum",
|
|
784
|
+
"description": "Chain to compare the wallets on"
|
|
693
785
|
},
|
|
694
786
|
"days": {
|
|
695
|
-
"
|
|
787
|
+
"type": "number",
|
|
788
|
+
"default": 30,
|
|
789
|
+
"description": "Lookback window in days"
|
|
696
790
|
}
|
|
697
791
|
}
|
|
698
792
|
}
|
|
@@ -706,13 +800,19 @@
|
|
|
706
800
|
"description": "Token flow metrics",
|
|
707
801
|
"options": {
|
|
708
802
|
"chain": {
|
|
709
|
-
"
|
|
803
|
+
"type": "string",
|
|
804
|
+
"default": "solana",
|
|
805
|
+
"description": "Chain the token lives on"
|
|
710
806
|
},
|
|
711
807
|
"token": {
|
|
712
|
-
"
|
|
808
|
+
"type": "string",
|
|
809
|
+
"required": true,
|
|
810
|
+
"description": "Token contract address (mint address on Solana)"
|
|
713
811
|
},
|
|
714
812
|
"days": {
|
|
715
|
-
"
|
|
813
|
+
"type": "number",
|
|
814
|
+
"default": 30,
|
|
815
|
+
"description": "Lookback window in days"
|
|
716
816
|
},
|
|
717
817
|
"label": {
|
|
718
818
|
"description": "Holder segment to filter flows by",
|
|
@@ -732,13 +832,19 @@
|
|
|
732
832
|
"description": "Recent buyers and sellers",
|
|
733
833
|
"options": {
|
|
734
834
|
"chain": {
|
|
735
|
-
"
|
|
835
|
+
"type": "string",
|
|
836
|
+
"default": "solana",
|
|
837
|
+
"description": "Chain the token lives on"
|
|
736
838
|
},
|
|
737
839
|
"token": {
|
|
738
|
-
"
|
|
840
|
+
"type": "string",
|
|
841
|
+
"required": true,
|
|
842
|
+
"description": "Token contract address (mint address on Solana)"
|
|
739
843
|
},
|
|
740
844
|
"days": {
|
|
741
|
-
"
|
|
845
|
+
"type": "number",
|
|
846
|
+
"default": 30,
|
|
847
|
+
"description": "Lookback window in days"
|
|
742
848
|
},
|
|
743
849
|
"buy-or-sell": {
|
|
744
850
|
"description": "Filter by buy or sell side",
|
|
@@ -755,13 +861,19 @@
|
|
|
755
861
|
"description": "DEX trading activity",
|
|
756
862
|
"options": {
|
|
757
863
|
"chain": {
|
|
758
|
-
"
|
|
864
|
+
"type": "string",
|
|
865
|
+
"default": "solana",
|
|
866
|
+
"description": "Chain the token lives on"
|
|
759
867
|
},
|
|
760
868
|
"token": {
|
|
761
|
-
"
|
|
869
|
+
"type": "string",
|
|
870
|
+
"required": true,
|
|
871
|
+
"description": "Token contract address (mint address on Solana)"
|
|
762
872
|
},
|
|
763
873
|
"days": {
|
|
764
|
-
"
|
|
874
|
+
"type": "number",
|
|
875
|
+
"default": 30,
|
|
876
|
+
"description": "Lookback window in days"
|
|
765
877
|
}
|
|
766
878
|
}
|
|
767
879
|
},
|
|
@@ -770,13 +882,19 @@
|
|
|
770
882
|
"description": "Token transfer history",
|
|
771
883
|
"options": {
|
|
772
884
|
"chain": {
|
|
773
|
-
"
|
|
885
|
+
"type": "string",
|
|
886
|
+
"default": "solana",
|
|
887
|
+
"description": "Chain the token lives on"
|
|
774
888
|
},
|
|
775
889
|
"token": {
|
|
776
|
-
"
|
|
890
|
+
"type": "string",
|
|
891
|
+
"required": true,
|
|
892
|
+
"description": "Token contract address (mint address on Solana)"
|
|
777
893
|
},
|
|
778
894
|
"days": {
|
|
779
|
-
"
|
|
895
|
+
"type": "number",
|
|
896
|
+
"default": 30,
|
|
897
|
+
"description": "Lookback window in days"
|
|
780
898
|
}
|
|
781
899
|
}
|
|
782
900
|
},
|
|
@@ -785,10 +903,14 @@
|
|
|
785
903
|
"description": "Token holder analysis",
|
|
786
904
|
"options": {
|
|
787
905
|
"chain": {
|
|
788
|
-
"
|
|
906
|
+
"type": "string",
|
|
907
|
+
"default": "solana",
|
|
908
|
+
"description": "Chain the token lives on"
|
|
789
909
|
},
|
|
790
910
|
"token": {
|
|
791
|
-
"
|
|
911
|
+
"type": "string",
|
|
912
|
+
"required": true,
|
|
913
|
+
"description": "Token contract address (mint address on Solana)"
|
|
792
914
|
},
|
|
793
915
|
"premium-labels": {
|
|
794
916
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
@@ -801,13 +923,19 @@
|
|
|
801
923
|
"description": "PnL leaderboard",
|
|
802
924
|
"options": {
|
|
803
925
|
"chain": {
|
|
804
|
-
"
|
|
926
|
+
"type": "string",
|
|
927
|
+
"default": "solana",
|
|
928
|
+
"description": "Chain the token lives on"
|
|
805
929
|
},
|
|
806
930
|
"token": {
|
|
807
|
-
"
|
|
931
|
+
"type": "string",
|
|
932
|
+
"required": true,
|
|
933
|
+
"description": "Token contract address (mint address on Solana)"
|
|
808
934
|
},
|
|
809
935
|
"days": {
|
|
810
|
-
"
|
|
936
|
+
"type": "number",
|
|
937
|
+
"default": 30,
|
|
938
|
+
"description": "Lookback window in days"
|
|
811
939
|
},
|
|
812
940
|
"premium-labels": {
|
|
813
941
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
@@ -820,10 +948,14 @@
|
|
|
820
948
|
"description": "Perp PnL leaderboard by token",
|
|
821
949
|
"options": {
|
|
822
950
|
"symbol": {
|
|
823
|
-
"
|
|
951
|
+
"type": "string",
|
|
952
|
+
"required": true,
|
|
953
|
+
"description": "Perp symbol, e.g. BTC"
|
|
824
954
|
},
|
|
825
955
|
"days": {
|
|
826
|
-
"
|
|
956
|
+
"type": "number",
|
|
957
|
+
"default": 30,
|
|
958
|
+
"description": "Lookback window in days"
|
|
827
959
|
},
|
|
828
960
|
"premium-labels": {
|
|
829
961
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
@@ -836,7 +968,9 @@
|
|
|
836
968
|
"description": "Open perp positions by token symbol",
|
|
837
969
|
"options": {
|
|
838
970
|
"symbol": {
|
|
839
|
-
"
|
|
971
|
+
"type": "string",
|
|
972
|
+
"required": true,
|
|
973
|
+
"description": "Perp symbol, e.g. BTC"
|
|
840
974
|
}
|
|
841
975
|
}
|
|
842
976
|
},
|
|
@@ -845,10 +979,14 @@
|
|
|
845
979
|
"description": "Perp trades by token symbol",
|
|
846
980
|
"options": {
|
|
847
981
|
"symbol": {
|
|
848
|
-
"
|
|
982
|
+
"type": "string",
|
|
983
|
+
"required": true,
|
|
984
|
+
"description": "Perp symbol, e.g. BTC"
|
|
849
985
|
},
|
|
850
986
|
"days": {
|
|
851
|
-
"
|
|
987
|
+
"type": "number",
|
|
988
|
+
"default": 30,
|
|
989
|
+
"description": "Lookback window in days"
|
|
852
990
|
}
|
|
853
991
|
}
|
|
854
992
|
},
|
|
@@ -857,13 +995,19 @@
|
|
|
857
995
|
"description": "Detailed flow intelligence by label",
|
|
858
996
|
"options": {
|
|
859
997
|
"chain": {
|
|
860
|
-
"
|
|
998
|
+
"type": "string",
|
|
999
|
+
"default": "solana",
|
|
1000
|
+
"description": "Chain the token lives on"
|
|
861
1001
|
},
|
|
862
1002
|
"token": {
|
|
863
|
-
"
|
|
1003
|
+
"type": "string",
|
|
1004
|
+
"required": true,
|
|
1005
|
+
"description": "Token contract address (mint address on Solana)"
|
|
864
1006
|
},
|
|
865
1007
|
"timeframe": {
|
|
866
|
-
"
|
|
1008
|
+
"type": "string",
|
|
1009
|
+
"default": "1d",
|
|
1010
|
+
"description": "Time window for the flow metrics"
|
|
867
1011
|
}
|
|
868
1012
|
}
|
|
869
1013
|
},
|
|
@@ -872,13 +1016,19 @@
|
|
|
872
1016
|
"description": "Get detailed information for a specific token",
|
|
873
1017
|
"options": {
|
|
874
1018
|
"chain": {
|
|
875
|
-
"
|
|
1019
|
+
"type": "string",
|
|
1020
|
+
"default": "solana",
|
|
1021
|
+
"description": "Chain the token lives on"
|
|
876
1022
|
},
|
|
877
1023
|
"token": {
|
|
878
|
-
"
|
|
1024
|
+
"type": "string",
|
|
1025
|
+
"required": true,
|
|
1026
|
+
"description": "Token contract address (mint address on Solana)"
|
|
879
1027
|
},
|
|
880
1028
|
"timeframe": {
|
|
881
|
-
"
|
|
1029
|
+
"type": "string",
|
|
1030
|
+
"default": "1d",
|
|
1031
|
+
"description": "Time window for the price-change and volume fields"
|
|
882
1032
|
}
|
|
883
1033
|
}
|
|
884
1034
|
},
|
|
@@ -887,10 +1037,14 @@
|
|
|
887
1037
|
"description": "Risk and reward indicators for a token (Nansen Score)",
|
|
888
1038
|
"options": {
|
|
889
1039
|
"chain": {
|
|
890
|
-
"
|
|
1040
|
+
"type": "string",
|
|
1041
|
+
"default": "ethereum",
|
|
1042
|
+
"description": "Chain the token lives on"
|
|
891
1043
|
},
|
|
892
1044
|
"token": {
|
|
893
|
-
"
|
|
1045
|
+
"type": "string",
|
|
1046
|
+
"required": true,
|
|
1047
|
+
"description": "Token contract address"
|
|
894
1048
|
}
|
|
895
1049
|
}
|
|
896
1050
|
},
|
|
@@ -899,13 +1053,19 @@
|
|
|
899
1053
|
"description": "OHLCV candle data for a token",
|
|
900
1054
|
"options": {
|
|
901
1055
|
"chain": {
|
|
902
|
-
"
|
|
1056
|
+
"type": "string",
|
|
1057
|
+
"default": "solana",
|
|
1058
|
+
"description": "Chain the token lives on"
|
|
903
1059
|
},
|
|
904
1060
|
"token": {
|
|
905
|
-
"
|
|
1061
|
+
"type": "string",
|
|
1062
|
+
"required": true,
|
|
1063
|
+
"description": "Token contract address (mint address on Solana)"
|
|
906
1064
|
},
|
|
907
1065
|
"timeframe": {
|
|
908
|
-
"
|
|
1066
|
+
"type": "string",
|
|
1067
|
+
"default": "1d",
|
|
1068
|
+
"description": "Candle interval"
|
|
909
1069
|
}
|
|
910
1070
|
}
|
|
911
1071
|
},
|
|
@@ -914,7 +1074,9 @@
|
|
|
914
1074
|
"description": "Jupiter DCA orders for token",
|
|
915
1075
|
"options": {
|
|
916
1076
|
"token": {
|
|
917
|
-
"
|
|
1077
|
+
"type": "string",
|
|
1078
|
+
"required": true,
|
|
1079
|
+
"description": "Token mint address"
|
|
918
1080
|
}
|
|
919
1081
|
}
|
|
920
1082
|
},
|
|
@@ -923,10 +1085,14 @@
|
|
|
923
1085
|
"description": "Discover and filter tokens",
|
|
924
1086
|
"options": {
|
|
925
1087
|
"timeframe": {
|
|
926
|
-
"
|
|
1088
|
+
"type": "string",
|
|
1089
|
+
"default": "24h",
|
|
1090
|
+
"description": "Time window for volume, flow, and price-change metrics"
|
|
927
1091
|
},
|
|
928
1092
|
"chain": {
|
|
929
|
-
"
|
|
1093
|
+
"type": "string",
|
|
1094
|
+
"default": "solana",
|
|
1095
|
+
"description": "Chain the token lives on"
|
|
930
1096
|
},
|
|
931
1097
|
"include-stablecoins": {
|
|
932
1098
|
"description": "Whether to include stablecoins in screener results (default true on API side)",
|
|
@@ -947,7 +1113,9 @@
|
|
|
947
1113
|
]
|
|
948
1114
|
},
|
|
949
1115
|
"limit": {
|
|
950
|
-
"
|
|
1116
|
+
"type": "number",
|
|
1117
|
+
"default": 25,
|
|
1118
|
+
"description": "Number of tokens to return"
|
|
951
1119
|
}
|
|
952
1120
|
}
|
|
953
1121
|
}
|
|
@@ -959,13 +1127,20 @@
|
|
|
959
1127
|
"description": "Search for tokens and entities across Nansen",
|
|
960
1128
|
"options": {
|
|
961
1129
|
"query": {
|
|
962
|
-
"
|
|
1130
|
+
"type": "string",
|
|
1131
|
+
"required": true,
|
|
1132
|
+
"description": "Token name, symbol, or address, or an entity name"
|
|
963
1133
|
},
|
|
964
1134
|
"type": {
|
|
965
|
-
"
|
|
1135
|
+
"type": "string",
|
|
1136
|
+
"default": "any",
|
|
1137
|
+
"enum": ["any", "token", "entity"],
|
|
1138
|
+
"description": "Result type: token, entity, or any"
|
|
966
1139
|
},
|
|
967
1140
|
"limit": {
|
|
968
|
-
"
|
|
1141
|
+
"type": "number",
|
|
1142
|
+
"default": 25,
|
|
1143
|
+
"description": "Maximum number of results"
|
|
969
1144
|
}
|
|
970
1145
|
}
|
|
971
1146
|
},
|
|
@@ -976,7 +1151,9 @@
|
|
|
976
1151
|
"description": "Screen perpetual futures contracts",
|
|
977
1152
|
"options": {
|
|
978
1153
|
"days": {
|
|
979
|
-
"
|
|
1154
|
+
"type": "number",
|
|
1155
|
+
"default": 30,
|
|
1156
|
+
"description": "Lookback window in days"
|
|
980
1157
|
},
|
|
981
1158
|
"trader-type": {
|
|
982
1159
|
"description": "Filter by trader type. One of: all, sm, whale, public_figure, high_winrate_hl_perps_trader. Defaults to all.",
|
|
@@ -1004,7 +1181,9 @@
|
|
|
1004
1181
|
"description": "Perpetual futures PnL leaderboard",
|
|
1005
1182
|
"options": {
|
|
1006
1183
|
"days": {
|
|
1007
|
-
"
|
|
1184
|
+
"type": "number",
|
|
1185
|
+
"default": 30,
|
|
1186
|
+
"description": "Lookback window in days"
|
|
1008
1187
|
},
|
|
1009
1188
|
"premium-labels": {
|
|
1010
1189
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
@@ -1022,7 +1201,9 @@
|
|
|
1022
1201
|
"description": "Get Prediction Market OHLCV Candles",
|
|
1023
1202
|
"options": {
|
|
1024
1203
|
"market-id": {
|
|
1025
|
-
"
|
|
1204
|
+
"type": "string",
|
|
1205
|
+
"required": true,
|
|
1206
|
+
"description": "Polymarket market ID (numeric, from the screener)"
|
|
1026
1207
|
}
|
|
1027
1208
|
}
|
|
1028
1209
|
},
|
|
@@ -1031,7 +1212,9 @@
|
|
|
1031
1212
|
"description": "Get Prediction Market Orderbook",
|
|
1032
1213
|
"options": {
|
|
1033
1214
|
"market-id": {
|
|
1034
|
-
"
|
|
1215
|
+
"type": "string",
|
|
1216
|
+
"required": true,
|
|
1217
|
+
"description": "Polymarket market ID (numeric, from the screener)"
|
|
1035
1218
|
}
|
|
1036
1219
|
}
|
|
1037
1220
|
},
|
|
@@ -1040,7 +1223,9 @@
|
|
|
1040
1223
|
"description": "Get Prediction Market Top Holders",
|
|
1041
1224
|
"options": {
|
|
1042
1225
|
"market-id": {
|
|
1043
|
-
"
|
|
1226
|
+
"type": "string",
|
|
1227
|
+
"required": true,
|
|
1228
|
+
"description": "Polymarket market ID (numeric, from the screener)"
|
|
1044
1229
|
}
|
|
1045
1230
|
}
|
|
1046
1231
|
},
|
|
@@ -1049,7 +1234,9 @@
|
|
|
1049
1234
|
"description": "Get Prediction Market Trades by Market",
|
|
1050
1235
|
"options": {
|
|
1051
1236
|
"market-id": {
|
|
1052
|
-
"
|
|
1237
|
+
"type": "string",
|
|
1238
|
+
"required": true,
|
|
1239
|
+
"description": "Polymarket market ID (numeric, from the screener)"
|
|
1053
1240
|
}
|
|
1054
1241
|
}
|
|
1055
1242
|
},
|
|
@@ -1058,25 +1245,70 @@
|
|
|
1058
1245
|
"description": "Get Prediction Market Screener",
|
|
1059
1246
|
"options": {
|
|
1060
1247
|
"query": {
|
|
1061
|
-
"
|
|
1248
|
+
"type": "string",
|
|
1249
|
+
"default": "",
|
|
1250
|
+
"description": "Text filter on market titles"
|
|
1062
1251
|
},
|
|
1063
1252
|
"sort-by": {
|
|
1064
1253
|
"description": "Deprecated: use --sort field:dir instead"
|
|
1065
1254
|
},
|
|
1066
|
-
"tags": {
|
|
1067
|
-
|
|
1068
|
-
|
|
1069
|
-
|
|
1070
|
-
"
|
|
1071
|
-
|
|
1072
|
-
|
|
1073
|
-
|
|
1074
|
-
"
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1078
|
-
"min-
|
|
1079
|
-
|
|
1255
|
+
"tags": {
|
|
1256
|
+
"type": "string",
|
|
1257
|
+
"description": "Comma-separated Polymarket tags to filter by"
|
|
1258
|
+
},
|
|
1259
|
+
"min-liquidity": {
|
|
1260
|
+
"type": "number",
|
|
1261
|
+
"description": "Minimum liquidity in USD"
|
|
1262
|
+
},
|
|
1263
|
+
"max-liquidity": {
|
|
1264
|
+
"type": "number",
|
|
1265
|
+
"description": "Maximum liquidity in USD"
|
|
1266
|
+
},
|
|
1267
|
+
"min-unique-traders-24h": {
|
|
1268
|
+
"type": "number",
|
|
1269
|
+
"description": "Minimum unique traders in the last 24 hours"
|
|
1270
|
+
},
|
|
1271
|
+
"max-unique-traders-24h": {
|
|
1272
|
+
"type": "number",
|
|
1273
|
+
"description": "Maximum unique traders in the last 24 hours"
|
|
1274
|
+
},
|
|
1275
|
+
"min-volume-24hr": {
|
|
1276
|
+
"type": "number",
|
|
1277
|
+
"description": "Minimum 24-hour volume in USD"
|
|
1278
|
+
},
|
|
1279
|
+
"max-volume-24hr": {
|
|
1280
|
+
"type": "number",
|
|
1281
|
+
"description": "Maximum 24-hour volume in USD"
|
|
1282
|
+
},
|
|
1283
|
+
"neg-risk": {
|
|
1284
|
+
"type": "boolean",
|
|
1285
|
+
"enum": ["true", "false"],
|
|
1286
|
+
"description": "Only negative-risk markets (true, or the bare flag) or only standard markets (false)"
|
|
1287
|
+
},
|
|
1288
|
+
"min-open-interest": {
|
|
1289
|
+
"type": "number",
|
|
1290
|
+
"description": "Minimum open interest in USD"
|
|
1291
|
+
},
|
|
1292
|
+
"max-open-interest": {
|
|
1293
|
+
"type": "number",
|
|
1294
|
+
"description": "Maximum open interest in USD"
|
|
1295
|
+
},
|
|
1296
|
+
"end-date-before": {
|
|
1297
|
+
"type": "string",
|
|
1298
|
+
"description": "Only markets ending before this date (ISO 8601)"
|
|
1299
|
+
},
|
|
1300
|
+
"end-date-after": {
|
|
1301
|
+
"type": "string",
|
|
1302
|
+
"description": "Only markets ending after this date (ISO 8601)"
|
|
1303
|
+
},
|
|
1304
|
+
"min-price": {
|
|
1305
|
+
"type": "number",
|
|
1306
|
+
"description": "Minimum outcome price (0-1)"
|
|
1307
|
+
},
|
|
1308
|
+
"max-price": {
|
|
1309
|
+
"type": "number",
|
|
1310
|
+
"description": "Maximum outcome price (0-1)"
|
|
1311
|
+
}
|
|
1080
1312
|
}
|
|
1081
1313
|
},
|
|
1082
1314
|
"event-screener": {
|
|
@@ -1084,23 +1316,62 @@
|
|
|
1084
1316
|
"description": "Get Prediction Market Event Screener",
|
|
1085
1317
|
"options": {
|
|
1086
1318
|
"query": {
|
|
1087
|
-
"
|
|
1319
|
+
"type": "string",
|
|
1320
|
+
"default": "",
|
|
1321
|
+
"description": "Text filter on event titles"
|
|
1088
1322
|
},
|
|
1089
1323
|
"sort-by": {
|
|
1090
1324
|
"description": "Deprecated: use --sort field:dir instead"
|
|
1091
1325
|
},
|
|
1092
|
-
"tags": {
|
|
1093
|
-
|
|
1094
|
-
|
|
1095
|
-
|
|
1096
|
-
"
|
|
1097
|
-
|
|
1098
|
-
|
|
1099
|
-
|
|
1100
|
-
"
|
|
1101
|
-
|
|
1102
|
-
|
|
1103
|
-
|
|
1326
|
+
"tags": {
|
|
1327
|
+
"type": "string",
|
|
1328
|
+
"description": "Comma-separated Polymarket tags to filter by"
|
|
1329
|
+
},
|
|
1330
|
+
"min-liquidity": {
|
|
1331
|
+
"type": "number",
|
|
1332
|
+
"description": "Minimum liquidity in USD"
|
|
1333
|
+
},
|
|
1334
|
+
"max-liquidity": {
|
|
1335
|
+
"type": "number",
|
|
1336
|
+
"description": "Maximum liquidity in USD"
|
|
1337
|
+
},
|
|
1338
|
+
"min-unique-traders-24h": {
|
|
1339
|
+
"type": "number",
|
|
1340
|
+
"description": "Minimum unique traders in the last 24 hours"
|
|
1341
|
+
},
|
|
1342
|
+
"max-unique-traders-24h": {
|
|
1343
|
+
"type": "number",
|
|
1344
|
+
"description": "Maximum unique traders in the last 24 hours"
|
|
1345
|
+
},
|
|
1346
|
+
"min-volume-24hr": {
|
|
1347
|
+
"type": "number",
|
|
1348
|
+
"description": "Minimum 24-hour volume in USD"
|
|
1349
|
+
},
|
|
1350
|
+
"max-volume-24hr": {
|
|
1351
|
+
"type": "number",
|
|
1352
|
+
"description": "Maximum 24-hour volume in USD"
|
|
1353
|
+
},
|
|
1354
|
+
"neg-risk": {
|
|
1355
|
+
"type": "boolean",
|
|
1356
|
+
"enum": ["true", "false"],
|
|
1357
|
+
"description": "Only negative-risk markets (true, or the bare flag) or only standard markets (false)"
|
|
1358
|
+
},
|
|
1359
|
+
"min-open-interest": {
|
|
1360
|
+
"type": "number",
|
|
1361
|
+
"description": "Minimum open interest in USD"
|
|
1362
|
+
},
|
|
1363
|
+
"max-open-interest": {
|
|
1364
|
+
"type": "number",
|
|
1365
|
+
"description": "Maximum open interest in USD"
|
|
1366
|
+
},
|
|
1367
|
+
"end-date-before": {
|
|
1368
|
+
"type": "string",
|
|
1369
|
+
"description": "Only events ending before this date (ISO 8601)"
|
|
1370
|
+
},
|
|
1371
|
+
"end-date-after": {
|
|
1372
|
+
"type": "string",
|
|
1373
|
+
"description": "Only events ending after this date (ISO 8601)"
|
|
1374
|
+
}
|
|
1104
1375
|
}
|
|
1105
1376
|
},
|
|
1106
1377
|
"pnl-by-market": {
|
|
@@ -1108,7 +1379,9 @@
|
|
|
1108
1379
|
"description": "Get Prediction Market PnL by Market",
|
|
1109
1380
|
"options": {
|
|
1110
1381
|
"market-id": {
|
|
1111
|
-
"
|
|
1382
|
+
"type": "string",
|
|
1383
|
+
"required": true,
|
|
1384
|
+
"description": "Polymarket market ID (numeric, from the screener)"
|
|
1112
1385
|
}
|
|
1113
1386
|
}
|
|
1114
1387
|
},
|
|
@@ -1117,7 +1390,9 @@
|
|
|
1117
1390
|
"description": "Get Prediction Market PnL by Address",
|
|
1118
1391
|
"options": {
|
|
1119
1392
|
"address": {
|
|
1120
|
-
"
|
|
1393
|
+
"type": "string",
|
|
1394
|
+
"required": true,
|
|
1395
|
+
"description": "Polymarket trader address"
|
|
1121
1396
|
}
|
|
1122
1397
|
}
|
|
1123
1398
|
},
|
|
@@ -1126,7 +1401,9 @@
|
|
|
1126
1401
|
"description": "Get Prediction Market Position Detail",
|
|
1127
1402
|
"options": {
|
|
1128
1403
|
"market-id": {
|
|
1129
|
-
"
|
|
1404
|
+
"type": "string",
|
|
1405
|
+
"required": true,
|
|
1406
|
+
"description": "Polymarket market ID (numeric, from the screener)"
|
|
1130
1407
|
}
|
|
1131
1408
|
}
|
|
1132
1409
|
},
|
|
@@ -1135,7 +1412,9 @@
|
|
|
1135
1412
|
"description": "Get Prediction Market Trades by Address",
|
|
1136
1413
|
"options": {
|
|
1137
1414
|
"address": {
|
|
1138
|
-
"
|
|
1415
|
+
"type": "string",
|
|
1416
|
+
"required": true,
|
|
1417
|
+
"description": "Polymarket trader address"
|
|
1139
1418
|
}
|
|
1140
1419
|
}
|
|
1141
1420
|
},
|
|
@@ -1148,7 +1427,9 @@
|
|
|
1148
1427
|
"description": "Get wallet-level PnL summary for a Polymarket address",
|
|
1149
1428
|
"options": {
|
|
1150
1429
|
"address": {
|
|
1151
|
-
"
|
|
1430
|
+
"type": "string",
|
|
1431
|
+
"required": true,
|
|
1432
|
+
"description": "Polymarket trader address"
|
|
1152
1433
|
}
|
|
1153
1434
|
}
|
|
1154
1435
|
}
|
|
@@ -1156,12 +1437,179 @@
|
|
|
1156
1437
|
"description": "Polymarket prediction market analytics"
|
|
1157
1438
|
},
|
|
1158
1439
|
"points": {
|
|
1440
|
+
"description": "Nansen Points analytics",
|
|
1159
1441
|
"subcommands": {
|
|
1160
1442
|
"leaderboard": {
|
|
1161
1443
|
"description": "Points leaderboard"
|
|
1162
1444
|
}
|
|
1163
1445
|
}
|
|
1164
1446
|
},
|
|
1447
|
+
"chain-rank": {
|
|
1448
|
+
"endpoint": "/api/v1/chains/chain-rank",
|
|
1449
|
+
"description": "Rank chains by growth metrics",
|
|
1450
|
+
"options": {
|
|
1451
|
+
"timeframe-days": {
|
|
1452
|
+
"type": "number",
|
|
1453
|
+
"enum": [7, 30, 365],
|
|
1454
|
+
"default": 7,
|
|
1455
|
+
"description": "Growth window in days"
|
|
1456
|
+
},
|
|
1457
|
+
"chain-type": {
|
|
1458
|
+
"type": "string",
|
|
1459
|
+
"enum": ["all", "evm"],
|
|
1460
|
+
"default": "all",
|
|
1461
|
+
"description": "Include all chains or only EVM chains"
|
|
1462
|
+
}
|
|
1463
|
+
}
|
|
1464
|
+
},
|
|
1465
|
+
"token-sectors": {
|
|
1466
|
+
"endpoint": "/api/v1/search/token-sectors",
|
|
1467
|
+
"description": "List token sectors available for filtering"
|
|
1468
|
+
},
|
|
1469
|
+
"address-premium-labels": {
|
|
1470
|
+
"endpoint": "/api/v1/profiler/address/premium-labels",
|
|
1471
|
+
"description": "Get all labels for an address, including premium labels",
|
|
1472
|
+
"options": {
|
|
1473
|
+
"address": {
|
|
1474
|
+
"type": "string",
|
|
1475
|
+
"required": true,
|
|
1476
|
+
"description": "Address to fetch labels for"
|
|
1477
|
+
},
|
|
1478
|
+
"chain": {
|
|
1479
|
+
"type": "string",
|
|
1480
|
+
"default": "all",
|
|
1481
|
+
"description": "Chain to fetch labels for, or all"
|
|
1482
|
+
},
|
|
1483
|
+
"page": {
|
|
1484
|
+
"type": "number",
|
|
1485
|
+
"default": 1,
|
|
1486
|
+
"description": "1-based page number"
|
|
1487
|
+
},
|
|
1488
|
+
"limit": {
|
|
1489
|
+
"type": "number",
|
|
1490
|
+
"default": 100,
|
|
1491
|
+
"description": "Labels per page"
|
|
1492
|
+
}
|
|
1493
|
+
}
|
|
1494
|
+
},
|
|
1495
|
+
"smart-money-pnl-leaderboard": {
|
|
1496
|
+
"endpoint": "/api/v1/smart-money/pnl-leaderboard",
|
|
1497
|
+
"description": "Rank smart money wallets by PnL",
|
|
1498
|
+
"options": {
|
|
1499
|
+
"chains": {
|
|
1500
|
+
"default": "solana",
|
|
1501
|
+
"description": "Comma-separated chains"
|
|
1502
|
+
},
|
|
1503
|
+
"timeframe-days": {
|
|
1504
|
+
"type": "number",
|
|
1505
|
+
"enum": [1, 7, 30, 90, 180],
|
|
1506
|
+
"default": 7,
|
|
1507
|
+
"description": "Timeframe in days"
|
|
1508
|
+
},
|
|
1509
|
+
"filters": {
|
|
1510
|
+
"type": "string",
|
|
1511
|
+
"description": "Filters as JSON object"
|
|
1512
|
+
},
|
|
1513
|
+
"sort": {
|
|
1514
|
+
"type": "string",
|
|
1515
|
+
"description": "Sort order (field[:asc|desc])"
|
|
1516
|
+
},
|
|
1517
|
+
"page": {
|
|
1518
|
+
"type": "number",
|
|
1519
|
+
"default": 1,
|
|
1520
|
+
"description": "1-based page number; maps to pagination.page"
|
|
1521
|
+
},
|
|
1522
|
+
"limit": {
|
|
1523
|
+
"type": "number",
|
|
1524
|
+
"description": "Max results per page; maps to pagination.per_page"
|
|
1525
|
+
}
|
|
1526
|
+
}
|
|
1527
|
+
},
|
|
1528
|
+
"position-intelligence": {
|
|
1529
|
+
"endpoint": "/api/v1/tgm/position-intelligence",
|
|
1530
|
+
"description": "Aggregate Hyperliquid positions by trader cohort",
|
|
1531
|
+
"options": {
|
|
1532
|
+
"symbol": {
|
|
1533
|
+
"required": true,
|
|
1534
|
+
"description": "Hyperliquid asset symbol (--token-address is accepted as an alias)"
|
|
1535
|
+
}
|
|
1536
|
+
}
|
|
1537
|
+
},
|
|
1538
|
+
"perp-pnl-summary": {
|
|
1539
|
+
"endpoint": "/api/v1/profiler/perp-pnl-summary",
|
|
1540
|
+
"description": "Summarize realized Hyperliquid PnL for an address",
|
|
1541
|
+
"options": {
|
|
1542
|
+
"address": {
|
|
1543
|
+
"type": "string",
|
|
1544
|
+
"required": true,
|
|
1545
|
+
"description": "Hyperliquid trader address"
|
|
1546
|
+
},
|
|
1547
|
+
"from-date": {
|
|
1548
|
+
"required": true,
|
|
1549
|
+
"description": "Start of date range"
|
|
1550
|
+
},
|
|
1551
|
+
"to-date": {
|
|
1552
|
+
"required": true,
|
|
1553
|
+
"description": "End of date range"
|
|
1554
|
+
}
|
|
1555
|
+
}
|
|
1556
|
+
},
|
|
1557
|
+
"historical-token-ohlcv": {
|
|
1558
|
+
"endpoint": "/api/v1beta1/tgm/historical-token-ohlcv",
|
|
1559
|
+
"description": "Historical token OHLCV candles",
|
|
1560
|
+
"options": {
|
|
1561
|
+
"token-address": {
|
|
1562
|
+
"required": true,
|
|
1563
|
+
"description": "Token address or Hyperliquid asset symbol"
|
|
1564
|
+
},
|
|
1565
|
+
"chain": {
|
|
1566
|
+
"type": "string",
|
|
1567
|
+
"enum": ["base", "bnb", "ethereum", "hyperliquid", "solana"],
|
|
1568
|
+
"default": "solana",
|
|
1569
|
+
"description": "Chain the token lives on"
|
|
1570
|
+
},
|
|
1571
|
+
"from-date": {
|
|
1572
|
+
"required": true,
|
|
1573
|
+
"description": "Start of data window"
|
|
1574
|
+
},
|
|
1575
|
+
"as-of-date": {
|
|
1576
|
+
"description": "End of data window; exactly one of --as-of-date or --as-of-ts is required"
|
|
1577
|
+
},
|
|
1578
|
+
"as-of-ts": {
|
|
1579
|
+
"description": "Exact Hyperliquid cutoff timestamp; exactly one of --as-of-date or --as-of-ts is required"
|
|
1580
|
+
},
|
|
1581
|
+
"timeframe": {
|
|
1582
|
+
"type": "string",
|
|
1583
|
+
"required": true,
|
|
1584
|
+
"enum": ["5m", "15m", "30m", "1h", "1d", "1w"],
|
|
1585
|
+
"description": "Candle interval"
|
|
1586
|
+
},
|
|
1587
|
+
"apply-blacklist-filter": {
|
|
1588
|
+
"type": "boolean",
|
|
1589
|
+
"description": "Apply blacklist filtering for 1d/1w non-Hyperliquid requests"
|
|
1590
|
+
}
|
|
1591
|
+
}
|
|
1592
|
+
},
|
|
1593
|
+
"transaction-with-token-transfer-lookup": {
|
|
1594
|
+
"endpoint": "/api/v1/transaction-with-token-transfer-lookup",
|
|
1595
|
+
"description": "Look up a transaction and its token/NFT transfers",
|
|
1596
|
+
"options": {
|
|
1597
|
+
"transaction-hash": {
|
|
1598
|
+
"type": "string",
|
|
1599
|
+
"required": true,
|
|
1600
|
+
"description": "Transaction hash to look up"
|
|
1601
|
+
},
|
|
1602
|
+
"chain": {
|
|
1603
|
+
"type": "string",
|
|
1604
|
+
"enum": ["all", "arbitrum", "avalanche", "base", "bitcoin", "bnb", "ethereum", "hyperevm", "injective", "iotaevm", "linea", "mantle", "mantra", "monad", "near", "optimism", "plasma", "robinhood", "sei", "sonic", "starknet", "sui", "ton", "tron"],
|
|
1605
|
+
"default": "ethereum",
|
|
1606
|
+
"description": "Chain the transaction was made on"
|
|
1607
|
+
},
|
|
1608
|
+
"block-timestamp": {
|
|
1609
|
+
"description": "Block timestamp (required for bitcoin, tron, ton, starknet, and sui)"
|
|
1610
|
+
}
|
|
1611
|
+
}
|
|
1612
|
+
},
|
|
1165
1613
|
"historical-dex-trades": {
|
|
1166
1614
|
"endpoint": "/api/v1beta1/tgm/historical-dex-trades",
|
|
1167
1615
|
"description": "Historical DEX trades for a token at a point in time",
|
|
@@ -1820,13 +2268,20 @@
|
|
|
1820
2268
|
"description": "Send tokens or native currency",
|
|
1821
2269
|
"options": {
|
|
1822
2270
|
"to": {
|
|
1823
|
-
"
|
|
2271
|
+
"type": "string",
|
|
2272
|
+
"required": true,
|
|
2273
|
+
"description": "Recipient address"
|
|
1824
2274
|
},
|
|
1825
2275
|
"chain": {
|
|
1826
|
-
"
|
|
2276
|
+
"type": "string",
|
|
2277
|
+
"required": true,
|
|
2278
|
+
"enum": ["evm", "solana", "ethereum", "base"],
|
|
2279
|
+
"description": "Chain to send on (evm is an alias for ethereum)"
|
|
1827
2280
|
},
|
|
1828
2281
|
"amount": {
|
|
1829
|
-
"
|
|
2282
|
+
"type": "string",
|
|
2283
|
+
"required": true,
|
|
2284
|
+
"description": "Amount to send in human-readable units, e.g. 1.5"
|
|
1830
2285
|
}
|
|
1831
2286
|
}
|
|
1832
2287
|
},
|
|
@@ -1976,7 +2431,11 @@
|
|
|
1976
2431
|
"url": {
|
|
1977
2432
|
"type": "string",
|
|
1978
2433
|
"default": "https://mcp.nansen.ai/ra/mcp",
|
|
1979
|
-
"description": "Hosted MCP server URL"
|
|
2434
|
+
"description": "Hosted MCP server URL. A saved API key is not sent to a non-default URL unless you pass --send-api-key, and never over plain HTTP to a non-loopback host."
|
|
2435
|
+
},
|
|
2436
|
+
"send-api-key": {
|
|
2437
|
+
"type": "boolean",
|
|
2438
|
+
"description": "Presence-only flag — pass it bare, never with a value (`--send-api-key false` is rejected). Authorizes sending your saved API key to a custom --url (must be https:// or a loopback host). Not needed when you pass --api-key explicitly."
|
|
1980
2439
|
},
|
|
1981
2440
|
"json": {
|
|
1982
2441
|
"type": "boolean",
|
|
@@ -1986,11 +2445,20 @@
|
|
|
1986
2445
|
"examples": [
|
|
1987
2446
|
"npx -y nansen-cli mcp verify",
|
|
1988
2447
|
"nansen mcp verify --json",
|
|
1989
|
-
"nansen mcp verify --url https://mcp.example.dev/ra/mcp --api-key <key>"
|
|
2448
|
+
"nansen mcp verify --url https://mcp.example.dev/ra/mcp --api-key <key>",
|
|
2449
|
+
"nansen mcp verify --url https://mcp.example.dev/ra/mcp --send-api-key"
|
|
1990
2450
|
]
|
|
1991
2451
|
},
|
|
1992
2452
|
"install": {
|
|
1993
2453
|
"description": "Add the Nansen MCP server to a client's config. Client (positional): claude-code, claude-desktop, or cursor. Uses the API key from `nansen login` / NANSEN_API_KEY; re-run after key rotation to update the entry.",
|
|
2454
|
+
"args": [
|
|
2455
|
+
{
|
|
2456
|
+
"name": "client",
|
|
2457
|
+
"required": true,
|
|
2458
|
+
"enum": ["claude-code", "claude-desktop", "cursor"],
|
|
2459
|
+
"description": "MCP client to configure"
|
|
2460
|
+
}
|
|
2461
|
+
],
|
|
1994
2462
|
"options": {
|
|
1995
2463
|
"dry-run": {
|
|
1996
2464
|
"type": "boolean",
|
|
@@ -2004,6 +2472,14 @@
|
|
|
2004
2472
|
},
|
|
2005
2473
|
"uninstall": {
|
|
2006
2474
|
"description": "Remove the Nansen MCP server entry from a client's config. Client (positional): claude-code, claude-desktop, or cursor.",
|
|
2475
|
+
"args": [
|
|
2476
|
+
{
|
|
2477
|
+
"name": "client",
|
|
2478
|
+
"required": true,
|
|
2479
|
+
"enum": ["claude-code", "claude-desktop", "cursor"],
|
|
2480
|
+
"description": "MCP client to remove the entry from"
|
|
2481
|
+
}
|
|
2482
|
+
],
|
|
2007
2483
|
"options": {
|
|
2008
2484
|
"dry-run": {
|
|
2009
2485
|
"type": "boolean",
|
|
@@ -2016,6 +2492,30 @@
|
|
|
2016
2492
|
]
|
|
2017
2493
|
}
|
|
2018
2494
|
}
|
|
2495
|
+
},
|
|
2496
|
+
"completion": {
|
|
2497
|
+
"description": "Generate a shell completion script from this schema (prints to stdout; nothing is written or fetched)",
|
|
2498
|
+
"subcommands": {
|
|
2499
|
+
"bash": {
|
|
2500
|
+
"description": "Print the bash completion script",
|
|
2501
|
+
"examples": [
|
|
2502
|
+
"nansen completion bash > /etc/bash_completion.d/nansen",
|
|
2503
|
+
"eval \"$(nansen completion bash)\""
|
|
2504
|
+
]
|
|
2505
|
+
},
|
|
2506
|
+
"zsh": {
|
|
2507
|
+
"description": "Print the zsh completion script",
|
|
2508
|
+
"examples": [
|
|
2509
|
+
"nansen completion zsh > \"${fpath[1]}/_nansen\""
|
|
2510
|
+
]
|
|
2511
|
+
},
|
|
2512
|
+
"fish": {
|
|
2513
|
+
"description": "Print the fish completion script",
|
|
2514
|
+
"examples": [
|
|
2515
|
+
"nansen completion fish > ~/.config/fish/completions/nansen.fish"
|
|
2516
|
+
]
|
|
2517
|
+
}
|
|
2518
|
+
}
|
|
2019
2519
|
}
|
|
2020
2520
|
},
|
|
2021
2521
|
"globalOptions": {
|