# market2000.xyz

> Real-time financial data API for AI agents. Pay-per-call via x402 micropayments on Base mainnet (USDC). No API keys, no subscriptions, no rate limits — agents pay per call.

## Quick Start (MCP)

Add to Claude Desktop / Claude Code `.claude/settings.json`:

```json
{
  "mcpServers": {
    "market2000": {
      "command": "node",
      "args": ["/root/mpattern-mcp/server.mjs"],
      "env": {"WALLET_PRIVATE_KEY": "0x..."}
    }
  }
}
```

## Quick Start (x402 / direct HTTP)

All endpoints are POST with query parameters. Pay with any x402-compatible client:

```bash
npx agentcash fetch "https://market2000.xyz/daily_brief" -m POST
```

## Pattern Intelligence (Moat)

- [Regime Detection](https://market2000.xyz/regime_detection) — POST /regime_detection?ticker=SPY&lookback_days=60 — "what historical era does now resemble?" Top-3 analogs + forward returns. $0.25.
- [Forward Distribution](https://market2000.xyz/forward_distribution) — POST /forward_distribution?ticker=SPY&start_date=2024-01-01&end_date=2024-03-01 — full P10/P25/P50/P75/P90 return distribution across all analogs. $0.25.
- [Macro Analog](https://market2000.xyz/macro_analog) — POST /macro_analog?lookback_days=20 — match current VIX/yields/SPY/GLD to historical macro periods. $0.25.
- [Playbook](https://market2000.xyz/playbook) — POST /playbook?ticker=NVDA&start_date=...&end_date=...&peers=MSFT,AMD,QQQ — when ticker showed this pattern, what did peers do? $0.50.
- [Pattern Backtest](https://market2000.xyz/pattern_backtest) — POST /pattern_backtest?ticker=SPY&lookback_days=20&min_return=0.05 — every time ticker did X% in N days, what happened next? $0.50.
- [Pattern Search](https://market2000.xyz/get_patterns) — POST /get_patterns?ticker=AAPL&start_date=2024-01-01&end_date=2024-03-01 — historical analogs + 7/30-day forward return stats. $0.25.
- [Pattern OHLC](https://market2000.xyz/get_patterns_ohlc) — Same + full candlestick data per match. $0.25.
- [Pattern Search Raw](https://market2000.xyz/get_patterns_raw) — Same, raw matches only. $0.05.
- [Batch Screener](https://market2000.xyz/screen) — POST /screen?tickers=AAPL,MSFT,NVDA,SPY,QQQ&start_date=...&end_date=... — scan up to 50 tickers. $0.15.

## Pattern Alerts

- [Pattern Alert](https://market2000.xyz/pattern_alert) — POST /pattern_alert?ticker=SPY&ref_ticker=SPY&ref_start=2020-03-01&ref_end=2020-03-20&webhook_url=https://... — webhook fires when current price shape matches a historical template. $0.25.
- [Pattern Alert Status](https://market2000.xyz/pattern_alert/status) — GET /pattern_alert/status?watch_id=... — check status of a pattern alert. Free.
- [Pattern Alert Cancel](https://market2000.xyz/pattern_alert/cancel) — POST /pattern_alert/cancel?watch_id=... — cancel a pattern alert. Free.

## Agent Tools

- [Daily Brief](https://market2000.xyz/daily_brief) — Fear/greed + top movers + earnings + macro events in one call. $0.02.
- [Analyze](https://market2000.xyz/analyze) — Natural language: POST /analyze?question=is+NVDA+overvalued. $0.02.
- [Price Alert](https://market2000.xyz/watch/register) — POST /watch/register?ticker=AAPL&condition=price_above&threshold=220&webhook_url=https://... — fires webhook once when triggered. $0.05.
- [Watch Status](https://market2000.xyz/watch/status) — GET /watch/status?watch_id=... — free.
- [Watch Cancel](https://market2000.xyz/watch/cancel) — POST /watch/cancel?watch_id=... — free.

## Market Data

- [Latest Price](https://market2000.xyz/get_latest_price) — POST /get_latest_price?ticker=AAPL — latest close + 1-day change. $0.01.
- [Price History](https://market2000.xyz/get_price_history) — POST /get_price_history?ticker=AAPL&start_date=2024-01-01&end_date=2024-06-01 — OHLC bars. $0.01.
- [Market Movers](https://market2000.xyz/get_market_movers) — POST /get_market_movers?category=all&count=10 — top gainers, losers, most active. $0.01.
- [Fear & Greed](https://market2000.xyz/get_fear_greed) — POST /get_fear_greed — CNN index 0–100, 7 components, 30-day history. $0.01.
- [Hardware Prices](https://market2000.xyz/get_hardware_prices) — POST /get_hardware_prices?category=gpu — CPU/GPU retail prices + NVDA/AMD/INTC stocks. $0.01.

## Calendars & Events

- [Earnings Calendar](https://market2000.xyz/get_earnings_calendar) — POST /get_earnings_calendar?date=2026-06-07 — companies reporting with EPS estimates. $0.01.
- [Economic Calendar](https://market2000.xyz/get_economic_calendar) — POST /get_economic_calendar?period=this_week&importance=high — CPI, Fed, NFP, GDP. $0.01.
- [Google Trends](https://market2000.xyz/get_trends) — POST /get_trends?period=daily&geo=US — top trending searches. $0.01.
- [arXiv Search](https://market2000.xyz/search_arxiv) — POST /search_arxiv?query=reinforcement+learning+trading — academic papers. $0.01.

## Financial Analysis

- [Fundamentals](https://market2000.xyz/get_fundamentals) — POST /get_fundamentals?ticker=AAPL — P/E, margins, growth, balance sheet, analyst targets. $0.01.
- [Options Chain](https://market2000.xyz/get_options_chain) — POST /get_options_chain?ticker=AAPL — calls+puts with IV, OI, put/call ratio. $0.05.
- [Portfolio Optimizer](https://market2000.xyz/optimize_portfolio) — POST /optimize_portfolio?tickers=AAPL,MSFT,NVDA&objective=max_sharpe — Markowitz optimization. $0.05.

## Response Signatures

Every 200 response includes three headers for verifiable data provenance:

- `X-Response-Hash: sha256=<hex>` — SHA-256 of the response body
- `X-Response-Signature: 0x<hex>` — secp256k1 signature by market2000.xyz signer
- `X-Signer: ` — verifiable Ethereum address

Verify at: POST /verify_signature?body=<json_string>&sig=<signature>

## Network & Payments

- Network: Base mainnet (eip155:8453)
- Payment asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Protocol: x402 (pay-per-call HTTP payment standard)
- Discovery: /.well-known/x402

## Optional: Discovery

- [API Docs](https://market2000.xyz/docs)
- [OpenAPI Spec](https://market2000.xyz/openapi.json)
- [API Catalog](https://market2000.xyz/.well-known/api-catalog)
- [x402 Well-Known](https://market2000.xyz/.well-known/x402)