Skip to main content
GET
/
v1
/
chains
/
{chainAlias}
/
tokens
/
{tokenAliasOrTokenAddress}
/
price
/
timeseries
Get historical BTC price time-series
curl --request GET \
  --url https://api.moralis.com/v1/chains/{chainAlias}/tokens/{tokenAliasOrTokenAddress}/price/timeseries \
  --header 'X-Api-Key: <api-key>'
{
  "cursor": "eyJhbGciOi...VCaaw",
  "chain": "bitcoin",
  "fromDate": "2025-01-01T00:00:00.000Z",
  "toDate": "2025-01-07T00:00:00.000Z",
  "interval": "5m",
  "page": 1,
  "result": [
    {
      "timestamp": "2025-01-02T09:00:00.000Z",
      "price": "0.00123"
    }
  ],
  "meta": {
    "syncedAt": {
      "bitcoin": "latest"
    }
  }
}
For BTC, pass bitcoin as chainAlias and native as tokenAliasOrTokenAddress.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
chainAlias
enum<string>
required

Bitcoin chain alias. Pass bitcoin or bitcoin-mainnet.

Available options:
bitcoin,
bitcoin-mainnet
​
tokenAliasOrTokenAddress
enum<string>
required

For BTC price, pass native.

Available options:
native

Query Parameters

​
limit
number
default:100

The limit per page

Required range: 1 <= x <= 100
​
cursor
string

The cursor to the next page

​
interval
enum<string>
default:5m

The time interval for price data points. Defaults to 5m if not provided.

Available options:
5m,
hourly,
daily,
weekly,
monthly
Example:

"hourly"

​
fromDate
string

The starting date (format in seconds or datestring accepted by momentjs). Defaults to 24 hours before toDate if not provided.

Example:

"2025-01-01T00:00:00Z"

​
toDate
string

The ending date (format in seconds or datestring accepted by momentjs). Defaults to now if not provided.

Example:

"2025-01-07T00:00:00Z"

​
forwardFill
boolean
default:false

When true, fills gaps in the time series with interpolated values

Response

200 - application/json
​
cursor
string | null
required

The cursor to be used for getting the next page of results

Example:

"eyJhbGciOi...VCaaw"

​
chain
string
required

The blockchain network chain ID

Example:

"bitcoin"

​
fromDate
string
required

The starting date of the time series in ISO 8601 format

Example:

"2025-01-01T00:00:00.000Z"

​
toDate
string
required

The ending date of the time series in ISO 8601 format

Example:

"2025-01-07T00:00:00.000Z"

​
interval
enum<string>
required

The time interval used for the price data points

Available options:
5m,
hourly,
daily,
weekly,
monthly
Example:

"5m"

​
page
number
required

The current page number

Example:

1

​
result
object[]
required

The list of price data points

​
meta
object
required