Skip to main content
GET
/
1
/
search
Search for assets, tokens, and pairs
curl --request GET \
  --url https://demo-api.mobula.io/api/1/search
{
  "data": [
    {
      "logo": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "decimals": [
        123
      ],
      "blockchains": [
        "<string>"
      ],
      "contracts": [
        "<string>"
      ],
      "price": 123,
      "total_supply": 123,
      "market_cap": 123,
      "pairs": [
        {
          "token0": {
            "address": "<string>",
            "price": 123,
            "priceToken": 123,
            "priceTokenString": "<string>",
            "approximateReserveUSD": 123,
            "approximateReserveTokenRaw": "<string>",
            "approximateReserveToken": 123,
            "symbol": "<string>",
            "name": "<string>",
            "decimals": 123,
            "totalSupply": 123,
            "circulatingSupply": 123,
            "chainId": "<string>",
            "logo": "<string>",
            "id": 123
          },
          "token1": {
            "address": "<string>",
            "price": 123,
            "priceToken": 123,
            "priceTokenString": "<string>",
            "approximateReserveUSD": 123,
            "approximateReserveTokenRaw": "<string>",
            "approximateReserveToken": 123,
            "symbol": "<string>",
            "name": "<string>",
            "decimals": 123,
            "totalSupply": 123,
            "circulatingSupply": 123,
            "chainId": "<string>",
            "logo": "<string>",
            "id": 123
          },
          "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>",
          "extraData": {}
        }
      ],
      "type": "token",
      "volume_24h": 123,
      "price_change_24h": 123,
      "price_change_1h": 123
    }
  ]
}

​
Query Details

ParameterRequiredDescription
inputYesSearch query input.
typeCond.Type of search: "assets", "pairs", "tokens".
filtersCond.JSON-encoded filters such as blockchains, factory,poolTypes and types- (“assets”, “pairs”, “tokens”)
modeCond.Search mode (implementation-specific).
sortByCond.Field to sort results by. See table below for available values.
excludeBondedCond.If true, excludes bonded assets from results.

​
Sort Options (sortBy)

Both camelCase (preferred) and snake_case (legacy) values are accepted:
camelCase (preferred)snake_case (legacy)Description
searchScoresearch_scoreRelevance score (default)
trendingScore24htrending_score_24h24h trending score
volume24hvolume_24h24h trading volume
marketCapmarket_capMarket capitalization
createdAtcreated_atToken creation date
volume1hvolume_1h1h trading volume
volume5minvolume_5min5min trading volume
feesPaid5minfees_paid_5min5min fees paid
feesPaid1hfees_paid_1h1h fees paid
feesPaid24hfees_paid_24h24h fees paid
holdersCountholders_countNumber of holders
organicVolume1horganic_volume_1h1h organic volume
totalFeesPaidUsdtotal_fees_paid_usdTotal fees paid in USD

​
Usage Examples

  • Search by filters blockchains and factory:
curl -X GET "https://demo-api.mobula.io/api/1/search?filters={"blockchains":"Mega Testnet","factory": "gte" }&input=itsagood"
  • Search by filters blockchains and poolTypes for type tokens:
curl -X GET "https://demo-api.mobula.io/api/1/search?filters={"blockchains":"Ethereum,Solana","poolTypes": "gte-bonding-v1" }&input=itsagood&type=tokens"
  • Search by filters blockchains, and factory, excludedBonded, type tokens
curl -X GET "https://demo-api.mobula.io/api/1/search?excludeBonded=true&filters={"blockchains":mega+testnet,"factory":"gte"}&input=M&types=tokens"

Query Parameters

​
input
string
required
​
type
enum<string>
Available options:
tokens,
assets,
pairs
​
filters
string
​
mode
enum<string>
default:trendings
Available options:
trendings,
og
​
sortBy
enum<string>
default:search_score
Available options:
volume_24h,
market_cap,
created_at,
volume_1h,
fees_paid_5min,
fees_paid_1h,
fees_paid_24h,
volume_5min,
holders_count,
organic_volume_1h,
total_fees_paid_usd,
search_score,
trending_score_24h
​
excludeBonded
boolean | null
​
limit
number
default:5
Required range: 1 <= x <= 20

Response

200 - application/json

Search response

​
data
object[]
required