# x402 Crypto Market Structure

Know what the market is actually doing — not just price. Live orderflow from 20 exchanges across Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin, Avalanche, Cardano, Chainlink, and 15 more tokens. Dire…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add admin-k56l/x402-crypto-market-structure

# Browse available tools
npx -y @smithery/cli@latest tool list admin-k56l/x402-crypto-market-structure

# Get full schema for a tool
npx -y @smithery/cli@latest tool get admin-k56l/x402-crypto-market-structure market.snapshot

# Call a tool
npx -y @smithery/cli@latest tool call admin-k56l/x402-crypto-market-structure market.snapshot '{}'
```

## Direct MCP Connection

Endpoint: `https://x402-crypto-market-structure--admin-k56l.run.tools`

**Optional config:**
- `max_age_seconds` (query) — Default maximum data age. Default: 3600.
- `include_debug_info` (query) — Include diagnostic metadata.

## Tools (8)

- `market.snapshot` — Live market snapshot — 16 reliably populated fields, no LLM, no interpretation. Returns price_usd, change_pct_24h, volu…
- `market.analyze` — Pre-trade macro check. Data-only, no LLM. Returns price, pulse direction with confidence, macro regime (bull/bear/risk_…
- `market.orderflow` — Cross-exchange orderflow from 20 live venues. Returns CVD direction/value, whale bar count (1h), liquidation pressure, …
- `market.full` — Complete pre-trade analysis. All market + orderflow data plus a grounded LLM call. Returns stance (BULLISH/BEARISH/NEUT…
- `address.risk` — On-chain address risk profile. Auto-detects EVM (0x...) or Solana (base58). Returns address_type, entity_label, account…
- `history.1h` — Hourly OHLC + orderflow bars. Up to 5,000 bars, up to 7 years history. Returns timestamp, open, high, low, close, vbuy,…
- `history.1d` — Daily OHLC + orderflow bars. Up to 7 years history. Returns timestamp, open, high, low, close, vbuy, vsell, cvd, buy_ra…
- `history.5m` — 5-minute OHLC + orderflow bars. 17-day rolling window. Returns timestamp, open, high, low, close, vbuy, vsell, cvd, buy…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get admin-k56l/x402-crypto-market-structure <tool-name>
```

## Prompts (2)

- `pre_trade_check` (token) — Complete pre-trade due diligence. Calls market.full, evaluates risk_level, orderflow_signal, macro_regime, delivers ent…
- `orderflow_scan` (token) — Quick orderflow health check. Calls market.orderflow, reports CVD, whale activity, liquidation pressure, flags manipula…
