Get Coins by name

🚨Aptos: Confirmed Deprecation (60 Days Notice)

Aptos mainnet and testnet will be discontinued on November 22nd, in line with the network’s deprecation of their v1 Indexers. We recommend exploring alternative providers, which you can find at Aptos APIs.

GEThttps://mainnet-aptos-api.moralis.io/coins/names

Get Coins by searching coin name using from_name or to_name, or combine both to return coins within a range (e.g. all coins from_name "A" to to_name "D" will return all coins from A to D). Returns all coins in A-Z order if from_name or to_name is not specified.

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

from_namestring

The name of the coin to start from (inclusive and case sensitive)

to_namestring

The name of the coin to end at (inclusive and case sensitive)

Responses

API KEY

Node.js

import Moralis from 'moralis';

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

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

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

Python

from moralis import aptos_api

api_key = "YOUR_API_KEY"

params = {
  "limit": 5,
  "network": "mainnet"
}

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

print(result)

cURL

curl --request GET \
     --url 'https://mainnet-aptos-api.moralis.io/coins/names?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/names?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/names?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": {
    "coin_type": "T0xa911c7236486be921f6cc9227b09afe4a4ad14d291ba1bb8a9b7c4d628759de::gegg::GEGG",
    "coin_type_hash": "6993fb8b5688d392a2d94127b9926519d6327e69f2bcf3dc0c5df2c060aec97d",
    "creator_address": "0x9125e4054d884fdc7296b66e12c0d63a7baa0d88c77e8e784987c0a967c670ac",
    "decimals": 8,
    "name": "GEGG Coin",
    "supply_aggregator_table_handle": "0x3::token::TokenStore",
    "supply_aggregator_table_key": "0x3::token::TokenStore",
    "symbol": "GEGG",
    "transaction_created_timestamp": "2022-09-17T22:03:32.000000Z",
    "transaction_version_created": "210373856"
  }
}