Metadata-Version: 2.5
Name: kotecharts
Version: 0.1.0
Summary: Free Bitcoin on-chain analytics API & MCP server: MVRV, NUPL, SOPR, exchange flows, whales
Project-URL: Homepage, https://kotecharts.com
Project-URL: Documentation, https://kotecharts.com/docs
Project-URL: Repository, https://github.com/kote-charts/kote-charts
Project-URL: Methodology, https://kotecharts.com/methodology
Project-URL: Issues, https://github.com/kote-charts/kote-charts/issues
Author: Kote Charts
License-Expression: MIT
License-File: LICENSE
Keywords: api,bitcoin,crypto,mcp,mvrv,nupl,on-chain,onchain-analytics,sopr
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.24
Provides-Extra: pandas
Requires-Dist: pandas>=1.5; extra == 'pandas'
Description-Content-Type: text/markdown

# kotecharts — Python SDK

**Free Bitcoin On-Chain Analytics API & MCP Server** — 110+ charts, history since 2009:
MVRV, NUPL, SOPR, exchange flows and whale analytics, computed from our own Bitcoin full node.

```bash
pip install kotecharts            # add [pandas] for DataFrames
```

```python
from kotecharts import KoteCharts

kc = KoteCharts()                         # reads KOTE_API_KEY (free key: https://kotecharts.com/account)

kc.metric("mvrv-z-score")["formula"]      # methodology — no key needed
df = kc.chart("mvrv-z-score", start="2020-01-01", granularity="week").to_pandas()
kc.latest("exchange-netflow")             # newest closed day
```

- `metrics()` / `metric(id)` — machine-readable methodology (formula, fields + units, input
  categories, update cadence, limitations, freshness). **No key.**
- `charts()` — catalog of every public chart with freshness.
- `chart(id, start=, end=, granularity=, exchange=, include_partial=)` → `ChartData`
  (`.series`, `.fields`, `.latest`, `.to_pandas()`).
- `latest(id)`, `usage()`; `AsyncKoteCharts` has the same methods for `asyncio`.

Errors are typed (`AuthenticationError`, `NotFoundError`, `RateLimitError` with `.retry_after`, …);
429/503 are retried with backoff (honouring `Retry-After`). The limit is 3 requests per second per key.

Data is free for **non-commercial** use with attribution — cite "Kote Charts" and link
`https://kotecharts.com/c/{id}`. Educational only, not financial advice.
Full docs: <https://github.com/kote-charts/kote-charts>.
