crypto-market-data-service-guide

What problem does it solve?

This guide solves the challenge of building a dependable crypto market data layer by coordinating pricing, OHLCV, token metadata, and real-time updates with production-grade resiliency.

Core Features & Use Cases

• Clean multi-source market data APIs: Retrieve token prices, candles (OHLCV), and detailed market metrics using a primary source with an ordered fallback chain.
• Production resiliency: Add caching, rate limiting, queueing strategies, and WebSocket subscriptions to reduce latency and prevent upstream throttling.
• Practical DeFi workflows: Power portfolio value calculations, price charts in chat, coin-query tools, and price alert engines that require consistent data.

Quick Start

Instantiate the MarketDataService with CoinGecko as the primary source, a fallback list (CoinMarketCap and DeFi Llama), a 1-minute cache TTL, and a 30 requests per minute rate limit.