@cryptoquant_official/mcp 0.0.1

package/dist/cache/storage.js

@@ -0,0 +1,140 @@
+/**
+ * Cache storage operations for discovery response caching
+ */
+import { homedir } from "os";
+import { join } from "path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, chmodSync } from "fs";
+import { CACHE_VERSION, CACHE_TTL_DAYS, } from "./types.js";
+const CACHE_DIR = join(homedir(), ".cryptoquant");
+const CACHE_FILE = join(CACHE_DIR, "discovery-cache.json");
+/**
+ * Get cache file path.
+ */
+export function getCacheFilePath(_apiUrl) {
+    return CACHE_FILE;
+}
+/**
+ * Check if cache is still valid (not expired and version matches).
+ */
+export function isCacheValid(cache, apiUrl, apiKeyPrefix) {
+    // Version check
+    if (cache.version !== CACHE_VERSION) {
+        return false;
+    }
+    // API URL must match
+    if (cache.metadata.api_url !== apiUrl) {
+        return false;
+    }
+    // API key prefix must match (detects account switch)
+    if (cache.metadata.api_key_prefix !== apiKeyPrefix) {
+        return false;
+    }
+    // TTL check
+    const expiresAt = new Date(cache.metadata.expires_at);
+    if (isNaN(expiresAt.getTime()) || expiresAt < new Date()) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Read cache from file.
+ * Returns null if cache doesn't exist or is invalid JSON.
+ */
+export function readCache(apiUrl) {
+    const cachePath = getCacheFilePath(apiUrl);
+    try {
+        if (!existsSync(cachePath)) {
+            return null;
+        }
+        const data = JSON.parse(readFileSync(cachePath, "utf-8"));
+        // Basic structure validation
+        if (!data.version || !data.metadata || !data.raw_response || !data.summary) {
+            return null;
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write cache to file with secure permissions.
+ */
+export function writeCache(apiUrl, apiKey, rawResponse, parsed, summary, plan) {
+    // Ensure directory exists
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true, mode: 0o700 });
+    }
+    const now = new Date();
+    const expiresAt = new Date(now);
+    expiresAt.setDate(expiresAt.getDate() + CACHE_TTL_DAYS);
+    const cache = {
+        version: CACHE_VERSION,
+        metadata: {
+            api_url: apiUrl,
+            api_key_prefix: apiKey.slice(0, 8),
+            cached_at: now.toISOString(),
+            expires_at: expiresAt.toISOString(),
+            plan,
+        },
+        raw_response: rawResponse,
+        parsed,
+        summary,
+    };
+    const cachePath = getCacheFilePath(apiUrl);
+    writeFileSync(cachePath, JSON.stringify(cache, null, 2), { encoding: "utf-8" });
+    chmodSync(cachePath, 0o600);
+}
+/**
+ * Delete cache file.
+ */
+export function invalidateCache(apiUrl) {
+    const cachePath = getCacheFilePath(apiUrl);
+    try {
+        if (existsSync(cachePath)) {
+            unlinkSync(cachePath);
+        }
+    }
+    catch {
+        // Already deleted or inaccessible
+    }
+}
+/**
+ * Delete the cache file.
+ */
+export function clearAllCaches() {
+    try {
+        if (existsSync(CACHE_FILE)) {
+            unlinkSync(CACHE_FILE);
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Calculate cache age in days.
+ */
+export function getCacheAgeDays(cache) {
+    const cachedAt = new Date(cache.metadata.cached_at);
+    const now = new Date();
+    const diffMs = now.getTime() - cachedAt.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+/**
+ * Get human-readable cache status string.
+ */
+export function getCacheStatus(cache, fromCache) {
+    if (!fromCache || !cache) {
+        return "fresh";
+    }
+    const days = getCacheAgeDays(cache);
+    return `cached (${days}d old)`;
+}
+/**
+ * Get cache file path for user display.
+ */
+export function getCachePath() {
+    return CACHE_DIR;
+}
+//# sourceMappingURL=storage.js.map

package/dist/cache/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/cache/storage.ts"],"names":[],"mappings":"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"}

package/dist/cache/summary.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Summary generation for cached discovery data
+ */
+import type { DiscoverySummaryData, MyDiscoveryRawResponse } from "./types.js";
+import type { PlanLimits } from "../plan-limits.js";
+/**
+ * Generate summary from parsed plan limits.
+ * Counts endpoints and organizes by asset/category.
+ */
+export declare function generateSummary(limits: PlanLimits | null, statics: string[]): DiscoverySummaryData;
+/**
+ * Extract raw response structure for caching.
+ * Only keeps necessary fields.
+ */
+export declare function extractRawResponse(apiResponse: Record<string, unknown>): MyDiscoveryRawResponse | null;
+//# sourceMappingURL=summary.d.ts.map

package/dist/cache/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/cache/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAiElG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,sBAAsB,GAAG,IAAI,CAqB/B"}

package/dist/cache/summary.js

@@ -0,0 +1,85 @@
+/**
+ * Summary generation for cached discovery data
+ */
+/**
+ * Generate summary from parsed plan limits.
+ * Counts endpoints and organizes by asset/category.
+ */
+export function generateSummary(limits, statics) {
+    const assetData = new Map();
+    // Count endpoints from limits
+    if (limits) {
+        for (const [asset, categories] of Object.entries(limits)) {
+            if (!assetData.has(asset)) {
+                assetData.set(asset, { endpoint_count: 0, categories: new Set() });
+            }
+            const data = assetData.get(asset);
+            for (const [category, metrics] of Object.entries(categories)) {
+                data.categories.add(category);
+                if (metrics) {
+                    data.endpoint_count += Object.keys(metrics).length;
+                }
+            }
+        }
+    }
+    // Count static endpoints (parse asset from path)
+    for (const staticPath of statics) {
+        const parts = staticPath.split("/");
+        if (parts.length >= 4) {
+            const asset = parts[2];
+            const category = parts[3];
+            if (!assetData.has(asset)) {
+                assetData.set(asset, { endpoint_count: 0, categories: new Set() });
+            }
+            const data = assetData.get(asset);
+            data.endpoint_count++;
+            data.categories.add(category);
+        }
+    }
+    // Build summary
+    const assets = [];
+    const categoryByAsset = {};
+    let totalEndpoints = 0;
+    for (const [asset, data] of assetData.entries()) {
+        assets.push({
+            name: asset,
+            endpoint_count: data.endpoint_count,
+            categories: Array.from(data.categories).sort(),
+        });
+        categoryByAsset[asset] = Array.from(data.categories).sort();
+        totalEndpoints += data.endpoint_count;
+    }
+    // Sort assets alphabetically
+    assets.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        total_endpoints: totalEndpoints,
+        assets,
+        category_by_asset: categoryByAsset,
+    };
+}
+/**
+ * Extract raw response structure for caching.
+ * Only keeps necessary fields.
+ */
+export function extractRawResponse(apiResponse) {
+    try {
+        const apiEndpoint = apiResponse.apiEndpoint;
+        const plan = apiResponse.plan;
+        const apiRateLimit = apiResponse.apiRateLimit;
+        if (!apiEndpoint || typeof apiEndpoint !== "object") {
+            return null;
+        }
+        return {
+            apiEndpoint: apiEndpoint,
+            plan: { name: plan?.name || "unknown" },
+            apiRateLimit: {
+                token: apiRateLimit?.token || 0,
+                window: apiRateLimit?.window || "day",
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=summary.js.map

package/dist/cache/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/cache/summary.ts"],"names":[],"mappings":"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"}

package/dist/cache/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Cache schema types for CryptoQuant discovery caching
+ */
+import type { UserPlan, ApiRateLimit, PlanLimits } from "../plan-limits.js";
+export declare const CACHE_VERSION = 1;
+export declare const CACHE_TTL_DAYS = 7;
+/**
+ * Raw API response structure from /my/discovery/endpoints
+ */
+export interface MyDiscoveryRawResponse {
+    apiEndpoint: Record<string, unknown>;
+    plan: {
+        name: string;
+    };
+    apiRateLimit: {
+        token: number;
+        window: string;
+    };
+}
+/**
+ * Summary data generated from the raw response
+ */
+export interface DiscoverySummaryData {
+    total_endpoints: number;
+    assets: Array<{
+        name: string;
+        endpoint_count: number;
+        categories: string[];
+    }>;
+    category_by_asset: Record<string, string[]>;
+}
+/**
+ * Cache metadata for validation
+ */
+export interface CacheMetadata {
+    api_url: string;
+    api_key_prefix: string;
+    cached_at: string;
+    expires_at: string;
+    plan: UserPlan;
+}
+/**
+ * Full cache schema stored in file
+ */
+export interface DiscoveryCacheSchema {
+    version: typeof CACHE_VERSION;
+    metadata: CacheMetadata;
+    raw_response: MyDiscoveryRawResponse;
+    parsed: {
+        limits: PlanLimits | null;
+        statics: string[];
+        apiRateLimit: ApiRateLimit | null;
+    };
+    summary: DiscoverySummaryData;
+}
+/**
+ * Compact response format for initialize() tool
+ */
+export interface CompactInitializeResponse {
+    success: boolean;
+    session: {
+        plan: UserPlan;
+        rate_limit: string;
+        cache_status: string;
+    };
+    scope: {
+        total_endpoints: number;
+        accessible: number;
+        assets: Record<string, {
+            endpoints: number;
+            categories: number;
+        }>;
+        note: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5E,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC,CAAC;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,aAAa,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,sBAAsB,CAAC;IACrC,MAAM,EAAE;QACN,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;YACE,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;SACpB,CACF,CAAC;QACF,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/cache/types.js

@@ -0,0 +1,6 @@
+/**
+ * Cache schema types for CryptoQuant discovery caching
+ */
+export const CACHE_VERSION = 1;
+export const CACHE_TTL_DAYS = 7;
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Centralized configuration for CryptoQuant MCP Server
+ *
+ * API URL Priority:
+ * 1. CRYPTOQUANT_API_URL environment variable (optional override)
+ * 2. Default production URL
+ */
+/**
+ * Get the configured API URL.
+ * Returns the base URL with /v1 suffix (e.g., "https://api.cryptoquant.com/v1")
+ */
+export declare function getApiUrl(): string;
+/**
+ * Get the API base URL without version suffix.
+ * Returns the base URL (e.g., "https://api.cryptoquant.com")
+ */
+export declare function getApiBaseUrl(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/config.js

@@ -0,0 +1,23 @@
+/**
+ * Centralized configuration for CryptoQuant MCP Server
+ *
+ * API URL Priority:
+ * 1. CRYPTOQUANT_API_URL environment variable (optional override)
+ * 2. Default production URL
+ */
+const DEFAULT_API_URL = "https://api.cryptoquant.com/v1";
+/**
+ * Get the configured API URL.
+ * Returns the base URL with /v1 suffix (e.g., "https://api.cryptoquant.com/v1")
+ */
+export function getApiUrl() {
+    return process.env.CRYPTOQUANT_API_URL || DEFAULT_API_URL;
+}
+/**
+ * Get the API base URL without version suffix.
+ * Returns the base URL (e.g., "https://api.cryptoquant.com")
+ */
+export function getApiBaseUrl() {
+    return getApiUrl().replace(/\/v1$/, "");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,eAAe,GAAG,gCAAgC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,eAAe,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/data/metrics.toon

@@ -0,0 +1,58 @@
+# Metric Descriptions for describe_metric() tool
+# Format: TOON (Token-Oriented Object Notation)
+# Schema: id, name, category, asset, description, thresholds, interpretation
+
+metrics[50]{id,name,category,asset,description,thresholds,interpretation}:
+
+# Market Indicators - BTC
+mvrv,Market Value to Realized Value,market-indicator,btc,Compares current market cap to realized cap (aggregate cost basis of all coins),<1 undervalued|1-2.5 neutral|2.5-3.7 overheated|>3.7 extreme top,Primary cycle indicator. Values below 1 historically mark accumulation zones. Values above 3.7 indicate cycle tops.
+nupl,Net Unrealized Profit/Loss,market-indicator,btc,Percentage of coins in profit or loss relative to total market cap,<0 capitulation|0-0.25 hope|0.25-0.5 belief|0.5-0.75 optimism|>0.75 euphoria,Sentiment gauge. Extreme values (below 0 or above 0.75) often precede major reversals.
+sopr,Spent Output Profit Ratio,market-indicator,btc,Ratio of price sold to price paid for coins moved on-chain,<1 selling at loss|=1 breakeven|>1 selling at profit,Real-time profit/loss behavior. SOPR=1 often acts as support in bull markets resistance in bear markets.
+asopr,Adjusted SOPR,market-indicator,btc,SOPR excluding coins younger than 1 hour to filter noise,<1 loss realization|>1 profit taking,More accurate than raw SOPR for trend analysis. Filters out exchange-related movements.
+realized-price,Realized Price,market-indicator,btc,Average acquisition price of all BTC based on when each coin last moved,N/A - use as reference price,Aggregate cost basis. Price below realized price = most holders in loss (capitulation zone).
+puell-multiple,Puell Multiple,market-indicator,btc,Daily miner revenue divided by 365-day moving average revenue,<0.5 undervalued|0.5-4 neutral|>4 overheated,Miner profitability indicator. Low values indicate miner stress high values indicate excess profitability.
+
+# Market Indicators - ETH
+eth-mvrv,Market Value to Realized Value (ETH),market-indicator,eth,Compares ETH market cap to realized cap,<1 undervalued|1-2 neutral|>2 overheated,ETH valuation indicator. Similar interpretation to BTC MVRV but with different threshold ranges.
+
+# Exchange Flows - BTC
+netflow,Exchange Netflow,exchange-flows,btc,Net flow of BTC into (positive) or out of (negative) exchanges,positive sell pressure|negative accumulation,Key supply dynamics indicator. Sustained outflows suggest accumulation sustained inflows suggest distribution.
+reserve,Exchange Reserve,exchange-flows,btc,Total BTC held across all tracked exchanges,increasing distribution|decreasing accumulation,Long-term trend indicator. Declining reserves bullish for price (less liquid supply).
+inflow,Exchange Inflow,exchange-flows,btc,Total BTC deposited to exchanges,high inflow potential sell pressure,Immediate selling potential. Large inflows may precede price drops.
+outflow,Exchange Outflow,exchange-flows,btc,Total BTC withdrawn from exchanges,high outflow accumulation,Accumulation signal. Large outflows suggest coins moving to cold storage.
+exchange-whale-ratio,Exchange Whale Ratio,exchange-flows,btc,Ratio of top 10 inflow transactions to total inflows,>0.9 whale dominated|<0.5 retail dominated,Who is moving coins. High ratio means large players dominating exchange activity.
+
+# Exchange Flows - ETH
+eth-netflow,Exchange Netflow (ETH),exchange-flows,eth,Net flow of ETH into or out of exchanges,positive sell pressure|negative accumulation,ETH supply dynamics. Same interpretation as BTC netflow.
+eth-reserve,Exchange Reserve (ETH),exchange-flows,eth,Total ETH held on exchanges,increasing distribution|decreasing accumulation,ETH long-term supply trend.
+
+# Derivatives Data
+funding-rates,Funding Rates,market-data,btc,Periodic payment between long and short perpetual swap holders,<0 bearish bias|0-0.03% neutral|>0.1% extreme bullish,Leverage sentiment. Extreme positive rates often precede corrections.
+open-interest,Open Interest,market-data,btc,Total value of outstanding derivative contracts,rising with price continuation|falling unwinding,Position buildup indicator. Rising OI with rising price = new money entering. Falling OI = positions closing.
+long-short-ratio,Long/Short Ratio,market-data,btc,Ratio of accounts holding long vs short positions,>1 more longs|<1 more shorts,Retail positioning. Can be contrarian - extreme ratios often precede reversals.
+liquidations,Liquidations,market-data,btc,Value of forced position closures,high liquidations volatility and trend exhaustion,Leverage washout. Large liquidation events often mark local tops or bottoms.
+
+# Miner Flows
+miner-netflow,Miner Netflow,miner-flows,btc,Net flow from miner wallets to exchanges (positive = selling),positive miner selling|negative miner accumulating,Miner behavior. Sustained miner selling can add supply pressure. Miner accumulation bullish.
+hashrate,Hash Rate,network-indicator,btc,Total computational power securing the Bitcoin network,rising network growth|falling miner stress,Network health. Declining hashrate may indicate miner capitulation.
+difficulty,Mining Difficulty,network-indicator,btc,Computational difficulty of mining a block,rising competition|falling capitulation,Mining economics. Difficulty adjustments follow hashrate changes.
+
+# Network Indicators
+active-addresses,Active Addresses,network-indicator,btc,Number of unique addresses transacting daily,rising adoption|falling reduced activity,Network usage proxy. More active addresses = more organic usage.
+transaction-count,Transaction Count,network-indicator,btc,Number of on-chain transactions per day,rising demand|falling reduced usage,Network demand. High transaction counts indicate active usage.
+nvt-ratio,NVT Ratio,network-indicator,btc,Network Value to Transactions ratio (market cap / daily tx volume),high overvalued|low undervalued,Valuation vs usage. High NVT suggests price outpacing network activity.
+
+# Stablecoin Data
+stablecoin-supply,Stablecoin Supply Ratio,stablecoin,btc,Ratio of stablecoin market cap to BTC market cap,high buying power|low limited firepower,Dry powder indicator. High ratio = lots of stables ready to buy BTC.
+usdt-exchange-reserve,USDT Exchange Reserve,stablecoin,stablecoin,USDT held on exchanges,increasing ready to buy|decreasing deployed or withdrawn,Immediate buying potential. Rising USDT reserves suggest incoming demand.
+
+# ETH Specific
+eth-staking-rate,ETH Staking Rate,network-indicator,eth,Percentage of ETH supply staked in beacon chain,high reduced liquid supply|low more tradeable,ETH supply dynamics. Higher staking = less sell pressure.
+eth-validator-count,Validator Count,network-indicator,eth,Number of active Ethereum validators,rising network security|falling concerning,Network participation. More validators = more decentralized and secure.
+eth-gas-used,Gas Used,network-indicator,eth,Total gas consumed in transactions,high network congestion|low low activity,Network demand. High gas usage indicates strong demand for block space.
+
+# Advanced Metrics
+sthr-sopr,Short-Term Holder SOPR,market-indicator,btc,SOPR for coins held less than 155 days,<1 STH capitulation|>1 STH profit taking,Recent buyer behavior. STH panic often marks local bottoms.
+lth-sopr,Long-Term Holder SOPR,market-indicator,btc,SOPR for coins held more than 155 days,rarely below 1 LTH selling at loss is extreme|high profit taking at tops,Diamond hands behavior. LTH selling at loss is historically rare and marks deep capitulation.
+supply-in-profit,Supply in Profit,market-indicator,btc,Percentage of circulating supply currently in profit,<50% capitulation zone|>95% euphoria zone,Market-wide profit state. Extreme readings mark cycle phases.
+coin-days-destroyed,Coin Days Destroyed,network-indicator,btc,Sum of coins multiplied by days held when moved,spike old coins moving (distribution)|low hodling,Old money movement. CDD spikes often occur at market tops as long-term holders distribute.

package/dist/discovery.d.ts

@@ -0,0 +1,70 @@
+export interface EndpointParameter {
+    [paramName: string]: string[];
+}
+export interface DiscoveryEndpoint {
+    path: string;
+    parameters: EndpointParameter;
+    required_parameters: string[];
+}
+export interface DiscoveryResponse {
+    status: {
+        code: number;
+        message: string;
+    };
+    result: {
+        data: DiscoveryEndpoint[];
+    };
+}
+export interface ParsedEndpoint {
+    path: string;
+    asset: string;
+    category: string;
+    metric: string;
+    parameters: EndpointParameter;
+    required_parameters: string[];
+}
+export interface EndpointCatalog {
+    endpoints: ParsedEndpoint[];
+    assets: string[];
+    categories: string[];
+    byAsset: Map<string, ParsedEndpoint[]>;
+    byCategory: Map<string, ParsedEndpoint[]>;
+    byAssetCategory: Map<string, ParsedEndpoint[]>;
+    fetched_at: number;
+}
+export declare function fetchDiscoveryEndpoints(apiKey: string, apiUrl: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function getEndpointCatalog(): EndpointCatalog | null;
+export declare function isDiscoveryLoaded(): boolean;
+export declare function searchEndpoints(options: {
+    asset?: string;
+    category?: string;
+    query?: string;
+}): ParsedEndpoint[];
+export declare function getEndpointByPath(path: string): ParsedEndpoint | undefined;
+export declare function validateEndpointParams(endpoint: ParsedEndpoint, params: Record<string, unknown>): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function getParameterOptions(path: string): {
+    parameters: EndpointParameter;
+    required: string[];
+} | null;
+export interface DiscoverySummary {
+    total_endpoints: number;
+    assets: {
+        name: string;
+        count: number;
+    }[];
+    categories: {
+        name: string;
+        count: number;
+    }[];
+    fetched_at: string | null;
+}
+export declare function getDiscoverySummary(): DiscoverySummary | null;
+export declare function getAssetCategoryMap(): Record<string, string[]> | null;
+export declare function resetDiscovery(): void;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,CAAC;IAC9B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,iBAAiB,CAAC;IAC9B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAC1C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B/C;AAsDD,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE3D;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAmBD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,cAAc,EAAE,CAWnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAmBtC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAI9G;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAe7D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAUrE;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC"}