Integrating ITSA’s Tokenbase API into Your Website: A Comprehensive Guide

As digital assets gain prominence in the world of finance, it is crucial for developers, investors, and enthusiasts to access reliable and comprehensive information about various tokens. The International Token Standardization Association (ITSA) provides a valuable resource in the form of its Tokenbase, an extensive database of token information. In this article, we will guide you through integrating the ITSA Tokenbase into your website using our API. This will allow your users to access token data seamlessly and efficiently.

Authors: Henricus Bracht, Christian Viehof

Tokenbase is one of the three main pillars of ITSA’s product line and is the main source to retrieve information about tokens, assign them an ITIN and classify them according to the ITC classification framework. If you want to learn more about the identification and classification of tokens, check out the ‘’What we do’’ page on our website.

Before you begin integrating ITSA’s Tokenbase API into your website, it’s essential to familiarize yourself with some basic principles of RESTful API requests and responses. RESTful APIs, like the Tokenbase API, use standard HTTP methods to communicate with the server and retrieve data. In this case, you’ll be using GET requests to fetch token data from ITSA’s servers.

The base URL for the Tokenbase API is: https://api.itsa.global/v2/. This URL is the starting point for all your API calls, and you’ll append specific endpoints and parameters to it depending on the data you wish to retrieve.

A summary of all possible endpoints can be found in the documentation under this address https://docs.itsa.global/reference/endpoint-overview.

As you work with the API, keep in mind that it follows a versioning system. The current version is v2, as indicated in the base URL. This versioning helps ensure that your implementation remains compatible with future updates to the API.

In the next sections, we’ll cover how to fetch token data using the Tokenbase API, both for individual tokens and for multiple tokens at once. We’ll also provide code examples to help you display the retrieved data on your website.

Fetching Token Data by ITIN

In this section, we will guide you through the process of fetching data for a specific token using its International Token Identification Number (ITIN) by calling ITSA’s Tokenbase API. The ITIN is a unique identifier for Tokens that is in particular capable of being used in a multi-chain world. We aligned the concept of this identifier with the concept of the ISIN. To be able to constantly cope with the newest developments, the ITIN is permanently supervised in the ITIN working group.

The API call for retrieving a Token with its ITIN is as follows:

https://api.itsa.global/v2/itin/{itin}

Replace {itin} with the ITIN of the token you want to fetch data for. For example, if the ITIN of the token you want to retrieve data for is “979K-JJQ2–7”, the API call would be:

https://api.itsa.global/v2/itin/979K-JJQ2-7/

Once you make the API call, you will receive a response containing the token data in JSON format. The response will include various fields, such as token URLs, supply details, platform information, and ITC classifications, among others.

Here’s an example of how you can make the API call and parse the response using JavaScript and the Fetch API:

const itin = '979K-JJQ2-7';
const apiUrl = `https://api.itsa.global/v2/itin/${itin}`;

fetch(apiUrl)
  .then(response => response.json())
  .then(data => {
    console.log('Token Data:', data);

    // Access specific fields from the data
    const tokenName = data.cmc_token_name;
    const tokenSymbol = data.cmc_token_symbol;
    const tokenCirculatingSupply = data.cmc_token_circulating_supply;

    // Display the token data on your website
    const tokenInfoDiv = document.getElementById('token-info');
    tokenInfoDiv.innerHTML = `
      <h3>${tokenName} (${tokenSymbol})</h3>
      <p>Circulating Supply: ${tokenCirculatingSupply}</p>
    `;
  })
  .catch(error => {
    console.error('Error fetching token data:', error);
  });

In the example above, we fetch the data for a token with ITIN “979K-JJQ2–7” and display its name, symbol, and circulating supply on a website (see figure 1). You can customize this code to display other fields from the API response as needed. If you want to find out about a specific Token’s ITIN, look them up here.

Remember to replace the example ITIN with the actual ITIN of the token you want to fetch data for and adapt the code to fit the structure of your website.

Here you see a screenshot of the frontend analogous to the query:

Figure 1: An excerpt out of our Tokenbase (source: https://itin.itsa.global/979KJJQ27)

You can find the documentation about all returned token data on this page.

Fetching an Array of Tokens

In this section, we will demonstrate how to fetch an array of tokens using ITSA’s Tokenbase API by applying filters to narrow down the search results. To fetch multiple tokens, use the following API call:

https://api.itsa.global/v2/search-tokens

You can apply various query parameters to filter the results based on the ITC classifications or token attributes. The ITC classification framework is a tool that makes it possible for you to get an understanding of Tokens you have not heard of before within seconds. It is continuously adjusted by the working groups of our community in accordance with the most recent developments in regulation and technology in the world of Web3 and Tokens. Some of the available query parameters include:

For instance, if you want to fetch all tokens with the ITC Economic Purpose (EEP) classification “EEP22TU02” and the ITC Legal Claim (LLC) classification “LLC31”, you would use the following API call:

https://api.itsa.global/v2/search-tokens?itc_eep=EEP22TU02&itc_llc=LLC31

Here’s an example of how to fetch multiple tokens with filters using JavaScript and the Fetch API:

const apiUrl = 'https://api.itsa.global/v2/list-tokens';

// Define query parameters for filtering
const queryParams = new URLSearchParams({
  itc_eep: 'EEP22TU02',
  itc_llc: 'LLC31',
});

fetch(`${apiUrl}?${queryParams}`)
  .then(response => response.json())
  .then(data => {
    console.log('Filtered Tokens:', data);

    // Iterate through the tokens and display their data
    const tokenListDiv = document.getElementById('token-list');
    data.forEach(token => {
      const tokenName = token.cmc_token_name;
      const tokenSymbol = token.cmc_token_symbol;
      const tokenCirculatingSupply = token.cmc_token_circulating_supply;

      const tokenItem = document.createElement('div');
      tokenItem.innerHTML = `
        <h3>${tokenName} (${tokenSymbol})</h3>
        <p>Circulating Supply: ${tokenCirculatingSupply}</p>
      `;
      tokenListDiv.appendChild(tokenItem);
    });
  })
  .catch(error => {
    console.error('Error fetching filtered tokens:', error);
  });

In this example, we fetch all tokens with ITC EEP classification “EEP22TU02” and ITC LLC classification “LLC31” and display their names, symbols, and circulating supplies on a website. An explanation on what these codes actually mean, can be found here. You can customize this code to apply different filters or display additional fields from the API response as needed.

Make sure to adapt the code to fit the structure of your website and replace the example query parameters with your desired filters. Figure 2 shows a search query in the frontend:

Figure 2: A search query in the frontend (source: shorturl.at/KPQW1)

You find the documentation about all returned token data on this page.

Summary

In this article, we have explored the ITSA Tokenbase API and demonstrated how to integrate it into your application. By following the steps outlined above, you can provide your users with a comprehensive and reliable source of token information. We covered fetching data for a single token, fetching multiple tokens with filters, and displaying the retrieved data on your application.

You want to learn more about Tokenbase? After your first steps with this quick introduction to the Tokenbase, a full-scale and more sophisticated documentation can be found under docs.itsa.global (see figure 3).

Figure 3: Tokenbase API documentation (source: https://docs.itsa.global/)

As the digital asset landscape continues to evolve, the ITSA Tokenbase can serve as an essential resource for developers, investors, and enthusiasts alike. By incorporating this valuable tool into your application, you can enhance your platform’s credibility and provide a valuable service to your users. Take a look at our successful partnerships with numerous different companies and institutions. We are curious to hear about your ideas and how Tokenbase can assist you in building fascinating products. Do not hesitate to get in touch with us!

With the ITSA Tokenbase at your fingertips, you will be well-equipped to navigate the rapidly changing world of digital assets.

Remarks

If you like this article, we would be happy if you forward it to your colleagues or share it on social networks. More information about the International Token Standardization Association can be found on the Internet, on Twitter, or on LinkedIn.

Henricus Bracht is the Lead Developer at International Token Standardization Association (ITSA) e.V., working to create the world’s largest token database, including a classification framework and unique token identifiers and locators. He studies „Computational Business Analytics“ at Frankfurt School of Finance and Management very successfully, started programming at age 12 and entered the Blockchain World two years ago. You can contact Henricus via henricus.bracht@itsa.global and connect on LinkedIn if you would like to further discuss ITSA e.V., and in particular the Tokenbase, or have any other open questions.

Christian Viehof is an Executive Director at the International Token Standardization Association (ITSA) e.V., working to create the world’s largest token database including a classification framework and unique token identifiers and locators. He completed his Bachelor in Economics at the University of Bonn, the Hong Kong University and the London School of Economics and Political Science with a focus on Behavioral Economics and Finance. Currently pursuing his Master of Finance at the Frankfurt School of Finance and Management, you can contact him via christian.viehof@itsa.global and connect with him on Linkedin, if you would like to further discuss ITSA e.V. or have any open questions.