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://api.mobula.io/api/1/market/query/token?sortBy=listed_at&sortOrder=desc&blockchain=Base'

Using Axios:

import axios from "axios";

axios.get('https://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/60989b438a473ed77703f7bcd3530fc15542996a6607ae831de8c5e3e10f688d.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.