Get Latest DEX Trades for Multiple Addresses#
Retrieve on-chain transaction dynamics of tracked addresses. Supports filtering by dynamic type (custom grouping, platform KOL addresses, smart money addresses), trade type, volume, market cap, liquidity, chain, and more.
Request Path#
GET https://web3.okx.com/api/v6/dex/market/address-tracker/trades
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| trackerType | String | Yes | Track dynamic type. 1: smart_money, platform smart money addresses; 2: kol, platform Top 100 KOL addresses; 3: multi_address, query multiple addresses |
| walletAddress | String | No | Required when trackerType=multi_address. Can be a single address or multiple addresses separated by commas, up to 20 |
| tradeType | String | No | Trade type: 0: all (default); 1: buy; 2: sell |
| chainIndex | String | No | Chain identifier, defaults to all. Options: 501 (Solana), 1 (Ethereum), 56 (BNB Chain), 8453 (Base), 196 (X Layer) |
| minVolume | String | No | Minimum trade volume (USD) |
| maxVolume | String | No | Maximum trade volume (USD) |
| minHolders | String | No | Minimum number of holding addresses |
| minMarketCap | String | No | Minimum market cap (USD) |
| maxMarketCap | String | No | Maximum market cap (USD) |
| minLiquidity | String | No | Minimum liquidity (USD) |
| maxLiquidity | String | No | Maximum liquidity (USD) |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| trades | Array | List of transaction dynamics for tracked addresses |
| >txHash | String | Transaction hash |
| >walletAddress | String | Wallet address of the transaction |
| >quoteTokenSymbol | String | Pricing token symbol; only mainnet tokens are returned here |
| >quoteTokenAmount | String | Quantity of pricing tokens traded, indicating the amount priced in the mainnet token |
| >tokenSymbol | String | Trading token symbol |
| >tokenContractAddress | String | Trading token contract address |
| >chainIndex | String | Chain identifier where the trading token is located |
| >tokenPrice | String | Trading price of the token (USD) |
| >marketCap | String | Market cap corresponding to the token's transaction price (USD) |
| >realizedPnlUsd | String | Realized profit and loss of the trading token (USD) |
| >tradeType | String | Trade type for the token: 1: buy; 2: sell |
| >tradeTime | String | Transaction time (millisecond timestamp) |
Request Example#
Shell
curl --location --request GET 'https://web3.okx.com/api/v6/dex/market/address-tracker/trades?trackerType=1' \
--header 'OK-ACCESS-KEY: 37c541a1-****-****-****-10fe7a038418' \
--header 'OK-ACCESS-SIGN: leaV********3uw=' \
--header 'OK-ACCESS-PASSPHRASE: 1****6' \
--header 'OK-ACCESS-TIMESTAMP: 2023-10-18T12:21:41.274Z'
Response Example#
Json
{
"code": "0",
"data": {
"trades": [
{
"chainIndex": "56",
"marketCap": "6781.4431281050000000000000000000",
"quoteTokenAmount": "0.105214264768396182",
"quoteTokenSymbol": "BSC",
"realizedPnlUsd": "-28.212213718646256043110124512",
"tokenContractAddress": "0xcad59e019f06003303e56d4cc38fab0667114444",
"tokenPrice": "0.000006781443128105",
"tokenSymbol": "DoraemonToken",
"tradeTime": "1773736186000",
"tradeType": "2",
"txHash": "0x1daf1ab1c393ea5bf901f2d8efdd4a67ce1e1e0e7dfd748820e195f2398a8afd",
"walletAddress": "0xeb1222a0c07d4e62b0235d8b4b3e7e617d259be2"
}
]
},
"msg": ""
}