# MetaDuro > Quantitative asset analysis platform providing strategy backtests, seasonal trend evaluations, and technical charting for cryptocurrencies, equities, commodities, and futures. ## What MetaDuro Does - Quantitative seasonal trend analysis across multiple timeframes (1M, 1W, 1D, 4H, 1H) - Algorithmic strategy backtesting and historical performance metrics (Win Rate, Profit Factor, Sharpe Ratio, R², Max Drawdown, CAGR) - Real-time technical charting and data-driven market insights - Free educational research, trade breakdown videos, and verified broker discounts ## Covered Markets - Cryptocurrencies: Bitcoin (BTC), Ethereum (ETH), Solana (SOL), XRP, BNB, and leading altcoins - Traditional Assets: S&P 500 (SPY, SPX), DAX, NASDAQ, Gold (XAUUSD), Silver, and commodity futures ## Key Pages & URL Structures - [Platform Homepage](https://metaduro.com): Main entry point for quantitative crypto, equity, and commodity analytics. - [Seasonal Analysis Engine](https://metaduro.com/seasonal): Interactive seasonality analysis across weekdays, days, months, and years. - [Seasonal Backtest Records](https://metaduro.com/seasonal/SPY-November-Seasonality-Year-End-Strength-19932026-AMEX-Backtest-u-yzrh1t): Example public seasonal backtest record (`https://metaduro.com/seasonal/{slug}`). - [Seasonal Directory & Explore](https://metaduro.com/seasonal/browse): Searchable catalog of seasonal market anomalies and historical backtests. - [Multi-Asset Seasonal Screener](https://metaduro.com/seasonal/multi-asset): Cross-asset seasonality scanner for market baskets. - [Strategy Backtesting](https://metaduro.com/strategy): Systematic trading strategy builder and backtester (`https://metaduro.com/strategy/{slug}`). - [Strategy Directory](https://metaduro.com/strategy/browse): Public library of backtested quantitative trading strategies. - [Bitcoin Halving & Cycles](https://metaduro.com/bitcoin): Bitcoin halving epochs, supply disinflation metrics, and 4-year cycle analysis. - [Partner Bonuses & Fee Discounts](https://metaduro.com/bonus): Verified exchange sign-up bonuses and trading fee discounts. - [Research Videos](https://metaduro.com/video): Quantitative strategy breakdowns and market research videos. - [Blog & Market Studies](https://metaduro.com/blog): In-depth quantitative market studies and trading guides. - [Frequently Asked Questions](https://metaduro.com/faq): Answers to common questions on seasonality, backtesting, and platform usage. - [About MetaDuro](https://metaduro.com/about): Platform methodology, quantitative research pillars, and mission. - [Terms of Service](https://metaduro.com/terms): Platform terms and conditions of use. - [Privacy Policy](https://metaduro.com/privacy): Data privacy and protection policy. - [Impressum & Legal Notice](https://metaduro.com/impressum): Legal disclosure and contact information. ## Core Metrics Definitions & API Fields When querying `/api/data/seasonality`, `/api/data/scan`, or `/api/seasonal/{slug}`, the summary rows (`tblSum.rows`, `tbl.rows`) return quantitative metrics keyed by short identifiers: - `perfm`: Monthly Performance (%) — average expanding mean return per monthly holding cycle or trade. - `pfac`: Profit Factor — ratio of gross profits to gross losses (sum gains / sum losses). Values >1.5 indicate a robust statistical edge. - `sr`: Sharpe Ratio — annualized excess return per unit of volatility (risk-adjusted return metric). - `sor`: Sortino Ratio — downside risk-adjusted return ratio penalizing only negative return deviation. - `r2`: Linearity Score (0.0 to 1.0) — coefficient of determination (R²) measuring consistency and smoothness of the cumulative ROI trend. - `roi`: Return on Investment (%) — total cumulative percentage return across the backtest period. - `cagr`: Compound Annual Growth Rate (%) — annualized geometric growth rate of capital. - `win`: Win Rate (%) — percentage of historical cycles or trades ending with positive returns. - `cnt`: Sample Count / Total Trades — total number of occurrences or trades analyzed. - `dd`: Current Drawdown (%) — percentage decline from recent equity peak. - `dd_max`: Maximum Drawdown (%) — largest peak-to-trough decline over the backtest horizon. - `vola`: Annualized Volatility (%) — annualized standard deviation of percentage returns. - `str`: Current Streak — active consecutive winning (+) or losing (-) periods. - `+str`: Max Consecutive Wins — longest historical sequence of winning cycles. - `-str`: Max Consecutive Losses — longest historical sequence of losing cycles. - `wmax`: Maximum Single Win (%) — highest single cycle or trade return observed. - `lmax`: Maximum Single Loss (%) — largest single cycle or trade loss observed. - `start` / `end`: Horizon date boundaries (YYYY-MM-DD). ## Core Policies - Access: Free public access to analytical tools and educational datasets - Nature: Informational and statistical research only; strictly no financial or investment advice ## Model Context Protocol (MCP) Server MetaDuro provides a read-only Model Context Protocol (MCP) server for Claude, Cursor, and other AI assistants: - Endpoint (Streamable HTTP): `https://metaduro.com/mcp` (MCP 2026-07-28, plus the initialize handshake of 2025-11-25 back to 2024-11-05; `https://metaduro.com/api/mcp` also works) - Discovery Manifest: `https://metaduro.com/.well-known/mcp.json` - MCP Documentation: `https://metaduro.com/mcp` - Security & IT Admin Guide: `https://metaduro.com/mcp/security` - Data Policy: Read-only statistical queries, no sign-in required, tool inputs are not stored (see https://metaduro.com/privacy). Analyses only use market data MetaDuro already stores. - MCP App: `chart_seasonality` and `run_backtest` render interactive charts (MetaDuro Charts, `ui://metaduro/charts.html`) in Claude and other clients that support MCP Apps; other clients get the same numbers as text and structured content. ### Available MCP Tools - `get_seasonality`: Search published seasonality reports (by month, weekday, or day of the month) by ticker, month or quarter, analysis type, keyword, and minimum win rate, with sorting and paging. - `search_trading_strategies`: Search published strategy backtests by ticker, indicator or keyword, minimum win rate, profit factor, and number of trades, with sorting and paging. - `get_strategy_details`: Get one strategy backtest's full metrics, rule definition, and description. - `list_popular_assets`: List the covered assets by asset class, with report and backtest counts. - `chart_seasonality`: Compute any covered asset's seasonality by month, weekday, day of the month, trading day of the month, week, year, or hour (win rate, average return, Sharpe ratio, profit factor, sample size per period), with a link to the interactive analysis. - `run_backtest`: Backtest strategy rules written in MetaDuro's strategy language, e.g. `{"s": "spy:amex:1d", "o": [[["rsi", 2], "<", 10]], "n": 5}`, or a published strategy: trades, win rate, ROI, CAGR, profit factor, Sharpe ratio, drawdown, and the equity curve versus buy and hold, with a link to open and edit the backtest. - `list_indicators`: Look up the 166 indicators available in strategy rules, with parameters in rule order, defaults, and an example rule. ### MCP Prompts & Resources - Prompts: `seasonality_briefing` (asset, period) and `strategy_screen` (indicator, asset, min_win_rate). - Resources: `metaduro://docs/metrics` (metric definitions), `metaduro://docs/strategy-rules` (how to read strategy rules), and `ui://metaduro/charts.html` (the MetaDuro Charts MCP App). ## Developer & AI Agent API MetaDuro exposes a machine-readable REST API and OpenAPI 3.0 specification for AI assistants, agents, and quantitative developers: - [OpenAPI Specification (Root)](https://metaduro.com/openapi.json): Machine-readable OpenAPI 3.0.3 JSON schema (CORS-enabled, includes `x-token-cost` per operation; also available at `https://metaduro.com/.well-known/openapi.json` and `https://metaduro.com/api/openapi.json`). - [Interactive API Explorer](https://metaduro.com/api/docs): Swagger/OpenAPI interactive documentation (`https://metaduro.com/docs` also works). - [Full AI Knowledge Base (llms-full.txt)](https://metaduro.com/llms-full.txt): Single-file technical reference with MCP tool schemas, strategy rule syntax, and complete Strategy Backtesting DSL documentation. - [Generate API Tokens](https://metaduro.com/user/tokens): Manage `free`, `plus`, and `pro` API keys for programmatic access. ### Authentication, Permission Tiers & Daily Usage Tokens Pass tokens via HTTP headers (`Authorization: Bearer mtd_live_...` or `X-API-Key: mtd_live_...`). Query parameter `?token=...` is deprecated. - `free` (Anonymous): Read-only access to cached seasonality records, public slugs, and strategies (**10 usage tokens/day**, 10 requests/day per IP). - `plus` (Registered): **50 usage tokens/day** shared across browser sessions and API keys. - `pro` (Upgraded): Live ticker market downloads (`dl=1`), custom strategy/slug creation, and **100 usage tokens/day** (unlimited IP request rate). - `adm` (Admin): Full administrative platform access (**10,000 usage tokens/day**, unlimited IP request rate). #### Usage & Rate Limit Headers - `X-Usage-Tokens-Cost`: Usage tokens deducted for the request (`0` for unmetered endpoints). - `X-Usage-Tokens-Remaining`: Remaining daily usage tokens. - `X-Usage-Tokens-Limit`: Daily usage-token allowance (`10`, `50`, `100`, or `10000`). - `X-Usage-Tokens-Reset`: Unix timestamp when daily allowance resets (`00:00 Europe/Berlin`). - `X-RateLimit-Limit` / `X-RateLimit-Remaining`: IP-level request limit (`10` for anonymous/free, `unlimited` for `pro`/`adm`). - `429 Too Many Requests`: Returned when daily allowance or IP rate limit is exhausted, with `Retry-After: ` header. ### Core Endpoints - `GET /api/data/assets?search=btc` - Return usable assets, tickers, and exchanges (public). - `GET /api/data/history?s=btcusd:coinbase:1D` - Fetch historical candlestick price bars (UTC). - `GET /api/data/seasonality?s=btcusd:coinbase:1D&datet=weekday` - Fetch seasonality win rates, equity curves, and summary tables. - `GET /api/data/scan?tlist=sp10&datet=weekday` - Scan market baskets for seasonal anomalies. - `GET /api/seasonal/{slug}` - Retrieve public slug seasonality datasets (public). - `GET /api/data/mystr/{slug}` - Retrieve public saved strategy backtest details and metrics (public). - `POST /api/data/str` - Execute custom algorithmic strategy backtests with indicators, stop-loss, and take-profit targets. - `GET /api/data/ta/docs?name=RSI&format=markdown` - Structured documentation and examples for 160+ technical indicators (public, unmetered). - `GET /api/data/finta/methods` - Catalog of supported technical indicators and parameters (public). - `GET /api/data/user/usage` - Check current caller's daily usage-token balance and reset time (unmetered). - `POST /api/user/tokens` - Generate programmatic API tokens. ### Strategy DSL Quick Example Execute a backtest via `POST /api/data/str`: ```json { "s": "btcusd:coinbase:1D", "o": [["rsi", "<", 30]], "c": [["rsi", ">", 70]], "sl": 5.0, "tp": 15.0, "bal": 10000.0, "t": 1, "bm": "btcusd:coinbase:1D" } ```