Get Latest Signal List#
Retrieve the latest buy-direction token signal list on a specified chain, sorted in descending order by time.
Request URL#
POST https://web3.okx.com/api/v6/dex/market/signal/list
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| chainIndex | String | Yes | Unique identifier of the chain. Pass the chain ID (e.g., 1: Ethereum). Only single-chain queries are supported. |
| walletType | String | No | Wallet type code. Enum: 1 = Smart Money, 2 = KOL / Influencer, 3 = Whales. Multiple values supported, separated by commas. |
| minAmountUsd | String | No | Minimum total transaction amount (USD) for the selected wallet type(s). |
| maxAmountUsd | String | No | Maximum total transaction amount (USD) for the selected wallet type(s). |
| minAddressCount | String | No | Minimum number of addresses of the selected wallet type that triggered the signal. |
| maxAddressCount | String | No | Maximum number of addresses of the selected wallet type that triggered the signal. |
| tokenAddress | String | No | Token contract address. If provided, query the specified token; if not, return a filtered list within constraints. |
| minMarketCapUsd | String | No | Minimum market cap (USD) of the token when the signal was triggered. |
| maxMarketCapUsd | String | No | Maximum market cap (USD) of the token when the signal was triggered. |
| minLiquidityUsd | String | No | Minimum liquidity (USD) of the token when the signal was triggered. |
| maxLiquidityUsd | String | No | Maximum liquidity (USD) of the token when the signal was triggered. |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| timestamp | String | Timestamp when the signal was triggered. |
| chainIndex | String | Unique identifier of the chain. |
| token | Object | Token information. |
| >tokenAddress | String | Token address. |
| >symbol | String | Token symbol. |
| >name | String | Token name. |
| >logo | String | Token logo. |
| >marketCapUsd | String | Market cap in USD. |
| >holders | String | Number of holder addresses. |
| >top10HolderPercent | String | Top 10 holder percentage. |
| price | String | Token price in USD when the signal was triggered. |
| walletType | String | Wallet type. Enum: SMART_MONEY / WHALE / INFLUENCER. |
| triggerWalletCount | String | Number of triggering wallet addresses. |
| triggerWalletAddress | String | List of triggering wallet addresses, separated by commas. |
| amountUsd | String | Transaction amount in USD. |
| soldRatioPercent | String | Sold percentage. |
Request Example#
Shell
curl --location --request POST 'https://web3.okx.com/api/v6/dex/market/signal/list' \
--header 'Content-Type: application/json' \
--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' \
--data-raw '[
{
"chainIndex": "501",
"walletType": "1,2,3",
"minAmountUsd": "1000",
"maxAmountUsd": "500000",
"minAddressCount": "2",
"maxAddressCount": "50",
"tokenAddress": "",
"minMarketCapUsd": "168564",
"maxMarketCapUsd": "",
"minLiquidityUsd": "333",
"maxLiquidityUsd": ""
}
]'
Response Example#
Json
{
"code": "0",
"data": [
{
"amountUsd": "8967.931586152583612904",
"chainIndex": "501",
"price": "0.00041028240641149",
"soldRatioPercent": "0.5603",
"timestamp": "1772547560679",
"token": {
"holders": "1363",
"logo": "https://static.oklink.com/cdn/web3/currency/token/pre/large/501-7AVtDPrxKexrJ4gLLSfdTjeqeeN1DcxLW8wLBj4dpump-107/type=webp_90_0?v=1772453340935",
"marketCapUsd": "135093.893009664330998981",
"name": "サナエ・トークン",
"symbol": "SANAE",
"tokenAddress": "7AVtDPrxKexrJ4gLLSfdTjeqeeN1DcxLW8wLBj4dpump",
"top10HolderPercent": "18.9985"
},
"triggerWalletAddress": "4cXnf2z85UiZ5cyKsPMEULq1yufAtpkatmX4j4DBZqj2,ARSdp5MFL1bjgWddK8dkF3QdttHvy5ZdVjJ6T8BHJimo,6S8GezkxYUfZy9JPtYnanbcZTMB87Wjt1qx3c6ELajKC",
"triggerWalletCount": "3",
"walletType": "2"
},
{
"amountUsd": "2046.227228624210517822",
"chainIndex": "501",
"price": "0.000920251372217055",
"soldRatioPercent": "0.5966",
"timestamp": "1772542533476",
"token": {
"holders": "8547",
"logo": "https://static.oklink.com/cdn/web3/currency/token/default-logo/token_custom_logo_default_G/type=default_350_0",
"marketCapUsd": "1146247.308547961026108816",
"name": "Goyim",
"symbol": "Goyim",
"tokenAddress": "9S8edqWxoWz5LYLnxWUmWBJnePg35WfdYQp7HQkUpump",
"top10HolderPercentage": "14.0299"
},
"triggerWalletAddress": "HPcJJzsBe4jgid7YYPm7wL2qoHPhUh88ur3zuqSf8nQW,2yrkWNrVFNWRPn5CdZaFnMj8razVMGeEB5aJLu92VqiL,GAmk8dHPcYnfuRKszhNFMLgfh6wzcQ1QSH62kkpm25xy,HfLyhwHUbu1gtLbJKRuiUYQaoaeeNB4jTLcDP5pUa6zc",
"triggerWalletCount": "4",
"walletType": "3"
},
],
"msg": ""
}