> ## Documentation Index > Fetch the complete documentation index at: https://docs.messari.io/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## 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: ```bash theme={null} 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](/api-reference/endpoints/bulk/get-v1-datasets-datasetSlug-granularity-data) with the appropriate `datasetSlug` and `granularity` values. ## OpenAPI ````yaml GET /bulk/v1/datasets openapi: 3.0.0 info: description: >- The Bulk API provides access to download large timeseries datasets in CSV or JSONL format. This API is optimized for downloading historical data at scale, supporting multiple granularities and dataset types. title: Messari API - Bulk V1 version: 1.0.0 servers: - description: Messari Bulk API url: https://api.messari.io security: - ApiKeyAuth: [] paths: /bulk/v1/datasets: get: tags: - Bulk API description: >- 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. operationId: GetBulkDatasets responses: '200': description: Successfully retrieved available datasets content: application/json: schema: $ref: '#/components/schemas/BulkCatalog' example: 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 '401': description: Unauthorized - missing or invalid API key content: application/json: schema: properties: error: type: string type: object '500': description: Internal server error content: application/json: schema: properties: error: type: string type: object components: schemas: BulkCatalog: type: object properties: datasets: type: array items: $ref: '#/components/schemas/BulkDataset' BulkDataset: type: object properties: name: type: string description: Human-readable name of the dataset slug: type: string description: URL-safe identifier for the dataset description: type: string description: Detailed description of what data this dataset contains tier: type: string enum: - FREE - PROFESSIONAL - ENTERPRISE description: Minimum subscription tier required to access this dataset columns: type: array items: $ref: '#/components/schemas/BulkColumn' description: List of columns available in this dataset granularities: type: array items: type: string enum: - 1d - 1w description: Available time granularities for this dataset BulkColumn: type: object properties: name: type: string description: Human-readable name of the column slug: type: string description: Column identifier used in the data output description: type: string description: Detailed description of what this column represents type: type: string enum: - string - float - integer - timestamp - boolean description: Data type of the column securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-messari-api-key description: >- API key for authentication. Get your key at https://messari.io/account/api ````