GET
/
market
/
pair
curl --request GET \
  --url https://api.mobula.io/api/1/market/pair
{
  "data": {
    "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>",
    "trades_1min": 123,
    "buys_1min": 123,
    "sells_1min": 123,
    "volume_1min": 123,
    "buy_volume_1min": 123,
    "sell_volume_1min": 123,
    "sellers_1min": 123,
    "buyers_1min": 123,
    "traders_1min": 123,
    "trades_5min": 123,
    "buys_5min": 123,
    "sells_5min": 123,
    "volume_5min": 123,
    "buy_volume_5min": 123,
    "sell_volume_5min": 123,
    "sellers_5min": 123,
    "buyers_5min": 123,
    "traders_5min": 123,
    "trades_15min": 123,
    "buys_15min": 123,
    "sells_15min": 123,
    "volume_15min": 123,
    "buy_volume_15min": 123,
    "sell_volume_15min": 123,
    "sellers_15min": 123,
    "buyers_15min": 123,
    "traders_15min": 123,
    "trades_1h": 123,
    "buys_1h": 123,
    "sells_1h": 123,
    "volume_1h": 123,
    "buy_volume_1h": 123,
    "sell_volume_1h": 123,
    "sellers_1h": 123,
    "buyers_1h": 123,
    "traders_1h": 123,
    "trades_4h": 123,
    "buys_4h": 123,
    "sells_4h": 123,
    "volume_4h": 123,
    "buy_volume_4h": 123,
    "sell_volume_4h": 123,
    "sellers_4h": 123,
    "buyers_4h": 123,
    "traders_4h": 123,
    "trades_12h": 123,
    "buys_12h": 123,
    "sells_12h": 123,
    "volume_12h": 123,
    "buy_volume_12h": 123,
    "sell_volume_12h": 123,
    "sellers_12h": 123,
    "buyers_12h": 123,
    "traders_12h": 123,
    "trades_24h": 123,
    "buys_24h": 123,
    "sells_24h": 123,
    "volume_24h": 123,
    "buy_volume_24h": 123,
    "sell_volume_24h": 123,
    "sellers_24h": 123,
    "buyers_24h": 123,
    "traders_24h": 123,
    "pool_addr": 123,
    "price_change_1min": 123,
    "price_change_5min": 123,
    "price_change_1h": 123,
    "price_change_4h": 123,
    "price_change_12h": 123,
    "price_change_24h": 123
  }
}

​
Query details

Blockchain is only mandatory if the DEX is Balancer V2 but recommended (blockchain format can be found here.

You can also add an asset as optionnal parameter, which will then return at the highest level priceToken & price that would be the price & price-in-other-token of the given asset (same query pattern as market/data) The “stats” param set to true will return trades stats on the given pair, including volume, fees, and number of trades.

​
Data details

Price data is computed using Octopus, Mobula’s market data engine. You can have a high-level overview of how it’s computing DeFi prices here.

Protocols covered right now includes: Uniswap V2 and all +800 forks, Uniswap V3 and all +30 forks, Balancer V2/V3 (and forks), TraderJoe 2.1, Camelot stableswaps & all SUI DEXes.

Query Parameters

​
blockchain
string
​
asset
string
​
symbol
string
​
address
string
​
baseToken
string
​
stats
default:false

Response

200 - application/json
Market pair response
​
data
object
required
Get Market Data (batch)Get All Pairs