# RegimeShift — Regime-Aware Risk & Rate Benchmarks for Agents on Base
# https://regimeshift.xyz

> 4 agent endpoints on Base. x402 micropayments (USDC, $0.001/call) or MCP.
> ETH/BTC volatility risk premium, decentralized Agent-SOFR short rate, regime-capped max-safe LTV.
> Every response carries raw inputs + an open methodology URL for audit.

## Links
- Site: https://regimeshift.xyz
- Live loan registry: https://regimeshift.xyz/#loans
- MCP endpoint (Streamable HTTP): https://mcp.regimeshift.xyz/mcp
- MCP endpoint (SSE): https://mcp.regimeshift.xyz/sse
- Discovery manifest (canonical): https://regimeshift.xyz/api/manifest
- Discovery manifest (static mirror): https://regimeshift.xyz/.well-known/manifest.json
- Per-tool manifests: https://regimeshift.xyz/.well-known/ai-tool/<slug>.json
- Agent card (A2A): https://regimeshift.xyz/.well-known/agent-card.json
- Methodology — VRP: https://regimeshift.xyz/methodology/vrp-v1
- Methodology — Agent-SOFR: https://regimeshift.xyz/methodology/agent-sofr-v1

## Tools
- eth-vrp    GET /api/v1/asset/eth/vrp                ETH volatility risk premium (DVOL − Parkinson RV 72h) + LOW/MID/HIGH regime
- btc-vrp    GET /api/v1/asset/btc/vrp                BTC volatility risk premium (DVOL − Parkinson RV 72h) + LOW/MID/HIGH regime
- agent-sofr GET /api/v1/rate/sofr/usd?horizon=1h     Decentralized USD short rate; horizon in {1h,1d,1w} (default 1h)
- max-ltv    GET /api/v1/risk/max-ltv?asset=ETH&duration_sec=3600&max_default_prob=0.001   Regime-capped max-safe LTV
All 4 are $0.001 USDC per call via x402 on Base. No free tier.

## Quick Start
1. curl -i https://regimeshift.xyz/api/v1/asset/eth/vrp
   -> HTTP 402. The x402 challenge is in the `payment-required` response header (base64 JSON); body is empty {}.
2. Pay + retry with any standard x402 v2 client:
   - Python:     pip install x402   (register exact-EVM scheme on network eip155:8453)
   - TypeScript: @coinbase/x402  or  x402-anthropic  (auto-settles USDC on Base)
3. Or skip HTTP and call via MCP: connect an MCP client to https://regimeshift.xyz -> https://mcp.regimeshift.xyz/mcp
   (tools: eth_vrp, btc_vrp, agent_sofr, max_ltv)

## Auth / Payment
- Protocol: x402, x402Version 2 (challenge delivered in the `payment-required` HTTP header).
- Network: Base — CAIP-2 eip155:8453.
- Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (EIP-712 domain name "USD Coin", version "2").
- Scheme: exact (EIP-3009 transferWithAuthorization). Price: amount "1000" atomic = $0.001 per call.
- payTo: 0x82B17D0bb4De9ae6c3491257B60E8245e70acd7B
- maxTimeoutSeconds: 300. Settlement is on Base mainnet (block-time bound, ~2s end-to-end).

## Registry
- ERC-8257 ToolRegistry: NOT YET REGISTERED (TODO before citing an on-chain ID).

## Full Spec
Per-tool input/output JSON Schemas, pricing, and x402 fields:
https://regimeshift.xyz/.well-known/ai-tool/<slug>.json  (slugs: eth-vrp, btc-vrp, agent-sofr, max-ltv)