API reference · v5

Binance Smart Signal API

Binance Smart Signal per symbol: how many top traders and whales are long or short, the notional on each side, and who they are.

Base URL https://api.kopyon.com/v5/binance-smart-signal/ · send your key in the X-API-KEY header · trader id: No trader ids: this source is read by symbol, such as BTCUSDT.

Get a free API key · Interactive reference with Try it · Authentication, paging and errors

Signals

GET /v5/binance-smart-signal/signals

Every symbol with what smart-money traders and whales did on each side, in Binance's order.

Binance refreshes this Binance updates these signals about every 30 s..

Query parameters

Name	Type	Description
`period`required	enum	30m to 7D cover what was traded in that period; ALL covers the positions held now30m, 1h, 1D, 7D, ALL
`symbol`	string	Only this symbol; an unknown one gives an empty list

Response fields, in `data`

Field	Type	Description
`signals[]`always	array
`signals[].symbol`always	string
`signals[].dominantSide`always	LONG \| SHORT	The side with the larger notional
`signals[].notional`always	number	Long and short notional together
`signals[].long`always	object
`signals[].long.notional`always	number	In the quote asset
`signals[].long.qty`always	number	In the base asset
`signals[].long.traders`always	number	Smart-money traders on this side, whales included
`signals[].long.whales`always	number
`signals[].long.avgEntryPrice`	number	Average entry price; omitted when the side has no one
`signals[].short`always	object
`signals[].short.notional`always	number	In the quote asset
`signals[].short.qty`always	number	In the base asset
`signals[].short.traders`always	number	Smart-money traders on this side, whales included
`signals[].short.whales`always	number
`signals[].short.avgEntryPrice`	number	Average entry price; omitted when the side has no one

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/binance-smart-signal/signals?period=30m"

{
  "data": {
    "signals": [
      {
        "symbol": "BTCUSDT",
        "dominantSide": "SHORT",
        "notional": 23778316.65048,
        "long": {
          "notional": 2948670.76834,
          "qty": 36.384,
          "traders": 89,
          "whales": 50,
          "avgEntryPrice": 81043.06201462
        },
        "short": {
          "notional": 20829645.88214,
          "qty": 256.844,
          "traders": 153,
          "whales": 114,
          "avgEntryPrice": 81098.43283137
        }
      },
      {
        "symbol": "ETHUSDT",
        "dominantSide": "SHORT",
        "notional": 19246265.97027,
        "long": {
          "notional": 7575321.15616,
          "qty": 3190.761,
          "traders": 124,
          "whales": 86,
          "avgEntryPrice": 2374.14245572
        },
        "short": {
          "notional": 11670944.81411,
          "qty": 4914.542,
          "traders": 142,
          "whales": 97,
          "avgEntryPrice": 2374.77771359
        }
      },
      {
        "symbol": "ZECUSDT",
        "dominantSide": "LONG",
        "notional": 7731214.15658,
        "long": {
          "notional": 4817523.9094,
          "qty": 4461.058,
          "traders": 152,
          "whales": 71,
          "avgEntryPrice": 1079.90613648
        },
        "short": {
          "notional": 2913690.24718,
          "qty": 2691.615,
          "traders": 172,
          "whales": 84,
          "avgEntryPrice": 1082.50631951
        }
      }
    ]
  }
}

Symbol overview

GET /v5/binance-smart-signal/symbolOverview

The positions smart-money traders and whales hold on a symbol, by side, and how many are in profit.

Binance refreshes this Binance updates this overview about every 60 s..

Query parameters

Name	Type	Description
`symbol`required	string	A USDⓈ-M futures symbol in capitals, for example BTCUSDT

Response fields, in `data`

Field	Type	Description
`symbol`always	string
`notional`always	number	Positions smart-money traders hold now, in the quote asset
`longShortRatio`always	number	Long notional divided by short notional
`updatedAt`always	number	When Binance computed it, in Unix milliseconds
`traders`always	object	Every smart-money trader, whales included
`traders.long`always	object
`traders.long.count`always	number
`traders.long.qty`always	number	Position size, in the base asset
`traders.long.avgEntryPrice`	number	Average entry price; omitted when the side has no one
`traders.long.profitable`always	number	How many are in profit
`traders.short`always	object
`traders.short.count`always	number
`traders.short.qty`always	number	Position size, in the base asset
`traders.short.avgEntryPrice`	number	Average entry price; omitted when the side has no one
`traders.short.profitable`always	number	How many are in profit
`whales`always	object
`whales.long`always	object
`whales.long.count`always	number
`whales.long.qty`always	number	Position size, in the base asset
`whales.long.avgEntryPrice`	number	Average entry price; omitted when the side has no one
`whales.long.profitable`always	number	How many are in profit
`whales.short`always	object
`whales.short.count`always	number
`whales.short.qty`always	number	Position size, in the base asset
`whales.short.avgEntryPrice`	number	Average entry price; omitted when the side has no one
`whales.short.profitable`always	number	How many are in profit

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/binance-smart-signal/symbolOverview?symbol=BTCUSDT"

{
  "data": {
    "symbol": "BTCUSDT",
    "notional": 3220848220.3619366,
    "longShortRatio": 0.3976,
    "updatedAt": 1792303268147,
    "traders": {
      "long": {
        "count": 712,
        "qty": 11301.526,
        "avgEntryPrice": 84804.94360588,
        "profitable": 116
      },
      "short": {
        "count": 1020,
        "qty": 28422.004,
        "avgEntryPrice": 78451.09020063,
        "profitable": 780
      }
    },
    "whales": {
      "long": {
        "count": 257,
        "qty": 10573.87,
        "avgEntryPrice": 85043.3155278,
        "profitable": 46
      },
      "short": {
        "count": 440,
        "qty": 27811.549,
        "avgEntryPrice": 78372.16870612,
        "profitable": 316
      }
    }
  }
}

Symbol stats

GET /v5/binance-smart-signal/symbolStats

How many traders and whales are on each side of a symbol over a time range, and their notional.

Query parameters

Name	Type	Description
`symbol`required	string	A USDⓈ-M futures symbol in capitals, for example BTCUSDT
`period`required	enum	30m to 7D cover what was traded in that period; ALL covers the positions held now30m, 1h, 1D, 7D, ALL

Response fields, in `data`

Field	Type	Description
`symbol`always	string
`period`always	string
`traders`always	object	Every smart-money trader, whales included. For 30m to 7D, what was traded in the range; for ALL, the positions held now.
`traders.long`always	object
`traders.long.count`always	number
`traders.long.notional`always	number
`traders.long.qty`always	number
`traders.short`always	object
`traders.short.count`always	number
`traders.short.notional`always	number
`traders.short.qty`always	number
`whales`always	object
`whales.long`always	object
`whales.long.count`always	number
`whales.long.notional`always	number
`whales.long.qty`always	number
`whales.short`always	object
`whales.short.count`always	number
`whales.short.notional`always	number
`whales.short.qty`always	number

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/binance-smart-signal/symbolStats?symbol=BTCUSDT&period=30m"

{
  "data": {
    "symbol": "BTCUSDT",
    "period": "30m",
    "traders": {
      "long": {
        "count": 89,
        "notional": 2948670.76834,
        "qty": 36.384
      },
      "short": {
        "count": 153,
        "notional": 20829645.88214,
        "qty": 256.844
      }
    },
    "whales": {
      "long": {
        "count": 50,
        "notional": 2013828.84114,
        "qty": 24.853
      },
      "short": {
        "count": 114,
        "notional": 20031060.19544,
        "qty": 246.994
      }
    }
  }
}

Symbol traders

GET /v5/binance-smart-signal/symbolTraders

The named traders on a symbol, plus one row that adds up those who hide their name. traderId works with the Binance Smart Money operations.

Query parameters

Name	Type	Description
`symbol`required	string	A USDⓈ-M futures symbol in capitals, for example BTCUSDT
`period`required	enum	30m to 7D cover what was traded in that period; ALL covers the positions held now30m, 1h, 1D, 7D, ALL
`group`	enumdefault traders	traders lists every smart-money trader, whales only the whalestraders, whales
`side`	enum	Only this sideLONG, SHORT
`sortBy`	enumdefault lastTrade	size sorts by volume for 30m to 7D, by position for ALLlastTrade, size
`order`	enumdefault DESC	DESC lists the highest first, ASC the lowestDESC, ASC
`page`	intdefault 1	Page number
`rows`	intdefault 20	Rows per page1 to 50

Response fields, in `data`

Field	Type	Description
`traders[]`always	array
`traders[].anonymous`always	boolean	true for the row that adds up every trader or whale who hides their name
`traders[].whale`always	boolean
`traders[].traderId`	string	Named traders only: the same id as /v5/binance-smart-money/traderProfile takes
`traders[].name`	string
`traders[].count`always	number	Traders the row adds up; 1 for a named trader
`traders[].side`always	LONG \| SHORT
`traders[].volume`	number	30m to 7D: notional traded in the range, in the quote asset
`traders[].notional`	number	ALL: the position held now, in the quote asset
`traders[].qty`	number	ALL: the position held now, in the base asset
`traders[].avgEntryPrice`	number	ALL: the position's average entry price
`traders[].lastTradeAt`always	number	Last trade, in Unix milliseconds
`hasMore`always	boolean	true when another page follows
`total`	number	Rows across all pages

Example

curl -H "X-API-KEY: $KOPYON_KEY" \
  "https://api.kopyon.com/v5/binance-smart-signal/symbolTraders?symbol=BTCUSDT&period=30m"

{
  "data": {
    "traders": [
      {
        "anonymous": true,
        "whale": false,
        "count": 152,
        "side": "SHORT",
        "volume": 20821541.26214,
        "lastTradeAt": 1792339442000
      },
      {
        "anonymous": true,
        "whale": false,
        "count": 88,
        "side": "LONG",
        "volume": 2948663.88364,
        "lastTradeAt": 1792339421000
      },
      {
        "anonymous": false,
        "whale": false,
        "traderId": "5241853511379906816",
        "name": "有大车",
        "count": 1,
        "side": "SHORT",
        "volume": 8104.62,
        "lastTradeAt": 1792338511000
      }
    ],
    "hasMore": false,
    "total": 4
  }
}

Binance Smart Signal API

Signals

Query parameters

Response fields, in data

Example

Symbol overview

Query parameters

Response fields, in data

Example

Symbol stats

Query parameters

Response fields, in data

Example

Symbol traders

Query parameters

Response fields, in data

Example

Try the Binance Smart Signal API for free.

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`

Response fields, in `data`