Market Price API

KOL & Smart Money Tracker Trades Channel#

Real-time push of on-chain transaction activity from tracked KOL / Smart Money addresses. Subscribe after login; data is pushed whenever a new transaction occurs.
URL Path
wss://wsdex.okx.com/ws/v6/dex

Request Parameters#

ParameterTypeRequiredDescription
opStringYesOperation: subscribe unsubscribe
argsArrayYesList of subscription parameters
> channelStringYesChannel name: kol_smartmoney-tracker-activity

Response Parameters#

ParameterTypeDescription
eventStringEvent type: subscribe unsubscribe error
argObjectSuccessfully subscribed channel parameters
> channelStringChannel name
codeStringError code (only returned when event=error)
msgStringError message (only returned when event=error)
connIdStringWebSocket connection ID

Push Data Parameters#

ParameterTypeDescription
argObjectChannel info that triggered the push
> channelStringChannel name
dataArrayList of pushed trade activity
> txHashStringTransaction hash
> walletAddressStringTrading wallet address
> quoteTokenSymbolStringQuote token symbol (native chain token)
> quoteTokenAmountStringQuote token trade amount
> tokenSymbolStringTraded token symbol
> tokenContractAddressStringTraded token contract address
> chainIndexStringChain identifier of the traded token
> tokenPriceStringTrade price of the token (USD)
> marketCapStringMarket cap of the token at the trade price (USD)
> realizedPnlUsdStringRealized PnL for the token (USD)
> tradeTypeStringTrade type: 1 buy 2 sell
> tradeTimeStringTrade time (Unix timestamp in milliseconds)
> trackerTypeArrayTracker wallet type: 1 Smart Money 2 KOL

Request Example#

Json
{
  "op": "subscribe",
  "args": [
    {
      "channel": "kol_smartmoney-tracker-activity"
    }
  ]
}

Response Example#

Successful response example

Json
{
  "event": "subscribe",
  "arg": {
    "channel": "kol_smartmoney-tracker-activity"
  },
  "connId": "a4d3ae55"
}

Failure response example

Json
{
  "event": "error",
  "code": "60012",
  "msg": "Invalid request: {\"op\": \"subscribe\", \"argss\":[{ \"channel\" , \"chainIndex\" : \"1\", \"tokenContractAddress\" : \"0x382bb369d343125bfb2117af9c149795c6c65c50\"}]}",
  "connId": "a4d3ae55"
}

Push data example

Json
{
  "arg": {
    "channel": "kol_smartmoney-tracker-activity"
  },
  "data": [
    {
      "baseTokenChainIndex": "501",
      "baseTokenContractAddress": "FmxDdxpFmmuN4DeXoHFzuEyrH8RfRsej6oxg4MaUpump",
      "baseTokenSymbol": "XAIC",
      "marketCap": "3229.75150297000000000000000000000000000",
      "quoteTokenAmount": "1.576294",
      "quoteTokenSymbol": "SOLANA",
      "realizedPnlUsd": "-0.481221442431056693018746",
      "trackerType": [1],
      "tradePrice": "0.00000322975150297",
      "tradeTime": 1773628806000,
      "tradeType": "2",
      "walletAddress": "DHfshpzoC9Q7rz32j5juq2do3Bo8bA1KLmkNiRYaA8tf"
    }
  ]
}