{ "openapi": "3.0.0", "info": { "description": "OpenAPI specification for the entire Messari API", "title": "Messari API - Metrics V2", "version": "1.0.0" }, "servers": [ { "description": "Messari API", "url": "https://api.messari.io" } ], "security": [], "paths": { "/metrics/v2/assets": { "get": { "description": "Retrieve a list of assets", "operationId": "getAssetsV2", "parameters": [ { "description": "Category", "in": "query", "name": "category", "schema": { "type": "string" } }, { "description": "Sector", "in": "query", "name": "sector", "schema": { "type": "string" } }, { "description": "Search by name, symbol, slug, or contract address", "in": "query", "name": "search", "schema": { "type": "string" } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Page number (starts at 1)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Has Diligence", "in": "query", "name": "hasDiligence", "schema": { "type": "boolean", "nullable": true } }, { "description": "Has Intel", "in": "query", "name": "hasIntel", "schema": { "type": "boolean", "nullable": true } }, { "description": "Filter to assets by market data coverage. True when Messari covers market data for the asset. Use it to scope a listing to the assets that carry price, volume and marketcap values. The `firstPriceAt` field reports when that price coverage starts.", "in": "query", "name": "hasMarketData", "schema": { "type": "boolean", "nullable": true } }, { "description": "Has News", "in": "query", "name": "hasNews", "schema": { "type": "boolean", "nullable": true } }, { "description": "Has Proposals", "in": "query", "name": "hasProposals", "schema": { "type": "boolean", "nullable": true } }, { "description": "Has Research", "in": "query", "name": "hasResearch", "schema": { "type": "boolean", "nullable": true } }, { "description": "Has Token Unlocks", "in": "query", "name": "hasTokenUnlocks", "schema": { "type": "boolean", "nullable": true } }, { "description": "Has Fundraising", "in": "query", "name": "hasFundraising", "schema": { "type": "boolean", "nullable": true } }, { "description": "Restrict to assets covered by Messari Monitoring (industry-events coverage)", "in": "query", "name": "coveredByMonitoring", "schema": { "type": "boolean", "nullable": true } }, { "description": "Column to sort by (default: rank)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "symbol", "slug", "category", "sector", "rank" ], "default": "rank" } }, { "description": "Sort direction: asc or desc (default: asc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "asc" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AssetListItem" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/MetricsPagination" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "id": "1e31218a-e44e-4285-820c-8282ee222035", "name": "Bitcoin", "slug": "bitcoin", "symbol": "BTC", "category": "Cryptocurrency", "sector": "Cryptocurrency", "sectorV2": [ "Networks" ], "subSectorV2": [ "Layer-1" ], "tags": [ "Proof-of-Work" ], "rank": 1, "firstPriceAt": "2010-07-21T23:00:00Z", "hasDiligence": true, "hasIntel": true, "hasMarketData": true, "hasNews": true, "hasProposals": false, "hasResearch": true, "hasTokenUnlocks": true, "hasFundraising": true, "coveredByMonitoring": true }, { "id": "21c795f5-1bfd-40c3-858e-e9d7e820c6d0", "name": "Ethereum", "slug": "ethereum", "symbol": "ETH", "category": "Networks", "sector": "Smart Contract Platform", "sectorV2": [ "Networks" ], "subSectorV2": [ "Layer-1" ], "tags": [ "EVM", "Proof-of-Stake", "Stakeable" ], "rank": 2, "firstPriceAt": "2015-08-07T17:15:00Z", "hasDiligence": true, "hasIntel": true, "hasMarketData": true, "hasNews": true, "hasProposals": false, "hasResearch": true, "hasTokenUnlocks": true, "hasFundraising": true, "coveredByMonitoring": true }, { "id": "51f8ea5e-f426-4f40-939a-db7e05495374", "name": "Tether", "slug": "tether", "symbol": "USDT", "category": "Cryptocurrency", "sector": "Stablecoins", "sectorV2": [ "CeFi", "Stablecoins" ], "subSectorV2": [ "U.S. Dollar Stablecoin", "Centralized Issuer", "Fiat-backed Stablecoin" ], "tags": [ "Centralized Issuer", "U.S. Dollar Stablecoin" ], "rank": 3, "firstPriceAt": "2013-12-27T19:05:00Z", "hasDiligence": true, "hasIntel": true, "hasMarketData": true, "hasNews": true, "hasProposals": false, "hasResearch": true, "hasTokenUnlocks": false, "hasFundraising": true, "coveredByMonitoring": true }, { "id": "97775be0-2608-4720-b7af-f85b24c7eb2d", "name": "XRP", "slug": "xrp", "symbol": "XRP", "category": "Financial Services", "sector": "Payments", "sectorV2": [ "CeFi", "Networks" ], "subSectorV2": [ "Centralized Payments", "Layer-1" ], "tags": [ "SEC Alleged Securities" ], "rank": 4, "firstPriceAt": "2015-01-26T08:25:00Z", "hasDiligence": true, "hasIntel": true, "hasMarketData": true, "hasNews": true, "hasProposals": false, "hasResearch": true, "hasTokenUnlocks": true, "hasFundraising": true, "coveredByMonitoring": true }, { "id": "7dc551ba-cfed-4437-a027-386044415e3e", "name": "BNB", "slug": "binance-coin", "symbol": "BNB", "category": "Networks", "sector": "Smart Contract Platform", "sectorV2": [ "Others", "Networks" ], "subSectorV2": [ "SEC Alleged Securities", "Layer-1" ], "tags": [ "CeFi", "Centralized Exchange", "Cosmos SDK", "EVM", "SEC Alleged Securities" ], "rank": 5, "firstPriceAt": "2017-07-14T04:00:00Z", "hasDiligence": true, "hasIntel": true, "hasMarketData": true, "hasNews": true, "hasProposals": false, "hasResearch": true, "hasTokenUnlocks": true, "hasFundraising": true, "coveredByMonitoring": true } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 45190, "totalPages": 4519 } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get assets", "tags": [ "metrics/assets" ] } }, "/metrics/v2/assets/ath": { "get": { "description": "Retrieve a specific asset's ATH", "operationId": "getAssetsATH", "parameters": [ { "description": "Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs", "in": "query", "name": "assetIDs", "schema": { "type": "string", "example": "bitcoin,ethereum" } }, { "description": "Filter By Category", "in": "query", "name": "category", "schema": { "type": "string" } }, { "description": "Filter By Sector", "in": "query", "name": "sector", "schema": { "type": "string" } }, { "description": "Search by name, symbol, slug, or contract address", "in": "query", "name": "search", "schema": { "type": "string" } }, { "description": "Limit", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer" }, "example": 10 }, { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Column to sort by (default: price-change-24h)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "slug", "price-change-24h", "price-change-7d", "price-change-30d", "price-change-1y", "price-change-year-to-date", "all-time-high", "all-time-high-percent-down", "breakeven-multiple", "cycle-low-percent-up" ], "default": "price-change-24h" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AssetComparisonItem" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "id": "b3d5d66c-26a2-404c-9325-91dc714a722b", "name": "Solana", "slug": "solana", "symbol": "SOL", "category": "Networks", "sector": "Smart Contract Platform", "tags": [ "Proof-of-Stake", "SEC Alleged Securities", "Stakeable" ], "allTimeHigh": { "allTimeHigh": 294.51538872508485, "allTimeHighDate": "2025-01-19T11:00:00Z", "allTimeHighTimeSinceSeconds": 50338680, "allTimeHighPercentDown": 65.97545363689574, "breakevenMultiple": 2.939054614654278, "cycleLow": 60.31919725339023, "cycleLowDate": "2026-06-06T05:00:00Z", "cycleLowTimeSinceSeconds": 6901080, "cycleLowPercentUp": 66.12874432378337 } }, { "id": "1e31218a-e44e-4285-820c-8282ee222035", "name": "Bitcoin", "slug": "bitcoin", "symbol": "BTC", "category": "Cryptocurrency", "sector": "Cryptocurrency", "tags": [ "Proof-of-Work" ], "allTimeHigh": { "allTimeHigh": 126238.2220708942, "allTimeHighDate": "2025-10-06T18:00:00Z", "allTimeHighTimeSinceSeconds": 27849480, "allTimeHighPercentDown": 36.99990883191281, "breakevenMultiple": 1.5872992903009508, "cycleLow": 57854.64489846412, "cycleLowDate": "2026-07-01T01:00:00Z", "cycleLowTimeSinceSeconds": 4755480, "cycleLowPercentUp": 37.46553130386083 } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 2, "totalPages": 1 } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get asset ATH", "tags": [ "metrics/assets" ] } }, "/metrics/v2/assets/details": { "get": { "description": "Retrieve a specific asset's details", "operationId": "getAssetDetails", "parameters": [ { "description": "Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs", "in": "query", "name": "assetIDs", "schema": { "type": "string", "example": "bitcoin,ethereum" } }, { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: circulating-marketcap)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "slug", "rank", "price-usd", "circulating-marketcap", "fully-diluted-marketcap", "volume-24h", "price-change-24h", "price-change-7d", "price-change-30d" ], "default": "circulating-marketcap" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/metricsAsset" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "id": "1e31218a-e44e-4285-820c-8282ee222035", "name": "Bitcoin", "slug": "bitcoin", "symbol": "BTC", "rank": 1, "category": "Cryptocurrency", "sector": "Cryptocurrency", "sectorV2": [ "Networks" ], "subSectorV2": [ "Layer-1" ], "tags": [ "Proof-of-Work" ], "description": "Bitcoin is the first distributed,\u00a0[consensus-based](https://messari.io/resource/distributed-systems), censorship-resistant, permissionless, peer-to-peer payment settlement network with a provably scarce, programmable, native currency. The Bitcoin network is an emergent decentralized monetary institution that exists through the interplay of [full nodes](https://messari.io/resource/node),\u00a0[miners](https://messari.io/resource/mining), and developers. Furthermore, it is set by a social contract created and opted into by the network\u2019s users, which is hardened through\u00a0[game theory](https://messari.io/c/resource/game-theory)\u00a0and\u00a0[cryptography](https://messari.io/resource/cryptography).", "links": [ { "name": "Reddit", "url": "https://www.reddit.com/r/Bitcoin/" }, { "name": "Telegram", "url": "http://t.me/bitcoin" }, { "name": "Twitter", "url": "https://x.com/bitcoin" }, { "name": "Whitepaper", "url": "https://bitcoin.org/bitcoin.pdf" }, { "name": "Github", "url": "https://github.com/bitcoin/bitcoin" } ], "marketData": { "priceUsd": 79530.19499363571, "priceBtc": 1, "priceEth": 31.939919414479906, "priceAt": "2026-08-25T01:53:00Z", "firstPriceAt": "2010-07-21T23:00:00Z", "volume24Hour": 25975668831.467796, "ohlcv1HourUsd": { "open": 79731.44807612435, "high": 79973.29513146801, "low": 79490.22256351278, "close": 79530.19499363571, "volume": 881153734.4973136 }, "ohlcv24HourUsd": { "open": 76945.16880393501, "high": 79982.43786068354, "low": 76700.99802998474, "close": 79530.19499363571, "volume": 25975668831.467796 }, "ohlcvTodayUsd": { "open": 78969.81857192001, "high": 79973.29513146801, "low": 78713.25233572445, "close": 79530.19499363571, "volume": 1909062718.4637263 }, "supply": { "circulating": 20071518, "total": 20071518, "max": 21000000 }, "marketcap": { "circulatingUsd": 1603453246717, "fullyDilutedUsd": 1603453246717.211, "dominance": 58.6743 } }, "networkSlugs": [ "bitcoin" ], "protocolSlugs": [], "returnOnInvestment": { "priceChange24h": 3.3958355900563073, "priceChange7d": 23.995486737167784, "priceChange30d": 23.462191512402136, "priceChange1y": -29.655801560914334, "priceChange3y": 205.8709998539287, "priceChange5y": 69.60373417091355, "priceChangeMTD": 26.613560328841533, "priceChangeQTD": 35.82967514844355, "priceChangeYTD": -9.111349105649321 }, "allTimeHigh": { "allTimeHigh": 126238.2220708942, "allTimeHighDate": "2025-10-06T18:00:00Z", "allTimeHighTimeSinceSeconds": 27849480, "allTimeHighPercentDown": 36.99990883191281, "breakevenMultiple": 1.5872992903009508, "cycleLow": 57854.64489846412, "cycleLowDate": "2026-07-01T01:00:00Z", "cycleLowTimeSinceSeconds": 4755480, "cycleLowPercentUp": 37.46553130386083 }, "contractAddresses": [] }, { "id": "b3d5d66c-26a2-404c-9325-91dc714a722b", "name": "Solana", "slug": "solana", "symbol": "SOL", "rank": 7, "category": "Networks", "sector": "Smart Contract Platform", "sectorV2": [ "Others", "Networks" ], "subSectorV2": [ "SEC Alleged Securities", "Layer-1" ], "tags": [ "Proof-of-Stake", "SEC Alleged Securities", "Stakeable" ], "description": "Solana is a Layer-1 blockchain network that provides infrastructure for decentralized applications, emphasizing high throughput, low transaction costs, and support for LLVM-compatible smart contracts. It is designed to minimize performance constraints typically faced by developers.", "links": [ { "name": "CB Insights", "url": "https://www.cbinsights.com/company/solana-labs" }, { "name": "Blog", "url": "https://solana.com/news" }, { "name": "LinkedIn", "url": "https://www.linkedin.com/company/solanalabs" }, { "name": "Pitchbook", "url": "https://pitchbook.com/profiles/company/227820-52" }, { "name": "Crunchbase", "url": "https://www.crunchbase.com/organization/solana-io" } ], "marketData": { "priceUsd": 100.20752498324322, "priceBtc": 0.0012599934526912977, "priceEth": 0.04024408934173235, "priceAt": "2026-08-25T01:53:00Z", "firstPriceAt": "2020-04-10T04:00:00Z", "volume24Hour": 4863256751.275651, "ohlcv1HourUsd": { "open": 101.7656535298781, "high": 102.4290680812433, "low": 100.18401572221552, "close": 100.20752498324322, "volume": 266805954.1508444 }, "ohlcv24HourUsd": { "open": 93.90336625897292, "high": 102.4290680812433, "low": 93.314522452209, "close": 100.20752498324322, "volume": 4863256751.275651 }, "ohlcvTodayUsd": { "open": 98.87996437524579, "high": 102.4290680812433, "low": 98.66351696768402, "close": 100.20752498324322, "volume": 1022135245.942657 }, "supply": { "circulating": 583276610.3383662, "total": 632749687.2066673, "max": 0 }, "marketcap": { "circulatingUsd": 59727232252, "fullyDilutedUsd": 64793176035.49797, "dominance": 2.1856 } }, "networkSlugs": [ "solana" ], "protocolSlugs": [ "solana" ], "returnOnInvestment": { "priceChange24h": 6.758885116117631, "priceChange7d": 32.664251691293394, "priceChange30d": 34.04869001943003, "priceChange1y": -51.56636283183186, "priceChange3y": 394.22506822571836, "priceChange5y": 33.711219771301224, "priceChangeMTD": 37.67550803702086, "priceChangeQTD": 36.22414650182056, "priceChangeYTD": -19.473921604318946 }, "allTimeHigh": { "allTimeHigh": 294.51538872508485, "allTimeHighDate": "2025-01-19T11:00:00Z", "allTimeHighTimeSinceSeconds": 50338680, "allTimeHighPercentDown": 65.97545363689574, "breakevenMultiple": 2.939054614654278, "cycleLow": 60.31919725339023, "cycleLowDate": "2026-06-06T05:00:00Z", "cycleLowTimeSinceSeconds": 6901080, "cycleLowPercentUp": 66.12874432378337 }, "contractAddresses": [ { "networkName": "Solana", "networkSlug": "solana", "contractAddress": "So11111111111111111111111111111111111111112" } ] } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 2, "totalPages": 1 } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get asset details", "tags": [ "metrics/assets" ] } }, "/metrics/v2/assets/metrics": { "get": { "description": "Get metric catalog of datasets for assets.", "operationId": "getAssetsTimeseriesCatalogV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "futures-funding-rate", "granularities": [ "1h", "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Funding Rate (OI Weighted)", "slug": "funding-rate-open-interest", "description": "The funding rate for the asset weighted by the open interest. This is expressed as a percentage, e.g. 0.01 = 1%.", "is_timestamp": false }, { "name": "Funding Rate (Volume Weighted)", "slug": "funding-rate-volume", "description": "The funding rate for the asset weighted by trading volume. This is expressed as a percentage, e.g. 0.01 = 1%.", "is_timestamp": false } ] }, { "slug": "futures-open-interest", "granularities": [ "1h", "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Open Interest", "slug": "open-interest", "description": "The open interest for the asset.", "is_timestamp": false } ] }, { "slug": "futures-volume", "granularities": [ "1h", "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Futures Trade Count", "slug": "trade-count", "description": "The number of trades for the asset on the exchange", "is_timestamp": false }, { "name": "Futures Volume (USD)", "slug": "volume-usd", "description": "The volume of the asset on the exchange in USD", "is_timestamp": false }, { "name": "Futures Volume Buy (USD)", "slug": "volume-buy-usd", "description": "The volume of the asset on the exchange in USD for buy trades", "is_timestamp": false }, { "name": "Futures Volume Sell (USD)", "slug": "volume-sell-usd", "description": "The volume of the asset on the exchange in USD for sell trades", "is_timestamp": false } ] }, { "slug": "marketcap", "granularities": [ "1h", "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Circulating Marketcap", "slug": "circulating-marketcap", "description": "The market capitalization of the asset, calculated using the circulating supply", "is_timestamp": false }, { "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", "is_timestamp": false }, { "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).", "is_timestamp": false } ] }, { "slug": "price", "granularities": [ "5m", "1h", "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Open Price", "slug": "open", "description": "Price at the candle open.", "is_timestamp": false }, { "name": "High Price", "slug": "high", "description": "High price during the candle.", "is_timestamp": false }, { "name": "Low Price", "slug": "low", "description": "Low price during the candle.", "is_timestamp": false }, { "name": "Close Price", "slug": "close", "description": "Price at the candle close.", "is_timestamp": false }, { "name": "Volume", "slug": "volume", "description": "Total trade volume during the candle.", "is_timestamp": false } ] }, { "slug": "sharpe-ratio", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Sharpe Ratio 30D", "slug": "sharpe-ratio-30d", "description": "The Sharpe ratio of the asset over the last 30 days", "is_timestamp": false }, { "name": "Sharpe Ratio 90D", "slug": "sharpe-ratio-90d", "description": "The Sharpe ratio of the asset over the last 90 days", "is_timestamp": false }, { "name": "Sharpe Ratio 1Y", "slug": "sharpe-ratio-1y", "description": "The Sharpe ratio of the asset over the last year", "is_timestamp": false }, { "name": "Sharpe Ratio 3Y", "slug": "sharpe-ratio-3y", "description": "The Sharpe ratio of the asset over the last 3 years", "is_timestamp": false } ] }, { "slug": "stablecoin-network-breakdown", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Breakdown Stablecoin Outstanding Supply USD", "slug": "breakdown-stablecoin-outstanding-supply-usd", "description": "The total outstanding supply in USD for this stablecoin broken down by network.", "is_timestamp": false }, { "name": "Breakdown Stablecoin Mints USD", "slug": "breakdown-stablecoin-mints-usd", "description": "The total value of new stablecoins minted in USD broken down by network.", "is_timestamp": false }, { "name": "Breakdown Stablecoin Redemptions USD", "slug": "breakdown-stablecoin-redemptions-usd", "description": "The total value of stablecoins redeemed in USD broken down by network.", "is_timestamp": false }, { "name": "Breakdown Stablecoin Transfer Volume USD", "slug": "breakdown-stablecoin-transfer-volume-usd", "description": "The total value of onchain transactions conducted with this stablecoin broken down by network, measured in USD.", "is_timestamp": false }, { "name": "Breakdown Stablecoin Transfer Count", "slug": "breakdown-stablecoin-transfer-count", "description": "The total number of stablecoin transfer transactions broken down by network.", "is_timestamp": false } ] }, { "slug": "stablecoin-supply", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Stablecoin Outstanding Supply USD", "slug": "stablecoin-outstanding-supply-usd", "description": "The total outstanding supply in USD for this stablecoin on a given interval.", "is_timestamp": false }, { "name": "Stablecoin Mints USD", "slug": "stablecoin-mints-usd", "description": "The total value of new stablecoins minted in USD.", "is_timestamp": false }, { "name": "Stablecoin Redemptions USD", "slug": "stablecoin-redemptions-usd", "description": "The total value of stablecoins redeemed in USD.", "is_timestamp": false } ] }, { "slug": "stablecoin-transfers", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Stablecoin Transfer Volume USD", "slug": "stablecoin-transfer-volume-usd", "description": "The total value of onchain transactions conducted with this stablecoin, measured in USD.", "is_timestamp": false }, { "name": "Stablecoin Transfer Count", "slug": "stablecoin-transfer-count", "description": "The total number of stablecoin transfer transactions.", "is_timestamp": false } ] }, { "slug": "supply", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "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", "is_timestamp": false }, { "name": "Total Supply", "slug": "total-supply", "description": "The total number of tokens that exist", "is_timestamp": false } ] }, { "slug": "volatility", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Volatility 30D", "slug": "volatility-30d", "description": "The average daily price movement of the asset over the last 30 days", "is_timestamp": false }, { "name": "Volatility 90D", "slug": "volatility-90d", "description": "The average daily price movement of the asset over the last 90 days", "is_timestamp": false }, { "name": "Volatility 1Y", "slug": "volatility-1y", "description": "The average daily price movement of the asset over the last year", "is_timestamp": false }, { "name": "Volatility 3Y", "slug": "volatility-3y", "description": "The average daily price movement of the asset over the last 3 years", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get timeseries metrics catalog", "tags": [ "metrics/assets" ] } }, "/metrics/v2/assets/roi": { "get": { "description": "Retrieve a specific asset's ROI", "operationId": "getAssetsROI", "parameters": [ { "description": "Comma separated list of asset identifiers - accepts slugs (e.g. 'bitcoin') or UUIDs", "in": "query", "name": "assetIDs", "schema": { "type": "string", "example": "bitcoin,ethereum" } }, { "description": "Filter By Category", "in": "query", "name": "category", "schema": { "type": "string" } }, { "description": "Filter By Sector", "in": "query", "name": "sector", "schema": { "type": "string" } }, { "description": "Search by name, symbol, slug, or contract address", "in": "query", "name": "search", "schema": { "type": "string" } }, { "description": "Limit", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer" }, "example": 10 }, { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Column to sort by (default: price-change-24h)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "slug", "price-change-24h", "price-change-7d", "price-change-30d", "price-change-1y", "price-change-year-to-date", "all-time-high", "all-time-high-percent-down", "breakeven-multiple", "cycle-low-percent-up" ], "default": "price-change-24h" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AssetComparisonItem" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "id": "b3d5d66c-26a2-404c-9325-91dc714a722b", "name": "Solana", "slug": "solana", "symbol": "SOL", "category": "Networks", "sector": "Smart Contract Platform", "tags": [ "Proof-of-Stake", "SEC Alleged Securities", "Stakeable" ], "returnOnInvestment": { "priceChange24h": 6.758885116117631, "priceChange7d": 32.664251691293394, "priceChange30d": 34.04869001943003, "priceChange1y": -51.56636283183186, "priceChange3y": 394.22506822571836, "priceChange5y": 33.711219771301224, "priceChangeMTD": 37.67550803702086, "priceChangeQTD": 36.22414650182056, "priceChangeYTD": -19.473921604318946 } }, { "id": "1e31218a-e44e-4285-820c-8282ee222035", "name": "Bitcoin", "slug": "bitcoin", "symbol": "BTC", "category": "Cryptocurrency", "sector": "Cryptocurrency", "tags": [ "Proof-of-Work" ], "returnOnInvestment": { "priceChange24h": 3.3958355900563073, "priceChange7d": 23.995486737167784, "priceChange30d": 23.462191512402136, "priceChange1y": -29.655801560914334, "priceChange3y": 205.8709998539287, "priceChange5y": 69.60373417091355, "priceChangeMTD": 26.613560328841533, "priceChangeQTD": 35.82967514844355, "priceChangeYTD": -9.111349105649321 } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 2, "totalPages": 1 } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get asset ROI", "tags": [ "metrics/assets" ] } }, "/metrics/v2/assets/{assetID}/metrics/{datasetSlug}/time-series": { "get": { "description": "Retrieve a specific asset's timeseries data", "operationId": "getAssetTimeseriesV2", "parameters": [ { "description": "Asset identifier - accepts slugs (e.g. 'bitcoin') or UUIDs", "in": "path", "name": "assetID", "required": true, "schema": { "type": "string", "example": "bitcoin", "default": "bitcoin" } }, { "description": "Dataset slug identifier. Use /metrics/v2/assets/metrics to see all available datasets.", "in": "path", "name": "datasetSlug", "required": true, "schema": { "type": "string", "default": "price", "enum": [ "futures-funding-rate", "futures-open-interest", "futures-volume", "marketcap", "price", "sharpe-ratio", "stablecoin-network-breakdown", "stablecoin-supply", "stablecoin-transfers", "supply", "volatility" ] } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 104729.2072916125, 105927.26807578972, 103720.19999058776, 105656.22864515736, 13350705564.05455 ], [ 1748822400, 105658.92299858449, 105992.1273801626, 103735.46779448254, 105898.90983196444, 20101327463.116177 ], [ 1748908800, 105896.38739709451, 106790.13927085044, 104918.11817101362, 105402.4445014, 20023603325.901714 ], [ 1748995200, 105407.80668470112, 105996.44497344238, 104319.0466004516, 104737.29919383606, 20006693677.200764 ], [ 1749081600, 104746.64834316898, 105976.08059532435, 100559.43093223224, 101613.17147431568, 29218094244.512634 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Open Price", "slug": "open", "description": "Price at the candle open.", "is_timestamp": false }, { "name": "High Price", "slug": "high", "description": "High price during the candle.", "is_timestamp": false }, { "name": "Low Price", "slug": "low", "description": "Low price during the candle.", "is_timestamp": false }, { "name": "Close Price", "slug": "close", "description": "Price at the candle close.", "is_timestamp": false }, { "name": "Volume", "slug": "volume", "description": "Total trade volume during the candle.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get asset timeseries data", "tags": [ "metrics/assets" ] } }, "/metrics/v2/assets/{assetID}/metrics/{datasetSlug}/time-series/{granularity}": { "get": { "description": "Retrieve a specific asset's timeseries data", "operationId": "getAssetTimeseriesWithGranularityV2", "parameters": [ { "description": "Asset identifier - accepts slugs (e.g. 'bitcoin') or UUIDs", "in": "path", "name": "assetID", "required": true, "schema": { "type": "string", "example": "bitcoin", "default": "bitcoin" } }, { "description": "Dataset slug identifier. Use /metrics/v2/assets/metrics to see all available datasets.", "in": "path", "name": "datasetSlug", "required": true, "schema": { "type": "string", "enum": [ "futures-funding-rate", "futures-open-interest", "futures-volume", "marketcap", "price", "sharpe-ratio", "supply", "volatility" ], "default": "price" }, "example": "price" }, { "description": "Granularity - time interval for data points", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "5m", "1h", "1d", "1w" ], "type": "string", "default": "1d" }, "example": "1d" }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 104729.2072916125, 105927.26807578972, 103720.19999058776, 105656.22864515736, 13350705564.05455 ], [ 1748822400, 105658.92299858449, 105992.1273801626, 103735.46779448254, 105898.90983196444, 20101327463.116177 ], [ 1748908800, 105896.38739709451, 106790.13927085044, 104918.11817101362, 105402.4445014, 20023603325.901714 ], [ 1748995200, 105407.80668470112, 105996.44497344238, 104319.0466004516, 104737.29919383606, 20006693677.200764 ], [ 1749081600, 104746.64834316898, 105976.08059532435, 100559.43093223224, 101613.17147431568, 29218094244.512634 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Open Price", "slug": "open", "description": "Price at the candle open.", "is_timestamp": false }, { "name": "High Price", "slug": "high", "description": "High price during the candle.", "is_timestamp": false }, { "name": "Low Price", "slug": "low", "description": "Low price during the candle.", "is_timestamp": false }, { "name": "Close Price", "slug": "close", "description": "Price at the candle close.", "is_timestamp": false }, { "name": "Volume", "slug": "volume", "description": "Total trade volume during the candle.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get asset timeseries data", "tags": [ "metrics/assets" ] } }, "/metrics/v2/networks": { "get": { "description": "Retrieve a list of networks", "operationId": "getNetworksV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetNetworksV2Response" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "b0b77938-d093-4d3e-ba5e-a27608b55e9d", "name": "TRON", "slug": "tron", "metrics": { "activity": { "blockTimeMs": 3000.834, "txnCount24Hour": 9185768, "activeAddresses24Hour": 2799884, "newContractsDeployed24Hour": 2046, "contractDeployers24Hour": 109 }, "financial": { "feesTotal24HourUsd": 6342316.28279782, "feeMedian24HourUsd": 0.09666926875, "rolling7dAvgFeeUsd": 7497413.863349775, "avgFeePerTxn24HourUsd": 0.6904503012483899, "feesSupplySide24HourUsd": 0, "expenses24HourUsd": 7434898.251882398, "revenue24HourUsd": 6342316.28279782, "tokenIncentives24HourUsd": 7434898.251882398 }, "stablecoin": { "mints24HourUsd": 17248993.850668423, "burns24HourUsd": 24958030.515035644, "outstandingSupplyUsd": 93001869823.94705, "transferVolumeUsd": 10011546337.079369 }, "ecosystem": { "tvl24HourUsd": null, "dexVolume24HourUsd": null, "coreCommits24Hour": 0, "activeDevelopers24Hour": 19, "ecosystemCommits24Hour": 0 } } }, { "id": "b204e48e-9812-43e6-a00b-5fcfd40e04a2", "name": "Solana", "slug": "solana", "metrics": { "activity": { "blockTimeMs": 366.078, "txnCount24Hour": 168516862, "activeAddresses24Hour": 2195087, "newContractsDeployed24Hour": 77, "contractDeployers24Hour": 68 }, "financial": { "feesTotal24HourUsd": 698853.7020260056, "feeMedian24HourUsd": 0.0004994586048016, "rolling7dAvgFeeUsd": 782504.9934299067, "avgFeePerTxn24HourUsd": 0.002124511039469, "feesSupplySide24HourUsd": 616575.8470416903, "expenses24HourUsd": 10589881.692391912, "revenue24HourUsd": 82277.85498431529, "tokenIncentives24HourUsd": 10589881.692391912 }, "stablecoin": { "mints24HourUsd": 3626808.1715571997, "burns24HourUsd": 354589367.0487198, "outstandingSupplyUsd": 12700958526.669176, "transferVolumeUsd": 10548490402.9545 }, "ecosystem": { "tvl24HourUsd": 9212218699.843391, "dexVolume24HourUsd": 973583387.3851659, "coreCommits24Hour": 1, "activeDevelopers24Hour": 26, "ecosystemCommits24Hour": 2 } } }, { "id": "ce84ab09-fec6-4024-a42a-53bdc0293038", "name": "BNB Chain", "slug": "binance-smart-chain", "metrics": { "activity": { "blockTimeMs": 450.136, "txnCount24Hour": 16955737, "activeAddresses24Hour": 1942118, "newContractsDeployed24Hour": 212282, "contractDeployers24Hour": 7252 }, "financial": { "feesTotal24HourUsd": 623498.095716146, "feeMedian24HourUsd": 0.0041312038979416, "rolling7dAvgFeeUsd": 708069.7815754432, "avgFeePerTxn24HourUsd": 0.0367721023106306, "feesSupplySide24HourUsd": 561059.1232000488, "expenses24HourUsd": 42.94083510302815, "revenue24HourUsd": 62438.9725160972, "tokenIncentives24HourUsd": 0 }, "stablecoin": { "mints24HourUsd": 10357117.246305106, "burns24HourUsd": 8329318.73820484, "outstandingSupplyUsd": 1542348030.4320588, "transferVolumeUsd": 558714975.3118011 }, "ecosystem": { "tvl24HourUsd": 4680960862.215577, "dexVolume24HourUsd": 1039299911.3004029, "coreCommits24Hour": 0, "activeDevelopers24Hour": 14, "ecosystemCommits24Hour": 3 } } }, { "id": "09f15639-06cf-4460-83b8-a86de2f2db28", "name": "Ethereum", "slug": "ethereum", "metrics": { "activity": { "blockTimeMs": 12035.102, "txnCount24Hour": 1678773, "activeAddresses24Hour": 466281, "newContractsDeployed24Hour": 45990, "contractDeployers24Hour": 1660 }, "financial": { "feesTotal24HourUsd": 529065.705851847, "feeMedian24HourUsd": 0.0494282322687339, "rolling7dAvgFeeUsd": 582994.0047762848, "avgFeePerTxn24HourUsd": 0.3151502352324268, "feesSupplySide24HourUsd": 458082.8223565072, "expenses24HourUsd": 4966105.981645153, "revenue24HourUsd": 70982.88349533977, "tokenIncentives24HourUsd": 4966105.981645153 }, "stablecoin": { "mints24HourUsd": 3349444249.9108267, "burns24HourUsd": 3288625704.359681, "outstandingSupplyUsd": 158586493884.3514, "transferVolumeUsd": 67983541270.570526 }, "ecosystem": { "tvl24HourUsd": 59209052841.94413, "dexVolume24HourUsd": 548390312.7195497, "coreCommits24Hour": 0, "activeDevelopers24Hour": 111, "ecosystemCommits24Hour": 113 } } }, { "id": "6fd334cc-a7da-4ebb-8134-667941574a63", "name": "Celo", "slug": "celo", "metrics": { "activity": { "blockTimeMs": 1000, "txnCount24Hour": 1141379, "activeAddresses24Hour": 460580, "newContractsDeployed24Hour": 1643, "contractDeployers24Hour": 101 }, "financial": { "feesTotal24HourUsd": 4078.251936887091, "feeMedian24HourUsd": 0.0022422199922487, "rolling7dAvgFeeUsd": 3732.729498282151, "avgFeePerTxn24HourUsd": 0.0035730917923731, "feesSupplySide24HourUsd": 0, "expenses24HourUsd": 0, "revenue24HourUsd": 4078.251936887091, "tokenIncentives24HourUsd": 0 }, "stablecoin": { "mints24HourUsd": 4572.126231048983, "burns24HourUsd": 2964.5968843335054, "outstandingSupplyUsd": 92867051.2370777, "transferVolumeUsd": 62623344.628520675 }, "ecosystem": { "tvl24HourUsd": 9513207.537550515, "dexVolume24HourUsd": 748164.3446482194, "coreCommits24Hour": 0, "activeDevelopers24Hour": 23, "ecosystemCommits24Hour": 0 } } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 32, "totalPages": 4 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get networks", "tags": [ "metrics/networks" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: active-addresses)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "slug", "active-addresses", "total-transactions", "fees-total-usd", "revenue-usd", "tvl-usd", "ecosystem-dex-volume-usd", "stablecoin-outstanding-supply-usd" ], "default": "active-addresses" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/networks/metrics": { "get": { "description": "Get metric catalog of datasets for networks.", "operationId": "getNetworksTimeseriesCatalogV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "activity", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Daily Transactions", "slug": "txnCount24Hour", "description": "The number of successful and unsuccessful transactions in a day.", "is_timestamp": false }, { "name": "Daily Active Addresses", "slug": "activeAddresses24Hour", "description": "The number of new and returning unique wallet addresses that send a transaction in a day.", "is_timestamp": false }, { "name": "New Contracts Deployed 24 Hour", "slug": "newContractsDeployed24Hour", "description": "The number of new contracts deployed in a day.", "is_timestamp": false }, { "name": "Contract Deployers 24 Hour", "slug": "contractDeployers24Hour", "description": "", "is_timestamp": false }, { "name": "Transactions Per Second", "slug": "transactionsPerSecond", "description": "Average transactions per second processed by the network.", "is_timestamp": false } ] }, { "slug": "ecosystem", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in the network in USD.", "is_timestamp": false }, { "name": "Ecosystem DEX Volume (USD)", "slug": "dexVolume24HourUsd", "description": "USD value of all tokens swapped across supported decentralized exchanges (DEXs) on a network.", "is_timestamp": false }, { "name": "Core Commits 24 Hour", "slug": "coreCommits24Hour", "description": "Number of code commits to the network's primary repository in the time period.", "is_timestamp": false }, { "name": "Active Developers 24 Hour", "slug": "activeDevelopers24Hour", "description": "Number of developers that have made at least one commit to the network's primary repository in the last 30 days.", "is_timestamp": false }, { "name": "Ecosystem Commits 24 Hour", "slug": "ecosystemCommits24Hour", "description": "Number of code commits to projects in the network's ecosystem.", "is_timestamp": false }, { "name": "Spot DEX Trade Count", "slug": "spotDexTradeCount", "description": "Daily spot DEX trade count on the network. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Lending TVL (USD)", "slug": "lendingTvlUsd", "description": "Lending-protocol TVL on the network (deposits minus borrows) in USD. Sourced from Blockworks Research.", "is_timestamp": false } ] }, { "slug": "financial", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Median Transaction Fees", "slug": "feeMedian24HourUsd", "description": "Median fees paid for processing transactions.", "is_timestamp": false }, { "name": "Rolling 7D Average Transaction Fees", "slug": "rolling7dAvgFees", "description": "7 day rolling average of daily total transaction fees.", "is_timestamp": false }, { "name": "Average Fee Per Transaction", "slug": "avgFeePerTxn24Hour", "description": "Value of daily Transaction Fees divided by number of Transactions.", "is_timestamp": false }, { "name": "Fees Total (USD)", "slug": "feesTotal24HourUsd", "description": "Total fees paid for processing transactions.", "is_timestamp": false }, { "name": "Fees Supply Side (USD)", "slug": "feesSupplySide24HourUsd", "description": "Share of fees that goes to the service providers.", "is_timestamp": false }, { "name": "Expenses (USD)", "slug": "expenses24HourUsd", "description": "Total expenses of the network in USD.", "is_timestamp": false }, { "name": "Revenue (USD)", "slug": "revenue24HourUsd", "description": "Total revenue of the network in USD.", "is_timestamp": false }, { "name": "Token Incentives (USD)", "slug": "tokenIncentives24HourUsd", "description": "Total token incentives of the network in USD.", "is_timestamp": false }, { "name": "Application Revenue (USD)", "slug": "appRevenueUsd", "description": "Daily application-level revenue on the network in USD. Sourced from Blockworks Research.", "is_timestamp": false } ] }, { "slug": "perp-dex", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Perp DEX Volume (USD)", "slug": "perpDexVolumeUsd", "description": "Daily perpetual DEX trading volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Perp DEX Open Interest (USD)", "slug": "perpDexOpenInterestUsd", "description": "Perpetual DEX open interest in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Perp DEX Trade Count", "slug": "perpDexTradeCount", "description": "Daily perpetual DEX trade count on the network. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Perp DEX Fees (USD)", "slug": "perpDexFeesUsd", "description": "Daily perpetual DEX fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Perp DEX Revenue (USD)", "slug": "perpDexRevenueUsd", "description": "Daily perpetual DEX revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false } ] }, { "slug": "stablecoin", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Stablecoin Mints (USD)", "slug": "mints24HourUsd", "description": "Total stablecoin mints of the network in USD.", "is_timestamp": false }, { "name": "Stablecoin Burns (USD)", "slug": "burns24HourUsd", "description": "Total stablecoin burn on the network in USD.", "is_timestamp": false }, { "name": "Stablecoin Outstanding Supply (USD)", "slug": "outstandingSupplyUsd", "description": "Total stablecoin outstanding supply of the network in USD.", "is_timestamp": false }, { "name": "Stablecoin Transfer Volume (USD)", "slug": "transferVolumeUsd", "description": "Total stablecoin transfer volume of the network in USD.", "is_timestamp": false } ] }, { "slug": "staking", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Total Staked (Native)", "slug": "totalStakedNative", "description": "Total native tokens staked on the network. Sourced from Blockworks Research; falls back to Avalanche primary-chain data where BWR has no coverage.", "is_timestamp": false }, { "name": "Total Staked (USD)", "slug": "totalStakedUsd", "description": "USD value of total stake on the network.", "is_timestamp": false }, { "name": "Staking Rate (%)", "slug": "stakingRatePct", "description": "Percentage (0-100) of native circulating supply staked.", "is_timestamp": false }, { "name": "Native Staked (Native)", "slug": "nativeStakedNative", "description": "Native tokens staked directly, excluding liquid staking.", "is_timestamp": false }, { "name": "Native Staked (USD)", "slug": "nativeStakedUsd", "description": "USD value of tokens staked directly, excluding liquid staking.", "is_timestamp": false }, { "name": "Liquid Staked (Native)", "slug": "liquidStakedNative", "description": "Native tokens staked via liquid staking protocols.", "is_timestamp": false }, { "name": "Liquid Staked (USD)", "slug": "liquidStakedUsd", "description": "USD value of tokens staked via liquid staking protocols.", "is_timestamp": false }, { "name": "Liquid Staking Rate (%)", "slug": "liquidStakingRatePct", "description": "Percentage (0-100) of native circulating supply in liquid staking.", "is_timestamp": false }, { "name": "Net Stake Flow (Native)", "slug": "netStakeFlowNative", "description": "Net stake flow in native tokens over the period; negative values indicate net unstaking.", "is_timestamp": false }, { "name": "Net Stake Flow (USD)", "slug": "netStakeFlowUsd", "description": "Net stake flow in USD over the period; negative values indicate net unstaking.", "is_timestamp": false }, { "name": "Staking Rewards (Native)", "slug": "stakingRewardsNative", "description": "Staking rewards paid in native tokens over the period.", "is_timestamp": false }, { "name": "Staking Rewards (USD)", "slug": "stakingRewardsUsd", "description": "Staking rewards paid in USD over the period.", "is_timestamp": false }, { "name": "Staking APR 30D (%)", "slug": "stakingApr30dPct", "description": "30-day trailing staking APR, in percent.", "is_timestamp": false }, { "name": "Staking APY 30D (%)", "slug": "stakingApy30dPct", "description": "30-day trailing staking APY, in percent.", "is_timestamp": false }, { "name": "Real Staking APY 30D (%)", "slug": "realStakingApy30dPct", "description": "30-day trailing staking APY net of native inflation, in percent.", "is_timestamp": false }, { "name": "Staking Inflation Rate 30D (%)", "slug": "stakingInflationRate30dPct", "description": "30-day trailing annualized native token inflation rate, in percent.", "is_timestamp": false }, { "name": "Validator Count", "slug": "validatorCount", "description": "Number of validators on the network.", "is_timestamp": false }, { "name": "Active Validator Count", "slug": "activeValidatorCount", "description": "Number of active validators on the network.", "is_timestamp": false }, { "name": "Delegator Count", "slug": "delegatorCount", "description": "Number of delegators on the network.", "is_timestamp": false }, { "name": "Staker Count", "slug": "stakerCount", "description": "Number of unique staking participants on the network.", "is_timestamp": false }, { "name": "Average Validator Commission Rate", "slug": "avgValidatorCommissionRate", "description": "Average validator commission rate, as reported by Blockworks Research.", "is_timestamp": false }, { "name": "Stake-Weighted Commission Rate", "slug": "stakeWeightedCommissionRate", "description": "Stake-weighted validator commission rate, as reported by Blockworks Research.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get timeseries metrics catalog", "tags": [ "metrics/networks" ] } }, "/metrics/v2/networks/metrics/{datasetSlug}/time-series/{granularity}": { "get": { "description": "Returns one timeseries per network, for every network the networks listing serves, in a single response. Use this instead of calling the per-network endpoint once for each network. Every network is included, so narrow start and end to limit the response size.", "operationId": "getAllNetworksTimeseriesV2", "parameters": [ { "description": "Dataset slug", "in": "path", "name": "datasetSlug", "required": true, "schema": { "enum": [ "activity", "financial", "ecosystem", "stablecoin", "staking", "perp-dex" ], "type": "string", "example": "activity", "default": "activity" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/NetworkTimeseriesEntry" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "network": { "id": "e7bc4889-a1fd-4e59-a264-5f27941c9976", "slug": "algorand", "name": "Algorand" }, "points": [ [ 1748736000, 1612887, 189111, 137, 25, 18.667673611111116 ], [ 1748822400, 1672474, 208776, 151, 19, 19.35733796296296 ], [ 1748908800, 1700602, 208949, 158, 34, 19.68289351851852 ], [ 1748995200, 1752483, 215064, 174, 19, 20.28336805555556 ], [ 1749081600, 1877860, 225765, 281, 33, 21.73449074074074 ] ] }, { "network": { "id": "383aabb9-285c-4813-aa76-6987091b93a6", "slug": "arbitrum-one", "name": "Arbitrum" }, "points": [ [ 1748736000, 1920409, 243188, 7764, 683, 23.99576554232804 ], [ 1748822400, 2259980, 276336, 9197, 762, 23.732270171957673 ], [ 1748908800, 2320530, 312763, 7822, 768, 23.093839285714285 ], [ 1748995200, 2270473, 291690, 7821, 868, 23.123978174603174 ], [ 1749081600, 2647854, 272817, 9180, 901, 23.306512896825396 ] ] }, { "network": { "id": "60b82a80-8324-4d5f-bfe5-7e756b0023f9", "slug": "avalanche", "name": "Avalanche" }, "points": [ [ 1748736000, 1088336, 36865, 97306, 747, 12.59648148148148 ], [ 1748822400, 1030983, 42683, 93074, 785, 11.932673611111111 ], [ 1748908800, 1205532, 42602, 47021, 694, 13.952916666666669 ], [ 1748995200, 892628, 55937, 91702, 811, 10.331342592592591 ], [ 1749081600, 697577, 94312, 5451, 616, 8.07380787037037 ] ] }, { "network": { "id": "ce84ab09-fec6-4024-a42a-53bdc0293038", "slug": "binance-smart-chain", "name": "BNB Chain" }, "points": [ [ 1748736000, 14159740, 1441414, 66594, 2071, 168.693814484127 ], [ 1748822400, 15060937, 1442235, 152794, 2256, 169.943664021164 ], [ 1748908800, 16075242, 1701675, 158406, 2268, 172.7389566798942 ], [ 1748995200, 15314764, 1636692, 295372, 2663, 173.22598710317462 ], [ 1749081600, 15964565, 1636864, 117021, 2430, 174.3675710978836 ] ] }, { "network": { "id": "d1696128-579b-46e9-ab5a-2ab33d8c4b7e", "slug": "base", "name": "Base" }, "points": [ [ 1748736000, 8435362, 1520188, 3671997, 5546, 123.78646494708995 ], [ 1748822400, 8830010, 1639247, 2164942, 5502, 121.12548776455026 ], [ 1748908800, 11717342, 3197091, 855757, 4682, 124.190916005291 ], [ 1748995200, 9964436, 1559485, 697719, 5409, 120.8360300925926 ], [ 1749081600, 12000760, 1823154, 1274663, 5518, 117.45576554232804 ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Daily Transactions", "slug": "txnCount24Hour", "description": "The number of successful and unsuccessful transactions in a day.", "is_timestamp": false }, { "name": "Daily Active Addresses", "slug": "activeAddresses24Hour", "description": "The number of new and returning unique wallet addresses that send a transaction in a day.", "is_timestamp": false }, { "name": "New Contracts Deployed 24 Hour", "slug": "newContractsDeployed24Hour", "description": "The number of new contracts deployed in a day.", "is_timestamp": false }, { "name": "Contract Deployers 24 Hour", "slug": "contractDeployers24Hour", "description": "", "is_timestamp": false }, { "name": "Transactions Per Second", "slug": "transactionsPerSecond", "description": "Average transactions per second processed by the network.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get All Networks Time Series", "tags": [ "metrics/networks" ] } }, "/metrics/v2/networks/{entityIdentifier}/metrics/{datasetSlug}/time-series": { "get": { "description": "Retrieve a specific network's timeseries data", "operationId": "getNetworkTimeseriesV2", "parameters": [ { "description": "Entity ID or slug", "in": "path", "name": "entityIdentifier", "required": true, "schema": { "type": "string", "example": "ethereum", "default": "ethereum" } }, { "description": "Dataset slug", "in": "path", "name": "datasetSlug", "required": true, "schema": { "type": "string", "enum": [ "activity", "ecosystem", "financial", "stablecoin", "staking" ], "example": "activity", "default": "activity" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get network timeseries data", "tags": [ "metrics/networks" ] } }, "/metrics/v2/networks/{entityIdentifier}/metrics/{datasetSlug}/time-series/{granularity}": { "get": { "description": "Retrieve a specific network's timeseries data", "operationId": "getNetworkTimeseriesWithGranularityV2", "parameters": [ { "description": "Entity ID or slug", "in": "path", "name": "entityIdentifier", "required": true, "schema": { "type": "string", "default": "ethereum" } }, { "description": "Dataset slug", "in": "path", "name": "datasetSlug", "required": true, "schema": { "type": "string", "enum": [ "activity", "ecosystem", "financial", "stablecoin", "staking" ], "example": "activity", "default": "activity" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1m", "5m", "15m", "30m", "1h", "6h", "1d", "1w", "30d", "1q", "1y" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "default": "2025-05-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "default": "2025-06-01T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 256072, 483411, null, null, 4.393158068783069 ], [ 1748822400, 346488, 552790, null, null, 4.37364417989418 ], [ 1748908800, 358895, 608701, null, null, 4.267676917989418 ], [ 1748995200, 337037, 502560, null, null, 3.9301835317460316 ], [ 1749081600, 320509, 539048, null, null, 3.8270916005291005 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Daily Transactions", "slug": "txnCount24Hour", "description": "The number of successful and unsuccessful transactions in a day.", "is_timestamp": false }, { "name": "Daily Active Addresses", "slug": "activeAddresses24Hour", "description": "The number of new and returning unique wallet addresses that send a transaction in a day.", "is_timestamp": false }, { "name": "New Contracts Deployed 24 Hour", "slug": "newContractsDeployed24Hour", "description": "The number of new contracts deployed in a day.", "is_timestamp": false }, { "name": "Contract Deployers 24 Hour", "slug": "contractDeployers24Hour", "description": "", "is_timestamp": false }, { "name": "Transactions Per Second", "slug": "transactionsPerSecond", "description": "Average transactions per second processed by the network.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get network timeseries data", "tags": [ "metrics/networks" ] } }, "/metrics/v2/stablecoins": { "get": { "description": "Retrieve a list of stablecoins", "operationId": "getStablecoins", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetStablecoinsResponse" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "51f8ea5e-f426-4f40-939a-db7e05495374", "name": "Tether", "slug": "tether", "symbol": "USDT", "supply": { "outstandingSupplyUsd": 182970542283.55804, "mints24HourUsd": 902185.3609487434, "burns24HourUsd": 22122.285347873145 }, "transfers": { "volumeUsd": 24888241546.431797, "count": 14092233 }, "networkBreakdown": { "outstandingSupplyUsd": [ { "networkSlug": "tron", "value": 91575814538.47612 }, { "networkSlug": "ethereum", "value": 86435227028.35545 }, { "networkSlug": "solana", "value": 2834204771.768269 }, { "networkSlug": "aptos", "value": 851563825.0784814 }, { "networkSlug": "ton", "value": 585732186.453912 } ], "mints24HourUsd": [ { "networkSlug": "optimism", "value": 888442.1826420894 }, { "networkSlug": "zk-sync", "value": 13648.69119163574 }, { "networkSlug": "sonic", "value": 94.48711501817886 }, { "networkSlug": "ethereum", "value": 0 }, { "networkSlug": "celo", "value": 0 } ], "burns24HourUsd": [ { "networkSlug": "sonic", "value": 15001.10756984981 }, { "networkSlug": "zk-sync", "value": 7110.695279496581 }, { "networkSlug": "solana", "value": 10.48249852675455 }, { "networkSlug": "optimism", "value": 0 }, { "networkSlug": "ethereum", "value": 0 } ], "transferCount": [ { "networkSlug": "celo", "value": 7876662 }, { "networkSlug": "solana", "value": 3116805 }, { "networkSlug": "tron", "value": 1922693 }, { "networkSlug": "ethereum", "value": 783962 }, { "networkSlug": "ton", "value": 145294 } ], "transferVolumeUsd": [ { "networkSlug": "ethereum", "value": 12557777197.23128 }, { "networkSlug": "tron", "value": 9898638702.873407 }, { "networkSlug": "solana", "value": 1701691116.901009 }, { "networkSlug": "aptos", "value": 365965421.2802042 }, { "networkSlug": "ton", "value": 111718383.0197446 } ] } }, { "id": "4515ba15-2719-4183-b0ca-b9255d55b67e", "name": "USDC", "slug": "circle-usdc-stablecoin", "symbol": "USDC", "supply": { "outstandingSupplyUsd": 73130556052.85765, "mints24HourUsd": 767192657.8006141, "burns24HourUsd": 1058431099.2157421 }, "transfers": { "volumeUsd": 129213677164.94948, "count": 21359426 }, "networkBreakdown": { "outstandingSupplyUsd": [ { "networkSlug": "ethereum", "value": 49790240359.73467 }, { "networkSlug": "solana", "value": 7138379201.200015 }, { "networkSlug": "hyperevm", "value": 6330208426.989727 }, { "networkSlug": "base", "value": 4306142052.207857 }, { "networkSlug": "arbitrum-one", "value": 2608699716.816709 } ], "mints24HourUsd": [ { "networkSlug": "stellar", "value": null }, { "networkSlug": "ethereum", "value": 206493147.09666 }, { "networkSlug": "hyperevm", "value": 205143752.95157 }, { "networkSlug": "arbitrum-one", "value": 178853573.8448787 }, { "networkSlug": "base", "value": 56078239.22552834 } ], "burns24HourUsd": [ { "networkSlug": "stellar", "value": null }, { "networkSlug": "solana", "value": 351982645.873704 }, { "networkSlug": "ethereum", "value": 257021613.866013 }, { "networkSlug": "arbitrum-one", "value": 231633199.8504061 }, { "networkSlug": "hyperevm", "value": 89947500.3171366 } ], "transferCount": [ { "networkSlug": "solana", "value": 12947049 }, { "networkSlug": "base", "value": 3391389 }, { "networkSlug": "optimism", "value": 1090880 }, { "networkSlug": "arbitrum-one", "value": 1001890 }, { "networkSlug": "polygon-pos", "value": 741477 } ], "transferVolumeUsd": [ { "networkSlug": "base", "value": 69628046543.92531 }, { "networkSlug": "ethereum", "value": 37848937550.95406 }, { "networkSlug": "solana", "value": 8238041610.422954 }, { "networkSlug": "optimism", "value": 7301655293.167127 }, { "networkSlug": "arbitrum-one", "value": 2153241618.541129 } ] } }, { "id": "5b9504b4-fc14-4ec5-af2b-4ba1bd496cfe", "name": "Sky Dollar", "slug": "usds", "symbol": "USDS", "supply": { "outstandingSupplyUsd": 9497950486.145483, "mints24HourUsd": 509632894.20303667, "burns24HourUsd": 491551920.0327277 }, "transfers": { "volumeUsd": 2683926657.246133, "count": 42601 }, "networkBreakdown": { "outstandingSupplyUsd": [ { "networkSlug": "ethereum", "value": 9489419855.517282 }, { "networkSlug": "solana", "value": 8530630.628201013 } ], "mints24HourUsd": [ { "networkSlug": "ethereum", "value": 509632894.2030367 }, { "networkSlug": "solana", "value": 0 } ], "burns24HourUsd": [ { "networkSlug": "ethereum", "value": 491551920.014594 }, { "networkSlug": "solana", "value": 0.0181336777382045 } ], "transferCount": [ { "networkSlug": "solana", "value": 32966 }, { "networkSlug": "ethereum", "value": 9635 } ], "transferVolumeUsd": [ { "networkSlug": "ethereum", "value": 2682142030.260221 }, { "networkSlug": "solana", "value": 1784626.985912449 } ] } }, { "id": "1319f3e9-df7f-4669-9e7e-71aa912f8f6d", "name": "Ethena USDe", "slug": "ethena-usde", "symbol": "USDe", "supply": { "outstandingSupplyUsd": 4078684404.668999, "mints24HourUsd": 6846797.721254027, "burns24HourUsd": 18868758.617866024 }, "transfers": { "volumeUsd": 239167930.5996504, "count": 4318 }, "networkBreakdown": { "outstandingSupplyUsd": [ { "networkSlug": "ethereum", "value": 4078684404.668999 } ], "mints24HourUsd": [ { "networkSlug": "ethereum", "value": 6846797.721254027 } ], "burns24HourUsd": [ { "networkSlug": "ethereum", "value": 18868758.61786602 } ], "transferCount": [ { "networkSlug": "ethereum", "value": 4318 } ], "transferVolumeUsd": [ { "networkSlug": "ethereum", "value": 239167930.5996504 } ] } }, { "id": "f1ef4b29-36da-4c6a-8190-c7cebcfed539", "name": "USD1", "slug": "usd1-wlfi", "symbol": "USD1", "supply": { "outstandingSupplyUsd": 3980906238.4719443, "mints24HourUsd": 5215569.198866852, "burns24HourUsd": 0.0113136598601964 }, "transfers": { "volumeUsd": 499294854.2337471, "count": 895612 }, "networkBreakdown": { "outstandingSupplyUsd": [ { "networkSlug": "ethereum", "value": 1505190161.967638 }, { "networkSlug": "binance-smart-chain", "value": 1397672101.105922 }, { "networkSlug": "solana", "value": 1067982562.305485 }, { "networkSlug": "tron", "value": 10061413.09289844 } ], "mints24HourUsd": [ { "networkSlug": "ethereum", "value": 5215569.198866852 }, { "networkSlug": "binance-smart-chain", "value": 0 }, { "networkSlug": "tron", "value": 0 }, { "networkSlug": "solana", "value": 0 } ], "burns24HourUsd": [ { "networkSlug": "solana", "value": 0.0113136598601964 }, { "networkSlug": "tron", "value": 0 }, { "networkSlug": "ethereum", "value": 0 }, { "networkSlug": "binance-smart-chain", "value": 0 } ], "transferCount": [ { "networkSlug": "binance-smart-chain", "value": 562355 }, { "networkSlug": "solana", "value": 331376 }, { "networkSlug": "tron", "value": 965 }, { "networkSlug": "ethereum", "value": 916 } ], "transferVolumeUsd": [ { "networkSlug": "binance-smart-chain", "value": 382797124.2338738 }, { "networkSlug": "solana", "value": 77979197.63810147 }, { "networkSlug": "ethereum", "value": 38198258.5825865 }, { "networkSlug": "tron", "value": 320273.7791854173 } ] } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 35, "totalPages": 4 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get stablecoins", "tags": [ "metrics/stablecoins" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: stablecoin-outstanding-supply-usd)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "symbol", "slug", "stablecoin-outstanding-supply-usd", "stablecoin-mints-usd", "stablecoin-redemptions-usd", "stablecoin-transfer-count", "stablecoin-transfer-volume-usd" ], "default": "stablecoin-outstanding-supply-usd" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/stablecoins/metrics": { "get": { "description": "Get metric catalog of datasets for stablecoins.", "operationId": "getStablecoinsTimeseriesCatalogV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "network-breakdown", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Outstanding Supply USD", "slug": "outstandingSupplyUsd", "description": "The total outstanding supply in USD for this stablecoin broken down by network.", "is_timestamp": false }, { "name": "Mints 24 Hour USD", "slug": "mints24HourUsd", "description": "The total value of new stablecoins minted in USD broken down by network.", "is_timestamp": false }, { "name": "Breakdown Stablecoin Redemptions USD", "slug": "breakdown-stablecoin-redemptions-usd", "description": "The total value of stablecoins redeemed in USD broken down by network.", "is_timestamp": false }, { "name": "Transfer Volume USD", "slug": "transferVolumeUsd", "description": "The total value of onchain transactions conducted with this stablecoin broken down by network, measured in USD.", "is_timestamp": false }, { "name": "Breakdown Stablecoin Transfer Count", "slug": "breakdown-stablecoin-transfer-count", "description": "The total number of stablecoin transfer transactions broken down by network.", "is_timestamp": false } ] }, { "slug": "supply", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Outstanding Supply USD", "slug": "outstandingSupplyUsd", "description": "The total outstanding supply in USD for this stablecoin on a given interval.", "is_timestamp": false }, { "name": "Mints 24 Hour USD", "slug": "mints24HourUsd", "description": "The total value of new stablecoins minted in USD.", "is_timestamp": false }, { "name": "Burns 24 Hour USD", "slug": "stablecoin-redemptions-usd", "description": "The total value of stablecoins redeemed in USD.", "is_timestamp": false } ] }, { "slug": "transfers", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Transfer Volume USD", "slug": "transferVolumeUsd", "description": "The total value of onchain transactions conducted with this stablecoin, measured in USD.", "is_timestamp": false }, { "name": "Stablecoin Transfer Count", "slug": "stablecoin-transfer-count", "description": "The total number of stablecoin transfer transactions.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get timeseries metrics catalog", "tags": [ "metrics/stablecoins" ] } }, "/metrics/v2/stablecoins/{entityIdentifier}/metrics/{datasetSlug}/time-series": { "get": { "description": "Retrieve a specific stablecoin's timeseries data", "operationId": "getStablecoinTimeseriesV2", "parameters": [ { "description": "Entity ID or slug", "in": "path", "name": "entityIdentifier", "required": true, "schema": { "type": "string", "example": "tether", "default": "tether" } }, { "description": "Dataset slug", "in": "path", "name": "datasetSlug", "required": true, "schema": { "type": "string", "enum": [ "network-breakdown", "supply", "transfers" ], "example": "supply", "default": "supply" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1674864000, 68500978293.758316, null, null ], [ 1674950400, 68512350446.7849, null, null ], [ 1675036800, 68490420842.94022, null, null ], [ 1675123200, 68473605079.801216, null, null ], [ 1675209600, 68493868332.42586, null, null ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Outstanding Supply USD", "slug": "outstandingSupplyUsd", "description": "The total outstanding supply in USD for this stablecoin on a given interval.", "is_timestamp": false }, { "name": "Mints 24 Hour USD", "slug": "mints24HourUsd", "description": "The total value of new stablecoins minted in USD.", "is_timestamp": false }, { "name": "Burns 24 Hour USD", "slug": "stablecoin-redemptions-usd", "description": "The total value of stablecoins redeemed in USD.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get stablecoin timeseries data", "tags": [ "metrics/stablecoins" ] } }, "/metrics/v2/stablecoins/{entityIdentifier}/metrics/{datasetSlug}/time-series/{granularity}": { "get": { "description": "Retrieve a specific stablecoin's timeseries data", "operationId": "getStablecoinTimeseriesWithGranularityV2", "parameters": [ { "description": "Entity ID or slug", "in": "path", "name": "entityIdentifier", "required": true, "schema": { "type": "string", "example": "tether", "default": "tether" } }, { "description": "Dataset slug", "in": "path", "name": "datasetSlug", "required": true, "schema": { "type": "string", "enum": [ "network-breakdown", "supply", "transfers" ], "example": "supply", "default": "supply" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1m", "5m", "15m", "30m", "1h", "6h", "1d", "1w", "30d", "1q", "1y" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Outstanding Supply USD", "slug": "outstandingSupplyUsd", "description": "The total outstanding supply in USD for this stablecoin on a given interval.", "is_timestamp": false }, { "name": "Mints 24 Hour USD", "slug": "mints24HourUsd", "description": "The total value of new stablecoins minted in USD.", "is_timestamp": false }, { "name": "Burns 24 Hour USD", "slug": "stablecoin-redemptions-usd", "description": "The total value of stablecoins redeemed in USD.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get stablecoin timeseries data", "tags": [ "metrics/stablecoins" ] } }, "/metrics/v2/protocols": { "get": { "description": "Returns a complete list of all available protocols supported by Messari, along with core metrics. Protocols aggregate deployments across multiple blockchain networks (e.g., Aave includes V3, V2, and V1 versions).", "operationId": "getProtocolsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "1eaf063a-b8dd-4cfb-95dd-a06338565720", "name": "Tether", "slug": "tether", "activity": { "tvl24HourUsd": 188644665207.35986, "activeAddresses24Hour": 1122231, "fees24HourUsd": 14618429.653360274 } }, { "id": "9e46405d-d9e8-4dd3-8dc6-0cd2d81ffedc", "name": "Circle", "slug": "circle-usdc", "activity": { "tvl24HourUsd": 75834977011.21634, "activeAddresses24Hour": 207052, "fees24HourUsd": 5970865.623038587 } }, { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave", "activity": { "tvl24HourUsd": 29943935339.394585, "activeAddresses24Hour": 6385, "fees24HourUsd": 2364765.883961379 } }, { "id": "3ee3418e-ab75-475c-b153-aeba3752478e", "name": "Lido DAO", "slug": "lido-dao", "activity": { "tvl24HourUsd": 23568580401.07076, "activeAddresses24Hour": 1083, "fees24HourUsd": 1970337.5536137987 } }, { "id": "e4fd40c6-4e95-4fbe-8d6b-e6e401793a8d", "name": "Morpho", "slug": "morpho-2", "activity": { "tvl24HourUsd": 14131509867.358997, "activeAddresses24Hour": 932, "fees24HourUsd": 793248.111185432 } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 214, "totalPages": 22 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List all protocols", "tags": [ "metrics/protocols" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: tvl_usd)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "tvl_usd", "active_addresses", "fees_usd", "fees_supply_side_usd", "expenses_usd", "dex_volume_usd", "borrowed_usd", "treasury_usd" ], "default": "tvl_usd" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/protocols/metrics": { "get": { "description": "Returns a list of timeseries core metrics available for all protocols", "operationId": "getProtocolsMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "core", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Revenue 24 Hour USD", "slug": "revenue24HourUsd", "description": "Total revenue generated by the protocol in USD.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List all protocols core metrics", "tags": [ "metrics/protocols" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/core/time-series/{granularity}": { "get": { "description": "Returns a timeseries metric for a specific protocol. Protocols represent an aggregation of all deployments across all chains (e.g., Aave will include V3, V2, and V1).", "operationId": "getProtocolCoreTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "uniswap", "default": "uniswap" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1m", "5m", "15m", "30m", "1h", "6h", "1d", "1w", "30d", "1q", "1y" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 40874983380.06086, 8894, 1803840.5151728864, 268995.01127406844 ], [ 1748822400, 41493958468.891754, 8801, 1503209.007828896, 234752.092106393 ], [ 1748908800, 41587470329.870155, 9871, 1524454.7886562573, 235031.26761175104 ], [ 1748995200, 41911763138.436165, 10204, 1527950.2199558418, 230042.68047371123 ], [ 1749081600, 39703840117.46197, 12350, 2486100.5018659243, 330345.9880056461 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Revenue 24 Hour USD", "slug": "revenue24HourUsd", "description": "Total revenue generated by the protocol in USD.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get protocol core timeseries metric", "tags": [ "metrics/protocols" ] } }, "/metrics/v2/protocols/dex": { "get": { "description": "Returns a complete list of all available DEX protocols supported by Messari, along with metrics. Protocol data represents an aggregation across all chain deployments (e.g., Uniswap includes V3, V2, and V1 versions).", "operationId": "getDexProtocolsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "d32b98a8-7160-480b-a331-fa294aa25301", "name": "Uniswap", "slug": "uniswap", "activity": { "tvl24HourUsd": 6387589478.206842, "activeAddresses24Hour": 97028, "fees24HourUsd": 3297638.002456539 }, "dex": { "feesSupplySide24HourUsd": 2983959.986941341, "tokenIncentives24HourUsd": 0, "expenses24HourUsd": 120.61243736163108, "netDeposits24HourUsd": 6387589478.206842, "treasuryUsd": 1210789059.5480464, "flashLoanVolume24HourUsd": 90552.66102363159, "tradeablePairs": 23215455, "tradeableAssets": 22612057, "treadeableAssets": 22612057, "dexVolume24HourUsd": 7793206.652491826, "dexTradeCount24Hour": 2636380, "correlatedVolume24HourUsd": 474464516.20092493, "aggregatorVolume24HourUsd": 0, "platformVolume24HourUsd": 0, "aggregatorTradeCount24Hour": 0, "platformTradeCount24Hour": 0, "memecoinVolumeShare": 0.04490572508605675, "volumeByCategory": { "nativeStablecoin": 1065616906.267955, "chainToken": 16448054.71900846, "foreignToken": 355966553.0196866, "stablecoinSwaps": 452889910.0967662, "lstSwaps": 15780991.23045627, "composites": 1497966.810096225, "tokenizedAssets": 40832521.09766898, "projectTokens": 127991991.8951476, "memes": 97655604.67453687 }, "volumeByPair": { "bitcoinUsd": 90844597.05547303, "ethereumUsd": 898613592.2889426, "solanaUsd": 1809988.81597485, "avalancheUsd": 9797718.463858636, "bnbUsd": 118227330.2912434, "bitcoinEthereum": 151862697.7797924, "bitcoinSolana": null, "ethereumSolana": null, "fx": 6687471.277998365, "eurUsd": 5905564.355886682 } } }, { "id": "b0a1e7d1-ad17-49ba-81d2-16f9c3355641", "name": "PancakeSwap", "slug": "pancakeswap", "activity": { "tvl24HourUsd": 2286788690.71832, "activeAddresses24Hour": 162897, "fees24HourUsd": 664036.2045485349 }, "dex": { "feesSupplySide24HourUsd": 446399.81015817117, "tokenIncentives24HourUsd": 38070.03802386702, "expenses24HourUsd": 38070.03802386702, "netDeposits24HourUsd": 2286788690.71832, "treasuryUsd": null, "flashLoanVolume24HourUsd": 102553.70747785387, "tradeablePairs": 2849542, "tradeableAssets": 2721786, "treadeableAssets": 2721786, "dexVolume24HourUsd": 11284996.755292598, "dexTradeCount24Hour": 4358441, "correlatedVolume24HourUsd": 79492276.67852783, "aggregatorVolume24HourUsd": 17245643.64917819, "platformVolume24HourUsd": 1191983.3794902908, "aggregatorTradeCount24Hour": 17245643, "platformTradeCount24Hour": 1191983, "memecoinVolumeShare": 0.038677501870628676, "volumeByCategory": { "nativeStablecoin": 582480589.8714244, "chainToken": 143294.4423089666, "foreignToken": 306091241.9599469, "stablecoinSwaps": 79333037.22933745, "lstSwaps": 72348.2097417814, "composites": 15.62595430888, "tokenizedAssets": 58454818.37974676, "projectTokens": 168185562.4711963, "memes": 48069578.47275978 }, "volumeByPair": { "bitcoinUsd": 51359815.32681513, "ethereumUsd": 99825259.66793564, "solanaUsd": 70871852.46483889, "avalancheUsd": 23017.78853924858, "bnbUsd": 431731776.5037512, "bitcoinEthereum": 100644763.3302905, "bitcoinSolana": 1153140.444712805, "ethereumSolana": 1850879.827798028, "fx": 352157.8581334574, "eurUsd": 345917.3838671498 } } }, { "id": "62725574-8aac-4be8-8b38-a0f2b4398aac", "name": "Curve", "slug": "curve-2", "activity": { "tvl24HourUsd": 1631245137.1477873, "activeAddresses24Hour": 533, "fees24HourUsd": 57329.96492366137 }, "dex": { "feesSupplySide24HourUsd": 23213.235237460634, "tokenIncentives24HourUsd": 96208.51700953535, "expenses24HourUsd": 96208.51700953535, "netDeposits24HourUsd": 1631245137.1477873, "treasuryUsd": 278796.11784157885, "flashLoanVolume24HourUsd": null, "tradeablePairs": null, "tradeableAssets": null, "treadeableAssets": null, "dexVolume24HourUsd": 444073.98400568485, "dexTradeCount24Hour": 30248, "correlatedVolume24HourUsd": null, "aggregatorVolume24HourUsd": null, "platformVolume24HourUsd": null, "aggregatorTradeCount24Hour": null, "platformTradeCount24Hour": null, "memecoinVolumeShare": null } }, { "id": "b52e50ca-13e6-4b00-a540-8c0d10a69bc9", "name": "Orca", "slug": "orca", "activity": { "tvl24HourUsd": 248050290.04041782, "activeAddresses24Hour": 4508, "fees24HourUsd": 259303.79419487246 }, "dex": { "feesSupplySide24HourUsd": 225566.61170471297, "tokenIncentives24HourUsd": 0.1840206719020512, "expenses24HourUsd": 0.1840206719020512, "netDeposits24HourUsd": null, "treasuryUsd": null, "flashLoanVolume24HourUsd": null, "tradeablePairs": 126170, "tradeableAssets": 116784, "treadeableAssets": 116784, "dexVolume24HourUsd": 31617242.873630412, "dexTradeCount24Hour": 1118821, "correlatedVolume24HourUsd": null, "aggregatorVolume24HourUsd": null, "platformVolume24HourUsd": null, "aggregatorTradeCount24Hour": null, "platformTradeCount24Hour": null, "memecoinVolumeShare": null } }, { "id": "b801a2ab-0ab4-44ee-82dc-ac30b1b8318d", "name": "QuickSwap", "slug": "quickswap", "activity": { "tvl24HourUsd": 185495523.80392265, "activeAddresses24Hour": 77121, "fees24HourUsd": 35248.001304907804 }, "dex": { "feesSupplySide24HourUsd": 29488.499384940074, "tokenIncentives24HourUsd": null, "expenses24HourUsd": null, "netDeposits24HourUsd": 185495523.80392265, "treasuryUsd": null, "flashLoanVolume24HourUsd": 13.42724781000264, "tradeablePairs": 144857, "tradeableAssets": 124619, "treadeableAssets": 124619, "dexVolume24HourUsd": null, "dexTradeCount24Hour": 276064, "correlatedVolume24HourUsd": 3622402.858515514, "aggregatorVolume24HourUsd": 0, "platformVolume24HourUsd": 0, "aggregatorTradeCount24Hour": 0, "platformTradeCount24Hour": 0, "memecoinVolumeShare": 5.062029913044644e-05, "volumeByCategory": { "nativeStablecoin": 1464212.458408867, "chainToken": null, "foreignToken": 2620794.852527187, "stablecoinSwaps": 3635104.760788042, "lstSwaps": 26110.13325214984, "composites": null, "tokenizedAssets": null, "projectTokens": 733558.63642968, "memes": 429.2707725675108 }, "volumeByPair": { "bitcoinUsd": 162056.3076958402, "ethereumUsd": 653678.9564637097, "solanaUsd": 2.73559245989, "avalancheUsd": 0.07079254609530412, "bnbUsd": null, "bitcoinEthereum": 243840.148448031, "bitcoinSolana": null, "ethereumSolana": null, "fx": 20919.00708113224, "eurUsd": 20621.3262356116 } } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 22, "totalPages": 3 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List DEX protocols", "tags": [ "metrics/protocols/dex" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: tvl_usd)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "tvl_usd", "active_addresses", "fees_usd", "fees_supply_side_usd", "expenses_usd", "dex_volume_usd", "borrowed_usd", "treasury_usd" ], "default": "tvl_usd" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/protocols/dex/metrics": { "get": { "description": "Returns a list of timeseries metrics available for DEXs", "operationId": "getDexMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "dex", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Net Deposits 24 Hour USD", "slug": "netDeposits24HourUsd", "description": "Net value of deposits into the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Flash Loan Volume 24 Hour USD", "slug": "flashLoanVolume24HourUsd", "description": "Total volume of flash loans in USD.", "is_timestamp": false }, { "name": "Tradeable Pairs", "slug": "tradeablePairs", "description": "Number of trading pairs available on the protocol.", "is_timestamp": false }, { "name": "Tradeable Assets", "slug": "tradeableAssets", "description": "Number of unique assets available for trading.", "is_timestamp": false }, { "name": "DEX Volume 24 Hour USD", "slug": "dexVolume24HourUsd", "description": "Total trading volume on the DEX in USD.", "is_timestamp": false }, { "name": "DEX Trade Count 24 Hour", "slug": "dexTradeCount24Hour", "description": "Number of trades executed on the DEX.", "is_timestamp": false }, { "name": "Correlated Volume 24 Hour USD", "slug": "correlatedVolume24HourUsd", "description": "Volume traded between correlated assets in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Aggregator Volume 24 Hour USD", "slug": "aggregatorVolume24HourUsd", "description": "Volume the exchange received through aggregators in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Platform Volume 24 Hour USD", "slug": "platformVolume24HourUsd", "description": "Volume traded directly on the exchange's own front end in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Aggregator Trade Count 24 Hour", "slug": "aggregatorTradeCount24Hour", "description": "Number of trades the exchange received through aggregators. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Platform Trade Count 24 Hour", "slug": "platformTradeCount24Hour", "description": "Number of trades made directly on the exchange's own front end. Sourced from Blockworks.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List DEX metrics", "tags": [ "metrics/protocols/dex" ] } }, "/metrics/v2/protocols/dex/time-series/{granularity}": { "get": { "description": "Returns one timeseries per DEX protocol, for every protocol the DEX listing serves, in a single response. Use this instead of calling the per-protocol DEX endpoint once for each protocol. Protocols are an aggregation of all deployments across all chains (e.g. Uniswap includes V3, V2 and V1). Every protocol is included, so narrow start and end to limit the response size.", "operationId": "getAllDexTimeseriesV2", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d", "1w" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProtocolTimeseriesEntry" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "protocol": { "id": "44ca6d01-f646-4394-ae0c-6a2789d083f4", "slug": "apeswap", "name": "ApeSwap" }, "points": [ [ 1748736000, 9283904.613956857, 6, 225.4164786992339, 159.929876859997, 0, 0, 9283904.613956857, null, null, 6413, 4553, 68937.67544507078, 11685, null, null, null, null, null ], [ 1748822400, 9364029.742667643, 2, 262.19613971403743, 187.69970236101392, 0, 0, 9364029.742667643, null, null, 6414, 4554, 81274.46435555548, 12509, null, null, null, null, null ], [ 1748908800, 9308761.997873798, 9, 366.94827830319616, 269.2997287292201, 0, 0, 9308761.997873798, null, null, 6414, 4554, 99159.8021448772, 10967, null, null, null, null, null ], [ 1748995200, 9277457.549847417, 3, 239.0314740579374, 168.58744193812873, 0, 0, 9277457.549847417, null, null, 6414, 4554, 79723.46550770226, 11772, null, null, null, null, null ], [ 1749081600, 8896777.19452199, 7, 387.1175110991601, 278.2770686736165, 0, 0, 8896777.19452199, null, null, 6415, 4555, 149152.98878175562, 16022, null, null, null, null, null ] ] }, { "protocol": { "id": "ab2715af-d953-48c6-9a41-6769ca419968", "slug": "balancer", "name": "Balancer" }, "points": [ [ 1748736000, 564953217.6349862, 597, 20583.794569561273, 10291.897284780636, 7339.446807366845, 7339.446807366845, 564953217.6349862, 11563785.887878189, 866122802.6539073, 7686, 4177, 13055238.760492792, 75903, null, null, null, null, null ], [ 1748822400, 580851749.3590931, 408, 43010.407577140395, 21505.203788570198, 8431.188199497385, 8431.188199497385, 580851749.3590931, 11810939.167250317, 580742134.9236892, 7687, 4178, 25802095.412474833, 95966, null, null, null, null, null ], [ 1748908800, 588682646.9955364, 501, 20672.79817556022, 10336.39908778011, 11809.86072718149, 11809.86072718149, 588682646.9955364, 11966627.817746025, 1490352253.0180008, 7687, 4178, 24092263.068957206, 89350, null, null, null, null, null ], [ 1748995200, 582155708.9784327, 367, 34188.0237228611, 17094.01186143055, 8103.467364191301, 8103.467364191301, 582155708.9784327, 11981314.50870812, 1086913006.977004, 7689, 4178, 24999553.20436899, 113261, null, null, null, null, null ], [ 1749081600, 536623242.0307283, 448, 14119.385038748584, 7059.692519374292, 34192.74972818614, 34192.74972818614, 536623242.0307283, 12037932.959435102, 769291514.6248691, 7698, 4187, 20896683.863227557, 138395, null, null, null, null, null ] ] }, { "protocol": { "id": "b2080fe8-468b-4431-b67f-d1126bc0039c", "slug": "biswap", "name": "Biswap" }, "points": [ [ 1748736000, null, 45, 905.8928508525056, 679.4196381393791, null, null, null, 128839.1317426492, 0, 3587, 2448, null, null, null, null, null, null, null ], [ 1748822400, null, 41, 1254.2596754478502, 940.6947565858876, null, null, null, 130816.6435771576, 0, 3587, 2448, null, null, null, null, null, null, null ], [ 1748908800, null, 61, 888.882310727179, 666.6617330453842, null, null, null, 129633.0786272876, 0, 3587, 2448, null, null, null, null, null, null, null ], [ 1748995200, null, 81, 978.7289968869576, 734.0467476652183, null, null, null, 130004.54254419832, 0, 3587, 2448, null, null, null, null, null, null, null ], [ 1749081600, null, 67, 2349.559062686524, 1762.1692970148931, null, null, null, 124402.71133940028, 0, 3587, 2448, null, null, null, null, null, null, null ] ] }, { "protocol": { "id": "62725574-8aac-4be8-8b38-a0f2b4398aac", "slug": "curve-2", "name": "Curve" }, "points": [ [ 1748736000, 2201380144.1594067, 472, 95009.00453599077, 47522.43487531457, 439308.3684986886, 439308.3684986886, 2201380144.159406, 16708998.37836462, null, null, null, 156229907.91029656, 34242, null, null, null, null, null ], [ 1748822400, 2218341797.2182665, 463, 181004.23970778688, 35453.570443836616, 224159.4601791213, 224159.4601791213, 2218341797.2182665, 16874553.292807527, null, null, null, 136152564.8763098, 40528, null, null, null, null, null ], [ 1748908800, 2212359559.4888043, 575, 164524.52843790257, 43369.17178991305, 168023.72946054026, 168023.72946054026, 2212359559.4888043, 16802734.895089682, null, null, null, 189941106.58444074, 51209, null, null, null, null, null ], [ 1748995200, 2219093309.080082, 535, 154003.4142756178, 48046.75200524938, 159458.42606662275, 159458.42606662275, 2219093309.080082, 15698863.91123608, null, null, null, 179327882.022069, 72673, null, null, null, null, null ], [ 1749081600, 2173870157.398219, 712, 136588.4934397026, 49933.21948837055, 268467.9169480476, 268467.9169480476, 2173870157.398219, 15048445.75594037, null, null, null, 236750401.78737435, 60726, null, null, null, null, null ] ] }, { "protocol": { "id": "4dd339bb-5235-42c8-9171-6b7d249b578d", "slug": "dfx", "name": "DFX" }, "points": [ [ 1748736000, null, 0, 0.1903376086693685, 0.0951688043346842, 0, 0, 1030436.8855774796, 188341.35867806425, null, null, null, null, null, null, null, null, null, null ], [ 1748822400, null, 0, 0.047394348588843, 0.0236971742944215, 0, 0, 1073017.9107814622, 192388.34537364828, null, null, null, null, null, null, null, null, null, null ], [ 1748908800, null, 0, 0.1646455053345353, 0.0823227526672676, 0, 0, 1110237.7006933084, 191652.6776520917, null, null, null, null, null, null, null, null, null, null ], [ 1748995200, null, 0, 0, 0, 0, 0, 1146769.6543186526, 192619.00233996077, null, null, null, null, null, null, null, null, null, null ], [ 1749081600, null, 0, 0.27501767216035, 0.137508836080175, 0, 0, 1132822.0091761297, 164818.17335104832, null, null, null, null, null, null, null, null, null, null ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Net Deposits 24 Hour USD", "slug": "netDeposits24HourUsd", "description": "Net value of deposits into the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Flash Loan Volume 24 Hour USD", "slug": "flashLoanVolume24HourUsd", "description": "Total volume of flash loans in USD.", "is_timestamp": false }, { "name": "Tradeable Pairs", "slug": "tradeablePairs", "description": "Number of trading pairs available on the protocol.", "is_timestamp": false }, { "name": "Tradeable Assets", "slug": "tradeableAssets", "description": "Number of unique assets available for trading.", "is_timestamp": false }, { "name": "DEX Volume 24 Hour USD", "slug": "dexVolume24HourUsd", "description": "Total trading volume on the DEX in USD.", "is_timestamp": false }, { "name": "DEX Trade Count 24 Hour", "slug": "dexTradeCount24Hour", "description": "Number of trades executed on the DEX.", "is_timestamp": false }, { "name": "Correlated Volume 24 Hour USD", "slug": "correlatedVolume24HourUsd", "description": "Volume traded between correlated assets in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Aggregator Volume 24 Hour USD", "slug": "aggregatorVolume24HourUsd", "description": "Volume the exchange received through aggregators in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Platform Volume 24 Hour USD", "slug": "platformVolume24HourUsd", "description": "Volume traded directly on the exchange's own front end in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Aggregator Trade Count 24 Hour", "slug": "aggregatorTradeCount24Hour", "description": "Number of trades the exchange received through aggregators. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Platform Trade Count 24 Hour", "slug": "platformTradeCount24Hour", "description": "Number of trades made directly on the exchange's own front end. Sourced from Blockworks.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get All DEX Time Series", "tags": [ "metrics/protocols/dex" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/dex/time-series/{granularity}": { "get": { "description": "Returns a timeseries metric for a specific DEX. Protocols will be an aggregation of all deployments across all chains (e.g., Uniswap will include V3, V2, and V1).", "operationId": "getDexTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "uniswap", "default": "uniswap" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 40874983380.06086, 8894, 1803840.5151728864, 1534847.1850615353, 44883.088839995566, 44883.088839995566, 40874983380.06086, 249689038.2528827, null, null, null, null, null, null, null, null, null, null ], [ 1748822400, 41493958468.891754, 8801, 1503209.007828896, 1268459.8070935463, 79172.7962739207, 79172.7962739207, 41493958468.891754, 254306555.8746326, null, null, null, null, null, null, null, null, null, null ], [ 1748908800, 41587470329.870155, 9871, 1524454.7886562573, 1289423.8766373072, 56124.78365219167, 56124.78365219167, 41587470329.870155, 260633515.67957327, null, null, null, null, null, null, null, null, null, null ], [ 1748995200, 41911763138.436165, 10204, 1527950.2199558418, 1297908.365999997, 264418.62121689686, 264418.62121689686, 41911763138.436165, 260062527.57958496, null, null, null, null, null, null, null, null, null, null ], [ 1749081600, 39703840117.46197, 12350, 2486100.5018659243, 2155761.9465042762, 1243578.0972587697, 1243578.0972587697, 39703840117.46197, 244922570.73489606, null, null, null, null, null, null, null, null, null, null ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Net Deposits 24 Hour USD", "slug": "netDeposits24HourUsd", "description": "Net value of deposits into the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Flash Loan Volume 24 Hour USD", "slug": "flashLoanVolume24HourUsd", "description": "Total volume of flash loans in USD.", "is_timestamp": false }, { "name": "Tradeable Pairs", "slug": "tradeablePairs", "description": "Number of trading pairs available on the protocol.", "is_timestamp": false }, { "name": "Tradeable Assets", "slug": "tradeableAssets", "description": "Number of unique assets available for trading.", "is_timestamp": false }, { "name": "DEX Volume 24 Hour USD", "slug": "dexVolume24HourUsd", "description": "Total trading volume on the DEX in USD.", "is_timestamp": false }, { "name": "DEX Trade Count 24 Hour", "slug": "dexTradeCount24Hour", "description": "Number of trades executed on the DEX.", "is_timestamp": false }, { "name": "Correlated Volume 24 Hour USD", "slug": "correlatedVolume24HourUsd", "description": "Volume traded between correlated assets in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Aggregator Volume 24 Hour USD", "slug": "aggregatorVolume24HourUsd", "description": "Volume the exchange received through aggregators in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Platform Volume 24 Hour USD", "slug": "platformVolume24HourUsd", "description": "Volume traded directly on the exchange's own front end in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Aggregator Trade Count 24 Hour", "slug": "aggregatorTradeCount24Hour", "description": "Number of trades the exchange received through aggregators. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Platform Trade Count 24 Hour", "slug": "platformTradeCount24Hour", "description": "Number of trades made directly on the exchange's own front end. Sourced from Blockworks.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get DEX timeseries metric", "tags": [ "metrics/protocols/dex" ] } }, "/metrics/v2/protocols/lending": { "get": { "description": "Returns a complete list of all available Lending protocols supported by Messari, along with metrics. The response aggregates data across all deployments and versions of protocols (e.g., AAVE includes V3, V2, and V1).", "operationId": "getLendingProtocolsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave", "activity": { "tvl24HourUsd": 29943935339.394585, "activeAddresses24Hour": 6385, "fees24HourUsd": 2364765.883961379 }, "lending": { "feesSupplySide24HourUsd": 2061684.4840612353, "tokenIncentives24HourUsd": 51149.58720065142, "expenses24HourUsd": 51149.58720065142, "netDeposits24HourUsd": 29943935339.394585, "treasuryUsd": 167555454.4819777, "borrowedUsd": 12400174597.438202, "depositsUsd": 29181238353.540382, "interest24HourUsd": 1056219.7677710939, "netInterestIncome24HourUsd": 138894.2030648238, "flashLoanFees24HourUsd": 1188.8200917318395, "liquidationFees24HourUsd": 10.180472253331036, "royalties24HourUsd": 0, "instances": [ { "productSlug": "aave-v2", "chain": "avalanche_c" }, { "productSlug": "aave-v2", "chain": "ethereum" }, { "productSlug": "aave-v2", "chain": "polygon" }, { "productSlug": "aave-v3", "chain": "arbitrum" }, { "productSlug": "aave-v3", "chain": "avalanche_c" } ] } }, { "id": "ed659e93-6de9-4c95-8e9c-4ae0e3889826", "name": "Maple Finance (legacy)", "slug": "maple-finance", "activity": { "tvl24HourUsd": 4966641378.853602, "activeAddresses24Hour": 64, "fees24HourUsd": 0 }, "lending": { "feesSupplySide24HourUsd": 0, "tokenIncentives24HourUsd": 0, "expenses24HourUsd": 0, "netDeposits24HourUsd": 4915205052.5221195, "treasuryUsd": 10852208.194671996, "borrowedUsd": 1256444793.85, "depositsUsd": 1915899871.955055, "interest24HourUsd": 0, "netInterestIncome24HourUsd": 0, "flashLoanFees24HourUsd": 0, "liquidationFees24HourUsd": 0, "royalties24HourUsd": 0, "instances": [ { "productSlug": "AQRU Maple Pool USDC1", "chain": "ethereum" }, { "productSlug": "High Yield Corporate Loan Maple", "chain": "ethereum" }, { "productSlug": "High Yield Secured Lending Mapl", "chain": "ethereum" }, { "productSlug": "Icebreaker Maple Pool USDC1", "chain": "ethereum" }, { "productSlug": "Laser Maple Pool USDC.k1", "chain": "ethereum" } ] } }, { "id": "21ef8a1b-7b6d-47a8-ac7e-b3c1aac3905b", "name": "Fluid", "slug": "fluid-instadapp", "activity": { "tvl24HourUsd": 3742780774.2219872, "activeAddresses24Hour": 135, "fees24HourUsd": 114862.59498435636 }, "lending": { "feesSupplySide24HourUsd": 95084.49954204561, "tokenIncentives24HourUsd": 0, "expenses24HourUsd": 0, "netDeposits24HourUsd": 3742780774.2219872, "treasuryUsd": 22373686.906483516, "borrowedUsd": 1707101853.2502735, "depositsUsd": 1548155177.379448, "interest24HourUsd": 114715.92918028038, "netInterestIncome24HourUsd": 11471.592918028042, "flashLoanFees24HourUsd": 0, "liquidationFees24HourUsd": 0, "royalties24HourUsd": 0, "instances": [ { "productSlug": "fluid-lend", "chain": "arbitrum" }, { "productSlug": "fluid-lend", "chain": "base" }, { "productSlug": "fluid-lend", "chain": "ethereum" }, { "productSlug": "fluid-lend", "chain": "plasma" }, { "productSlug": "fluid-lend", "chain": "polygon" } ] } }, { "id": "b4a4024c-14c1-4e90-b092-b27cb58b7521", "name": "Compound", "slug": "compound", "activity": { "tvl24HourUsd": 1955709449.9308121, "activeAddresses24Hour": 494, "fees24HourUsd": 73709.78602654302 }, "lending": { "feesSupplySide24HourUsd": 65961.76513859248, "tokenIncentives24HourUsd": 33.95012031696253, "expenses24HourUsd": 33.95012031696253, "netDeposits24HourUsd": 1955709449.9308121, "treasuryUsd": 8012764.930828158, "borrowedUsd": 617968609.0015558, "depositsUsd": 2089289189.1639314, "interest24HourUsd": 71602.98762832422, "netInterestIncome24HourUsd": 7254.79118260254, "flashLoanFees24HourUsd": 0, "liquidationFees24HourUsd": 0, "royalties24HourUsd": 0, "instances": [ { "productSlug": "compound-v2", "chain": "ethereum" }, { "productSlug": "compound-v3", "chain": "arbitrum" }, { "productSlug": "compound-v3", "chain": "base" }, { "productSlug": "compound-v3", "chain": "ethereum" }, { "productSlug": "compound-v3", "chain": "linea" } ] } }, { "id": "650fae24-3873-4399-95fe-014f6b561c56", "name": "Venus", "slug": "venus", "activity": { "tvl24HourUsd": 1725407576.5511098, "activeAddresses24Hour": 353, "fees24HourUsd": 27524.128284583632 }, "lending": { "feesSupplySide24HourUsd": 22868.67541776088, "tokenIncentives24HourUsd": 260.37062234273026, "expenses24HourUsd": 260.37062234273026, "netDeposits24HourUsd": 1725407576.5511098, "treasuryUsd": 65284042.03028923, "borrowedUsd": 444539896.73888695, "depositsUsd": 1687790924.7098606, "interest24HourUsd": 26432.052901783176, "netInterestIncome24HourUsd": 4768.236782285632, "flashLoanFees24HourUsd": 0, "liquidationFees24HourUsd": 0.20064082605764894, "royalties24HourUsd": 0, "instances": [ { "productSlug": "venus-flux", "chain": "bnb" }, { "productSlug": "venus", "chain": "arbitrum" }, { "productSlug": "venus", "chain": "base" }, { "productSlug": "venus", "chain": "bnb" }, { "productSlug": "venus", "chain": "ethereum" } ] } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 15, "totalPages": 2 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List lending protocols", "tags": [ "metrics/protocols/lending" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: tvl_usd)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "tvl_usd", "active_addresses", "fees_usd", "fees_supply_side_usd", "expenses_usd", "dex_volume_usd", "borrowed_usd", "treasury_usd" ], "default": "tvl_usd" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/protocols/lending/metrics": { "get": { "description": "Returns a list of timeseries metrics available for lending protocols", "operationId": "getLendingMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "lending", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Net Deposits 24 Hour USD", "slug": "netDeposits24HourUsd", "description": "Net value of deposits into the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Borrowed USD", "slug": "borrowedUsd", "description": "Total value of assets borrowed from the protocol in USD.", "is_timestamp": false }, { "name": "Deposits USD", "slug": "depositsUsd", "description": "Value deposited with the lending protocol in USD. This is a balance, unlike Net Deposits USD, which is a daily flow. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Interest 24 Hour USD", "slug": "interest24HourUsd", "description": "Interest paid by borrowers in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Net Interest Income 24 Hour USD", "slug": "netInterestIncome24HourUsd", "description": "Interest earned less the interest paid out to depositors, in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Flash Loan Fees 24 Hour USD", "slug": "flashLoanFees24HourUsd", "description": "Fees earned on flash loans in USD. This is a fee, unlike Flash Loan Volume USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Liquidation Fees 24 Hour USD", "slug": "liquidationFees24HourUsd", "description": "Fees earned on liquidations in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Royalties 24 Hour USD", "slug": "royalties24HourUsd", "description": "Royalties paid to the protocol in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Revenue USD", "slug": "revenueUsd", "description": "Daily lending revenue in USD, net interest income plus flash loan, liquidation and royalty fees. Distinct from Revenue USD, which is total protocol revenue from a different source. Sourced from Blockworks Research.", "is_timestamp": false } ] }, { "slug": "lending-instances", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Deposits (USD)", "slug": "depositsUsd", "description": "Total deposits (supply and collateral) in USD across the product's markets. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Borrowed (USD)", "slug": "borrowedUsd", "description": "Total outstanding borrows in USD across the product's markets. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "TVL (USD)", "slug": "tvl24HourUsd", "description": "TVL in USD, deposits minus borrows. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Interest (USD)", "slug": "interest24HourUsd", "description": "Daily interest paid by borrowers in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Net Interest Income (USD)", "slug": "netInterestIncome24HourUsd", "description": "Daily net interest income in USD, the interest kept by the protocol. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Flash Loan Fees (USD)", "slug": "flashLoanFees24HourUsd", "description": "Daily flash loan fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Liquidation Fees (USD)", "slug": "liquidationFees24HourUsd", "description": "Daily liquidation fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Royalties (USD)", "slug": "royalties24HourUsd", "description": "Daily royalty fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Fees (USD)", "slug": "fees24HourUsd", "description": "Daily total fees in USD, interest plus flash loan, liquidation and royalty fees. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Revenue (USD)", "slug": "revenueUsd", "description": "Daily revenue in USD, net interest income plus flash loan, liquidation and royalty fees. Sourced from Blockworks Research.", "is_timestamp": false } ] }, { "slug": "lending-markets", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Deposits (USD)", "slug": "depositsUsd", "description": "Total deposits (supply and collateral) in USD across the market's tokens. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Borrowed (USD)", "slug": "borrowedUsd", "description": "Total outstanding borrows in USD across the market's tokens. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "TVL (USD)", "slug": "tvl24HourUsd", "description": "TVL in USD, deposits minus borrows. Sourced from Blockworks Research.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List lending metrics", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/lending/time-series/{granularity}": { "get": { "description": "Returns one timeseries per lending protocol, for every protocol the lending listing serves, in a single response. Use this instead of calling the per-protocol lending endpoint once for each protocol. The response aggregates data across all deployments and versions of protocols (e.g., AAVE includes V3, V2, and V1). This is the protocol grain only; for a series per instance or per market, use the lending-instances and lending-markets endpoints. Every protocol is included, so narrow start and end to limit the response size.", "operationId": "getAllLendingTimeseriesV2", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d", "1w" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProtocolTimeseriesEntry" }, "type": "array" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "protocol": { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "slug": "aave", "name": "Aave" }, "points": [ [ 1748736000, 40874983380.06086, 8894, 1803840.5151728864, 1534847.1850615353, 44883.088839995566, 44883.088839995566, 40874983380.06086, 249689038.2528827, 16294149438.990723, 40268112671.70828, 1551387.839683547, 197169.2727293963, 1.6598382227577217, 207.1847393765548, 0, 197378.1173069956 ], [ 1748822400, 41493958468.891754, 8801, 1503209.007828896, 1268459.8070935463, 79172.7962739207, 79172.7962739207, 41493958468.891754, 254306555.8746326, 16585912225.029522, 40359824834.80632, 1564840.7767739724, 197873.75184447062, 2.8038795777402337, 4.890537270539835, 0, 197881.44626131892 ], [ 1748908800, 41587470329.870155, 9871, 1524454.7886562573, 1289423.8766373072, 56124.78365219167, 56124.78365219167, 41587470329.870155, 260633515.67957327, 16610197883.470901, 41412415086.66814, 1615121.062744834, 203794.93652453623, 2.320478688222493, 98.13338385263711, 0, 203895.3903870771 ], [ 1748995200, 41911763138.436165, 10204, 1527950.2199558418, 1297908.365999997, 264418.62121689686, 264418.62121689686, 41911763138.436165, 260062527.57958496, 16791416443.23892, 41684712563.3855, 1634185.9690682248, 206257.13982246685, 1.1849291085353384, 5.303010913648925, 0, 206263.62776248905 ], [ 1749081600, 39703840117.46197, 12350, 2486100.5018659243, 2155761.9465042762, 1243578.0972587697, 1243578.0972587697, 39703840117.46197, 244922570.73489606, 15931300843.386644, 40829202853.07711, 2065674.2559990229, 248763.88267701067, 9.36715973164632, 10989.644258556362, 0, 259762.8940952987 ] ] }, { "protocol": { "id": "b4a4024c-14c1-4e90-b092-b27cb58b7521", "slug": "compound", "name": "Compound" }, "points": [ [ 1748736000, 3379495333.42196, 716, 105441.86089911278, 95485.43110105432, 10735.314139887734, 10735.314139887734, 3379495333.42196, 44465278.77244486, 1003472763.3842549, 3548842878.5220904, 106267.26551551247, 10066.057073530052, 0, 7, 0, 10073.057073530052 ], [ 1748822400, 3403042744.0751905, 654, 105825.84725324147, 95836.54541374776, 12142.9154771638, 12142.9154771638, 3403042744.0751905, 45348187.19411568, 1015432415.1546865, 3567518748.9408865, 105969.7767406129, 9808.44892614686, 0, 0, 0, 9808.44892614686 ], [ 1748908800, 3493381405.3334208, 851, 109010.94019437824, 98148.64962861588, 8431.141850663182, 8431.141850663182, 3493381405.3334208, 48082532.32236777, 1024490661.7775595, 3632533132.2667365, 110986.43288509475, 10900.286123244994, 0, 0, 0, 10900.286123244994 ], [ 1748995200, 3363395710.525871, 1022, 107866.4251033833, 97319.59629084589, 48285.58223824978, 48285.58223824978, 3363395710.525871, 48261170.796743125, 1019414060.0750184, 3624374450.291818, 108080.12246775754, 10537.008252815884, 0, 0, 0, 10537.008252815884 ], [ 1749081600, 3364888591.4737496, 886, 118831.1053353625, 106748.92345247106, 5703.171372341787, 5703.171372341787, 3364888591.4737496, 45443866.35926631, 1004495707.7190264, 3575406713.274932, 124040.23569632549, 12626.817302221016, 0, 4811, 0, 17437.817302221018 ] ] }, { "protocol": { "id": "08805846-f74d-4f4c-9b61-ea345f942f31", "slug": "dolomite", "name": "Dolomite" }, "points": [ [ 1748736000, 254486968.92432517, 220, 23821.667130493617, 17523.42911107255, 0, 34.456541402280145, 254486968.92432517, null, 78198451.00543317, null, null, null, null, null, null, null ], [ 1748822400, 261317629.79176745, 229, 23169.846591529567, 17209.488444310253, 0, 38.6730393896864, 261317629.79176745, null, 78619495.24061483, null, null, null, null, null, null, null ], [ 1748908800, 254764081.66747215, 242, 27190.687840641138, 20177.120920234924, 0, 700.0560565770737, 254764081.66747215, null, 77630629.8551523, null, null, null, null, null, null, null ], [ 1748995200, 259132669.4210086, 215, 47961.12164510309, 37981.885147810426, 0, 117.80520825975503, 259132669.4210086, null, 81969203.40594465, null, null, null, null, null, null, null ], [ 1749081600, 219942474.14345703, 298, 21072.698394237785, 15356.312068061565, 0, 2629.9225741938703, 219942474.14345703, null, 59223149.91794719, null, null, null, null, null, null, null ] ] }, { "protocol": { "id": "4bb0dcdd-75ae-4b34-92fc-64400dcdff8e", "slug": "euler-finance", "name": "Euler Finance" }, "points": [ [ 1748736000, 1782185302.9735782, 987, 102533.37060473644, 90090.70547369728, null, null, 1782185302.9735782, 37735544.27595803, 864370180.139309, 1771216808.1239774, 143664.4270215827, 11813.947018694133, 0, 0, 0, 11813.947018694133 ], [ 1748822400, 1779734256.5965266, 1267, 105129.14316467613, 93373.8254768025, null, null, 1779734256.5965266, 38612789.42935929, 856679236.9142518, 1802219978.7652335, 145130.71915694055, 11697.020416042147, 0, 0, 0, 11697.020416042147 ], [ 1748908800, 1795723464.601608, 3281, 109418.91347906101, 96846.91258378931, null, null, 1795723464.601608, 38215246.87043049, 873139113.7630298, 1805149636.207731, 146959.5953304491, 12676.096870811982, 0, 0, 0, 12676.096870811982 ], [ 1748995200, 1826808766.103897, 2819, 111236.04774370493, 98319.3589257784, null, null, 1826808766.103897, 38322470.28133832, 893678251.9342333, 1843098427.2084424, 150273.20982257117, 12661.291276429296, 0, 0, 0, 12661.291276429296 ], [ 1749081600, 1804328855.7277777, 2689, 106748.49242587008, 94292.40658426638, null, null, 1804328855.7277777, 34621791.280557804, 886718536.1130446, 1855282876.6489198, 157393.60629128572, 12533.896655553419, 0, 0, 0, 12533.896655553419 ] ] }, { "protocol": { "id": "21ef8a1b-7b6d-47a8-ac7e-b3c1aac3905b", "slug": "fluid-instadapp", "name": "Fluid" }, "points": [ [ 1748736000, 2064707906.911739, 201, 137137.90912230843, 116566.1698840688, 0, 0, 2064707906.911739, 107016160.41469081, 907149562.4728653, 1881105309.6363502, 82701.6628755591, 8270.16628755591, 0, 0, 0, 8270.16628755591 ], [ 1748822400, 2110304435.9401305, 199, 109691.09033938145, 96200.45887418688, 0, 0, 2110304435.9401305, 109339230.24893554, 937645689.6318932, 1900565869.8538463, 84792.3704977696, 8479.23704977696, 0, 0, 0, 8479.23704977696 ], [ 1748908800, 2146841633.4441354, 198, 157741.4587619406, 131525.3565711596, 0, 0, 2146841633.4441354, 107421846.34080963, 968524013.3314428, 1974739151.3160229, 90270.80866200743, 9027.080866200744, 0, 0, 0, 9027.080866200744 ], [ 1748995200, 2139515430.9217832, 194, 108555.94986905789, 92522.59674930149, 0, 0, 2139515430.9217832, 108619827.7036162, 963057898.5094433, 1965651169.4630187, 91064.08841871597, 9106.408841871611, 0, 0, 0, 9106.408841871611 ], [ 1749081600, 2048729382.1516364, 268, 190673.1181884097, 165676.38144782657, 0, 0, 2048729382.1516364, 100450402.33476938, 931591979.8880106, 1942493662.2212415, 92342.98364738666, 9234.298364738659, 0, 0, 0, 9234.298364738659 ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Net Deposits 24 Hour USD", "slug": "netDeposits24HourUsd", "description": "Net value of deposits into the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Borrowed USD", "slug": "borrowedUsd", "description": "Total value of assets borrowed from the protocol in USD.", "is_timestamp": false }, { "name": "Deposits USD", "slug": "depositsUsd", "description": "Value deposited with the lending protocol in USD. This is a balance, unlike Net Deposits USD, which is a daily flow. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Interest 24 Hour USD", "slug": "interest24HourUsd", "description": "Interest paid by borrowers in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Net Interest Income 24 Hour USD", "slug": "netInterestIncome24HourUsd", "description": "Interest earned less the interest paid out to depositors, in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Flash Loan Fees 24 Hour USD", "slug": "flashLoanFees24HourUsd", "description": "Fees earned on flash loans in USD. This is a fee, unlike Flash Loan Volume USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Liquidation Fees 24 Hour USD", "slug": "liquidationFees24HourUsd", "description": "Fees earned on liquidations in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Royalties 24 Hour USD", "slug": "royalties24HourUsd", "description": "Royalties paid to the protocol in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Revenue USD", "slug": "revenueUsd", "description": "Daily lending revenue in USD, net interest income plus flash loan, liquidation and royalty fees. Distinct from Revenue USD, which is total protocol revenue from a different source. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get All Lending Time Series", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/lending/time-series/{granularity}": { "get": { "description": "Returns a timeseries metric for a specific Lending Protocol. Protocol data represents an aggregation of all deployments across all chains.", "operationId": "getLendingTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "aave", "default": "aave" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 40874983380.06086, 8894, 1803840.5151728864, 1534847.1850615353, 44883.088839995566, 44883.088839995566, 40874983380.06086, 249689038.2528827, 16294149438.990723, 40268112671.70828, 1551387.839683547, 197169.2727293963, 1.6598382227577217, 207.1847393765548, 0, 197378.1173069956 ], [ 1748822400, 41493958468.891754, 8801, 1503209.007828896, 1268459.8070935463, 79172.7962739207, 79172.7962739207, 41493958468.891754, 254306555.8746326, 16585912225.029522, 40359824834.80632, 1564840.7767739724, 197873.75184447062, 2.8038795777402337, 4.890537270539835, 0, 197881.44626131892 ], [ 1748908800, 41587470329.870155, 9871, 1524454.7886562573, 1289423.8766373072, 56124.78365219167, 56124.78365219167, 41587470329.870155, 260633515.67957327, 16610197883.470901, 41412415086.66814, 1615121.062744834, 203794.93652453623, 2.320478688222493, 98.13338385263711, 0, 203895.3903870771 ], [ 1748995200, 41911763138.436165, 10204, 1527950.2199558418, 1297908.365999997, 264418.62121689686, 264418.62121689686, 41911763138.436165, 260062527.57958496, 16791416443.23892, 41684712563.3855, 1634185.9690682248, 206257.13982246685, 1.1849291085353384, 5.303010913648925, 0, 206263.62776248905 ], [ 1749081600, 39703840117.46197, 12350, 2486100.5018659243, 2155761.9465042762, 1243578.0972587697, 1243578.0972587697, 39703840117.46197, 244922570.73489606, 15931300843.386644, 40829202853.07711, 2065674.2559990229, 248763.88267701067, 9.36715973164632, 10989.644258556362, 0, 259762.8940952987 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Net Deposits 24 Hour USD", "slug": "netDeposits24HourUsd", "description": "Net value of deposits into the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Borrowed USD", "slug": "borrowedUsd", "description": "Total value of assets borrowed from the protocol in USD.", "is_timestamp": false }, { "name": "Deposits USD", "slug": "depositsUsd", "description": "Value deposited with the lending protocol in USD. This is a balance, unlike Net Deposits USD, which is a daily flow. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Interest 24 Hour USD", "slug": "interest24HourUsd", "description": "Interest paid by borrowers in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Net Interest Income 24 Hour USD", "slug": "netInterestIncome24HourUsd", "description": "Interest earned less the interest paid out to depositors, in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Flash Loan Fees 24 Hour USD", "slug": "flashLoanFees24HourUsd", "description": "Fees earned on flash loans in USD. This is a fee, unlike Flash Loan Volume USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Liquidation Fees 24 Hour USD", "slug": "liquidationFees24HourUsd", "description": "Fees earned on liquidations in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Royalties 24 Hour USD", "slug": "royalties24HourUsd", "description": "Royalties paid to the protocol in USD. Sourced from Blockworks.", "is_timestamp": false }, { "name": "Revenue USD", "slug": "revenueUsd", "description": "Daily lending revenue in USD, net interest income plus flash loan, liquidation and royalty fees. Distinct from Revenue USD, which is total protocol revenue from a different source. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get lending timeseries metric", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/lending-instances/metrics": { "get": { "description": "Returns the timeseries metrics available for the lending-instances dataset. The dataset carries the same ten Blockworks Research lending metrics as the protocol-grain lending dataset, at product x chain grain.", "operationId": "getLendingInstancesMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "lending-instances", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Deposits (USD)", "slug": "depositsUsd", "description": "Total deposits (supply and collateral) in USD across the product's markets. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Borrowed (USD)", "slug": "borrowedUsd", "description": "Total outstanding borrows in USD across the product's markets. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "TVL (USD)", "slug": "tvl24HourUsd", "description": "TVL in USD, deposits minus borrows. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Interest (USD)", "slug": "interest24HourUsd", "description": "Daily interest paid by borrowers in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Net Interest Income (USD)", "slug": "netInterestIncome24HourUsd", "description": "Daily net interest income in USD, the interest kept by the protocol. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Flash Loan Fees (USD)", "slug": "flashLoanFees24HourUsd", "description": "Daily flash loan fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Liquidation Fees (USD)", "slug": "liquidationFees24HourUsd", "description": "Daily liquidation fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Royalties (USD)", "slug": "royalties24HourUsd", "description": "Daily royalty fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Fees (USD)", "slug": "fees24HourUsd", "description": "Daily total fees in USD, interest plus flash loan, liquidation and royalty fees. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Revenue (USD)", "slug": "revenueUsd", "description": "Daily revenue in USD, net interest income plus flash loan, liquidation and royalty fees. Sourced from Blockworks Research.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List lending instance metrics", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/lending-instances/time-series/{granularity}": { "get": { "description": "Returns one timeseries per instance of a lending protocol, where an instance is a product on a chain (for example aave-v3 on ethereum). Each series carries its own productSlug and chain, so you do not have to parse the composite series id. A protocol that Blockworks Research does not map returns 200 with an empty series list; an unknown identifier returns 404. The response caps at 100 series, above which a 400 names the filters that narrow it.", "operationId": "getLendingInstancesTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "aave", "default": "aave" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/LendingSeriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/LendingSeriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "series": [ { "id": "aave_aave-v2_avalanche_c", "productSlug": "aave-v2", "chain": "avalanche_c", "points": [ [ 1748736000, 23510950.643165242, 2376072.6093996367, 21134878.033765607, 301.01694037900495, 240.81355230320406, null, null, null, 301.01694037900495, 240.81355230320406 ], [ 1748822400, 23523794.091174293, 2376248.4934064513, 21147545.59776784, 319.8424524524242, 255.87396196193936, null, null, null, 319.8424524524242, 255.87396196193936 ], [ 1748908800, 23788075.803780608, 2383901.4966985104, 21404174.307082098, 310.49614690200985, 248.39691752160786, null, null, null, 310.49614690200985, 248.39691752160786 ], [ 1748995200, 23724622.839787386, 2380605.459132212, 21344017.380655173, 356.1887488826583, 292.2990269312045, null, null, null, 356.1887488826583, 292.2990269312045 ], [ 1749081600, 23382182.466817264, 2368096.8816541755, 21014085.585163087, 318.96365988463714, 255.1709279077097, 1.7447996631129166, null, null, 320.70845954775007, 256.91572757082264 ] ] }, { "id": "aave_aave-v2_ethereum", "productSlug": "aave-v2", "chain": "ethereum", "points": [ [ 1748736000, 9551.686342817173, 51.80130061469237, 9499.88504220248, null, null, null, null, null, null, null ], [ 1748822400, 9606.47023431713, 52.09840802908795, 9554.371826288043, null, null, null, null, null, null, null ], [ 1748908800, 9994.038037074974, 54.20028988938714, 9939.837747185586, null, null, null, null, null, null, null ], [ 1748995200, 9947.98670475451, 53.95054143412789, 9894.036163320383, null, null, null, null, null, null, null ], [ 1749081600, 9539.681600128959, 51.73619574603619, 9487.945404382923, null, null, null, null, null, null, null ] ] }, { "id": "aave_aave-v2_polygon", "productSlug": "aave-v2", "chain": "polygon", "points": [ [ 1748736000, 38569752.827218965, 3794864.69262788, 34774888.13459109, 739.7777373570226, 739.7037595832874, null, null, null, 739.7777373570226, 739.7037595832874 ], [ 1748822400, 38621212.893048756, 3796818.0100005027, 34824394.88304825, 737.0167610107412, 736.9430593346403, null, null, null, 737.0167610107412, 736.9430593346403 ], [ 1748908800, 39331042.423220664, 3827882.368949122, 35503160.05427154, 734.2401606879171, 734.1667366718483, 0.21408820030553471, null, null, 734.4542488882227, 734.3808248721539 ], [ 1748995200, 39305813.58849489, 3828104.5682649044, 35477709.02022999, 736.7596252460398, 736.685949283516, 0.18822759430621044, null, null, 736.9478528403461, 736.8741768778222 ], [ 1749081600, 38770014.970714115, 3801301.6189646525, 34968713.351749465, 743.9805846096467, 743.9061865511845, null, null, null, 743.9805846096467, 743.9061865511845 ] ] }, { "id": "aave_aave-v3_arbitrum", "productSlug": "aave-v3", "chain": "arbitrum", "points": [ [ 1748736000, 1392810041.7209344, 540777750.2162962, 852032291.5046382, 50865.11657335174, 6288.096754812424, 0.5210811234784968, 0, null, 50865.63765447522, 6288.617835935902 ], [ 1748822400, 1379438050.846866, 534573903.878233, 844864146.9686329, 50566.44057323932, 6241.969863846052, 0.6309275901232236, 0.6077457931198094, null, 50567.67924662256, 6243.208537229295 ], [ 1748908800, 1417208445.081294, 545077998.9018447, 872130446.1794493, 49988.74034171699, 6207.327096757944, 0.5865558441849725, 0, null, 49989.32689756117, 6207.913652602128 ], [ 1748995200, 1408689076.4192958, 542510458.7211453, 866178617.6981505, 50313.73129830093, 6261.333838007798, 0.36022933291254006, 3.697900313428462, null, 50317.78942794727, 6265.391967654139 ], [ 1749081600, 1378255015.0168488, 529904072.81535995, 848350942.2014889, 49828.59870878518, 6180.594927249853, 0.839282800545761, 1267.9700421617038, null, 51097.408033747444, 7449.404252212103 ] ] }, { "id": "aave_aave-v3_avalanche_c", "productSlug": "aave-v3", "chain": "avalanche_c", "points": [ [ 1748736000, 1057401488.071581, 356742939.47328234, 700658548.5982987, 37426.31143302348, 5082.797263440349, 0.3942830874612327, 0.5083066531066874, null, 37427.21402276405, 5083.699853180916 ], [ 1748822400, 1066133677.693049, 363787851.34041595, 702345826.352633, 42660.61682321578, 5854.279755109773, 0.5118179279661097, 0.3314130641497396, null, 42661.46005420789, 5855.122986101888 ], [ 1748908800, 1081216165.9432366, 369133810.77200663, 712082355.17123, 46630.357404025606, 6511.654116727927, 0.4650503092123496, 0, null, 46630.82245433482, 6512.11916703714 ], [ 1748995200, 1079830349.4492311, 369258960.8018748, 710571388.6473563, 46477.85911948461, 6492.938819797229, 0.1236919134837602, 0, null, 46477.98281139809, 6493.062511710714 ], [ 1749081600, 1060196353.3508334, 362117295.1509563, 698079058.1998771, 51156.28663196303, 7154.086474138776, 0.5928843028712506, 1551.5953951695583, null, 52708.47491143545, 8706.274753611206 ] ] } ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Deposits (USD)", "slug": "depositsUsd", "description": "Total deposits (supply and collateral) in USD across the product's markets. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Borrowed (USD)", "slug": "borrowedUsd", "description": "Total outstanding borrows in USD across the product's markets. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "TVL (USD)", "slug": "tvl24HourUsd", "description": "TVL in USD, deposits minus borrows. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Interest (USD)", "slug": "interest24HourUsd", "description": "Daily interest paid by borrowers in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Net Interest Income (USD)", "slug": "netInterestIncome24HourUsd", "description": "Daily net interest income in USD, the interest kept by the protocol. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Flash Loan Fees (USD)", "slug": "flashLoanFees24HourUsd", "description": "Daily flash loan fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Liquidation Fees (USD)", "slug": "liquidationFees24HourUsd", "description": "Daily liquidation fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Royalties (USD)", "slug": "royalties24HourUsd", "description": "Daily royalty fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Fees (USD)", "slug": "fees24HourUsd", "description": "Daily total fees in USD, interest plus flash loan, liquidation and royalty fees. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Revenue (USD)", "slug": "revenueUsd", "description": "Daily revenue in USD, net interest income plus flash loan, liquidation and royalty fees. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d", "seriesCount": 20 } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get lending instances timeseries", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/lending-markets": { "get": { "description": "Returns a paginated list of Blockworks Research lending markets, one row per individual pool, filterable by protocol, product and chain. The protocol object is the parent protocol, so its slug passes straight back as the protocol filter; the specific product (aave-v3 rather than aave) is the sibling productSlug field, which the product filter matches. Each marketId is a composite of parent slug, product slug, chain and market key, keyed on the pool address rather than the market name so that it survives an upstream rename.", "operationId": "getLendingMarketsV2", "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "type": "integer", "format": "int64", "example": 1, "default": 1 } }, { "description": "Page size limit", "in": "query", "name": "limit", "schema": { "type": "integer", "format": "int64", "example": 10, "default": 10 } }, { "description": "Filter to a parent protocol slug", "in": "query", "name": "protocol", "schema": { "type": "string", "example": "aave" } }, { "description": "Filter to a Blockworks Research product slug", "in": "query", "name": "product", "schema": { "type": "string", "example": "aave-v3" } }, { "description": "Filter to a Blockworks Research chain slug", "in": "query", "name": "chain", "schema": { "type": "string", "example": "ethereum" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetLendingMarketsResponse" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "marketId": "aave_aave-v3_arbitrum_0x794a61358d6845594f94dc1db02a252b5b4814ad", "marketName": "arbitrum-core", "productSlug": "aave-v3", "chain": "arbitrum", "protocol": { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave" } }, { "marketId": "aave_aave-v3_avalanche_c_0x794a61358d6845594f94dc1db02a252b5b4814ad", "marketName": "avalanche_c-core", "productSlug": "aave-v3", "chain": "avalanche_c", "protocol": { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave" } }, { "marketId": "aave_aave-v2_avalanche_c_avalanche_c-v2", "marketName": "avalanche_c-v2", "productSlug": "aave-v2", "chain": "avalanche_c", "protocol": { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave" } }, { "marketId": "aave_aave-v3_base_0xa238dd80c259a72e81d7e4664a9801593f98d1c5", "marketName": "base-core", "productSlug": "aave-v3", "chain": "base", "protocol": { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave" } }, { "marketId": "aave_aave-v3_bnb_0x6807dc923806fe8fd134338eabca509979a7e0cb", "marketName": "bnb-core", "productSlug": "aave-v3", "chain": "bnb", "protocol": { "id": "675b85dc-85a1-4096-9600-212e90a56e9a", "name": "Aave", "slug": "aave" } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 23, "totalPages": 3 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List lending markets", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/lending-markets/metrics": { "get": { "description": "Returns the timeseries metrics available for the lending-markets dataset. The market grain deliberately carries fewer metrics than the protocol and instance grains.", "operationId": "getLendingMarketsMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "lending-markets", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Deposits (USD)", "slug": "depositsUsd", "description": "Total deposits (supply and collateral) in USD across the market's tokens. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Borrowed (USD)", "slug": "borrowedUsd", "description": "Total outstanding borrows in USD across the market's tokens. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "TVL (USD)", "slug": "tvl24HourUsd", "description": "TVL in USD, deposits minus borrows. Sourced from Blockworks Research.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List lending market metrics", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/lending-markets/time-series/{granularity}": { "get": { "description": "Returns one timeseries per market of a lending protocol, where a market is an individual pool (for example a USDC pool of aave-v3 on ethereum). Each series carries its own marketName, productSlug and chain. A protocol that Blockworks Research does not map returns 200 with an empty series list; an unknown identifier returns 404. The response caps at 250 series, above which a 400 names the product and chain filters that narrow it.", "operationId": "getLendingMarketsTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "aave", "default": "aave" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } }, { "description": "Filter to a Blockworks Research product slug", "in": "query", "name": "product", "schema": { "type": "string", "example": "aave-v3" } }, { "description": "Filter to a Blockworks Research chain slug", "in": "query", "name": "chain", "schema": { "type": "string", "example": "ethereum" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/LendingSeriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/LendingSeriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "series": [ { "id": "aave_aave-v2_avalanche_c_avalanche_c-v2", "productSlug": "aave-v2", "chain": "avalanche_c", "marketName": "avalanche_c-v2", "points": [ [ 1748736000, 23510950.643165242, 2376072.6093996367, 21134878.033765607 ], [ 1748822400, 23523794.091174293, 2376248.4934064513, 21147545.59776784 ], [ 1748908800, 23788075.803780608, 2383901.4966985104, 21404174.307082098 ], [ 1748995200, 23724622.839787386, 2380605.459132212, 21344017.380655173 ], [ 1749081600, 23382182.466817264, 2368096.8816541755, 21014085.585163087 ] ] }, { "id": "aave_aave-v2_ethereum_ethereum-v2", "productSlug": "aave-v2", "chain": "ethereum", "marketName": "ethereum-v2", "points": [ [ 1748736000, 9551.686342817173, 51.80130061469237, 9499.88504220248 ], [ 1748822400, 9606.47023431713, 52.09840802908795, 9554.371826288043 ], [ 1748908800, 9994.038037074974, 54.20028988938714, 9939.837747185586 ], [ 1748995200, 9947.98670475451, 53.95054143412789, 9894.036163320383 ], [ 1749081600, 9539.681600128959, 51.73619574603619, 9487.945404382923 ] ] }, { "id": "aave_aave-v2_polygon_polygon-v2", "productSlug": "aave-v2", "chain": "polygon", "marketName": "polygon-v2", "points": [ [ 1748736000, 38569752.82721896, 3794864.6926278803, 34774888.13459108 ], [ 1748822400, 38621212.89304876, 3796818.0100005027, 34824394.88304826 ], [ 1748908800, 39331042.423220664, 3827882.368949122, 35503160.05427154 ], [ 1748995200, 39305813.58849489, 3828104.5682649044, 35477709.02022999 ], [ 1749081600, 38770014.97071412, 3801301.6189646525, 34968713.35174947 ] ] }, { "id": "aave_aave-v3_arbitrum_0x794a61358d6845594f94dc1db02a252b5b4814ad", "productSlug": "aave-v3", "chain": "arbitrum", "marketName": "arbitrum-core", "points": [ [ 1748736000, 1392810041.7209342, 540777750.2162962, 852032291.504638 ], [ 1748822400, 1379438050.8468657, 534573903.878233, 844864146.9686327 ], [ 1748908800, 1417208445.081294, 545077998.9018449, 872130446.1794492 ], [ 1748995200, 1408689076.4192958, 542510458.7211453, 866178617.6981505 ], [ 1749081600, 1378255015.016849, 529904072.8153599, 848350942.2014892 ] ] }, { "id": "aave_aave-v3_avalanche_c_0x794a61358d6845594f94dc1db02a252b5b4814ad", "productSlug": "aave-v3", "chain": "avalanche_c", "marketName": "avalanche_c-core", "points": [ [ 1748736000, 1057401488.071581, 356742939.47328234, 700658548.5982987 ], [ 1748822400, 1066133677.6930491, 363787851.34041595, 702345826.3526331 ], [ 1748908800, 1081216165.9432366, 369133810.77200663, 712082355.17123 ], [ 1748995200, 1079830349.4492314, 369258960.8018748, 710571388.6473565 ], [ 1749081600, 1060196353.3508334, 362117295.15095633, 698079058.199877 ] ] } ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Deposits (USD)", "slug": "depositsUsd", "description": "Total deposits (supply and collateral) in USD across the market's tokens. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Borrowed (USD)", "slug": "borrowedUsd", "description": "Total outstanding borrows in USD across the market's tokens. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "TVL (USD)", "slug": "tvl24HourUsd", "description": "TVL in USD, deposits minus borrows. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d", "seriesCount": 23 } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get lending markets timeseries", "tags": [ "metrics/protocols/lending" ] } }, "/metrics/v2/protocols/interop": { "get": { "description": "Returns a complete list of all available interoperability (bridging) protocols supported by Messari, along with metrics. Protocol data represents an aggregation across all chain deployments.", "operationId": "getInteropProtocolsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "f8c4483b-ce35-4911-85ed-dd3e0acbe168", "name": "Across", "slug": "across", "activity": { "tvl24HourUsd": 17962588.25749314, "activeAddresses24Hour": 4062, "fees24HourUsd": 1586.7809263242157 }, "interop": { "feesSupplySide24HourUsd": 1586.7809263242157, "expenses24HourUsd": 5.614884822765095, "treasuryUsd": 10768067.89101094, "transferVolume24HourUsd": 22684158.057731938, "transactionCount24Hour": null, "coreDevelopers": 16, "codeCommits": 2 } }, { "id": "4f989070-a487-49dd-a9bb-0a02e49bde9d", "name": "Synapse", "slug": "synapse", "activity": { "tvl24HourUsd": 9339601.74312462, "activeAddresses24Hour": 4, "fees24HourUsd": 0 }, "interop": { "feesSupplySide24HourUsd": 0, "expenses24HourUsd": 5.75160455987214, "treasuryUsd": null, "transferVolume24HourUsd": 0.3999306009662249, "transactionCount24Hour": null, "coreDevelopers": 0, "codeCommits": 0 } }, { "id": "1226ed3e-631a-4eaf-ac40-3e528b2435ef", "name": "Ren", "slug": "ren-3", "activity": { "tvl24HourUsd": null, "activeAddresses24Hour": 12, "fees24HourUsd": 0 }, "interop": { "feesSupplySide24HourUsd": 0, "expenses24HourUsd": 0, "treasuryUsd": null, "transferVolume24HourUsd": 0, "transactionCount24Hour": null, "coreDevelopers": 0, "codeCommits": 0 } }, { "id": "2484e536-2a6f-4981-9fa6-64a9fb268c2f", "name": "Gravity", "slug": "g-token", "activity": { "tvl24HourUsd": null, "activeAddresses24Hour": 686, "fees24HourUsd": 1.4322405200351236 }, "interop": { "feesSupplySide24HourUsd": 0, "expenses24HourUsd": 0, "treasuryUsd": null, "transferVolume24HourUsd": null, "transactionCount24Hour": 6567, "coreDevelopers": 6, "codeCommits": 0 } }, { "id": "26c5a44d-cd59-4cfc-8568-bb24c15061c5", "name": "Hyperbridge", "slug": "hyperbridge", "activity": { "tvl24HourUsd": null, "activeAddresses24Hour": 2897, "fees24HourUsd": 6.9662e-14 }, "interop": { "feesSupplySide24HourUsd": 6.9662e-14, "expenses24HourUsd": 0, "treasuryUsd": null, "transferVolume24HourUsd": 0, "transactionCount24Hour": 69888, "coreDevelopers": null, "codeCommits": null } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 10, "totalPages": 1 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List interoperability protocols", "tags": [ "metrics/protocols/interop" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: tvl_usd)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "tvl_usd", "active_addresses", "fees_usd", "fees_supply_side_usd", "expenses_usd", "dex_volume_usd", "borrowed_usd", "treasury_usd" ], "default": "tvl_usd" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/protocols/interop/metrics": { "get": { "description": "Returns a list of timeseries metrics available for interoperability protocols", "operationId": "getInteropMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "interop", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Transfer Volume USD", "slug": "transferVolumeUsd", "description": "Total transfer volume in USD for interoperability protocols.", "is_timestamp": false }, { "name": "Transaction Count 24 Hour", "slug": "transactionCount24Hour", "description": "Number of transactions for interoperability protocols.", "is_timestamp": false }, { "name": "Core Developers", "slug": "coreDevelopers", "description": "Number of active core developers.", "is_timestamp": false }, { "name": "Core Commits 24 Hour", "slug": "coreCommits24Hour", "description": "Number of code commits.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List interoperability metrics", "tags": [ "metrics/protocols/interop" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/interop/time-series/{granularity}": { "get": { "description": "Returns a timeseries metric for a specific interoperability protocol. Protocol data represents an aggregation of all deployments across all chains.", "operationId": "getInteropTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "layerzero", "default": "layerzero" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, null, 3533, 9614.985348783908, 9614.985348783908, 0, null, 84167188.69139333, null, null, null ], [ 1748822400, null, 4468, 17598.827342636912, 17598.827342636912, 0, null, 170106726.18246555, null, null, null ], [ 1748908800, null, 4838, 17892.19034872127, 17892.19034872127, 0, null, 163091603.8792969, null, null, null ], [ 1748995200, null, 4932, 16498.32671597795, 16498.32671597795, 0, null, 166279508.40912437, null, null, null ], [ 1749081600, null, 4736, 20335.37994910295, 20335.37994910295, 0, null, 237794293.38489774, null, null, null ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Transfer Volume USD", "slug": "transferVolumeUsd", "description": "Total transfer volume in USD for interoperability protocols.", "is_timestamp": false }, { "name": "Transaction Count 24 Hour", "slug": "transactionCount24Hour", "description": "Number of transactions for interoperability protocols.", "is_timestamp": false }, { "name": "Core Developers", "slug": "coreDevelopers", "description": "Number of active core developers.", "is_timestamp": false }, { "name": "Core Commits 24 Hour", "slug": "coreCommits24Hour", "description": "Number of code commits.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get interoperability timeseries metric", "tags": [ "metrics/protocols/interop" ] } }, "/metrics/v2/protocols/liquid-staking": { "get": { "description": "Returns a complete list of all available liquid staking protocols supported by Messari, along with metrics. Protocol data represents an aggregation across all chain deployments.", "operationId": "getLiquidStakingProtocolsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "3ee3418e-ab75-475c-b153-aeba3752478e", "name": "Lido DAO", "slug": "lido-dao", "activity": { "tvl24HourUsd": 23568580401.07076, "activeAddresses24Hour": 1083, "fees24HourUsd": 1970337.5536137987 }, "liquidStaking": { "feesSupplySide24HourUsd": 1773303.7982524189, "tokenIncentives24HourUsd": 0, "expenses24HourUsd": 49870.89000088661, "treasuryUsd": 114959997.67423151, "costOfRevenue": 49870.89000088661, "grossProfit24HourUsd": 147162.86536049328, "treasuryNetUsd": 68956729.45379876, "assetsStaked": 23551908400.89418, "coreDevelopers": 45, "codeCommits": 0 } }, { "id": "ccd26836-a02e-450f-8602-3f3c84f6a4c2", "name": "StakeWise", "slug": "stakewise", "activity": { "tvl24HourUsd": 926067679.685865, "activeAddresses24Hour": 82, "fees24HourUsd": 30965.633712057064 }, "liquidStaking": { "feesSupplySide24HourUsd": 29417.35202645421, "tokenIncentives24HourUsd": 0, "expenses24HourUsd": 0, "treasuryUsd": null, "costOfRevenue": null, "grossProfit24HourUsd": 1548.2816856028533, "treasuryNetUsd": null, "assetsStaked": 926067679.685865, "coreDevelopers": 6, "codeCommits": 0 } }, { "id": "24bc547e-1ac9-44e1-a949-532cfd170d3c", "name": "Marinade Finance", "slug": "marinade-finance", "activity": { "tvl24HourUsd": 590334022.9365058, "activeAddresses24Hour": 45, "fees24HourUsd": 169529.40157529496 }, "liquidStaking": { "feesSupplySide24HourUsd": 147662.65802144507, "tokenIncentives24HourUsd": null, "expenses24HourUsd": null, "treasuryUsd": null, "costOfRevenue": null, "grossProfit24HourUsd": null, "treasuryNetUsd": null, "assetsStaked": 584633024.7342511, "coreDevelopers": 9, "codeCommits": 1 } }, { "id": "9c3a0182-30c7-4210-9d00-ee5c26abdb26", "name": "Stader", "slug": "stader", "activity": { "tvl24HourUsd": 200253668.56597793, "activeAddresses24Hour": 22, "fees24HourUsd": 0 }, "liquidStaking": { "feesSupplySide24HourUsd": 0, "tokenIncentives24HourUsd": null, "expenses24HourUsd": null, "treasuryUsd": null, "costOfRevenue": null, "grossProfit24HourUsd": null, "treasuryNetUsd": null, "assetsStaked": 200253668.56597793, "coreDevelopers": 0, "codeCommits": 0 } }, { "id": "0f4ab6f6-7461-42bc-b20a-3767dd5e9d3f", "name": "Origin Protocol", "slug": "origin-protocol", "activity": { "tvl24HourUsd": 137470479.87186158, "activeAddresses24Hour": 98, "fees24HourUsd": 8142.2097926319375 }, "liquidStaking": { "feesSupplySide24HourUsd": 1468.1565474588435, "tokenIncentives24HourUsd": 0, "expenses24HourUsd": 0, "treasuryUsd": 359.8983293956518, "costOfRevenue": null, "grossProfit24HourUsd": 1859.4206352113488, "treasuryNetUsd": 359.8983293956518, "assetsStaked": null, "coreDevelopers": 6, "codeCommits": 0 } } ], "metadata": { "pageSize": 10, "page": 1, "totalRows": 6, "totalPages": 1 } } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List liquid staking protocols", "tags": [ "metrics/protocols/liquid-staking" ], "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "format": "int64", "type": "integer", "example": 1, "default": 1 } }, { "description": "Number of results per page", "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer", "example": 10, "default": 10 } }, { "description": "Column to sort by (default: tvl_usd)", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "tvl_usd", "active_addresses", "fees_usd", "fees_supply_side_usd", "expenses_usd", "dex_volume_usd", "borrowed_usd", "treasury_usd" ], "default": "tvl_usd" } }, { "description": "Sort direction: asc or desc (default: desc)", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } } ] } }, "/metrics/v2/protocols/liquid-staking/metrics": { "get": { "description": "Returns a list of timeseries metrics available for liquid staking protocols", "operationId": "getLiquidStakingMetricsV2", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "liquid-staking", "granularities": [ "1d", "1w" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Cost of Revenue", "slug": "costOfRevenue", "description": "Cost of revenue in USD for liquid staking protocols.", "is_timestamp": false }, { "name": "Gross Profit 24 Hour USD", "slug": "grossProfit24HourUsd", "description": "Gross profit in USD for liquid staking protocols.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Treasury Net USD", "slug": "treasuryNetUsd", "description": "Net treasury value in USD.", "is_timestamp": false }, { "name": "Assets Staked", "slug": "assetsStaked", "description": "Value of assets staked in USD for liquid staking protocols.", "is_timestamp": false }, { "name": "Core Developers", "slug": "coreDevelopers", "description": "Number of active core developers.", "is_timestamp": false }, { "name": "Core Commits 24 Hour", "slug": "coreCommits24Hour", "description": "Number of code commits.", "is_timestamp": false } ] } ] } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "List liquid staking metrics", "tags": [ "metrics/protocols/liquid-staking" ] } }, "/metrics/v2/protocols/{protocolIdentifier}/metrics/liquid-staking/time-series/{granularity}": { "get": { "description": "Returns a timeseries metric for a specific liquid staking protocol. Protocol data represents an aggregation of all deployments across all chains.", "operationId": "getLiquidStakingTimeseriesV2", "parameters": [ { "description": "Protocol identifier (ID or slug)", "in": "path", "name": "protocolIdentifier", "required": true, "schema": { "type": "string", "example": "lido-dao", "default": "lido-dao" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2025-06-01T00:00:00Z", "default": "2025-06-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2025-06-07T00:00:00Z", "default": "2025-06-07T00:00:00Z" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1748736000, 22762012444.154636, 1330, 1836118.0875550655, 1652506.2787995592, 0, 89393.81408341261, 89393.81408341261, 94217.99467209398, 189263554.3218315, 101267436.5173278, 22762012444.154636, 48, 2 ], [ 1748822400, 23364641256.82638, 1084, 1902879.8650966976, 1712591.8785870278, 0, 92644.1986691784, 92644.1986691784, 97643.78784049134, 192675777.78574905, 103183946.53774177, 23364641256.82638, 48, 28 ], [ 1748908800, 23247834030.204742, 1272, 1926332.3713444616, 1733699.1342100156, 0, 93786.01465449686, 93786.01465449686, 98847.22247994933, 189980716.94736183, 102936612.5479238, 23247834030.204742, 48, 29 ], [ 1748995200, 23410632407.39561, 1258, 1952869.987162179, 1757582.9884459611, 0, 95078.03324017776, 95078.03324017776, 100208.96547604012, 195239903.03745604, 103404875.96572185, 23410632407.39561, 48, 49 ], [ 1749081600, 21675847946.298466, 1236, 1787682.0781981768, 1608913.870378359, 0, 87035.64352524455, 87035.64352524455, 91732.56429457312, 177446730.74842316, 98376030.79928784, 21675847946.298466, 50, 73 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "TVL 24 Hour USD", "slug": "tvl24HourUsd", "description": "Total Value Locked in USD.", "is_timestamp": false }, { "name": "Active Addresses 24 Hour", "slug": "activeAddresses24Hour", "description": "Number of unique addresses interacting with the protocol.", "is_timestamp": false }, { "name": "Fees 24 Hour USD", "slug": "fees24HourUsd", "description": "Total fees generated by the protocol in USD.", "is_timestamp": false }, { "name": "Fees Supply Side 24 Hour USD", "slug": "feesSupplySide24HourUsd", "description": "Fees paid to liquidity providers in USD.", "is_timestamp": false }, { "name": "Token Incentives 24 Hour USD", "slug": "tokenIncentives24HourUsd", "description": "Value of token incentives distributed by the protocol.", "is_timestamp": false }, { "name": "Expenses 24 Hour USD", "slug": "expenses24HourUsd", "description": "Total expenses incurred by the protocol in USD.", "is_timestamp": false }, { "name": "Cost of Revenue", "slug": "costOfRevenue", "description": "Cost of revenue in USD for liquid staking protocols.", "is_timestamp": false }, { "name": "Gross Profit 24 Hour USD", "slug": "grossProfit24HourUsd", "description": "Gross profit in USD for liquid staking protocols.", "is_timestamp": false }, { "name": "Treasury USD", "slug": "treasuryUsd", "description": "Value of assets held in the protocol treasury in USD.", "is_timestamp": false }, { "name": "Treasury Net USD", "slug": "treasuryNetUsd", "description": "Net treasury value in USD.", "is_timestamp": false }, { "name": "Assets Staked", "slug": "assetsStaked", "description": "Value of assets staked in USD for liquid staking protocols.", "is_timestamp": false }, { "name": "Core Developers", "slug": "coreDevelopers", "description": "Number of active core developers.", "is_timestamp": false }, { "name": "Core Commits 24 Hour", "slug": "coreCommits24Hour", "description": "Number of code commits.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "Default response" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } }, "security": [ { "apiKey": [] } ], "summary": "Get liquid staking timeseries metric", "tags": [ "metrics/protocols/liquid-staking" ] } }, "/metrics/v2/protocols/dats": { "get": { "description": "Returns one row per digital asset treasury (DAT) company, each with the assets it holds and its latest treasury values. A DAT is a public company holding crypto on its balance sheet, and its id is its stock ticker (for example MSTR). The holdings summary lists which assets the company holds, so you can see the by-asset coverage before calling the holdings endpoints. Latest values are read from the most recent point in the last 30 days; a company that reported nothing in that window returns nulls and a null asOfTime.", "operationId": "getDATs", "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "type": "integer", "format": "int64", "example": 1, "default": 1 } }, { "description": "Page size limit", "in": "query", "name": "limit", "schema": { "type": "integer", "format": "int64", "example": 100, "default": 100 } }, { "description": "Column to sort by", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "id", "market-cap", "nav", "enterprise-value", "fully-diluted-valuation", "outstanding-mnav", "price", "volume-usd" ], "example": "market-cap", "default": "market-cap" } }, { "description": "Sort direction", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "example": "desc", "default": "desc" } }, { "description": "Match against ticker, name or slug. Case-insensitive.", "in": "query", "name": "search", "schema": { "type": "string", "example": "strategy" } }, { "description": "Only companies holding this asset, by ticker symbol (for example btc). Case-insensitive.", "in": "query", "name": "assetSymbol", "schema": { "type": "string", "example": "btc" } } ], "security": [ { "apiKey": [] } ], "summary": "List DATs", "tags": [ "metrics/protocols/dats" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetDATsResponse" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "MSTR", "name": "Strategy", "slug": "micro-strategy", "projectId": "86eb6499-1feb-46c1-8d28-31a46defbe41", "asOfTime": 1787270400, "holdings": { "assetSymbols": [ "btc" ], "count": 1 }, "treasury": { "price": 119.881, "volumeUsd": 5558195938.4706745, "outstandingShares": 398417522, "marketCap": 47762690954.882, "enterpriseValue": 64087573973.532005, "fullyDilutedShares": 401295000, "fullyDilutedValuation": 48107645895, "fullyDilutedEnterpriseValue": 64432528913.65, "cash": 2550000000, "debt": 6770777000, "preferredMarketCap": 12104106018.65, "nav": 61434612466.19795, "outstandingMnav": 0.7774557214170041, "fullyDilutedMnav": 0.7830707147614774, "outstandingEvMnav": 1.0431834986961745, "fullyDilutedEvMnav": 1.048798492040648 } }, { "id": "BMNR", "name": "BitMine", "slug": "bitmine", "projectId": "380a2cf4-1237-4ae4-80b2-747423edbb18", "asOfTime": 1787270400, "holdings": { "assetSymbols": [ "btc", "eth" ], "count": 2 }, "treasury": { "price": 22.6922, "volumeUsd": 1350045438.3081183, "outstandingShares": 603226394, "marketCap": 13688533977.9268, "enterpriseValue": 13134749977.9268, "fullyDilutedShares": 606333508, "fullyDilutedValuation": 13759041230.2376, "fullyDilutedEnterpriseValue": 13205257230.2376, "cash": 555000000, "debt": 1216000, "preferredMarketCap": null, "nav": 13545556338.759651, "outstandingMnav": 1.0105553168575312, "fullyDilutedMnav": 1.0157605111328707, "outstandingEvMnav": 0.969672241541135, "fullyDilutedEvMnav": 0.9748774358164745 } } ], "metadata": { "pageSize": 100, "page": 1, "totalRows": 43, "totalPages": 1 } } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/dats/metrics": { "get": { "description": "Returns the metric catalog for both digital asset treasury datasets in one response: treasury, at the company grain, and holdings, one series per company and held asset. Use the metric slugs here to read the point arrays the DAT time series endpoints return.", "operationId": "getDATsTimeseriesCatalog", "parameters": [], "security": [ { "apiKey": [] } ], "summary": "List DAT Metrics", "tags": [ "metrics/protocols/dats" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "holdings", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "AUM (Native)", "slug": "aumNative", "description": "Company's holdings of this asset in native units.", "is_timestamp": false }, { "name": "AUM (USD)", "slug": "aumUsd", "description": "Company's holdings of this asset in USD.", "is_timestamp": false }, { "name": "Purchases (Native)", "slug": "purchasesNative", "description": "Units of this asset purchased that day.", "is_timestamp": false } ] }, { "slug": "treasury", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Stock Price (USD)", "slug": "price", "description": "Latest stock price in USD.", "is_timestamp": false }, { "name": "Volume (USD)", "slug": "volumeUsd", "description": "Dollar trading volume.", "is_timestamp": false }, { "name": "Outstanding Shares", "slug": "outstandingShares", "description": "Shares currently issued and held by investors.", "is_timestamp": false }, { "name": "Market Cap (USD)", "slug": "marketCap", "description": "Stock price times outstanding shares in USD.", "is_timestamp": false }, { "name": "Enterprise Value (USD)", "slug": "enterpriseValue", "description": "Market cap plus debt minus cash in USD.", "is_timestamp": false }, { "name": "Fully Diluted Shares", "slug": "fullyDilutedShares", "description": "All shares if options, warrants and convertibles are exercised.", "is_timestamp": false }, { "name": "Fully Diluted Valuation (USD)", "slug": "fullyDilutedValuation", "description": "Stock price times fully diluted shares in USD.", "is_timestamp": false }, { "name": "Fully Diluted Enterprise Value (USD)", "slug": "fullyDilutedEnterpriseValue", "description": "Enterprise value on a fully diluted share basis in USD.", "is_timestamp": false }, { "name": "Cash (USD)", "slug": "cash", "description": "Cash and equivalents on the balance sheet in USD.", "is_timestamp": false }, { "name": "Debt (USD)", "slug": "debt", "description": "Total debt on the balance sheet in USD.", "is_timestamp": false }, { "name": "Preferred Market Cap (USD)", "slug": "preferredMarketCap", "description": "Market value of preferred stock in USD.", "is_timestamp": false }, { "name": "NAV (USD)", "slug": "nav", "description": "Net asset value - crypto holdings at market value, net of liabilities, in USD.", "is_timestamp": false }, { "name": "Outstanding mNAV", "slug": "outstandingMnav", "description": "Market cap divided by NAV - premium or discount to crypto NAV on outstanding shares.", "is_timestamp": false }, { "name": "Fully Diluted mNAV", "slug": "fullyDilutedMnav", "description": "Fully diluted valuation divided by NAV.", "is_timestamp": false }, { "name": "Outstanding EV mNAV", "slug": "outstandingEvMnav", "description": "Enterprise value divided by NAV on outstanding shares.", "is_timestamp": false }, { "name": "Fully Diluted EV mNAV", "slug": "fullyDilutedEvMnav", "description": "Fully diluted enterprise value divided by NAV.", "is_timestamp": false } ] } ] } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/dats/{datIdentifier}/metrics/treasury/time-series/{granularity}": { "get": { "description": "Returns one company's capital structure history: share counts, market cap, enterprise value, cash, debt, NAV and the four mNAV variants. The identifier is the company's stock ticker (MSTR) or its Messari project slug. Only the 1d granularity is available for this dataset.", "operationId": "getDATTreasuryTimeseries", "parameters": [ { "description": "Company stock ticker (MSTR) or Messari project slug (micro-strategy). Case-sensitive: a ticker is upper-case and a slug is lower-case, so mstr does not resolve.", "in": "path", "name": "datIdentifier", "required": true, "schema": { "type": "string", "example": "MSTR" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get DAT Treasury Time Series", "tags": [ "metrics/protocols/dats" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1785715200, 94.6276, 1314808853.696448, 388372974, 36750802434.4824, 52404433006.7724, 401295000, 37973582742, 53627213314.29, 2550000000, 6770777000, 11432853572.289999, 53447462891.35466, 0.6876061172293173, 0.7104842903243286, 0.9804849504886232, 1.0033631235836344 ], [ 1785801600, 96.3525, 1466558873.7327795, 388372974, 37420706977.335, 53127524238.115, 401295000, 38665776487.5, 54372593748.28, 2550000000, 6770777000, 11486040260.78, 53452819103.028946, 0.7000698486118673, 0.7233627175579402, 0.9939143553067435, 1.0172072242528165 ], [ 1785888000, 97.8714, 1340405520.083278, 388372974, 38010606687.543594, 53914076786.5936, 401295000, 39275303463, 55178773562.05, 2550000000, 6770777000, 11682693099.05, 53929956131.069305, 0.7048143446503844, 0.7282650734509556, 0.9997055561395763, 1.0231562849401474 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Stock Price (USD)", "slug": "price", "description": "Latest stock price in USD.", "is_timestamp": false }, { "name": "Volume (USD)", "slug": "volumeUsd", "description": "Dollar trading volume.", "is_timestamp": false }, { "name": "Outstanding Shares", "slug": "outstandingShares", "description": "Shares currently issued and held by investors.", "is_timestamp": false }, { "name": "Market Cap (USD)", "slug": "marketCap", "description": "Stock price times outstanding shares in USD.", "is_timestamp": false }, { "name": "Enterprise Value (USD)", "slug": "enterpriseValue", "description": "Market cap plus debt minus cash in USD.", "is_timestamp": false }, { "name": "Fully Diluted Shares", "slug": "fullyDilutedShares", "description": "All shares if options, warrants and convertibles are exercised.", "is_timestamp": false }, { "name": "Fully Diluted Valuation (USD)", "slug": "fullyDilutedValuation", "description": "Stock price times fully diluted shares in USD.", "is_timestamp": false }, { "name": "Fully Diluted Enterprise Value (USD)", "slug": "fullyDilutedEnterpriseValue", "description": "Enterprise value on a fully diluted share basis in USD.", "is_timestamp": false }, { "name": "Cash (USD)", "slug": "cash", "description": "Cash and equivalents on the balance sheet in USD.", "is_timestamp": false }, { "name": "Debt (USD)", "slug": "debt", "description": "Total debt on the balance sheet in USD.", "is_timestamp": false }, { "name": "Preferred Market Cap (USD)", "slug": "preferredMarketCap", "description": "Market value of preferred stock in USD.", "is_timestamp": false }, { "name": "NAV (USD)", "slug": "nav", "description": "Net asset value - crypto holdings at market value, net of liabilities, in USD.", "is_timestamp": false }, { "name": "Outstanding mNAV", "slug": "outstandingMnav", "description": "Market cap divided by NAV - premium or discount to crypto NAV on outstanding shares.", "is_timestamp": false }, { "name": "Fully Diluted mNAV", "slug": "fullyDilutedMnav", "description": "Fully diluted valuation divided by NAV.", "is_timestamp": false }, { "name": "Outstanding EV mNAV", "slug": "outstandingEvMnav", "description": "Enterprise value divided by NAV on outstanding shares.", "is_timestamp": false }, { "name": "Fully Diluted EV mNAV", "slug": "fullyDilutedEvMnav", "description": "Fully diluted enterprise value divided by NAV.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/dats/time-series/{granularity}": { "get": { "description": "Returns one treasury time series per digital asset treasury company, for every company the DAT listing serves, in a single response. Use this instead of calling the per-company treasury endpoint once for each company. Every metric and the full history are returned by default; narrow start and end to limit the response size. A company with no data in the window is still present, with an empty points array.", "operationId": "getAllDATsTimeseries", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get All DATs Time Series", "tags": [ "metrics/protocols/dats" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DATTimeseriesEntry" } }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "dat": { "id": "AGRI", "name": "AVAX One", "slug": "" }, "points": [] }, { "dat": { "id": "BNC", "name": "BNB Network Company", "slug": "bnb-network-company", "projectId": "cd2462c7-0f11-4354-9413-17c865c76b92" }, "points": [ [ 1787011200, 2.5231, 322404.53655501, 41173850, 103885740.935, 55638740.935, 98429348, 248347087.93879998, 200100087.93879998, 50000000, 1753000, null, 311753413.5113964, 0.3332304841986995, 0.796613853049989, 0.17847035035902206, 0.6418537192103115 ], [ 1787097600, 2.5819, 521772.467367726, 41173850, 106306763.315, 58059763.315, 98429348, 254134733.6012, 205887733.6012, 50000000, 1753000, null, 310582276.2861007, 0.34228213079703507, 0.818252530827282, 0.18693843064475701, 0.662908830675004 ], [ 1787184000, 2.7419, 1016178.1409923919, 41173850, 112894579.315, 64647579.315, 98429348, 269883429.2812, 221636429.2812, 50000000, 1753000, null, 323376657.4291549, 0.3491117145328675, 0.8345791914196091, 0.1999141800430136, 0.6853816569297552 ], [ 1787270400, 2.9575, 2262979.13535148, 41173850, 121771661.375, 73524661.375, 98429348, 291104796.71, 242857796.70999998, 50000000, 1753000, null, 336972157.7417888, 0.3613700971351758, 0.8638838254793277, 0.21819209595155822, 0.7207058242957102 ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Stock Price (USD)", "slug": "price", "description": "Latest stock price in USD.", "is_timestamp": false }, { "name": "Volume (USD)", "slug": "volumeUsd", "description": "Dollar trading volume.", "is_timestamp": false }, { "name": "Outstanding Shares", "slug": "outstandingShares", "description": "Shares currently issued and held by investors.", "is_timestamp": false }, { "name": "Market Cap (USD)", "slug": "marketCap", "description": "Stock price times outstanding shares in USD.", "is_timestamp": false }, { "name": "Enterprise Value (USD)", "slug": "enterpriseValue", "description": "Market cap plus debt minus cash in USD.", "is_timestamp": false }, { "name": "Fully Diluted Shares", "slug": "fullyDilutedShares", "description": "All shares if options, warrants and convertibles are exercised.", "is_timestamp": false }, { "name": "Fully Diluted Valuation (USD)", "slug": "fullyDilutedValuation", "description": "Stock price times fully diluted shares in USD.", "is_timestamp": false }, { "name": "Fully Diluted Enterprise Value (USD)", "slug": "fullyDilutedEnterpriseValue", "description": "Enterprise value on a fully diluted share basis in USD.", "is_timestamp": false }, { "name": "Cash (USD)", "slug": "cash", "description": "Cash and equivalents on the balance sheet in USD.", "is_timestamp": false }, { "name": "Debt (USD)", "slug": "debt", "description": "Total debt on the balance sheet in USD.", "is_timestamp": false }, { "name": "Preferred Market Cap (USD)", "slug": "preferredMarketCap", "description": "Market value of preferred stock in USD.", "is_timestamp": false }, { "name": "NAV (USD)", "slug": "nav", "description": "Net asset value - crypto holdings at market value, net of liabilities, in USD.", "is_timestamp": false }, { "name": "Outstanding mNAV", "slug": "outstandingMnav", "description": "Market cap divided by NAV - premium or discount to crypto NAV on outstanding shares.", "is_timestamp": false }, { "name": "Fully Diluted mNAV", "slug": "fullyDilutedMnav", "description": "Fully diluted valuation divided by NAV.", "is_timestamp": false }, { "name": "Outstanding EV mNAV", "slug": "outstandingEvMnav", "description": "Enterprise value divided by NAV on outstanding shares.", "is_timestamp": false }, { "name": "Fully Diluted EV mNAV", "slug": "fullyDilutedEvMnav", "description": "Fully diluted enterprise value divided by NAV.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/dats/{datIdentifier}/metrics/holdings/time-series/{granularity}": { "get": { "description": "Returns one company's crypto holdings history, one time series per asset it holds, tracking units held, USD value and daily purchases. A company holding three assets returns three series. Each series carries its own assetSymbol, so you do not have to parse the composite series id. Only the 1d granularity is available for this dataset.", "operationId": "getDATHoldingsTimeseries", "parameters": [ { "description": "Company stock ticker (MSTR) or Messari project slug (micro-strategy). Case-sensitive: a ticker is upper-case and a slug is lower-case, so mstr does not resolve.", "in": "path", "name": "datIdentifier", "required": true, "schema": { "type": "string", "example": "MSTR" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get DAT Holdings Time Series", "tags": [ "metrics/protocols/dats" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DATHoldingTimeseriesEntry" } }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "holding": { "id": "MSTR_btc", "name": "Strategy BTC", "companyTicker": "MSTR", "assetSymbol": "btc", "networkSlug": "bitcoin" }, "points": [ [ 1787011200, 840447, 54171331002.35294, 0 ], [ 1787097600, 840447, 54347026149.71165, 0 ], [ 1787184000, 840447, 58342517955.511665, 0 ], [ 1787270400, 840447, 61434612466.19795, 0 ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "AUM (Native)", "slug": "aumNative", "description": "Company's holdings of this asset in native units.", "is_timestamp": false }, { "name": "AUM (USD)", "slug": "aumUsd", "description": "Company's holdings of this asset in USD.", "is_timestamp": false }, { "name": "Purchases (Native)", "slug": "purchasesNative", "description": "Units of this asset purchased that day.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/dats/holdings/time-series/{granularity}": { "get": { "description": "Returns every company's crypto holdings history in a single response: every digital asset treasury company, every asset it holds, over the window. Use this instead of calling the per-company holdings endpoint once for each company. Every metric and the full history are returned by default; narrow start and end to limit the response size.", "operationId": "getAllDATHoldingsTimeseries", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get All DAT Holdings Time Series", "tags": [ "metrics/protocols/dats" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DATHoldingTimeseriesEntry" } }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "holding": { "id": "BNC_bnb", "name": "BNB Network Company BNB", "companyTicker": "BNC", "assetSymbol": "bnb", "networkSlug": "binance-smart-chain" }, "points": [ [ 1787011200, 515054, 311753413.5113964, 0 ], [ 1787097600, 515054, 310582276.2861007, 0 ], [ 1787184000, 515054, 323376657.4291549, 0 ], [ 1787270400, 515054, 336972157.7417888, 0 ] ] }, { "holding": { "id": "BTCS_eth", "name": "BTCS ETH", "companyTicker": "BTCS", "assetSymbol": "eth", "networkSlug": "ethereum" }, "points": [ [ 1787011200, 70028, 133850191.48017864, 0 ], [ 1787097600, 70028, 134090002.55267532, 0 ], [ 1787184000, 70028, 157811980.74823716, 0 ], [ 1787270400, 70028, 162934915.60418308, 0 ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "AUM (Native)", "slug": "aumNative", "description": "Company's holdings of this asset in native units.", "is_timestamp": false }, { "name": "AUM (USD)", "slug": "aumUsd", "description": "Company's holdings of this asset in USD.", "is_timestamp": false }, { "name": "Purchases (Native)", "slug": "purchasesNative", "description": "Units of this asset purchased that day.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs": { "get": { "description": "Returns one row per crypto ETF issuer, with the issuer's latest values. An ETF provider is an asset manager running crypto exchange-traded products, and its id is its Blockworks Research provider slug (for example blackrock). Latest values are read from the most recent point in the last 30 days; an issuer that reported nothing in that window returns nulls and a null asOf. Sourced from Blockworks Research.", "operationId": "getETFProviders", "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "type": "integer", "format": "int64", "example": 1, "default": 1 } }, { "description": "Page size limit", "in": "query", "name": "limit", "schema": { "type": "integer", "format": "int64", "example": 100, "default": 100 } }, { "description": "Column to sort by. Anything other than name or slug sorts on that metric's latest value; a row with no value for it always sorts last, in either direction.", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "slug", "aum-usd", "flow-usd", "num-products", "weighted-aum-expense-ratio", "bitcoin-aum-perc", "spot-aum-perc", "rolling-30d-flow-usd", "aum-30d-change-perc" ], "example": "aum-usd", "default": "aum-usd" } }, { "description": "Sort direction", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "example": "desc", "default": "desc" } }, { "description": "Match against the issuer's id, slug or name. Case-insensitive substring.", "in": "query", "name": "search", "schema": { "type": "string", "example": "blackrock" } } ], "security": [ { "apiKey": [] } ], "summary": "List ETF Providers", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetETFProvidersResponse" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "blackrock", "slug": "blackrock", "name": "BlackRock", "asOf": 1787270400, "metrics": { "aumUsd": 69035555967, "flowUsd": 776184468, "numProducts": 8, "weightedAumExpenseRatio": 0.002489769699759677, "bitcoinAumPerc": 0.8771670448767953, "spotAumPerc": 0.9989685136738227, "rolling30dFlowUsd": 2278552478, "aum30dChangePerc": 0.2604181259715074 } }, { "id": "grayscale", "slug": "grayscale", "name": "Grayscale", "asOf": 1787270400, "metrics": { "aumUsd": 19674093972, "flowUsd": 9649610, "numProducts": 17, "weightedAumExpenseRatio": 0.010781808503369489, "bitcoinAumPerc": 0.7534320894825499, "spotAumPerc": 0.9988471478771892, "rolling30dFlowUsd": 47624438, "aum30dChangePerc": 0.2221210439264214 } }, { "id": "fidelity", "slug": "fidelity", "name": "Fidelity", "asOf": 1787270400, "metrics": { "aumUsd": 16333700368, "flowUsd": 78555503, "numProducts": 6, "weightedAumExpenseRatio": 0.0026353644271711794, "bitcoinAumPerc": 0.9127296812795311, "spotAumPerc": 1, "rolling30dFlowUsd": 217897331, "aum30dChangePerc": 0.22125080250160287 } }, { "id": "bitwise", "slug": "bitwise-asset-management", "name": "Bitwise Asset Management", "asOf": 1787270400, "metrics": { "aumUsd": 7313252055, "flowUsd": 58535177, "numProducts": 29, "weightedAumExpenseRatio": 0.005947079384849672, "bitcoinAumPerc": 0.5376709484957031, "spotAumPerc": 1, "rolling30dFlowUsd": 127567875, "aum30dChangePerc": 0.23493029064431553 } }, { "id": "21shares", "slug": "21shares", "name": "21Shares", "asOf": 1787270400, "metrics": { "aumUsd": 6053211130, "flowUsd": 14849115, "numProducts": 71, "weightedAumExpenseRatio": 0.009072870196929678, "bitcoinAumPerc": 0.6343309095845133, "spotAumPerc": 0.997981592788091, "rolling30dFlowUsd": 87247089, "aum30dChangePerc": 0.2302057140879824 } } ], "metadata": { "pageSize": 100, "page": 1, "totalRows": 76, "totalPages": 1 } } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs/metrics": { "get": { "description": "Returns the metric catalog for both ETF datasets in one response: the provider grain, one series per issuer, and the asset grain, one series per underlying crypto asset. Both publish a dataset slugged overview, so each entry carries a grain telling them apart. Use the metric slugs here to read the point arrays the ETF time series endpoints return.", "operationId": "getETFsTimeseriesCatalog", "parameters": [], "security": [ { "apiKey": [] } ], "summary": "List ETF Metrics", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/ETFTimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "grain": "providers", "slug": "overview", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "AUM (USD)", "slug": "aum-usd", "description": "Assets under management across the provider's crypto ETF products in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Flow (USD)", "slug": "flow-usd", "description": "Daily net flow across the provider's crypto ETF products in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Product Count", "slug": "num-products", "description": "Number of active products with positive AUM. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Weighted Expense Ratio", "slug": "weighted-aum-expense-ratio", "description": "AUM-weighted average expense ratio. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Bitcoin AUM Share", "slug": "bitcoin-aum-perc", "description": "Share of AUM in bitcoin products (0-1). Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot AUM Share", "slug": "spot-aum-perc", "description": "Share of AUM in delta-one (spot) products (0-1). Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Rolling 30d Flow (USD)", "slug": "rolling-30d-flow-usd", "description": "Rolling 30-day net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "AUM 30d Change", "slug": "aum-30d-change-perc", "description": "AUM change versus 30 days ago as a ratio. Sourced from Blockworks Research.", "is_timestamp": false } ] }, { "grain": "assets", "slug": "overview", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Spot AUM (USD)", "slug": "type-spot-aum-usd", "description": "Spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot Flow (USD)", "slug": "type-spot-flow-usd", "description": "Spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot Product Count", "slug": "type-spot-product-count", "description": "Number of spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures AUM (USD)", "slug": "type-futures-aum-usd", "description": "Futures product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures Flow (USD)", "slug": "type-futures-flow-usd", "description": "Futures product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures Product Count", "slug": "type-futures-product-count", "description": "Number of futures products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot AUM (USD)", "slug": "type-spot-unitedstates-aum-usd", "description": "US spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot Flow (USD)", "slug": "type-spot-unitedstates-flow-usd", "description": "US spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot Product Count", "slug": "type-spot-unitedstates-product-count", "description": "Number of US spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot AUM (USD)", "slug": "type-spot-europe-aum-usd", "description": "European spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot Flow (USD)", "slug": "type-spot-europe-flow-usd", "description": "European spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot Product Count", "slug": "type-spot-europe-product-count", "description": "Number of European spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot AUM (USD)", "slug": "type-spot-apac-aum-usd", "description": "APAC spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot Flow (USD)", "slug": "type-spot-apac-flow-usd", "description": "APAC spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot Product Count", "slug": "type-spot-apac-product-count", "description": "Number of APAC spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One AUM (USD)", "slug": "strategy-deltaone-aum-usd", "description": "Delta-one strategy AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One Flow (USD)", "slug": "strategy-deltaone-flow-usd", "description": "Delta-one strategy daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One Product Count", "slug": "strategy-deltaone-product-count", "description": "Number of delta-one products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged AUM (USD)", "slug": "strategy-leveraged-aum-usd", "description": "Leveraged strategy AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged Flow (USD)", "slug": "strategy-leveraged-flow-usd", "description": "Leveraged strategy daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged Product Count", "slug": "strategy-leveraged-product-count", "description": "Number of leveraged products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Total Volume (USD)", "slug": "total-volume-usd", "description": "Total traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Volume (USD)", "slug": "volume-unitedstates-usd", "description": "US traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Volume (USD)", "slug": "volume-europe-usd", "description": "European traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Volume (USD)", "slug": "volume-apac-usd", "description": "APAC traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false } ] } ] } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs/{providerIdentifier}/metrics/overview/time-series/{granularity}": { "get": { "description": "Returns one issuer's history: AUM, daily and rolling 30-day net flow, product count, AUM-weighted expense ratio, and the bitcoin and spot shares of AUM. The identifier is the issuer's Blockworks Research provider slug (blackrock) or its Messari project slug (bitwise-asset-management). Only the 1d granularity is available for this dataset.", "operationId": "getETFProviderTimeseries", "parameters": [ { "description": "Blockworks Research provider slug (blackrock) or Messari project slug (bitwise-asset-management). Both resolve to the same series.", "in": "path", "name": "providerIdentifier", "required": true, "schema": { "type": "string", "example": "blackrock" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get ETF Provider Time Series", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1704844800, 10449833, 10449833, 1, 0.0025, 1, 1, 10449833, -0.9997965550229319 ], [ 1704931200, 10635116, 0, 1, 0.0025, 1, 1, 10449833, -0.999792947798234 ], [ 1705017600, 114712330, 104737345, 1, 0.0025, 1, 1, 115187178, -0.9977666966212494 ], [ 1705276800, 114712330, 0, 1, 0.0025, 1, 1, 115187178, -0.9977666966212494 ], [ 1705363200, 494341368, 381095835, 1, 0.0025, 1, 1, 496283013, -0.9903758013858617 ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "AUM (USD)", "slug": "aum-usd", "description": "Assets under management across the provider's crypto ETF products in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Flow (USD)", "slug": "flow-usd", "description": "Daily net flow across the provider's crypto ETF products in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Product Count", "slug": "num-products", "description": "Number of active products with positive AUM. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Weighted Expense Ratio", "slug": "weighted-aum-expense-ratio", "description": "AUM-weighted average expense ratio. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Bitcoin AUM Share", "slug": "bitcoin-aum-perc", "description": "Share of AUM in bitcoin products (0-1). Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot AUM Share", "slug": "spot-aum-perc", "description": "Share of AUM in delta-one (spot) products (0-1). Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Rolling 30d Flow (USD)", "slug": "rolling-30d-flow-usd", "description": "Rolling 30-day net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "AUM 30d Change", "slug": "aum-30d-change-perc", "description": "AUM change versus 30 days ago as a ratio. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs/time-series/{granularity}": { "get": { "description": "Returns one time series per ETF issuer, for every issuer the provider listing serves, in a single response. Use this instead of calling the per-issuer endpoint once for each issuer. Every provider metric and the full history are returned by default; narrow start and end to limit the response size. An issuer with no data in the window is still present, with an empty points array.", "operationId": "getAllETFProvidersTimeseries", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get All ETF Providers Time Series", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ETFProviderTimeseriesEntry" } }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "provider": { "id": "21shares", "slug": "21shares", "name": "21Shares" }, "points": [ [ 1779926400, 5491070284, -12857858, 73, 0.009332801646798224, 0.6306379701768173, 0.997662783877053, -211637056, 0.1819180546015759 ], [ 1780012800, 5506995524, 3472147, 73, 0.009353502862189724, 0.6287018236915495, 0.9971358727401791, -250988687, 0.185345861514685 ], [ 1780272000, 5417290721, 2771058, 73, 0.009414303984406748, 0.6218617830386881, 0.9967329680256235, -212646014.00000003, 0.1660374715712688 ], [ 1780358400, 5157471208, -10209643, 73, 0.00958178253339461, 0.612891285189701, 0.9969369364630682, -222855657, 0.1101129691573621 ], [ 1780444800, 5027090390.000001, -25002386, 73, 0.009566590484361672, 0.6130858967904892, 0.9972746575181434, -338050858, 0.0820493249499768 ] ] }, { "provider": { "id": "3iq", "slug": "3iq", "name": "3iQ" }, "points": [ [ 1779926400, 373371547, -196560, 4, 0.010337842760417949, 0.45736786954470315, 1, -176699, 0.10909221637156744 ], [ 1780012800, 372640482, 148564, 4, 0.010350164030756058, 0.4583574202225297, 1, 135945, 0.10692060338263853 ], [ 1780272000, 366230108, 654594, 4, 0.01031106170741156, 0.4538086912286305, 1, 803290, 0.08787872414851823 ], [ 1780358400, 343595392, -338296, 4, 0.010334192010933605, 0.45361944202092214, 1, 464994, 0.020642783067606193 ], [ 1780444800, 334761249.00000006, 0, 4, 0.01034556726247607, 0.456467352348778, 1, 464994, -0.005598850282171709 ] ] }, { "provider": { "id": "amina-bank", "slug": "amina-bank", "name": "AMINA Bank" }, "points": [ [ 1779926400, 55753590, 0, 5, 0.009884328928415193, 0.7041589250127211, 1, -3866196, 0.2422877005193409 ], [ 1780012800, 53149864, 0, 5, 0.009939446223230222, 0.6987467362098989, 1, -3866196, 0.1842721218754827 ], [ 1780272000, 52039936, 0, 5, 0.009937248865947875, 0.6973355040252164, 1, -3855600, 0.1595409807442654 ], [ 1780358400, 50435994, 0, 5, 0.009948766400836672, 0.6911840579567046, 1, -3855600, 0.1238023418701338 ], [ 1780444800, 48782519, 0, 5, 0.009950856525059722, 0.6922561133015702, 1, -3855600, 0.0869600209430649 ] ] }, { "provider": { "id": "alphabit-investments", "slug": "alphabit-investments", "name": "AlphaBit Investments" }, "points": [ [ 1779926400, 9762075, 0, 1, 0.0104, 0, 1, 0, 0.0870066292196762 ], [ 1780012800, 9714015, 0, 1, 0.0104, 0, 1, 0, 0.0816551502973879 ], [ 1780272000, 9791370, 0, 1, 0.0104, 0, 1, 0, 0.0902686262032059 ], [ 1780358400, 9677205, 0, 1, 0.0104, 0, 1, 0, 0.0775563583887439 ], [ 1780444800, 9591030, 0, 1, 0.0104, 0, 1, 0, 0.0679607758642288 ] ] }, { "provider": { "id": "amplify-etfs", "slug": "amplify-etfs", "name": "Amplify ETFs" }, "points": [ [ 1779926400, 47199126.00000001, 0, 6, 0.006923609623618878, 0.576390376381122, 0, 5549098, 0.156692144263159 ], [ 1780012800, 47797622, 492150, 6, 0.006929741797614953, 0.5702582023850475, 0, 6041248, 0.1713592722428789 ], [ 1780272000, 46748428, 0, 6, 0.006935531500652813, 0.5644684993471866, 0, 5625970, 0.14564704914773 ], [ 1780358400, 44707842, 838653, 6, 0.006927521641505309, 0.572478358494691, 0, 6464623, 0.0956391359526132 ], [ 1780444800, 43498305, 174080, 6, 0.0069277007345458635, 0.5722992654541367, 0, 6638703, 0.0659974441531585 ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "AUM (USD)", "slug": "aum-usd", "description": "Assets under management across the provider's crypto ETF products in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Flow (USD)", "slug": "flow-usd", "description": "Daily net flow across the provider's crypto ETF products in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Product Count", "slug": "num-products", "description": "Number of active products with positive AUM. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Weighted Expense Ratio", "slug": "weighted-aum-expense-ratio", "description": "AUM-weighted average expense ratio. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Bitcoin AUM Share", "slug": "bitcoin-aum-perc", "description": "Share of AUM in bitcoin products (0-1). Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot AUM Share", "slug": "spot-aum-perc", "description": "Share of AUM in delta-one (spot) products (0-1). Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Rolling 30d Flow (USD)", "slug": "rolling-30d-flow-usd", "description": "Rolling 30-day net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "AUM 30d Change", "slug": "aum-30d-change-perc", "description": "AUM change versus 30 days ago as a ratio. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs/assets": { "get": { "description": "Returns one row per underlying crypto asset held through ETFs, with the asset's latest values split by product type, by region and by strategy. This is a sibling of the provider listing, not a child of it: an issuer and an underlying asset are two independent cuts of the same data. Latest values are read from the most recent point in the last 30 days; an asset that reported nothing in that window returns nulls and a null asOf. Sourced from Blockworks Research.", "operationId": "getETFAssets", "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "type": "integer", "format": "int64", "example": 1, "default": 1 } }, { "description": "Page size limit", "in": "query", "name": "limit", "schema": { "type": "integer", "format": "int64", "example": 100, "default": 100 } }, { "description": "Column to sort by. Anything other than name or slug sorts on that metric's latest value; a row with no value for it always sorts last, in either direction.", "in": "query", "name": "sort", "schema": { "type": "string", "enum": [ "name", "slug", "type-spot-aum-usd", "type-spot-flow-usd", "type-spot-product-count", "type-futures-aum-usd", "type-futures-flow-usd", "type-futures-product-count", "type-spot-unitedstates-aum-usd", "type-spot-unitedstates-flow-usd", "type-spot-unitedstates-product-count", "type-spot-europe-aum-usd", "type-spot-europe-flow-usd", "type-spot-europe-product-count", "type-spot-apac-aum-usd", "type-spot-apac-flow-usd", "type-spot-apac-product-count", "strategy-deltaone-aum-usd", "strategy-deltaone-flow-usd", "strategy-deltaone-product-count", "strategy-leveraged-aum-usd", "strategy-leveraged-flow-usd", "strategy-leveraged-product-count", "total-volume-usd", "volume-unitedstates-usd", "volume-europe-usd", "volume-apac-usd" ], "example": "type-spot-aum-usd", "default": "type-spot-aum-usd" } }, { "description": "Sort direction", "in": "query", "name": "order", "schema": { "type": "string", "enum": [ "asc", "desc" ], "example": "desc", "default": "desc" } }, { "description": "Match against the asset's id, slug or name. Case-insensitive substring.", "in": "query", "name": "search", "schema": { "type": "string", "example": "bitcoin" } } ], "security": [ { "apiKey": [] } ], "summary": "List ETF Assets", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetETFAssetsResponse" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "bitcoin", "slug": "bitcoin", "name": "bitcoin", "asOf": 1787270400, "metrics": { "typeSpotAumUsd": 113171725902, "typeSpotFlowUsd": 687188302.0000001, "typeSpotProductCount": 135, "typeFuturesAumUsd": 3679822902, "typeFuturesFlowUsd": 23563391, "typeFuturesProductCount": 6, "typeSpotUnitedstatesAumUsd": 98150728001, "typeSpotUnitedstatesFlowUsd": 643295381, "typeSpotUnitedstatesProductCount": 59, "typeSpotEuropeAumUsd": 9599061196, "typeSpotEuropeFlowUsd": 31334458, "typeSpotEuropeProductCount": 35, "typeSpotApacAumUsd": 1056947400, "typeSpotApacFlowUsd": 3399323.0000000005, "typeSpotApacProductCount": 15, "strategyDeltaoneAumUsd": 112585118402, "strategyDeltaoneFlowUsd": 686197353, "strategyDeltaoneProductCount": 81, "strategyLeveragedAumUsd": 1754585085, "strategyLeveragedFlowUsd": 1756011, "strategyLeveragedProductCount": 8, "totalVolumeUsd": null, "volumeUnitedstatesUsd": null, "volumeEuropeUsd": null, "volumeApacUsd": null } }, { "id": "ethereum", "slug": "ethereum", "name": "ethereum", "asOf": 1787270400, "metrics": { "typeSpotAumUsd": 17676473555, "typeSpotFlowUsd": 241183836, "typeSpotProductCount": 69, "typeFuturesAumUsd": 1560187673.0000002, "typeFuturesFlowUsd": 10294644, "typeFuturesProductCount": 6, "typeSpotUnitedstatesAumUsd": 14324198864, "typeSpotUnitedstatesFlowUsd": 228336043, "typeSpotUnitedstatesProductCount": 22, "typeSpotEuropeAumUsd": 2238108620, "typeSpotEuropeFlowUsd": 2179470, "typeSpotEuropeProductCount": 21, "typeSpotApacAumUsd": 151056637, "typeSpotApacFlowUsd": -237183, "typeSpotApacProductCount": 9, "strategyDeltaoneAumUsd": 17475072318, "strategyDeltaoneFlowUsd": 242624178, "strategyDeltaoneProductCount": 55, "strategyLeveragedAumUsd": 1444888591, "strategyLeveragedFlowUsd": 1771349, "strategyLeveragedProductCount": 8, "totalVolumeUsd": null, "volumeUnitedstatesUsd": null, "volumeEuropeUsd": null, "volumeApacUsd": null } }, { "id": "multi-asset", "slug": "", "name": "multi-asset", "asOf": 1787270400, "metrics": { "typeSpotAumUsd": 4493114907, "typeSpotFlowUsd": 107564966, "typeSpotProductCount": 53, "typeFuturesAumUsd": 2648808, "typeFuturesFlowUsd": 0, "typeFuturesProductCount": 2, "typeSpotUnitedstatesAumUsd": 2399308710, "typeSpotUnitedstatesFlowUsd": 107637388, "typeSpotUnitedstatesProductCount": 14, "typeSpotEuropeAumUsd": 1881407857, "typeSpotEuropeFlowUsd": -602121, "typeSpotEuropeProductCount": 28, "typeSpotApacAumUsd": 128823025, "typeSpotApacFlowUsd": null, "typeSpotApacProductCount": 2, "strategyDeltaoneAumUsd": 4300898856, "strategyDeltaoneFlowUsd": 107564966, "strategyDeltaoneProductCount": 53, "strategyLeveragedAumUsd": null, "strategyLeveragedFlowUsd": null, "strategyLeveragedProductCount": null, "totalVolumeUsd": null, "volumeUnitedstatesUsd": null, "volumeEuropeUsd": null, "volumeApacUsd": null } }, { "id": "solana", "slug": "solana", "name": "solana", "asOf": 1787270400, "metrics": { "typeSpotAumUsd": 2454519267, "typeSpotFlowUsd": 13567592, "typeSpotProductCount": 31, "typeFuturesAumUsd": 299413018, "typeFuturesFlowUsd": -3403263.0000000005, "typeFuturesProductCount": 4, "typeSpotUnitedstatesAumUsd": 1188685862, "typeSpotUnitedstatesFlowUsd": 7770985, "typeSpotUnitedstatesProductCount": 10, "typeSpotEuropeAumUsd": 1099453833, "typeSpotEuropeFlowUsd": 5610037, "typeSpotEuropeProductCount": 11, "typeSpotApacAumUsd": 7548530, "typeSpotApacFlowUsd": 0, "typeSpotApacProductCount": 1, "strategyDeltaoneAumUsd": 2563767819, "strategyDeltaoneFlowUsd": 14384233.999999998, "strategyDeltaoneProductCount": 32, "strategyLeveragedAumUsd": 188586798, "strategyLeveragedFlowUsd": -4219905, "strategyLeveragedProductCount": 2, "totalVolumeUsd": null, "volumeUnitedstatesUsd": null, "volumeEuropeUsd": null, "volumeApacUsd": null } }, { "id": "ripple", "slug": "", "name": "ripple", "asOf": 1787270400, "metrics": { "typeSpotAumUsd": 2416763651, "typeSpotFlowUsd": 17298506, "typeSpotProductCount": 21, "typeFuturesAumUsd": 190352441, "typeFuturesFlowUsd": 557926, "typeFuturesProductCount": 2, "typeSpotUnitedstatesAumUsd": 1375248369, "typeSpotUnitedstatesFlowUsd": 15340165, "typeSpotUnitedstatesProductCount": 7, "typeSpotEuropeAumUsd": 870738844, "typeSpotEuropeFlowUsd": 2008631, "typeSpotEuropeProductCount": 8, "typeSpotApacAumUsd": null, "typeSpotApacFlowUsd": null, "typeSpotApacProductCount": null, "strategyDeltaoneAumUsd": 2513228126, "strategyDeltaoneFlowUsd": 15549117, "strategyDeltaoneProductCount": 21, "strategyLeveragedAumUsd": 80934545, "strategyLeveragedFlowUsd": 1753750, "strategyLeveragedProductCount": 1, "totalVolumeUsd": null, "volumeUnitedstatesUsd": null, "volumeEuropeUsd": null, "volumeApacUsd": null } } ], "metadata": { "pageSize": 100, "page": 1, "totalRows": 60, "totalPages": 1 } } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs/assets/{assetIdentifier}/metrics/overview/time-series/{granularity}": { "get": { "description": "Returns one underlying crypto asset's ETF history: AUM, net flow and product count split by product type (spot and futures), by region (US, Europe and APAC) and by strategy (delta-one and leveraged), plus traded volume by region. Only the 1d granularity is available for this dataset.", "operationId": "getETFAssetTimeseries", "parameters": [ { "description": "The asset's symbol (bitcoin) or its Messari network slug, where the asset maps to a network.", "in": "path", "name": "assetIdentifier", "required": true, "schema": { "type": "string", "example": "bitcoin" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get ETF Asset Time Series", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "points": [ [ 1704153600, 7572297082, 6018137, 41, 2076892442, 15953828, 4, 185017249, 7497055, 8, 4445558372, 988461, 16, 62914825, 1499074, 3, 9282139246, 23900450, 38, 206404726, -1542252, 1, null, null, null, null ], [ 1704240000, 7962737158, 23844922, 45, 1977947140, 9285924, 4, 175512368, -3023858.9999999995, 8, 4958093862, 24438447, 20, 60109946, 211285, 3, 9588458738, 31149978.000000004, 41, 185866395, 0, 1, null, null, null, null ], [ 1704326400, 8136420222, -6865284, 45, 2061621307, 8891982, 4, 182108410.00000003, 0, 8, 5056983323, -1335886.0000000002, 20, 62132157, 172689, 3, 9829094425, -934309, 41, 202976884, 3722070, 1, null, null, null, null ], [ 1704412800, 8076803649.000001, 12164081, 45, 2098748767, 49937359, 4, 177333958, 0, 8, 5010389881, 7922256, 20, 61564487.99999999, 0, 3, 9801858062, 54954293, 41, 207659836.99999997, 7109959, 1, null, null, null, null ], [ 1704672000, 8437863009, -6253208, 45, 2279209081, 36509120, 4, 190105825.00000003, 2688792, 8, 5191400572, 2027037, 20, 67575918, 2576669, 3, 10314039307, 29274590, 41, 234887499, 0, 1, null, null, null, null ] ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Spot AUM (USD)", "slug": "type-spot-aum-usd", "description": "Spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot Flow (USD)", "slug": "type-spot-flow-usd", "description": "Spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot Product Count", "slug": "type-spot-product-count", "description": "Number of spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures AUM (USD)", "slug": "type-futures-aum-usd", "description": "Futures product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures Flow (USD)", "slug": "type-futures-flow-usd", "description": "Futures product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures Product Count", "slug": "type-futures-product-count", "description": "Number of futures products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot AUM (USD)", "slug": "type-spot-unitedstates-aum-usd", "description": "US spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot Flow (USD)", "slug": "type-spot-unitedstates-flow-usd", "description": "US spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot Product Count", "slug": "type-spot-unitedstates-product-count", "description": "Number of US spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot AUM (USD)", "slug": "type-spot-europe-aum-usd", "description": "European spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot Flow (USD)", "slug": "type-spot-europe-flow-usd", "description": "European spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot Product Count", "slug": "type-spot-europe-product-count", "description": "Number of European spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot AUM (USD)", "slug": "type-spot-apac-aum-usd", "description": "APAC spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot Flow (USD)", "slug": "type-spot-apac-flow-usd", "description": "APAC spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot Product Count", "slug": "type-spot-apac-product-count", "description": "Number of APAC spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One AUM (USD)", "slug": "strategy-deltaone-aum-usd", "description": "Delta-one strategy AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One Flow (USD)", "slug": "strategy-deltaone-flow-usd", "description": "Delta-one strategy daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One Product Count", "slug": "strategy-deltaone-product-count", "description": "Number of delta-one products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged AUM (USD)", "slug": "strategy-leveraged-aum-usd", "description": "Leveraged strategy AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged Flow (USD)", "slug": "strategy-leveraged-flow-usd", "description": "Leveraged strategy daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged Product Count", "slug": "strategy-leveraged-product-count", "description": "Number of leveraged products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Total Volume (USD)", "slug": "total-volume-usd", "description": "Total traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Volume (USD)", "slug": "volume-unitedstates-usd", "description": "US traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Volume (USD)", "slug": "volume-europe-usd", "description": "European traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Volume (USD)", "slug": "volume-apac-usd", "description": "APAC traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/etfs/assets/time-series/{granularity}": { "get": { "description": "Returns one time series per underlying crypto asset, for every asset the asset listing serves, in a single response. Every asset metric and the full history are returned by default; narrow start and end to limit the response size. An asset with no data in the window is still present, with an empty points array.", "operationId": "getAllETFAssetsTimeseries", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get All ETF Assets Time Series", "tags": [ "metrics/protocols/etfs" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ETFAssetTimeseriesEntry" } }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/metricsTimeseriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": [ { "asset": { "id": "aave", "slug": "", "name": "aave" }, "points": [ [ 1779926400, 3694325, 0, 2, null, null, null, null, null, null, 3694325, 0, 2, null, null, null, 3694325, 0, 2, null, null, null, 281613.047069, null, 281613.047069, null ], [ 1780012800, 3765812, 0, 2, null, null, null, null, null, null, 3765812, 0, 2, null, null, null, 3765812, 0, 2, null, null, null, 38586.27966134, null, 38586.27966134, null ], [ 1780272000, 3362237, -326928.00000000006, 2, null, null, null, null, null, null, 3362237, -326928.00000000006, 2, null, null, null, 3362237, -326928.00000000006, 2, null, null, null, 22384.040734242, null, 22384.040734242, null ], [ 1780358400, 3209163, 0, 2, null, null, null, null, null, null, 3209163, 0, 2, null, null, null, 3209163, 0, 2, null, null, null, null, null, null, null ], [ 1780444800, 3211588, 0, 2, null, null, null, null, null, null, 3211588, 0, 2, null, null, null, 3211588, 0, 2, null, null, null, null, null, null, null ] ] }, { "asset": { "id": "algorand", "slug": "", "name": "algorand" }, "points": [ [ 1779926400, 15391768, -4430, 4, null, null, null, null, null, null, 15391768, -4430, 4, null, null, null, 15391768, -4430, 4, null, null, null, 54870.198317020004, null, 54870.198317020004, null ], [ 1780012800, 16518075.999999998, 3704.9999999999995, 4, null, null, null, null, null, null, 16518075.999999998, 3704.9999999999995, 4, null, null, null, 16518075.999999998, 3704.9999999999995, 4, null, null, null, 102592.73461813999, null, 102592.73461813999, null ], [ 1780272000, 17233950, -10395, 4, null, null, null, null, null, null, 17233950, -10395, 4, null, null, null, 17233950, -10395, 4, null, null, null, 436437.37228263, null, 436437.37228263, null ], [ 1780358400, 17361583, -284, 4, null, null, null, null, null, null, 17361583, -284, 4, null, null, null, 17361583, -284, 4, null, null, null, null, null, null, null ], [ 1780444800, 16135289, -180146, 4, null, null, null, null, null, null, 16135289, -180146, 4, null, null, null, 16135289, -180146, 4, null, null, null, null, null, null, null ] ] }, { "asset": { "id": "aptos", "slug": "aptos", "name": "aptos" }, "points": [ [ 1779926400, 5553943, 0, 3, null, null, null, null, null, null, 5553943, 0, 3, null, null, null, 5553943, 0, 3, null, null, null, 6918.281893470001, null, 6918.281893470001, null ], [ 1780012800, 5488925, 1617, 3, null, null, null, null, null, null, 5488925, 1617, 3, null, null, null, 5488925, 1617, 3, null, null, null, 324628.06091004, null, 324628.06091004, null ], [ 1780272000, 5508350, -5441.999999999999, 3, null, null, null, null, null, null, 5508350, -5441.999999999999, 3, null, null, null, 5508350, -5441.999999999999, 3, null, null, null, 13813.842214179, null, 13813.842214179, null ], [ 1780358400, 5340109, 279, 3, null, null, null, null, null, null, 5340109, 279, 3, null, null, null, 5340109, 279, 3, null, null, null, null, null, null, null ], [ 1780444800, 5162507, -523, 3, null, null, null, null, null, null, 5162507, -523, 3, null, null, null, 5162507, -523, 3, null, null, null, null, null, null, null ] ] }, { "asset": { "id": "arbitrum", "slug": "arbitrum-one", "name": "arbitrum" }, "points": [ [ 1779926400, 2918877, -751, 3, null, null, null, null, null, null, 2918877, -751, 3, null, null, null, 2918877, -751, 3, null, null, null, 56739.107742311004, null, 56739.107742311004, null ], [ 1780012800, 2920153, 521, 3, null, null, null, null, null, null, 2920153, 521, 3, null, null, null, 2920153, 521, 3, null, null, null, 10138.70312585, null, 10138.70312585, null ], [ 1780272000, 2847916.9999999995, 1160, 3, null, null, null, null, null, null, 2847916.9999999995, 1160, 3, null, null, null, 2847916.9999999995, 1160, 3, null, null, null, 13985.97602448, null, 13985.97602448, null ], [ 1780358400, 2740515, 1111, 3, null, null, null, null, null, null, 2740515, 1111, 3, null, null, null, 2740515, 1111, 3, null, null, null, null, null, null, null ], [ 1780444800, 2750924.9999999995, 499, 3, null, null, null, null, null, null, 2750924.9999999995, 499, 3, null, null, null, 2750924.9999999995, 499, 3, null, null, null, null, null, null, null ] ] }, { "asset": { "id": "avalanche", "slug": "", "name": "avalanche" }, "points": [ [ 1779926400, 71926474, -5128, 9, 764035, 0, 1, 43262568, 0, 3, 28663906, -5128, 6, null, null, null, 71926474, -5128, 9, 764035, 0, 1, 442116.18088705, 292206.14360913, 149910.03727792, null ], [ 1780012800, 71249009, -1884, 9, 747620, 0, 1, 42766878, 0, 3, 28482131, -1884, 6, null, null, null, 71249009, -1884, 9, 747620, 0, 1, 782398.7855279425, 664130.16055772, 118268.6249702224, null ], [ 1780272000, 71583559, 4537, 9, 770495, 0, 1, 43252209, 0, 3, 28331350, 4537, 6, null, null, null, 71583559, 4537, 9, 770495, 0, 1, 75992.4542429178, null, 75992.4542429178, null ], [ 1780358400, 67830483, -22421, 9, 796932, 132822, 1, 40250971, 0, 3, 27579512, -22421, 6, null, null, null, 67830483, -22421, 9, 796932, 132822, 1, null, null, null, null ], [ 1780444800, 66098819.99999999, 11297, 9, 860811, 122973, 1, 39303996, 0, 3, 26794824, 11297, 6, null, null, null, 66098819.99999999, 11297, 9, 860811, 122973, 1, null, null, null, null ] ] } ], "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Spot AUM (USD)", "slug": "type-spot-aum-usd", "description": "Spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot Flow (USD)", "slug": "type-spot-flow-usd", "description": "Spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Spot Product Count", "slug": "type-spot-product-count", "description": "Number of spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures AUM (USD)", "slug": "type-futures-aum-usd", "description": "Futures product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures Flow (USD)", "slug": "type-futures-flow-usd", "description": "Futures product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Futures Product Count", "slug": "type-futures-product-count", "description": "Number of futures products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot AUM (USD)", "slug": "type-spot-unitedstates-aum-usd", "description": "US spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot Flow (USD)", "slug": "type-spot-unitedstates-flow-usd", "description": "US spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Spot Product Count", "slug": "type-spot-unitedstates-product-count", "description": "Number of US spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot AUM (USD)", "slug": "type-spot-europe-aum-usd", "description": "European spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot Flow (USD)", "slug": "type-spot-europe-flow-usd", "description": "European spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Spot Product Count", "slug": "type-spot-europe-product-count", "description": "Number of European spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot AUM (USD)", "slug": "type-spot-apac-aum-usd", "description": "APAC spot product AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot Flow (USD)", "slug": "type-spot-apac-flow-usd", "description": "APAC spot product daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Spot Product Count", "slug": "type-spot-apac-product-count", "description": "Number of APAC spot products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One AUM (USD)", "slug": "strategy-deltaone-aum-usd", "description": "Delta-one strategy AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One Flow (USD)", "slug": "strategy-deltaone-flow-usd", "description": "Delta-one strategy daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Delta-One Product Count", "slug": "strategy-deltaone-product-count", "description": "Number of delta-one products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged AUM (USD)", "slug": "strategy-leveraged-aum-usd", "description": "Leveraged strategy AUM in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged Flow (USD)", "slug": "strategy-leveraged-flow-usd", "description": "Leveraged strategy daily net flow in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Leveraged Product Count", "slug": "strategy-leveraged-product-count", "description": "Number of leveraged products. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Total Volume (USD)", "slug": "total-volume-usd", "description": "Total traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "US Volume (USD)", "slug": "volume-unitedstates-usd", "description": "US traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Europe Volume (USD)", "slug": "volume-europe-usd", "description": "European traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "APAC Volume (USD)", "slug": "volume-apac-usd", "description": "APAC traded volume in USD. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d" } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/tcg": { "get": { "description": "Returns one row per Blockworks Research trading-card and collectibles platform, each with the chains it runs on. The id is the platform's Blockworks Research slug and can be passed straight back as the platformIdentifier of the platform time series route; each chain carries the series key of its platform-chain pair, which is the id the time series endpoints return. projectSlug and networkSlug are the Messari mappings and are null where the platform or chain maps to no Messari record. Paging is over platforms, so a multi-chain platform is never split across two pages. Sourced from Blockworks Research.", "operationId": "getTCGPlatforms", "parameters": [ { "description": "Page number (1-indexed)", "in": "query", "name": "page", "schema": { "type": "integer", "format": "int64", "example": 1, "default": 1 } }, { "description": "Page size limit", "in": "query", "name": "limit", "schema": { "type": "integer", "format": "int64", "example": 100, "default": 100 } } ], "security": [ { "apiKey": [] } ], "summary": "List TCG Platforms", "tags": [ "metrics/protocols/tcg" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/GetTCGPlatformsResponse" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "data": [ { "id": "beezie", "name": "beezie", "projectSlug": "beezie", "chains": [ { "id": "beezie_base", "chain": "base", "networkSlug": "base" }, { "id": "beezie_flow", "chain": "flow", "networkSlug": "flow" }, { "id": "beezie_solana", "chain": "solana", "networkSlug": "solana" } ] }, { "id": "bonkuji", "name": "bonkuji", "projectSlug": null, "chains": [ { "id": "bonkuji_solana", "chain": "solana", "networkSlug": "solana" } ] }, { "id": "collector-crypt", "name": "collector-crypt", "projectSlug": "collector-crypt", "chains": [ { "id": "collector-crypt_solana", "chain": "solana", "networkSlug": "solana" } ] }, { "id": "courtyard", "name": "courtyard", "projectSlug": "courtyard", "chains": [ { "id": "courtyard_polygon", "chain": "polygon", "networkSlug": "polygon-pos" } ] }, { "id": "monster", "name": "monster", "projectSlug": null, "chains": [ { "id": "monster_megaeth", "chain": "megaeth", "networkSlug": "megaeth" } ] } ], "metadata": { "pageSize": 100, "page": 1, "totalRows": 6, "totalPages": 1 } } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/tcg/metrics": { "get": { "description": "Returns the metric catalog for the TCG overview dataset: one entry per column of a point, in point order, with the timestamp first. The slugs here are the keys of a point row, and the order is the order of the values in every points array the TCG time series endpoints return. Sourced from Blockworks Research.", "operationId": "getTCGTimeseriesCatalogV2", "parameters": [], "security": [ { "apiKey": [] } ], "summary": "List TCG Metrics", "tags": [ "metrics/protocols/tcg" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TimeseriesCatalog" }, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "datasets": [ { "slug": "overview", "granularities": [ "1d" ], "metrics": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Gross Revenue USD", "slug": "grossRevenueUsd", "description": "Gross platform revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Net Revenue USD", "slug": "netRevenueUsd", "description": "Net platform revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Misc Revenue USD", "slug": "miscRevenueUsd", "description": "Miscellaneous revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Buyback Expense USD", "slug": "buybackExpenseUsd", "description": "Card buyback expense in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Referral Expense USD", "slug": "referralExpenseUsd", "description": "Referral expense in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "GMV USD", "slug": "gmvUsd", "description": "Gross merchandise value in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Volume incl. Buybacks USD", "slug": "volumeInclBuybackUsd", "description": "Volume including platform buybacks in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Gacha Spend USD", "slug": "gachaSpendUsd", "description": "Net gacha (pack-opening) spend in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Credit Card Spend USD", "slug": "creditCardSpendUsd", "description": "Credit-card spend in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "New DAU", "slug": "dauNew", "description": "New daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Recurring DAU", "slug": "dauRecurring", "description": "Recurring daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Total DAU", "slug": "dauTotal", "description": "Total daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Marketplace Volume USD", "slug": "marketplaceVolumeUsd", "description": "Secondary-marketplace volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Organic Volume USD", "slug": "organicVolumeUsd", "description": "Marketplace volume excluding buybacks in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Buyback Volume USD", "slug": "buybackVolumeUsd", "description": "Marketplace buyback volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Sales Count", "slug": "salesCount", "description": "Marketplace sales count. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Unique Buyers", "slug": "uniqueBuyers", "description": "Unique marketplace buyers. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Top Sale USD", "slug": "topSaleUsd", "description": "Largest single sale of the day in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Marketplace Fees USD", "slug": "marketplaceFeesUsd", "description": "Marketplace fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Packs Opened", "slug": "packsOpened", "description": "Gacha packs opened, summed across tiers. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Gross Gacha Spend USD", "slug": "grossGachaSpendUsd", "description": "Gross gacha spend, summed across tiers, in USD. Sourced from Blockworks Research.", "is_timestamp": false } ] } ] } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/tcg/time-series/{granularity}": { "get": { "description": "Returns one time series per platform and chain, across every TCG platform, in a single response. Nothing is aggregated across a platform's chains: the daily-active-user and unique-buyer counts overlap between chains, so a cross-chain total would overstate them. Every series carries its platform and chain alongside the composite id, so no consumer has to split the id. Only the 1d granularity is available. The response is small enough to serve the full history by default; narrow it with start and end.", "operationId": "getAllTCGPlatformsTimeSeriesWithGranularityV2", "parameters": [ { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get All TCG Platforms Time Series", "tags": [ "metrics/protocols/tcg" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TCGSeriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/TCGSeriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "series": [ { "id": "beezie_base", "platform": "beezie", "chain": "base", "points": [ [ 1785542400, 207915.68, 7177.260000000009, 0, 196453.41999999998, 0, 213772, 410225.42, 207460, 3330, 3, 74, 77, 6312, 2027, 4285, 63, 4, 900, 374.67999999999995, 5104, 411590 ], [ 1785628800, 69278.58, 3463.5800000000163, 0, 59689.999999999985, 0, 75537, 135227, 68890, 4050, 6, 66, 72, 6647, 522, 6125, 84, 4, 1000, 388.58, 2410, 133730 ], [ 1785715200, 203290.26, 3384.000000000029, 0, 183656.25999999998, 0, 218818, 402474.26, 202210, 2850, 10, 80, 90, 16608, 358, 16250, 140, 7, 3250, 991.2600000000001, 8306, 401570 ], [ 1785801600, 459557.18, 23967.66000000015, 0, 421738.51999999984, 0, 472987, 894725.5199999998, 458700, 2870, 7, 86, 93, 14287, 436, 13851, 157, 6, 2089, 844.1800000000003, 7374.000000000001, 914530 ], [ 1785888000, 89859.08, 5083.879999999976, 0, 80821.20000000003, 0, 93555, 174376.2, 89550, 1580, 4, 69, 73, 4005, 51, 3954, 56, 2, 457.99999999999994, 234.08000000000004, 4558, 177520 ] ] }, { "id": "beezie_flow", "platform": "beezie", "chain": "flow", "points": [ [ 1785542400, 0.7356, 0.7356, 0, 0, 0, 12.26, 12.26, 0, 0, 0, 0, 0, 12.26, 12.26, 0, 1, 1, 12.26, 0.8582000000000001, 0, 0 ], [ 1785715200, 1.44, 1.44, 0, 0, 0, 24, 24, 0, 0, 0, 0, 0, 24, 24, 0, 1, 1, 24, 1.68, 0, 0 ], [ 1785801600, 0.7392, 0.7392, 0, 0, 0, 12.319999999999999, 12.319999999999999, 0, 0, 0, 0, 0, 12.319999999999999, 12.319999999999999, 0, 1, 1, 12.319999999999999, 0.8623999999999999, 0, 0 ], [ 1785888000, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, null, null, null, null, null, null, null, 0, 0 ], [ 1785974400, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, null, null, null, null, null, null, null, 0, 0 ] ] }, { "id": "beezie_solana", "platform": "beezie", "chain": "solana", "points": [ [ 1785542400, 14817.38, 1505.2400000000016, 0, 13189.139999999998, 0, 14933, 28122.14, 14810, 0, 3, 13, 16, 123, 0, 123, 1, 1, 123, 7.38, 274, 29620 ], [ 1785628800, 105073.38, 6504.480000000025, 0, 97275.89999999998, 0, 106293, 203568.89999999997, 105000, 0, 1, 23, 24, 1293, 0, 1293, 15, 1, 236, 77.58000000000001, 1582, 210000 ], [ 1785715200, 166007.14, 5890.139999999956, 0, 159048.00000000006, 0, 167069, 326117.00000000006, 166000, 0, 3, 13, 16, 1069, 0, 1069, 3, 1, 670, 64.14, 760, 332000 ], [ 1785801600, 32557.62, 3808.8200000000033, 0, 28641.799999999996, 0, 32687, 61328.799999999996, 32550, 0, 7, 20, 27, 137, 30, 107, 4, 3, 54, 8.22, 268, 65100 ], [ 1785888000, 109445.1, -1250.6399999999994, 0, 110610.74, 0, 109525, 220135.74, 109440, 0, 3, 17, 20, 85, 0, 85, 1, 1, 85, 5.1, 1274, 218880 ] ] }, { "id": "bonkuji_solana", "platform": "bonkuji", "chain": "solana", "points": [ [ 1785542400, 6731.004, 2181.728, 0, 4549.276, 0, 6731.004, 11280.279999999999, 6731.004, null, 6, 5, 11, 0, 0, 0, null, null, null, null, 66, 12911.004 ], [ 1785628800, 7058.015877, 2835.4470779999983, 0, 4222.5687990000015, 0, 7058.015877, 11280.584676000002, 7058.015877, null, 3, 3, 6, 0, 0, 0, null, null, null, null, 144, 13448.015877 ], [ 1785715200, 1198.0020000000002, -152.74119600000012, 0, 1350.7431960000004, 0, 1241.0020000000002, 2548.7451960000008, 1198.0020000000002, null, 5, 2, 7, 43, 43, 0, 6, 2, 15, null, 68, 2278.0020000000004 ], [ 1785801600, 749.0010000000003, -51.75739699999979, 0, 800.7583970000002, 0, 749.0010000000003, 1549.7593970000005, 749.0010000000003, null, 0, 4, 4, 0, 0, 0, null, null, null, null, 50, 1489.0010000000007 ], [ 1785888000, 678.0009999999999, -2366.595798000001, 0, 3044.5967980000014, 0, 778.0009999999999, 3722.597798000001, 678.0009999999999, null, 4, 3, 7, 100, 100, 0, 1, 1, 100, null, 40, 1288.001 ] ] }, { "id": "collector-crypt_solana", "platform": "collector-crypt", "chain": "solana", "points": [ [ 1785542400, 4149437.964231991, 376712.8942320696, 3318.186389085104, 3772725.0699999216, null, 4263458.664520208, 8036183.73452013, 4095410, 48800, 149, 556, 705, 114217.037382418, 39666.417382418, 74550.62, 382, 65, 24795.920000000002, 1909.777842905999, 44234, 8239620 ], [ 1785628800, 8536286.021759918, 530743.2364930464, 2703.653204893479, 8005542.785266872, null, 8660288.362224795, 16665831.147491667, 8487771, 43950, 182, 574, 756, 116905.04760667412, 43787.59760667413, 73117.45, 249, 58, 45000, 1861.36855502404, 56560.00000000001, 17019492 ], [ 1785715200, 10787227.077417841, 797227.3016739022, 2914.2414679857393, 9989999.775743939, null, 10891241.905367816, 20881241.681111753, 10687210, 95200, 141, 621, 762, 102173.76199533616, 30871.4321953362, 71302.32979999996, 330, 64, 9183.669999999998, 1902.8359498554014, 53980, 21469620 ], [ 1785801600, 3530082.7420048416, 291918.35200487357, 3942.5621500115976, 3238164.389999968, null, 3586850.84395315, 6825015.233953118, 3477735, 47300, 171, 537, 708, 56758.62895198998, 37340.09895198999, 19418.52999999999, 446, 78, 6000, 1105.1798548299992, 38916, 7002770 ], [ 1785888000, 6101956.268599927, 276855.31860008463, 633.9475200380002, 5825100.949999843, null, 6176538.704900779, 12001639.654900622, 6033400, 66650, 175, 561, 736, 72855.9528969782, 41260.082896978194, 31595.87, 433, 80, 6029.08, 1272.3210798893992, 43866, 12133450 ] ] } ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Gross Revenue USD", "slug": "grossRevenueUsd", "description": "Gross platform revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Net Revenue USD", "slug": "netRevenueUsd", "description": "Net platform revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Misc Revenue USD", "slug": "miscRevenueUsd", "description": "Miscellaneous revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Buyback Expense USD", "slug": "buybackExpenseUsd", "description": "Card buyback expense in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Referral Expense USD", "slug": "referralExpenseUsd", "description": "Referral expense in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "GMV USD", "slug": "gmvUsd", "description": "Gross merchandise value in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Volume incl. Buybacks USD", "slug": "volumeInclBuybackUsd", "description": "Volume including platform buybacks in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Gacha Spend USD", "slug": "gachaSpendUsd", "description": "Net gacha (pack-opening) spend in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Credit Card Spend USD", "slug": "creditCardSpendUsd", "description": "Credit-card spend in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "New DAU", "slug": "dauNew", "description": "New daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Recurring DAU", "slug": "dauRecurring", "description": "Recurring daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Total DAU", "slug": "dauTotal", "description": "Total daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Marketplace Volume USD", "slug": "marketplaceVolumeUsd", "description": "Secondary-marketplace volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Organic Volume USD", "slug": "organicVolumeUsd", "description": "Marketplace volume excluding buybacks in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Buyback Volume USD", "slug": "buybackVolumeUsd", "description": "Marketplace buyback volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Sales Count", "slug": "salesCount", "description": "Marketplace sales count. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Unique Buyers", "slug": "uniqueBuyers", "description": "Unique marketplace buyers. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Top Sale USD", "slug": "topSaleUsd", "description": "Largest single sale of the day in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Marketplace Fees USD", "slug": "marketplaceFeesUsd", "description": "Marketplace fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Packs Opened", "slug": "packsOpened", "description": "Gacha packs opened, summed across tiers. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Gross Gacha Spend USD", "slug": "grossGachaSpendUsd", "description": "Gross gacha spend, summed across tiers, in USD. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d", "seriesCount": 8 } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } }, "/metrics/v2/protocols/tcg/{platformIdentifier}/metrics/overview/time-series/{granularity}": { "get": { "description": "Returns one TCG platform's history, one series per chain it runs on. Nothing is aggregated across a platform's chains: the daily-active-user and unique-buyer counts overlap between chains, so a cross-chain total would overstate them. Every series carries its platform and chain alongside the composite id, so no consumer has to split the id. Only the 1d granularity is available. A platform slug the TCG listing does not serve returns 404.", "operationId": "getTCGPlatformTimeSeriesWithGranularityV2", "parameters": [ { "description": "Blockworks Research platform slug, as returned in the id field of the TCG platform listing.", "in": "path", "name": "platformIdentifier", "required": true, "schema": { "type": "string", "example": "courtyard" } }, { "description": "Granularity", "in": "path", "name": "granularity", "required": true, "schema": { "enum": [ "1d" ], "type": "string", "example": "1d", "default": "1d" } }, { "description": "Time range start", "in": "query", "name": "start", "schema": { "type": "string", "example": "2026-08-01T00:00:00Z" } }, { "description": "Time range end", "in": "query", "name": "end", "schema": { "type": "string", "example": "2026-08-21T00:00:00Z" } } ], "security": [ { "apiKey": [] } ], "summary": "Get TCG Platform Time Series", "tags": [ "metrics/protocols/tcg" ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/TCGSeriesData" }, "error": { "type": "string" }, "metadata": { "$ref": "#/components/schemas/TCGSeriesMetadata" } }, "required": [ "data" ], "type": "object" }, "example": { "error": null, "data": { "series": [ { "id": "courtyard_polygon", "platform": "courtyard", "chain": "polygon", "points": [ [ 1785542400, 5019686.24, 1043157.63, 0, 3976528.61, null, 5206374.79, 9182903.4, 5020356.24, 1616203.1600000001, 7507, 8157, 15664, 186688.55, 186688.55, 0, 3248, 751, 6600, null, 145724, 8423839.32 ], [ 1785628800, 3996765.92, 804410.55, 0, 3192355.37, null, 4160657.81, 7353013.18, 3996902.92, 1316540.4100000001, 7965, 5942, 13907, 163891.89, 163891.89, 0, 3226, 727, null, null, 125453.99999999999, 6677128.43 ], [ 1785715200, 4120334.81, 917821.64, 0, 3202513.17, null, 4324841.69, 7527354.86, 4120384.81, 1217061.35, 9611, 5588, 15199, 204506.88, 204506.88, 0, 2695, 670, 11500, null, 122811.99999999999, 7023658.27 ], [ 1785801600, 3997818.01, 807187.42, 0, 3190630.59, null, 4190233.36, 7380863.949999999, 3997853.01, 1137967.6399999997, 11246, 5724, 16970, 192415.35, 192415.35, 0, 2726, 619, 21500, null, 122454, 6857703.38 ], [ 1785888000, 4079926.22, 930139.43, 0, 3149786.79, null, 4287724, 7437510.79, 4080420.22, 1234427.62, 5274, 5329, 10603, 207797.78, 207797.78, 0, 2512, 653, 19000, null, 108045.99999999999, 6925918.82 ] ] } ] }, "metadata": { "pointSchemas": [ { "name": "Timestamp", "slug": "time", "description": "Timestamp of the data point.", "is_timestamp": true }, { "name": "Gross Revenue USD", "slug": "grossRevenueUsd", "description": "Gross platform revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Net Revenue USD", "slug": "netRevenueUsd", "description": "Net platform revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Misc Revenue USD", "slug": "miscRevenueUsd", "description": "Miscellaneous revenue in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Buyback Expense USD", "slug": "buybackExpenseUsd", "description": "Card buyback expense in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Referral Expense USD", "slug": "referralExpenseUsd", "description": "Referral expense in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "GMV USD", "slug": "gmvUsd", "description": "Gross merchandise value in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Volume incl. Buybacks USD", "slug": "volumeInclBuybackUsd", "description": "Volume including platform buybacks in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Gacha Spend USD", "slug": "gachaSpendUsd", "description": "Net gacha (pack-opening) spend in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Credit Card Spend USD", "slug": "creditCardSpendUsd", "description": "Credit-card spend in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "New DAU", "slug": "dauNew", "description": "New daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Recurring DAU", "slug": "dauRecurring", "description": "Recurring daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Total DAU", "slug": "dauTotal", "description": "Total daily active users. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Marketplace Volume USD", "slug": "marketplaceVolumeUsd", "description": "Secondary-marketplace volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Organic Volume USD", "slug": "organicVolumeUsd", "description": "Marketplace volume excluding buybacks in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Buyback Volume USD", "slug": "buybackVolumeUsd", "description": "Marketplace buyback volume in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Sales Count", "slug": "salesCount", "description": "Marketplace sales count. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Unique Buyers", "slug": "uniqueBuyers", "description": "Unique marketplace buyers. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Top Sale USD", "slug": "topSaleUsd", "description": "Largest single sale of the day in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Marketplace Fees USD", "slug": "marketplaceFeesUsd", "description": "Marketplace fees in USD. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Packs Opened", "slug": "packsOpened", "description": "Gacha packs opened, summed across tiers. Sourced from Blockworks Research.", "is_timestamp": false }, { "name": "Gross Gacha Spend USD", "slug": "grossGachaSpendUsd", "description": "Gross gacha spend, summed across tiers, in USD. Sourced from Blockworks Research.", "is_timestamp": false } ], "granularity": "1d", "seriesCount": 1 } } } }, "description": "OK" }, "400": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Not Found" }, "500": { "content": { "application/json": { "schema": { "properties": { "data": {}, "error": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Internal Server Error" } } } } }, "components": { "schemas": { "metricsAsset": { "properties": { "allTimeHigh": { "$ref": "#/components/schemas/AssetATH" }, "category": { "type": "string" }, "contractAddresses": { "items": { "$ref": "#/components/schemas/ContractAddress" }, "type": "array" }, "description": { "type": "string" }, "id": { "type": "string" }, "links": { "items": { "$ref": "#/components/schemas/metricsLink" }, "type": "array" }, "marketData": { "$ref": "#/components/schemas/AssetMarketData" }, "name": { "type": "string" }, "networkSlugs": { "items": { "type": "string" }, "type": "array" }, "protocolSlugs": { "items": { "type": "string" }, "type": "array" }, "rank": { "format": "int64", "type": "integer" }, "returnOnInvestment": { "$ref": "#/components/schemas/AssetROI" }, "sector": { "type": "string" }, "slug": { "type": "string" }, "symbol": { "type": "string" }, "tags": { "items": { "type": "string" }, "type": "array" } }, "required": [ "allTimeHigh", "category", "contractAddresses", "description", "id", "links", "marketData", "name", "networkSlugs", "protocolSlugs", "returnOnInvestment", "sector", "slug", "symbol", "tags" ], "type": "object" }, "GetNetworksV2Response": { "properties": { "data": { "items": { "$ref": "#/components/schemas/NetworkV2" }, "type": "array" }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ], "type": "object" }, "TimeseriesCatalog": { "properties": { "datasets": { "items": { "$ref": "#/components/schemas/TimeseriesDataset" }, "type": "array" } }, "required": [ "datasets" ], "type": "object" }, "AssetComparisonItem": { "properties": { "allTimeHigh": { "$ref": "#/components/schemas/AssetATH" }, "category": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "returnOnInvestment": { "$ref": "#/components/schemas/AssetROI" }, "sector": { "type": "string" }, "slug": { "type": "string" }, "symbol": { "type": "string" }, "tags": { "items": { "type": "string" }, "type": "array" } }, "required": [ "category", "id", "name", "sector", "slug", "symbol", "tags" ], "type": "object" }, "GetStablecoinsResponse": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Stablecoin" }, "type": "array" }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ], "type": "object" }, "AssetListItem": { "properties": { "category": { "type": "string" }, "coveredByMonitoring": { "description": "True when Messari Monitoring **actively** covers this asset. Active coverage is an editorial decision about ongoing tracking, not a measure of historical presence \u2014 the active set is curated and changes over time. Historical developments may still be returnable from `/monitoring/v2/developments?assetIds=` for assets where this flag is `false`. Use this flag to scope to assets with current monitoring; do not infer historical coverage from it.", "type": "boolean" }, "firstPriceAt": { "description": "When the earliest price on record for the asset was observed. This marks the start of the price coverage of the asset. Null when no price is on record. The `hasMarketData` flag reports whether that coverage exists at all.", "format": "date-time", "nullable": true, "type": "string" }, "hasDiligence": { "type": "boolean" }, "hasFundraising": { "type": "boolean" }, "hasIntel": { "type": "boolean" }, "hasMarketData": { "description": "True when Messari covers market data for the asset. Use it to scope a listing to the assets that carry price, volume and marketcap values. The `firstPriceAt` field reports when that price coverage starts.", "type": "boolean" }, "hasNews": { "type": "boolean" }, "hasProposals": { "type": "boolean" }, "hasResearch": { "type": "boolean" }, "hasTokenUnlocks": { "type": "boolean" }, "id": { "type": "string" }, "name": { "type": "string" }, "rank": { "format": "double", "type": "number" }, "sector": { "type": "string" }, "slug": { "type": "string" }, "symbol": { "type": "string" }, "tags": { "items": { "type": "string" }, "type": "array" } }, "required": [ "category", "coveredByMonitoring", "hasDiligence", "hasFundraising", "hasIntel", "hasMarketData", "hasNews", "hasProposals", "hasResearch", "hasTokenUnlocks", "id", "name", "rank", "sector", "slug", "symbol", "tags" ], "type": "object" }, "metricsTimeseriesMetadata": { "properties": { "granularity": { "enum": [ "1m", "5m", "15m", "30m", "1h", "6h", "1d", "1w", "30d", "1q", "1y" ], "type": "string" }, "pointSchemas": { "items": { "$ref": "#/components/schemas/metricsPointSchema" }, "type": "array" } }, "required": [ "granularity", "pointSchemas" ], "type": "object" }, "TimeseriesData": { "properties": { "points": { "items": { "items": {}, "type": "array" }, "type": "array" } }, "required": [ "points" ], "type": "object" }, "Stablecoin": { "type": "object", "description": "Schema for Stablecoin", "properties": {}, "additionalProperties": true }, "AssetMarketData": { "type": "object", "description": "Latest prices, trailing volume, candles, supply and marketcap for an asset.", "properties": { "priceUsd": { "type": "number", "format": "double", "description": "Latest price of the asset, in USD." }, "priceBtc": { "type": "number", "format": "double", "description": "Latest price of the asset, denominated in BTC." }, "priceEth": { "type": "number", "format": "double", "description": "Latest price of the asset, denominated in ETH." }, "priceAt": { "type": "string", "format": "date-time", "nullable": true, "description": "When the latest price was recorded. Null when no price is on record for the asset." }, "firstPriceAt": { "type": "string", "format": "date-time", "nullable": true, "description": "When the earliest price on record for the asset was observed. This marks the start of the price coverage of the asset. Null when no price is on record." }, "volume24Hour": { "type": "number", "format": "double", "description": "Traded volume over the trailing 24 hours, in USD." }, "ohlcv1HourUsd": { "allOf": [ { "$ref": "#/components/schemas/OHLCV" } ], "description": "Candle over the trailing hour." }, "ohlcv24HourUsd": { "allOf": [ { "$ref": "#/components/schemas/OHLCV" } ], "description": "Candle over the trailing 24 hours." }, "ohlcvTodayUsd": { "allOf": [ { "$ref": "#/components/schemas/OHLCV" } ], "description": "Most recent daily candle." }, "supply": { "$ref": "#/components/schemas/Supply" }, "marketcap": { "$ref": "#/components/schemas/MarketCap" } } }, "OHLCV": { "type": "object", "description": "Open, high, low, close and volume over one window, in USD.", "properties": { "open": { "type": "number", "format": "double", "description": "Price at the start of the window." }, "high": { "type": "number", "format": "double", "description": "Highest price in the window." }, "low": { "type": "number", "format": "double", "description": "Lowest price in the window." }, "close": { "type": "number", "format": "double", "description": "Price at the end of the window, which is the latest price of the asset." }, "volume": { "type": "number", "format": "double", "description": "Traded volume in the window, in USD." } } }, "Supply": { "type": "object", "description": "Token supply of the asset.", "properties": { "circulating": { "type": "number", "format": "double", "description": "Tokens available to the market." }, "total": { "type": "number", "format": "double", "description": "Tokens that exist, minus the tokens burned." }, "max": { "type": "number", "format": "double", "description": "Tokens that can ever exist. Zero when the asset has no cap." } } }, "MarketCap": { "type": "object", "description": "Marketcap of the asset.", "properties": { "circulatingUsd": { "type": "number", "format": "double", "description": "Circulating supply valued at the latest price, in USD." }, "fullyDilutedUsd": { "type": "number", "format": "double", "description": "Total supply valued at the latest price, in USD." }, "dominance": { "type": "number", "format": "double", "description": "Percent of total crypto marketcap held by the asset." } } }, "metricsLink": { "type": "object", "description": "Schema for metricsLink", "properties": {}, "additionalProperties": true }, "AssetROI": { "type": "object", "description": "Schema for AssetROI", "properties": {}, "additionalProperties": true }, "AssetATH": { "type": "object", "description": "All-time high of an asset, and the cycle low that follows it.", "properties": { "allTimeHigh": { "type": "number", "format": "double", "description": "Highest price on record, in USD." }, "allTimeHighDate": { "type": "string", "format": "date-time", "nullable": true, "description": "When the asset reached its all-time high. Null when no price is on record." }, "allTimeHighTimeSinceSeconds": { "type": "number", "format": "double", "description": "Seconds since the all-time high." }, "allTimeHighPercentDown": { "type": "number", "format": "double", "description": "Percent the latest price sits below the all-time high." }, "breakevenMultiple": { "type": "number", "format": "double", "description": "Multiple the latest price must gain to return to the all-time high." }, "cycleLow": { "type": "number", "format": "double", "description": "Lowest price since the all-time high, in USD." }, "cycleLowDate": { "type": "string", "format": "date-time", "nullable": true, "description": "When the asset reached its cycle low. Null when no price is on record." }, "cycleLowTimeSinceSeconds": { "type": "number", "format": "double", "description": "Seconds since the cycle low." }, "cycleLowPercentUp": { "type": "number", "format": "double", "description": "Percent the latest price sits above the cycle low." } } }, "metricsPointSchema": { "type": "object", "description": "Schema for metricsPointSchema", "properties": {}, "additionalProperties": true }, "SnapshotListingMetadata": { "properties": { "page": { "format": "int64", "type": "integer", "description": "Current page number" }, "pageSize": { "format": "int64", "type": "integer", "description": "Number of results per page" }, "totalPages": { "format": "int64", "type": "integer", "description": "Total number of pages" }, "totalRows": { "format": "int64", "type": "integer", "description": "Total number of rows" } }, "required": [ "page", "pageSize", "totalPages", "totalRows" ], "type": "object", "description": "Pagination metadata" }, "ContractAddress": { "type": "object", "description": "Schema for ContractAddress", "properties": {}, "additionalProperties": true }, "NetworkV2": { "type": "object", "description": "Schema for NetworkV2", "properties": {}, "additionalProperties": true }, "TimeseriesDataset": { "type": "object", "description": "Schema for TimeseriesDataset", "properties": {}, "additionalProperties": true }, "MetricsPagination": { "properties": { "pageSize": { "format": "int64", "type": "integer" }, "page": { "format": "int64", "type": "integer" }, "totalPages": { "format": "int64", "type": "integer" }, "totalRows": { "format": "int64", "type": "integer" } }, "required": [ "pageSize", "page", "totalPages", "totalRows" ], "type": "object" }, "GetLendingMarketsResponse": { "properties": { "data": { "items": { "$ref": "#/components/schemas/LendingMarket" }, "type": "array" }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ], "type": "object" }, "LendingInstance": { "properties": { "chain": { "type": "string", "description": "Blockworks Research chain slug." }, "productSlug": { "type": "string", "description": "Blockworks Research product slug." } }, "required": [ "chain", "productSlug" ], "type": "object" }, "LendingMarket": { "properties": { "chain": { "type": "string", "description": "Blockworks Research chain slug." }, "marketId": { "type": "string", "description": "Composite market key: parent slug, product slug, chain and market key. Keyed on the pool address when one is present." }, "marketName": { "type": "string", "description": "Market name when the source reports one, otherwise the market key." }, "productSlug": { "type": "string", "description": "Blockworks Research product slug, for example aave-v3." }, "protocol": { "$ref": "#/components/schemas/LendingMarketProtocol" } }, "required": [ "chain", "marketId", "marketName", "productSlug", "protocol" ], "type": "object" }, "LendingMarketProtocol": { "properties": { "id": { "type": "string", "description": "Messari project id of the parent protocol." }, "name": { "type": "string", "description": "Name of the parent protocol." }, "slug": { "type": "string", "description": "Slug of the parent protocol. Pass it back as the protocol filter." } }, "required": [ "id", "name", "slug" ], "type": "object" }, "LendingSeriesData": { "properties": { "series": { "items": { "$ref": "#/components/schemas/LendingSeriesEntry" }, "type": "array" } }, "required": [ "series" ], "type": "object" }, "LendingSeriesEntry": { "properties": { "chain": { "type": "string", "description": "Blockworks Research chain slug." }, "id": { "type": "string", "description": "Composite series key: parent slug, product slug and chain, plus the market key for the lending-markets dataset." }, "marketName": { "type": "string", "description": "Market name. Present on the lending-markets dataset only." }, "points": { "items": { "items": {}, "type": "array" }, "type": "array", "description": "Rows of values. Read the column order from metadata.pointSchemas." }, "productSlug": { "type": "string", "description": "Blockworks Research product slug, for example aave-v3." } }, "required": [ "chain", "id", "points", "productSlug" ], "type": "object" }, "LendingSeriesMetadata": { "properties": { "granularity": { "type": "string" }, "pointSchemas": { "items": { "$ref": "#/components/schemas/metricsPointSchema" }, "type": "array" }, "seriesCount": { "format": "int64", "type": "integer", "description": "Number of series in the response." } }, "required": [ "granularity", "pointSchemas", "seriesCount" ], "type": "object" }, "ProtocolTimeseriesEntry": { "properties": { "points": { "items": { "items": {}, "type": "array" }, "type": "array" }, "protocol": { "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" } }, "type": "object" } }, "required": [ "protocol", "points" ], "type": "object" }, "NetworkTimeseriesEntry": { "properties": { "network": { "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" } }, "type": "object" }, "points": { "items": { "items": {}, "type": "array" }, "type": "array" } }, "required": [ "network", "points" ], "type": "object" }, "DATTreasuryMetrics": { "type": "object", "description": "A company's latest capital structure values. Every field is null where the company reports no value.", "properties": { "price": { "format": "double", "type": "number", "description": "Latest stock price in USD." }, "volumeUsd": { "format": "double", "type": "number", "description": "Dollar trading volume." }, "outstandingShares": { "format": "double", "type": "number", "description": "Shares currently issued and held by investors." }, "marketCap": { "format": "double", "type": "number", "description": "Stock price times outstanding shares, in USD." }, "enterpriseValue": { "format": "double", "type": "number", "description": "Market cap plus debt and preferred stock, minus cash, in USD." }, "fullyDilutedShares": { "format": "double", "type": "number", "description": "All shares if options, warrants and convertibles are exercised." }, "fullyDilutedValuation": { "format": "double", "type": "number", "description": "Stock price times fully diluted shares, in USD." }, "fullyDilutedEnterpriseValue": { "format": "double", "type": "number", "description": "Enterprise value on a fully diluted share basis, in USD." }, "cash": { "format": "double", "type": "number", "description": "Cash and equivalents on the balance sheet, in USD." }, "debt": { "format": "double", "type": "number", "description": "Total debt on the balance sheet, in USD." }, "preferredMarketCap": { "format": "double", "type": "number", "description": "Market value of preferred stock, in USD." }, "nav": { "format": "double", "type": "number", "description": "Net asset value: crypto holdings at market value, net of liabilities, in USD." }, "outstandingMnav": { "format": "double", "type": "number", "description": "Market cap divided by NAV, the premium or discount to crypto NAV on outstanding shares." }, "fullyDilutedMnav": { "format": "double", "type": "number", "description": "Fully diluted valuation divided by NAV." }, "outstandingEvMnav": { "format": "double", "type": "number", "description": "Enterprise value divided by NAV." }, "fullyDilutedEvMnav": { "format": "double", "type": "number", "description": "Fully diluted enterprise value divided by NAV." } } }, "DATHoldingsSummary": { "type": "object", "description": "Which crypto assets the company holds. Use it to see the by-asset coverage before calling the holdings endpoints.", "properties": { "assetSymbols": { "type": "array", "items": { "type": "string" }, "description": "Ticker symbols of the assets held, lower-case (for example btc). Each one is the suffix of a holdings series id." }, "count": { "format": "int64", "type": "integer", "description": "Number of assets held, and so the number of holdings series this company has." } }, "required": [ "assetSymbols", "count" ] }, "DAT": { "type": "object", "properties": { "id": { "type": "string", "description": "The company's stock ticker, which is also its treasury series key (for example MSTR)." }, "name": { "type": "string", "description": "Display name of the company." }, "slug": { "type": "string", "description": "URL slug of the company. Empty for a company with no Messari project mapping." }, "projectId": { "type": "string", "description": "Messari project id, where the company maps to one." }, "asOfTime": { "format": "int64", "type": "integer", "description": "Unix timestamp (seconds) of the point the treasury values were read from, or null where the company reported nothing in the last 30 days." }, "holdings": { "$ref": "#/components/schemas/DATHoldingsSummary" }, "treasury": { "$ref": "#/components/schemas/DATTreasuryMetrics" } }, "required": [ "id", "name", "slug", "holdings", "treasury" ] }, "GetDATsResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DAT" } }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ] }, "DATTimeseriesEntry": { "type": "object", "properties": { "dat": { "type": "object", "properties": { "id": { "type": "string", "description": "The company's stock ticker." }, "name": { "type": "string" }, "slug": { "type": "string" } }, "required": [ "id" ] }, "points": { "type": "array", "items": { "type": "array", "items": {} }, "description": "Points in the order metadata.pointSchemas declares. Empty for a company with no data in the window." } }, "required": [ "dat", "points" ] }, "DATHoldingTimeseriesEntry": { "type": "object", "properties": { "holding": { "type": "object", "properties": { "id": { "type": "string", "description": "Composite series key of company ticker and held asset (for example MSTR_btc)." }, "name": { "type": "string", "description": "Display name of the position." }, "companyTicker": { "type": "string", "description": "The holding company's stock ticker." }, "assetSymbol": { "type": "string", "description": "Ticker symbol of the held asset, lower-case. Carried per series so you do not have to parse the composite id." }, "networkSlug": { "type": "string", "description": "Slug of the held asset's network." } }, "required": [ "id", "companyTicker", "assetSymbol" ] }, "points": { "type": "array", "items": { "type": "array", "items": {} } } }, "required": [ "holding", "points" ] }, "ETFProviderMetrics": { "type": "object", "description": "An issuer's latest values, read from its most recent point in the last 30 days. Every field is null where the issuer reported no value. Sourced from Blockworks Research.", "properties": { "aumUsd": { "format": "double", "type": "number", "description": "Assets under management across the provider's crypto ETF products in USD.. Series slug `aum-usd`." }, "flowUsd": { "format": "double", "type": "number", "description": "Daily net flow across the provider's crypto ETF products in USD.. Series slug `flow-usd`." }, "numProducts": { "format": "double", "type": "number", "description": "Number of active products with positive AUM.. Series slug `num-products`." }, "weightedAumExpenseRatio": { "format": "double", "type": "number", "description": "AUM-weighted average expense ratio.. Series slug `weighted-aum-expense-ratio`." }, "bitcoinAumPerc": { "format": "double", "type": "number", "description": "Share of AUM in bitcoin products (0-1).. Series slug `bitcoin-aum-perc`." }, "spotAumPerc": { "format": "double", "type": "number", "description": "Share of AUM in delta-one (spot) products (0-1).. Series slug `spot-aum-perc`." }, "rolling30dFlowUsd": { "format": "double", "type": "number", "description": "Rolling 30-day net flow in USD.. Series slug `rolling-30d-flow-usd`." }, "aum30dChangePerc": { "format": "double", "type": "number", "description": "AUM change versus 30 days ago as a ratio.. Series slug `aum-30d-change-perc`." } } }, "ETFAssetMetrics": { "type": "object", "description": "An underlying asset's latest values, split by product type, by region and by strategy, read from its most recent point in the last 30 days. Every field is null where the asset reported no value. Sourced from Blockworks Research.", "properties": { "typeSpotAumUsd": { "format": "double", "type": "number", "description": "Spot product AUM in USD.. Series slug `type-spot-aum-usd`." }, "typeSpotFlowUsd": { "format": "double", "type": "number", "description": "Spot product daily net flow in USD.. Series slug `type-spot-flow-usd`." }, "typeSpotProductCount": { "format": "double", "type": "number", "description": "Number of spot products.. Series slug `type-spot-product-count`." }, "typeFuturesAumUsd": { "format": "double", "type": "number", "description": "Futures product AUM in USD.. Series slug `type-futures-aum-usd`." }, "typeFuturesFlowUsd": { "format": "double", "type": "number", "description": "Futures product daily net flow in USD.. Series slug `type-futures-flow-usd`." }, "typeFuturesProductCount": { "format": "double", "type": "number", "description": "Number of futures products.. Series slug `type-futures-product-count`." }, "typeSpotUnitedstatesAumUsd": { "format": "double", "type": "number", "description": "US spot product AUM in USD.. Series slug `type-spot-unitedstates-aum-usd`." }, "typeSpotUnitedstatesFlowUsd": { "format": "double", "type": "number", "description": "US spot product daily net flow in USD.. Series slug `type-spot-unitedstates-flow-usd`." }, "typeSpotUnitedstatesProductCount": { "format": "double", "type": "number", "description": "Number of US spot products.. Series slug `type-spot-unitedstates-product-count`." }, "typeSpotEuropeAumUsd": { "format": "double", "type": "number", "description": "European spot product AUM in USD.. Series slug `type-spot-europe-aum-usd`." }, "typeSpotEuropeFlowUsd": { "format": "double", "type": "number", "description": "European spot product daily net flow in USD.. Series slug `type-spot-europe-flow-usd`." }, "typeSpotEuropeProductCount": { "format": "double", "type": "number", "description": "Number of European spot products.. Series slug `type-spot-europe-product-count`." }, "typeSpotApacAumUsd": { "format": "double", "type": "number", "description": "APAC spot product AUM in USD.. Series slug `type-spot-apac-aum-usd`." }, "typeSpotApacFlowUsd": { "format": "double", "type": "number", "description": "APAC spot product daily net flow in USD.. Series slug `type-spot-apac-flow-usd`." }, "typeSpotApacProductCount": { "format": "double", "type": "number", "description": "Number of APAC spot products.. Series slug `type-spot-apac-product-count`." }, "strategyDeltaoneAumUsd": { "format": "double", "type": "number", "description": "Delta-one strategy AUM in USD.. Series slug `strategy-deltaone-aum-usd`." }, "strategyDeltaoneFlowUsd": { "format": "double", "type": "number", "description": "Delta-one strategy daily net flow in USD.. Series slug `strategy-deltaone-flow-usd`." }, "strategyDeltaoneProductCount": { "format": "double", "type": "number", "description": "Number of delta-one products.. Series slug `strategy-deltaone-product-count`." }, "strategyLeveragedAumUsd": { "format": "double", "type": "number", "description": "Leveraged strategy AUM in USD.. Series slug `strategy-leveraged-aum-usd`." }, "strategyLeveragedFlowUsd": { "format": "double", "type": "number", "description": "Leveraged strategy daily net flow in USD.. Series slug `strategy-leveraged-flow-usd`." }, "strategyLeveragedProductCount": { "format": "double", "type": "number", "description": "Number of leveraged products.. Series slug `strategy-leveraged-product-count`." }, "totalVolumeUsd": { "format": "double", "type": "number", "description": "Total traded volume in USD.. Series slug `total-volume-usd`." }, "volumeUnitedstatesUsd": { "format": "double", "type": "number", "description": "US traded volume in USD.. Series slug `volume-unitedstates-usd`." }, "volumeEuropeUsd": { "format": "double", "type": "number", "description": "European traded volume in USD.. Series slug `volume-europe-usd`." }, "volumeApacUsd": { "format": "double", "type": "number", "description": "APAC traded volume in USD.. Series slug `volume-apac-usd`." } } }, "ETFProvider": { "type": "object", "properties": { "id": { "type": "string", "description": "The issuer's Blockworks Research provider slug, which is also its series key (for example blackrock)." }, "name": { "type": "string", "description": "Display name." }, "slug": { "type": "string", "description": "Messari project slug of the issuer. An empty string where the issuer maps to no Messari project." }, "asOf": { "format": "int64", "type": "integer", "description": "Unix timestamp (seconds) of the point the latest values were read from, or null where nothing was reported in the last 30 days." }, "metrics": { "$ref": "#/components/schemas/ETFProviderMetrics" } }, "required": [ "id", "name", "slug", "metrics" ] }, "ETFAsset": { "type": "object", "properties": { "id": { "type": "string", "description": "The underlying crypto asset's symbol, which is also its series key (for example bitcoin)." }, "name": { "type": "string", "description": "Display name." }, "slug": { "type": "string", "description": "Messari network slug of the asset's chain. An empty string where the asset maps to no network." }, "asOf": { "format": "int64", "type": "integer", "description": "Unix timestamp (seconds) of the point the latest values were read from, or null where nothing was reported in the last 30 days." }, "metrics": { "$ref": "#/components/schemas/ETFAssetMetrics" } }, "required": [ "id", "name", "slug", "metrics" ] }, "GetETFProvidersResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ETFProvider" } }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ] }, "GetETFAssetsResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ETFAsset" } }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ] }, "ETFProviderTimeseriesEntry": { "type": "object", "properties": { "provider": { "type": "object", "properties": { "id": { "type": "string", "description": "The issuer's Blockworks Research provider slug, which is also its series key (for example blackrock)." }, "name": { "type": "string", "description": "Display name." }, "slug": { "type": "string", "description": "Messari project slug of the issuer. An empty string where the issuer maps to no Messari project." } }, "required": [ "id", "name", "slug" ] }, "points": { "type": "array", "items": { "type": "array", "items": {} }, "description": "Points in the order metadata.pointSchemas declares. Empty where the entity has no data in the window." } }, "required": [ "provider", "points" ] }, "ETFAssetTimeseriesEntry": { "type": "object", "properties": { "asset": { "type": "object", "properties": { "id": { "type": "string", "description": "The underlying crypto asset's symbol, which is also its series key (for example bitcoin)." }, "name": { "type": "string", "description": "Display name." }, "slug": { "type": "string", "description": "Messari network slug of the asset's chain. An empty string where the asset maps to no network." } }, "required": [ "id", "name", "slug" ] }, "points": { "type": "array", "items": { "type": "array", "items": {} }, "description": "Points in the order metadata.pointSchemas declares. Empty where the entity has no data in the window." } }, "required": [ "asset", "points" ] }, "ETFTimeseriesDataset": { "type": "object", "properties": { "grain": { "type": "string", "enum": [ "providers", "assets" ], "description": "Which collection the dataset belongs to. The two grains are independent cuts of the same data, so both publish the same dataset slug under different collections." }, "slug": { "type": "string", "description": "Dataset slug, as it appears in the time series paths." }, "granularities": { "type": "array", "items": { "type": "string" }, "description": "Granularities the dataset serves." }, "metrics": { "type": "array", "items": { "$ref": "#/components/schemas/metricsPointSchema" }, "description": "One entry per column of a point, in point order. The first is always the timestamp." } }, "required": [ "grain", "slug", "granularities", "metrics" ] }, "ETFTimeseriesCatalog": { "type": "object", "properties": { "datasets": { "type": "array", "items": { "$ref": "#/components/schemas/ETFTimeseriesDataset" } } }, "required": [ "datasets" ] }, "TCGPlatformChain": { "type": "object", "description": "One chain a TCG platform runs on.", "properties": { "id": { "type": "string", "description": "The series key of the platform-chain pair (for example courtyard_polygon). This is the id every TCG time series entry carries, so the listing and the series join on it without either side parsing the composite." }, "chain": { "type": "string", "description": "Blockworks Research chain slug the platform operates on." }, "networkSlug": { "type": "string", "nullable": true, "description": "Messari network slug of the chain. Null where the chain maps to no Messari network." } }, "required": [ "id", "chain", "networkSlug" ] }, "TCGPlatform": { "type": "object", "description": "One trading-card and collectibles platform, with every chain it runs on.", "properties": { "id": { "type": "string", "description": "The platform's Blockworks Research slug (for example courtyard). This is the platformIdentifier the platform time series route takes." }, "name": { "type": "string", "description": "Display name of the platform." }, "projectSlug": { "type": "string", "nullable": true, "description": "Messari project slug of the platform. Null where the platform maps to no Messari project." }, "chains": { "type": "array", "items": { "$ref": "#/components/schemas/TCGPlatformChain" }, "description": "Every chain the platform runs on. Most platforms have exactly one; the array is the shape regardless, so a consumer never special-cases the multi-chain platforms." } }, "required": [ "id", "name", "projectSlug", "chains" ] }, "GetTCGPlatformsResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/TCGPlatform" } }, "metadata": { "$ref": "#/components/schemas/SnapshotListingMetadata" } }, "required": [ "data", "metadata" ] }, "TCGSeriesEntry": { "type": "object", "description": "One platform-chain time series.", "properties": { "id": { "type": "string", "description": "Composite series key of platform and chain (for example courtyard_polygon). It matches the id of the corresponding entry in the platform listing's chains array." }, "platform": { "type": "string", "description": "Blockworks Research platform slug, served alongside the composite id so it never has to be parsed out of it." }, "chain": { "type": "string", "description": "Blockworks Research chain slug, served alongside the composite id so it never has to be parsed out of it." }, "points": { "type": "array", "items": { "type": "array", "items": {} }, "description": "Rows of values, in the order metadata.pointSchemas declares. Empty where the platform-chain pair has no data in the window." } }, "required": [ "id", "platform", "chain", "points" ] }, "TCGSeriesData": { "type": "object", "properties": { "series": { "type": "array", "items": { "$ref": "#/components/schemas/TCGSeriesEntry" } } }, "required": [ "series" ] }, "TCGSeriesMetadata": { "type": "object", "description": "One shared pointSchemas array covers every series in the response.", "properties": { "pointSchemas": { "type": "array", "items": { "$ref": "#/components/schemas/metricsPointSchema" }, "description": "One entry per column of a point, in point order. The first is always the timestamp." }, "granularity": { "type": "string" }, "seriesCount": { "type": "integer", "format": "int64", "description": "Number of series in the response." } }, "required": [ "pointSchemas", "granularity", "seriesCount" ] } }, "securitySchemes": { "apiKey": { "in": "header", "name": "X-Messari-API-Key", "type": "apiKey" } } } }