GET
/
market
/
pairs
curl --request GET \
  --url https://api.mobula.io/api/1/market/pairs
{
  "data": {
    "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>",
        "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
      }
    ],
    "total_count": 123
  }
}

​
Query quick start

Input in “asset” the name of the asset you want to query, or the contract address while adding the blockchain as a second parameter. The market data asset query pattern is explained in great details here, with blockchain format, etc.

​
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.

Pairs are sorted by volume, then by liquidity - sent 25 by 25, use offset parameter to iterate over them (contact us if you need a higher limit).

Query Parameters

​
limit
string
default:25
​
offset
string
default:0
​
id
number | null
​
asset
string
​
symbol
string
​
blockchain
string
​
tokens
string
​
blockchains
string

Response

200 - application/json
Market pairs response
​
data
object
required
Get Market PairGet Pair Trades