Skip to main content
GET
/
erc20
/
{address}
/
top-gainers
Get top traders for a given ERC20 token
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/erc20/{address}/top-gainers \
  --header 'X-API-Key: <api-key>'
{
  "name": "Kylin Network",
  "symbol": "KYL",
  "decimals": 18,
  "logo": "https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png",
  "possible_spam": "false",
  "result": [
    {
      "avg_buy_price_usd": "<string>",
      "avg_cost_of_quantity_sold": "<string>",
      "avg_sell_price_usd": "<string>",
      "count_of_trades": 123,
      "realized_profit_percentage": 123,
      "realized_profit_usd": "<string>",
      "total_sold_usd": "<string>",
      "total_tokens_bought": "<string>",
      "total_tokens_sold": "<string>",
      "total_usd_invested": "<string>",
      "address": "<string>"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
address
string
required

The ERC20 token address.

Example:

"0x6982508145454ce325ddbe47a25d4ec3d2311933"

Query Parameters

​
days
string

Timeframe in days for which profitability is calculated, Options include 'all', '7', '30' default is 'all'.

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x31769,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

Response

200 - application/json

Successful response with top profitable wallets.

​
name
string
required

The name of the token contract

Example:

"Kylin Network"

​
symbol
string
required

The symbol of the NFT contract

Example:

"KYL"

​
decimals
integer
required

The number of decimals on the token

Example:

18

The logo of the token

Example:

"https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png"

​
possible_spam
boolean
required

Indicates if a contract is possibly a spam contract

Example:

"false"

​
result
object[]
required

List of top profitable wallets per token.