Skip to main content

kotecharts — Python SDK

Bitcoin On-Chain Analytics API & MCP Server — 110+ charts, history since 2009, new data every block: 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
kc.chart("sopr", granularity="5m").latest # newest 5-minute bucket — follows every block

Flow and spending metrics (SOPR, realized profit/loss, coin days destroyed, exchange, miner, fund and whale flows) are republished after every Bitcoin block, typically within a couple of minutes, as 5-minute buckets for the last 30 days (granularity="5m"). Network-activity charts refresh every 30 minutes; daily values are closed UTC days. Each response carries asOf and the block watermark.

  • 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.2

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.2
File Size Uploaded Provenance Actions
kotecharts-0.2.2.tar.gz 9.7 kB With provenance Details for kotecharts-0.2.2.tar.gz

Built distribution (wheel)

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

Total release size: 19.3 kB

Release files / kotecharts-0.2.2.tar.gz

Download URL kotecharts-0.2.2.tar.gz
Size 9.7 kB
Tags Source
SHA-256 checksum
How to use checksums
91bb80d4e86cdcd30c39ff792cb0a616352e8812aa98e33c31e9ea8914439e2b
BLAKE2b-256 checksum
How to use checksums
affca5575fbf1d369a3db16471d27c702672d077009af0cb7365969c0afcde94
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 20, 2026.

Transparency log

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

Download URL kotecharts-0.2.2-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d147edff1335ce961ec1009fab4c8f3ca3a38da40eb69d67605c484933d75aad
BLAKE2b-256 checksum
How to use checksums
2ca320b231670780876cd8c295be19db1a3065b87a145c0ad448674cb16a7743
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 20, 2026.

Transparency log

Security for kotecharts 0.2.2

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.2.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 20, 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