finterion-charts (Python)

Python binding for Finterion Charts.

This package does not render anything. It builds, validates, and encodes ChartSpec JSON — the same JSON contract consumed by @finterion/charts-spec. Rendering is done in the browser by @finterion/charts-core, so charts produced from Python are pixel-identical to charts produced from TypeScript.

Install

From PyPI (once published):

pip install finterion-charts          # core: builder + cheap validator + codec
pip install "finterion-charts[schema]"   # add jsonschema-based strict validation
pip install "finterion-charts[pandas]"   # add pandas/numpy ergonomic builders
pip install "finterion-charts[jupyter]"  # add IPython iframe display helper
pip install "finterion-charts[all]"

From this monorepo (editable):

cd bindings/python
pip install -e ".[all,dev]"

Quickstart

from finterion_charts import ChartSpec, Indicator, Price, Marker

spec = (
    ChartSpec(theme="finterion-dark", background="#131722", grid="horizontal")
    .with_bars(time=time, open=o, high=h, low=l, close=c, volume=v)
    .with_column("rsi14", rsi)
    .add_panel(Price(id="price", weight=3, title="AAPL", type="candles"))
    .add_panel(Indicator.panel(
        id="rsi", weight=1, title="RSI 14",
        values="rsi14", color="#a3ff12",
        ref_lines=[30, 70], y_range=(0, 100),
    ))
    .add_marker(Marker(time=ts, side="buy",  price=lo, label="B"))
    .add_marker(Marker(time=ts, side="sell", price=hi, label="S"))
)

spec.validate()                   # raises ValueError on invalid spec
spec.to_json("chart.json")
url = spec.embed_url()            # https://charts.finterion.com/embed/#spec=…

See examples/aapl_supertrend.py for an end-to-end example with OHLC, RSI, SuperTrend overlay, and buy/sell markers.

Licence

Finterion Community Licence v1.0 (source-available, not OSI-approved). Free to use — including commercially — as long as the default "Powered by Finterion" badge stays visible on rendered charts. To remove the badge or to build a competing hosted charting service, you need a commercial licence: contact licensing@finterion.com. See the LICENSE file shipped with the wheel, or the full text on GitHub.

Project links

Data verified by PyPI on Jul 8, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.4.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Finterion from gravatar.com Finterion

Credits

Author: Finterion

GitHub Statistics

Data verified by PyPI on Jul 8, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Other/Proprietary License (Finterion Community License 1.0 (source-available, not OSI-approved). See LICENSE file.)

Requires

Python >=3.10

Provides Extra

all dev jupyter pandas schema

Tags

candlestick chart charts finance finterion ohlc trading

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

finterion_charts-1.3.0.tar.gz (953.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

finterion_charts-1.3.0-py3-none-any.whl (95.0 kB view details)

Uploaded Python 3

File details

Details for the file finterion_charts-1.3.0.tar.gz.

File metadata

  • Download URL: finterion_charts-1.3.0.tar.gz
  • Upload date:
  • Size: 953.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for finterion_charts-1.3.0.tar.gz
Algorithm Hash digest
SHA256 b104094a9ea92c09d5c88c728b645dbca3c1ca73c97ac2ce53a3af940dccc13b
MD5 d68ef8a0be5630fe70bcf6c92b3239d1
BLAKE2b-256 8876cc0be05bdbac1a415b180a693023b2bb8ada12e417e1b84e305394f343bd

See more details on using hashes here.

Provenance

The following attestation bundles were made for finterion_charts-1.3.0.tar.gz:

Publisher: release-python.yml on Finterion/charts

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file finterion_charts-1.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for finterion_charts-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 486d267ea33b8cd196f9f432e159addbc1cd27c4452402e43fc9c0ff1ce30df2
MD5 cc83a129f1cb553404f3431764abbadd
BLAKE2b-256 0f200f262a93ec9759c32a64eb2d9c22c2cab7b63fa4b5d9e25fe5bde5d13fc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for finterion_charts-1.3.0-py3-none-any.whl:

Publisher: release-python.yml on Finterion/charts

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.4.0

2 files

This release

1.3.0 This release

2 files

1.2.0

2 files

1.1.0

2 files

1.0.0

2 files

0.2.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page