Download Dataset - Messari Docs

cURL

curl --request GET \
  --url https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data \
  --header 'x-messari-api-key: <api-key>'

import requests

url = "https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data"

headers = {"x-messari-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-messari-api-key': '<api-key>'}};

fetch('https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-messari-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-messari-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data")
  .header("x-messari-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-messari-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

"asset_id,timestamp,price_usd,market_cap_usd\nbtc,2024-01-01T00:00:00Z,42500.50,834215000000\neth,2024-01-01T00:00:00Z,2250.75,270500000000\n"

GET

bulk

datasets

{datasetSlug}

{granularity}

data

cURL

curl --request GET \
  --url https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data \
  --header 'x-messari-api-key: <api-key>'

import requests

url = "https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data"

headers = {"x-messari-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-messari-api-key': '<api-key>'}};

fetch('https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-messari-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-messari-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data")
  .header("x-messari-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.messari.io/bulk/v1/datasets/{datasetSlug}/{granularity}/data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-messari-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

"asset_id,timestamp,price_usd,market_cap_usd\nbtc,2024-01-01T00:00:00Z,42500.50,834215000000\neth,2024-01-01T00:00:00Z,2250.75,270500000000\n"

Overview

Downloads bulk timeseries data for a specific dataset at the specified granularity. The data is streamed directly as a file in either CSV or JSONL format, making it ideal for large-scale data downloads.

Path Parameters

datasetSlug (required): The slug identifier of the dataset to download. Use the Get Available Datasets endpoint to discover available dataset slugs.
granularity (required): The time interval for the data points. Available options: 1d, 1w

Query Parameters

rangeStart (required): Start of the time range in ISO 8601 format (e.g., 2024-01-01T00:00:00Z)
rangeEnd (required): End of the time range in ISO 8601 format (e.g., 2024-12-31T23:59:59Z)
format (optional): Output format - either csv (default) or jsonl

Output Formats

CSV Format

Comma-separated values with a header row. Compatible with Excel, Google Sheets, pandas, and most data analysis tools.

asset_id,timestamp,price_usd,market_cap_usd,volume_24h
btc,2024-01-01T00:00:00Z,42500.50,834215000000,18234567890
eth,2024-01-01T00:00:00Z,2250.75,270500000000,8945123456

JSONL Format

JSON Lines format with one JSON object per line. Ideal for streaming processing and database imports.

{"asset_id":"btc","timestamp":"2024-01-01T00:00:00Z","price_usd":42500.50,"market_cap_usd":834215000000,"volume_24h":18234567890}
{"asset_id":"eth","timestamp":"2024-01-01T00:00:00Z","price_usd":2250.75,"market_cap_usd":270500000000,"volume_24h":8945123456}

Time Range Limits

To prevent excessive data downloads, time ranges are limited based on granularity:

1d: Maximum 365 days per request
1w: Maximum 1095 days (3 years) per request

For larger time ranges, make multiple requests with different date ranges.

Usage Examples

Download CSV Data

curl -X GET "https://api.messari.io/bulk/v1/datasets/asset_price/1d/data?rangeStart=2024-01-01T00:00:00Z&rangeEnd=2024-12-31T23:59:59Z&format=csv" \
  -H "x-messari-api-key: YOUR_API_KEY" \
  -o asset_price_data.csv

Download JSONL Data

curl -X GET "https://api.messari.io/bulk/v1/datasets/asset_price/1h/data?rangeStart=2024-01-01T00:00:00Z&rangeEnd=2024-01-31T23:59:59Z&format=jsonl" \
  -H "x-messari-api-key: YOUR_API_KEY" \
  -o asset_price_data.jsonl

Python Example with pandas

import pandas as pd
import requests

url = "https://api.messari.io/bulk/v1/datasets/asset_price/1d/data"
params = {
    "rangeStart": "2024-01-01T00:00:00Z",
    "rangeEnd": "2024-12-31T23:59:59Z",
    "format": "csv"
}
headers = {"x-messari-api-key": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers)
df = pd.read_csv(pd.io.common.BytesIO(response.content))
print(df.head())

Response Headers

The response includes helpful headers:

Content-Type: text/csv; charset=utf-8 or application/x-ndjson
Content-Disposition: Suggests a filename for the download (e.g., asset_price_1d_2024-01-01_2024-12-31.csv)
Content-Encoding: gzip if compression is applied

Error Responses

400 Bad Request

Invalid date format
End date before start date
Time range exceeds maximum allowed for the granularity
Invalid format parameter

403 Forbidden

Your subscription tier does not have access to this dataset

404 Not Found

Dataset slug does not exist
Granularity not supported for this dataset

Best Practices

Start with the datasets catalog: Always check available datasets first to see supported granularities
Respect time range limits: Break large downloads into smaller time windows
Use appropriate granularity: Choose the coarsest granularity that meets your needs to reduce data transfer
Handle errors gracefully: Implement retry logic for transient network errors
Store data efficiently: Consider using columnar formats like Parquet for long-term storage after download

Authorizations

x-messari-api-key

string

header

required

API key for authentication. Get your key at https://messari.io/account/api

Path Parameters

datasetSlug

enum<string>

default:asset-price

required

Dataset slug identifier. Use /bulk/v1/datasets to see all available datasets.

Available options:

asset-marketcap,

asset-price,

asset-supply,

market

granularity

enum<string>

default:1d

required

Data granularity interval

Available options:

1d,

1w

Query Parameters

rangeStart

string<date-time>

default:2025-10-01T00:00:00Z

required

Start of time range in ISO 8601 format

Example:

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

rangeEnd

string<date-time>

default:2025-10-07T23:59:59Z

required

End of time range in ISO 8601 format

Example:

"2025-10-07T23:59:59Z"

format

enum<string>

default:csv

Output format for the data

Available options:

csv,

jsonl

Response

Successfully generated and streaming bulk data file

The response is of type file.

Get Available Datasets Watchlists API

⌘I

​Overview

​Path Parameters

​Query Parameters

​Output Formats

​CSV Format

​JSONL Format

​Time Range Limits

​Usage Examples

​Download CSV Data

​Download JSONL Data

​Python Example with pandas

​Response Headers

​Error Responses

​400 Bad Request

​403 Forbidden

​404 Not Found

​Best Practices

Authorizations

Path Parameters

Query Parameters

Response

Overview

Path Parameters

Query Parameters

Output Formats

CSV Format

JSONL Format

Time Range Limits

Usage Examples

Download CSV Data

Download JSONL Data

Python Example with pandas

Response Headers

Error Responses

400 Bad Request

403 Forbidden

404 Not Found

Best Practices