Skip to main content
GET
/
bulk
/
v1
/
datasets
cURL
curl --request GET \
  --url https://api.messari.io/bulk/v1/datasets \
  --header 'x-messari-api-key: <api-key>'
{
  "error": null,
  "data": {
    "datasets": [
      {
        "name": "Asset Price",
        "slug": "asset-price",
        "description": "Daily volume weighted average price and volume for an asset",
        "tier": "enterprise",
        "columns": [
          {
            "name": "Open Price",
            "slug": "open",
            "description": "Price at the candle open.",
            "type": "float64"
          },
          {
            "name": "High Price",
            "slug": "high",
            "description": "High price during the candle.",
            "type": "float64"
          },
          {
            "name": "Low Price",
            "slug": "low",
            "description": "Low price during the candle.",
            "type": "float64"
          },
          {
            "name": "Close Price",
            "slug": "close",
            "description": "Price at the candle close.",
            "type": "float64"
          },
          {
            "name": "Volume",
            "slug": "volume",
            "description": "Volume traded during candle.",
            "type": "float64"
          }
        ],
        "granularities": [
          "1d",
          "1w"
        ]
      },
      {
        "name": "Market",
        "slug": "market",
        "description": "Market time series data.",
        "tier": "enterprise",
        "columns": [
          {
            "name": "Open Price",
            "slug": "open-price",
            "description": "USD price at the candle open.",
            "type": "float64"
          },
          {
            "name": "Open Price Raw",
            "slug": "open-price-raw",
            "description": "Raw price at the candle open.",
            "type": "float64"
          },
          {
            "name": "High Price",
            "slug": "high-price",
            "description": "High USD price during the candle.",
            "type": "float64"
          },
          {
            "name": "High Price Raw",
            "slug": "high-price-raw",
            "description": "Raw high price during the candle.",
            "type": "float64"
          },
          {
            "name": "Low Price",
            "slug": "low-price",
            "description": "Low USD price during the candle.",
            "type": "float64"
          },
          {
            "name": "Low Price Raw",
            "slug": "low-price-raw",
            "description": "Raw low price during the candle.",
            "type": "float64"
          },
          {
            "name": "Close Price",
            "slug": "close-price",
            "description": "USD price at the candle close.",
            "type": "float64"
          },
          {
            "name": "Close Price Raw",
            "slug": "close-price-raw",
            "description": "Raw price at the candle close.",
            "type": "float64"
          },
          {
            "name": "Volume",
            "slug": "volume",
            "description": "Volume traded during candle.",
            "type": "float64"
          },
          {
            "name": "Volume Raw",
            "slug": "volume-raw",
            "description": "Raw volume traded during candle.",
            "type": "float64"
          }
        ],
        "granularities": [
          "1d",
          "1w"
        ]
      }
    ]
  }
}

​
Overview

This endpoint returns a catalog of all bulk datasets available to you based on your subscription tier. Each dataset includes metadata about available columns, supported granularities, and the minimum tier required for access.

​
Response Structure

The response includes an array of datasets, where each dataset contains:
  • name: Human-readable name of the dataset
  • slug: URL-safe identifier used in download requests
  • description: Detailed explanation of the dataset contents
  • tier: Minimum subscription tier required (FREE, PROFESSIONAL, or ENTERPRISE)
  • columns: Array of available columns with their names, slugs, descriptions, and data types
  • granularities: Supported time intervals for this dataset (e.g., 1h, 1d)

​
Usage Example

Use this endpoint to discover what data is available to you before making download requests: 
curl -X GET "https://api.messari.io/bulk/v1/datasets" \
  -H "x-messari-api-key: YOUR_API_KEY"

​
Subscription Tier Access

Different datasets require different subscription tiers:
  • FREE: Access to basic datasets
  • PROFESSIONAL: Additional datasets with more metrics
  • ENTERPRISE: Full access to all bulk datasets including premium metrics

​
Next Steps

After identifying the dataset you want to download, use the Download Dataset endpoint with the appropriate datasetSlug and granularity values.

Authorizations

​
x-messari-api-key
string
header
required

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

Response

Successfully retrieved available datasets

​
datasets
object[]