1---
2name: trading-signal
3description: |
4  Per-trade smart-money signals — each result is a discrete buy or sell event from a tracked smart-money wallet,
5  with trigger price, current price, max gain since trigger, and exit rate. BSC and Solana only.
6  Use for: "smart money buy signal on $X", "any whale just bought $Y", "alpha signals in the last hour",
7  "copy-trade-worthy signals", "trigger price and max gain on these trades", "on-chain trading signals from smart money".
8metadata:
9  author: binance-web3-team
10  version: "2.0"
11---
12 
13# Trading Signal Skill
14 
15## Overview
16 
17This skill retrieves on-chain Smart Money trading signals to help users track professional investors:
18 
19Get smart money buy/sell signals
20Compare signal trigger price with current price
21Analyze max gain and exit rate of signals
22Get token tags (e.g., Pumpfun, DEX Paid)
23 
24 
25## When to Use This Skill
26 
27| User intent | Command |
28|-------------|---------|
29| Get on-chain smart-money buy/sell signals with gain + exit-rate data | `smart-money` |
30 
31## Supported Chains
32 
33| Chain | chainId |
34|-------|---------|
35| BSC | `56` |
36| Solana | `CT_501` |
37 
38## How to Call APIs
39 
40```bash
41node <skill-dir>/scripts/cli.mjs smart-money '{"chainId":"CT_501","page":1,"pageSize":50}'
42```
43 
44## Commands
45 
46| Command | Purpose | Required args | Example |
47|---------|---------|---------------|---------|
48| `smart-money` | Smart-money buy/sell signals with trigger price, max gain, exit rate | `chainId` | `node <skill-dir>/scripts/cli.mjs smart-money '{"chainId":"56","page":1,"pageSize":50}'` |
49 
50Optional args: `page` (default 1), `pageSize` (**max 100**), `smartSignalType` (filter; empty string = all).
51 
52## Rules
53 
54- **`pageSize` cap is 100** — larger values are silently clamped upstream.
55- **`status` enum** (map to user-friendly language when summarizing):
56  - `active` — signal still valid
57  - `timeout` — exceeded observation window (may still be informative, but stale)
58  - `completed` — reached target / stop loss
59  Prefer `active` signals when surfacing actionable opportunities.
60- **Quality indicators**: higher `smartMoneyCount` (more distinct smart-money addresses) implies higher signal reliability; high `exitRate` (%) suggests smart money has already exited, so the opportunity may have passed.
61- **`direction`** is `buy` or `sell` — always include this when summarizing a signal.
62- **Icon URL prefix**: `logoUrl` is a relative path; prepend `https://bin.bnbstatic.com`. `chainLogoUrl` is already a full URL. Timestamps are ms; `maxGain` is a % string — convert before arithmetic.
63 
64## Full CLI Reference
65 
66See [`references/cli.md`](references/cli.md) for per-subcommand invocations, parameter tables, signal / tag / performance field tables, and real response samples.
67