# Trading Signal

> Use this skill when retrieving or interpreting on-chain smart-money trading signals, including buy or sell direction, trigger price, current price, max gain, exit rate, and token tags.

- Skill: `chatandbuild/trading-signal` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chatandbuild/trading-signal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chatandbuild/trading-signal/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ChatAndBuild (https://skillmd.com/u/chatandbuild)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/chatandbuild/trading-signal

---


# 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)

## API Endpoint

### Get Smart Money Signals

**Method**: POST

**URL**:
`https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money`

**Request Headers**:
```text
Content-Type: application/json
Accept-Encoding: identity
```

**Request Body**:
```json
{
  "smartSignalType": "",
  "page": 1,
  "pageSize": 100,
  "chainId": "CT_501"
}
```

**Request Parameters**:

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| smartSignalType | string | No | Signal type filter, empty string for all |
| page | number | Yes | Page number, starting from 1 |
| pageSize | number | Yes | Items per page, max 100 |
| chainId | string | Yes | Chain ID: `56` for bsc, `CT_501` for solana |

**Example Request**:
```bash
curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money' \
--header 'Content-Type: application/json' \
--header 'Accept-Encoding: identity' \
--data '{"smartSignalType":"","page":1,"pageSize":100,"chainId":"CT_501"}'
```

**Response Example**:
```json
{
  "code": "000000",
  "message": null,
  "messageDetail": null,
  "data": [
    {
      "signalId": 22179,
      "ticker": "symbol of the token",
      "chainId": "CT_501",
      "contractAddress": "NV...pump",
      "logoUrl": "/images/web3-data/public/token/logos/825C62EC6BE6.png",
      "chainLogoUrl": "https://bin.bnbstatic.com/image/admin_mgs_image_upload/20250303/42065e0a-3808-400e-b589-61c2dbfc0eac.png",
      "tokenDecimals": 6,
      "isAlpha": false,
      "launchPlatform": "Pumpfun",
      "mark": null,
      "isExclusiveLaunchpad": false,
      "alphaPoint": null,
      "tokenTag": {
        "Social Events": [
          {"tagName": "DEX Paid", "languageKey": "wmp-label-update-dexscreener-social"}
        ],
        "Launch Platform": [
          {"tagName": "Pumpfun", "languageKey": "wmp-label-title-pumpfun"}
        ],
        "Sensitive Events": [
          {"tagName": "Smart Money Add Holdings", "languageKey": "wmp-label-title-smart-money-add-position"}
        ]
      },
      "smartSignalType": "SMART_MONEY",
      "smartMoneyCount": 5,
      "direction": "buy",
      "timeFrame": 883000,
      "signalTriggerTime": 1771903462000,
      "totalTokenValue": "3436.694044670495772073",
      "alertPrice": "0.024505932131088482",
      "alertMarketCap": "24505118.720436560690909782",
      "currentPrice": "0.025196",
      "currentMarketCap": "25135683.751234890220129783671668745",
      "highestPrice": "0.027244000000000000",
      "highestPriceTime": 1771927760000,
      "exitRate": 78,
      "status": "timeout",
      "maxGain": "5.4034",
      "signalCount": 23
    }
  ],
  "success": true
}
```

**Response Fields**:

### Basic Information
| Field | Type | Description |
|-------|------|-------------|
| signalId | number | Unique signal ID |
| ticker | string | Token symbol/name |
| chainId | string | Chain ID |
| contractAddress | string | Token contract address |
| logoUrl | string | Token icon URL path |
| chainLogoUrl | string | Chain icon URL |
| tokenDecimals | number | Token decimals |

### Tag Information
| Field | Type | Description |
|-------|------|-------------|
| isAlpha | boolean | Whether it's an Alpha token |
| launchPlatform | string | Launch platform (e.g., Pumpfun) |
| isExclusiveLaunchpad | boolean | Whether it's exclusive launchpad |
| alphaPoint | number | Alpha points (can be null) |
| tokenTag | object | Token tag categories |

### Signal Data
| Field | Type | Description |
|-------|------|-------------|
| smartSignalType | string | Signal type, e.g., `SMART_MONEY` |
| smartMoneyCount | number | Number of smart money addresses involved |
| direction | string | Trade direction: `buy` / `sell` |
| timeFrame | number | Time frame (milliseconds) |
| signalTriggerTime | number | Signal trigger timestamp (ms) |
| signalCount | number | Total signal count |

### Price Data
| Field | Type | Description |
|-------|------|-------------|
| totalTokenValue | string | Total trade value (USD) |
| alertPrice | string | Price at signal trigger |
| alertMarketCap | string | Market cap at signal trigger |
| currentPrice | string | Current price |
| currentMarketCap | string | Current market cap |
| highestPrice | string | Highest price after signal |
| highestPriceTime | number | Highest price timestamp (ms) |

### Performance Data
| Field | Type | Description |
|-------|------|-------------|
| exitRate | number | Exit rate (%) |
| status | string | Signal status: `active`/`timeout`/`completed` |
| maxGain | string | Maximum gain (%) |

## Token Tag Types

### Social Events
| Tag | Description |
|-----|-------------|
| DEX Paid | DEX paid promotion |

### Launch Platform
| Tag | Description |
|-----|-------------|
| Pumpfun | Pump.fun platform |
| Moonshot | Moonshot platform |

### Sensitive Events
| Tag | Description |
|-----|-------------|
| Smart Money Add Holdings | Smart money accumulating |
| Smart Money Reduce Holdings | Smart money reducing |
| Whale Buy | Whale buying |
| Whale Sell | Whale selling |

## Supported Chains

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

## Signal Status

| Status | Description |
|--------|-------------|
| active | Active, signal still valid |
| timeout | Timed out, exceeded observation period |
| completed | Completed, reached target or stop loss |

## Use Cases

1. **Track Smart Money**: Monitor professional investor trading behavior
2. **Discover Opportunities**: Get early signals when smart money buys
3. **Risk Alert**: Receive alerts when smart money starts selling
4. **Performance Analysis**: Analyze historical signal performance and max gains
5. **Strategy Validation**: Evaluate signal quality via exitRate and maxGain

## Example Requests

### Get Smart Money Signals on Solana
```bash
curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money' \
--header 'Content-Type: application/json' \
--header 'Accept-Encoding: identity' \
--data '{"smartSignalType":"","page":1,"pageSize":50,"chainId":"CT_501"}'
```

### Get Signals on BSC
```bash
curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money' \
--header 'Content-Type: application/json' \
--header 'Accept-Encoding: identity' \
--data '{"smartSignalType":"","page":1,"pageSize":50,"chainId":"56"}'
```

## Notes

1. Token icon URL requires full domain prefix: `https://bin.bnbstatic.com` + logoUrl path
2. Chain icon URL (`chainLogoUrl`) is already a full URL
3. Timestamps are in milliseconds
4. `maxGain` is a percentage string
5. Signals may timeout (`status=timeout`), so focus on active signals
6. Higher `smartMoneyCount` may indicate higher signal reliability
7. `exitRate` shows smart money exit status; high `exitRate` may indicate expired signal