nansen-cli 2.3.0 → 2.5.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 +112 -0
- package/README.md +61 -38
- package/docs/auth.md +56 -0
- package/docs/browser-login.md +101 -7
- package/docs/error-codes.md +251 -0
- package/package.json +10 -4
- package/skills/nansen-agent-guide/SKILL.md +20 -4
- package/skills/nansen-alerts-webhook-listener/SKILL.md +17 -14
- package/skills/nansen-dca-tracker/SKILL.md +1 -1
- package/skills/nansen-defi-positions/SKILL.md +1 -1
- package/skills/nansen-exit-signals/SKILL.md +2 -2
- package/skills/nansen-fund-tracker/SKILL.md +1 -1
- package/skills/nansen-general-search/SKILL.md +1 -1
- package/skills/nansen-holder-analysis/SKILL.md +2 -2
- package/skills/nansen-limit-orders/SKILL.md +9 -1
- package/skills/nansen-mpp-payment/SKILL.md +2 -2
- package/skills/nansen-perp-screener/SKILL.md +1 -1
- package/skills/nansen-perp-trader-profile/SKILL.md +1 -1
- package/skills/nansen-polymarket-deep-dive/SKILL.md +1 -1
- package/skills/nansen-polymarket-insider-scan/SKILL.md +1 -1
- package/skills/nansen-polymarket-trader-profile/SKILL.md +1 -1
- package/skills/nansen-portfolio-tracker/SKILL.md +1 -1
- package/skills/nansen-prediction-markets/SKILL.md +1 -1
- package/skills/nansen-sm-cross-chain-flows/SKILL.md +1 -1
- package/skills/nansen-smart-alerts/SKILL.md +5 -2
- package/skills/nansen-smart-money-alpha/SKILL.md +1 -1
- package/skills/nansen-smart-money-tracker/SKILL.md +8 -7
- package/skills/nansen-smart-money-trend/SKILL.md +1 -1
- package/skills/nansen-token-research/SKILL.md +1 -1
- package/skills/nansen-token-screener/SKILL.md +1 -1
- package/skills/nansen-token-transfer-analysis/SKILL.md +1 -1
- package/skills/nansen-trading/SKILL.md +23 -2
- package/skills/nansen-wallet-batch/SKILL.md +1 -1
- package/skills/nansen-wallet-clustering/SKILL.md +1 -1
- package/skills/nansen-wallet-deep-dive/SKILL.md +1 -1
- package/skills/nansen-wallet-keychain-migration/SKILL.md +1 -1
- package/skills/nansen-wallet-manager/SKILL.md +11 -5
- package/skills/nansen-wallet-profiler/SKILL.md +1 -1
- package/skills/nansen-web-fetcher/SKILL.md +1 -1
- package/skills/nansen-web-searcher/SKILL.md +1 -1
- package/src/api-endpoints.json +1605 -0
- package/src/api.js +282 -124
- package/src/auth-credentials.js +1 -0
- package/src/auth-key-input.js +57 -9
- package/src/auth-state.js +2 -2
- package/src/auth-store-native.js +6 -1
- package/src/auth-store-worker.js +1 -1
- package/src/auth-store.js +9 -4
- package/src/auto-paginate.js +25 -7
- package/src/bridge.js +19 -10
- package/src/cache-inspect.js +16 -6
- package/src/cli.js +272 -114
- package/src/commands/agent.js +2 -3
- package/src/commands/alerts.js +365 -18
- package/src/commands/completion.js +4 -1
- package/src/commands/feedback.js +98 -37
- package/src/commands/mcp.js +1 -1
- package/src/commands/research.js +14 -37
- package/src/cost-cache.js +33 -7
- package/src/doctor.js +14 -5
- package/src/ens.js +14 -5
- package/src/error-codes.js +228 -0
- package/src/execute-guard.js +8 -3
- package/src/input-validation.js +555 -0
- package/src/limit-order.js +127 -54
- package/src/perp.js +358 -35
- package/src/privy.js +90 -15
- package/src/query-options.js +47 -8
- package/src/response-cache-files.js +65 -0
- package/src/response-meta.js +8 -2
- package/src/rpc-urls.js +3 -1
- package/src/schema.json +1254 -156
- package/src/solana-tx.js +4 -0
- package/src/telemetry-flags.js +75 -0
- package/src/trade-validation.js +167 -8
- package/src/trading.js +243 -20
- package/src/transfer.js +79 -12
- package/src/update-check.js +32 -5
- package/src/wallet.js +246 -69
- package/src/walletconnect-x402.js +27 -9
package/src/schema.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"commands": {
|
|
3
3
|
"feedback": {
|
|
4
4
|
"description": "Read the account feedback preference, submit product feedback, or recover an account-scoped receipt. Free; seven new reports per account per UTC week.",
|
|
5
|
-
"notes": "Use the configured API key or login session. Keep the same submission ID and unchanged report after an uncertain result. No caching or payment fallback. Remove credentials and unnecessary personal context from reports. Without --submission-id, save one private submission before sending. Resume with nansen feedback resume. Use --new for a deliberate new report after confirmation or local erasure. Pending data expires after one calendar year; feedback commands enforce cleanup. Automatic IDs require POSIX private storage and native locking; otherwise supply an explicit ID.
|
|
5
|
+
"notes": "Use the configured API key or login session. Keep the same submission ID and unchanged report after an uncertain result. No caching or payment fallback. Remove credentials and unnecessary personal context from reports. Without --submission-id, save one private submission before sending. Resume with nansen feedback resume. Use --new for a deliberate new report after confirmation or local erasure. Pending data expires after one calendar year; feedback commands enforce cleanup. Automatic IDs require POSIX private storage and native locking; otherwise supply an explicit ID. The report file is a JSON object with required category and description. Category is one of bug, data_quality, documentation, missing_capability, usability or other; a feature request or product gap is missing_capability. Optional fields: endpoint, tool, goal, expected_behavior, observed_behavior, workaround, request_ids and client. The API rejects any other field or category with a 422, so do not add fields such as title, summary or severity. nansen feedback submit --help lists the limits. Agents: send on your own only after an authenticated read shows the account preference is enabled and host controls permit it. Otherwise show the report and ask first; a direct user request permits that report. Use nansen feedback preferences --json for a fresh account preference before each new automatic report. If the read fails, show the report and ask. Host or local-deny controls still apply. Direct lasting choices to Superapp settings. Never enable the preference automatically. Submit is noninteractive and does not verify approval. New submissions may be paused before release or during an outage. A 503 with reason feedback_admissions_paused means this attempt accepted no new report and used no weekly allowance. Tell the user feedback is unavailable and stop; do not keep retrying or ask for approval again in the same session. Preserve the ID and unchanged file for a later retry. A 403 with reason feedback_not_enabled means this account is outside rollout. Stop automatic retries; approval and saved preferences do not override it. Preserve IDs and earlier uncertain outcomes. Accepted-ID replays and receipt reads remain available during a pause.",
|
|
6
6
|
"subcommands": {
|
|
7
7
|
"submit": {
|
|
8
8
|
"description": "Submit a JSON report. Received means saved; human review may still be pending.",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"file": {
|
|
12
12
|
"type": "string",
|
|
13
13
|
"required": true,
|
|
14
|
-
"description": "JSON report file
|
|
14
|
+
"description": "JSON report file. Fields and categories are listed under report."
|
|
15
15
|
},
|
|
16
16
|
"submission-id": {
|
|
17
17
|
"type": "string",
|
|
@@ -41,13 +41,67 @@
|
|
|
41
41
|
"examples": [
|
|
42
42
|
"nansen feedback submit --file feedback.json --json",
|
|
43
43
|
"nansen feedback submit --file feedback.json --submission-id report-123 --json"
|
|
44
|
-
]
|
|
44
|
+
],
|
|
45
|
+
"report": {
|
|
46
|
+
"description": "JSON object in --file. Unknown fields and categories are rejected.",
|
|
47
|
+
"fields": {
|
|
48
|
+
"category": {
|
|
49
|
+
"required": true,
|
|
50
|
+
"description": "Kind of problem. A feature request or product gap is missing_capability.",
|
|
51
|
+
"enum": [
|
|
52
|
+
"bug",
|
|
53
|
+
"data_quality",
|
|
54
|
+
"documentation",
|
|
55
|
+
"missing_capability",
|
|
56
|
+
"usability",
|
|
57
|
+
"other"
|
|
58
|
+
]
|
|
59
|
+
},
|
|
60
|
+
"description": {
|
|
61
|
+
"required": true,
|
|
62
|
+
"description": "What happened and what was needed, up to 2,000 characters."
|
|
63
|
+
},
|
|
64
|
+
"endpoint": {
|
|
65
|
+
"description": "API endpoint path involved, without query string or credentials, up to 256 characters."
|
|
66
|
+
},
|
|
67
|
+
"tool": {
|
|
68
|
+
"description": "Tool name involved, up to 256 characters."
|
|
69
|
+
},
|
|
70
|
+
"goal": {
|
|
71
|
+
"description": "What you were trying to do, up to 2,000 characters."
|
|
72
|
+
},
|
|
73
|
+
"expected_behavior": {
|
|
74
|
+
"description": "What you expected, up to 2,000 characters."
|
|
75
|
+
},
|
|
76
|
+
"observed_behavior": {
|
|
77
|
+
"description": "What happened instead, up to 2,000 characters."
|
|
78
|
+
},
|
|
79
|
+
"workaround": {
|
|
80
|
+
"description": "Any workaround used, up to 2,000 characters."
|
|
81
|
+
},
|
|
82
|
+
"request_ids": {
|
|
83
|
+
"description": "Array of up to 10 distinct request IDs from your own requests, each up to 128 characters."
|
|
84
|
+
},
|
|
85
|
+
"client": {
|
|
86
|
+
"description": "Object with name and version, up to 64 characters each. Attribution only."
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
"example": {
|
|
90
|
+
"category": "missing_capability",
|
|
91
|
+
"description": "I need to compare labels across 50 wallets but cannot find a bulk lookup.",
|
|
92
|
+
"goal": "Compare labels across a wallet list."
|
|
93
|
+
}
|
|
94
|
+
}
|
|
45
95
|
},
|
|
46
96
|
"get": {
|
|
47
97
|
"description": "Read the current receipt. Reviewed means triaged; closed means review complete. Neither promises a fix date.",
|
|
48
98
|
"endpoint": "/api/v1/feedback/{feedback_id}",
|
|
49
99
|
"args": [
|
|
50
|
-
|
|
100
|
+
{
|
|
101
|
+
"name": "feedback-id",
|
|
102
|
+
"required": true,
|
|
103
|
+
"description": "Feedback ID from a submit receipt, such as fb_01JA8Z6K2R7N4Q9V3T5W8X1Y2Z."
|
|
104
|
+
}
|
|
51
105
|
],
|
|
52
106
|
"options": {
|
|
53
107
|
"json": {
|
|
@@ -122,6 +176,7 @@
|
|
|
122
176
|
"order": {
|
|
123
177
|
"submitsTo": "https://api.hyperliquid.xyz/exchange",
|
|
124
178
|
"apiEndpoints": [
|
|
179
|
+
"/api/v1/perp/positions",
|
|
125
180
|
"/api/v1/perp/meta",
|
|
126
181
|
"/api/v1/perp/builder-fee",
|
|
127
182
|
"/api/v1/sanctions/screen"
|
|
@@ -189,12 +244,24 @@
|
|
|
189
244
|
"wallet": {
|
|
190
245
|
"type": "string",
|
|
191
246
|
"description": "Wallet name (defaults to the configured default wallet)"
|
|
247
|
+
},
|
|
248
|
+
"dry-run": {
|
|
249
|
+
"type": "boolean",
|
|
250
|
+
"description": "Run the normal validation and read-only lookups (asset metadata, builder fee, open position, compliance screen), print the order plan (coin, side, rounded size, price and type, take-profit/stop-loss, estimated notional, leverage, builder fee), then stop. Nothing is signed or sent to Hyperliquid, no wallet password is needed, and the one-time builder-fee approval is not submitted. Exits 0."
|
|
251
|
+
},
|
|
252
|
+
"yes": {
|
|
253
|
+
"type": "boolean",
|
|
254
|
+
"aliases": [
|
|
255
|
+
"y"
|
|
256
|
+
],
|
|
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."
|
|
192
258
|
}
|
|
193
259
|
}
|
|
194
260
|
},
|
|
195
261
|
"cancel": {
|
|
196
262
|
"submitsTo": "https://api.hyperliquid.xyz/exchange",
|
|
197
263
|
"apiEndpoints": [
|
|
264
|
+
"/api/v1/perp/orders",
|
|
198
265
|
"/api/v1/perp/meta",
|
|
199
266
|
"/api/v1/sanctions/screen"
|
|
200
267
|
],
|
|
@@ -213,6 +280,17 @@
|
|
|
213
280
|
"wallet": {
|
|
214
281
|
"type": "string",
|
|
215
282
|
"description": "Wallet name"
|
|
283
|
+
},
|
|
284
|
+
"dry-run": {
|
|
285
|
+
"type": "boolean",
|
|
286
|
+
"description": "Run the normal validation and read-only lookups (asset metadata, open orders, compliance screen), print the cancel plan (coin, order id, the matching open order), then stop. Nothing is signed or sent to Hyperliquid and no wallet password is needed. Exits 0."
|
|
287
|
+
},
|
|
288
|
+
"yes": {
|
|
289
|
+
"type": "boolean",
|
|
290
|
+
"aliases": [
|
|
291
|
+
"y"
|
|
292
|
+
],
|
|
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."
|
|
216
294
|
}
|
|
217
295
|
}
|
|
218
296
|
},
|
|
@@ -258,12 +336,24 @@
|
|
|
258
336
|
"wallet": {
|
|
259
337
|
"type": "string",
|
|
260
338
|
"description": "Wallet name"
|
|
339
|
+
},
|
|
340
|
+
"dry-run": {
|
|
341
|
+
"type": "boolean",
|
|
342
|
+
"description": "Run the normal validation and read-only lookups (asset metadata, open position and close-direction check, builder fee, compliance screen), print the close plan (coin, side, rounded size, worst fill price after slippage, estimated notional, open position, builder fee), then stop. Nothing is signed or sent to Hyperliquid, no wallet password is needed, and the one-time builder-fee approval is not submitted. Exits 0, or exits 1 with NO_OPEN_POSITION when the wallet has no open position in that coin. A real close (without --dry-run) does not make this check; Hyperliquid rejects a close with nothing to close."
|
|
343
|
+
},
|
|
344
|
+
"yes": {
|
|
345
|
+
"type": "boolean",
|
|
346
|
+
"aliases": [
|
|
347
|
+
"y"
|
|
348
|
+
],
|
|
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."
|
|
261
350
|
}
|
|
262
351
|
}
|
|
263
352
|
},
|
|
264
353
|
"leverage": {
|
|
265
354
|
"submitsTo": "https://api.hyperliquid.xyz/exchange",
|
|
266
355
|
"apiEndpoints": [
|
|
356
|
+
"/api/v1/perp/positions",
|
|
267
357
|
"/api/v1/perp/meta",
|
|
268
358
|
"/api/v1/sanctions/screen"
|
|
269
359
|
],
|
|
@@ -291,6 +381,17 @@
|
|
|
291
381
|
"wallet": {
|
|
292
382
|
"type": "string",
|
|
293
383
|
"description": "Wallet name"
|
|
384
|
+
},
|
|
385
|
+
"dry-run": {
|
|
386
|
+
"type": "boolean",
|
|
387
|
+
"description": "Run the normal validation and read-only lookups (asset metadata and maximum leverage, open position, compliance screen), print the leverage plan (coin, leverage, margin type, asset maximum, open position), then stop. Nothing is signed or sent to Hyperliquid and no wallet password is needed. Exits 0."
|
|
388
|
+
},
|
|
389
|
+
"yes": {
|
|
390
|
+
"type": "boolean",
|
|
391
|
+
"aliases": [
|
|
392
|
+
"y"
|
|
393
|
+
],
|
|
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."
|
|
294
395
|
}
|
|
295
396
|
}
|
|
296
397
|
},
|
|
@@ -383,7 +484,7 @@
|
|
|
383
484
|
"notes": "Signed locally and submitted directly to Hyperliquid. apiEndpoints lists the Nansen API routes each command reads (compliance screening, market metadata, builder-fee status)."
|
|
384
485
|
},
|
|
385
486
|
"bridge": {
|
|
386
|
-
"description": "Move funds between
|
|
487
|
+
"description": "Move funds between EVM chains and Hyperliquid",
|
|
387
488
|
"notes": "Supported routes: base -> hyperliquid (deposit); hyperliquid -> base, hyperliquid -> ethereum, hyperliquid -> arbitrum (withdrawal). Any other combination is rejected. base -> hyperliquid deposits currently support USDC only — a non-USDC --from-token is rejected with INVALID_INPUT before the quote is created. Deposits broadcast an EVM transaction from the local wallet, so they require a locally signable origin chain; withdrawals sign a Hyperliquid action and never transact on the destination chain.",
|
|
388
489
|
"routes": [
|
|
389
490
|
{
|
|
@@ -514,6 +615,9 @@
|
|
|
514
615
|
},
|
|
515
616
|
"yes": {
|
|
516
617
|
"type": "boolean",
|
|
618
|
+
"aliases": [
|
|
619
|
+
"y"
|
|
620
|
+
],
|
|
517
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."
|
|
518
622
|
}
|
|
519
623
|
},
|
|
@@ -554,9 +658,13 @@
|
|
|
554
658
|
"wallet": {
|
|
555
659
|
"type": "string",
|
|
556
660
|
"required": true,
|
|
557
|
-
"description": "Wallet address to fetch DeFi positions for"
|
|
661
|
+
"description": "Wallet address to fetch DeFi positions for",
|
|
662
|
+
"aliases": [
|
|
663
|
+
"address"
|
|
664
|
+
]
|
|
558
665
|
}
|
|
559
|
-
}
|
|
666
|
+
},
|
|
667
|
+
"pagination": false
|
|
560
668
|
}
|
|
561
669
|
},
|
|
562
670
|
"description": "Portfolio analytics"
|
|
@@ -571,6 +679,30 @@
|
|
|
571
679
|
"type": "string",
|
|
572
680
|
"default": "solana",
|
|
573
681
|
"description": "Chain to query"
|
|
682
|
+
},
|
|
683
|
+
"chains": {
|
|
684
|
+
"type": "string",
|
|
685
|
+
"description": "Comma-separated chains; overrides --chain",
|
|
686
|
+
"repeatable": true
|
|
687
|
+
},
|
|
688
|
+
"filters": {
|
|
689
|
+
"type": "string",
|
|
690
|
+
"format": "json",
|
|
691
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
692
|
+
},
|
|
693
|
+
"sort": {
|
|
694
|
+
"type": "string",
|
|
695
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
696
|
+
},
|
|
697
|
+
"order-by": {
|
|
698
|
+
"type": "string",
|
|
699
|
+
"format": "json",
|
|
700
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
701
|
+
},
|
|
702
|
+
"labels": {
|
|
703
|
+
"type": "string",
|
|
704
|
+
"description": "Smart money labels to include, comma-separated or repeated; sent as filters.include_smart_money_labels",
|
|
705
|
+
"repeatable": true
|
|
574
706
|
}
|
|
575
707
|
}
|
|
576
708
|
},
|
|
@@ -582,16 +714,86 @@
|
|
|
582
714
|
"type": "string",
|
|
583
715
|
"default": "solana",
|
|
584
716
|
"description": "Chain to query"
|
|
717
|
+
},
|
|
718
|
+
"chains": {
|
|
719
|
+
"type": "string",
|
|
720
|
+
"description": "Comma-separated chains; overrides --chain",
|
|
721
|
+
"repeatable": true
|
|
722
|
+
},
|
|
723
|
+
"filters": {
|
|
724
|
+
"type": "string",
|
|
725
|
+
"format": "json",
|
|
726
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
727
|
+
},
|
|
728
|
+
"sort": {
|
|
729
|
+
"type": "string",
|
|
730
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
731
|
+
},
|
|
732
|
+
"order-by": {
|
|
733
|
+
"type": "string",
|
|
734
|
+
"format": "json",
|
|
735
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
736
|
+
},
|
|
737
|
+
"labels": {
|
|
738
|
+
"type": "string",
|
|
739
|
+
"description": "Smart money labels to include, comma-separated or repeated; sent as filters.include_smart_money_labels",
|
|
740
|
+
"repeatable": true
|
|
585
741
|
}
|
|
586
742
|
}
|
|
587
743
|
},
|
|
588
744
|
"perp-trades": {
|
|
589
745
|
"endpoint": "/api/v1/smart-money/perp-trades",
|
|
590
|
-
"description": "Perpetual trading on Hyperliquid"
|
|
746
|
+
"description": "Perpetual trading on Hyperliquid",
|
|
747
|
+
"options": {
|
|
748
|
+
"filters": {
|
|
749
|
+
"type": "string",
|
|
750
|
+
"format": "json",
|
|
751
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
752
|
+
},
|
|
753
|
+
"sort": {
|
|
754
|
+
"type": "string",
|
|
755
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
756
|
+
},
|
|
757
|
+
"order-by": {
|
|
758
|
+
"type": "string",
|
|
759
|
+
"format": "json",
|
|
760
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
761
|
+
},
|
|
762
|
+
"labels": {
|
|
763
|
+
"type": "string",
|
|
764
|
+
"description": "Smart money labels to include, comma-separated or repeated; sent as filters.include_smart_money_labels",
|
|
765
|
+
"repeatable": true
|
|
766
|
+
},
|
|
767
|
+
"only-new-positions": {
|
|
768
|
+
"type": "boolean",
|
|
769
|
+
"description": "Only trades that open a new position"
|
|
770
|
+
}
|
|
771
|
+
}
|
|
591
772
|
},
|
|
592
773
|
"dcas": {
|
|
593
774
|
"endpoint": "/api/v1/smart-money/dcas",
|
|
594
|
-
"description": "DCA strategies on Jupiter"
|
|
775
|
+
"description": "DCA strategies on Jupiter",
|
|
776
|
+
"options": {
|
|
777
|
+
"filters": {
|
|
778
|
+
"type": "string",
|
|
779
|
+
"format": "json",
|
|
780
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
781
|
+
},
|
|
782
|
+
"sort": {
|
|
783
|
+
"type": "string",
|
|
784
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
785
|
+
},
|
|
786
|
+
"order-by": {
|
|
787
|
+
"type": "string",
|
|
788
|
+
"format": "json",
|
|
789
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
790
|
+
},
|
|
791
|
+
"labels": {
|
|
792
|
+
"type": "string",
|
|
793
|
+
"description": "Smart money labels to include, comma-separated or repeated; sent as filters.include_smart_money_labels",
|
|
794
|
+
"repeatable": true
|
|
795
|
+
}
|
|
796
|
+
}
|
|
595
797
|
},
|
|
596
798
|
"holdings": {
|
|
597
799
|
"endpoint": "/api/v1/smart-money/holdings",
|
|
@@ -601,6 +803,34 @@
|
|
|
601
803
|
"type": "string",
|
|
602
804
|
"default": "solana",
|
|
603
805
|
"description": "Chain to query"
|
|
806
|
+
},
|
|
807
|
+
"chains": {
|
|
808
|
+
"type": "string",
|
|
809
|
+
"description": "Comma-separated chains; overrides --chain",
|
|
810
|
+
"repeatable": true
|
|
811
|
+
},
|
|
812
|
+
"filters": {
|
|
813
|
+
"type": "string",
|
|
814
|
+
"format": "json",
|
|
815
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
816
|
+
},
|
|
817
|
+
"sort": {
|
|
818
|
+
"type": "string",
|
|
819
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
820
|
+
},
|
|
821
|
+
"order-by": {
|
|
822
|
+
"type": "string",
|
|
823
|
+
"format": "json",
|
|
824
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
825
|
+
},
|
|
826
|
+
"labels": {
|
|
827
|
+
"type": "string",
|
|
828
|
+
"description": "Smart money labels to include, comma-separated or repeated; sent as filters.include_smart_money_labels",
|
|
829
|
+
"repeatable": true
|
|
830
|
+
},
|
|
831
|
+
"token": {
|
|
832
|
+
"type": "string",
|
|
833
|
+
"description": "Only this token (contract address); sent as filters.token_address"
|
|
604
834
|
}
|
|
605
835
|
}
|
|
606
836
|
},
|
|
@@ -618,6 +848,30 @@
|
|
|
618
848
|
"minimum": 0,
|
|
619
849
|
"default": 30,
|
|
620
850
|
"description": "Lookback window in days"
|
|
851
|
+
},
|
|
852
|
+
"chains": {
|
|
853
|
+
"type": "string",
|
|
854
|
+
"description": "Comma-separated chains; overrides --chain",
|
|
855
|
+
"repeatable": true
|
|
856
|
+
},
|
|
857
|
+
"filters": {
|
|
858
|
+
"type": "string",
|
|
859
|
+
"format": "json",
|
|
860
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
861
|
+
},
|
|
862
|
+
"sort": {
|
|
863
|
+
"type": "string",
|
|
864
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
865
|
+
},
|
|
866
|
+
"order-by": {
|
|
867
|
+
"type": "string",
|
|
868
|
+
"format": "json",
|
|
869
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
870
|
+
},
|
|
871
|
+
"labels": {
|
|
872
|
+
"type": "string",
|
|
873
|
+
"description": "Smart money labels to include, comma-separated or repeated; sent as filters.include_smart_money_labels",
|
|
874
|
+
"repeatable": true
|
|
621
875
|
}
|
|
622
876
|
}
|
|
623
877
|
}
|
|
@@ -645,6 +899,25 @@
|
|
|
645
899
|
"minimum": 0,
|
|
646
900
|
"default": 30,
|
|
647
901
|
"description": "Lookback window in days"
|
|
902
|
+
},
|
|
903
|
+
"date": {
|
|
904
|
+
"type": "string",
|
|
905
|
+
"description": "Date range: YYYY-MM-DD or {\"from\":\"YYYY-MM-DD\",\"to\":\"YYYY-MM-DD\"}; overrides --days",
|
|
906
|
+
"format": "json"
|
|
907
|
+
},
|
|
908
|
+
"filters": {
|
|
909
|
+
"type": "string",
|
|
910
|
+
"format": "json",
|
|
911
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
912
|
+
},
|
|
913
|
+
"sort": {
|
|
914
|
+
"type": "string",
|
|
915
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
916
|
+
},
|
|
917
|
+
"order-by": {
|
|
918
|
+
"type": "string",
|
|
919
|
+
"format": "json",
|
|
920
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
648
921
|
}
|
|
649
922
|
}
|
|
650
923
|
},
|
|
@@ -668,7 +941,8 @@
|
|
|
668
941
|
"default": 30,
|
|
669
942
|
"description": "Lookback window in days"
|
|
670
943
|
}
|
|
671
|
-
}
|
|
944
|
+
},
|
|
945
|
+
"pagination": false
|
|
672
946
|
},
|
|
673
947
|
"balance": {
|
|
674
948
|
"endpoint": "/api/v1/profiler/address/current-balance",
|
|
@@ -677,12 +951,36 @@
|
|
|
677
951
|
"address": {
|
|
678
952
|
"type": "string",
|
|
679
953
|
"required": true,
|
|
680
|
-
"description": "Wallet address to profile"
|
|
954
|
+
"description": "Wallet address to profile",
|
|
955
|
+
"requiredUnless": [
|
|
956
|
+
"entity"
|
|
957
|
+
]
|
|
681
958
|
},
|
|
682
959
|
"chain": {
|
|
683
960
|
"type": "string",
|
|
684
961
|
"default": "ethereum",
|
|
685
962
|
"description": "Chain to profile the address on"
|
|
963
|
+
},
|
|
964
|
+
"entity": {
|
|
965
|
+
"type": "string",
|
|
966
|
+
"aliases": [
|
|
967
|
+
"entity-name"
|
|
968
|
+
],
|
|
969
|
+
"description": "Nansen entity name to profile instead of --address"
|
|
970
|
+
},
|
|
971
|
+
"filters": {
|
|
972
|
+
"type": "string",
|
|
973
|
+
"format": "json",
|
|
974
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
975
|
+
},
|
|
976
|
+
"sort": {
|
|
977
|
+
"type": "string",
|
|
978
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
979
|
+
},
|
|
980
|
+
"order-by": {
|
|
981
|
+
"type": "string",
|
|
982
|
+
"format": "json",
|
|
983
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
686
984
|
}
|
|
687
985
|
}
|
|
688
986
|
},
|
|
@@ -705,6 +1003,20 @@
|
|
|
705
1003
|
"minimum": 0,
|
|
706
1004
|
"default": 30,
|
|
707
1005
|
"description": "Lookback window in days"
|
|
1006
|
+
},
|
|
1007
|
+
"filters": {
|
|
1008
|
+
"type": "string",
|
|
1009
|
+
"format": "json",
|
|
1010
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1011
|
+
},
|
|
1012
|
+
"sort": {
|
|
1013
|
+
"type": "string",
|
|
1014
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1015
|
+
},
|
|
1016
|
+
"order-by": {
|
|
1017
|
+
"type": "string",
|
|
1018
|
+
"format": "json",
|
|
1019
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
708
1020
|
}
|
|
709
1021
|
}
|
|
710
1022
|
},
|
|
@@ -714,7 +1026,12 @@
|
|
|
714
1026
|
"options": {
|
|
715
1027
|
"addresses": {
|
|
716
1028
|
"type": "string",
|
|
717
|
-
"description": "Comma-separated list (or JSON array) of up to 10 distinct wallet addresses; required unless --file <path> is provided"
|
|
1029
|
+
"description": "Comma-separated list (or JSON array) of up to 10 distinct wallet addresses; required unless --file <path> is provided",
|
|
1030
|
+
"required": true,
|
|
1031
|
+
"requiredUnless": [
|
|
1032
|
+
"file"
|
|
1033
|
+
],
|
|
1034
|
+
"repeatable": true
|
|
718
1035
|
},
|
|
719
1036
|
"file": {
|
|
720
1037
|
"type": "string",
|
|
@@ -730,6 +1047,20 @@
|
|
|
730
1047
|
"minimum": 0,
|
|
731
1048
|
"default": 30,
|
|
732
1049
|
"description": "Lookback window in days (max 90 for this command)"
|
|
1050
|
+
},
|
|
1051
|
+
"filters": {
|
|
1052
|
+
"type": "string",
|
|
1053
|
+
"format": "json",
|
|
1054
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1055
|
+
},
|
|
1056
|
+
"sort": {
|
|
1057
|
+
"type": "string",
|
|
1058
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1059
|
+
},
|
|
1060
|
+
"order-by": {
|
|
1061
|
+
"type": "string",
|
|
1062
|
+
"format": "json",
|
|
1063
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
733
1064
|
}
|
|
734
1065
|
}
|
|
735
1066
|
},
|
|
@@ -752,6 +1083,20 @@
|
|
|
752
1083
|
"minimum": 0,
|
|
753
1084
|
"default": 30,
|
|
754
1085
|
"description": "Lookback window in days"
|
|
1086
|
+
},
|
|
1087
|
+
"filters": {
|
|
1088
|
+
"type": "string",
|
|
1089
|
+
"format": "json",
|
|
1090
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1091
|
+
},
|
|
1092
|
+
"sort": {
|
|
1093
|
+
"type": "string",
|
|
1094
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1095
|
+
},
|
|
1096
|
+
"order-by": {
|
|
1097
|
+
"type": "string",
|
|
1098
|
+
"format": "json",
|
|
1099
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
755
1100
|
}
|
|
756
1101
|
}
|
|
757
1102
|
},
|
|
@@ -768,6 +1113,15 @@
|
|
|
768
1113
|
"type": "string",
|
|
769
1114
|
"default": "ethereum",
|
|
770
1115
|
"description": "Chain to profile the address on"
|
|
1116
|
+
},
|
|
1117
|
+
"sort": {
|
|
1118
|
+
"type": "string",
|
|
1119
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1120
|
+
},
|
|
1121
|
+
"order-by": {
|
|
1122
|
+
"type": "string",
|
|
1123
|
+
"format": "json",
|
|
1124
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
771
1125
|
}
|
|
772
1126
|
}
|
|
773
1127
|
},
|
|
@@ -780,7 +1134,8 @@
|
|
|
780
1134
|
"required": true,
|
|
781
1135
|
"description": "Address whose first funder to find"
|
|
782
1136
|
}
|
|
783
|
-
}
|
|
1137
|
+
},
|
|
1138
|
+
"pagination": false
|
|
784
1139
|
},
|
|
785
1140
|
"pnl": {
|
|
786
1141
|
"endpoint": "/api/v1/profiler/address/pnl",
|
|
@@ -801,6 +1156,25 @@
|
|
|
801
1156
|
"minimum": 0,
|
|
802
1157
|
"default": 30,
|
|
803
1158
|
"description": "Lookback window in days"
|
|
1159
|
+
},
|
|
1160
|
+
"date": {
|
|
1161
|
+
"type": "string",
|
|
1162
|
+
"description": "Date range: YYYY-MM-DD or {\"from\":\"YYYY-MM-DD\",\"to\":\"YYYY-MM-DD\"}; overrides --days",
|
|
1163
|
+
"format": "json"
|
|
1164
|
+
},
|
|
1165
|
+
"filters": {
|
|
1166
|
+
"type": "string",
|
|
1167
|
+
"format": "json",
|
|
1168
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1169
|
+
},
|
|
1170
|
+
"sort": {
|
|
1171
|
+
"type": "string",
|
|
1172
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1173
|
+
},
|
|
1174
|
+
"order-by": {
|
|
1175
|
+
"type": "string",
|
|
1176
|
+
"format": "json",
|
|
1177
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
804
1178
|
}
|
|
805
1179
|
}
|
|
806
1180
|
},
|
|
@@ -828,8 +1202,23 @@
|
|
|
828
1202
|
"type": "string",
|
|
829
1203
|
"required": true,
|
|
830
1204
|
"description": "Hyperliquid trader address"
|
|
1205
|
+
},
|
|
1206
|
+
"filters": {
|
|
1207
|
+
"type": "string",
|
|
1208
|
+
"format": "json",
|
|
1209
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1210
|
+
},
|
|
1211
|
+
"sort": {
|
|
1212
|
+
"type": "string",
|
|
1213
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1214
|
+
},
|
|
1215
|
+
"order-by": {
|
|
1216
|
+
"type": "string",
|
|
1217
|
+
"format": "json",
|
|
1218
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
831
1219
|
}
|
|
832
|
-
}
|
|
1220
|
+
},
|
|
1221
|
+
"pagination": false
|
|
833
1222
|
},
|
|
834
1223
|
"perp-trades": {
|
|
835
1224
|
"endpoint": "/api/v1/profiler/perp-trades",
|
|
@@ -845,6 +1234,20 @@
|
|
|
845
1234
|
"minimum": 0,
|
|
846
1235
|
"default": 30,
|
|
847
1236
|
"description": "Lookback window in days"
|
|
1237
|
+
},
|
|
1238
|
+
"filters": {
|
|
1239
|
+
"type": "string",
|
|
1240
|
+
"format": "json",
|
|
1241
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1242
|
+
},
|
|
1243
|
+
"sort": {
|
|
1244
|
+
"type": "string",
|
|
1245
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1246
|
+
},
|
|
1247
|
+
"order-by": {
|
|
1248
|
+
"type": "string",
|
|
1249
|
+
"format": "json",
|
|
1250
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
848
1251
|
}
|
|
849
1252
|
}
|
|
850
1253
|
},
|
|
@@ -867,6 +1270,25 @@
|
|
|
867
1270
|
"minimum": 0,
|
|
868
1271
|
"default": 30,
|
|
869
1272
|
"description": "Lookback window in days"
|
|
1273
|
+
},
|
|
1274
|
+
"date": {
|
|
1275
|
+
"type": "string",
|
|
1276
|
+
"description": "Date range: YYYY-MM-DD or {\"from\":\"YYYY-MM-DD\",\"to\":\"YYYY-MM-DD\"}; overrides --days",
|
|
1277
|
+
"format": "json"
|
|
1278
|
+
},
|
|
1279
|
+
"filters": {
|
|
1280
|
+
"type": "string",
|
|
1281
|
+
"format": "json",
|
|
1282
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1283
|
+
},
|
|
1284
|
+
"sort": {
|
|
1285
|
+
"type": "string",
|
|
1286
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1287
|
+
},
|
|
1288
|
+
"order-by": {
|
|
1289
|
+
"type": "string",
|
|
1290
|
+
"format": "json",
|
|
1291
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
870
1292
|
}
|
|
871
1293
|
}
|
|
872
1294
|
},
|
|
@@ -879,7 +1301,8 @@
|
|
|
879
1301
|
"required": true,
|
|
880
1302
|
"description": "Entity or label name to search for"
|
|
881
1303
|
}
|
|
882
|
-
}
|
|
1304
|
+
},
|
|
1305
|
+
"pagination": false
|
|
883
1306
|
},
|
|
884
1307
|
"batch": {
|
|
885
1308
|
"description": "Batch profile multiple addresses",
|
|
@@ -892,14 +1315,29 @@
|
|
|
892
1315
|
"include": {
|
|
893
1316
|
"type": "string",
|
|
894
1317
|
"default": "labels,balance",
|
|
895
|
-
"description": "Comma-separated sections to fetch per address: labels, balance, pnl"
|
|
1318
|
+
"description": "Comma-separated sections to fetch per address: labels, balance, pnl",
|
|
1319
|
+
"repeatable": true
|
|
896
1320
|
},
|
|
897
1321
|
"delay": {
|
|
898
1322
|
"type": "number",
|
|
899
1323
|
"default": 1000,
|
|
900
1324
|
"description": "Delay in milliseconds between API calls"
|
|
1325
|
+
},
|
|
1326
|
+
"addresses": {
|
|
1327
|
+
"type": "string",
|
|
1328
|
+
"description": "Comma-separated addresses (max 100)",
|
|
1329
|
+
"required": true,
|
|
1330
|
+
"requiredUnless": [
|
|
1331
|
+
"file"
|
|
1332
|
+
],
|
|
1333
|
+
"repeatable": true
|
|
1334
|
+
},
|
|
1335
|
+
"file": {
|
|
1336
|
+
"type": "string",
|
|
1337
|
+
"description": "File with one address per line"
|
|
901
1338
|
}
|
|
902
|
-
}
|
|
1339
|
+
},
|
|
1340
|
+
"pagination": false
|
|
903
1341
|
},
|
|
904
1342
|
"trace": {
|
|
905
1343
|
"description": "Multi-hop counterparty trace (BFS)",
|
|
@@ -935,7 +1373,8 @@
|
|
|
935
1373
|
"default": 1000,
|
|
936
1374
|
"description": "Delay in milliseconds between API calls"
|
|
937
1375
|
}
|
|
938
|
-
}
|
|
1376
|
+
},
|
|
1377
|
+
"pagination": false
|
|
939
1378
|
},
|
|
940
1379
|
"compare": {
|
|
941
1380
|
"description": "Compare two wallets (shared counterparties, tokens)",
|
|
@@ -943,7 +1382,8 @@
|
|
|
943
1382
|
"addresses": {
|
|
944
1383
|
"type": "string",
|
|
945
1384
|
"required": true,
|
|
946
|
-
"description": "Comma-separated list (or JSON array) of wallet addresses to compare"
|
|
1385
|
+
"description": "Comma-separated list (or JSON array) of wallet addresses to compare",
|
|
1386
|
+
"repeatable": true
|
|
947
1387
|
},
|
|
948
1388
|
"chain": {
|
|
949
1389
|
"type": "string",
|
|
@@ -956,7 +1396,8 @@
|
|
|
956
1396
|
"default": 30,
|
|
957
1397
|
"description": "Lookback window in days"
|
|
958
1398
|
}
|
|
959
|
-
}
|
|
1399
|
+
},
|
|
1400
|
+
"pagination": false
|
|
960
1401
|
}
|
|
961
1402
|
},
|
|
962
1403
|
"description": "Wallet profiling - detailed information about any blockchain address"
|
|
@@ -975,7 +1416,10 @@
|
|
|
975
1416
|
"token": {
|
|
976
1417
|
"type": "string",
|
|
977
1418
|
"required": true,
|
|
978
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1419
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1420
|
+
"aliases": [
|
|
1421
|
+
"token-address"
|
|
1422
|
+
]
|
|
979
1423
|
},
|
|
980
1424
|
"days": {
|
|
981
1425
|
"type": "integer",
|
|
@@ -992,7 +1436,31 @@
|
|
|
992
1436
|
"whale",
|
|
993
1437
|
"exchange"
|
|
994
1438
|
],
|
|
995
|
-
"default": "top_100_holders"
|
|
1439
|
+
"default": "top_100_holders",
|
|
1440
|
+
"type": "string"
|
|
1441
|
+
},
|
|
1442
|
+
"date": {
|
|
1443
|
+
"type": "string",
|
|
1444
|
+
"description": "Date range: YYYY-MM-DD or {\"from\":\"YYYY-MM-DD\",\"to\":\"YYYY-MM-DD\"}; overrides --days",
|
|
1445
|
+
"format": "json"
|
|
1446
|
+
},
|
|
1447
|
+
"filters": {
|
|
1448
|
+
"type": "string",
|
|
1449
|
+
"format": "json",
|
|
1450
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1451
|
+
},
|
|
1452
|
+
"sort": {
|
|
1453
|
+
"type": "string",
|
|
1454
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1455
|
+
},
|
|
1456
|
+
"order-by": {
|
|
1457
|
+
"type": "string",
|
|
1458
|
+
"format": "json",
|
|
1459
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1460
|
+
},
|
|
1461
|
+
"smart-money": {
|
|
1462
|
+
"type": "boolean",
|
|
1463
|
+
"description": "Only smart money wallets"
|
|
996
1464
|
}
|
|
997
1465
|
}
|
|
998
1466
|
},
|
|
@@ -1008,7 +1476,10 @@
|
|
|
1008
1476
|
"token": {
|
|
1009
1477
|
"type": "string",
|
|
1010
1478
|
"required": true,
|
|
1011
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1479
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1480
|
+
"aliases": [
|
|
1481
|
+
"token-address"
|
|
1482
|
+
]
|
|
1012
1483
|
},
|
|
1013
1484
|
"days": {
|
|
1014
1485
|
"type": "integer",
|
|
@@ -1022,7 +1493,31 @@
|
|
|
1022
1493
|
"BUY",
|
|
1023
1494
|
"SELL"
|
|
1024
1495
|
],
|
|
1025
|
-
"default": "BUY"
|
|
1496
|
+
"default": "BUY",
|
|
1497
|
+
"type": "string"
|
|
1498
|
+
},
|
|
1499
|
+
"date": {
|
|
1500
|
+
"type": "string",
|
|
1501
|
+
"description": "Date range: YYYY-MM-DD or {\"from\":\"YYYY-MM-DD\",\"to\":\"YYYY-MM-DD\"}; overrides --days",
|
|
1502
|
+
"format": "json"
|
|
1503
|
+
},
|
|
1504
|
+
"filters": {
|
|
1505
|
+
"type": "string",
|
|
1506
|
+
"format": "json",
|
|
1507
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1508
|
+
},
|
|
1509
|
+
"sort": {
|
|
1510
|
+
"type": "string",
|
|
1511
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1512
|
+
},
|
|
1513
|
+
"order-by": {
|
|
1514
|
+
"type": "string",
|
|
1515
|
+
"format": "json",
|
|
1516
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1517
|
+
},
|
|
1518
|
+
"smart-money": {
|
|
1519
|
+
"type": "boolean",
|
|
1520
|
+
"description": "Only smart money wallets"
|
|
1026
1521
|
}
|
|
1027
1522
|
}
|
|
1028
1523
|
},
|
|
@@ -1038,13 +1533,34 @@
|
|
|
1038
1533
|
"token": {
|
|
1039
1534
|
"type": "string",
|
|
1040
1535
|
"required": true,
|
|
1041
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1536
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1537
|
+
"aliases": [
|
|
1538
|
+
"token-address"
|
|
1539
|
+
]
|
|
1042
1540
|
},
|
|
1043
1541
|
"days": {
|
|
1044
1542
|
"type": "integer",
|
|
1045
1543
|
"minimum": 0,
|
|
1046
1544
|
"default": 30,
|
|
1047
1545
|
"description": "Lookback window in days"
|
|
1546
|
+
},
|
|
1547
|
+
"filters": {
|
|
1548
|
+
"type": "string",
|
|
1549
|
+
"format": "json",
|
|
1550
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1551
|
+
},
|
|
1552
|
+
"sort": {
|
|
1553
|
+
"type": "string",
|
|
1554
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1555
|
+
},
|
|
1556
|
+
"order-by": {
|
|
1557
|
+
"type": "string",
|
|
1558
|
+
"format": "json",
|
|
1559
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1560
|
+
},
|
|
1561
|
+
"smart-money": {
|
|
1562
|
+
"type": "boolean",
|
|
1563
|
+
"description": "Only smart money wallets"
|
|
1048
1564
|
}
|
|
1049
1565
|
}
|
|
1050
1566
|
},
|
|
@@ -1060,13 +1576,46 @@
|
|
|
1060
1576
|
"token": {
|
|
1061
1577
|
"type": "string",
|
|
1062
1578
|
"required": true,
|
|
1063
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1579
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1580
|
+
"aliases": [
|
|
1581
|
+
"token-address"
|
|
1582
|
+
]
|
|
1064
1583
|
},
|
|
1065
1584
|
"days": {
|
|
1066
1585
|
"type": "integer",
|
|
1067
1586
|
"minimum": 0,
|
|
1068
1587
|
"default": 30,
|
|
1069
1588
|
"description": "Lookback window in days"
|
|
1589
|
+
},
|
|
1590
|
+
"filters": {
|
|
1591
|
+
"type": "string",
|
|
1592
|
+
"format": "json",
|
|
1593
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1594
|
+
},
|
|
1595
|
+
"sort": {
|
|
1596
|
+
"type": "string",
|
|
1597
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1598
|
+
},
|
|
1599
|
+
"order-by": {
|
|
1600
|
+
"type": "string",
|
|
1601
|
+
"format": "json",
|
|
1602
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1603
|
+
},
|
|
1604
|
+
"from": {
|
|
1605
|
+
"type": "string",
|
|
1606
|
+
"description": "Only transfers from this address; sent as filters.from_address"
|
|
1607
|
+
},
|
|
1608
|
+
"to": {
|
|
1609
|
+
"type": "string",
|
|
1610
|
+
"description": "Only transfers to this address; sent as filters.to_address"
|
|
1611
|
+
},
|
|
1612
|
+
"enrich": {
|
|
1613
|
+
"type": "boolean",
|
|
1614
|
+
"description": "Add Nansen labels for the from/to addresses (extra requests)"
|
|
1615
|
+
},
|
|
1616
|
+
"smart-money": {
|
|
1617
|
+
"type": "boolean",
|
|
1618
|
+
"description": "Only smart money wallets"
|
|
1070
1619
|
}
|
|
1071
1620
|
}
|
|
1072
1621
|
},
|
|
@@ -1082,11 +1631,32 @@
|
|
|
1082
1631
|
"token": {
|
|
1083
1632
|
"type": "string",
|
|
1084
1633
|
"required": true,
|
|
1085
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1634
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1635
|
+
"aliases": [
|
|
1636
|
+
"token-address"
|
|
1637
|
+
]
|
|
1086
1638
|
},
|
|
1087
1639
|
"premium-labels": {
|
|
1088
1640
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
1089
1641
|
"type": "boolean"
|
|
1642
|
+
},
|
|
1643
|
+
"filters": {
|
|
1644
|
+
"type": "string",
|
|
1645
|
+
"format": "json",
|
|
1646
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1647
|
+
},
|
|
1648
|
+
"sort": {
|
|
1649
|
+
"type": "string",
|
|
1650
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1651
|
+
},
|
|
1652
|
+
"order-by": {
|
|
1653
|
+
"type": "string",
|
|
1654
|
+
"format": "json",
|
|
1655
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1656
|
+
},
|
|
1657
|
+
"smart-money": {
|
|
1658
|
+
"type": "boolean",
|
|
1659
|
+
"description": "Only smart money wallets"
|
|
1090
1660
|
}
|
|
1091
1661
|
}
|
|
1092
1662
|
},
|
|
@@ -1102,7 +1672,10 @@
|
|
|
1102
1672
|
"token": {
|
|
1103
1673
|
"type": "string",
|
|
1104
1674
|
"required": true,
|
|
1105
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1675
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1676
|
+
"aliases": [
|
|
1677
|
+
"token-address"
|
|
1678
|
+
]
|
|
1106
1679
|
},
|
|
1107
1680
|
"days": {
|
|
1108
1681
|
"type": "integer",
|
|
@@ -1113,6 +1686,24 @@
|
|
|
1113
1686
|
"premium-labels": {
|
|
1114
1687
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
1115
1688
|
"type": "boolean"
|
|
1689
|
+
},
|
|
1690
|
+
"filters": {
|
|
1691
|
+
"type": "string",
|
|
1692
|
+
"format": "json",
|
|
1693
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1694
|
+
},
|
|
1695
|
+
"sort": {
|
|
1696
|
+
"type": "string",
|
|
1697
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1698
|
+
},
|
|
1699
|
+
"order-by": {
|
|
1700
|
+
"type": "string",
|
|
1701
|
+
"format": "json",
|
|
1702
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1703
|
+
},
|
|
1704
|
+
"smart-money": {
|
|
1705
|
+
"type": "boolean",
|
|
1706
|
+
"description": "Only smart money wallets"
|
|
1116
1707
|
}
|
|
1117
1708
|
}
|
|
1118
1709
|
},
|
|
@@ -1123,7 +1714,10 @@
|
|
|
1123
1714
|
"symbol": {
|
|
1124
1715
|
"type": "string",
|
|
1125
1716
|
"required": true,
|
|
1126
|
-
"description": "Perp symbol, e.g. BTC"
|
|
1717
|
+
"description": "Perp symbol, e.g. BTC",
|
|
1718
|
+
"aliases": [
|
|
1719
|
+
"token-symbol"
|
|
1720
|
+
]
|
|
1127
1721
|
},
|
|
1128
1722
|
"days": {
|
|
1129
1723
|
"type": "integer",
|
|
@@ -1134,6 +1728,24 @@
|
|
|
1134
1728
|
"premium-labels": {
|
|
1135
1729
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
1136
1730
|
"type": "boolean"
|
|
1731
|
+
},
|
|
1732
|
+
"filters": {
|
|
1733
|
+
"type": "string",
|
|
1734
|
+
"format": "json",
|
|
1735
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1736
|
+
},
|
|
1737
|
+
"sort": {
|
|
1738
|
+
"type": "string",
|
|
1739
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1740
|
+
},
|
|
1741
|
+
"order-by": {
|
|
1742
|
+
"type": "string",
|
|
1743
|
+
"format": "json",
|
|
1744
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1745
|
+
},
|
|
1746
|
+
"smart-money": {
|
|
1747
|
+
"type": "boolean",
|
|
1748
|
+
"description": "Only smart money wallets"
|
|
1137
1749
|
}
|
|
1138
1750
|
}
|
|
1139
1751
|
},
|
|
@@ -1144,7 +1756,28 @@
|
|
|
1144
1756
|
"symbol": {
|
|
1145
1757
|
"type": "string",
|
|
1146
1758
|
"required": true,
|
|
1147
|
-
"description": "Perp symbol, e.g. BTC"
|
|
1759
|
+
"description": "Perp symbol, e.g. BTC",
|
|
1760
|
+
"aliases": [
|
|
1761
|
+
"token-symbol"
|
|
1762
|
+
]
|
|
1763
|
+
},
|
|
1764
|
+
"filters": {
|
|
1765
|
+
"type": "string",
|
|
1766
|
+
"format": "json",
|
|
1767
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1768
|
+
},
|
|
1769
|
+
"sort": {
|
|
1770
|
+
"type": "string",
|
|
1771
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1772
|
+
},
|
|
1773
|
+
"order-by": {
|
|
1774
|
+
"type": "string",
|
|
1775
|
+
"format": "json",
|
|
1776
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1777
|
+
},
|
|
1778
|
+
"smart-money": {
|
|
1779
|
+
"type": "boolean",
|
|
1780
|
+
"description": "Only smart money wallets"
|
|
1148
1781
|
}
|
|
1149
1782
|
}
|
|
1150
1783
|
},
|
|
@@ -1155,13 +1788,34 @@
|
|
|
1155
1788
|
"symbol": {
|
|
1156
1789
|
"type": "string",
|
|
1157
1790
|
"required": true,
|
|
1158
|
-
"description": "Perp symbol, e.g. BTC"
|
|
1791
|
+
"description": "Perp symbol, e.g. BTC",
|
|
1792
|
+
"aliases": [
|
|
1793
|
+
"token-symbol"
|
|
1794
|
+
]
|
|
1159
1795
|
},
|
|
1160
1796
|
"days": {
|
|
1161
1797
|
"type": "integer",
|
|
1162
1798
|
"minimum": 0,
|
|
1163
1799
|
"default": 30,
|
|
1164
1800
|
"description": "Lookback window in days"
|
|
1801
|
+
},
|
|
1802
|
+
"filters": {
|
|
1803
|
+
"type": "string",
|
|
1804
|
+
"format": "json",
|
|
1805
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1806
|
+
},
|
|
1807
|
+
"sort": {
|
|
1808
|
+
"type": "string",
|
|
1809
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1810
|
+
},
|
|
1811
|
+
"order-by": {
|
|
1812
|
+
"type": "string",
|
|
1813
|
+
"format": "json",
|
|
1814
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1815
|
+
},
|
|
1816
|
+
"smart-money": {
|
|
1817
|
+
"type": "boolean",
|
|
1818
|
+
"description": "Only smart money wallets"
|
|
1165
1819
|
}
|
|
1166
1820
|
}
|
|
1167
1821
|
},
|
|
@@ -1177,14 +1831,18 @@
|
|
|
1177
1831
|
"token": {
|
|
1178
1832
|
"type": "string",
|
|
1179
1833
|
"required": true,
|
|
1180
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1834
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1835
|
+
"aliases": [
|
|
1836
|
+
"token-address"
|
|
1837
|
+
]
|
|
1181
1838
|
},
|
|
1182
1839
|
"timeframe": {
|
|
1183
1840
|
"type": "string",
|
|
1184
1841
|
"default": "1d",
|
|
1185
1842
|
"description": "Time window for the flow metrics"
|
|
1186
1843
|
}
|
|
1187
|
-
}
|
|
1844
|
+
},
|
|
1845
|
+
"pagination": false
|
|
1188
1846
|
},
|
|
1189
1847
|
"info": {
|
|
1190
1848
|
"endpoint": "/api/v1/tgm/token-information",
|
|
@@ -1198,14 +1856,18 @@
|
|
|
1198
1856
|
"token": {
|
|
1199
1857
|
"type": "string",
|
|
1200
1858
|
"required": true,
|
|
1201
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1859
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1860
|
+
"aliases": [
|
|
1861
|
+
"token-address"
|
|
1862
|
+
]
|
|
1202
1863
|
},
|
|
1203
1864
|
"timeframe": {
|
|
1204
1865
|
"type": "string",
|
|
1205
1866
|
"default": "1d",
|
|
1206
1867
|
"description": "Time window for the price-change and volume fields"
|
|
1207
1868
|
}
|
|
1208
|
-
}
|
|
1869
|
+
},
|
|
1870
|
+
"pagination": false
|
|
1209
1871
|
},
|
|
1210
1872
|
"indicators": {
|
|
1211
1873
|
"endpoint": "/api/v1/tgm/indicators",
|
|
@@ -1219,9 +1881,13 @@
|
|
|
1219
1881
|
"token": {
|
|
1220
1882
|
"type": "string",
|
|
1221
1883
|
"required": true,
|
|
1222
|
-
"description": "Token contract address"
|
|
1884
|
+
"description": "Token contract address",
|
|
1885
|
+
"aliases": [
|
|
1886
|
+
"token-address"
|
|
1887
|
+
]
|
|
1223
1888
|
}
|
|
1224
|
-
}
|
|
1889
|
+
},
|
|
1890
|
+
"pagination": false
|
|
1225
1891
|
},
|
|
1226
1892
|
"ohlcv": {
|
|
1227
1893
|
"endpoint": "/api/v1/tgm/token-ohlcv",
|
|
@@ -1235,23 +1901,40 @@
|
|
|
1235
1901
|
"token": {
|
|
1236
1902
|
"type": "string",
|
|
1237
1903
|
"required": true,
|
|
1238
|
-
"description": "Token contract address (mint address on Solana)"
|
|
1904
|
+
"description": "Token contract address (mint address on Solana)",
|
|
1905
|
+
"aliases": [
|
|
1906
|
+
"token-address"
|
|
1907
|
+
]
|
|
1239
1908
|
},
|
|
1240
1909
|
"timeframe": {
|
|
1241
1910
|
"type": "string",
|
|
1242
1911
|
"default": "1d",
|
|
1243
1912
|
"description": "Candle interval"
|
|
1244
1913
|
}
|
|
1245
|
-
}
|
|
1914
|
+
},
|
|
1915
|
+
"pagination": false
|
|
1246
1916
|
},
|
|
1247
1917
|
"jup-dca": {
|
|
1248
1918
|
"endpoint": "/api/v1/tgm/jup-dca",
|
|
1249
1919
|
"description": "Jupiter DCA orders for token",
|
|
1920
|
+
"examples": ["nansen research token jup-dca --token So11111111111111111111111111111111111111112"],
|
|
1250
1921
|
"options": {
|
|
1251
1922
|
"token": {
|
|
1252
1923
|
"type": "string",
|
|
1253
1924
|
"required": true,
|
|
1254
|
-
"description": "Token mint address"
|
|
1925
|
+
"description": "Token mint address",
|
|
1926
|
+
"aliases": [
|
|
1927
|
+
"token-address"
|
|
1928
|
+
]
|
|
1929
|
+
},
|
|
1930
|
+
"filters": {
|
|
1931
|
+
"type": "string",
|
|
1932
|
+
"format": "json",
|
|
1933
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1934
|
+
},
|
|
1935
|
+
"smart-money": {
|
|
1936
|
+
"type": "boolean",
|
|
1937
|
+
"description": "Only smart money wallets"
|
|
1255
1938
|
}
|
|
1256
1939
|
}
|
|
1257
1940
|
},
|
|
@@ -1264,18 +1947,42 @@
|
|
|
1264
1947
|
"default": "24h",
|
|
1265
1948
|
"description": "Time window for volume, flow, and price-change metrics"
|
|
1266
1949
|
},
|
|
1267
|
-
"chain": {
|
|
1950
|
+
"chain": {
|
|
1951
|
+
"type": "string",
|
|
1952
|
+
"default": "solana",
|
|
1953
|
+
"description": "Chain the token lives on"
|
|
1954
|
+
},
|
|
1955
|
+
"include-stablecoins": {
|
|
1956
|
+
"description": "Whether to include stablecoins in screener results (default true on API side)",
|
|
1957
|
+
"default": true,
|
|
1958
|
+
"type": "boolean"
|
|
1959
|
+
},
|
|
1960
|
+
"search": {
|
|
1961
|
+
"type": "string",
|
|
1962
|
+
"description": "Filter screener candidates client-side by token name, symbol, or exact address. Only the fetched candidate rows are searched (the first 500 by default, more with --limit/--page, every traversed page with --paginate/--all), so the response adds _meta.search: { query, searched, matched, complete }. complete: false means the API had more rows beyond that window and a missing token may simply rank below it; widen with --limit (max 1000) or --paginate, or narrow with --filters. A stderr note repeats this for --fields/--table/--csv/--stream output. With --paginate/--all, the fully traversed candidate pool is filtered after traversal; pagination metadata describes the upstream candidate-page traversal, not the number of matches after filtering."
|
|
1963
|
+
},
|
|
1964
|
+
"filters": {
|
|
1965
|
+
"type": "string",
|
|
1966
|
+
"format": "json",
|
|
1967
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
1968
|
+
},
|
|
1969
|
+
"sort": {
|
|
1970
|
+
"type": "string",
|
|
1971
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
1972
|
+
},
|
|
1973
|
+
"order-by": {
|
|
1268
1974
|
"type": "string",
|
|
1269
|
-
"
|
|
1270
|
-
"description": "
|
|
1975
|
+
"format": "json",
|
|
1976
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1271
1977
|
},
|
|
1272
|
-
"
|
|
1273
|
-
"
|
|
1274
|
-
"
|
|
1978
|
+
"smart-money": {
|
|
1979
|
+
"type": "boolean",
|
|
1980
|
+
"description": "Only smart money wallets"
|
|
1275
1981
|
},
|
|
1276
|
-
"
|
|
1982
|
+
"chains": {
|
|
1277
1983
|
"type": "string",
|
|
1278
|
-
"description": "
|
|
1984
|
+
"description": "Comma-separated chains; overrides --chain",
|
|
1985
|
+
"repeatable": true
|
|
1279
1986
|
}
|
|
1280
1987
|
}
|
|
1281
1988
|
},
|
|
@@ -1289,14 +1996,19 @@
|
|
|
1289
1996
|
"lowcap",
|
|
1290
1997
|
"midcap",
|
|
1291
1998
|
"largecap"
|
|
1292
|
-
]
|
|
1999
|
+
],
|
|
2000
|
+
"aliases": [
|
|
2001
|
+
"market-cap-group"
|
|
2002
|
+
],
|
|
2003
|
+
"type": "string"
|
|
1293
2004
|
},
|
|
1294
2005
|
"limit": {
|
|
1295
2006
|
"type": "number",
|
|
1296
2007
|
"default": 25,
|
|
1297
2008
|
"description": "Number of tokens to return"
|
|
1298
2009
|
}
|
|
1299
|
-
}
|
|
2010
|
+
},
|
|
2011
|
+
"pagination": false
|
|
1300
2012
|
}
|
|
1301
2013
|
},
|
|
1302
2014
|
"description": "Token God Mode - deep analytics for any token"
|
|
@@ -1308,7 +2020,8 @@
|
|
|
1308
2020
|
"query": {
|
|
1309
2021
|
"type": "string",
|
|
1310
2022
|
"required": true,
|
|
1311
|
-
"description": "Token name, symbol, or address, or an entity name"
|
|
2023
|
+
"description": "Token name, symbol, or address, or an entity name",
|
|
2024
|
+
"positional": true
|
|
1312
2025
|
},
|
|
1313
2026
|
"type": {
|
|
1314
2027
|
"type": "string",
|
|
@@ -1320,8 +2033,13 @@
|
|
|
1320
2033
|
"type": "number",
|
|
1321
2034
|
"default": 25,
|
|
1322
2035
|
"description": "Maximum number of results"
|
|
2036
|
+
},
|
|
2037
|
+
"chain": {
|
|
2038
|
+
"type": "string",
|
|
2039
|
+
"description": "Only results on this chain"
|
|
1323
2040
|
}
|
|
1324
|
-
}
|
|
2041
|
+
},
|
|
2042
|
+
"pagination": false
|
|
1325
2043
|
},
|
|
1326
2044
|
"perp": {
|
|
1327
2045
|
"subcommands": {
|
|
@@ -1343,16 +2061,37 @@
|
|
|
1343
2061
|
"whale",
|
|
1344
2062
|
"public_figure",
|
|
1345
2063
|
"high_winrate_hl_perps_trader"
|
|
1346
|
-
]
|
|
2064
|
+
],
|
|
2065
|
+
"type": "string"
|
|
1347
2066
|
},
|
|
1348
2067
|
"sectors-filter": {
|
|
1349
|
-
"description": "Comma-separated sector:subcategory pairs to filter by, e.g. \"Crypto:AI,TradFi:Stocks\"."
|
|
2068
|
+
"description": "Comma-separated sector:subcategory pairs to filter by, e.g. \"Crypto:AI,TradFi:Stocks\".",
|
|
2069
|
+
"type": "string",
|
|
2070
|
+
"repeatable": true
|
|
1350
2071
|
},
|
|
1351
2072
|
"sm-label-filter": {
|
|
1352
|
-
"description": "Comma-separated Nansen SM labels to filter by, e.g. \"30D Smart Trader\". Only applies when trader-type is all or sm."
|
|
2073
|
+
"description": "Comma-separated Nansen SM labels to filter by, e.g. \"30D Smart Trader\". Only applies when trader-type is all or sm.",
|
|
2074
|
+
"type": "string",
|
|
2075
|
+
"repeatable": true
|
|
1353
2076
|
},
|
|
1354
2077
|
"trader-label-filter": {
|
|
1355
|
-
"description": "Comma-separated HL perps trader labels to filter by, e.g. \"HL Perps Whale\". Only applies when trader-type is all or sm."
|
|
2078
|
+
"description": "Comma-separated HL perps trader labels to filter by, e.g. \"HL Perps Whale\". Only applies when trader-type is all or sm.",
|
|
2079
|
+
"type": "string",
|
|
2080
|
+
"repeatable": true
|
|
2081
|
+
},
|
|
2082
|
+
"filters": {
|
|
2083
|
+
"type": "string",
|
|
2084
|
+
"format": "json",
|
|
2085
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2086
|
+
},
|
|
2087
|
+
"sort": {
|
|
2088
|
+
"type": "string",
|
|
2089
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2090
|
+
},
|
|
2091
|
+
"order-by": {
|
|
2092
|
+
"type": "string",
|
|
2093
|
+
"format": "json",
|
|
2094
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1356
2095
|
}
|
|
1357
2096
|
}
|
|
1358
2097
|
},
|
|
@@ -1369,6 +2108,20 @@
|
|
|
1369
2108
|
"premium-labels": {
|
|
1370
2109
|
"description": "Include premium Nansen labels in the response (true=premium, false=free-tier). When omitted, uses API default.",
|
|
1371
2110
|
"type": "boolean"
|
|
2111
|
+
},
|
|
2112
|
+
"filters": {
|
|
2113
|
+
"type": "string",
|
|
2114
|
+
"format": "json",
|
|
2115
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2116
|
+
},
|
|
2117
|
+
"sort": {
|
|
2118
|
+
"type": "string",
|
|
2119
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2120
|
+
},
|
|
2121
|
+
"order-by": {
|
|
2122
|
+
"type": "string",
|
|
2123
|
+
"format": "json",
|
|
2124
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1372
2125
|
}
|
|
1373
2126
|
}
|
|
1374
2127
|
}
|
|
@@ -1385,6 +2138,15 @@
|
|
|
1385
2138
|
"type": "string",
|
|
1386
2139
|
"required": true,
|
|
1387
2140
|
"description": "Polymarket market ID (numeric, from the screener)"
|
|
2141
|
+
},
|
|
2142
|
+
"sort": {
|
|
2143
|
+
"type": "string",
|
|
2144
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2145
|
+
},
|
|
2146
|
+
"order-by": {
|
|
2147
|
+
"type": "string",
|
|
2148
|
+
"format": "json",
|
|
2149
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1388
2150
|
}
|
|
1389
2151
|
}
|
|
1390
2152
|
},
|
|
@@ -1407,6 +2169,15 @@
|
|
|
1407
2169
|
"type": "string",
|
|
1408
2170
|
"required": true,
|
|
1409
2171
|
"description": "Polymarket market ID (numeric, from the screener)"
|
|
2172
|
+
},
|
|
2173
|
+
"sort": {
|
|
2174
|
+
"type": "string",
|
|
2175
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2176
|
+
},
|
|
2177
|
+
"order-by": {
|
|
2178
|
+
"type": "string",
|
|
2179
|
+
"format": "json",
|
|
2180
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1410
2181
|
}
|
|
1411
2182
|
}
|
|
1412
2183
|
},
|
|
@@ -1418,6 +2189,15 @@
|
|
|
1418
2189
|
"type": "string",
|
|
1419
2190
|
"required": true,
|
|
1420
2191
|
"description": "Polymarket market ID (numeric, from the screener)"
|
|
2192
|
+
},
|
|
2193
|
+
"sort": {
|
|
2194
|
+
"type": "string",
|
|
2195
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2196
|
+
},
|
|
2197
|
+
"order-by": {
|
|
2198
|
+
"type": "string",
|
|
2199
|
+
"format": "json",
|
|
2200
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1421
2201
|
}
|
|
1422
2202
|
}
|
|
1423
2203
|
},
|
|
@@ -1431,11 +2211,13 @@
|
|
|
1431
2211
|
"description": "Text filter on market titles"
|
|
1432
2212
|
},
|
|
1433
2213
|
"sort-by": {
|
|
1434
|
-
"description": "Deprecated: use --sort field:dir instead"
|
|
2214
|
+
"description": "Deprecated: use --sort field:dir instead",
|
|
2215
|
+
"type": "string"
|
|
1435
2216
|
},
|
|
1436
2217
|
"tags": {
|
|
1437
2218
|
"type": "string",
|
|
1438
|
-
"description": "Comma-separated Polymarket tags to filter by"
|
|
2219
|
+
"description": "Comma-separated Polymarket tags to filter by",
|
|
2220
|
+
"repeatable": true
|
|
1439
2221
|
},
|
|
1440
2222
|
"min-liquidity": {
|
|
1441
2223
|
"type": "number",
|
|
@@ -1445,10 +2227,6 @@
|
|
|
1445
2227
|
"type": "number",
|
|
1446
2228
|
"description": "Maximum liquidity in USD"
|
|
1447
2229
|
},
|
|
1448
|
-
"min-unique-traders-24h": {
|
|
1449
|
-
"type": "number",
|
|
1450
|
-
"description": "Minimum unique traders in the last 24 hours"
|
|
1451
|
-
},
|
|
1452
2230
|
"max-unique-traders-24h": {
|
|
1453
2231
|
"type": "number",
|
|
1454
2232
|
"description": "Maximum unique traders in the last 24 hours"
|
|
@@ -1457,10 +2235,6 @@
|
|
|
1457
2235
|
"type": "number",
|
|
1458
2236
|
"description": "Minimum 24-hour volume in USD"
|
|
1459
2237
|
},
|
|
1460
|
-
"max-volume-24hr": {
|
|
1461
|
-
"type": "number",
|
|
1462
|
-
"description": "Maximum 24-hour volume in USD"
|
|
1463
|
-
},
|
|
1464
2238
|
"neg-risk": {
|
|
1465
2239
|
"type": "boolean",
|
|
1466
2240
|
"enum": ["true", "false"],
|
|
@@ -1489,6 +2263,19 @@
|
|
|
1489
2263
|
"max-price": {
|
|
1490
2264
|
"type": "number",
|
|
1491
2265
|
"description": "Maximum outcome price (0-1)"
|
|
2266
|
+
},
|
|
2267
|
+
"sort": {
|
|
2268
|
+
"type": "string",
|
|
2269
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2270
|
+
},
|
|
2271
|
+
"order-by": {
|
|
2272
|
+
"type": "string",
|
|
2273
|
+
"format": "json",
|
|
2274
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
2275
|
+
},
|
|
2276
|
+
"status": {
|
|
2277
|
+
"type": "string",
|
|
2278
|
+
"description": "Market status filter, e.g. active or closed"
|
|
1492
2279
|
}
|
|
1493
2280
|
}
|
|
1494
2281
|
},
|
|
@@ -1502,11 +2289,13 @@
|
|
|
1502
2289
|
"description": "Text filter on event titles"
|
|
1503
2290
|
},
|
|
1504
2291
|
"sort-by": {
|
|
1505
|
-
"description": "Deprecated: use --sort field:dir instead"
|
|
2292
|
+
"description": "Deprecated: use --sort field:dir instead",
|
|
2293
|
+
"type": "string"
|
|
1506
2294
|
},
|
|
1507
2295
|
"tags": {
|
|
1508
2296
|
"type": "string",
|
|
1509
|
-
"description": "Comma-separated Polymarket tags to filter by"
|
|
2297
|
+
"description": "Comma-separated Polymarket tags to filter by",
|
|
2298
|
+
"repeatable": true
|
|
1510
2299
|
},
|
|
1511
2300
|
"min-liquidity": {
|
|
1512
2301
|
"type": "number",
|
|
@@ -1516,10 +2305,6 @@
|
|
|
1516
2305
|
"type": "number",
|
|
1517
2306
|
"description": "Maximum liquidity in USD"
|
|
1518
2307
|
},
|
|
1519
|
-
"min-unique-traders-24h": {
|
|
1520
|
-
"type": "number",
|
|
1521
|
-
"description": "Minimum unique traders in the last 24 hours"
|
|
1522
|
-
},
|
|
1523
2308
|
"max-unique-traders-24h": {
|
|
1524
2309
|
"type": "number",
|
|
1525
2310
|
"description": "Maximum unique traders in the last 24 hours"
|
|
@@ -1528,10 +2313,6 @@
|
|
|
1528
2313
|
"type": "number",
|
|
1529
2314
|
"description": "Minimum 24-hour volume in USD"
|
|
1530
2315
|
},
|
|
1531
|
-
"max-volume-24hr": {
|
|
1532
|
-
"type": "number",
|
|
1533
|
-
"description": "Maximum 24-hour volume in USD"
|
|
1534
|
-
},
|
|
1535
2316
|
"neg-risk": {
|
|
1536
2317
|
"type": "boolean",
|
|
1537
2318
|
"enum": ["true", "false"],
|
|
@@ -1552,6 +2333,19 @@
|
|
|
1552
2333
|
"end-date-after": {
|
|
1553
2334
|
"type": "string",
|
|
1554
2335
|
"description": "Only events ending after this date (ISO 8601)"
|
|
2336
|
+
},
|
|
2337
|
+
"sort": {
|
|
2338
|
+
"type": "string",
|
|
2339
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2340
|
+
},
|
|
2341
|
+
"order-by": {
|
|
2342
|
+
"type": "string",
|
|
2343
|
+
"format": "json",
|
|
2344
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
2345
|
+
},
|
|
2346
|
+
"status": {
|
|
2347
|
+
"type": "string",
|
|
2348
|
+
"description": "Market status filter, e.g. active or closed"
|
|
1555
2349
|
}
|
|
1556
2350
|
}
|
|
1557
2351
|
},
|
|
@@ -1563,6 +2357,15 @@
|
|
|
1563
2357
|
"type": "string",
|
|
1564
2358
|
"required": true,
|
|
1565
2359
|
"description": "Polymarket market ID (numeric, from the screener)"
|
|
2360
|
+
},
|
|
2361
|
+
"sort": {
|
|
2362
|
+
"type": "string",
|
|
2363
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2364
|
+
},
|
|
2365
|
+
"order-by": {
|
|
2366
|
+
"type": "string",
|
|
2367
|
+
"format": "json",
|
|
2368
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1566
2369
|
}
|
|
1567
2370
|
}
|
|
1568
2371
|
},
|
|
@@ -1574,6 +2377,15 @@
|
|
|
1574
2377
|
"type": "string",
|
|
1575
2378
|
"required": true,
|
|
1576
2379
|
"description": "Polymarket trader address"
|
|
2380
|
+
},
|
|
2381
|
+
"sort": {
|
|
2382
|
+
"type": "string",
|
|
2383
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2384
|
+
},
|
|
2385
|
+
"order-by": {
|
|
2386
|
+
"type": "string",
|
|
2387
|
+
"format": "json",
|
|
2388
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1577
2389
|
}
|
|
1578
2390
|
}
|
|
1579
2391
|
},
|
|
@@ -1596,6 +2408,15 @@
|
|
|
1596
2408
|
"type": "string",
|
|
1597
2409
|
"required": true,
|
|
1598
2410
|
"description": "Polymarket trader address"
|
|
2411
|
+
},
|
|
2412
|
+
"sort": {
|
|
2413
|
+
"type": "string",
|
|
2414
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2415
|
+
},
|
|
2416
|
+
"order-by": {
|
|
2417
|
+
"type": "string",
|
|
2418
|
+
"format": "json",
|
|
2419
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1599
2420
|
}
|
|
1600
2421
|
}
|
|
1601
2422
|
},
|
|
@@ -1617,14 +2438,6 @@
|
|
|
1617
2438
|
},
|
|
1618
2439
|
"description": "Polymarket prediction market analytics"
|
|
1619
2440
|
},
|
|
1620
|
-
"points": {
|
|
1621
|
-
"description": "Nansen Points analytics",
|
|
1622
|
-
"subcommands": {
|
|
1623
|
-
"leaderboard": {
|
|
1624
|
-
"description": "Points leaderboard (unavailable)"
|
|
1625
|
-
}
|
|
1626
|
-
}
|
|
1627
|
-
},
|
|
1628
2441
|
"chain-rank": {
|
|
1629
2442
|
"endpoint": "/api/v1/chains/chain-rank",
|
|
1630
2443
|
"description": "Rank chains by growth metrics",
|
|
@@ -1641,11 +2454,13 @@
|
|
|
1641
2454
|
"default": "all",
|
|
1642
2455
|
"description": "Include all chains or only EVM chains"
|
|
1643
2456
|
}
|
|
1644
|
-
}
|
|
2457
|
+
},
|
|
2458
|
+
"pagination": false
|
|
1645
2459
|
},
|
|
1646
2460
|
"token-sectors": {
|
|
1647
2461
|
"endpoint": "/api/v1/search/token-sectors",
|
|
1648
|
-
"description": "List token sectors available for filtering"
|
|
2462
|
+
"description": "List token sectors available for filtering",
|
|
2463
|
+
"pagination": false
|
|
1649
2464
|
},
|
|
1650
2465
|
"address-premium-labels": {
|
|
1651
2466
|
"endpoint": "/api/v1/profiler/address/premium-labels",
|
|
@@ -1679,7 +2494,9 @@
|
|
|
1679
2494
|
"options": {
|
|
1680
2495
|
"chains": {
|
|
1681
2496
|
"default": "solana",
|
|
1682
|
-
"description": "Comma-separated chains"
|
|
2497
|
+
"description": "Comma-separated chains",
|
|
2498
|
+
"type": "string",
|
|
2499
|
+
"repeatable": true
|
|
1683
2500
|
},
|
|
1684
2501
|
"timeframe-days": {
|
|
1685
2502
|
"type": "number",
|
|
@@ -1689,7 +2506,8 @@
|
|
|
1689
2506
|
},
|
|
1690
2507
|
"filters": {
|
|
1691
2508
|
"type": "string",
|
|
1692
|
-
"description": "Filters as JSON object"
|
|
2509
|
+
"description": "Filters as JSON object",
|
|
2510
|
+
"format": "json"
|
|
1693
2511
|
},
|
|
1694
2512
|
"sort": {
|
|
1695
2513
|
"type": "string",
|
|
@@ -1703,6 +2521,15 @@
|
|
|
1703
2521
|
"limit": {
|
|
1704
2522
|
"type": "number",
|
|
1705
2523
|
"description": "Max results per page; maps to pagination.per_page"
|
|
2524
|
+
},
|
|
2525
|
+
"order-by": {
|
|
2526
|
+
"type": "string",
|
|
2527
|
+
"format": "json",
|
|
2528
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
2529
|
+
},
|
|
2530
|
+
"chain": {
|
|
2531
|
+
"type": "string",
|
|
2532
|
+
"description": "Single chain; --chains takes precedence"
|
|
1706
2533
|
}
|
|
1707
2534
|
}
|
|
1708
2535
|
},
|
|
@@ -1712,9 +2539,15 @@
|
|
|
1712
2539
|
"options": {
|
|
1713
2540
|
"symbol": {
|
|
1714
2541
|
"required": true,
|
|
1715
|
-
"description": "Hyperliquid asset symbol (--token-address is accepted as an alias)"
|
|
2542
|
+
"description": "Hyperliquid asset symbol (--token-address is accepted as an alias)",
|
|
2543
|
+
"type": "string",
|
|
2544
|
+
"aliases": [
|
|
2545
|
+
"token-address",
|
|
2546
|
+
"token"
|
|
2547
|
+
]
|
|
1716
2548
|
}
|
|
1717
|
-
}
|
|
2549
|
+
},
|
|
2550
|
+
"pagination": false
|
|
1718
2551
|
},
|
|
1719
2552
|
"perp-pnl-summary": {
|
|
1720
2553
|
"endpoint": "/api/v1/profiler/perp-pnl-summary",
|
|
@@ -1727,13 +2560,18 @@
|
|
|
1727
2560
|
},
|
|
1728
2561
|
"from-date": {
|
|
1729
2562
|
"required": true,
|
|
1730
|
-
"description": "Start of date range"
|
|
2563
|
+
"description": "Start of date range",
|
|
2564
|
+
"type": "string",
|
|
2565
|
+
"format": "date-time"
|
|
1731
2566
|
},
|
|
1732
2567
|
"to-date": {
|
|
1733
2568
|
"required": true,
|
|
1734
|
-
"description": "End of date range"
|
|
2569
|
+
"description": "End of date range",
|
|
2570
|
+
"type": "string",
|
|
2571
|
+
"format": "date-time"
|
|
1735
2572
|
}
|
|
1736
|
-
}
|
|
2573
|
+
},
|
|
2574
|
+
"pagination": false
|
|
1737
2575
|
},
|
|
1738
2576
|
"historical-token-ohlcv": {
|
|
1739
2577
|
"endpoint": "/api/v1beta1/tgm/historical-token-ohlcv",
|
|
@@ -1741,35 +2579,50 @@
|
|
|
1741
2579
|
"options": {
|
|
1742
2580
|
"token-address": {
|
|
1743
2581
|
"required": true,
|
|
1744
|
-
"description": "Token address or Hyperliquid asset symbol"
|
|
2582
|
+
"description": "Token address or Hyperliquid asset symbol",
|
|
2583
|
+
"type": "string",
|
|
2584
|
+
"aliases": [
|
|
2585
|
+
"token"
|
|
2586
|
+
]
|
|
1745
2587
|
},
|
|
1746
2588
|
"chain": {
|
|
1747
2589
|
"type": "string",
|
|
1748
|
-
"enum": ["base", "bnb", "ethereum", "hyperliquid", "solana"],
|
|
1749
2590
|
"default": "solana",
|
|
1750
2591
|
"description": "Chain the token lives on"
|
|
1751
2592
|
},
|
|
1752
2593
|
"from-date": {
|
|
1753
2594
|
"required": true,
|
|
1754
|
-
"description": "Start of data window"
|
|
2595
|
+
"description": "Start of data window",
|
|
2596
|
+
"type": "string"
|
|
1755
2597
|
},
|
|
1756
2598
|
"as-of-date": {
|
|
1757
|
-
"description": "End of data window; exactly one of --as-of-date or --as-of-ts is required"
|
|
2599
|
+
"description": "End of data window; exactly one of --as-of-date or --as-of-ts is required",
|
|
2600
|
+
"type": "string"
|
|
1758
2601
|
},
|
|
1759
2602
|
"as-of-ts": {
|
|
1760
|
-
"description": "Exact Hyperliquid cutoff timestamp; exactly one of --as-of-date or --as-of-ts is required"
|
|
2603
|
+
"description": "Exact Hyperliquid cutoff timestamp; exactly one of --as-of-date or --as-of-ts is required",
|
|
2604
|
+
"type": "string"
|
|
1761
2605
|
},
|
|
1762
2606
|
"timeframe": {
|
|
1763
2607
|
"type": "string",
|
|
1764
2608
|
"required": true,
|
|
1765
|
-
"enum": [
|
|
2609
|
+
"enum": [
|
|
2610
|
+
"5m",
|
|
2611
|
+
"15m",
|
|
2612
|
+
"30m",
|
|
2613
|
+
"1h",
|
|
2614
|
+
"4h",
|
|
2615
|
+
"1d",
|
|
2616
|
+
"1w"
|
|
2617
|
+
],
|
|
1766
2618
|
"description": "Candle interval"
|
|
1767
2619
|
},
|
|
1768
2620
|
"apply-blacklist-filter": {
|
|
1769
2621
|
"type": "boolean",
|
|
1770
2622
|
"description": "Apply blacklist filtering for 1d/1w non-Hyperliquid requests"
|
|
1771
2623
|
}
|
|
1772
|
-
}
|
|
2624
|
+
},
|
|
2625
|
+
"pagination": false
|
|
1773
2626
|
},
|
|
1774
2627
|
"transaction-with-token-transfer-lookup": {
|
|
1775
2628
|
"endpoint": "/api/v1/transaction-with-token-transfer-lookup",
|
|
@@ -1782,14 +2635,15 @@
|
|
|
1782
2635
|
},
|
|
1783
2636
|
"chain": {
|
|
1784
2637
|
"type": "string",
|
|
1785
|
-
"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"],
|
|
1786
2638
|
"default": "ethereum",
|
|
1787
2639
|
"description": "Chain the transaction was made on"
|
|
1788
2640
|
},
|
|
1789
2641
|
"block-timestamp": {
|
|
1790
|
-
"description": "Block timestamp (required for bitcoin, tron, ton, starknet, and sui)"
|
|
2642
|
+
"description": "Block timestamp (required for bitcoin, tron, ton, starknet, and sui)",
|
|
2643
|
+
"type": "string"
|
|
1791
2644
|
}
|
|
1792
|
-
}
|
|
2645
|
+
},
|
|
2646
|
+
"pagination": false
|
|
1793
2647
|
},
|
|
1794
2648
|
"historical-dex-trades": {
|
|
1795
2649
|
"endpoint": "/api/v1/tgm/historical-dex-trades",
|
|
@@ -1797,19 +2651,42 @@
|
|
|
1797
2651
|
"options": {
|
|
1798
2652
|
"token-address": {
|
|
1799
2653
|
"required": true,
|
|
1800
|
-
"description": "Token address"
|
|
2654
|
+
"description": "Token address",
|
|
2655
|
+
"type": "string",
|
|
2656
|
+
"aliases": [
|
|
2657
|
+
"token"
|
|
2658
|
+
]
|
|
1801
2659
|
},
|
|
1802
2660
|
"from-date": {
|
|
1803
2661
|
"required": true,
|
|
1804
|
-
"description": "Start of date range (YYYY-MM-DD)"
|
|
2662
|
+
"description": "Start of date range (YYYY-MM-DD)",
|
|
2663
|
+
"type": "string",
|
|
2664
|
+
"format": "date-time"
|
|
1805
2665
|
},
|
|
1806
2666
|
"to-date": {
|
|
1807
2667
|
"required": true,
|
|
1808
|
-
"description": "End of date range (YYYY-MM-DD)"
|
|
2668
|
+
"description": "End of date range (YYYY-MM-DD)",
|
|
2669
|
+
"type": "string",
|
|
2670
|
+
"format": "date-time"
|
|
1809
2671
|
},
|
|
1810
2672
|
"chain": {
|
|
1811
2673
|
"default": "solana",
|
|
1812
|
-
"description": "Chain"
|
|
2674
|
+
"description": "Chain",
|
|
2675
|
+
"type": "string"
|
|
2676
|
+
},
|
|
2677
|
+
"filters": {
|
|
2678
|
+
"type": "string",
|
|
2679
|
+
"format": "json",
|
|
2680
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2681
|
+
},
|
|
2682
|
+
"sort": {
|
|
2683
|
+
"type": "string",
|
|
2684
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2685
|
+
},
|
|
2686
|
+
"order-by": {
|
|
2687
|
+
"type": "string",
|
|
2688
|
+
"format": "json",
|
|
2689
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1813
2690
|
}
|
|
1814
2691
|
}
|
|
1815
2692
|
},
|
|
@@ -1819,43 +2696,76 @@
|
|
|
1819
2696
|
"options": {
|
|
1820
2697
|
"token-address": {
|
|
1821
2698
|
"required": true,
|
|
1822
|
-
"description": "Token address"
|
|
2699
|
+
"description": "Token address",
|
|
2700
|
+
"type": "string",
|
|
2701
|
+
"aliases": [
|
|
2702
|
+
"token"
|
|
2703
|
+
]
|
|
1823
2704
|
},
|
|
1824
2705
|
"from-date": {
|
|
1825
2706
|
"required": true,
|
|
1826
|
-
"description": "Start of date range (YYYY-MM-DD)"
|
|
2707
|
+
"description": "Start of date range (YYYY-MM-DD)",
|
|
2708
|
+
"type": "string",
|
|
2709
|
+
"format": "date-time"
|
|
1827
2710
|
},
|
|
1828
2711
|
"to-date": {
|
|
1829
2712
|
"required": true,
|
|
1830
|
-
"description": "End of date range (YYYY-MM-DD)"
|
|
2713
|
+
"description": "End of date range (YYYY-MM-DD)",
|
|
2714
|
+
"type": "string",
|
|
2715
|
+
"format": "date-time"
|
|
1831
2716
|
},
|
|
1832
2717
|
"chain": {
|
|
1833
2718
|
"default": "solana",
|
|
1834
|
-
"description": "Chain"
|
|
2719
|
+
"description": "Chain",
|
|
2720
|
+
"type": "string"
|
|
2721
|
+
},
|
|
2722
|
+
"filters": {
|
|
2723
|
+
"type": "string",
|
|
2724
|
+
"format": "json",
|
|
2725
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2726
|
+
},
|
|
2727
|
+
"sort": {
|
|
2728
|
+
"type": "string",
|
|
2729
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2730
|
+
},
|
|
2731
|
+
"order-by": {
|
|
2732
|
+
"type": "string",
|
|
2733
|
+
"format": "json",
|
|
2734
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1835
2735
|
}
|
|
1836
2736
|
}
|
|
1837
2737
|
},
|
|
1838
2738
|
"historical-token-flow-summary": {
|
|
1839
2739
|
"endpoint": "/api/v1/tgm/historical-token-flow-summary",
|
|
1840
|
-
"description": "Historical token flow summary (no pagination)",
|
|
2740
|
+
"description": "Historical token flow summary (no pagination; whale, public figure, top PnL and exchange segments start 2025-03-11)",
|
|
1841
2741
|
"options": {
|
|
1842
2742
|
"token-address": {
|
|
1843
2743
|
"required": true,
|
|
1844
|
-
"description": "Token address"
|
|
2744
|
+
"description": "Token address",
|
|
2745
|
+
"type": "string",
|
|
2746
|
+
"aliases": [
|
|
2747
|
+
"token"
|
|
2748
|
+
]
|
|
1845
2749
|
},
|
|
1846
2750
|
"from-date": {
|
|
1847
2751
|
"required": true,
|
|
1848
|
-
"description": "Start of date range (YYYY-MM-DD)"
|
|
2752
|
+
"description": "Start of date range (YYYY-MM-DD)",
|
|
2753
|
+
"type": "string",
|
|
2754
|
+
"format": "date-time"
|
|
1849
2755
|
},
|
|
1850
2756
|
"to-date": {
|
|
1851
2757
|
"required": true,
|
|
1852
|
-
"description": "End of date range (YYYY-MM-DD)"
|
|
2758
|
+
"description": "End of date range (YYYY-MM-DD). Whale, public figure, top PnL and exchange label history starts 2025-03-11, so those fields are null for an earlier date",
|
|
2759
|
+
"type": "string",
|
|
2760
|
+
"format": "date-time"
|
|
1853
2761
|
},
|
|
1854
2762
|
"chain": {
|
|
1855
2763
|
"default": "solana",
|
|
1856
|
-
"description": "Chain"
|
|
2764
|
+
"description": "Chain",
|
|
2765
|
+
"type": "string"
|
|
1857
2766
|
}
|
|
1858
|
-
}
|
|
2767
|
+
},
|
|
2768
|
+
"pagination": false
|
|
1859
2769
|
},
|
|
1860
2770
|
"historical-token-quant-scores": {
|
|
1861
2771
|
"endpoint": "/api/v1/tgm/historical-token-quant-scores",
|
|
@@ -1863,17 +2773,25 @@
|
|
|
1863
2773
|
"options": {
|
|
1864
2774
|
"token-address": {
|
|
1865
2775
|
"required": true,
|
|
1866
|
-
"description": "Token address"
|
|
2776
|
+
"description": "Token address",
|
|
2777
|
+
"type": "string",
|
|
2778
|
+
"aliases": [
|
|
2779
|
+
"token"
|
|
2780
|
+
]
|
|
1867
2781
|
},
|
|
1868
2782
|
"as-of-date": {
|
|
1869
2783
|
"required": true,
|
|
1870
|
-
"description": "Snapshot date (YYYY-MM-DD)"
|
|
2784
|
+
"description": "Snapshot date (YYYY-MM-DD)",
|
|
2785
|
+
"type": "string",
|
|
2786
|
+
"format": "date"
|
|
1871
2787
|
},
|
|
1872
2788
|
"chain": {
|
|
1873
2789
|
"default": "solana",
|
|
1874
|
-
"description": "Chain"
|
|
2790
|
+
"description": "Chain",
|
|
2791
|
+
"type": "string"
|
|
1875
2792
|
}
|
|
1876
|
-
}
|
|
2793
|
+
},
|
|
2794
|
+
"pagination": false
|
|
1877
2795
|
},
|
|
1878
2796
|
"historical-top-holders": {
|
|
1879
2797
|
"endpoint": "/api/v1/tgm/historical-top-holders",
|
|
@@ -1881,15 +2799,36 @@
|
|
|
1881
2799
|
"options": {
|
|
1882
2800
|
"token-address": {
|
|
1883
2801
|
"required": true,
|
|
1884
|
-
"description": "Token address"
|
|
2802
|
+
"description": "Token address",
|
|
2803
|
+
"type": "string",
|
|
2804
|
+
"aliases": [
|
|
2805
|
+
"token"
|
|
2806
|
+
]
|
|
1885
2807
|
},
|
|
1886
2808
|
"as-of-date": {
|
|
1887
2809
|
"required": true,
|
|
1888
|
-
"description": "Snapshot date (YYYY-MM-DD)"
|
|
2810
|
+
"description": "Snapshot date (YYYY-MM-DD)",
|
|
2811
|
+
"type": "string",
|
|
2812
|
+
"format": "date"
|
|
1889
2813
|
},
|
|
1890
2814
|
"chain": {
|
|
1891
2815
|
"default": "solana",
|
|
1892
|
-
"description": "Chain"
|
|
2816
|
+
"description": "Chain",
|
|
2817
|
+
"type": "string"
|
|
2818
|
+
},
|
|
2819
|
+
"filters": {
|
|
2820
|
+
"type": "string",
|
|
2821
|
+
"format": "json",
|
|
2822
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2823
|
+
},
|
|
2824
|
+
"sort": {
|
|
2825
|
+
"type": "string",
|
|
2826
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2827
|
+
},
|
|
2828
|
+
"order-by": {
|
|
2829
|
+
"type": "string",
|
|
2830
|
+
"format": "json",
|
|
2831
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1893
2832
|
}
|
|
1894
2833
|
}
|
|
1895
2834
|
},
|
|
@@ -1899,23 +2838,47 @@
|
|
|
1899
2838
|
"options": {
|
|
1900
2839
|
"token-address": {
|
|
1901
2840
|
"required": true,
|
|
1902
|
-
"description": "Token address"
|
|
2841
|
+
"description": "Token address",
|
|
2842
|
+
"type": "string",
|
|
2843
|
+
"aliases": [
|
|
2844
|
+
"token"
|
|
2845
|
+
]
|
|
1903
2846
|
},
|
|
1904
2847
|
"from-date": {
|
|
1905
2848
|
"required": true,
|
|
1906
|
-
"description": "Start of date range (YYYY-MM-DD)"
|
|
2849
|
+
"description": "Start of date range (YYYY-MM-DD)",
|
|
2850
|
+
"type": "string",
|
|
2851
|
+
"format": "date-time"
|
|
1907
2852
|
},
|
|
1908
2853
|
"to-date": {
|
|
1909
2854
|
"required": true,
|
|
1910
|
-
"description": "End of date range (YYYY-MM-DD)"
|
|
2855
|
+
"description": "End of date range (YYYY-MM-DD)",
|
|
2856
|
+
"type": "string",
|
|
2857
|
+
"format": "date-time"
|
|
1911
2858
|
},
|
|
1912
2859
|
"buy-or-sell": {
|
|
1913
2860
|
"default": "BUY",
|
|
1914
|
-
"description": "BUY or SELL"
|
|
2861
|
+
"description": "BUY or SELL",
|
|
2862
|
+
"type": "string"
|
|
1915
2863
|
},
|
|
1916
2864
|
"chain": {
|
|
1917
2865
|
"default": "solana",
|
|
1918
|
-
"description": "Chain"
|
|
2866
|
+
"description": "Chain",
|
|
2867
|
+
"type": "string"
|
|
2868
|
+
},
|
|
2869
|
+
"filters": {
|
|
2870
|
+
"type": "string",
|
|
2871
|
+
"format": "json",
|
|
2872
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2873
|
+
},
|
|
2874
|
+
"sort": {
|
|
2875
|
+
"type": "string",
|
|
2876
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2877
|
+
},
|
|
2878
|
+
"order-by": {
|
|
2879
|
+
"type": "string",
|
|
2880
|
+
"format": "json",
|
|
2881
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
1919
2882
|
}
|
|
1920
2883
|
}
|
|
1921
2884
|
},
|
|
@@ -1925,11 +2888,24 @@
|
|
|
1925
2888
|
"options": {
|
|
1926
2889
|
"as-of-date": {
|
|
1927
2890
|
"required": true,
|
|
1928
|
-
"description": "Snapshot date (YYYY-MM-DD)"
|
|
2891
|
+
"description": "Snapshot date (YYYY-MM-DD)",
|
|
2892
|
+
"type": "string",
|
|
2893
|
+
"format": "date"
|
|
1929
2894
|
},
|
|
1930
2895
|
"chains": {
|
|
1931
2896
|
"default": "solana",
|
|
1932
|
-
"description": "Comma-separated chains"
|
|
2897
|
+
"description": "Comma-separated chains",
|
|
2898
|
+
"type": "string",
|
|
2899
|
+
"repeatable": true
|
|
2900
|
+
},
|
|
2901
|
+
"filters": {
|
|
2902
|
+
"type": "string",
|
|
2903
|
+
"format": "json",
|
|
2904
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2905
|
+
},
|
|
2906
|
+
"chain": {
|
|
2907
|
+
"type": "string",
|
|
2908
|
+
"description": "Single chain; --chains takes precedence"
|
|
1933
2909
|
}
|
|
1934
2910
|
}
|
|
1935
2911
|
},
|
|
@@ -1944,11 +2920,33 @@
|
|
|
1944
2920
|
},
|
|
1945
2921
|
"to-date": {
|
|
1946
2922
|
"required": true,
|
|
1947
|
-
"description": "End date for the window (YYYY-MM-DD)"
|
|
2923
|
+
"description": "End date for the window (YYYY-MM-DD)",
|
|
2924
|
+
"type": "string",
|
|
2925
|
+
"format": "date"
|
|
1948
2926
|
},
|
|
1949
2927
|
"chains": {
|
|
1950
2928
|
"default": "solana",
|
|
1951
|
-
"description": "Comma-separated chains"
|
|
2929
|
+
"description": "Comma-separated chains",
|
|
2930
|
+
"type": "string",
|
|
2931
|
+
"repeatable": true
|
|
2932
|
+
},
|
|
2933
|
+
"filters": {
|
|
2934
|
+
"type": "string",
|
|
2935
|
+
"format": "json",
|
|
2936
|
+
"description": "Filters as a JSON object, sent as the request filters. EVM addresses (0x + 40 hex) are lowercased."
|
|
2937
|
+
},
|
|
2938
|
+
"sort": {
|
|
2939
|
+
"type": "string",
|
|
2940
|
+
"description": "Sort as field or field:asc|desc, sent as order_by"
|
|
2941
|
+
},
|
|
2942
|
+
"order-by": {
|
|
2943
|
+
"type": "string",
|
|
2944
|
+
"format": "json",
|
|
2945
|
+
"description": "Full order_by JSON array, e.g. [{\"field\":\"value_usd\",\"direction\":\"DESC\"}]; overrides --sort"
|
|
2946
|
+
},
|
|
2947
|
+
"chain": {
|
|
2948
|
+
"type": "string",
|
|
2949
|
+
"description": "Single chain; --chains takes precedence"
|
|
1952
2950
|
}
|
|
1953
2951
|
}
|
|
1954
2952
|
},
|
|
@@ -1958,38 +2956,48 @@
|
|
|
1958
2956
|
"options": {
|
|
1959
2957
|
"address": {
|
|
1960
2958
|
"required": true,
|
|
1961
|
-
"description": "Wallet address"
|
|
2959
|
+
"description": "Wallet address",
|
|
2960
|
+
"type": "string"
|
|
1962
2961
|
},
|
|
1963
2962
|
"as-of-date": {
|
|
1964
2963
|
"required": true,
|
|
1965
|
-
"description": "Snapshot date (YYYY-MM-DD)"
|
|
2964
|
+
"description": "Snapshot date (YYYY-MM-DD)",
|
|
2965
|
+
"type": "string",
|
|
2966
|
+
"format": "date"
|
|
1966
2967
|
},
|
|
1967
2968
|
"chain": {
|
|
1968
2969
|
"default": "ethereum",
|
|
1969
|
-
"description": "Chain"
|
|
2970
|
+
"description": "Chain",
|
|
2971
|
+
"type": "string"
|
|
1970
2972
|
}
|
|
1971
2973
|
}
|
|
1972
2974
|
},
|
|
1973
2975
|
"historical-tx-lookup": {
|
|
1974
2976
|
"endpoint": "/api/v1/profiler/historical-transaction-lookup",
|
|
1975
|
-
"description": "Lookup a historical transaction by hash",
|
|
2977
|
+
"description": "Lookup a historical transaction by hash (entity labels start 2025-03-11)",
|
|
1976
2978
|
"options": {
|
|
1977
2979
|
"transaction-hash": {
|
|
1978
2980
|
"required": true,
|
|
1979
|
-
"description": "Transaction hash (0x-prefixed, 66 chars)"
|
|
2981
|
+
"description": "Transaction hash (0x-prefixed, 66 chars)",
|
|
2982
|
+
"type": "string"
|
|
1980
2983
|
},
|
|
1981
2984
|
"as-of-date": {
|
|
1982
2985
|
"required": true,
|
|
1983
|
-
"description": "Reference date for label and pricing resolution (YYYY-MM-DD)"
|
|
2986
|
+
"description": "Reference date for label and pricing resolution (YYYY-MM-DD). Entity labels are available from 2025-03-11 onward",
|
|
2987
|
+
"type": "string",
|
|
2988
|
+
"format": "date"
|
|
1984
2989
|
},
|
|
1985
2990
|
"block-timestamp": {
|
|
1986
|
-
"description": "Block timestamp (YYYY-MM-DD HH:MM:SS) — skips slow hash-resolution step if provided"
|
|
2991
|
+
"description": "Block timestamp (YYYY-MM-DD HH:MM:SS) — skips slow hash-resolution step if provided",
|
|
2992
|
+
"type": "string"
|
|
1987
2993
|
},
|
|
1988
2994
|
"chain": {
|
|
1989
2995
|
"default": "ethereum",
|
|
1990
|
-
"description": "Chain (ethereum, bnb, base)"
|
|
2996
|
+
"description": "Chain (ethereum, bnb, base)",
|
|
2997
|
+
"type": "string"
|
|
1991
2998
|
}
|
|
1992
|
-
}
|
|
2999
|
+
},
|
|
3000
|
+
"pagination": false
|
|
1993
3001
|
},
|
|
1994
3002
|
"historical-wallet-transactions": {
|
|
1995
3003
|
"endpoint": "/api/v1/profiler/address/historical-transactions",
|
|
@@ -1997,15 +3005,19 @@
|
|
|
1997
3005
|
"options": {
|
|
1998
3006
|
"address": {
|
|
1999
3007
|
"required": true,
|
|
2000
|
-
"description": "Wallet address"
|
|
3008
|
+
"description": "Wallet address",
|
|
3009
|
+
"type": "string"
|
|
2001
3010
|
},
|
|
2002
3011
|
"as-of-date": {
|
|
2003
3012
|
"required": true,
|
|
2004
|
-
"description": "Snapshot date (YYYY-MM-DD)"
|
|
3013
|
+
"description": "Snapshot date (YYYY-MM-DD)",
|
|
3014
|
+
"type": "string",
|
|
3015
|
+
"format": "date"
|
|
2005
3016
|
},
|
|
2006
3017
|
"chain": {
|
|
2007
3018
|
"default": "ethereum",
|
|
2008
|
-
"description": "Chain"
|
|
3019
|
+
"description": "Chain",
|
|
3020
|
+
"type": "string"
|
|
2009
3021
|
}
|
|
2010
3022
|
}
|
|
2011
3023
|
}
|
|
@@ -2026,7 +3038,13 @@
|
|
|
2026
3038
|
"channels",
|
|
2027
3039
|
"data",
|
|
2028
3040
|
"description"
|
|
2029
|
-
]
|
|
3041
|
+
],
|
|
3042
|
+
"options": {
|
|
3043
|
+
"reveal": {
|
|
3044
|
+
"type": "boolean",
|
|
3045
|
+
"description": "Show full channel webhook URLs and webhook signing secrets (redacted by default)"
|
|
3046
|
+
}
|
|
3047
|
+
}
|
|
2030
3048
|
},
|
|
2031
3049
|
"create": {
|
|
2032
3050
|
"endpoint": "/api/v1/smart-alert",
|
|
@@ -2065,7 +3083,11 @@
|
|
|
2065
3083
|
},
|
|
2066
3084
|
"webhook-secret": {
|
|
2067
3085
|
"type": "string",
|
|
2068
|
-
"description": "Signing secret for webhook payload verification (optional, webhook only)"
|
|
3086
|
+
"description": "Signing secret for webhook payload verification (optional, webhook only, minimum 16 characters). Visible in shell history and the process list; prefer --webhook-secret-stdin or the NANSEN_WEBHOOK_SECRET env var. Cannot combine with --webhook-secret-stdin; overrides NANSEN_WEBHOOK_SECRET."
|
|
3087
|
+
},
|
|
3088
|
+
"webhook-secret-stdin": {
|
|
3089
|
+
"type": "boolean",
|
|
3090
|
+
"description": "Read the webhook signing secret from a pipe or redirected file (maximum 4096 bytes; input must close within 30 seconds). Surrounding whitespace is trimmed; the secret is never echoed. Requires --webhook. Cannot combine with --webhook-secret; overrides NANSEN_WEBHOOK_SECRET, which is read only when --webhook is given."
|
|
2069
3091
|
},
|
|
2070
3092
|
"data": {
|
|
2071
3093
|
"type": "string",
|
|
@@ -2078,6 +3100,10 @@
|
|
|
2078
3100
|
"disabled": {
|
|
2079
3101
|
"type": "boolean",
|
|
2080
3102
|
"description": "Create alert in disabled state"
|
|
3103
|
+
},
|
|
3104
|
+
"reveal": {
|
|
3105
|
+
"type": "boolean",
|
|
3106
|
+
"description": "Show full channel webhook URLs and webhook signing secrets in the response (redacted by default)"
|
|
2081
3107
|
}
|
|
2082
3108
|
}
|
|
2083
3109
|
},
|
|
@@ -2116,7 +3142,11 @@
|
|
|
2116
3142
|
},
|
|
2117
3143
|
"webhook-secret": {
|
|
2118
3144
|
"type": "string",
|
|
2119
|
-
"description": "Signing secret for webhook payload verification (optional, webhook only)"
|
|
3145
|
+
"description": "Signing secret for webhook payload verification (optional, webhook only, minimum 16 characters). Visible in shell history and the process list; prefer --webhook-secret-stdin or the NANSEN_WEBHOOK_SECRET env var. Cannot combine with --webhook-secret-stdin; overrides NANSEN_WEBHOOK_SECRET."
|
|
3146
|
+
},
|
|
3147
|
+
"webhook-secret-stdin": {
|
|
3148
|
+
"type": "boolean",
|
|
3149
|
+
"description": "Read the webhook signing secret from a pipe or redirected file (maximum 4096 bytes; input must close within 30 seconds). Surrounding whitespace is trimmed; the secret is never echoed. Requires --webhook. Cannot combine with --webhook-secret; overrides NANSEN_WEBHOOK_SECRET, which is read only when --webhook is given."
|
|
2120
3150
|
},
|
|
2121
3151
|
"data": {
|
|
2122
3152
|
"type": "string",
|
|
@@ -2133,6 +3163,10 @@
|
|
|
2133
3163
|
"disabled": {
|
|
2134
3164
|
"type": "boolean",
|
|
2135
3165
|
"description": "Disable alert"
|
|
3166
|
+
},
|
|
3167
|
+
"reveal": {
|
|
3168
|
+
"type": "boolean",
|
|
3169
|
+
"description": "Show full channel webhook URLs and webhook signing secrets in the response (redacted by default)"
|
|
2136
3170
|
}
|
|
2137
3171
|
}
|
|
2138
3172
|
},
|
|
@@ -2147,13 +3181,22 @@
|
|
|
2147
3181
|
"disabled": {
|
|
2148
3182
|
"type": "boolean",
|
|
2149
3183
|
"description": "Disable alert"
|
|
3184
|
+
},
|
|
3185
|
+
"reveal": {
|
|
3186
|
+
"type": "boolean",
|
|
3187
|
+
"description": "Show full channel webhook URLs and webhook signing secrets in the response (redacted by default)"
|
|
2150
3188
|
}
|
|
2151
3189
|
}
|
|
2152
3190
|
},
|
|
2153
3191
|
"delete": {
|
|
2154
3192
|
"endpoint": "/api/v1/smart-alert/{alertId}",
|
|
2155
3193
|
"description": "Delete an alert. Usage: nansen alerts delete <id>",
|
|
2156
|
-
"options": {
|
|
3194
|
+
"options": {
|
|
3195
|
+
"reveal": {
|
|
3196
|
+
"type": "boolean",
|
|
3197
|
+
"description": "Show full channel webhook URLs and webhook signing secrets in error messages (redacted by default)"
|
|
3198
|
+
}
|
|
3199
|
+
}
|
|
2157
3200
|
}
|
|
2158
3201
|
}
|
|
2159
3202
|
},
|
|
@@ -2280,6 +3323,9 @@
|
|
|
2280
3323
|
},
|
|
2281
3324
|
"yes": {
|
|
2282
3325
|
"type": "boolean",
|
|
3326
|
+
"aliases": [
|
|
3327
|
+
"y"
|
|
3328
|
+
],
|
|
2283
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."
|
|
2284
3330
|
}
|
|
2285
3331
|
},
|
|
@@ -2364,6 +3410,17 @@
|
|
|
2364
3410
|
"wallet": {
|
|
2365
3411
|
"type": "string",
|
|
2366
3412
|
"description": "Wallet name (or \"walletconnect\"/\"wc\")"
|
|
3413
|
+
},
|
|
3414
|
+
"dry-run": {
|
|
3415
|
+
"type": "boolean",
|
|
3416
|
+
"description": "Print a locally validated create intent and stop before limit-order authentication, custom-token metadata RPC lookups, transaction crafting, transaction signing, or order submission. No API request is made and exits 0."
|
|
3417
|
+
},
|
|
3418
|
+
"yes": {
|
|
3419
|
+
"type": "boolean",
|
|
3420
|
+
"aliases": [
|
|
3421
|
+
"y"
|
|
3422
|
+
],
|
|
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."
|
|
2367
3424
|
}
|
|
2368
3425
|
},
|
|
2369
3426
|
"chains": [
|
|
@@ -2423,6 +3480,17 @@
|
|
|
2423
3480
|
"wallet": {
|
|
2424
3481
|
"type": "string",
|
|
2425
3482
|
"description": "Wallet name (or \"walletconnect\"/\"wc\")"
|
|
3483
|
+
},
|
|
3484
|
+
"dry-run": {
|
|
3485
|
+
"type": "boolean",
|
|
3486
|
+
"description": "Print a locally validated cancel intent and stop before limit-order authentication, order lookup, signing, confirmation, or requesting/consuming the one-time cancellation transaction. No API request is made and exits 0."
|
|
3487
|
+
},
|
|
3488
|
+
"yes": {
|
|
3489
|
+
"type": "boolean",
|
|
3490
|
+
"aliases": [
|
|
3491
|
+
"y"
|
|
3492
|
+
],
|
|
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."
|
|
2426
3494
|
}
|
|
2427
3495
|
},
|
|
2428
3496
|
"chains": [
|
|
@@ -2462,11 +3530,25 @@
|
|
|
2462
3530
|
"description": "Wallet management. x402 auto-payments are guarded by a client-side policy: per-payment USD cap via NANSEN_X402_MAX_AMOUNT (default 1.00; 'unlimited' to disable), an optional cumulative cap on what one CLI process signs via NANSEN_X402_SESSION_MAX_AMOUNT (environment only; unset or 'unlimited' = no limit, an invalid value refuses every payment; a payment the server cleanly rejects is not counted; it resets with every process), and an optional recipient allowlist via NANSEN_X402_ALLOWED_PAYTO (comma-separated addresses). Each auto-payment and its outcome are recorded in ~/.nansen/x402/payments.jsonl.",
|
|
2463
3531
|
"subcommands": {
|
|
2464
3532
|
"create": {
|
|
2465
|
-
"description": "Create a new wallet. Explicitly blank --name values are rejected for local and Privy wallets.",
|
|
3533
|
+
"description": "Create a new wallet (EVM + Solana). A local wallet needs a password of at least 12 characters from NANSEN_WALLET_PASSWORD (or the password an earlier wallet create saved); the command does not prompt unless --human is passed, and without a password it fails with PASSWORD_REQUIRED. The password is then saved to the OS keychain, or to ~/.nansen/wallets/.credentials (plaintext) when no keychain is available, so later wallet commands find it. If neither can be written, the wallet is still created but the password is not saved, and NANSEN_WALLET_PASSWORD must stay set for every later wallet command. Privy wallets need no password. Explicitly blank --name values are rejected for local and Privy wallets.",
|
|
2466
3534
|
"options": {
|
|
3535
|
+
"name": {
|
|
3536
|
+
"type": "string",
|
|
3537
|
+
"default": "default",
|
|
3538
|
+
"description": "Wallet name"
|
|
3539
|
+
},
|
|
3540
|
+
"provider": {
|
|
3541
|
+
"type": "string",
|
|
3542
|
+
"enum": ["local", "privy"],
|
|
3543
|
+
"description": "local (default) stores encrypted keys on disk; privy creates a server-side wallet and needs PRIVY_APP_ID and PRIVY_APP_SECRET. NANSEN_WALLET_PROVIDER=privy also selects privy"
|
|
3544
|
+
},
|
|
2467
3545
|
"unsafe-no-password": {
|
|
2468
3546
|
"type": "boolean",
|
|
2469
3547
|
"description": "Skip encryption; private keys are stored unencrypted on disk (local only)"
|
|
3548
|
+
},
|
|
3549
|
+
"human": {
|
|
3550
|
+
"type": "boolean",
|
|
3551
|
+
"description": "Prompt for the password in an interactive terminal when none is set or saved (for humans; agents set NANSEN_WALLET_PASSWORD instead)"
|
|
2470
3552
|
}
|
|
2471
3553
|
},
|
|
2472
3554
|
"examples": [
|
|
@@ -2512,7 +3594,7 @@
|
|
|
2512
3594
|
]
|
|
2513
3595
|
},
|
|
2514
3596
|
"send": {
|
|
2515
|
-
"description": "Send tokens or native currency. Explicitly blank --token and --wallet values are rejected; omit them for native currency and the default wallet.",
|
|
3597
|
+
"description": "Send tokens or native currency. --token takes USDC, USDT or a token contract/mint address. Explicitly blank --token and --wallet values are rejected; omit them for native currency and the default wallet.",
|
|
2516
3598
|
"options": {
|
|
2517
3599
|
"to": {
|
|
2518
3600
|
"type": "string",
|
|
@@ -2532,10 +3614,23 @@
|
|
|
2532
3614
|
"max": {
|
|
2533
3615
|
"type": "boolean",
|
|
2534
3616
|
"description": "Send the entire spendable balance instead of --amount"
|
|
3617
|
+
},
|
|
3618
|
+
"token": {
|
|
3619
|
+
"type": "string",
|
|
3620
|
+
"description": "Token to send: USDC, USDT, or a token contract/mint address. Omit to send the chain's native currency"
|
|
3621
|
+
},
|
|
3622
|
+
"wallet": {
|
|
3623
|
+
"type": "string",
|
|
3624
|
+
"description": "Wallet to send from (default wallet if omitted); walletconnect or wc for a WalletConnect session (EVM only)"
|
|
3625
|
+
},
|
|
3626
|
+
"dry-run": {
|
|
3627
|
+
"type": "boolean",
|
|
3628
|
+
"description": "Preview the transaction without broadcasting it"
|
|
2535
3629
|
}
|
|
2536
3630
|
},
|
|
2537
3631
|
"examples": [
|
|
2538
3632
|
"nansen wallet send --to <address> --amount 1.5 --chain evm",
|
|
3633
|
+
"nansen wallet send --to <address> --amount 25 --chain base --token USDC",
|
|
2539
3634
|
"nansen wallet send --to <address> --max --chain solana"
|
|
2540
3635
|
]
|
|
2541
3636
|
},
|
|
@@ -2925,22 +4020,26 @@
|
|
|
2925
4020
|
"type": "boolean",
|
|
2926
4021
|
"description": "Format output as human-readable table"
|
|
2927
4022
|
},
|
|
4023
|
+
"stream": {
|
|
4024
|
+
"type": "boolean",
|
|
4025
|
+
"description": "Print one JSON object per line (NDJSON), one line per result row, instead of the {success, data} envelope (alias: -s). Applies to commands that return data, such as research commands; schema, feedback and commands that print their own text (trade, wallet, perp trading) ignore it. Takes precedence over --format csv, and over --table except for alerts list, which keeps its table. A single object prints as one line; an empty row list or a non-object result prints nothing. Errors are not streamed and print as they would without --stream."
|
|
4026
|
+
},
|
|
2928
4027
|
"fields": {
|
|
2929
4028
|
"type": "string",
|
|
2930
4029
|
"description": "Comma-separated list of fields to include in output"
|
|
2931
4030
|
},
|
|
2932
4031
|
"limit": {
|
|
2933
4032
|
"type": "number",
|
|
2934
|
-
"description": "Maximum results per page for list-returning research commands; maps to pagination.per_page. General endpoints default to 10 (max 1000), while profiler address endpoints default to 20 (max 100).
|
|
4033
|
+
"description": "Maximum results per page for list-returning research commands; maps to pagination.per_page. General endpoints default to 10 (max 1000), while profiler address endpoints default to 20 (max 100). Commands that declare their own limit option (search, token top-tokens, trade limit-order list) use those command-specific semantics instead. Research commands marked \"pagination\": false in this schema (for example token ohlcv, profiler perp-positions, historical-token-flow-summary) reject it. profiler labels defaults to 100 when omitted."
|
|
2935
4034
|
},
|
|
2936
4035
|
"page": {
|
|
2937
4036
|
"type": "number",
|
|
2938
4037
|
"default": 1,
|
|
2939
|
-
"description": "1-based page number for list-returning research commands; maps to pagination.page.
|
|
4038
|
+
"description": "1-based page number (a positive integer) for list-returning research commands; maps to pagination.page. Research commands marked \"pagination\": false in this schema reject it. Trade, wallet, and operational commands ignore it. profiler labels defaults to page 1 when omitted."
|
|
2940
4039
|
},
|
|
2941
4040
|
"paginate": {
|
|
2942
4041
|
"type": "boolean",
|
|
2943
|
-
"description": "Fetch every page of a list-returning command and return one merged response (alias: --all). Starts at --page (default 1) and uses --limit as the page size; stops on a short or empty page, when server pagination metadata (total_pages, total, is_last_page, has_more, or next_page) says the traversal is complete, when a page repeats rows already seen, or after --max-pages requests. Server total metadata is trusted, so a live dataset that changes or reports inconsistent totals during traversal can omit later rows. The merged response keeps the first page's shape (a bare array is wrapped as { data: [...] }) with rows de-duplicated, plus pagination: { page, pages_fetched, next_page, complete } — next_page is null when complete, otherwise the page to resume from. Each page is a separate, separately billed API call. Works with --stream (NDJSON), --table, --format csv and --fields.
|
|
4042
|
+
"description": "Fetch every page of a list-returning command and return one merged response (alias: --all). Starts at --page (default 1) and uses --limit as the page size; stops on a short or empty page, when server pagination metadata (total_pages, total, is_last_page, has_more, or next_page) says the traversal is complete, when a page repeats rows already seen, or after --max-pages requests. Server total metadata is trusted, so a live dataset that changes or reports inconsistent totals during traversal can omit later rows. The merged response keeps the first page's shape (a bare array is wrapped as { data: [...] }) with rows de-duplicated, plus pagination: { page, pages_fetched, next_page, complete } — next_page is null when complete, otherwise the page to resume from. Each page is a separate, separately billed API call. Works with --stream (NDJSON), --table, --format csv and --fields. Research commands marked \"pagination\": false reject it."
|
|
2944
4043
|
},
|
|
2945
4044
|
"max-pages": {
|
|
2946
4045
|
"type": "integer",
|
|
@@ -2985,7 +4084,7 @@
|
|
|
2985
4084
|
"json",
|
|
2986
4085
|
"csv"
|
|
2987
4086
|
],
|
|
2988
|
-
"description": "Output format (default
|
|
4087
|
+
"description": "Output format: json (default) or csv. Any other value is rejected."
|
|
2989
4088
|
},
|
|
2990
4089
|
"x402-payment-signature": {
|
|
2991
4090
|
"type": "string",
|
|
@@ -3076,7 +4175,6 @@
|
|
|
3076
4175
|
"viction"
|
|
3077
4176
|
],
|
|
3078
4177
|
"smartMoneyLabels": [
|
|
3079
|
-
"Fund",
|
|
3080
4178
|
"Smart Trader",
|
|
3081
4179
|
"30D Smart Trader",
|
|
3082
4180
|
"90D Smart Trader",
|