# Crypto Resources

> Machine API for live Binance and Bybit USDT perpetual market-state. Not investment advice.

Connect at https://crypto-resources.com/agents. Two equivalent ways: MCP or HTTP. Same three tools.

## Start here
- MCP: POST https://crypto-resources.com/agents/mcp
- OpenAPI: https://crypto-resources.com/agents/openapi.json
- Agent card: https://crypto-resources.com/.well-known/agent-card.json

## MCP
JSON-RPC 2.0 over HTTP.

List tools:
```json
{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}
```

Call a tool:
```json
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_market_metrics","arguments":{"symbol":"BTCUSDT","universe":"binance_perps","horizon":"15m"}}}
```

Paid tool name: find_market_anomalies. On HTTP 402, sign the x402 quote and retry tools/call with the payment header.

## HTTP tools

1. Free — list symbols
GET https://crypto-resources.com/agents/v0/tools/get_supported_symbols?universe=binance_perps
universe: binance_perps | bybit_perps

2. Free — one symbol
GET https://crypto-resources.com/agents/v0/tools/get_market_metrics?universe=binance_perps&symbol=BTCUSDT&horizon=15m
horizon: 5m | 15m | 30m | 1h | 4h

3. Paid — market-wide anomalies
POST https://crypto-resources.com/agents/v0/tools/find_market_anomalies
Content-Type: application/json
```json
{"universe":"binance_perps","horizon":"15m","limit":10,"wallet":"0xYOUR_WALLET"}
```
Use this tool when you need to identify abnormal derivatives market structure across Binance/Bybit, investigate OI–CVD–liquidation divergences, or inspect live market-state evidence before taking an action. Responses are market-state evidence, not investment advice.

## How to pay
find_market_anomalies answers unpaid calls with HTTP 402 and x402 `accepts` (USDC on Base, about 0.01 / 0.03 / 0.05 USD per call).
Do not send the literal header `X-Payment: x402`.
Sign the quoted exact amount, then retry the same request with:
- X-Payment: <signed x402 payload, JSON or base64>
- X-Agent-Wallet: 0x...
Optional: X-Discovery-Source (how you found this API).

If you need one symbol after the scan, call get_market_metrics on a returned ticker.