1# trading-signal — CLI Reference
2 
3Complete reference for every command in `scripts/cli.mjs`.
4 
5**Invocation pattern:** `node <skill-dir>/scripts/cli.mjs <command> '<json_params>'`
6**Exit codes:** `0` success · `1` usage/upstream error · `3` network failure
7 
8---
9 
10## `smart-money` — On-chain Smart Money trading signals
11 
12> ⚠️ Only `"56"` (BSC) and `"CT_501"` (Solana) are supported. `pageSize` max is `100`. Signals with `status: "timeout"` are stale — prefer `"valid"` / `"active"` signals.
13 
14```bash
15node <skill-dir>/scripts/cli.mjs smart-money '{"chainId":"CT_501","page":1,"pageSize":20}'
16```
17 
18### Parameters
19 
20| Param | Type | Required | Default | Description |
21|---|---|---|---|---|
22| `chainId` | string | **yes** | — | `"56"` (BSC) · `"CT_501"` (Solana) |
23| `page` | number | no | `1` | Page number (1-indexed) |
24| `pageSize` | number | no | — | Items per page, max `100` |
25| `smartSignalType` | string | no | — | Filter by signal type (e.g. `"SMART_MONEY"`); omit for all |
26 
27### Return fields (under `.data[]`)
28 
29**Token identity**
30 
31| Field | Type | Description |
32|---|---|---|
33| `signalId` | number | Unique signal ID |
34| `ticker` | string | Token symbol |
35| `chainId` | string | Chain identifier |
36| `contractAddress` | string | Token contract address |
37| `logoUrl` | string | Logo path — prefix with `https://bin.bnbstatic.com` |
38| `chainLogoUrl` | string | Full URL of the chain icon |
39| `tokenDecimals` | number | Token decimals |
40 
41**Tags & flags**
42 
43| Field | Type | Description |
44|---|---|---|
45| `isAlpha` | boolean | Marked as Alpha token |
46| `launchPlatform` | string | Launch platform (e.g. `"Pumpfun"`, `"Moonshot"`) |
47| `tokenTag` | object | Categorized tags. Known categories: `"Social Events"`, `"Launch Platform"`, `"Sensitive Events"`, `"Wash Trading Behavior"` |
48 
49**Signal data**
50 
51| Field | Type | Description |
52|---|---|---|
53| `smartSignalType` | string | e.g. `"SMART_MONEY"` |
54| `direction` | string | `"buy"` or `"sell"` |
55| `smartMoneyCount` | number | Smart money addresses triggering the signal (higher = stronger) |
56| `signalCount` | number | Historical signal count for this token |
57| `signalTriggerTime` | number | Signal trigger timestamp (ms) |
58| `timeFrame` | number | Observation window (ms) |
59 
60**Price & performance**
61 
62| Field | Type | Description |
63|---|---|---|
64| `alertPrice`, `alertMarketCap` | string | Price / market cap at trigger (USD) |
65| `currentPrice`, `currentMarketCap` | string | Latest price / market cap (USD) |
66| `highestPrice`, `highestPriceTime` | string, number | Peak after signal + timestamp (ms) |
67| `totalTokenValue` | string | Aggregate trade value at signal (USD) |
68| `maxGain` | string | Max % gain since trigger — **decimal fraction** (e.g. `"0.25"` = 25%); multiply by 100 when displaying as a percentage |
69| `exitRate` | number | % of smart money already exited (high = stale) |
70| `status` | string | Signal status. Values: `active` (monitoring), `valid` (fresh/open), `timeout` (expired), `completed` (closed). |
71 
72**Sample `tokenTag` shape** (categorized; each category holds `[{tagName}]`):
73 
74```json
75"tokenTag": {
76  "Social Events": [{"tagName": "DEX Paid"}],
77  "Launch Platform": [{"tagName": "Pumpfun"}],
78  "Sensitive Events": [{"tagName": "Smart Money Add Holdings"}],
79  "Wash Trading Behavior": [{"tagName": "Insider Wash Trading"}]
80}
81```
82 
83**Signal quality:** `smartMoneyCount ≥ 5` = stronger conviction · `exitRate ≥ 70` = already exiting, treat with caution · `status:"timeout"` = no longer actionable.
84 
85---
86 
87## Errors
88 
89Exit codes: `0` ok · `1` upstream/usage (stderr: reason; stdout: body with business `code`) · `3` network.
90Business `code`: `000000` ok · `100004` rate-limited · `100002` bad param (check `chainId`/`pageSize`) · `000400` unsupported chain.
91