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 Marketcap",
"slug": "asset-marketcap",
"description": "Daily market capitalization for an asset",
"tier": "enterprise",
"columns": [
{
"name": "Circulating Marketcap",
"slug": "circulating-marketcap",
"description": "The market capitalization of the asset, calculated using the circulating supply",
"type": "float64"
},
{
"name": "Circulating Marketcap Dominance",
"slug": "circulating-marketcap-dominance",
"description": "The market capitalization of the asset as a percentage of the total market capitalization of all crypto assets",
"type": "float64"
},
{
"name": "Fully Diluted Marketcap",
"slug": "fully-diluted-marketcap",
"description": "The market capitalization of the asset, calculated using the fully diluted supply. Commonly known as Fully Diluted Valuation (FDV).",
"type": "float64"
}
],
"granularities": [
"1d",
"1w"
]
},
{
"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": "Asset Supply",
"slug": "asset-supply",
"description": "Daily supply metrics for an asset",
"tier": "enterprise",
"columns": [
{
"name": "Circulating Supply",
"slug": "circulating-supply",
"description": "The number of tokens that exist, excluding those that are locked in contracts or otherwise not available for trading",
"type": "float64"
},
{
"name": "Total Supply",
"slug": "total-supply",
"description": "The total number of tokens that exist",
"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"
]
}
]
}
}Bulk API
Get Available Datasets
Lists all bulk datasets available to the authenticated user based on their subscription tier. Each dataset includes its name, slug, description, required tier, available columns, and supported granularities.
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 Marketcap",
"slug": "asset-marketcap",
"description": "Daily market capitalization for an asset",
"tier": "enterprise",
"columns": [
{
"name": "Circulating Marketcap",
"slug": "circulating-marketcap",
"description": "The market capitalization of the asset, calculated using the circulating supply",
"type": "float64"
},
{
"name": "Circulating Marketcap Dominance",
"slug": "circulating-marketcap-dominance",
"description": "The market capitalization of the asset as a percentage of the total market capitalization of all crypto assets",
"type": "float64"
},
{
"name": "Fully Diluted Marketcap",
"slug": "fully-diluted-marketcap",
"description": "The market capitalization of the asset, calculated using the fully diluted supply. Commonly known as Fully Diluted Valuation (FDV).",
"type": "float64"
}
],
"granularities": [
"1d",
"1w"
]
},
{
"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": "Asset Supply",
"slug": "asset-supply",
"description": "Daily supply metrics for an asset",
"tier": "enterprise",
"columns": [
{
"name": "Circulating Supply",
"slug": "circulating-supply",
"description": "The number of tokens that exist, excluding those that are locked in contracts or otherwise not available for trading",
"type": "float64"
},
{
"name": "Total Supply",
"slug": "total-supply",
"description": "The total number of tokens that exist",
"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 appropriatedatasetSlug and granularity values.Authorizations
API key for authentication. Get your key at https://messari.io/account/api
Response
Successfully retrieved available datasets
Show child attributes
Show child attributes
⌘I

