How one can Get an Deal with’ Token Steadiness on Solana

Once you use next-gen Web3 instruments, you possibly can effortlessly implement important options into your Solana dapps. For instance, because of the Solana API from Moralis, you may get the token stability on Solana for a particular handle with just some traces of code. So, in the event you’d prefer to bypass the cumbersome technique of coding such a characteristic from scratch, Moralis is your go-to choice! In reality, in the event you determine to make use of Moralis, you need to use the next core traces of code to get an handle’ token stability on Solana:

• First, it’s worthwhile to initialize Moralis utilizing your Web3 API key:

await Moralis.begin({
  apiKey: course of.env.MORALIS_API_KEY,
});

• Second, it’s worthwhile to make the most of the getSPL endpoint: 

const information = await Moralis.SolApi.account.getSPL({
  handle,
  community,
});

The above two snippets of code are the essence of getting addresses’ token balances on Solana the straightforward method. In fact, there’s some surrounding code that it’s worthwhile to put in place to make this characteristic operate correctly. So, in the event you want to discover ways to correctly implement the getSPL Solana Token API endpoint, comply with our lead. You possibly can watch the video on the prime or full the tutorial under, which covers a easy three-step course of to get token stability on Solana. Whichever choice you select, you’ll want your Web3 API key, which awaits you within the Moralis admin space. Due to this fact, be certain to enroll with Moralis now!

Overview

Under, you could find two main sections: “Tutorial: Get Token Steadiness on Solana with a Easy Backend Script” and “Get Any Token Steadiness on Solana with Our Instance Dapp”. The primary is our three-step tutorial demonstrating the best way to get SPL token balances with minimal fuss utilizing JavaScript, TypeScript, or Python. 

The three steps are as follows:

1. Moralis Setup – Right here, we have a look at varied instructions you need to use to arrange the Moralis SDK.
2. Get an Deal with’ SPL Token Steadiness – This part presents the parameters and their respective choices, whether or not you wish to concentrate on the mainnet or devnet. As well as, we have a look at the best way to get token stability utilizing JavaScript, TypeScript, and Python.
3. Run Your Script – On this part, you lastly get to run your script to get the token stability of a particular Solana handle.

However, the second part focuses on our instance challenge across the main endpoint. This instance challenge makes use of the identical rules as coated within the tutorial but in addition features a easy HTML frontend. The latter allows you to expertise the facility of the getSPL endpoint in your browser.  

Tutorial: Get Token Steadiness on Solana with a Easy Backend Script

Earlier than we bounce into step one of this tutorial, be certain to deal with the next conditions:

• Obtain and set up NodeJS v.14 or greater in the event you want to get a token stability on Solana with JavaScript or TypeScript. You may as well set up Python in the event you desire to work with that language.
• Set up your favourite package deal supervisor (NPM, Yarn, or PIP).
• Be sure to have a dependable code editor prepared. We desire to make use of Visible Studio Code (VSC).

With the above conditions beneath your belt, you’re prepared to leap into step one of this tutorial. 

Step 1: Moralis Setup 

Should you haven’t created your Moralis account but, do it now. A free account is all it’s worthwhile to full this tutorial and entry all Moralis API endpoints. Nonetheless, in case you are severe about your Web3 growth and want to construct dapps that simply assist numerous site visitors, it is best to get a Moralis Professional, Enterprise, or Enterprise plan.

Now that you’ve got your Moralis account prepared, you’ll be able to entry your admin space. That is the place you possibly can go to the “Web3 APIs” web page and duplicate your API key:

Observe: For now, maintain on to your API key – we’ll inform you the place to stick it within the second step.   

To make use of Moralis, you additionally want to put in the Moralis SDK. So, use one of many following instructions that match your package deal supervisor:

npm set up moralis @moralisweb3/common-sol-utils

yarn add moralis @moralisweb3/common-sol-utils

pip set up moralis

Step 2: Get an Deal with’ SPL Token Steadiness

At this level, you already know that the best strategy to get token stability on Solana is by utilizing the getSPL endpoint. As indicated within the snippet of code within the intro, this endpoint takes in two parameters: community and handle. The primary one has two choices: mainnet or devnet – the second accepts any Solana handle. So, for the sake of this tutorial, you possibly can determine to focus both on the Solana mainnet or devnet:

Observe: If you’re unfamiliar with the Solana devnet, we encourage you to make use of the hyperlink to get some expertise with this community.   

As for the Solana handle, we advocate going along with your Solana pockets handle. In fact, be happy to make use of our instance handle supplied within the upcoming scripts. Shifting ahead, we’ll stroll you thru our JavaScript and Python scripts. The TS script is fairly just like the JavaScript one. Thus, we’ll merely offer you the ultimate code. 

Observe: You possibly can discover the small print of the “getSPL” endpoint and even take it for a spin by visiting the “Get token stability by pockets” API reference web page.    

Get SPL Token Balances with JavaScript

Create a brand new “index.js” file and first import moralis and sol-utils:

const Moralis = require("moralis").default;
const { SolNetwork } = require("@moralisweb3/common-sol-utils");

Subsequent, create a runApp async operate. On the prime of it, initialize Moralis:

const runApp = async () => {
  await Moralis.begin({
    apiKey: "YOUR_API_KEY",
});

Wanting on the above code snippet, you possibly can see the YOUR_API_KEY placeholder. Be sure to exchange it with the above-obtained API key. 

Observe: When creating production-ready dapps, you wish to use a “.env” file to retailer your API key and different environmental variables. In that case, you exchange the above apiKey line with apiKey: course of.env.MORALIS_API_KEY. You possibly can study extra about that within the video on the prime (3:00). 

Inside runApp, you additionally have to outline the handle and community parameters:

const handle = "BWeBmN8zYDXgx2tnGj72cA533GZEWAVeqR9Eu29txaen";

const community = SolNetwork.MAINNET;

Be at liberty to exchange the above handle with any Solana handle you need. Additionally, you possibly can exchange MAINNET with DEVNET in the event you want to concentrate on the latter. By doing so, you possibly can count on transactions of free testnet property that you just get to acquire from a vetted Solana testnet faucet. 

Lastly, you get to implement the Moralis.SolApi.account.getSPL methodology from the intro. Under the tactic, you additionally have to console-log the response in JSON format and run the runApp operate:

const response = await Moralis.SolApi.account.getSPL({
  handle,
  community,
});

console.log(response.toJSON());
};

runApp();

So, that is the whole JS script that allows you to get token stability on Solana:

const Moralis = require("moralis").default;
const { SolNetwork } = require("@moralisweb3/common-sol-utils");

const runApp = async () => {
  await Moralis.begin({
    apiKey: "YOUR_API_KEY",
  });

  const handle = "BWeBmN8zYDXgx2tnGj72cA533GZEWAVeqR9Eu29txaen";

  const community = SolNetwork.MAINNET;

  const response = await Moralis.SolApi.account.getSPL({
    handle,
    community,
  });

  console.log(response.toJSON());
};

runApp();

Get SPL Token Balances with TypeScript

The next is the whole TypeScript model of the above script (the one distinction is the way it imports Moralis [the top two lines]). So, paste it in a brand new “index.ts” script:

import Moralis from "moralis";
import { SolNetwork } from "@moralisweb3/common-sol-utils";

const runApp = async () => {
  await Moralis.begin({
    apiKey: "YOUR_API_KEY",
  });

  const handle = "BWeBmN8zYDXgx2tnGj72cA533GZEWAVeqR9Eu29txaen";

  const community = SolNetwork.MAINNET;

  const response = await Moralis.SolApi.account.getSPL({
    handle,
    community,
  });

  console.log(response.toJSON());
};

runApp();

Get SPL Token Balances with Python

Should you determine to make use of Python to get token balances on Solana, create a brand new “index.py” file and begin by importing Moralis:

from moralis import sol_api

Subsequent, outline the api_key variable and the 2 endpoint parameters:

api_key = "YOUR_API_KEY"
params = {
    "community": "mainnet",
    "handle": "BWeBmN8zYDXgx2tnGj72cA533GZEWAVeqR9Eu29txaen",
}

Lastly, you name the sol_api.account.get_spl methodology and assign it to outcomes. Plus, you wish to return the outcomes:

end result = sol_api.account.get_spl(
    api_key=api_key,
    params=params,
)

print(end result)

That is the Python script that you just get in the event you put all the above snippets of code collectively:

from moralis import sol_api

api_key = "YOUR_API_KEY"
params = {
    "community": "mainnet",
    "handle": "BWeBmN8zYDXgx2tnGj72cA533GZEWAVeqR9Eu29txaen",
}

end result = sol_api.account.get_spl(
    api_key=api_key,
    params=params,
)

print(end result)

Step 3: Run Your Script

At this level, it is best to have one of many above scripts in place. As such, it’s time to run your script and get token stability on Solana for the handle you used. So, relying on the programming language, use the matching command:

node index.js

ts-node index.ts

python index.py

After operating one of many above instructions, have a look at your terminal for the response. Right here’s the JSON response for our instance handle on the Solana mainnet:

[
  {
    "associatedTokenAddress": "Dpmpwm93Amvj4uEFpYhjv8ZzfpgARq6zxKTi6mrj97gW",
    "mint": "BXWuzb3jEuGsGUe29xdApu8Z3jVgrFbr3wWdsZmLWYk9",
    "amountRaw": "100000000000",
    "amount": "100",
    "decimals": "9"
  }
]

Get Any Token Steadiness on Solana with Our Instance Dapp

The above screenshot demonstrates our instance dapp’s frontend, having an identical backend because the one introduced above. You possibly can see that our frontend has an enter discipline the place customers get to stick any Solana pockets handle. It additionally permits customers to decide on whether or not they wish to concentrate on the Solana mainnet or devnet. With an handle in place and a community chosen – in the event you bear in mind from the above tutorial are the 2 parameters that the getSPL endpoint takes as inputs – customers get to click on on the “Get Token Steadiness” button to view the outcomes:

Wanting on the above picture, you possibly can see that outcomes are available the identical format as within the above tutorial. As such, they embody the next 5 particulars:

• associatedTokenAddress – A document within the Solana ledger that both holds information or is an executable program (e.g., Solana good contract) for the token in query.
• mint – An handle that shops the metadata of a token. 
• amountRaw – The quantity of the related tokens with decimal locations included. 
• quantity – The quantity of tokens excluding the decimal locations.
• decimals – The variety of decimal locations. 

Observe: The getSPL endpoint additionally returns the token identify and image if these particulars are supplied.

To higher perceive the above outcomes, let’s use Solana Explorer to seek for the associatedTokenAddress of the above instance’s prime end result:

As you possibly can see, it is a Solana on-chain account, and its proprietor handle is the pockets handle we entered within the search discipline within the above instance. You additionally see that this account offers particulars concerning the variety of tokens. To entry the token’s metadata, we have to use the mint handle:

So, primarily based on the response of the getSPL endpoint, you possibly can entry a variety of particulars.

Construct Your Personal Occasion of Our Instance Dapp and Extra

Should you want to create your individual occasion of the above-presented dapp and take it for a spin your self, entry the “solana-api-demo” GitHub repo. Then, you’ll simply cowl the three core points of making our instance dapp:

1. Acquiring your Moralis Web3 API key and utilizing it to initialize Moralis.
2. Utilizing the getSPL endpoint to fetch the newest on-chain information quick.
3. Outline an API route within the backend and name the API route on the frontend.

On the above-linked repo, you’ll discover all of the frontend and backend scripts enabling you to get token stability on Solana in minutes. In terms of the backend, you possibly can select between the Solana Python API and NodeJS. Plus, the scripts there embody all different Moralis Solana API endpoints – you could find them listed under: 

• NFT API:
  • Get NFTs by pockets
  • Get NFT metadata
• Token API:
• Steadiness API:
  • Get native stability, token stability, and portfolio by pockets

With the above set of Solana API endpoints, you possibly can construct all kinds of dapps on this fashionable community. A number of the commonest use circumstances embody NFT marketplaces, crypto wallets, portfolio trackers, auditing and reporting, metaverse gaming, block explorers, token gating (NFT authentication), and so on.

How one can Get an Deal with’ Token Steadiness on Solana – Abstract

In at this time’s article, we targeted on the getSPL endpoint, enabling you to get token stability on Solana with minimal effort. By following the three-step course of in our beginner-friendly tutorial, you have been in a position to create a easy backend script. Whichever programming languages you targeted on, you needed to receive your Moralis Web3 API key, which is your ticket to straightforward Web3 growth. Along with the tutorial, we additionally confirmed you our neat demo dapp. We even supplied you with the hyperlink to our repo as a way to simply create your individual occasion of our dapp and take a look at all Moralis Solana API endpoints in your browser.

Herein, you obtained all the knowledge it’s worthwhile to begin creating Solana dapps the straightforward method. Together with your Web3 API key and the Moralis docs, you’re absolutely outfitted to create distinctive dapps on Solana or some other main blockchain. In any case, Moralis is all about cross-chain interoperability. 

Nonetheless, in the event you want some extra inspiration, steerage, or extra details about Web3 growth, you should discover the Moralis YouTube channel and Moralis weblog. Other than numerous tutorials, these are the locations to get acquainted with blockchain and Web3 ideas. For example, among the newest articles discover zk-rollup tasks, Alchemy’s Notify Customized Webhooks, how and the place to purchase ENS domains, and way more. All in all, our movies and articles will help you turn into a Web3 developer totally free. That stated, you could be keen on taking a extra skilled strategy to your crypto training. In that case, we advocate enrolling in Moralis Academy. There, you possibly can prepare your particular person abilities or your complete staff and get blockchain licensed!