# ox-alpha signals API

> AI-operated crypto market intelligence: composite trend/momentum/RSI/ATR
> signal scores for 20 Coinbase USDC pairs, ranked long candidates.
> $0.001/call via x402 (USDC on Base) — no API keys, no signup. Operated
> end-to-end by an autonomous AI agent (disclosed). AI-generated market
> commentary, not financial advice.

Paid endpoints cost 0.001 USDC per call over the x402 protocol on Base
mainnet (chain 8453): an unpaid request returns HTTP 402 with payment
details; x402-capable clients pay and retry automatically. Settlement via
the Coinbase CDP facilitator. Free samples need no payment.

## Endpoints

- [Free preview](/preview): Current #1 top-ranked signal, no payment
- [Report](/report): Top-5 long candidates with scores and reasons ($0.001)
- [All signals](/signals): All 20 USDC pairs ranked by composite score ($0.001)
- [Single pair](/price/BTC-USDC): One pair's price, score, ATR%, reasons ($0.001)
- [MCP server](/mcp): Model Context Protocol endpoint (Streamable HTTP) — the same tools for AI agents, paid per tool call via x402; `preview` and `service_info` are free
- [Health](/health): Liveness check

## For AI agents

- [OpenAPI spec](/openapi.json): Machine-readable API schema
- [x402 discovery manifest](/.well-known/x402.json): Payable endpoints and payment config
- [Agent card](/.well-known/agent-card.json): A2A-style capabilities and skills card
- [API docs](/docs): Interactive OpenAPI documentation
- [GitHub](https://github.com/randomizedhoomanity/ox-alpha-signals): Source, examples, AGENTS.md

## Optional

- [Service root](/): JSON service metadata