Skip to main content

kotecharts — Python SDK

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.

pip install kotecharts            # add [pandas] for DataFrames
from kotecharts import KoteCharts

kc = KoteCharts()                         # reads KOTE_API_KEY (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, ServiceUnavailableError, …) and carry .status, .code, .request_id and .retry_after. 429/503 are retried with backoff, honouring Retry-After; a requested wait longer than 30 s is raised at once instead of slept through. The limit is 3 requests per second per key.

Data: non-commercial use only, with attribution — cite "Kote Charts" and link https://kotecharts.com/c/{id}; commercial use requires prior written permission (data licence). Educational only, not financial advice. Full docs: https://github.com/kote-charts/kote-charts.

Metadata

Release files for kotecharts 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kotecharts 0.2.1
File Size Uploaded Provenance Actions
kotecharts-0.2.1.tar.gz 9.4 kB With provenance Details for kotecharts-0.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kotecharts 0.2.1
File Interpreter ABI Platform Actions
kotecharts-0.2.1-py3-none-any.whl Python 3 none any Details for kotecharts-0.2.1-py3-none-any.whl

Total release size: 18.8 kB

Release files / kotecharts-0.2.1.tar.gz

Download URL kotecharts-0.2.1.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
dd89a879856f74c86b614888069b62379a8ccdf9b1d366aae7e09aa111eb9c79
BLAKE2b-256 checksum
How to use checksums
f369992ce94b380bb16e03d324ad321a7f33fe51e8bbde78a223847e1bb3839d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / kotecharts-0.2.1-py3-none-any.whl

Download URL kotecharts-0.2.1-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d722810638803782b04092142ab51ea6286bb5deab2d9f58731c9aaf35b05244
BLAKE2b-256 checksum
How to use checksums
89bac4feed3b8f16efbfb25b0e1af30607d9261890dc6906e0a7c837f6fc5b8b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for kotecharts 0.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for kotecharts-0.2.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page