GET
/
1
/
market
/
query
/
token
curl --request GET \
  --url https://api.mobula.io/api/1/market/query/token
{
  "data": [
    {
      "name": "<string>",
      "logo": "<string>",
      "symbol": "<string>",
      "address": "<string>",
      "blockchain": "<string>",
      "decimals": 123,
      "volume_24h": 123,
      "listed_at": "<string>",
      "circulating_supply": "<string>",
      "total_supply": "<string>",
      "coingecko_id": "<string>",
      "pairs": [
        {
          "token0": {
            "address": "<string>",
            "price": 123,
            "priceToken": 123,
            "priceTokenString": "<string>",
            "approximateReserveUSD": 123,
            "approximateReserveTokenRaw": "<string>",
            "approximateReserveToken": 123,
            "symbol": "<string>",
            "name": "<string>",
            "id": 123,
            "decimals": 123,
            "totalSupply": 123,
            "circulatingSupply": 123,
            "logo": "<string>",
            "chainId": "<string>"
          },
          "token1": {
            "address": "<string>",
            "price": 123,
            "priceToken": 123,
            "priceTokenString": "<string>",
            "approximateReserveUSD": 123,
            "approximateReserveTokenRaw": "<string>",
            "approximateReserveToken": 123,
            "symbol": "<string>",
            "name": "<string>",
            "id": 123,
            "decimals": 123,
            "totalSupply": 123,
            "circulatingSupply": 123,
            "logo": "<string>",
            "chainId": "<string>"
          },
          "volume24h": 123,
          "liquidity": 123,
          "blockchain": "<string>",
          "address": "<string>",
          "createdAt": "<string>",
          "type": "<string>",
          "baseToken": "<string>",
          "exchange": {
            "name": "<string>",
            "logo": "<string>"
          },
          "factory": "<string>",
          "quoteToken": "<string>",
          "price": 123,
          "priceToken": 123,
          "priceTokenString": "<string>"
        }
      ]
    }
  ]
}

​
Query quick start

The market query endpoint allows you to run SQL-like queries against token market data. You can query tokens using various fields from the token model including chain ID, address, name, symbol, and more.

​
Data details

Available fields for querying:

  • chainId: Blockchain chain identifier
  • address: Token contract address
  • name: Token name
  • symbol: Token symbol
  • decimals: Number of decimal places
  • priceUSD: Current price in USD
  • volume24hUSD: 24-hour trading volume in USD
  • reserveUSD: Reserve value in USD
  • totalSupply: Total token supply in wei
  • circulatingSupply: Circulating supply in wei
  • listedAt: Token listing timestamp
  • is_exotic: Exotic token flag
  • holders_count: Number of token holders
  • is_spam: Spam flag
  • source: Token source information
  • deployer: Token deployer address
  • logo: Token logo URL

Query Parameters

​
sortField
string
​
sortOrder
string
default:desc
​
sortBy
string
​
filters
string
​
limit
number | null
default:20
​
blockchain
string
​
blockchains
string
​
unlistedAssets
boolean | null
default:false

Response

200 - application/json

Market query token response

The response is of type object.