Skip to main content
GET
/
discovery
/
tokens
/
top-gainers
Get tokens with top gainers
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers \
  --header 'X-API-Key: <api-key>'
[
  {
    "chain_id": "0x1",
    "token_address": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
    "token_name": "Maker",
    "token_symbol": "MKR",
    "token_logo": "<string>",
    "price_usd": 123,
    "token_age_in_days": 123,
    "on_chain_strength_index": 123,
    "security_score": 88,
    "market_cap": 1351767630.85,
    "fully_diluted_valuation": 1363915420.28,
    "twitter_followers": 255217,
    "holders_change": {
      "1h": 14,
      "1d": 14,
      "1w": 162,
      "1M": 162
    },
    "liquidity_change_usd": {
      "1h": 14,
      "1d": 14,
      "1w": 162,
      "1M": 162
    },
    "experienced_net_buyers_change": {
      "1h": 14,
      "1d": 14,
      "1w": 162,
      "1M": 162
    },
    "volume_change_usd": {
      "1h": 14,
      "1d": 14,
      "1w": 162,
      "1M": 162
    },
    "net_volume_change_usd": {
      "1h": 14,
      "1d": 14,
      "1w": 162,
      "1M": 162
    },
    "price_percent_change_usd": {
      "1h": 14,
      "1d": 14,
      "1w": 162,
      "1M": 162
    }
  }
]
Endpoint cost: CUs. Learn more about compute units.

Authorizations

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

Query Parameters

​
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,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f,
solana
Example:

"eth"

​
min_market_cap
number

The minimum market cap in usd of a token

Example:

50000000

​
security_score
number

The minimum security score of a token

Example:

80

​
time_frame
enum<string>

The time frame used for price percent change ordering in response

Available options:
1h,
1d,
1w,
1M
Example:

"1d"

Response

200 - application/json

Returns the token details

​
chain_id
string
required

The chain id of the token

Example:

"0x1"

​
token_address
string
required

The address of the token

Example:

"0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2"

​
token_name
string | null
required

The name of the token contract

Example:

"Maker"

​
token_symbol
string | null
required

The symbol of the token

Example:

"MKR"

​
token_logo
string | null
required

The logo of the token

​
price_usd
number | null
required

The price in USD for the token

​
token_age_in_days
number | null
required

The number of days since the token was created

​
on_chain_strength_index
number | null
required

The score of coin determined by various on chain metrics

​
security_score
number | null
required

The security score (0-100) given to the token based various parameters

Example:

88

​
market_cap
number | null
required

The market cap in USD

Example:

1351767630.85

​
fully_diluted_valuation
number | null
required

The fully diluted valuation in USD

Example:

1363915420.28

​
twitter_followers
number | null
required

The number of followers of the token on twitter

Example:

255217

​
holders_change
object
required
​
liquidity_change_usd
object
required
​
experienced_net_buyers_change
object
required
​
volume_change_usd
object
required
​
net_volume_change_usd
object
required
​
price_percent_change_usd
object
required