nansen-cli 2.5.0 → 2.6.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 +30 -0
- package/README.md +18 -12
- package/docs/error-codes.md +1 -0
- package/package.json +1 -1
- package/scripts/postinstall.js +36 -11
- package/skills/nansen-limit-orders/SKILL.md +6 -3
- package/skills/nansen-token-research/SKILL.md +1 -1
- package/skills/nansen-trading/SKILL.md +14 -11
- package/skills/nansen-web-searcher/SKILL.md +1 -1
- package/src/api.js +0 -14
- package/src/cli.js +150 -116
- package/src/commands/alerts.js +13 -4
- package/src/commands/completion.js +0 -1
- package/src/commands/research.js +35 -35
- package/src/error-codes.js +1 -0
- package/src/execute-guard.js +43 -3
- package/src/input-validation.js +32 -3
- package/src/limit-order.js +12 -4
- package/src/perp.js +14 -9
- package/src/privy.js +145 -103
- package/src/schema.json +152 -88
- package/skills/nansen-web-fetcher/SKILL.md +0 -53
package/src/schema.json
CHANGED
|
@@ -183,10 +183,11 @@
|
|
|
183
183
|
],
|
|
184
184
|
"description": "Place a perp order (limit or market, with optional take-profit/stop-loss)",
|
|
185
185
|
"options": {
|
|
186
|
-
"
|
|
186
|
+
"symbol": {
|
|
187
187
|
"type": "string",
|
|
188
|
+
"aliases": ["coin"],
|
|
188
189
|
"required": true,
|
|
189
|
-
"description": "Asset symbol, e.g. BTC, ETH
|
|
190
|
+
"description": "Asset symbol, e.g. BTC, ETH"
|
|
190
191
|
},
|
|
191
192
|
"side": {
|
|
192
193
|
"type": "string",
|
|
@@ -254,7 +255,7 @@
|
|
|
254
255
|
"aliases": [
|
|
255
256
|
"y"
|
|
256
257
|
],
|
|
257
|
-
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed. Declining the prompt exits 1 with nothing signed."
|
|
258
|
+
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed, unless NANSEN_REQUIRE_CONFIRM=1 is set, in which case this (or NANSEN_YES=1) is required and a run without it fails with CONFIRMATION_REQUIRED before any request or signature. Declining the prompt exits 1 with nothing signed."
|
|
258
259
|
}
|
|
259
260
|
}
|
|
260
261
|
},
|
|
@@ -267,10 +268,11 @@
|
|
|
267
268
|
],
|
|
268
269
|
"description": "Cancel an open order by order id",
|
|
269
270
|
"options": {
|
|
270
|
-
"
|
|
271
|
+
"symbol": {
|
|
271
272
|
"type": "string",
|
|
273
|
+
"aliases": ["coin"],
|
|
272
274
|
"required": true,
|
|
273
|
-
"description": "Asset symbol
|
|
275
|
+
"description": "Asset symbol"
|
|
274
276
|
},
|
|
275
277
|
"oid": {
|
|
276
278
|
"type": "string",
|
|
@@ -290,7 +292,7 @@
|
|
|
290
292
|
"aliases": [
|
|
291
293
|
"y"
|
|
292
294
|
],
|
|
293
|
-
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed. Declining the prompt exits 1 with nothing signed."
|
|
295
|
+
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed, unless NANSEN_REQUIRE_CONFIRM=1 is set, in which case this (or NANSEN_YES=1) is required and a run without it fails with CONFIRMATION_REQUIRED before any request or signature. Declining the prompt exits 1 with nothing signed."
|
|
294
296
|
}
|
|
295
297
|
}
|
|
296
298
|
},
|
|
@@ -304,10 +306,11 @@
|
|
|
304
306
|
],
|
|
305
307
|
"description": "Close a position (reduce-only market order)",
|
|
306
308
|
"options": {
|
|
307
|
-
"
|
|
309
|
+
"symbol": {
|
|
308
310
|
"type": "string",
|
|
311
|
+
"aliases": ["coin"],
|
|
309
312
|
"required": true,
|
|
310
|
-
"description": "Asset symbol
|
|
313
|
+
"description": "Asset symbol"
|
|
311
314
|
},
|
|
312
315
|
"size": {
|
|
313
316
|
"type": "string",
|
|
@@ -346,7 +349,7 @@
|
|
|
346
349
|
"aliases": [
|
|
347
350
|
"y"
|
|
348
351
|
],
|
|
349
|
-
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed. Declining the prompt exits 1 with nothing signed."
|
|
352
|
+
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed, unless NANSEN_REQUIRE_CONFIRM=1 is set, in which case this (or NANSEN_YES=1) is required and a run without it fails with CONFIRMATION_REQUIRED before any request or signature. Declining the prompt exits 1 with nothing signed."
|
|
350
353
|
}
|
|
351
354
|
}
|
|
352
355
|
},
|
|
@@ -359,10 +362,11 @@
|
|
|
359
362
|
],
|
|
360
363
|
"description": "Set leverage and margin mode for an asset",
|
|
361
364
|
"options": {
|
|
362
|
-
"
|
|
365
|
+
"symbol": {
|
|
363
366
|
"type": "string",
|
|
367
|
+
"aliases": ["coin"],
|
|
364
368
|
"required": true,
|
|
365
|
-
"description": "Asset symbol
|
|
369
|
+
"description": "Asset symbol"
|
|
366
370
|
},
|
|
367
371
|
"leverage": {
|
|
368
372
|
"type": "string",
|
|
@@ -391,7 +395,7 @@
|
|
|
391
395
|
"aliases": [
|
|
392
396
|
"y"
|
|
393
397
|
],
|
|
394
|
-
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed. Declining the prompt exits 1 with nothing signed."
|
|
398
|
+
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed, unless NANSEN_REQUIRE_CONFIRM=1 is set, in which case this (or NANSEN_YES=1) is required and a run without it fails with CONFIRMATION_REQUIRED before any request or signature. Declining the prompt exits 1 with nothing signed."
|
|
395
399
|
}
|
|
396
400
|
}
|
|
397
401
|
},
|
|
@@ -618,7 +622,7 @@
|
|
|
618
622
|
"aliases": [
|
|
619
623
|
"y"
|
|
620
624
|
],
|
|
621
|
-
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed. Declining the prompt exits 1 with nothing signed."
|
|
625
|
+
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed, unless NANSEN_REQUIRE_CONFIRM=1 is set, in which case this (or NANSEN_YES=1) is required and a run without it fails with CONFIRMATION_REQUIRED before any request or signature. Declining the prompt exits 1 with nothing signed."
|
|
622
626
|
}
|
|
623
627
|
},
|
|
624
628
|
"examples": [
|
|
@@ -830,6 +834,9 @@
|
|
|
830
834
|
},
|
|
831
835
|
"token": {
|
|
832
836
|
"type": "string",
|
|
837
|
+
"aliases": [
|
|
838
|
+
"token-address"
|
|
839
|
+
],
|
|
833
840
|
"description": "Only this token (contract address); sent as filters.token_address"
|
|
834
841
|
}
|
|
835
842
|
}
|
|
@@ -891,7 +898,7 @@
|
|
|
891
898
|
},
|
|
892
899
|
"chain": {
|
|
893
900
|
"type": "string",
|
|
894
|
-
"default": "
|
|
901
|
+
"default": "all",
|
|
895
902
|
"description": "Chain to profile the address on"
|
|
896
903
|
},
|
|
897
904
|
"days": {
|
|
@@ -932,7 +939,7 @@
|
|
|
932
939
|
},
|
|
933
940
|
"chain": {
|
|
934
941
|
"type": "string",
|
|
935
|
-
"default": "
|
|
942
|
+
"default": "all",
|
|
936
943
|
"description": "Chain to profile the address on"
|
|
937
944
|
},
|
|
938
945
|
"days": {
|
|
@@ -958,7 +965,7 @@
|
|
|
958
965
|
},
|
|
959
966
|
"chain": {
|
|
960
967
|
"type": "string",
|
|
961
|
-
"default": "
|
|
968
|
+
"default": "all",
|
|
962
969
|
"description": "Chain to profile the address on"
|
|
963
970
|
},
|
|
964
971
|
"entity": {
|
|
@@ -995,7 +1002,7 @@
|
|
|
995
1002
|
},
|
|
996
1003
|
"chain": {
|
|
997
1004
|
"type": "string",
|
|
998
|
-
"default": "
|
|
1005
|
+
"default": "all",
|
|
999
1006
|
"description": "Chain to profile the address on"
|
|
1000
1007
|
},
|
|
1001
1008
|
"days": {
|
|
@@ -1075,7 +1082,7 @@
|
|
|
1075
1082
|
},
|
|
1076
1083
|
"chain": {
|
|
1077
1084
|
"type": "string",
|
|
1078
|
-
"default": "
|
|
1085
|
+
"default": "all",
|
|
1079
1086
|
"description": "Chain to profile the address on"
|
|
1080
1087
|
},
|
|
1081
1088
|
"days": {
|
|
@@ -1111,7 +1118,7 @@
|
|
|
1111
1118
|
},
|
|
1112
1119
|
"chain": {
|
|
1113
1120
|
"type": "string",
|
|
1114
|
-
"default": "
|
|
1121
|
+
"default": "all",
|
|
1115
1122
|
"description": "Chain to profile the address on"
|
|
1116
1123
|
},
|
|
1117
1124
|
"sort": {
|
|
@@ -1148,7 +1155,7 @@
|
|
|
1148
1155
|
},
|
|
1149
1156
|
"chain": {
|
|
1150
1157
|
"type": "string",
|
|
1151
|
-
"default": "
|
|
1158
|
+
"default": "all",
|
|
1152
1159
|
"description": "Chain to profile the address on"
|
|
1153
1160
|
},
|
|
1154
1161
|
"days": {
|
|
@@ -1189,7 +1196,7 @@
|
|
|
1189
1196
|
},
|
|
1190
1197
|
"chain": {
|
|
1191
1198
|
"type": "string",
|
|
1192
|
-
"default": "
|
|
1199
|
+
"default": "all",
|
|
1193
1200
|
"description": "Chain to profile the address on"
|
|
1194
1201
|
}
|
|
1195
1202
|
}
|
|
@@ -1262,7 +1269,7 @@
|
|
|
1262
1269
|
},
|
|
1263
1270
|
"chain": {
|
|
1264
1271
|
"type": "string",
|
|
1265
|
-
"default": "
|
|
1272
|
+
"default": "all",
|
|
1266
1273
|
"description": "Chain to profile the address on"
|
|
1267
1274
|
},
|
|
1268
1275
|
"days": {
|
|
@@ -1309,7 +1316,7 @@
|
|
|
1309
1316
|
"options": {
|
|
1310
1317
|
"chain": {
|
|
1311
1318
|
"type": "string",
|
|
1312
|
-
"default": "
|
|
1319
|
+
"default": "all",
|
|
1313
1320
|
"description": "Chain to profile every address on"
|
|
1314
1321
|
},
|
|
1315
1322
|
"include": {
|
|
@@ -1349,7 +1356,7 @@
|
|
|
1349
1356
|
},
|
|
1350
1357
|
"chain": {
|
|
1351
1358
|
"type": "string",
|
|
1352
|
-
"default": "
|
|
1359
|
+
"default": "all",
|
|
1353
1360
|
"description": "Chain to profile the address on"
|
|
1354
1361
|
},
|
|
1355
1362
|
"depth": {
|
|
@@ -1387,7 +1394,7 @@
|
|
|
1387
1394
|
},
|
|
1388
1395
|
"chain": {
|
|
1389
1396
|
"type": "string",
|
|
1390
|
-
"default": "
|
|
1397
|
+
"default": "all",
|
|
1391
1398
|
"description": "Chain to compare the wallets on"
|
|
1392
1399
|
},
|
|
1393
1400
|
"days": {
|
|
@@ -1715,9 +1722,7 @@
|
|
|
1715
1722
|
"type": "string",
|
|
1716
1723
|
"required": true,
|
|
1717
1724
|
"description": "Perp symbol, e.g. BTC",
|
|
1718
|
-
"aliases": [
|
|
1719
|
-
"token-symbol"
|
|
1720
|
-
]
|
|
1725
|
+
"aliases": ["token-symbol", "coin"]
|
|
1721
1726
|
},
|
|
1722
1727
|
"days": {
|
|
1723
1728
|
"type": "integer",
|
|
@@ -1757,9 +1762,7 @@
|
|
|
1757
1762
|
"type": "string",
|
|
1758
1763
|
"required": true,
|
|
1759
1764
|
"description": "Perp symbol, e.g. BTC",
|
|
1760
|
-
"aliases": [
|
|
1761
|
-
"token-symbol"
|
|
1762
|
-
]
|
|
1765
|
+
"aliases": ["token-symbol", "coin"]
|
|
1763
1766
|
},
|
|
1764
1767
|
"filters": {
|
|
1765
1768
|
"type": "string",
|
|
@@ -1789,9 +1792,7 @@
|
|
|
1789
1792
|
"type": "string",
|
|
1790
1793
|
"required": true,
|
|
1791
1794
|
"description": "Perp symbol, e.g. BTC",
|
|
1792
|
-
"aliases": [
|
|
1793
|
-
"token-symbol"
|
|
1794
|
-
]
|
|
1795
|
+
"aliases": ["token-symbol", "coin"]
|
|
1795
1796
|
},
|
|
1796
1797
|
"days": {
|
|
1797
1798
|
"type": "integer",
|
|
@@ -1875,7 +1876,7 @@
|
|
|
1875
1876
|
"options": {
|
|
1876
1877
|
"chain": {
|
|
1877
1878
|
"type": "string",
|
|
1878
|
-
"default": "
|
|
1879
|
+
"default": "solana",
|
|
1879
1880
|
"description": "Chain the token lives on"
|
|
1880
1881
|
},
|
|
1881
1882
|
"token": {
|
|
@@ -1906,8 +1907,9 @@
|
|
|
1906
1907
|
"token-address"
|
|
1907
1908
|
]
|
|
1908
1909
|
},
|
|
1909
|
-
"
|
|
1910
|
+
"interval": {
|
|
1910
1911
|
"type": "string",
|
|
1912
|
+
"aliases": ["timeframe"],
|
|
1911
1913
|
"default": "1d",
|
|
1912
1914
|
"description": "Candle interval"
|
|
1913
1915
|
}
|
|
@@ -2442,8 +2444,9 @@
|
|
|
2442
2444
|
"endpoint": "/api/v1/chains/chain-rank",
|
|
2443
2445
|
"description": "Rank chains by growth metrics",
|
|
2444
2446
|
"options": {
|
|
2445
|
-
"
|
|
2447
|
+
"days": {
|
|
2446
2448
|
"type": "number",
|
|
2449
|
+
"aliases": ["timeframe-days"],
|
|
2447
2450
|
"enum": [7, 30, 365],
|
|
2448
2451
|
"default": 7,
|
|
2449
2452
|
"description": "Growth window in days"
|
|
@@ -2498,8 +2501,9 @@
|
|
|
2498
2501
|
"type": "string",
|
|
2499
2502
|
"repeatable": true
|
|
2500
2503
|
},
|
|
2501
|
-
"
|
|
2504
|
+
"days": {
|
|
2502
2505
|
"type": "number",
|
|
2506
|
+
"aliases": ["timeframe-days"],
|
|
2503
2507
|
"enum": [1, 7, 30, 90, 180],
|
|
2504
2508
|
"default": 7,
|
|
2505
2509
|
"description": "Timeframe in days"
|
|
@@ -2529,7 +2533,8 @@
|
|
|
2529
2533
|
},
|
|
2530
2534
|
"chain": {
|
|
2531
2535
|
"type": "string",
|
|
2532
|
-
"description": "Single chain; --chains takes precedence"
|
|
2536
|
+
"description": "Single chain; --chains takes precedence",
|
|
2537
|
+
"default": "solana"
|
|
2533
2538
|
}
|
|
2534
2539
|
}
|
|
2535
2540
|
},
|
|
@@ -2541,10 +2546,7 @@
|
|
|
2541
2546
|
"required": true,
|
|
2542
2547
|
"description": "Hyperliquid asset symbol (--token-address is accepted as an alias)",
|
|
2543
2548
|
"type": "string",
|
|
2544
|
-
"aliases": [
|
|
2545
|
-
"token-address",
|
|
2546
|
-
"token"
|
|
2547
|
-
]
|
|
2549
|
+
"aliases": ["token-address", "token", "coin"]
|
|
2548
2550
|
}
|
|
2549
2551
|
},
|
|
2550
2552
|
"pagination": false
|
|
@@ -2577,13 +2579,11 @@
|
|
|
2577
2579
|
"endpoint": "/api/v1beta1/tgm/historical-token-ohlcv",
|
|
2578
2580
|
"description": "Historical token OHLCV candles",
|
|
2579
2581
|
"options": {
|
|
2580
|
-
"token
|
|
2582
|
+
"token": {
|
|
2581
2583
|
"required": true,
|
|
2582
2584
|
"description": "Token address or Hyperliquid asset symbol",
|
|
2583
2585
|
"type": "string",
|
|
2584
|
-
"aliases": [
|
|
2585
|
-
"token"
|
|
2586
|
-
]
|
|
2586
|
+
"aliases": ["token-address", "symbol"]
|
|
2587
2587
|
},
|
|
2588
2588
|
"chain": {
|
|
2589
2589
|
"type": "string",
|
|
@@ -2603,8 +2603,9 @@
|
|
|
2603
2603
|
"description": "Exact Hyperliquid cutoff timestamp; exactly one of --as-of-date or --as-of-ts is required",
|
|
2604
2604
|
"type": "string"
|
|
2605
2605
|
},
|
|
2606
|
-
"
|
|
2606
|
+
"interval": {
|
|
2607
2607
|
"type": "string",
|
|
2608
|
+
"aliases": ["timeframe"],
|
|
2608
2609
|
"required": true,
|
|
2609
2610
|
"enum": [
|
|
2610
2611
|
"5m",
|
|
@@ -2649,12 +2650,12 @@
|
|
|
2649
2650
|
"endpoint": "/api/v1/tgm/historical-dex-trades",
|
|
2650
2651
|
"description": "Historical DEX trades for a token at a point in time",
|
|
2651
2652
|
"options": {
|
|
2652
|
-
"token
|
|
2653
|
+
"token": {
|
|
2653
2654
|
"required": true,
|
|
2654
2655
|
"description": "Token address",
|
|
2655
2656
|
"type": "string",
|
|
2656
2657
|
"aliases": [
|
|
2657
|
-
"token"
|
|
2658
|
+
"token-address"
|
|
2658
2659
|
]
|
|
2659
2660
|
},
|
|
2660
2661
|
"from-date": {
|
|
@@ -2694,12 +2695,12 @@
|
|
|
2694
2695
|
"endpoint": "/api/v1/tgm/historical-pnl-leaderboard",
|
|
2695
2696
|
"description": "Historical PnL leaderboard for a token",
|
|
2696
2697
|
"options": {
|
|
2697
|
-
"token
|
|
2698
|
+
"token": {
|
|
2698
2699
|
"required": true,
|
|
2699
2700
|
"description": "Token address",
|
|
2700
2701
|
"type": "string",
|
|
2701
2702
|
"aliases": [
|
|
2702
|
-
"token"
|
|
2703
|
+
"token-address"
|
|
2703
2704
|
]
|
|
2704
2705
|
},
|
|
2705
2706
|
"from-date": {
|
|
@@ -2739,12 +2740,12 @@
|
|
|
2739
2740
|
"endpoint": "/api/v1/tgm/historical-token-flow-summary",
|
|
2740
2741
|
"description": "Historical token flow summary (no pagination; whale, public figure, top PnL and exchange segments start 2025-03-11)",
|
|
2741
2742
|
"options": {
|
|
2742
|
-
"token
|
|
2743
|
+
"token": {
|
|
2743
2744
|
"required": true,
|
|
2744
2745
|
"description": "Token address",
|
|
2745
2746
|
"type": "string",
|
|
2746
2747
|
"aliases": [
|
|
2747
|
-
"token"
|
|
2748
|
+
"token-address"
|
|
2748
2749
|
]
|
|
2749
2750
|
},
|
|
2750
2751
|
"from-date": {
|
|
@@ -2771,12 +2772,12 @@
|
|
|
2771
2772
|
"endpoint": "/api/v1/tgm/historical-token-quant-scores",
|
|
2772
2773
|
"description": "Historical token quantitative scores at a snapshot date",
|
|
2773
2774
|
"options": {
|
|
2774
|
-
"token
|
|
2775
|
+
"token": {
|
|
2775
2776
|
"required": true,
|
|
2776
2777
|
"description": "Token address",
|
|
2777
2778
|
"type": "string",
|
|
2778
2779
|
"aliases": [
|
|
2779
|
-
"token"
|
|
2780
|
+
"token-address"
|
|
2780
2781
|
]
|
|
2781
2782
|
},
|
|
2782
2783
|
"as-of-date": {
|
|
@@ -2797,12 +2798,12 @@
|
|
|
2797
2798
|
"endpoint": "/api/v1/tgm/historical-top-holders",
|
|
2798
2799
|
"description": "Historical top holders of a token at a snapshot date",
|
|
2799
2800
|
"options": {
|
|
2800
|
-
"token
|
|
2801
|
+
"token": {
|
|
2801
2802
|
"required": true,
|
|
2802
2803
|
"description": "Token address",
|
|
2803
2804
|
"type": "string",
|
|
2804
2805
|
"aliases": [
|
|
2805
|
-
"token"
|
|
2806
|
+
"token-address"
|
|
2806
2807
|
]
|
|
2807
2808
|
},
|
|
2808
2809
|
"as-of-date": {
|
|
@@ -2836,12 +2837,12 @@
|
|
|
2836
2837
|
"endpoint": "/api/v1/tgm/historical-who-bought-sold",
|
|
2837
2838
|
"description": "Historical buyers/sellers of a token",
|
|
2838
2839
|
"options": {
|
|
2839
|
-
"token
|
|
2840
|
+
"token": {
|
|
2840
2841
|
"required": true,
|
|
2841
2842
|
"description": "Token address",
|
|
2842
2843
|
"type": "string",
|
|
2843
2844
|
"aliases": [
|
|
2844
|
-
"token"
|
|
2845
|
+
"token-address"
|
|
2845
2846
|
]
|
|
2846
2847
|
},
|
|
2847
2848
|
"from-date": {
|
|
@@ -2905,7 +2906,8 @@
|
|
|
2905
2906
|
},
|
|
2906
2907
|
"chain": {
|
|
2907
2908
|
"type": "string",
|
|
2908
|
-
"description": "Single chain; --chains takes precedence"
|
|
2909
|
+
"description": "Single chain; --chains takes precedence",
|
|
2910
|
+
"default": "solana"
|
|
2909
2911
|
}
|
|
2910
2912
|
}
|
|
2911
2913
|
},
|
|
@@ -2913,9 +2915,10 @@
|
|
|
2913
2915
|
"endpoint": "/api/v1beta1/token-screener/historical",
|
|
2914
2916
|
"description": "Historical token screener over a trailing window",
|
|
2915
2917
|
"options": {
|
|
2916
|
-
"
|
|
2918
|
+
"days": {
|
|
2917
2919
|
"required": true,
|
|
2918
2920
|
"type": "number",
|
|
2921
|
+
"aliases": ["timeframe-days"],
|
|
2919
2922
|
"description": "Trailing window size in days"
|
|
2920
2923
|
},
|
|
2921
2924
|
"to-date": {
|
|
@@ -2946,7 +2949,8 @@
|
|
|
2946
2949
|
},
|
|
2947
2950
|
"chain": {
|
|
2948
2951
|
"type": "string",
|
|
2949
|
-
"description": "Single chain; --chains takes precedence"
|
|
2952
|
+
"description": "Single chain; --chains takes precedence",
|
|
2953
|
+
"default": "solana"
|
|
2950
2954
|
}
|
|
2951
2955
|
}
|
|
2952
2956
|
},
|
|
@@ -3040,6 +3044,37 @@
|
|
|
3040
3044
|
"description"
|
|
3041
3045
|
],
|
|
3042
3046
|
"options": {
|
|
3047
|
+
"token": {
|
|
3048
|
+
"type": "string",
|
|
3049
|
+
"aliases": [
|
|
3050
|
+
"token-address"
|
|
3051
|
+
],
|
|
3052
|
+
"description": "Only alerts that include or exclude this token address"
|
|
3053
|
+
},
|
|
3054
|
+
"type": {
|
|
3055
|
+
"type": "string",
|
|
3056
|
+
"description": "Only alerts of this type (sm-token-flows, common-token-transfer, smart-contract-call)"
|
|
3057
|
+
},
|
|
3058
|
+
"enabled": {
|
|
3059
|
+
"type": "boolean",
|
|
3060
|
+
"description": "Only enabled alerts. Cannot be combined with --disabled"
|
|
3061
|
+
},
|
|
3062
|
+
"disabled": {
|
|
3063
|
+
"type": "boolean",
|
|
3064
|
+
"description": "Only disabled alerts. Cannot be combined with --enabled"
|
|
3065
|
+
},
|
|
3066
|
+
"chain": {
|
|
3067
|
+
"type": "string",
|
|
3068
|
+
"description": "Only alerts that watch this chain (alerts on all chains also match)"
|
|
3069
|
+
},
|
|
3070
|
+
"limit": {
|
|
3071
|
+
"type": "number",
|
|
3072
|
+
"description": "Max results (non-negative integer)"
|
|
3073
|
+
},
|
|
3074
|
+
"offset": {
|
|
3075
|
+
"type": "number",
|
|
3076
|
+
"description": "Skip the first N results (non-negative integer)"
|
|
3077
|
+
},
|
|
3043
3078
|
"reveal": {
|
|
3044
3079
|
"type": "boolean",
|
|
3045
3080
|
"description": "Show full channel webhook URLs and webhook signing secrets (redacted by default)"
|
|
@@ -3326,7 +3361,7 @@
|
|
|
3326
3361
|
"aliases": [
|
|
3327
3362
|
"y"
|
|
3328
3363
|
],
|
|
3329
|
-
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed. Declining the prompt exits 1 with nothing signed."
|
|
3364
|
+
"description": "Skip the confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; when stdin is not a terminal (agents, CI, pipes) the command proceeds unprompted whether or not this is passed, unless NANSEN_REQUIRE_CONFIRM=1 is set, in which case this (or NANSEN_YES=1) is required and a run without it fails with CONFIRMATION_REQUIRED before any request or signature. Declining the prompt exits 1 with nothing signed."
|
|
3330
3365
|
}
|
|
3331
3366
|
},
|
|
3332
3367
|
"examples": [
|
|
@@ -3420,7 +3455,7 @@
|
|
|
3420
3455
|
"aliases": [
|
|
3421
3456
|
"y"
|
|
3422
3457
|
],
|
|
3423
|
-
"description": "Skip the create confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; non-TTY automation proceeds unprompted. Declining exits 1 before API requests or signing."
|
|
3458
|
+
"description": "Skip the create confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; non-TTY automation proceeds unprompted unless NANSEN_REQUIRE_CONFIRM=1 is set, which makes this (or NANSEN_YES=1) required there (CONFIRMATION_REQUIRED). Declining exits 1 before API requests or signing."
|
|
3424
3459
|
}
|
|
3425
3460
|
},
|
|
3426
3461
|
"chains": [
|
|
@@ -3431,14 +3466,15 @@
|
|
|
3431
3466
|
]
|
|
3432
3467
|
},
|
|
3433
3468
|
"list": {
|
|
3434
|
-
"description": "List your limit orders. Explicitly blank --wallet, --limit, --offset, --dir, and --
|
|
3469
|
+
"description": "List your limit orders. Explicitly blank --wallet, --limit, --offset, --dir, and --token values are rejected.",
|
|
3435
3470
|
"options": {
|
|
3436
3471
|
"state": {
|
|
3437
3472
|
"type": "string",
|
|
3438
3473
|
"description": "Filter by state (active, past)"
|
|
3439
3474
|
},
|
|
3440
|
-
"
|
|
3475
|
+
"token": {
|
|
3441
3476
|
"type": "string",
|
|
3477
|
+
"aliases": ["mint"],
|
|
3442
3478
|
"description": "Filter by token mint address"
|
|
3443
3479
|
},
|
|
3444
3480
|
"limit": {
|
|
@@ -3490,7 +3526,7 @@
|
|
|
3490
3526
|
"aliases": [
|
|
3491
3527
|
"y"
|
|
3492
3528
|
],
|
|
3493
|
-
"description": "Skip the cancel confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; non-TTY automation proceeds unprompted. Declining exits 1 before API requests or signing."
|
|
3529
|
+
"description": "Skip the cancel confirmation prompt (alias: -y, or set NANSEN_YES=1). The prompt is only shown when stdin is an interactive terminal; non-TTY automation proceeds unprompted unless NANSEN_REQUIRE_CONFIRM=1 is set, which makes this (or NANSEN_YES=1) required there (CONFIRMATION_REQUIRED). Declining exits 1 before API requests or signing."
|
|
3494
3530
|
}
|
|
3495
3531
|
},
|
|
3496
3532
|
"chains": [
|
|
@@ -3748,7 +3784,7 @@
|
|
|
3748
3784
|
]
|
|
3749
3785
|
},
|
|
3750
3786
|
"web": {
|
|
3751
|
-
"description": "Web search
|
|
3787
|
+
"description": "Web search commands",
|
|
3752
3788
|
"subcommands": {
|
|
3753
3789
|
"search": {
|
|
3754
3790
|
"endpoint": "/api/v1/search/web-search",
|
|
@@ -3768,24 +3804,6 @@
|
|
|
3768
3804
|
"nansen web search --query \"btc\" --query \"eth\"",
|
|
3769
3805
|
"nansen web search \"btc\" --query \"eth\" # positional + flag merged"
|
|
3770
3806
|
]
|
|
3771
|
-
},
|
|
3772
|
-
"fetch": {
|
|
3773
|
-
"endpoint": "/api/v1/search/web-fetch",
|
|
3774
|
-
"description": "Fetch and analyze content from one or more URLs using AI",
|
|
3775
|
-
"options": {
|
|
3776
|
-
"url": {
|
|
3777
|
-
"description": "URL to fetch (can be repeated for multiple URLs)"
|
|
3778
|
-
},
|
|
3779
|
-
"question": {
|
|
3780
|
-
"description": "Question to answer about the URL content",
|
|
3781
|
-
"required": true
|
|
3782
|
-
}
|
|
3783
|
-
},
|
|
3784
|
-
"examples": [
|
|
3785
|
-
"nansen web fetch https://nansen.ai --question \"What does Nansen do?\"",
|
|
3786
|
-
"nansen web fetch --url https://a.com --url https://b.com --question \"Compare these\"",
|
|
3787
|
-
"nansen web fetch https://a.com --url https://b.com --question \"Diff?\" # positional + flag merged"
|
|
3788
|
-
]
|
|
3789
3807
|
}
|
|
3790
3808
|
}
|
|
3791
3809
|
},
|
|
@@ -4009,6 +4027,53 @@
|
|
|
4009
4027
|
]
|
|
4010
4028
|
}
|
|
4011
4029
|
}
|
|
4030
|
+
},
|
|
4031
|
+
"help": {
|
|
4032
|
+
"description": "Show the top-level help, one help topic, or a command's help. \"nansen help <command> [subcommand]\" prints the same as \"nansen <command> [subcommand] --help\". Prints local text only: no network call, no credits.",
|
|
4033
|
+
"subcommands": {
|
|
4034
|
+
"auth": {
|
|
4035
|
+
"description": "Sign-in options, API keys, browser sessions and how auto-payment relates to authentication",
|
|
4036
|
+
"examples": [
|
|
4037
|
+
"nansen help auth"
|
|
4038
|
+
]
|
|
4039
|
+
},
|
|
4040
|
+
"options": {
|
|
4041
|
+
"description": "Global options: paging, output format, retries, caching and the --debug request trace",
|
|
4042
|
+
"examples": [
|
|
4043
|
+
"nansen help options"
|
|
4044
|
+
]
|
|
4045
|
+
},
|
|
4046
|
+
"examples": {
|
|
4047
|
+
"description": "Example commands for trading, the Hyperliquid bridge and research",
|
|
4048
|
+
"examples": [
|
|
4049
|
+
"nansen help examples"
|
|
4050
|
+
]
|
|
4051
|
+
},
|
|
4052
|
+
"chains": {
|
|
4053
|
+
"description": "Chains accepted by research, trade and the Hyperliquid bridge",
|
|
4054
|
+
"examples": [
|
|
4055
|
+
"nansen help chains"
|
|
4056
|
+
]
|
|
4057
|
+
},
|
|
4058
|
+
"labels": {
|
|
4059
|
+
"description": "Smart Money labels",
|
|
4060
|
+
"examples": [
|
|
4061
|
+
"nansen help labels"
|
|
4062
|
+
]
|
|
4063
|
+
},
|
|
4064
|
+
"deprecated": {
|
|
4065
|
+
"description": "Deprecated top-level aliases and the commands that replace them",
|
|
4066
|
+
"examples": [
|
|
4067
|
+
"nansen help deprecated"
|
|
4068
|
+
]
|
|
4069
|
+
},
|
|
4070
|
+
"telemetry": {
|
|
4071
|
+
"description": "What anonymous usage telemetry sends, and how to turn it off",
|
|
4072
|
+
"examples": [
|
|
4073
|
+
"nansen help telemetry"
|
|
4074
|
+
]
|
|
4075
|
+
}
|
|
4076
|
+
}
|
|
4012
4077
|
}
|
|
4013
4078
|
},
|
|
4014
4079
|
"globalOptions": {
|
|
@@ -4101,7 +4166,6 @@
|
|
|
4101
4166
|
"neverCached": [
|
|
4102
4167
|
"account",
|
|
4103
4168
|
"web search",
|
|
4104
|
-
"web fetch",
|
|
4105
4169
|
"alerts create",
|
|
4106
4170
|
"alerts update",
|
|
4107
4171
|
"alerts toggle",
|