Market API

Endpointhttps://web3.binance.com/build

Get Supported Chains

Return the list of blockchains supported by the market service.

GET

/api/v1/dex/market/supported/chain

https://web3.binance.com/build

Get Supported Chains › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Supported Chains › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Supported Chains › Responses

Supported chains returned successfully.

code

integer · int32

Business status code. 0 indicates success.

Example: 0

msg

string

Example: success

object[]

List of supported blockchain networks.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

Get Token Price

Get the latest price for tokens. Supports batch queries, up to 100 tokens per request.

POST

/api/v1/dex/market/price

https://web3.binance.com/build

Get Token Price › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Price › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Price › Request Body

object

binanceChainId

string · required

Unique chain identifier (e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0xdac17f958d2ee523a2206206994597c13d831ec7

Get Token Price › Responses

Token prices returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

One price entry per requested token.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

POST/api/v1/dex/market/price

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/market/price \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
[
  {
    "binanceChainId": "1",
    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
  },
  {
    "binanceChainId": "56",
    "tokenContractAddress": "0x55d398326f99059ff775485246999027b3197955"
  }
]
'

Example Request Body

[
  {
    "binanceChainId": "1",
    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
  },
  {
    "binanceChainId": "56",
    "tokenContractAddress": "0x55d398326f99059ff775485246999027b3197955"
  }
]

json

application/json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "binanceChainId": "1",
      "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "price": "1.0002",
      "time": 1748601600000
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Token Trading Info

Get token price and trading data (volume, transactions, market cap, holders, etc.). Supports batch queries for up to 100 tokens.

POST

/api/v1/dex/market/price-info

https://web3.binance.com/build

Get Token Trading Info › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Trading Info › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Trading Info › Request Body

object

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0xdac17f958d2ee523a2206206994597c13d831ec7

Get Token Trading Info › Responses

Price info returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Price info entry per requested token.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

POST/api/v1/dex/market/price-info

curl --request POST \
  --url https://web3.binance.com/build/api/v1/dex/market/price-info \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
[
  {
    "binanceChainId": "1",
    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
  }
]
'

Example Request Body

[
  {
    "binanceChainId": "1",
    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7"
  }
]

json

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "binanceChainId": "1",
      "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "price": "1.0002",
      "time": 1748601600000,
      "marketCap": "83500000.00",
      "priceChange5M": "0.12",
      "priceChange1H": "1.05",
      "priceChange4H": "2.30",
      "priceChange24H": "-0.85",
      "volume5M": "12500.50",
      "volume1H": "120000.30",
      "volume4H": "550000.20",
      "volume24H": "1250000.50",
      "buyVolume5M": "6800.00",
      "buyVolume1H": "65000.00",
      "buyVolume4H": "300000.00",
      "buyVolume24H": "680000.30",
      "sellVolume5M": "5700.00",
      "sellVolume1H": "55000.00",
      "sellVolume4H": "250000.00",
      "sellVolume24H": "570000.20",
      "txs5M": 60,
      "txs1H": 720,
      "txs4H": 2880,
      "txs24H": 1523,
      "buyTxs5M": 33,
      "buyTxs1H": 380,
      "buyTxs4H": 1500,
      "buyTxs24H": 812,
      "sellTxs5M": 27,
      "sellTxs1H": 340,
      "sellTxs4H": 1380,
      "sellTxs24H": 711,
      "maxPrice": "1.0023",
      "minPrice": "0.9987",
      "circSupply": "83000000000",
      "liquidity": "1250000.50",
      "holders": 45832,
      "bnVolume5M": "0",
      "bnVolume1H": "0",
      "bnVolume4H": "0",
      "bnVolume24H": "35000.80",
      "bnBuyVolume5M": "0",
      "bnBuyVolume1H": "0",
      "bnBuyVolume4H": "0",
      "bnBuyVolume24H": "20000.50",
      "bnSellVolume5M": "0",
      "bnSellVolume1H": "0",
      "bnSellVolume4H": "0",
      "bnSellVolume24H": "15000.30",
      "bnTxs5M": 0,
      "bnTxs1H": 0,
      "bnTxs4H": 0,
      "bnTxs24H": 156,
      "bnBuyTxs5M": 0,
      "bnBuyTxs1H": 0,
      "bnBuyTxs4H": 0,
      "bnBuyTxs24H": 89,
      "bnSellTxs5M": 0,
      "bnSellTxs1H": 0,
      "bnSellTxs4H": 0,
      "bnSellTxs24H": 67
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Candles

Return candlestick (K-line) data for a token.

GET

/api/v1/dex/market/candles

https://web3.binance.com/build

Get Candles › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Candles › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Candles › Query Parameters

binanceChainId

string · required

Unique chain identifier (e.g. "1"=Ethereum, "56"=BSC, "CT_501"=Solana).

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0xdac17f958d2ee523a2206206994597c13d831ec7

bar

string · enum

Candlestick time granularity, default "1m" (1 minute). Available values: 1s (1 second), 5s (5 seconds), 30s (30 seconds), 1m (1 minute), 3m (3 minutes), 5m (5 minutes), 15m (15 minutes), 30m (30 minutes), 1h (1 hour), 2h (2 hours), 4h (4 hours), 6h (6 hours), 8h (8 hours), 12h (12 hours), 1d (1 day), 3d (3 days), 1w (1 week), 1M (1 month).

Enum values:

30s

15m

30m

Example: 1m

Default: 1m

after

integer · int64

End time for the query, Unix millisecond timestamp. Returns candles earlier than this time (exclusive).

Example: 1748600000000

before

integer · int64

Start time for the query, Unix millisecond timestamp. Returns candles later than this time (exclusive).

Example: 1748000000000

limit

integer · int32

Number of candles to return. Defaults to 100.

Example: 100

Default: 100

Get Candles › Responses

Candle data returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

data

array[]

Candlestick data list. Each record contains 7 values in order: open, high, low, close, volume, timestamp (ms), tradeCount.

Example: [[1.0001,1.0023,0.9987,1.001,125000.5,1748600000000,42],[1.001,1.0035,1.0001,1.0028,187500.3,1748600060000,38]]

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

Search Token

Search tokens by symbol or contract address.

GET

/api/v1/dex/market/token/search

https://web3.binance.com/build

Search Token › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Search Token › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Search Token › Query Parameters

chains

string · required

List of chain IDs to search, comma-separated.

Example: 1,56,CT_501

search

string · required

Search keyword. Can be a token address or token symbol.

Example: USDT

Search Token › Responses

Search results returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Matching tokens.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/token/search

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/token/search?chains=%3Cstring%3E&search=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "binanceChainId": "1",
      "tokenName": "Tether USD",
      "tokenSymbol": "USDT",
      "tokenLogoUrl": "https://static.onchainos.com/tokens/usdt.png",
      "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "decimals": 6,
      "explorerUrl": "https://etherscan.io/token/0xdac17f958d2ee523a2206206994597c13d831ec7",
      "change": "-5.23",
      "holders": "45832",
      "liquidity": "1250000.50",
      "marketCap": "83500000.00",
      "price": "1.0001",
      "tagList": {
        "isRecognized": true
      }
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Token Basic Info

Return basic metadata for a token: name, symbol, logo, decimals, creator address, creation time, and tag info.

POST

/api/v1/dex/market/token/basic-info

https://web3.binance.com/build

Get Token Basic Info › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Basic Info › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Basic Info › Query Parameters

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0xdac17f958d2ee523a2206206994597c13d831ec7

Get Token Basic Info › Responses

Token basic info returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

POST/api/v1/dex/market/token/basic-info

curl --request POST \
  --url 'https://web3.binance.com/build/api/v1/dex/market/token/basic-info?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "binanceChainId": "1",
    "tokenContractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "tokenName": "Tether USD",
    "tokenSymbol": "USDT",
    "tokenLogoUrl": "https://static.onchainos.com/tokens/usdt.png",
    "decimals": 6,
    "creatorAddress": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",
    "createTime": 1716892020000,
    "tagList": {
      "isRecognized": true
    }
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Token Advanced Info

Return comprehensive metrics for a token, including creator and launch info, holding percentages by address type (smart money, KOL, sniper, bundler, fresh wallet, etc.), and token tags.

GET

/api/v1/dex/market/token/advanced-info

https://web3.binance.com/build

Get Token Advanced Info › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Advanced Info › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Advanced Info › Query Parameters

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

Get Token Advanced Info › Responses

Advanced token info returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/token/advanced-info

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/token/advanced-info?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "binanceChainId": "1",
    "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "isInternal": 0,
    "protocolId": 1,
    "progress": "75",
    "createTime": 1714000000000,
    "creatorAddress": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",
    "devCreatedTokenCount": 15,
    "devMigratedTokenCount": 8,
    "devMigratedTokenPercent": "53.5",
    "top10HoldingPercent": "40.08",
    "devHoldingPercent": "5.23",
    "smartMoneyHoldingPercent": "2.15",
    "kolHoldingPercent": "1.5",
    "bundlerHoldingPercent": "12.3",
    "proHoldingPercent": "4.2",
    "freshWalletHoldingPercent": "3.8",
    "sniperHoldingPercent": "3.1",
    "insiderHoldingPercent": "2.5",
    "holders": 45832,
    "bnHolderCount": 1203,
    "bnTraderCount7D": 250,
    "tokenTags": [
      "Alpha"
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Hot Token List

Get hot token ranking list. Supports sorting by volume, price change, market cap, etc., with filters for holding distribution, developer behavior, liquidity, and more.

GET

/api/v1/dex/market/token/hot-token

https://web3.binance.com/build

Get Hot Token List › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Hot Token List › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Hot Token List › Query Parameters

binanceChainId

string

Chain identifier. Single value only. Omit to return mixed results across all chains.

Example: 1

rankBy

integer · enum · int32

Ranking field. 1=price, 2=price change, 3=transactions, 4=volume, 5=market cap, 6=liquidity, 7=creation time, 8=holders, 9=Binance MPC wallet holders, 10=net inflow.

Enum values:

Example: 4

rankingTimeFrame

integer · enum · int32

Data time range. 1=1 min, 2=5 min, 3=1 hour, 4=4 hours, 5=24 hours. Default 1 hour.

Enum values:

Example: 3

Default: 3

priceChangePercentMin

string

Minimum price change filter. "5" means 5%.

Example: 5

priceChangePercentMax

string

Maximum price change filter. "100" means 100%.

Example: 100

volumeMin

string

Minimum volume filter, denominated in USD.

Example: 10000

volumeMax

string

Maximum volume filter, denominated in USD.

Example: 1000000

txsMin

string

Minimum transaction count.

Example: 100

txsMax

string

Maximum transaction count.

Example: 10000

marketCapMin

string

Minimum market cap filter, denominated in USD.

Example: 100000

marketCapMax

string

Maximum market cap filter, denominated in USD.

Example: 100000000

liquidityMin

string

Minimum liquidity filter, denominated in USD.

Example: 10000

liquidityMax

string

Maximum liquidity filter, denominated in USD.

Example: 10000000

devHoldingPercentMin

string

Minimum developer holding percentage filter. "5" means 5%.

Example: 0

devHoldingPercentMax

string

Maximum developer holding percentage filter. "5" means 5%.

Example: 10

inflowUsdMin

string

Minimum net inflow filter, denominated in USD.

Example: 0

inflowUsdMax

string

Maximum net inflow filter, denominated in USD.

Example: 1000000

holdersMin

string

Minimum holder count.

Example: 100

holdersMax

string

Maximum holder count.

Example: 100000

bnHolderCountMin

string

Minimum Binance MPC wallet holders.

Example: 0

bnHolderCountMax

string

Maximum Binance MPC wallet holders.

Example: 10000

top10HoldingPercentMin

string

Minimum top-10 holding percentage. "5" means 5%.

Example: 0

top10HoldingPercentMax

string

Maximum top-10 holding percentage. "5" means 5%.

Example: 100

sniperHoldingPercentMin

string

Minimum sniper holding percentage. "5" means 5%.

Example: 0

sniperHoldingPercentMax

string

Maximum sniper holding percentage. "5" means 5%.

Example: 100

smartMoneyHoldingPercentMin

string

Minimum smart-money holding percentage. "5" means 5%.

Example: 0

smartMoneyHoldingPercentMax

string

Maximum smart-money holding percentage. "5" means 5%.

Example: 100

kolHoldingPercentMin

string

Minimum KOL holding percentage. "5" means 5%.

Example: 0

kolHoldingPercentMax

string

Maximum KOL holding percentage. "5" means 5%.

Example: 100

proHoldingPercentMin

string

Minimum pro-trader holding percentage. "5" means 5%.

Example: 0

proHoldingPercentMax

string

Maximum pro-trader holding percentage. "5" means 5%.

Example: 100

freshWalletHoldingPercentMin

string

Minimum fresh-wallet holding percentage. "5" means 5%.

Example: 0

freshWalletHoldingPercentMax

string

Maximum fresh-wallet holding percentage. "5" means 5%.

Example: 100

insiderHoldingPercentMin

string

Minimum insider holding percentage. "5" means 5%.

Example: 0

insiderHoldingPercentMax

string

Maximum insider holding percentage. "5" means 5%.

Example: 100

bundlerHoldingPercentMin

string

Minimum bundler holding percentage. "5" means 5%.

Example: 0

bundlerHoldingPercentMax

string

Maximum bundler holding percentage. "5" means 5%.

Example: 100

devCreatedTokenCountMin

string

Minimum developer-created token count.

Example: 0

devCreatedTokenCountMax

string

Maximum developer-created token count.

Example: 100

devMigratedTokenCountMin

string

Minimum developer-migrated token count.

Example: 0

devMigratedTokenCountMax

string

Maximum developer-migrated token count.

Example: 100

devMigratedTokenPercentMin

string

Minimum developer-migrated token percentage. "5" means 5%.

Example: 0

devMigratedTokenPercentMax

string

Maximum developer-migrated token percentage. "5" means 5%.

Example: 100

isDevSoldAll

boolean

When set to true, returns only tokens where the developer has sold all holdings. Not filtered when omitted or false.

Example: false

isDevBurned

boolean

When set to true, returns only tokens where the developer has burned tokens. Not filtered when omitted or false.

Example: false

isMint

boolean

When set to true, excludes tokens with minting capability. Default false.

Example: false

Default: false

isFreeze

boolean

When set to true, excludes tokens with freeze capability. Default false.

Example: false

Default: false

isHideWashTradingTokens

boolean

When set to true, excludes tokens with wash trading behavior. Default true.

Example: true

Default: true

isHideDevWashTradingTokens

boolean

When set to true, excludes tokens where the developer has wash trading behavior. Default true.

Example: true

Default: true

isHideInternalWashTradingTokens

boolean

When set to true, excludes tokens where insiders have wash trading behavior. Default true.

Example: true

Default: true

pageId

integer · int32

Pagination identifier. Do not pass on the first request; pass the page value from the previous response to get the next page.

Example: 1

Default: 1

size

integer · int32 · max: 100

Page size. Maximum 100. Defaults to 100.

Example: 100

Default: 100

Get Hot Token List › Responses

Hot token list returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/token/hot-token

curl --request GET \
  --url https://web3.binance.com/build/api/v1/dex/market/token/hot-token \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "page": 1,
    "items": [
      {
        "binanceChainId": "1",
        "tokenSymbol": "PEPE",
        "tokenLogoUrl": "https://static.onchainos.com/tokens/pepe.png",
        "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "marketCap": "5830000.50",
        "volume": "1250000.30",
        "change": "12.5",
        "uniqueTraders": "2341",
        "buyTxs": "1523",
        "sellTxs": "987",
        "txs": "2510",
        "liquidity": "680000.00",
        "price": "0.00000702",
        "holders": "45832",
        "inflowUsd": "125000.50",
        "devHoldingPercent": "5.5",
        "bnHolderCount": "1203",
        "top10HoldingPercent": "35.2",
        "sniperHoldingPercent": "8.3",
        "proHoldingPercent": "12.1",
        "freshWalletHoldingPercent": "3.5",
        "smartMoneyHoldingPercent": "1.52",
        "kolHoldingPercent": "6.5",
        "insiderHoldingPercent": "2.8",
        "bundlerHoldingPercent": "6.2",
        "devCreatedTokenCount": "3",
        "devMigratedTokenCount": "1",
        "devMigratedTokenPercent": "33.3",
        "tokenTags": [
          "Alpha"
        ]
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Holders Ranking

Return the holders ranking list for a token, including holding amount, holding percentage, native-token balance, average buy/sell price, realized PnL, and funding source. Up to 100 records. Pagination is not supported.

GET

/api/v1/dex/market/token/holder

https://web3.binance.com/build

Get Holders Ranking › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Holders Ranking › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Holders Ranking › Query Parameters

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

tagFilter

integer · enum · int32

Address tag filter, single selection only. Returns all holder addresses (by holding amount descending) when omitted; returns addresses matching the specified tag when provided. Mapping: 1=KOL, 2=Developer, 3=Smart Money, 4=Insider, 5=Sniper, 6=Bundler.

Enum values:

Example: 1

Get Holders Ranking › Responses

Holders ranking returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Holder list.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/token/holder

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/token/holder?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "holderWalletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
      "holdAmount": "18580000",
      "holdingPercent": "5.23",
      "nativeTokenSymbol": "ETH",
      "nativeTokenBalance": "12.5",
      "boughtAmount": "18580000",
      "avgBuyPrice": "0.000105",
      "soldAmount": "15000000",
      "avgSellPrice": "0.000195",
      "maxHoldAmount": "30000000",
      "lastTradeTime": 1716892020000,
      "realizedPnlUsd": "1277.84",
      "fundingSource": "0x28c6c06298d514db089934071355e5743bf21d60",
      "fundingSourceLabel": {
        "tagName": "cex",
        "tagValue": "Binance"
      },
      "fundingSourceHash": "0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
      "fundingSourceTime": 1714000000000,
      "fundingSourceAmount": "0.5"
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Top Traders

Return the top profit-making addresses for a token, ranked by realized PnL descending. Includes holding amount, average buy/sell price, realized PnL, and funding source. Up to 100 records. Pagination is not supported.

GET

/api/v1/dex/market/token/top-trader

https://web3.binance.com/build

Get Top Traders › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Top Traders › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Top Traders › Query Parameters

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

tagFilter

integer · enum · int32

Address tag filter, single selection only. Returns all top profit addresses (by realized PnL descending) when omitted; returns addresses matching the specified tag when provided. Mapping: 1=KOL, 2=Developer, 3=Smart Money, 4=Insider, 5=Sniper, 6=Bundler, 7=Whale Holder.

Enum values:

Example: 1

Get Top Traders › Responses

Top traders returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Top profit-making address list.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/token/top-trader

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/token/top-trader?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "holderWalletAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
      "holdAmount": "18580000",
      "holdingPercent": "3.5",
      "boughtAmount": "25000000",
      "avgBuyPrice": "0.000105",
      "soldAmount": "20000000",
      "avgSellPrice": "0.000195",
      "maxHoldAmount": "30000000",
      "lastTradeTime": 1716892020000,
      "realizedPnlUsd": "1800.30",
      "fundingSource": "0x21a31ee1afc51d94c2efccaa2092ad1028285549",
      "fundingSourceLabel": {
        "tagName": "cex",
        "tagValue": "Binance"
      },
      "fundingSourceHash": "0x3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
      "fundingSourceTime": 1714000000000,
      "fundingSourceAmount": "0.5"
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Top Liquidity Pools

Return the top liquidity pools for a token, including pool name, protocol, liquidity in USD, pool address, and per-token composition.

GET

/api/v1/dex/market/token/top-liquidity

https://web3.binance.com/build

Get Top Liquidity Pools › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Top Liquidity Pools › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Top Liquidity Pools › Query Parameters

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

Get Top Liquidity Pools › Responses

Top liquidity pools returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object[]

Liquidity pool list.

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/token/top-liquidity

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/token/top-liquidity?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "pool": "PEPE/WETH",
      "protocolName": "Uniswap V3",
      "protocolLogoUrl": "https://static.onchainos.com/protocols/uniswap.png",
      "liquidityUsd": "680000.00",
      "poolAddress": "0x11950d141ecb863f01007add7d1a342041227b58",
      "liquidityAmount": [
        {
          "tokenAmount": "1500000000",
          "tokenSymbol": "PEPE",
          "tokenName": "Pepe",
          "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
          "tokenLogoUrl": "https://static.onchainos.com/tokens/pepe.png"
        }
      ]
    }
  ],
  "timestamp": 1748601600000,
  "success": true
}

json

application/json

Get Token Trades

Return on-chain trade history for a token. Supports tag filtering and wallet address filtering.

GET

/api/v1/dex/market/trades

https://web3.binance.com/build

Get Token Trades › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get Token Trades › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get Token Trades › Query Parameters

binanceChainId

string · required

Unique chain identifier.

Example: 1

tokenContractAddress

string · required

Token contract address.

Example: 0x6982508145454ce325ddbe47a25d4ec3d2311933

cursor

string

Pagination cursor. Do not pass on the first request; pass the cursor value from the previous response to get the next page.

Example: eyJ0aW1lIjoxNzQ4NjAwMDAwMDAwLCJpZCI6MTIzfQ==

limit

integer · int32 · min: 1 · max: 500

Number of results per page, maximum 500, defaults to 100.

Example: 100

Default: 100

tagFilter

integer · enum · int32

Address tag filter, single selection only. Returns all trades with pagination when omitted; returns only the latest 100 trades for the specified tag's addresses when provided (cursor and limit are ignored). Mapping: 1=KOL, 2=Developer, 3=Smart Money, 4=Insider, 5=Sniper, 6=Bundler, 7=Whale Holder.

Enum values:

Example: 1

walletAddressFilter

string

Filter by specific wallet addresses. Separate multiple addresses with commas. Up to 2 addresses.

Example: 0x28c6c06298d514db089934071355e5743bf21d60

Get Token Trades › Responses

Trade history returned successfully.

code

integer · int32

Example: 0

msg

string

Example: success

object

timestamp

integer · int64

Example: 1748601600000

success

boolean

Example: true

GET/api/v1/dex/market/trades

curl --request GET \
  --url 'https://web3.binance.com/build/api/v1/dex/market/trades?binanceChainId=%3Cstring%3E&tokenContractAddress=%3Cstring%3E' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>'

Example Responses

{
  "code": 0,
  "msg": "success",
  "data": {
    "cursor": "eyJ0aW1lIjoxNzQ4NTk5MDAwMDAwLCJpZCI6Nzh9",
    "trades": [
      {
        "binanceChainId": "1",
        "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "txHash": "0xabc123def4567890abc123def4567890abc123def4567890abc123def4567890",
        "userAddress": "0x28c6c06298d514db089934071355e5743bf21d60",
        "dexName": "Uniswap V3",
        "type": "buy",
        "price": "0.00000702",
        "volume": "1500.50",
        "time": 1748601600000,
        "changedTokenInfo": [
          {
            "amount": "1500000",
            "tokenSymbol": "PEPE",
            "tokenContractAddress": "0x6982508145454ce325ddbe47a25d4ec3d2311933"
          }
        ]
      }
    ]
  },
  "timestamp": 1748601600000,
  "success": true
}

json

application/json