Skip to main content
GET
/
1
/
market
/
data
Get market data
curl --request GET \
  --url https://demo-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,
    "liquidityMax": 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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

Deprecated EndpointThis endpoint is deprecated. Please use the new v2 endpoints instead:
  • /api/2/asset/details — For asset-level data (metadata, market data, supply stats) by asset ID or token address
  • /api/2/token/details — For detailed token-level data (holdings, trading activity, volume) by token address and blockchain

​
Query Details

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.
ParameterTypeRequiredDescription
assetstringYesThe asset identifier to query. This can be the token’s name or the contract address.
blockchainstringCond.The blockchain network name or ID where the asset resides. Required if querying by contract address.
shouldFetchPriceChangestring (e.g., “24h”)NoTimeframe for price change calculation. Example: "24h" returns price change over the last 24 hours.
symbolstringCond.Token ticker symbol. If duplicates exist, returns the first match. Use contract + blockchain for accuracy.
idnumberCond.The Asset Unique Identifier to query.

​
Additional Notes

  • 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 different 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>

​
Usage Examples

  • Query by Asset Name
curl -X GET "https://api.mobula.io/api/1/market/data?shouldFetchPriceChange=24h&blockchain=ethereum&asset=cult"
  • Query by Contract Address of Token.
curl -X GET "https://api.mobula.io/api/1/market/data?shouldFetchPriceChange=24h&blockchain=ethereum&asset=0x0000000000c5dc95539589fbd24be07c6c14eca4"
  • Query by Query Native Token.
curl -X GET "https://api.mobula.io/api/1/market/data?shouldFetchPriceChange=24h&blockchain=ethereum&asset=0xEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE"
  • Query by Asset id.
curl -X GET "https://api.mobula.io/api/1/market/data?shouldFetchPriceChange=24h&id=100"

Query Parameters

​
blockchain
string

Blockchain name or chain ID

​
asset
string

Token contract address or name

​
symbol
string

Token symbol

​
id
number | null

Asset ID

Response

200 - application/json

Market data response

​
data
object
required