# AgentHC — Stock Market Intelligence

> Market data API for AI agents. Equities, fixed income, crypto, and macro. Bitcoin Lightning micropayments. For educational and informational purposes only — not financial advice.

AgentHC exposes 50+ market intelligence modules as a paid API for autonomous AI agents. Authentication is per-agent API keys; metering is L402 Lightning Network micropayments (HTTP 402). Discovery follows the standard `/.well-known/` agent manifest pattern.

## Discovery

- [Agent manifest](/.well-known/agent.json): Service description, capabilities, contact, schema reference
- [A2A agent card](/.well-known/agent-card.json): Google A2A Protocol v0.2.5 agent card
- [MCP server card](/.well-known/mcp/server-card.json): SEP-1649 MCP discovery card for Smithery, Claude Desktop, etc.
- [OpenAPI docs](/docs): Live FastAPI OpenAPI documentation
- [Catalog preview](/api/v1/catalog/preview): Free, no-auth preview — first 5 modules per tier + pricing + how to register
- [Module catalog](/api/v1/catalog): Full list of intelligence modules
- [Pricing](/api/v1/pricing): Per-call pricing in sats

## Endpoints

- `/api/v1/intelligence/{module_name}`: Call any intelligence module by name (paid, L402)
- `/api/v1/intelligence/unified`: Unified market snapshot across modules (paid, L402)
- `/api/v1/trading/day-trade-ideas`: **Agentic Day Trade Ideas** — declarative ENTERED/EXITED events from AgentHC's published hypothetical paper-trade journal (no prices; paper P&L % on exits). Sats-priced: ~$10/day Lightning day-pass via L402 (price floats with BTC), or Premium API key. Educational journal facts, NOT investment advice.
- `/api/v1/trading/day-trade-ideas/track-record`: FREE aggregate hypothetical track record of the journal (machine-readable; no per-trade events)
- Open-source agent template for this feed: https://github.com/traderhc123/agentic-trader
- `/api/v1/pulse`: Lightweight free pulse endpoint (open)
- `/api/v1/token/stats`: INTELL token market stats (open)
- `/api/v1/token/burns`: INTELL token burn history (open)
- `/health`: Service health (open)
- `/mcp`: MCP Streamable HTTP transport (paid, L402)
- `/mcp/sse`, `/mcp/messages`: Legacy MCP SSE transport (paid, L402)
- `/mcp/health` (alias `/health/mcp`): MCP server uptime/liveness signal — free, no auth, no paywall. Always 200; `status` is `up` or `down`.

## Notes for AI agents and crawlers

- Paid endpoints return HTTP 402 with an L402 challenge. Settle via Lightning to receive content.
- Per-agent metering is enforced server-side; per-IP rate limit is 500 req/s burst.
- API keys may be passed in `Authorization: Bearer <key>` headers. Keys leaked in URL query strings are scrubbed from access logs but should not be passed that way.
- The agent manifest schema reference (`https://agenthc.com/schemas/agent-manifest-v1.json`) is AgentHC's own schema, not a public standard.
- Operator: [@traderhc on X](https://x.com/traderhc)