GET
/
1
/
market
/
data
curl --request GET \
  --url https://api.mobula.io/api/1/market/data
{
  "data": {
    "id": 123,
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "logo": "<string>",
    "rank": 123,
    "price": 123,
    "market_cap": 123,
    "market_cap_diluted": 123,
    "volume": 123,
    "volume_change_24h": 123,
    "volume_7d": 123,
    "liquidity": 123,
    "ath": 123,
    "atl": 123,
    "off_chain_volume": 123,
    "is_listed": true,
    "price_change_1h": 123,
    "price_change_24h": 123,
    "price_change_7d": 123,
    "price_change_1m": 123,
    "price_change_1y": 123,
    "total_supply": 123,
    "circulating_supply": 123,
    "contracts": [
      {
        "address": "<string>",
        "blockchainId": "<string>",
        "blockchain": "<string>",
        "decimals": 123
      }
    ],
    "native": {
      "name": "<string>",
      "symbol": "<string>",
      "address": "<string>",
      "type": "<string>",
      "decimals": 123,
      "logo": "<string>"
    },
    "priceNative": 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 freshness

Market data is constantly recomputed, in real time. There is no delay except how fast we ingest blocks, which is usually 100-200ms after blocks are emitted.

Pricing model 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. volume is on-chain volume, and off_chain_volume is - as name implies, the off-chain volume.

On some long tail assets, price is diffrent than on CoinGecko or CoinMarketCap. Why?

Mobula uses market-depth-weighted average price, which is more accurate than the simple average price. This is especially important for assets with low / zero volume in the long tail.

How to query native tokens?

To query the native token of any given chain, use asset=0xEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE&blockchain=<blockchain_name or blockchain_id>

Query Parameters

blockchain
string
asset
string
symbol
string
id
number | null

Response

200 - application/json
Market data response
data
object
required