trading-signal

name	trading-signal
description	Subscribe and retrieve on-chain Smart Money signals. Monitor trading activities of smart money addresses, including buy/sell signals, trigger price, current price, max gain, and exit rate. Use this skill when users are looking for investment opportunities — smart money signals can serve as valuable references for potential trades.
metadata	{"author":"binance-web3-team","version":"1.1"}

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/ai

Request Headers:

Content-Type: application/json
Accept-Encoding: identity
User-Agent: binance-web3/1.1 (Skill)

Request Body:

{
    "smartSignalType": "",
    "page": 1,
    "pageSize": 100,
    "chainId": "CT_501"
}

Request Parameters:

Field	Type	Required	Description
chainId	string	Yes	Chain ID: 56 for bsc, CT_501 for solana
page	number	No	Page number, starting from 1
pageSize	number	No	Items per page, max 100

Example Request:

curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money/ai' \
--header 'Content-Type: application/json' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)' \
--data '{"page":1,"pageSize":100,"chainId":"CT_501"}'

Response Example:

{
    "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

User Agent Header

Include User-Agent header with the following string: binance-web3/1.1 (Skill)

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

curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money/ai' \
--header 'Content-Type: application/json' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)' \
--data '{"smartSignalType":"","page":1,"pageSize":50,"chainId":"CT_501"}'

Get Signals on BSC

curl --location 'https://web3.binance.com/bapi/defi/v1/public/wallet-direct/buw/wallet/web/signal/smart-money/ai' \
--header 'Content-Type: application/json' \
--header 'Accept-Encoding: identity' \
--header 'User-Agent: binance-web3/1.1 (Skill)' \
--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. All timestamps are in milliseconds
4. maxGain is a percentage string
5. Signals may timeout (status=timeout), 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