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 5, 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 5, 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.2.0.tar.gz (953.2 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.2.0-py3-none-any.whl (94.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: finterion_charts-1.2.0.tar.gz
  • Upload date:
  • Size: 953.2 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.2.0.tar.gz
Algorithm Hash digest
SHA256 8f6eac85747aca88d327cbc419331fd91ecf9e062bc2361003999b3addc4ebf6
MD5 827b4726ad62a9ec719bcb7140f07797
BLAKE2b-256 4283603581b7b99e476c29debf9ce28b096449b7366aaa99402d0ab2f650f4f2

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for finterion_charts-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2e950978be7dff9ad7e664752978ab1e935e5aeaee3a52bd02d2e002c7a75f94
MD5 f0af7af1d8326d896e64bb0d82f67865
BLAKE2b-256 5f67e4ee15c721efcdad079231bb70b7ed2be60c7951249cf20b0244f4984fa6

See more details on using hashes here.

Provenance

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

1.3.0

2 files

This release

1.2.0 This release

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