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. |
| cursor | String | No | Pagination cursor, pass the cursor value returned from the previous request |
| limit | String | No | Number of records per page, max 100 |
Response Parameters#
| Parameter | Type | Description |
|---|---|---|
| timestamp | String | Timestamp when the signal was triggered. |
| cursor | String | Pagination cursor |
| 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": "669.455417761799554132",
"chainIndex": "501",
"price": "0.000122496972899498",
"soldRatioPercent": "64.29",
"timestamp": "1774364940575",
"token": {
"holders": "445",
"logo": "https://static.oklink.com/cdn/web3/currency/token/pre/large/501-FN9ZSeNDdPV6bBF9DeDYxvqYK4JvFKeF7DBrhGGXJZ3Q-109/type=webp_90_0?v=1774292374274",
"marketCapUsd": "64466.670905193533007211",
"name": "Van Cleef Memes",
"symbol": "VanCleef",
"tokenAddress": "FN9ZSeNDdPV6bBF9DeDYxvqYK4JvFKeF7DBrhGGXJZ3Q",
"top10HolderPercent": "17.9547"
},
"triggerWalletAddress": "5jds1qi6nYu2JTZv5YTczPwyaq1RAkNkjbpsma8xSTem,4YzpSZpxDdjNf3unjkCtdWEsz2FL5mok7e5XQaDNqry8,F8sHTSpZpoNB7H2JUZ7tmMb2YWRM1pXiHPuubHVRDSsB",
"triggerWalletCount": "3",
"walletType": "2",
"cursor": "1774364940575!@#123"
},
{
"amountUsd": "1912.742277985131470193",
"chainIndex": "501",
"price": "0.000043905847119596",
"soldRatioPercent": "74.73",
"timestamp": "1774350239648",
"token": {
"holders": "1112",
"logo": "https://static.oklink.com/cdn/web3/currency/token/pre/large/501-AytNmHWe8uXfgBACLnvhyKWrecAcYFywLK2nXbegpump-109/type=webp_90_0?v=1774359780606",
"marketCapUsd": "127139.702497190490981742",
"name": "The Sandwich Heist",
"symbol": "Sandwich",
"tokenAddress": "AytNmHWe8uXfgBACLnvhyKWrecAcYFywLK2nXbegpump",
"top10HolderPercent": "18.4131"
},
"triggerWalletAddress": "As7HjL7dzzvbRbaD3WCun47robib2kmAKRXMvjHkSMB5,719sfKUjiMThumTt2u39VMGn612BZyCcwbM5Pe8SqFYz,3L8RAxLkvwkz4CgHivaVRtq19741FAdGLk5DgjRfc1fW,9FNz4MjPUmnJqTf6yEDbL1D4SsHVh7uA8zRHhR5K138r,FRbUNvGxYNC1eFngpn7AD3f14aKKTJVC6zSMtvj2dyCS,6iM1Ljh8zkY9Vxw6VqHmm9HJ3axD4f9yYpXnSCi22hvY",
"triggerWalletCount": "6",
"walletType": "2",
"cursor": "1774350239648!@#123" // pass this for next pagination
}
]
}