Live Perpetual Intelligence for Agents

1. get_supported_markets — markets, tickers, indicator filters (free). Alias: get_supported_symbols
2. get_market_metrics — optional free 15m pulse on one ticker
3. get_market_context — optional regime snapshot, only if it changes how you read a scan
4. scan_market — cheap market-wide filter; read reasons[]
5. get_instrument_state — depth on a candidate; pass indicators/windows to avoid the full dump
6. historical_validation — evidence only; insufficient sample is a valid 200

Pass indicators to get every window for those families, not the full dump. Optional windows=15m,60m.

• oi price cvd rsi vwap volume_spike
• liquidations — both USD and vs OI
• liquidations_usd / liq_usd — liquidations in dollars
• liquidations_oi / liq_oi — liquidations as % of open interest

• anomaly — extreme versus the rest of the market right now
• divergence — price and OI together, CVD against
• trap — OI expanding with the move, flow fading
• liquidation — liquidations in USD or vs OI stand out

Read reasons[]. score is not a probability. Empty results = HTTP 200.

Live data (`data_mode: live`). Every live response includes `request_id`, `updated_at`, `freshness_seconds`, `ttl_seconds`, `is_stale`. `is_closed` means the event/candle finished; `is_stale` means the TTL expired. They are different. Some indicators include updated_at and is_closed. updated_at is the open time of the 1-minute candle included in that measurement. is_closed true means that 1-minute candle was already closed when the value was measured. Example: updated_at 2026-09-08T14:52:00Z with is_closed true means the last closed candle in this report is the 14:52 bar; freshness is 14:53:00 UTC. This is the candle clock, not delayed data.

Paid tools: scan_market (0.005), get_market_context (0.005), get_instrument_state (0.01). Network Base, asset USDC. No ETH for gas.

1. Quote — POST with wallet + X-Agent-Wallet → HTTP 402 + accepts[0]
2. Sign — EIP-712 TransferWithAuthorization for USDC (x402 spec)
3. Retry — same POST + X-Payment header. Send Idempotency-Key so a retry does not charge twice.

Do not send the literal string X-Payment: x402. Full 402/200 payloads: https://crypto-resources.com/agents/v0/examples.json

Paid tools accept Idempotency-Key (header) or idempotency_key (JSON). The same key + same request body returns the cached paid answer and does not settle USDC again. Recommended on every paid retry. Missing key still works, but a network retry may charge twice.

Optional header X-CR-Api-Key (or X-Api-Key / Authorization: Bearer). Today the key is accepted but does not skip USDC — unpaid scan_market, get_market_context and get_instrument_state still return HTTP 402. Planned: an active Crypto Resources subscription will unlock paid tools without on-chain payment. Always call unpaid first: HTTP 200 means no USDC needed; HTTP 402 means follow x402.

This API does not place orders, read balances, stream order books, dump raw candles as a product, cover spot markets, or forecast prices. historical_validation never returns expected_price, forecast, or probability_of_profit.

Per client IP, 60s window, tool × tier. Unpaid = free column. After a payment header = paid column.

• get_supported_markets 60 / 600
• get_market_metrics 60 / 300
• get_market_context 30 / 300
• scan_market 10 / 100
• get_instrument_state 20 / 200
• historical_validation 5 / 50
• 429: {"error":"rate_limited","message":"Too many requests"}