Castle Labs Data
Data API and MCP
Castle's live datasets can be read from code and from AI agents. The JSON API and the MCP server serve the same tables, need no key or sign-up, and return the sources and a citation with every response.
Add https://castlelabs.io/mcp as a remote MCP server in Claude, ChatGPT or Cursor, or call https://castlelabs.io/api/v1/datasets from code. Both are read-only and free. They serve 11 datasets today, refreshed daily: Perp DEX Rankings, Ethereum L2 Economics, Hyperliquid Stats & Revenue, Tokenized Stocks, Institutional Vaults and Curators, Stablecoin Yields, ETH Staking Yield, Major Stablecoins, Tokenized Treasuries, Onchain Commodities, Pre-IPO Markets Onchain.
Connect an AI agent
The server URL is the same for every app. There is nothing to sign in to.
https://castlelabs.io/mcpClaude
In claude.ai or the Claude desktop app, open Customize, then Connectors. Choose + Add, then Add custom connector. Name it Castle Labs, paste the URL above, select No sign in under Authentication and click Add. On Team and Enterprise plans an owner adds it once under Organization settings, Connectors. Steps from Claude's help centre.
Claude Code
claude mcp add --transport http castle-labs https://castlelabs.io/mcpChatGPT
On chatgpt.com, go to Plugins, click +, then Add custom MCP server. Paste the URL above as the Server URL, choose No authentication, then create and install the plugin. Steps from OpenAI's guide.
Cursor
Add the server to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:
{
"mcpServers": {
"castle-labs": {
"url": "https://castlelabs.io/mcp"
}
}
}Other clients
Any client that supports remote MCP servers over Streamable HTTP can connect. The server is stateless and answers protocol versions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.
MCP tools
3 tools · all read-only| # | Tool | Arguments |
|---|---|---|
| 1 | list_datasetsList every dataset the API serves: slug, name, summary, last update, sources, and each table with its row count and columns. Call this first to pick a dataset, table and columns for get_dataset. | none |
| 2 | get_datasetRead rows from one table of a dataset, with optional filters, sort and a row limit (default 25, max 100). Without a table, reads the dataset's first table. String comparisons ignore case. Every result includes the citation and sources to credit. | dataset (required), table, filters, sort, order, fields, limit, offset |
| 3 | search_datasetsFind rows that mention a name or term (a venue, ticker, company or deployer) across every table, plus datasets whose name or description matches, and links to matching datasets that are on castlelabs.io pages only. Use it when you do not know which dataset holds an entity. | query (required), limit |
Try asking: "Which HIP-3 deployer has the most open interest on Hyperliquid today?" or "Rank pre-IPO perps by 24h volume."
JSON API
Version 1 lives at https://castlelabs.io/api/v1. Every endpoint takes GET, allows requests from any origin, and returns JSON. The OpenAPI 3.1 document describes each endpoint and response.
curl https://castlelabs.io/api/v1/datasetscurl "https://castlelabs.io/api/v1/datasets/onchain-commodities/markets?sort=-oiUsd&fields=ticker,oiUsd,dayVolume&limit=5"curl "https://castlelabs.io/api/v1/datasets/onchain-commodities/markets?where=oiUsd:gt:10000000&where=change24h:lt:0"curl "https://castlelabs.io/api/v1/search?q=anthropic"Query parameters
where filters rows as column:operator:value and can be repeated; every filter must match. Operators are eq, ne, gt, gte, lt, lte, contains, in. Text comparisons ignore case, and in takes a comma-separated list. Nested columns use dots, such as latest.depthUsd.
sort takes a column, with a minus sign for descending order. fields picks columns. limit defaults to 25 rows and stops at 100; page on with offset and the nextOffset in each response. A bad column, operator or value returns a 400 with the valid choices.
Stability
Within v1, Castle adds datasets, tables and columns but does not rename or remove endpoints or parameters. A breaking change would ship as /api/v2. Columns follow the daily snapshots, so check the columns list in each response rather than hard-coding every field.
Datasets in the API
11 of 19 live datasets| # | Dataset | Tables | Updated |
|---|---|---|---|
| 1 | Perp DEX Rankingsperp-dex-rankings | hip3-deployers, depth | 18 November 2026 |
| 2 | Ethereum L2 Economicsl2-economics | chains | 18 November 2026 |
| 3 | Hyperliquid Stats & Revenuehyperliquid | hip3-volume-by-deployer, hip3-share-of-volume, hip3-crude-oil-volume | 18 November 2026 |
| 4 | Tokenized Stockstokenized-stocks | stock-perps | 18 November 2026 |
| 5 | Institutional Vaults and Curatorsinstitutional-vaults | morpho-vaults, morpho-curators | 18 November 2026 |
| 6 | Stablecoin Yieldsstablecoin-yields | rates | 18 November 2026 |
| 7 | ETH Staking Yieldeth-staking-yield | tokens, queue | 18 November 2026 |
| 8 | Major Stablecoinsstablecoins | tokens, savings | 18 November 2026 |
| 9 | Tokenized Treasuriestokenized-treasuries | funds, chains | 18 November 2026 |
| 10 | Onchain Commoditiesonchain-commodities | markets, daily-volume, other-dexes | 18 November 2026 |
| 11 | Pre-IPO Markets Onchainpre-ipo-markets | markets | 18 November 2026 |
Sources: Hyperliquid API, growthepie, Morpho API (Copyright 2026 MORPHO, all rights reserved), Public blockchains, read by Castle Labs (token and protocol contracts on Ethereum and other EVM chains, Stellar, Solana and the XRP Ledger), TradeXYZ, Entropy and Paragon contract specs, credited in every response. The other live datasets are on their pages: Crypto Revenue Rankings, Crypto Token Buybacks, Bitcoin $100K Odds, Prediction Markets Volume, Morpho Stats, Stablecoin Chains, RWA Yields Beyond Treasuries, Crypto Cards Compared.
How to cite the data
Every response has an attribution block with a ready-made citation, the dataset page and the upstream sources. Name Castle Labs and the dataset, link the page, give the date of the data, and credit the sources listed. For example:
Castle Labs, "Onchain Commodities", https://castlelabs.io/research/onchain-commodities, data as of 18 November 2026.
The full list of Castle datasets, with sources and raw files, is on the datasets page.
Questions
- Is the Castle Labs data API free?
- Yes. The JSON API at https://castlelabs.io/api/v1 and the MCP server at https://castlelabs.io/mcp need no key, account or sign-up, and both are read-only. Each response includes a citation and the upstream sources to credit.
- Which AI apps can use the Castle Labs MCP server?
- Claude (web, desktop and Claude Code), ChatGPT, Cursor and any other client that supports remote MCP servers over Streamable HTTP. The server speaks MCP protocol versions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.
- Which datasets can I query?
- 11 of Castle's 19 live datasets: Perp DEX Rankings, Ethereum L2 Economics, Hyperliquid Stats & Revenue, Tokenized Stocks, Institutional Vaults and Curators, Stablecoin Yields, ETH Staking Yield, Major Stablecoins, Tokenized Treasuries, Onchain Commodities, Pre-IPO Markets Onchain. More will be added once Castle has cleared re-serving them with each data source. Until then the others are on their castlelabs.io pages, with their sources listed.
- How often does the data change?
- The snapshots behind the API refresh once a day, the same files the castlelabs.io pages use. Every response carries an updatedAt timestamp, and responses are cached for five minutes at most.