Get NFTs by token ID hashes

GEThttps://mainnet-aptos-api.moralis.io/nfts

Get one or many NFTs by token ID hash. Learn more about token ID hashes here.

QUERY PARAMS

token_idsarrayrequired

The identifiers of the tokens to get

Responses

200 array

collection_data_id_hashstringrequired

The identifier of the collection

collection_namestringrequired

The name of the collection

creator_addressstringrequired

The address of the creator of the collection

default_propertiesrequired

The default properties of the token

descriptionstringrequired

The description of the collection

description_mutablebooleanrequired

Whether the description can be changed

largest_property_versionstringrequired

largest_property_version

last_transaction_timestampstringrequired

The timestamp of the last transaction returned in milliseconds

last_transaction_versionstringrequired

The version of the last transaction

maximumstringrequired

The maximum number of tokens that can be minted

maximum_mutablebooleanrequired

Whether the maximum number of tokens can be changed

metadata_uristringrequired

The URI of the image of the token

namestringrequired

The name of the token

payee_addressstringrequired

The address that last payed for the token

properties_mutablebooleanrequired

Whether the properties of the token can be changed

royalty_mutablebooleanrequired

Whether the royalty of the token can be changed

royalty_points_denominatorstringrequired

The denominator for royalty points

royalty_points_numeratorstringrequired

The numerator for royalty points

supplystringrequired

The number of tokens minted

token_data_id_hashstringrequired

The identifier of the token

uri_mutablebooleanrequired

Whether the URI of the image can be changed

API KEY

Node.js

import Moralis from 'moralis';

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

  const response = await Moralis.AptosApi.nfts.getNFTsByIds({
    "network": "mainnet"
  });

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

Python

from moralis import aptos_api

api_key = "YOUR_API_KEY"

params = {
  "network": "mainnet"
}

result = aptos_api.nfts.get_nfts_by_ids(
  api_key=api_key,
  params=params,
)

print(result)

cURL

curl --request GET \
     --url 'https://mainnet-aptos-api.moralis.io/nfts' \
     --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/nfts"

  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/nfts', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 400

[
  {
    "collection_data_id_hash": "6993fb8b5688d392a2d94127b9926519d6327e69f2bcf3dc0c5df2c060aec97d",
    "collection_name": "Topaz Troopers",
    "creator_address": "0x9125e4054d884fdc7296b66e12c0d63a7baa0d88c77e8e784987c0a967c670ac",
    "description": "A badge which proves you are an OG #TopazTrooper.",
    "description_mutable": "false",
    "largest_property_version": "1",
    "last_transaction_timestamp": "2022-09-17T22:03:32.000000Z",
    "last_transaction_version": "210373856",
    "maximum": "18446744073709551615",
    "maximum_mutable": "false",
    "metadata_uri": "https://static-cdn.risewallet.io/nft/aptos-monkeys/1572.jpeg",
    "name": "Souffl3 Testnet NFT",
    "payee_address": "0x0b11e89a399fa11c802099024498da9fc6512bd3d2d3068f0e78320bd6243990",
    "properties_mutable": "false",
    "royalty_mutable": "false",
    "royalty_points_denominator": "100",
    "royalty_points_numerator": "20",
    "supply": "32976",
    "token_data_id_hash": "1824178d98256f40046db3db8cf462f1c0a8e0d37304218044f11e69761c88e1",
    "uri_mutable": "false"
  }
]