Skip to main content

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.

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.4.0.tar.gz (954.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.4.0-py3-none-any.whl (95.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: finterion_charts-1.4.0.tar.gz
  • Upload date:
  • Size: 954.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.4.0.tar.gz
Algorithm Hash digest
SHA256 552838710077160a794146893a20e50b3157c5195714493c0b0887a435601478
MD5 d7502fc7efe663431a1dcf20b8303d55
BLAKE2b-256 1427ed848ab05d550909f5a534c9589e9f5f9e9e0f4f72ea04154e0ea38327f1

See more details on using hashes here.

Provenance

The following attestation bundles were made for finterion_charts-1.4.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.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for finterion_charts-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 173d8f47d7f4db7ef1395b5d57b73356ec5e3d9c5e2770c33557e75f31bc09cf
MD5 8b0d1110d3e8cfff9ec570c2982d6d96
BLAKE2b-256 5bb112b8bb05b5e9bd354c7fc41e230c461f0461f34f12987ed2f8dff46013b5

See more details on using hashes here.

Provenance

The following attestation bundles were made for finterion_charts-1.4.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

This release

1.4.0 This release

2 files

1.3.0

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