Chart Library Python SDK

Pattern intelligence for AI agents. Search 24 million historical chart patterns and see what happened next.

Install

pip install chartlibrary

Quick Start

from chartlibrary import ChartLibrary

cl = ChartLibrary(api_key="cl_your_key")  # or set CHART_LIBRARY_KEY env var

# One call — full intelligence
intel = cl.intelligence("NVDA")
print(f"Top match: {intel['matches'][0]['symbol']} {intel['matches'][0]['date']}")
print(f"5-day outlook: {intel['follow_through']['horizon_returns']['5']}")
print(f"Market regime: {intel['regime']['spy_summary'][:100]}...")

# Market regime snapshot
regime = cl.regime()
for sym, data in regime["regime"].items():
    print(f"{sym}: {data['avg_10d']:+.1f}% 10d outlook")

# Pattern search
results = cl.search("AAPL 2024-06-15")
for match in results["results"][:5]:
    print(f"  {match['symbol']} {match['date']} — {match['match_score']}%")

Endpoints

Free API Key

Get one at chartlibrary.io/developers — 200 calls/day, no credit card.