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.