Crypto Dossier

# 🪙 Crypto Dossier **An x402-native market-intelligence endpoint.** One call returns a complete dossier on any crypto token — **by symbol or contract address** — merged from **8 independent sources** into one clean JSON schema, priced at **$0.001 per call**, payable by any agent. Built for autonomous agents, trading bots, and enrichment pipelines that pay-per-call over **x402** — no accounts, no API-key juggling, no rate-limit management. --- ## 💳 Access & payment Speaks **x402-v2 on Base**. Two ways in: **1 · Free trial — Sign In With X (SIWX).** Your first **5 calls are free**. An unsigned request returns `401 siwx_required`; sign the SIWX challenge (EIP-4361 wallet sign-in) to consume one trial. No payment, just a signature. **2 · Pay-per-call — x402.** After the trials, an unsigned request returns the **`402` payment-required** challenge (accepted assets, networks, `payTo` in its header). Sign the x402 headers and the call settles on-chain at **$0.001** — the dossier returns in the same response. `wallet-mcp execute_service` signs both automatically. --- ## 🎯 What you send ```json { "query": "ETH" } { "query": "0x6982508145454ce325ddbe47a25d4ec3d2311933" } ``` A **symbol** (`BTC`, `ETH`, `SOL`) or any **token contract address** (any chain). Also accepts `symbol` / `token` / `address` keys, or a raw-string body. ## 📦 What you get A single, richly-organized dossier (`schema v2.0`): | Section | Contents | |---|---| | **query** | input, resolved type (symbol/contract), symbol, found flag | | **identity** | name, logo, website(s), socials (twitter / telegram / …) | | **price** | consolidated USD price, per-source breakdown, source count, cross-source spread % | | **market** | market cap, FDV, liquidity, 24h volume | | **change** | 1h / 6h / 24h % move | | **cex** | last, bid, ask, 24h high / low, VWAP, volume | | **dex** | top pair (chain, DEX, price, liquidity, volume, link) + pair count | | **ohlc** | 14 daily candles (O/H/L/C/V) | | **fx** | USD → EUR / GBP / JPY / CNY / INR | | **sentiment** | Fear & Greed index (value + classification) | | **global** | total market cap, BTC dominance, active coins, ATH | | **assessment** | derived `flags[]` — one-glance signal roll-up | | **meta** | schema version + per-source coverage map | ### Example `assessment.flags` ```json ["cex-listed", "high-volatility-24h", "low-liquidity", "price-divergence", "market-fear"] ``` `cex-listed` · `dex-only` · `low-liquidity` · `high-volatility-24h` · `near-1usd` · `price-divergence` · `market-<sentiment>` · `not-found`. --- ## 🧠 Symbol vs contract — the smart part - **Symbols** resolve to authoritative **exchange-grade** pricing (multi-source median + spread), with market-wide sentiment and global stats layered on. - **Contracts** resolve to full **on-chain / DEX** data — price, liquidity, market cap, pairs, plus logo and socials — so it works for **long-tail tokens** that centralized APIs don't even list. A trust gate keeps a same-named token on another chain from contaminating a major-symbol query. --- ## 🛡️ Built to never break - **Fail-open.** Any source can time out or go dark — the dossier still returns, that field simply degraded. No partial crashes. - **Always-valid schema.** Every response conforms to `schema v2.0` — even malformed input or an internal hiccup returns the full shape, never an empty `[]`. Safe to parse blind. - **Market context always.** Even an unknown token returns live sentiment + global market stats. - **Bounded latency.** Per-source timeouts keep every call fast. Verified across major symbols, raw contracts, `.co.uk`-style edge cases, unknown tickers, and empty input. --- **POST** `{ "query": "<symbol | contract>" }` → a complete market dossier in one response. Five free trial runs, then $0.001 each over x402.