Skip to main content
GET
/
1
/
market
/
history
/
pair
Get market history pair
curl --request GET \
  --url https://demo-api.mobula.io/api/1/market/history/pair
{
  "data": [
    {
      "volume": 123,
      "open": 123,
      "high": 123,
      "low": 123,
      "close": 123,
      "time": 123
    }
  ]
}
Legacy EndpointThis endpoint is deprecated. Please use the new v2 endpoints instead:

​
Query Details

Input in “address” field the contract address of the pair/pool you want to query. You can also query via asset explained in great details here and it will return the largest pair’s data for this asset (the input is the “asset” input, you cannot use symbol here). By default, MEV data is not included in the response. By default, the currency is USD. You can set it to base token by setting “usd” param to false.
ParameterTypeDescription
blockchainstringBlockchain identifier (e.g., "ethereum", "bsc", "solana"). Automatically normalized.
assetstringAsset name or identifier. Returns data for the most liquid pair of the asset.
symbolstringToken ticker symbol (e.g., "ETH"). Optional, not used when querying by asset.
addressstringContract address of the pair or pool. Takes priority over asset and symbol.
baseTokenstringContract address of the base token in the pair. Normalized automatically.
fromnumberStart of the timeframe (Unix timestamp in ms). Defaults to 0.
tonumberEnd of the timeframe (Unix timestamp in ms). Defaults to current time.
periodstringCandle resolution. Options: 1s, 5s, 15s, 30s, 1min, 5min, 15min, 1h, 4h, 1d, 7d, 30d. Default: 5m.
amountnumberNumber of candles to return. Defaults to 1000. Overrides from/to if both are set.
usdbooleanPrice reference mode. true = USD (default), false = base token pricing.
modeenumData source mode. "pool" (default) returns pool-specific data, "asset" aggregates by asset.

​
Data details

Available resolutions:
  • 1s
  • 5s
  • 15s
  • 30s
  • 1min
  • 5min
  • 15min
  • 1h
  • 4h
  • 1d
  • 7d
  • 30d

​
Troubleshoot

By default, the amount param is set to 1000, and has priority over from/to params - which means if you set a very large timeframe, which low granularity, and don’t adapt the amount parameter, it will be capped at 1000 entries. You can increase the amount parameter to get more data points.

​
Get a specific timeframe

The current endpoint is designed to serve TradingView user interface, which isn’t thinking with timeframes but with candle amounts. If no trades are happening in a given timeframe, the amount of candles will be reduced to the amount of intervals where trades happened. To get a specific timeframe, you can use the from and to parameters, coupled with “amount” being set to : to - from / resolution - and filter out manually the data points that are not in the timeframe you want.

​
Usage Example:

  • Query by Address, Period, USD, and Time Range
curl -X GET "https://api.mobula.io/api/1/market/history/pair?period=15min&blockchain=ethereum&to=1754313334939&from=1754310600000&amount=3&address=0xefb47fcfcad4f96c83d4ca676842fb03ef20a477&usd=true"

Query Parameters

​
blockchain
string

Blockchain name or chain ID

​
asset
string

Token contract address

​
symbol
string

Token symbol

​
address
string

Pool/pair address

​
baseToken

Base token address

​
from

Start date (timestamp or ISO string)

​
to

End date (timestamp or ISO string)

​
period
string

Candle period (e.g., "5m", "1h", "24h")

​
amount
number | null

Token amount for price calculation

Response

200 - application/json

Market history response

​
data
object[]
required