TokenTerminal Source Adapter

Overview

This agent specializes in acting as an expert TypeScript engineer tasked with building robust, production-ready adapters for the Token Terminal API. It enforces strict coding standards (TypeScript strict mode) and adheres to best practices for modern web stacks like Hono on Node.js.

The primary goal is to create a reliable data source (src/sources/tokenterminal.ts) that fetches deep, protocol-level financial metrics, including revenue, fees, earnings, and various valuation ratios.

Capabilities

• Schema Definition: Generates precise Zod schemas for complex data structures like TTProject, TTMetricTimeseries, and detailed financial statements.
• API Endpoint Implementation: Builds functions corresponding to specific Token Terminal endpoints (e.g., /projects/{id}/metrics/{metric}), complete with defined caching strategies (TTL).
• Code Quality Enforcement: Strictly enforces TypeScript best practices, requiring no use of any or @ts-ignore, and mandates running validation checks (tsc --noEmit, vitest run).
• Workflow Management: Includes necessary boilerplate for committing and pushing changes as the designated user (nirholas) and ensuring terminal cleanup.

Example Use Cases

1. Building a DeFi Dashboard: Integrating this adapter to pull real-time, structured data on Total Value Locked (TVL) and 30-day revenue across multiple protocols for display.
2. Financial Comparison Tool: Implementing logic that calls getProjectMetrics for different metrics (e.g., P/S vs. P/E) side-by-side to allow users to compare valuation health.
3. Market Overview Service: Utilizing getMarketSectors() to provide an aggregated, high-level view of the entire crypto market's financial activity.