Get Coin top holders

GEThttps://mainnet-aptos-api.moralis.io/coins/owners/:coin_type_hash/top-holders

Get the top holders of a coin by coin type hash.

PATH PARAMS

coin_type_hashstringrequired

The coin type hash to fetch info about

QUERY PARAMS

limitnumberrequired

The number of results to return

offsetnumber

The number of results to skip

cursorstring

The cursor to use for getting the next page

min_amountnumber

The minimum amount of coins required for a wallet to be included in the results

min_versionnumber

The minimum version on when the balance was last updated

wallet_blacklistarray

The addresses of the wallets to blacklist

No items in the array

wallet_whitelistarray

The addresses of the wallets to whitelist

No items in the array

Responses

API KEY

Node.js

import Moralis from 'moralis';

try {
  await Moralis.start({
    apiKey: "YOUR_API_KEY"
  });

  const response = await Moralis.AptosApi.coins.getTopHoldersByCoin({
    "limit": 5,
    "coinTypeHash": "91ceb1308a98389691e05158b07ed5f079ab78461a6bb8d5a4054b1bb5cb8bb6",
    "network": "mainnet"
  });

  console.log(response);
} catch (e) {
  console.error(e);
}

Python

from moralis import aptos_api

api_key = "YOUR_API_KEY"

params = {
  "limit": 5,
  "coin_type_hash": "91ceb1308a98389691e05158b07ed5f079ab78461a6bb8d5a4054b1bb5cb8bb6",
  "network": "mainnet"
}

result = aptos_api.coins.get_top_holders_by_coin(
  api_key=api_key,
  params=params,
)

print(result)

cURL

curl --request GET \
     --url 'https://mainnet-aptos-api.moralis.io/coins/owners/91ceb1308a98389691e05158b07ed5f079ab78461a6bb8d5a4054b1bb5cb8bb6/top-holders?limit=5' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Go

package main

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

func main() {

  url := "https://mainnet-aptos-api.moralis.io/coins/owners/91ceb1308a98389691e05158b07ed5f079ab78461a6bb8d5a4054b1bb5cb8bb6/top-holders?limit=5"

  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, _ := ioutil.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://mainnet-aptos-api.moralis.io/coins/owners/91ceb1308a98389691e05158b07ed5f079ab78461a6bb8d5a4054b1bb5cb8bb6/top-holders?limit=5', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 400

{
  "cursor": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhZGRyZXNzIjoiMHhkODUwOTQyZWY4ODExZjJhODY2NjkyYTYyMzAxMWJkZTUyYTQ2MmMxIiwiY2hhaW4iOiJldGgiLCJkaXNhYmxlVG90YWwiOiJ0cnVlIiwiYXBpS2V5SWQiOjM2NTg5LCJsaW1pdCI6MTAwLCJ0b3BpYzMiOiI9Om51bGwiLCJ0b19ibG9jayI6IjE0NjgxNTM3IiwicGFnZSI6MSwidG90YWwiOjAsIm9mZnNldCI6MSwidWMiOnRydWUsImlhdCI6MTY3MTk3ODQwNH0.XM9IN3wRJgWzSvQCy-K4Asgs_j8p9xTM1pY7UnHEhs4",
  "hasNextPage": true,
  "result": {
    "amount": "324933484",
    "coin_type": "T0xa911c7236486be921f6cc9227b09afe4a4ad14d291ba1bb8a9b7c4d628759de::gegg::GEGG",
    "coin_type_hash": "6993fb8b5688d392a2d94127b9926519d6327e69f2bcf3dc0c5df2c060aec97d",
    "last_transaction_timestamp": "2022-09-17T22:03:32.000000Z",
    "last_transaction_version": "210373856",
    "owner_address": "0x9125e4054d884fdc7296b66e12c0d63a7baa0d88c77e8e784987c0a967c670ac"
  }
}