Practical overview
When it fits
Use it when a JavaScript application needs to retrieve NFT mints or NFT information associated with a Solana wallet and the documented helper functions fit the retrieval task.
Who it is for
JavaScript developers building applications that retrieve NFT data from Solana wallets.
Documented uses
- List NFT mint addresses owned by a wallet.
- Retrieve NFT information for a mint address.
- Query a wallet’s NFTs with pagination and caching.
Requirements & limits
- The README example uses @solana/web3.js and a connection to mainnet-beta.
- The README warns that querying wallets with many NFTs can hit Solana API 429 rate limits.
- The README demonstrates sequential per-mint retrieval as an alternative to a full wallet query, alongside pagination and caching.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the package and prepare a Solana connection
Add the library to a JavaScript project and configure the connection used in the README example.
Before you start
- A JavaScript project with npm.
- The README example uses @solana/web3.js.
Steps
Install the package with the command below.
npm i --save @primenums/solana-nft-toolsCreate a connection with
new web3.Connection(web3.clusterApiUrl('mainnet-beta'), 'confirmed'), as shown in the README.
Expected outcome
The package is installed and the example’s Solana connection is prepared for use with its NFT helper functions.
Guide limitations
- The example notes that large wallet NFT collections can encounter Solana API 429 rate-limit errors.
Retrieve wallet NFT mints and metadata
Use the README’s helper-function examples to request mint addresses and NFT information for a wallet.
Before you start
- The installed @primenums/solana-nft-tools package.
- A Solana connection and wallet address.
Steps
Call
NFTs.getMintTokensByOwner(conn, walletAddr)to retrieve mint addresses owned by the wallet.Pass a mint address to
NFTs.getNFTByMintAddress(conn, mints[0])to request NFT information.For wallet NFT data, call
NFTs.getNFTsByOwner(conn, walletAddr).For a paginated query, pass page, per-page count, and cache TTL in minutes to
getNFTsByOwner, as shown in the README.
Expected outcome
The example requests wallet mint addresses, metadata for a mint, or wallet NFT data, with an option to page and cache wallet results.
Guide limitations
- The README warns that retrieving all NFTs for some wallets may trigger Solana API 429 rate-limit errors.
- The documented alternatives are to retrieve mint addresses and then request NFT data sequentially, or use pagination and caching.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- primenumsdev/solana-nft-tools · Official homepage title · retained in its source language

