Octopus - Market API
Get Market Pair
Introduction
Octopus - Market API
[BETA] Wallet Explorer API
Metacore
Octopus - Market API
Get Market Pair
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,
"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
- 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
Response
200 - application/json
Market pair response
The response is of type object
.
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
}
}