GET
/
1
/
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,
      "marketCap": 123,
      "marketCapDiluted": 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,
      "marketCap": 123,
      "marketCapDiluted": 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

  • When “blockchain” parameter is not provided, we will try to resolve the chain on a best-effort basis, but it’s recommended to always provide the blockchain parameter.
  • 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
​
force
boolean | null
default:false

Response

200 - application/json

Market pair response

The response is of type object.