Our latest API update introduces a new endpoint focused on delivering Fully Diluted Value (FDV) (also referred to as Fully Diluted Market Cap) data for all ERC20 tokens traded on Ethereum.

Motivation

The introduction of this feature is a direct response to user feedback. Many users have experienced difficulty in obtaining FDV figures. In particular:

• It’s difficult to obtain fully diluted market cap values for lesser-known, low-cap tokens.

• The process of retrieving this data for large numbers of tokens is notably inefficient and costly with other providers.

What is FDV?

Fully Diluted Value (or Fully Diluted Market Cap) is the value of a token assuming full circulation of its supply.

The formula for calculating FDV is simply the current market price of a token multiplied by it’s maximum supply.

Note: All tokens that adhere to the ERC20 standard have a totalSuppy function that return information about the maximum number of tokens that can be minted. (You can read more about it here: https://docs.openzeppelin.com/contracts/2.x/api/token/erc20)

Features of the New Endpoint

• Real-time Updates: The price information updates with the mining of each new Ethereum block, which occurs approximately every 12 seconds.

• Bulk Fetching Capability: Users can obtain FDV data for up to 10,000 tokens in a single request, significantly reducing the execution time and the cost for downloading FDV for a large number of tokens.

• Extensive Token Coverage: The current scope includes approximately 250,000 ERC20 tokens traded on Ethereum, and our database is continuously updated with new tokens as they enter the market and are traded.

How it works

The endpoint is called: https://api.syve.ai/v1/price-api/batch-latest-fdv

Documentation

Full documentation for this endpoint is here: https://syve.readme.io/reference/batch-latest-token-fdv

GET vs. POST request method

You can make GET as well as POST requests. If you want to fetch (or download) FDV for a large number of tokens use POST.

The GET request is limited to fetching FDV for 25 tokens in a single request. Note: This is because GET requests have a 2048 character limit for the URL.

Request parameters

There are two requests parameters token_address and price_type. For GET requests these parameters are supplied as query parameters in the URL. For POST they are supplied as JSON in the body of the request.

Example

The below example uses Python to fetch FDV for $UNIBOT $PEPE and $SHIB tokens in a single request using the POST method.

import requests
import json

url = "https://api.syve.ai/v1/price-api/batch-latest-fdv"

payload = json.dumps({
  "token_address": [
    "0xf819d9cb1c2a819fd991781a822de3ca8607c3c9",
    "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce"
  ]
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

You can try this example with different token addresses in Postman here: https://www.postman.com/dark-equinox-191074/workspace/syve-examples/request/11895150-1cfe550a-0b5a-4746-a0ee-25d37f3c7f51?ctx=documentation

If you have questions or want to give feedback you can contact us on Discord (https://discord.com/invite/rs5GPAZ7tG) or Twitter (https://twitter.com/syve_ai).

Feel free to also check out the rest of our API: https://syve.ai.