# Blockworks Documentation > The Blockworks Platform for onchain data, market intelligence, and research-grade metrics. ## Welcome ### Welcome - [Blockworks Docs](https://docs.blockworks.com/introduction.md): One account and one API key for institutional-grade crypto data, delivered as a REST API, an event feed, an MCP server, warehouse Datashares, and plugins. - [Authentication](https://docs.blockworks.com/getting-started/authentication.md): Authenticate every Blockworks API request with an API key sent in the X-Blockworks-API-Key header. - [Data API (290 pages)](https://docs.blockworks.com/_llms/data-api.md): Documentation for Data API. ## Monitoring ### Getting Started - [Overview](https://docs.blockworks.com/api-reference/monitoring/overview.md): Programmatic access to AI-surfaced, analyst-verified events across 1,000+ assets and 700+ sources. - [Webhooks](https://docs.blockworks.com/api-reference/monitoring/webhooks.md): Receive monitoring alerts as signed HTTP POST requests: payload format, signature verification, and retry behavior. - [Telegram Alerts](https://docs.blockworks.com/api-reference/monitoring/telegram.md): Deliver monitoring alerts into a Telegram direct message or group chat: connecting the bot, connection states, and troubleshooting. ### API - [Quickstart](https://docs.blockworks.com/api-reference/monitoring/quickstart.md): Get an API key, pull your first verified developments, and subscribe to the ones that matter. #### Categories - [List Categories](https://docs.blockworks.com/api-reference/monitoring/get-v2-categories.md): Retrieve the full intel taxonomy: top-level categories and their nested subcategories. #### Developments - [List Developments](https://docs.blockworks.com/api-reference/monitoring/get-v2-developments.md): Paginated list of developments with filtering by asset, category, subcategory, importance, and time range. - [Get Development](https://docs.blockworks.com/api-reference/monitoring/get-v2-developments-developmentId.md): Retrieve a single development by ID, including its taxonomy tags, resolved assets, and parent event reference. #### Events - [List Events](https://docs.blockworks.com/api-reference/monitoring/get-v2-events.md): Paginated list of events. Events group related developments over time and share the developments filter surface. - [Get Event](https://docs.blockworks.com/api-reference/monitoring/get-v2-events-eventId.md): Retrieve a single event by ID, along with the developments nested under it. #### Monitoring Views - [List Monitoring Views](https://docs.blockworks.com/api-reference/monitoring/get-v2-monitoring-views.md): Paginated list of the monitoring views the caller can read, including personal and team-shared views. - [Get Monitoring View](https://docs.blockworks.com/api-reference/monitoring/get-v2-monitoring-views-monitoringViewId.md): Retrieve a monitoring view definition and its aggregate stats by UUID or slug-with-id-prefix. - [Developments Matched by a View](https://docs.blockworks.com/api-reference/monitoring/get-v2-monitoring-views-monitoringViewId-developments.md): Paginated developments matching a saved monitoring view's predicates, with optional free-text search. - [Events Matched by a View](https://docs.blockworks.com/api-reference/monitoring/get-v2-monitoring-views-monitoringViewId-events.md): Paginated events matching a saved monitoring view's predicates, with optional free-text search. - [All Matched Developments](https://docs.blockworks.com/api-reference/monitoring/get-v2-monitoring-views-all-developments.md): Deduplicated union of developments matching any monitoring view the caller can access. - [All Matched Events](https://docs.blockworks.com/api-reference/monitoring/get-v2-monitoring-views-all-events.md): Deduplicated union of events matching any monitoring view the caller can access. #### Watchlists - [Watchlists API](https://docs.blockworks.com/api-reference/monitoring/watchlists/overview.md): Create and manage named sets of assets tied to your account, then reuse them to scope queries across the Blockworks API. - [Get Watchlists](https://docs.blockworks.com/api-reference/monitoring/watchlists/list.md): Returns every watchlist available to the authenticated account, each with its metadata and the asset IDs it contains. - [Create Watchlist](https://docs.blockworks.com/api-reference/monitoring/watchlists/create.md): Creates a new watchlist from a title and a list of asset UUIDs. - [Get Watchlist Details](https://docs.blockworks.com/api-reference/monitoring/watchlists/get.md): Returns the full details of a single watchlist by ID, including its metadata and every asset ID it contains. - [Update Watchlist](https://docs.blockworks.com/api-reference/monitoring/watchlists/update.md): Updates a watchlist's title, and optionally replaces its entire asset list. - [Update Watchlist Assets](https://docs.blockworks.com/api-reference/monitoring/watchlists/update-assets.md): Adds or removes specific assets in a watchlist without replacing the full asset list. - [Delete Watchlist](https://docs.blockworks.com/api-reference/monitoring/watchlists/delete.md): Permanently deletes a watchlist by ID. The deletion cannot be undone. ## Token Unlocks ### Getting Started - [Overview](https://docs.blockworks.com/api-reference/token-unlocks/overview.md): Analyst-modeled token unlock schedules: who holds what, when it vests, and how much supply lands in any given week. - [Quickstart](https://docs.blockworks.com/api-reference/token-unlocks/quickstart.md): Get an API key, find an asset with unlock coverage, and pull its next cliff and its supply schedule. ### API #### Assets - [List Covered Assets](https://docs.blockworks.com/api-reference/token-unlocks/get-v1-assets.md): Every asset with token unlock coverage, filterable by category, sector, tags, or asset UUID. - [Get Unlock Events](https://docs.blockworks.com/api-reference/token-unlocks/get-v1-assets-assetId-events.md): The dated points where an asset's unlock schedule changes: cliffs and linear rate changes, past and projected. - [Get Unlocks Timeseries](https://docs.blockworks.com/api-reference/token-unlocks/get-v1-assets-assetId-unlocks.md): Tokens unlocked per interval, in total and per recipient. The flow view of a vesting schedule. - [Get Vesting Schedule](https://docs.blockworks.com/api-reference/token-unlocks/get-v1-assets-assetId-vesting-schedule.md): Daily cumulative unlock state: how much has vested, how much remains, and what share of the allocation is complete. #### Allocations - [Get Allocations](https://docs.blockworks.com/api-reference/token-unlocks/get-v1-allocations.md): Allocation totals for an asset, broken down by recipient, with the analyst notes and citations behind each tranche. ## MCP Server ### Getting Started - [Overview](https://docs.blockworks.com/mcp/overview.md): A fully hosted Model Context Protocol server that connects AI assistants, agent frameworks, and your own products to Blockworks onchain data and crypto intelligence. - [MCP Quickstart](https://docs.blockworks.com/mcp/quickstart.md): Connect an AI assistant to the Blockworks MCP server and run your first prompt in a few minutes. - [Client Setup](https://docs.blockworks.com/mcp/clients.md): Connect Claude, Claude Code, Claude Desktop, Cursor, ChatGPT, or any other MCP client to the Blockworks MCP server. ### Guides - [What to Ask](https://docs.blockworks.com/mcp/prompts.md): Example prompts for an assistant connected to the Blockworks MCP server, grouped by use case. - [Troubleshooting](https://docs.blockworks.com/mcp/troubleshooting.md): Fixes for authentication loops, invalid API keys, stale OAuth credentials, and connection problems with the Blockworks MCP server. ### Tools Reference - [Tools Reference](https://docs.blockworks.com/mcp/tools/overview.md): Every tool the Blockworks MCP server exposes, what each one is for, and which to reach for first. - [Document Search](https://docs.blockworks.com/mcp/tools/search.md): search_documents finds research, news, and curated source documents relevant to a question, with the content and citations attached. - [Tabular Datasets](https://docs.blockworks.com/mcp/tools/datasets.md): tabular_catalog and tabular_data browse the row-and-column models, then read rows with filters, sorting, and pagination. - [Timeseries](https://docs.blockworks.com/mcp/tools/timeseries.md): timeseries_catalog and timeseries_data let you discover what metric series exist, then pull the exact data points at the granularity and window you want. ## Datashares ### Getting Started - [Overview](https://docs.blockworks.com/datashare/overview.md): Blockworks datasets delivered natively into your own data warehouse: SQL access at warehouse scale, no ETL. ### Snowflake - [Getting Access](https://docs.blockworks.com/datashare/snowflake/getting-access.md): Request the Blockworks Snowflake Datashare and mount it in your Snowflake account. - [Querying the Share](https://docs.blockworks.com/datashare/snowflake/querying.md): Discover the schemas and views in the Blockworks Snowflake Datashare and query them with ordinary SQL. ## Plugins ### Getting Started - [Overview](https://docs.blockworks.com/spreadsheets/overview.md): Blockworks plugins put Blockworks data inside the tools you already use: spreadsheet plugins for Google Sheets and Excel today, with plugins for AI assistants next. ### Spreadsheets - [Google Sheets](https://docs.blockworks.com/spreadsheets/google-sheets.md): Install the Messari by Blockworks add-on for Google Sheets and pull Blockworks data into your spreadsheet with native formulas or the Formula Builder. - [Microsoft Excel](https://docs.blockworks.com/spreadsheets/excel.md): Install the Messari by Blockworks add-in for Microsoft Excel and pull Blockworks data into your workbook with native formulas or the Formula Builder. ## OpenAPI Specs - [openapi](/api-reference/data-api/openapi.json) - [openapi](/api-reference/charts/openapi.json) - [openapi](/api-reference/monitoring/openapi.json) - [watchlists-openapi](/api-reference/monitoring/watchlists-openapi.json) - [openapi](/api-reference/token-unlocks/openapi.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Data API (290 pages)](https://docs.blockworks.com/_llms/data-api.md): Documentation for Data API. - [Data API / Real World Assets (60 pages)](https://docs.blockworks.com/_llms/data-api/real-world-assets.md): Documentation for Data API / Real World Assets.