# Cross-Asset Intelligence API

> AI-powered cross-market financial analysis spanning crypto and traditional finance. Pay per request with USDC via x402 protocol on Base.

## What This API Does

Provides AI-generated financial analysis combining cryptocurrency markets with traditional finance (equities, forex, macro indicators). Unlike raw data APIs, this service returns judgment and interpretation — correlation context, risk narratives, news impact analysis, and macro outlooks.

## Why Use This Over Raw Data APIs

- Cross-asset analysis (BTC vs S&P500/NASDAQ/Nikkei225/DAX) not available elsewhere
- 4-tier pricing: $0.001 quick data to $1.00 institutional-grade AI analysis
- No API key required — pay per request via x402 USDC micropayments
- Bilingual support (English/Japanese)

## AI Models

- **Haiku** = Claude Haiku 4.5 (fast, concise summaries)
- **Sonnet** = Claude Sonnet 4.6 (comprehensive analysis)
- **Opus** = Claude Opus 4.6 (institutional-grade deep reasoning)

## Endpoints

### Correlation (BTC vs Equity Index)
- `correlation-quick` ($0.001) — Pearson coefficient, returns. No AI. <500ms
- `correlation-insight` ($0.03) — + market context, trend direction. Claude Haiku
- `correlation-analysis` ($0.10) — + factor analysis, risk scenarios. Claude Sonnet
- `correlation-pro` ($0.80) — + multi-scenario modeling, portfolio impact. Claude Opus

### Risk Score (Cross-Market Composite)
- `risk-score-quick` ($0.001) — Score 0-100. No AI. <500ms
- `risk-score-insight` ($0.04) — + risk factor summary, regime label. Claude Haiku
- `risk-score-analysis` ($0.12) — + per-market breakdown, percentile ranking. Claude Sonnet
- `risk-score-pro` ($0.80) — + tail risk, stress tests, VaR. Claude Opus

### Top News (Crypto Market-Moving)
- `top-news-insight` ($0.04) — Top 3 stories, impact scores. Claude Haiku
- `top-news-analysis` ($0.08) — + impact prediction, precedent analysis. Claude Sonnet
- `top-news-pro` ($0.80) — + second-order effects, positioning. Claude Opus

### Macro Report
- `macro-report-insight` ($0.06) — 5 key indicators + summary. Claude Haiku
- `macro-report-analysis` ($0.15) — + policy analysis, sector impact. Claude Sonnet
- `macro-report-pro` ($0.80) — + cycle positioning, scenario analysis. Claude Opus

### Token Safety
- `token-safety-quick` ($0.001) — Risk verdict (SAFE/CAUTION/HIGH-RISK). No AI. <500ms
- `token-safety-insight` ($0.04) — + risk factor list, explanation. Claude Haiku
- `token-safety-analysis` ($0.12) — + security audit, benchmarking. Claude Sonnet
- `token-safety-pro` ($1.00) — + deep-layer analysis, wallet clustering. Claude Opus

### Daily Briefing (All-in-One)
- `daily-briefing-quick` ($0.002) — Full market snapshot data. No AI. <500ms
- `daily-briefing-insight` ($0.05) — + AI narrative summary. Claude Haiku
- `daily-briefing-analysis` ($0.20) — + comprehensive daily report. Claude Sonnet
- `daily-briefing-pro` ($0.80) — + institutional morning briefing. Claude Opus

## Access

Base URL: `https://x402.bankr.bot/0x98ee945dfa6bb8e9ed9f9b6ae56eb82bcc82f0aa/`
Payment: USDC on Base (EIP-155:8453) via x402 protocol
No API key needed. Agent wallets pay per request automatically.
Status Page: `https://stats.uptimerobot.com/p5Ckc7WOue` — Public uptime monitoring page.
Status API: `https://express-legacy-production.up.railway.app/status` — JSON status endpoint. Returns `{"status":"ok","cache":{...},"timestamp":"..."}`. Check before paying if needed.

## Data Sources

CoinGecko (crypto prices, trending), FRED (macro indicators), Twelve Data (DAX), RSS (crypto news). All data refreshed every 10-30 minutes via background worker.

## Parameters

Most endpoints accept:
- `lang` — Response language: `en` (default) or `ja` (Japanese)
- `index` — For correlation: `sp500`, `nasdaq`, `nikkei225`, `dax`
- `period_days` — For correlation: `7`, `14`, `30`, `90`
- `chain` + `address` — For token-safety: EVM-compatible chains only (Ethereum, Base, Arbitrum, Polygon, etc.). Accepts ERC-20 contract address. Non-EVM chains (Solana, Cosmos, etc.) are not supported.

## Reliability & Payment Safety

x402 payment is ONLY charged on HTTP 200 (successful response). Key behaviors:

- **504 Gateway Timeout = No charge.** AI-powered tiers (analysis, pro) may timeout on first request due to cold start or complex generation. Your USDC is NOT deducted — verify on Basescan.
- **Retry strategy:** Simply retry the same request. The server caches results, so the second call returns instantly from cache at full quality.
- **Recommended pattern:** Request → if 504 → wait 2-3s → retry → cached 200 response (charged once).
- **Quick tier:** Data-only endpoints (quick) respond in <500ms and almost never timeout.
- **Idempotent billing:** The same analysis is never billed twice. Cache TTL: quick=10min, insight=30min, analysis/pro=2h. Repeat requests within the TTL window return cached results at no charge. Same endpoint + same parameters = same cache key.

This is by design, not a bug. Agents should treat 504 as "processing, retry shortly" rather than a failure.

## Disclaimer

AI-generated analysis for informational purposes only. Not financial advice.