/trading-signal

name: trading-signal
description: |
  Per-trade smart-money signals — each result is a discrete buy or sell event from a tracked smart-money wallet,
  with trigger price, current price, max gain since trigger, and exit rate. BSC and Solana only.
  Use for: "smart money buy signal on $X", "any whale just bought $Y", "alpha signals in the last hour",
  "copy-trade-worthy signals", "trigger price and max gain on these trades", "on-chain trading signals from smart money".
metadata:
  author: binance-web3-team
  version: "2.0"

Trading Signal Skill

Overview

This skill retrieves on-chain Smart Money trading signals to help users track professional investors:

Get smart money buy/sell signals Compare signal trigger price with current price Analyze max gain and exit rate of signals Get token tags (e.g., Pumpfun, DEX Paid)

When to Use This Skill

| User intent | Command | |-------------|---------| | Get on-chain smart-money buy/sell signals with gain + exit-rate data | `smart-money` |

Supported Chains

| Chain | chainId | |-------|---------| | BSC | `56` | | Solana | `CT_501` |

How to Call APIs

node <skill-dir>/scripts/cli.mjs smart-money '{"chainId":"CT_501","page":1,"pageSize":50}'

Commands

| Command | Purpose | Required args | Example | |---------|---------|---------------|---------| | `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}'` |

Optional args: `page` (default 1), `pageSize` (**max 100**), `smartSignalType` (filter; empty string = all).

Rules

• **`pageSize` cap is 100** — larger values are silently clamped upstream.
• **`status` enum** (map to user-friendly language when summarizing):
• `active` — signal still valid
• `timeout` — exceeded observation window (may still be informative, but stale)
• `completed` — reached target / stop loss

Prefer `active` signals when surfacing actionable opportunities.

• **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.
• **`direction`** is `buy` or `sell` — always include this when summarizing a signal.
• **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.

Full CLI Reference

See [`references/cli.md`](references/cli.md) for per-subcommand invocations, parameter tables, signal / tag / performance field tables, and real response samples.