Mobula API offers a direct way to obtain real-time, detailed information about tokens immediately upon their market introduction. This guide outlines how to access data on newly listed tokens.

​
What you’ll need

  1. Basic knowledge of RESTful APIs and JavaScript.
  2. Optional: Preferences for specific blockchains, cache settings, and stale data handling.
  3. An API key from the Dashboard (required for production; optional in development mode).

​
Walkthrough

1

Execute the API call

You can call Mobula API directly from your terminal using cURL or any HTTP client.Using cURL:
curl --request GET \
--url 'https://production-api.mobula.io/api/1/market/query/token?sortBy=listed_at&sortOrder=desc&blockchain=Base'
Using Axios:
import axios from "axios";

axios.get('https://production-api.mobula.io/api/1/market/query/token?sortBy=listed_at&sortOrder=desc&blockchain=Base')
.then(function (response) {
  console.log(response);
})
.catch(function (error) {
  console.log(error);
})
2

Get your data

The API will return a comprehensive response including the token’s blockchain, address, creation date, pair type, transaction statistics, and details of the tokens forming trading pairs.
{
  "data": [
    {
      "name": "USDe",
      "symbol": "USDe",
      "address": "0xf290be4044bfbe8150eff82c2d33b9cdfd342b35",
      "blockchain": "Base",
      "decimals": 18,
      "volume_24h": 0,
      "listed_at": "2024-05-28T14:47:19+00:00",
      "pairs": [
        {
          "token0": {
            "address": "0x4200000000000000000000000000000000000006",
            "price": 3847.361963243166,
            "priceToken": 367771.4257120958,
            "priceTokenString": "367771.42571209580637514591217041015625",
            "logo": "https://metacore.mobula.io/d90e937d915ab0c865ff6e335361386c56524d4d33fb66f2f04defe1500082eb.png",
            "approximateReserveUSD": 10108.570360463622,
            "approximateReserveTokenRaw": "2627402999000000000",
            "approximateReserveToken": 2.6274,
            "symbol": "ETH",
            "name": "Ethereum",
            "id": 100004304,
            "decimals": 18,
            "totalSupply": 120129946,
            "circulatingSupply": 120364095
          },
          "token1": {
            "address": "0xf290be4044bfbe8150eff82c2d33b9cdfd342b35",
            "price": 0.010461285717871442,
            "priceToken": 0.0000027190801951613134,
            "priceTokenString": "0.00000271908019516131338716002225",
            "approximateReserveUSD": 0,
            "approximateReserveTokenRaw": "966283746862466389448279",
            "approximateReserveToken": 966283.7468,
            "decimals": 18,
            "symbol": "USDe",
            "name": "USDe",
            "totalSupply": 1000000,
            "circulatingSupply": 1000000
          },
          "volume24h": 0,
          "liquidity": 10108.570360463622,
          "blockchain": "Base",
          "address": "0x8662e57fc31dab9e256187728ab085a4fa3917b6",
          "createdAt": "2024-05-28T14:47:19.000Z",
          "type": "univ2",
          "baseToken": "token1",
          "factory": "0x8909dc15e40173ff4699343b6eb8132c65e18ec6",
          "quoteToken": "token0",
          "price_change_5min": 0,
          "price_change_1h": 0,
          "price_change_4h": 0,
          "price_change_12h": 0,
          "price_change_24h": 0,
          "trades_5min": 0,
          "buys_5min": 0,
          "sells_5min": 0,
          "volume_5min": 0,
          "buy_volume_5min": 0,
          "sell_volume_5min": 0,
          "trades_1h": 0,
          "buys_1h": 0,
          "sells_1h": 0,
          "volume_1h": 0,
          "buy_volume_1h": 0,
          "sell_volume_1h": 0,
          "trades_4h": 0,
          "buys_4h": 0,
          "sells_4h": 0,
          "volume_4h": 0,
          "buy_volume_4h": 0,
          "sell_volume_4h": 0,
          "trades_12h": 0,
          "buys_12h": 0,
          "sells_12h": 0,
          "volume_12h": 0,
          "buy_volume_12h": 0,
          "sell_volume_12h": 0,
          "trades_24h": 0,
          "buys_24h": 0,
          "sells_24h": 0,
          "volume_24h": 0,
          "buy_volume_24h": 0,
          "sell_volume_24h": 0
        }
      ]
    }
  ]
}

​
Extending Your Insights

With this information, you can:
  • Reverse Discovery: Actively monitor blockchains to spot newly listed tokens, then perform due diligence before investing.
  • Analytic Integration: Use blockchain activity data to power a tool that delivers statistical insights on blockchain performance.

​
Need Help?

Our support team is available to assist you with any questions or challenges in using the API.

Support

Telegram

Support

Slack

Support

Discord

Email Support

Email