Skip to main content
GET
/
1
/
market
/
history
Get market history
curl --request GET \
  --url https://explorer-api.mobula.io/api/1/market/history
{
  "data": {
    "price_history": [
      [
        123
      ]
    ],
    "volume_history": [
      [
        123
      ]
    ],
    "market_cap_history": [
      [
        123
      ]
    ],
    "market_cap_diluted_history": [
      [
        123
      ]
    ],
    "name": "<string>",
    "symbol": "<string>",
    "blockchain": "<string>",
    "address": "<string>"
  }
}
Timestamps are in MS, it’s JS timestamps.

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.
ParameterTypeDescription
assetstringAsset name or contract address. If an address is provided, you must also provide blockchain.
blockchainstringBlockchain identifier (e.g., "ethereum", "base"). Required when asset is an address.
symbolstringToken ticker symbol (e.g., "ETH"). Optional alternative to asset.
idnumberMobula’s internal asset ID (numeric identifier).
periodstringCandle resolution. Supported: 5m, 15m, 1h, 6h, 1d. Defaults to auto-granularity.
fromnumberStart timestamp (ms). Defaults to 0 (epoch).
tonumberEnd timestamp (ms). Defaults to current time.

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. Data granularity is designed as follows:
  • 5 minutes for the last 7 days
  • 6 hours for the last 30 days
  • 1 day for the remaining of history

Granularity settings

You can set the granularity of the data by adding the period parameter.
  • 5m for 5 minutes
  • 15m for 15 minutes
  • 1h for 1 hour
  • 6h for 6 hours
  • 1d for 1 day

Usage Example:

  • Query by Asset and Time Range
curl -X GET "https://api.mobula.io/api/1/market/history?from=1754337900000&to=1754721284970&asset=0x0000000000c5dc95539589fbd24be07c6c14eca4"
  • Query by Asset and Period
curl -X GET "https://api.mobula.io/api/1/market/history?to=1754721284970&period=1h&asset=0xc4ce8e63921b8b6cbdb8fcb6bd64cc701fb926f2&blockchain=ethereum"

Query Parameters

blockchain
string
asset
string
symbol
string
period
string
id
number | null
from
number | null
default:0
to
number | null
default:1758784063345

Response

200 - application/json

Market history response

data
object
required
I