Get Top Gainers Mainnet Only Premium Endpoint

💡Premium Endpoint

To use this API, you will need an API key associated with a Moralis account on the Pro plan or higher.

GEThttps://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers

Get tokens with top gainers

QUERY PARAMS

chainstring

The chain to query

ethmainnet0x1matic0x89polygonbscbinance0x38fantomftm0xfaarbitrum0xa4b1optimism0xapulsechain0x171base0x2105

min_market_capnumber

The minimum market cap in usd of a token

security_scorenumber

The minimum security score of a token

time_framestring

The time frame used for price percent change ordering in response

1h1d1w1M

Responses

200Returns the token details

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers?chain=eth&min_market_cap=50000000&security_score=80&time_frame=1d' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Node.js

// Node.js v18+ has native fetch support
// No additional dependencies required

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers?chain=eth&min_market_cap=50000000&security_score=80&time_frame=1d', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers?chain=eth&min_market_cap=50000000&security_score=80&time_frame=1d"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

Go

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers?chain=eth&min_market_cap=50000000&security_score=80&time_frame=1d"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/discovery/tokens/top-gainers?chain=eth&min_market_cap=50000000&security_score=80&time_frame=1d', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns the token details

[
  {
    "chain_id": "0x1",
    "token_address": "0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2",
    "token_name": "Maker",
    "token_symbol": "MKR",
    "token_logo": "string",
    "price_usd": 1,
    "token_age_in_days": 1,
    "on_chain_strength_index": 1,
    "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
    }
  }
]