The NFTScan API SDK is a JavaScript
/ TypeScript
library which provides convenience and quick access to the NFTScan's APIs, it helps developers build new experiences retrieving NFTs and data analysis. We provide a set of endpoints that enable you to fetch ERC721 and ERC1155 NFT assets as well as transactions, collections, marketplace statistics and more.
To use our APIs, You need to register an account on NFTScan open platform OpenAPI Platform and get your API-KEY
for making calls to API services.
The daily request limit for a single account is 10,000 general calls. If you have more needs, please upgrade your API plans to OpenAPI Pricing to enhance the number of calls and obtain access to the PRO interfaces.
The SDK currently supports the following chains:
Blockchain | Domain name | Short name |
---|---|---|
Ethereum | restapi.nftscan.com | eth |
BNB chain | bnbapi.nftscan.com | bnb |
Polygon | polygonapi.nftscan.com | polygon |
Moonbeam | moonbeamapi.nftscan.com | moonbeam |
Arbitrum | arbitrumapi.nftscan.com | arbitrum |
Optimism | optimismapi.nftscan.com | optimism |
PlatON | platonapi.nftscan.com | platon |
Avalanche | avaxapi.nftscan.com | avalanche |
Solana | solanaapi.nftscan.com | solana |
Cronos | cronosapi.nftscan.com | cronos |
The value of Short name is used in the SDK as an initialization configuration parameter.
via npm
:
npm install nftscan-api
or yarn
:
yarn add nftscan-api
Then you can import and use the SDK:
import { ErcType, EvmChain, NftscanEvm } from "nftscan-api";
const config = {
apiKey: "<YOUR_API_KEY>", // Replace with your NFTScan API key.
chain: EvmChain.ETH, // Replace with your chain.
};
const evm = new NftscanEvm(config);
The new NftscanEvm()
returns an object that can query the EVM-like chain, for here it is EvmChain.ETH
, which stand for the Ethereum blockchain.
The complete enumeration value of EvmChain
includes the following:
export enum EvmChain {
ETH = 'eth',
BNB = 'bnb',
ARBITRUM = 'arbitrum',
MOONBEAM = 'moonbeam',
POLYGON = 'polygon',
OPTIMISM = 'optimism',
PLATON = 'platon',
AVALANCHE = 'avalanche',
CRONOS = 'cronos',
}
And then you can use the object evm
to access to the NFTScan API, form example getAssetsByAccount
, which can retrieve the assets owned by an account.
const accountAddress = "<ACCOUNT_ADDRESS>"; // Replace with the account address you want to query.
// Access asset-related APIs
evm.asset
// Retrieve assets owned by an account.
.getAssetsByAccount(accountAddress, {
erc_type: ErcType.ERC_721, // Can be erc721 or erc1155
})
.then((res) => console.log(res));
// Access transaction-related APIs
evm.transaction
// Retrieve transactions by an account
.getTransactionsByAccount(accountAddress)
.then((res) => console.log(res));
Not only asset
and transaction
, but the NftscanEvm
also provides several other objects, for example collection
\ statistic
\ other
, these objects provide different types of APIs.
To query the other EVM-like chain's asset, for example 'Arbitrum', changing the config param chain
to EvmChain.ARBITRUM
:
const evm = new NftscanEvm({
apiKey: "<YOUR_API_KEY>",
chain: EvmChain.ARBITRUM,
});
We also support the Solana blockchain, to access the API, you just need to use new NftscanSolana()
to get an object.
const sol = new NftscanSolana({ apiKey: "<YOUR_API_KEY>" });
sol.asset
.getAssetsByAccount("<ACCOUNT_ADDRESS>")
.then((res) => console.log(res));
In general, NFTScan's API that supports pagination will uses the query params cursor
as the paging parameter, The return data of the API call will contain the attribute next
, you can pass in the next
value to the next call.
For example:
let nextCursor = "";
const { content, next } = await evm.asset.getAccountMinted("<ACCOUNT_ADDRESS>", {
cursor: nextCursor, // A cursor to retrieve the next page
limit: 20, // Page size
});
// update the nextCursor
nextCursor = next;
The SDK currently supports all of the NFTScan API endpoints, The distribution of the API is consistent with the NFTScan API.
As follows:
-
-
getAssetsByAccount()
: Retrieve assets owned by an account.getAllAssets()
: Retrieve all assets owned by an account group by contract address.getAccountMinted()
: Retrieve assets minted by an account.- [PRO]
getAssetsByContract()
: Retrieve assets by contract address. getAssetsByContractAndTokenId()
: Retrieve an asset by contract address and token ID.- [PRO]
getMultiChainAssets()
: Retrieve multi-chain assets owned by an account. - [PRO]
queryAssetsInBatches
: Retrieve assets by list of contract address and token ID. - [PRO]
queryAssetsByFilters()
: Retrieve assets with filters. - [PRO]
queryAssetsByAttributes()
: Retrieve assets by contract address with attributes.
-
- [PRO]
getTransactionsByAccount()
: Retrieve transactions by an account. - [PRO]
getTransactionsByContract()
: Retrieve transactions by contract address. - [PRO]
getTransactionsByContractAndTokenId()
: Retrieve transactions by contract address and token ID. - [PRO]
getTransactionsByToAddress()
: Retrieve transactions by to address. - [PRO]
queryTransactionsByFilters()
: Retrieve transactions with filters. - [PRO]
queryTransactionsByTxHashList()
: Retrieve transactions by the list of transaction hash.
- [PRO]
-
- [PRO]
getCollectionsByContract()
: Retrieve a collection by contract address. - [PRO]
getCollectionsByRanking()
: Retrieve collections by ranking. - [PRO]
queryCollectionsByFilters()
: Retrieve collections with filters. - [PRO]
queryCollectionsByAccountAddress()
: Retrieve collections by account address.
- [PRO]
-
getTradeRanking()
: Obtain trade ranking statistics.- [PRO]
getCollectionRanking()
: Obtain collection ranking statistics. - [PRO]
getCollectionTrade()
: Obtain collection trade distribution. - [PRO]
getCollectionTrending()
: Obtain collection trending statistics. - [PRO]
getAccountOverview()
: Obtain account overview statistics. - [PRO]
getBlueChipStatistics()
: Obtain blue chip statistics. getMarketplaceRanking()
: Obtain marketplace ranking statistics.getMarketCapRanking()
: Obtain market cap ranking statistics- [PRO]
getCollectionStatistics()
: Obtain collection statistics. getMintRanking()
: Obtain mint ranking statistics.getMintAmount()
: Obtain mint amount statistics.getTradersRanking()
: Obtain traders ranking statistics.getGasRanking()
: Obtain traders ranking statistics.getVolumeIn24h()
: Obtain 24h volume statistics.
-
getBlockNumber()
: Obtain the latest block number.- [PRO]
queryAssestAmountByAccounts()
: Obtain asset amount owned by accounts. - [PRO]
getAssetOwnerByContract()
: Obtain asset owner amount by contract address. - [PRO]
getAssetOwnerByContractAndTokenId()
: Obtain asset owner's amount by contract address and token ID. - [PRO]
refreshMetadata()
: Submit a task for refreshing NFT metadata.
-
-
-
getAssetsByAccount()
: Retrieve assets owned by an account.getAllAssets()
: Retrieve all assets owned by an account group by collection.getAccountMinted()
: Retrieve assets minted by an account.- [PRO]
getAssetsByCollection()
: Retrieve assets by collection. getAssetsByTokenAddress()
: Retrieve an asset by token address.
-
getTransactionsByAccount()
: Retrieve transactions by an account.getTransactionsByCollection()
: Retrieve transactions by collection.getTransactionsByTokenAddress()
: Retrieve transactions by token address.
-
- [PRO]
getCollection()
: Retrieve a collection. - [PRO]
queryCollectionsByFilters()
: Retrieve collections with filters.
- [PRO]
-
getTradeRanking()
: Obtain trade ranking statistics.
-