Get Token Details

Get Comprehensive Token Details

curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/details

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://demo-api.mobula.io/api/2/token/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://demo-api.mobula.io/api/2/token/details"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://demo-api.mobula.io/api/2/token/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "data": {
    "address": "<string>",
    "chainId": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "priceTokenString": "<string>",
    "approximateReserveTokenRaw": "<string>",
    "logo": "<string>",
    "bondedAt": "<string>",
    "createdAt": "<string>",
    "latestTradeDate": "<string>",
    "description": "<string>",
    "socials": {
      "twitter": "<string>",
      "website": "<string>",
      "telegram": "<string>",
      "others": {},
      "uri": "<string>"
    },
    "security": {
      "buyTax": "<string>",
      "sellTax": "<string>",
      "transferPausable": true,
      "top10Holders": "<string>",
      "isBlacklisted": true,
      "noMintAuthority": true,
      "isFreezable": true,
      "balanceMutable": true,
      "lowLiquidity": "<string>",
      "burnRate": "<string>",
      "liquidityBurnPercentage": 123,
      "transferTax": "<string>",
      "isHoneypot": true,
      "isNotOpenSource": true,
      "renounced": true,
      "locked": "<string>",
      "isWhitelisted": true,
      "isMintable": true,
      "modifyableTax": true,
      "selfDestruct": true
    },
    "liveStatus": "<string>",
    "liveThumbnail": "<string>",
    "livestreamTitle": "<string>",
    "liveReplyCount": 123,
    "decimals": 0,
    "id": null,
    "priceUSD": 0,
    "priceToken": 0,
    "approximateReserveUSD": 0,
    "approximateReserveToken": 0,
    "totalSupply": 0,
    "circulatingSupply": 0,
    "marketCapUSD": 0,
    "marketCapDilutedUSD": 0,
    "originLogoUrl": "<string>",
    "rank": null,
    "cexs": [],
    "exchange": {
      "name": "<string>",
      "logo": "<string>"
    },
    "factory": "<string>",
    "source": "<string>",
    "sourceFactory": "<string>",
    "sourceMetadata": {
      "name": "<string>",
      "logo": "<string>"
    },
    "sourceFactoryMetadata": {
      "name": "<string>",
      "logo": "<string>"
    },
    "liquidityUSD": 123,
    "liquidityMaxUSD": 123,
    "bonded": true,
    "bondingPercentage": 123,
    "migrating": true,
    "bondingCurveAddress": "<string>",
    "preBondingFactory": "<string>",
    "poolAddress": "<string>",
    "blockchain": "<string>",
    "type": "<string>",
    "deployer": "<string>",
    "athUSD": 123,
    "atlUSD": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "priceChange1minPercentage": 0,
    "priceChange5minPercentage": 0,
    "priceChange1hPercentage": 0,
    "priceChange4hPercentage": 0,
    "priceChange6hPercentage": 0,
    "priceChange12hPercentage": 0,
    "priceChange24hPercentage": 0,
    "poolPriceChange1minPercentage": 0,
    "poolPriceChange5minPercentage": 0,
    "poolPriceChange1hPercentage": 0,
    "poolPriceChange4hPercentage": 0,
    "poolPriceChange6hPercentage": 0,
    "poolPriceChange12hPercentage": 0,
    "poolPriceChange24hPercentage": 0,
    "liquidityBurnPercentage": 123,
    "volume1minUSD": 0,
    "volume5minUSD": 0,
    "volume15minUSD": 0,
    "volume1hUSD": 0,
    "volume4hUSD": 0,
    "volume6hUSD": 0,
    "volume12hUSD": 0,
    "volume24hUSD": 0,
    "volumeBuy1minUSD": 0,
    "volumeBuy5minUSD": 0,
    "volumeBuy15minUSD": 0,
    "volumeBuy1hUSD": 0,
    "volumeBuy4hUSD": 0,
    "volumeBuy6hUSD": 0,
    "volumeBuy12hUSD": 0,
    "volumeBuy24hUSD": 0,
    "volumeSell1minUSD": 0,
    "volumeSell5minUSD": 0,
    "volumeSell15minUSD": 0,
    "volumeSell1hUSD": 0,
    "volumeSell4hUSD": 0,
    "volumeSell6hUSD": 0,
    "volumeSell12hUSD": 0,
    "volumeSell24hUSD": 0,
    "trades1min": 0,
    "trades5min": 0,
    "trades15min": 0,
    "trades1h": 0,
    "trades4h": 0,
    "trades6h": 0,
    "trades12h": 0,
    "trades24h": 0,
    "buys1min": 0,
    "buys5min": 0,
    "buys15min": 0,
    "buys1h": 0,
    "buys4h": 0,
    "buys6h": 0,
    "buys12h": 0,
    "buys24h": 0,
    "sells1min": 0,
    "sells5min": 0,
    "sells15min": 0,
    "sells1h": 0,
    "sells4h": 0,
    "sells6h": 0,
    "sells12h": 0,
    "sells24h": 0,
    "buyers1min": 0,
    "buyers5min": 0,
    "buyers15min": 0,
    "buyers1h": 0,
    "buyers4h": 0,
    "buyers6h": 0,
    "buyers12h": 0,
    "buyers24h": 0,
    "sellers1min": 0,
    "sellers5min": 0,
    "sellers15min": 0,
    "sellers1h": 0,
    "sellers4h": 0,
    "sellers6h": 0,
    "sellers12h": 0,
    "sellers24h": 0,
    "traders1min": 0,
    "traders5min": 0,
    "traders15min": 0,
    "traders1h": 0,
    "traders4h": 0,
    "traders6h": 0,
    "traders12h": 0,
    "traders24h": 0,
    "feesPaid1minUSD": 0,
    "feesPaid5minUSD": 0,
    "feesPaid15minUSD": 0,
    "feesPaid1hUSD": 0,
    "feesPaid4hUSD": 0,
    "feesPaid6hUSD": 0,
    "feesPaid12hUSD": 0,
    "feesPaid24hUSD": 0,
    "totalFeesPaidUSD": 0,
    "totalFeesPaidNativeRaw": "0",
    "organicTrades1min": 0,
    "organicTrades5min": 0,
    "organicTrades15min": 0,
    "organicTrades1h": 0,
    "organicTrades4h": 0,
    "organicTrades6h": 0,
    "organicTrades12h": 0,
    "organicTrades24h": 0,
    "organicTraders1min": 0,
    "organicTraders5min": 0,
    "organicTraders15min": 0,
    "organicTraders1h": 0,
    "organicTraders4h": 0,
    "organicTraders6h": 0,
    "organicTraders12h": 0,
    "organicTraders24h": 0,
    "organicVolume1minUSD": 0,
    "organicVolume5minUSD": 0,
    "organicVolume15minUSD": 0,
    "organicVolume1hUSD": 0,
    "organicVolume4hUSD": 0,
    "organicVolume6hUSD": 0,
    "organicVolume12hUSD": 0,
    "organicVolume24hUSD": 0,
    "organicVolumeBuy1minUSD": 0,
    "organicVolumeBuy5minUSD": 0,
    "organicVolumeBuy15minUSD": 0,
    "organicVolumeBuy1hUSD": 0,
    "organicVolumeBuy4hUSD": 0,
    "organicVolumeBuy6hUSD": 0,
    "organicVolumeBuy12hUSD": 0,
    "organicVolumeBuy24hUSD": 0,
    "organicVolumeSell1minUSD": 0,
    "organicVolumeSell5minUSD": 0,
    "organicVolumeSell15minUSD": 0,
    "organicVolumeSell1hUSD": 0,
    "organicVolumeSell4hUSD": 0,
    "organicVolumeSell6hUSD": 0,
    "organicVolumeSell12hUSD": 0,
    "organicVolumeSell24hUSD": 0,
    "organicBuys1min": 0,
    "organicBuys5min": 0,
    "organicBuys15min": 0,
    "organicBuys1h": 0,
    "organicBuys4h": 0,
    "organicBuys6h": 0,
    "organicBuys12h": 0,
    "organicBuys24h": 0,
    "organicSells1min": 0,
    "organicSells5min": 0,
    "organicSells15min": 0,
    "organicSells1h": 0,
    "organicSells4h": 0,
    "organicSells6h": 0,
    "organicSells12h": 0,
    "organicSells24h": 0,
    "organicBuyers1min": 0,
    "organicBuyers5min": 0,
    "organicBuyers15min": 0,
    "organicBuyers1h": 0,
    "organicBuyers4h": 0,
    "organicBuyers6h": 0,
    "organicBuyers12h": 0,
    "organicBuyers24h": 0,
    "organicSellers1min": 0,
    "organicSellers5min": 0,
    "organicSellers15min": 0,
    "organicSellers1h": 0,
    "organicSellers4h": 0,
    "organicSellers6h": 0,
    "organicSellers12h": 0,
    "organicSellers24h": 0,
    "holdersCount": 123,
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "deployerMigrationsCount": 0,
    "deployerTokensCount": 0,
    "securityScore": null,
    "securityScoreUpdatedAt": null,
    "dexscreenerListed": false,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "dexscreenerAdPaidDate": null,
    "dexScreenerEnhanced": null,
    "dexscreenerPendingAt": null,
    "dexscreenerSocialPaid": false,
    "dexscreenerSocialPaidDate": null,
    "dexscreenerBoosted": false,
    "dexscreenerBoostedDate": null,
    "dexscreenerBoostedAmount": 0,
    "surgeScore": null,
    "isMayhemMode": null,
    "isCashbackCoin": null,
    "isAgentMode": null,
    "isOGCoin": null,
    "top10HoldingsPercentage": 123,
    "top50HoldingsPercentage": 123,
    "top100HoldingsPercentage": 123,
    "top200HoldingsPercentage": 123,
    "devHoldingsPercentage": 123,
    "insidersHoldingsPercentage": 123,
    "bundlersHoldingsPercentage": 123,
    "snipersHoldingsPercentage": 123,
    "proTradersHoldingsPercentage": 123,
    "freshTradersHoldingsPercentage": 123,
    "smartTradersHoldingsPercentage": 123,
    "insidersCount": 123,
    "bundlersCount": 123,
    "snipersCount": 123,
    "freshTradersCount": 123,
    "proTradersCount": 123,
    "smartTradersCount": 123,
    "freshTradersBuys": 123,
    "proTradersBuys": 123,
    "smartTradersBuys": 123
  },
  "hostname": "<string>"
}

GET

token

details

Get Comprehensive Token Details

curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/details

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://demo-api.mobula.io/api/2/token/details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://demo-api.mobula.io/api/2/token/details"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://demo-api.mobula.io/api/2/token/details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "data": {
    "address": "<string>",
    "chainId": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "priceTokenString": "<string>",
    "approximateReserveTokenRaw": "<string>",
    "logo": "<string>",
    "bondedAt": "<string>",
    "createdAt": "<string>",
    "latestTradeDate": "<string>",
    "description": "<string>",
    "socials": {
      "twitter": "<string>",
      "website": "<string>",
      "telegram": "<string>",
      "others": {},
      "uri": "<string>"
    },
    "security": {
      "buyTax": "<string>",
      "sellTax": "<string>",
      "transferPausable": true,
      "top10Holders": "<string>",
      "isBlacklisted": true,
      "noMintAuthority": true,
      "isFreezable": true,
      "balanceMutable": true,
      "lowLiquidity": "<string>",
      "burnRate": "<string>",
      "liquidityBurnPercentage": 123,
      "transferTax": "<string>",
      "isHoneypot": true,
      "isNotOpenSource": true,
      "renounced": true,
      "locked": "<string>",
      "isWhitelisted": true,
      "isMintable": true,
      "modifyableTax": true,
      "selfDestruct": true
    },
    "liveStatus": "<string>",
    "liveThumbnail": "<string>",
    "livestreamTitle": "<string>",
    "liveReplyCount": 123,
    "decimals": 0,
    "id": null,
    "priceUSD": 0,
    "priceToken": 0,
    "approximateReserveUSD": 0,
    "approximateReserveToken": 0,
    "totalSupply": 0,
    "circulatingSupply": 0,
    "marketCapUSD": 0,
    "marketCapDilutedUSD": 0,
    "originLogoUrl": "<string>",
    "rank": null,
    "cexs": [],
    "exchange": {
      "name": "<string>",
      "logo": "<string>"
    },
    "factory": "<string>",
    "source": "<string>",
    "sourceFactory": "<string>",
    "sourceMetadata": {
      "name": "<string>",
      "logo": "<string>"
    },
    "sourceFactoryMetadata": {
      "name": "<string>",
      "logo": "<string>"
    },
    "liquidityUSD": 123,
    "liquidityMaxUSD": 123,
    "bonded": true,
    "bondingPercentage": 123,
    "migrating": true,
    "bondingCurveAddress": "<string>",
    "preBondingFactory": "<string>",
    "poolAddress": "<string>",
    "blockchain": "<string>",
    "type": "<string>",
    "deployer": "<string>",
    "athUSD": 123,
    "atlUSD": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "priceChange1minPercentage": 0,
    "priceChange5minPercentage": 0,
    "priceChange1hPercentage": 0,
    "priceChange4hPercentage": 0,
    "priceChange6hPercentage": 0,
    "priceChange12hPercentage": 0,
    "priceChange24hPercentage": 0,
    "poolPriceChange1minPercentage": 0,
    "poolPriceChange5minPercentage": 0,
    "poolPriceChange1hPercentage": 0,
    "poolPriceChange4hPercentage": 0,
    "poolPriceChange6hPercentage": 0,
    "poolPriceChange12hPercentage": 0,
    "poolPriceChange24hPercentage": 0,
    "liquidityBurnPercentage": 123,
    "volume1minUSD": 0,
    "volume5minUSD": 0,
    "volume15minUSD": 0,
    "volume1hUSD": 0,
    "volume4hUSD": 0,
    "volume6hUSD": 0,
    "volume12hUSD": 0,
    "volume24hUSD": 0,
    "volumeBuy1minUSD": 0,
    "volumeBuy5minUSD": 0,
    "volumeBuy15minUSD": 0,
    "volumeBuy1hUSD": 0,
    "volumeBuy4hUSD": 0,
    "volumeBuy6hUSD": 0,
    "volumeBuy12hUSD": 0,
    "volumeBuy24hUSD": 0,
    "volumeSell1minUSD": 0,
    "volumeSell5minUSD": 0,
    "volumeSell15minUSD": 0,
    "volumeSell1hUSD": 0,
    "volumeSell4hUSD": 0,
    "volumeSell6hUSD": 0,
    "volumeSell12hUSD": 0,
    "volumeSell24hUSD": 0,
    "trades1min": 0,
    "trades5min": 0,
    "trades15min": 0,
    "trades1h": 0,
    "trades4h": 0,
    "trades6h": 0,
    "trades12h": 0,
    "trades24h": 0,
    "buys1min": 0,
    "buys5min": 0,
    "buys15min": 0,
    "buys1h": 0,
    "buys4h": 0,
    "buys6h": 0,
    "buys12h": 0,
    "buys24h": 0,
    "sells1min": 0,
    "sells5min": 0,
    "sells15min": 0,
    "sells1h": 0,
    "sells4h": 0,
    "sells6h": 0,
    "sells12h": 0,
    "sells24h": 0,
    "buyers1min": 0,
    "buyers5min": 0,
    "buyers15min": 0,
    "buyers1h": 0,
    "buyers4h": 0,
    "buyers6h": 0,
    "buyers12h": 0,
    "buyers24h": 0,
    "sellers1min": 0,
    "sellers5min": 0,
    "sellers15min": 0,
    "sellers1h": 0,
    "sellers4h": 0,
    "sellers6h": 0,
    "sellers12h": 0,
    "sellers24h": 0,
    "traders1min": 0,
    "traders5min": 0,
    "traders15min": 0,
    "traders1h": 0,
    "traders4h": 0,
    "traders6h": 0,
    "traders12h": 0,
    "traders24h": 0,
    "feesPaid1minUSD": 0,
    "feesPaid5minUSD": 0,
    "feesPaid15minUSD": 0,
    "feesPaid1hUSD": 0,
    "feesPaid4hUSD": 0,
    "feesPaid6hUSD": 0,
    "feesPaid12hUSD": 0,
    "feesPaid24hUSD": 0,
    "totalFeesPaidUSD": 0,
    "totalFeesPaidNativeRaw": "0",
    "organicTrades1min": 0,
    "organicTrades5min": 0,
    "organicTrades15min": 0,
    "organicTrades1h": 0,
    "organicTrades4h": 0,
    "organicTrades6h": 0,
    "organicTrades12h": 0,
    "organicTrades24h": 0,
    "organicTraders1min": 0,
    "organicTraders5min": 0,
    "organicTraders15min": 0,
    "organicTraders1h": 0,
    "organicTraders4h": 0,
    "organicTraders6h": 0,
    "organicTraders12h": 0,
    "organicTraders24h": 0,
    "organicVolume1minUSD": 0,
    "organicVolume5minUSD": 0,
    "organicVolume15minUSD": 0,
    "organicVolume1hUSD": 0,
    "organicVolume4hUSD": 0,
    "organicVolume6hUSD": 0,
    "organicVolume12hUSD": 0,
    "organicVolume24hUSD": 0,
    "organicVolumeBuy1minUSD": 0,
    "organicVolumeBuy5minUSD": 0,
    "organicVolumeBuy15minUSD": 0,
    "organicVolumeBuy1hUSD": 0,
    "organicVolumeBuy4hUSD": 0,
    "organicVolumeBuy6hUSD": 0,
    "organicVolumeBuy12hUSD": 0,
    "organicVolumeBuy24hUSD": 0,
    "organicVolumeSell1minUSD": 0,
    "organicVolumeSell5minUSD": 0,
    "organicVolumeSell15minUSD": 0,
    "organicVolumeSell1hUSD": 0,
    "organicVolumeSell4hUSD": 0,
    "organicVolumeSell6hUSD": 0,
    "organicVolumeSell12hUSD": 0,
    "organicVolumeSell24hUSD": 0,
    "organicBuys1min": 0,
    "organicBuys5min": 0,
    "organicBuys15min": 0,
    "organicBuys1h": 0,
    "organicBuys4h": 0,
    "organicBuys6h": 0,
    "organicBuys12h": 0,
    "organicBuys24h": 0,
    "organicSells1min": 0,
    "organicSells5min": 0,
    "organicSells15min": 0,
    "organicSells1h": 0,
    "organicSells4h": 0,
    "organicSells6h": 0,
    "organicSells12h": 0,
    "organicSells24h": 0,
    "organicBuyers1min": 0,
    "organicBuyers5min": 0,
    "organicBuyers15min": 0,
    "organicBuyers1h": 0,
    "organicBuyers4h": 0,
    "organicBuyers6h": 0,
    "organicBuyers12h": 0,
    "organicBuyers24h": 0,
    "organicSellers1min": 0,
    "organicSellers5min": 0,
    "organicSellers15min": 0,
    "organicSellers1h": 0,
    "organicSellers4h": 0,
    "organicSellers6h": 0,
    "organicSellers12h": 0,
    "organicSellers24h": 0,
    "holdersCount": 123,
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "deployerMigrationsCount": 0,
    "deployerTokensCount": 0,
    "securityScore": null,
    "securityScoreUpdatedAt": null,
    "dexscreenerListed": false,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "dexscreenerAdPaidDate": null,
    "dexScreenerEnhanced": null,
    "dexscreenerPendingAt": null,
    "dexscreenerSocialPaid": false,
    "dexscreenerSocialPaidDate": null,
    "dexscreenerBoosted": false,
    "dexscreenerBoostedDate": null,
    "dexscreenerBoostedAmount": 0,
    "surgeScore": null,
    "isMayhemMode": null,
    "isCashbackCoin": null,
    "isAgentMode": null,
    "isOGCoin": null,
    "top10HoldingsPercentage": 123,
    "top50HoldingsPercentage": 123,
    "top100HoldingsPercentage": 123,
    "top200HoldingsPercentage": 123,
    "devHoldingsPercentage": 123,
    "insidersHoldingsPercentage": 123,
    "bundlersHoldingsPercentage": 123,
    "snipersHoldingsPercentage": 123,
    "proTradersHoldingsPercentage": 123,
    "freshTradersHoldingsPercentage": 123,
    "smartTradersHoldingsPercentage": 123,
    "insidersCount": 123,
    "bundlersCount": 123,
    "snipersCount": 123,
    "freshTradersCount": 123,
    "proTradersCount": 123,
    "smartTradersCount": 123,
    "freshTradersBuys": 123,
    "proTradersBuys": 123,
    "smartTradersBuys": 123
  },
  "hostname": "<string>"
}

Batch Support Available: This endpoint supports batch queries via POST method for fetching multiple tokens in a single request. Jump to Batch Query section

Overview

The Token Details endpoint provides comprehensive token data including metadata, liquidity, volume, price changes, holdings, and trading activity over multiple timeframes. It supports both single-item queries (GET) and batch queries (POST) for efficient data retrieval by token address.

GET Method - Single Item Query

Retrieve detailed token information for a single token.

Query Parameters

blockchain (required) — The blockchain identifier (e.g., evm:1, solana, ethereum)
address (required) — Direct token address
currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD. Supported currencies: USD, EUR, GBP, JPY, CHF, CAD, AUD, CNY, KRW, INR, BRL

Step-by-Step Tutorial and Video Walkthrough

Check out the guide: Here

Usage Examples

# Default (USD only)
curl -X GET "https://api.mobula.io/api/2/token/details?blockchain=solana&address=3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"

# Multi-currency (USD and EUR)
curl -X GET "https://api.mobula.io/api/2/token/details?blockchain=solana&address=3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump&currencies=EUR,USD"

Response Format

{
  "data": {
    "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
    "chainId": "solana",
    "symbol": "EXAMPLE",
    "name": "Example Token",
    "decimals": 9,
    "id": 12345,
    "priceUSD": 0.0234,
    "priceToken": 43.21,
    "priceTokenString": "43.210000000000000000000000000000",
    "approximateReserveUSD": 125000.50,
    "approximateReserveTokenRaw": "5000000000000000000",
    "approximateReserveToken": 5000.0,
    "totalSupply": 1000000000,
    "circulatingSupply": 800000000,
    "marketCapUSD": 18720000,
    "marketCapDilutedUSD": 23400000,
    "logo": "https://example.com/token-logo.png",
    "originLogoUrl": "https://ipfs.io/ipfs/QmOriginalLogo123",
    "exchange": {
      "name": "Uniswap V3",
      "logo": "https://example.com/uniswap-logo.png"
    },
    "factory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
    "source": "uniswap",
    "sourceFactory": "0x1F98431c8aD98523631AE4a59f267346ea31F984",
    "liquidityUSD": 250000.75,
    "liquidityMaxUSD": 300000.0,
    "bonded": false,
    "bondingPercentage": 0,
    "bondingCurveAddress": null,
    "preBondingFactory": null,
    "poolAddress": null,
    "top10HoldingsPercentage": 45.6,
    "top50HoldingsPercentage": 68.9,
    "top100HoldingsPercentage": 78.5,
    "top200HoldingsPercentage": 85.2,
    "devHoldingsPercentage": 15.5,
    "insidersHoldingsPercentage": 8.2,
    "bundlersHoldingsPercentage": 2.8,
    "snipersHoldingsPercentage": 3.1,
    "proTradersHoldingsPercentage": 5.0,
    "freshTradersHoldingsPercentage": 1.2,
    "insidersCount": 12,
    "bundlersCount": 5,
    "snipersCount": 8,
    "freshTradersCount": 25,
    "proTradersCount": 15,
    "blockchain": "solana",
    "type": "token",
    "deployer": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
    "bondedAt": null,
    "isMayhemMode": false,
    "isCashbackCoin": true,
    "isOGCoin": true,
    "athUSD": 0.0456,
    "atlUSD": 0.0012,
    "athDate": "2024-12-15T10:30:00.000Z",
    "atlDate": "2024-12-01T00:00:00.000Z",
    "priceChange1minPercentage": 0.5,
    "priceChange5minPercentage": -1.2,
    "priceChange1hPercentage": 3.4,
    "priceChange4hPercentage": 2.1,
    "priceChange6hPercentage": 1.8,
    "priceChange12hPercentage": 0.9,
    "priceChange24hPercentage": -5.8,
    "liquidityBurnPercentage": 100,
    "volume1minUSD": 1250.75,
    "volume5minUSD": 8500.25,
    "volume15minUSD": 42500.80,
    "volume1hUSD": 45000.80,
    "volume4hUSD": 180000.25,
    "volume6hUSD": 270000.40,
    "volume12hUSD": 540000.50,
    "volume24hUSD": 890000.50,
    "volumeBuy1minUSD": 675.50,
    "volumeBuy5minUSD": 4500.25,
    "volumeBuy15minUSD": 22500.40,
    "volumeBuy1hUSD": 24000.40,
    "volumeBuy4hUSD": 96000.15,
    "volumeBuy6hUSD": 144000.25,
    "volumeBuy12hUSD": 288000.30,
    "volumeBuy24hUSD": 480000.25,
    "volumeSell1minUSD": 575.25,
    "volumeSell5minUSD": 4000.00,
    "volumeSell15minUSD": 20000.40,
    "volumeSell1hUSD": 21000.40,
    "volumeSell4hUSD": 84000.10,
    "volumeSell6hUSD": 126000.15,
    "volumeSell12hUSD": 252000.20,
    "volumeSell24hUSD": 410000.25,
    "trades1min": 15,
    "trades5min": 85,
    "trades15min": 425,
    "trades1h": 450,
    "trades4h": 1800,
    "trades6h": 2700,
    "trades12h": 5400,
    "trades24h": 8900,
    "buys1min": 8,
    "buys5min": 45,
    "buys15min": 225,
    "buys1h": 240,
    "buys4h": 960,
    "buys6h": 1440,
    "buys12h": 2880,
    "buys24h": 4800,
    "sells1min": 7,
    "sells5min": 40,
    "sells15min": 200,
    "sells1h": 210,
    "sells4h": 840,
    "sells6h": 1260,
    "sells12h": 2520,
    "sells24h": 4100,
    "buyers1min": 8,
    "buyers5min": 42,
    "buyers15min": 210,
    "buyers1h": 235,
    "buyers4h": 940,
    "buyers6h": 1410,
    "buyers12h": 2820,
    "buyers24h": 4650,
    "sellers1min": 7,
    "sellers5min": 38,
    "sellers15min": 190,
    "sellers1h": 205,
    "sellers4h": 820,
    "sellers6h": 1230,
    "sellers12h": 2460,
    "sellers24h": 3950,
    "traders1min": 14,
    "traders5min": 78,
    "traders15min": 390,
    "traders1h": 420,
    "traders4h": 1680,
    "traders6h": 2520,
    "traders12h": 5040,
    "traders24h": 8200,
    "feesPaid1minUSD": 6.25,
    "feesPaid5minUSD": 42.5,
    "feesPaid15minUSD": 212.5,
    "feesPaid1hUSD": 225.0,
    "feesPaid4hUSD": 900.0,
    "feesPaid6hUSD": 1350.0,
    "feesPaid12hUSD": 2700.0,
    "feesPaid24hUSD": 4450.0,
    "totalFeesPaidUSD": 8900.0,
    "organicTrades1min": 12,
    "organicTrades5min": 68,
    "organicTrades15min": 340,
    "organicTrades1h": 360,
    "organicTrades4h": 1440,
    "organicTrades6h": 2160,
    "organicTrades12h": 4320,
    "organicTrades24h": 7120,
    "organicTraders1min": 11,
    "organicTraders5min": 62,
    "organicTraders15min": 310,
    "organicTraders1h": 335,
    "organicTraders4h": 1340,
    "organicTraders6h": 2010,
    "organicTraders12h": 4020,
    "organicTraders24h": 6560,
    "organicVolume1minUSD": 1000.6,
    "organicVolume5minUSD": 6800.2,
    "organicVolume15minUSD": 34000.64,
    "organicVolume1hUSD": 36000.64,
    "organicVolume4hUSD": 144000.2,
    "organicVolume6hUSD": 216000.32,
    "organicVolume12hUSD": 432000.4,
    "organicVolume24hUSD": 712000.4,
    "organicVolumeBuy1minUSD": 540.32,
    "organicVolumeBuy5minUSD": 3600.16,
    "organicVolumeBuy15minUSD": 18000.32,
    "organicVolumeBuy1hUSD": 19200.32,
    "organicVolumeBuy4hUSD": 76800.12,
    "organicVolumeBuy6hUSD": 115200.2,
    "organicVolumeBuy12hUSD": 230400.24,
    "organicVolumeBuy24hUSD": 384000.2,
    "organicVolumeSell1minUSD": 460.28,
    "organicVolumeSell5minUSD": 3200.04,
    "organicVolumeSell15minUSD": 16000.32,
    "organicVolumeSell1hUSD": 16800.32,
    "organicVolumeSell4hUSD": 67200.08,
    "organicVolumeSell6hUSD": 100800.12,
    "organicVolumeSell12hUSD": 201600.16,
    "organicVolumeSell24hUSD": 328000.2,
    "organicBuys1min": 6,
    "organicBuys5min": 36,
    "organicBuys15min": 180,
    "organicBuys1h": 192,
    "organicBuys4h": 768,
    "organicBuys6h": 1152,
    "organicBuys12h": 2304,
    "organicBuys24h": 3840,
    "organicSells1min": 6,
    "organicSells5min": 32,
    "organicSells15min": 160,
    "organicSells1h": 168,
    "organicSells4h": 672,
    "organicSells6h": 1008,
    "organicSells12h": 2016,
    "organicSells24h": 3280,
    "organicBuyers1min": 6,
    "organicBuyers5min": 33,
    "organicBuyers15min": 165,
    "organicBuyers1h": 188,
    "organicBuyers4h": 752,
    "organicBuyers6h": 1128,
    "organicBuyers12h": 2256,
    "organicBuyers24h": 3720,
    "organicSellers1min": 6,
    "organicSellers5min": 30,
    "organicSellers15min": 152,
    "organicSellers1h": 164,
    "organicSellers4h": 656,
    "organicSellers6h": 984,
    "organicSellers12h": 1968,
    "organicSellers24h": 3168,
    "createdAt": "2024-12-01T00:00:00.000Z",
    "latestTradeDate": "2026-02-23T10:30:00.000Z",
    "holdersCount": 1250,
    "description": "Example token description",
    "socials": {
      "twitter": "https://twitter.com/example",
      "website": "https://example.com",
      "telegram": "https://t.me/example",
      "others": {},
      "uri": "https://example.com/token"
    },
    "security": {
      "buyTax": "5.00",
      "sellTax": "10.00",
      "transferPausable": false,
      "top10Holders": "42.50",
      "isBlacklisted": false,
      "isHoneypot": false,
      "isNotOpenSource": false,
      "renounced": true,
      "locked": "80.00",
      "isWhitelisted": false,
      "balanceMutable": false,
      "lowLiquidity": "false",
      "burnRate": "2.50",
      "isMintable": false,
      "modifyableTax": false,
      "selfDestruct": false,
      "liquidityBurnPercentage": 75.5,
      "noMintAuthority": true
    },
    "twitterReusesCount": 0,
    "twitterRenameCount": 0,
    "twitterRenameHistory": [],
    "deployerMigrationsCount": 0,
    "dexscreenerListed": true,
    "dexscreenerHeader": null,
    "dexscreenerAdPaid": false,
    "dexScreenerEnhanced": {
      "enhanced": true,
      "icon": "https://cdn.dexscreener.com/cms/images/e6851bfbd8e096ac5e44e8b71f2a34c949e2c777ec5523c0c6a06459b1299aad?width=64&height=64&quality=90&format=webp",
      "header": "https://cdn.dexscreener.com/cms/images/41394d85f86d5d3181e7f322983752270d97277c72bdf14655c57afbc2934f2b?width=600&height=200&quality=90&format=webp",
      "description": "2025 : Year Of Alien Invasion",
      "links": [
        { "url": "https://invasiononsol.xyz/", "label": "Website" },
        { "url": "https://x.com/invasionon_sol", "type": "twitter" },
        { "url": "https://t.me/invasionportal", "type": "telegram" }
      ],
      "isCto": true,
      "timestamp": 1735521401000,
      "previousEnhancements": [
        {
          "icon": "https://cdn.dexscreener.com/cms/images/e6851bfbd8e096ac5e44e8b71f2a34c949e2c777ec5523c0c6a06459b1299aad",
          "header": null,
          "description": "COMMUNITY TAKEOVER",
          "links": [
            { "url": "https://x.com/invasioncto", "type": "twitter" },
            { "url": "https://t.me/InvasionCTOPortal", "type": "telegram" }
          ],
          "isCto": true,
          "timestamp": 1735513478553
        }
      ]
    }
  }
}

POST Method - Batch Query

Retrieve token details for multiple tokens in a single request for improved efficiency.

Request Body

[
  {
    "blockchain": "evm:1",
    "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
  },
  {
    "blockchain": "solana",
    "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"
  }
]

Body Parameters

The request body is an array of query objects, where each object contains:

blockchain (required) — Blockchain id or name
address (required) — Direct token address
currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD

Usage Examples

# Batch query with default USD
curl -X POST "https://api.mobula.io/api/2/token/details" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": "evm:1",
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599"
    },
    {
      "blockchain": "solana",
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump"
    }
  ]'

# Batch query with multi-currency
curl -X POST "https://api.mobula.io/api/2/token/details" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": "evm:1",
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
      "currencies": "EUR,USD,GBP"
    },
    {
      "blockchain": "solana",
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
      "currencies": "EUR,USD"
    }
  ]'

Response Format

{
  "payload": [
    {
      "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
      "chainId": "evm:1",
      "symbol": "WBTC",
      "name": "Wrapped Bitcoin",
      "decimals": 8,
      "priceUSD": 45000.50,
      "marketCapUSD": 87750000,
      ...
    },
    {
      "address": "3vz82EWYv8xnc7Cm7qSgERcpMeqw92PcX8PBz88npump",
      "chainId": "solana",
      "symbol": "EXAMPLE",
      "name": "Example Token",
      "decimals": 9,
      "priceUSD": 0.0234,
      "marketCapUSD": 18720000,
      ...
    }
  ]
}

Multi-Currency Support

When you specify multiple currencies using the currencies parameter, the response will include additional fields for each currency. For every field ending in USD, a corresponding field will be added for each requested currency.

Example with `currencies=EUR,USD`

{
  "data": {
    "priceUSD": 0.0234,
    "priceEUR": 0.0215,
    "marketCapUSD": 18720000,
    "marketCapEUR": 17181600,
    "volume24hUSD": 890000.50,
    "volume24hEUR": 816810.46,
    "liquidityUSD": 250000.75,
    "liquidityEUR": 229500.69,
    // ... all other USD fields get their corresponding currency versions
  }
}

Converted Fields

The following field patterns are automatically converted:

priceUSD → price{CURRENCY}
marketCapUSD, marketCapDilutedUSD → marketCap{CURRENCY}, marketCapDiluted{CURRENCY}
volume*USD (all timeframes) → volume*{CURRENCY}
volumeBuy*USD, volumeSell*USD → volumeBuy*{CURRENCY}, volumeSell*{CURRENCY}
liquidityUSD, liquidityMaxUSD → liquidity{CURRENCY}, liquidityMax{CURRENCY}
approximateReserveUSD → approximateReserve{CURRENCY}
athUSD, atlUSD → ath{CURRENCY}, atl{CURRENCY}
feesPaid*USD, totalFeesPaidUSD → feesPaid*{CURRENCY}, totalFeesPaid{CURRENCY}
organicVolume*USD → organicVolume*{CURRENCY}

Exchange rates are fetched from reliable forex data providers and cached for optimal performance. Rates are updated every 30 minutes.

Response Field Definitions

Security Object

All fields in the security object are optional — they are only present when the relevant data is available for the token. A field being absent means the check was not performed or no data is available (not that the token is safe).

EVM vs Solana availability: Most fields apply to EVM chains. noMintAuthority is Solana-specific. isHoneypot, isNotOpenSource, renounced, locked, isWhitelisted, isMintable, modifyableTax, and selfDestruct are EVM-only.

Field	Type	Description
`buyTax`	`string`	Buy fee as a percentage string (e.g. `"5.00"` = 5%). Present when a transfer tax is charged on buys.
`sellTax`	`string`	Sell fee as a percentage string (e.g. `"10.00"` = 10%). Present when a transfer tax is charged on sells.
`transferPausable`	`boolean`	Whether the contract owner can pause all token transfers.
`top10Holders`	`string`	Percentage of total supply held by the top 10 wallets (e.g. `"42.50"`).
`isBlacklisted`	`boolean`	Whether the contract contains a blacklist mechanism that can block specific addresses from trading.
`isHoneypot`	`boolean`	Whether the token is a honeypot — users can buy but cannot sell. (EVM only)
`isNotOpenSource`	`boolean`	Whether the contract source code is not verified/open source on-chain. (EVM only)
`renounced`	`boolean`	Whether contract ownership has been renounced (owner is the zero address). (EVM only)
`locked`	`string`	Percentage of liquidity that is locked (e.g. `"80.00"`). (EVM only)
`isWhitelisted`	`boolean`	Whether the contract has a whitelist mechanism restricting who can trade. (EVM only)
`balanceMutable`	`boolean`	Whether the contract owner can arbitrarily modify token balances.
`lowLiquidity`	`string`	Indicates low liquidity status (e.g. `"true"` or `"false"`).
`burnRate`	`string`	Percentage of each transaction automatically burned (e.g. `"2.50"`).
`isMintable`	`boolean`	Whether the contract allows minting new tokens after deployment. (EVM only)
`modifyableTax`	`boolean`	Whether the contract owner can change the buy/sell tax rates. (EVM only)
`selfDestruct`	`boolean`	Whether the contract contains a self-destruct function. (EVM only)
`liquidityBurnPercentage`	`number`	Percentage of liquidity pool tokens that have been burned (legacy — prefer the top-level `liquidityBurnPercentage` field below).
`noMintAuthority`	`boolean`	Whether the mint authority has been disabled (safe = `true`). (Solana only)

PumpFun Flags

These fields are specific to tokens launched on PumpFun (Solana). They are null for non-PumpFun tokens.

Field	Type	Description
`isMayhemMode`	`boolean \| null`	Whether the token was created with Mayhem Mode enabled. When `true`, an AI trading agent trades the coin for 24h after creation. Immutable once set. (Solana PumpFun only)
`isCashbackCoin`	`boolean \| null`	Whether the token was created with Trader Cashback enabled. When `true`, 100% of creator fees are redistributed to traders. Immutable once set. (Solana PumpFun only)

OG Coin

Field	Type	Description
`isOGCoin`	`boolean \| null`	`true` when no other token on the same chain shares this token’s `name` — i.e. this is the “original” coin for that name. `false` when at least one prior token with the same `(chainId, name)` already exists (the new one is a copycat / rename). `null` while the flag is still being resolved (resolution is async and runs once per token after creation, plus a lazy retry on the first swap). Cross-chain: only same-chain siblings are considered, so the same name can be OG on multiple chains.

Liquidity Burn

Field	Type	Description
`liquidityBurnPercentage`	`number \| null`	Share of LP tokens (V2 pools) or position liquidity (V3/V4) held by dead/locker addresses for the largest pool. Computed from on-chain LP holder balances — no longer sourced from GoPlus. `null` while the cache is cold (warms on first `token/security` call for this token). Range `0`–`100`.

Holdings Data

The response includes various holdings percentage fields that help identify token distribution patterns:

top10HoldingsPercentage, top50HoldingsPercentage, top100HoldingsPercentage, top200HoldingsPercentage — Percentage of total supply held by the top N holders
devHoldingsPercentage — Percentage held by the token deployer/developer
insidersHoldingsPercentage — Percentage held by wallets identified as insiders (early participants with privileged access)
bundlersHoldingsPercentage — Percentage held by wallets using bundling strategies (multiple transactions in a single block)
snipersHoldingsPercentage — Percentage held by wallets that sniped the token at launch
proTradersHoldingsPercentage — Percentage held by accounts that interact with trading terminals (e.g., BullX, Photon, GMGN, Trojan, and other trading bots/interfaces). These wallets are identified by their interaction patterns with known trading terminal contracts and interfaces.
freshTradersHoldingsPercentage — Percentage held by newly funded wallets (within last 24 hours)
insidersCount, bundlersCount, snipersCount, freshTradersCount, proTradersCount — Number of holders in each category

Fees Paid Data

The feesPaid* fields represent an aggregation of transaction costs across all trades for this token:

feesPaid1minUSD, feesPaid5minUSD, feesPaid15minUSD, feesPaid1hUSD, etc. — Total fees paid over the specified timeframe
totalFeesPaidUSD — Cumulative fees paid since token creation

What’s included:

Priority fees (Solana) / Gas fees (EVM chains)
UI fees charged by trading terminals and interfaces
Protocol fees from DEX platforms

These values are approximate estimates based on heuristics. The calculation does not account for cashback systems, fee rebates, or certain terminal-specific fee structures. Use these values as directional indicators rather than precise figures.

Organic Metrics

The organic* fields filter out wash trading and bot activity to provide cleaner trading metrics:

organicTrades* — Trade count excluding suspected bot/wash activity
organicTraders* — Unique trader count excluding suspected bots
organicVolume* — Volume excluding suspected artificial activity
organicBuys*, organicSells* — Buy/sell counts excluding bots
organicBuyers*, organicSellers* — Unique buyer/seller counts excluding bots

Use Cases

GET: Single token monitoring, real-time price checks, detailed token analysis
POST: Portfolio analysis, bulk token research, multi-token dashboard data

Query Parameters

chainId

string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

address

string

Token contract address

currencies

string

Comma-separated list of currencies for price conversion

Response

200 - application/json

Token Holder response

data

object

required

Show child attributes

hostname

string

⌘I

Introduction

Market & Token Data

History - Prices & OHLCV Candles

Trades Data

Holders Data

Pulse API

Wallet APIs

Usage Data

Internal

Metacore

Webhook

Perps Data

Misc

Overview

GET Method - Single Item Query

Query Parameters

Step-by-Step Tutorial and Video Walkthrough

Usage Examples

Response Format

POST Method - Batch Query

Request Body

Body Parameters

Usage Examples

Response Format

Multi-Currency Support

Example with `currencies=EUR,USD`

Converted Fields

Response Field Definitions

Security Object

PumpFun Flags

OG Coin

Liquidity Burn

Holdings Data

Fees Paid Data

Organic Metrics

Use Cases

Query Parameters

Response

​Overview

​GET Method - Single Item Query

​Query Parameters

​Step-by-Step Tutorial and Video Walkthrough

​Usage Examples

​Response Format

​POST Method - Batch Query

​Request Body

​Body Parameters

​Usage Examples

​Response Format

​Multi-Currency Support

​Example with currencies=EUR,USD

​Converted Fields

​Response Field Definitions

​Security Object

​PumpFun Flags

​OG Coin

​Liquidity Burn

​Holdings Data

​Fees Paid Data

​Organic Metrics

​Use Cases

Query Parameters

Response

Overview

GET Method - Single Item Query

Query Parameters

Step-by-Step Tutorial and Video Walkthrough

Usage Examples

Response Format

POST Method - Batch Query

Request Body

Body Parameters

Usage Examples

Response Format

Multi-Currency Support

Example with `currencies=EUR,USD`

Converted Fields

Response Field Definitions

Security Object

PumpFun Flags

OG Coin

Liquidity Burn

Holdings Data

Fees Paid Data

Organic Metrics

Use Cases