GET
/
1
/
market
/
data
Get 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
​
shouldFetchPriceChange
default:24h
Available options:
24h

Response

200 - application/json

Market data response

The response is of type object.