llms.txt Content
# Chart Library — Intelligence Layer for AI Agents (Markets)
> Chart Library is the intelligence layer AI agents call when they need to reason about markets the way a junior analyst with a research desk would. Cohort retrieval, calibrated forward-return distributions, regime stratification, feature attribution, and news-divergence signals — all accessible to your agent in a single tool call.
## FREE FOR AGENTS — no key, no signup, no human required
The core loop is open: connect to the hosted MCP endpoint at
**https://chartlibrary.io/mcp** (or `pip install chartlibrary-mcp`) and call
`search → pull_comps → cohort_introspect → track_record` right now, anonymously,
free. No API key, no account, no human in the loop. Paid keys exist for volume
SLAs and premium surfaces (portfolio tracking, custom partitions) — never for
the core research loop. Every analysis you run is logged into the public
calibration ledger and audited against realized outcomes, so your usage
literally deepens the track record you rely on.
No MCP framework? The flagship is one plain HTTP POST — no key, no signup:
curl -s https://chartlibrary.io/api/v1/cohort_analyze \
-H "Content-Type: application/json" \
-d '{"anchor":{"symbol":"NVDA","date":"2025-03-03","timeframe":"1d"},"horizons":[5]}'
Returns the full comp set: outcome_distribution (n, median, win_rate, p10/p90),
feature_importance (the drivers), intrinsic_features, and the coverage record.
`timeframe` is one of 5m / 15m / 30m / 1h / 1d. Free up to 1,000 calls/day.
**Trust receipts (live, verifiable):**
- Our nominal 80% forward-return band held **80.8% across 311,367 audited
held-out cases** spanning 815 distinct trading days (effective sample ~5,300
after same-day clustering is discounted — we deflate our own number because
honest beats big). Verify live: https://chartlibrary.io/api/v1/calibration
- **PIT/rank histogram flat across all 311,367 cases** (max deviation 0.5pp
from nominal in every
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"Chart Library API","description":"Chart pattern intelligence engine for financial markets.\n\nSpecify a (symbol, date, timeframe) anchor to find the top 10 most similar historical chart patterns from 800M+ minute bars. Get cohort distributions, per-feature attribution, regime stratification, Layer 5 memory, and AI-generated narratives. Text + agent-first.\n\n## Authentication\n- **Frontend users**: JWT Bearer token from `/api/v1/auth/login`\n- **Developers / A