ccharts

Terminal charts for financial OHLC data, written as a single-header C library with optional Python bindings. Line and candlestick charts are rendered as ANSI-colored strings of Unicode block characters and printed straight to a terminal.

Licensed under the MIT License.

Badges become live once the first release is published.

Installation

pip install ccharts

Pre-built wheels for Linux (x86_64 and aarch64), macOS (x86_64 and arm64) and Windows (x86_64), built on GitHub Actions CI for CPython 3.9-3.14, are published together with each release — no C toolchain is needed on the target machine. Install the sdist instead and a C compiler (gcc/Clang on Linux/macOS, MSVC on Windows) is required, because the package wraps the C single-header library ccharts.h.

Features

Line charts — smooth curves using 8-level vertical resolution (▁▂▃▄▅▆▇█), per-segment coloring, optional area fill under the line.
Candlestick charts — solid bodies between open/close, thin vertical wicks (│) between high/low, gap-separated candles, automatic downsampling when there are more candles than columns.
Axis labels — optional max/min price margin and first/last timestamp footer. The timestamp format is picked automatically from the candle interval (YYYY-MM-DD for daily+, HH:MM for intraday).
Timestamps — optional per-candle epoch timestamps, parsed from ISO8601 or a plain number.
Parsers — CSV (cc_str_to_ohlc) and a fixed-schema JSON parser (cc_json_to_ohlc).

C usage

#define CCHARTS_IMPLEMENTATION
#include "ccharts.h"

int main(void) {
    const char* json = ...;                 // [{ts,open,high,low,close}, ...]
    cc_ohlc_t* ohlc = NULL;
    int size = 0;
    cc_json_to_ohlc(json, &ohlc, &size);

    cc_settings_t s = { .rise_color = CC_COLOR_BLUE,
                        .show_prices = 1, .show_times = 1 };
    char* chart = cc_line_create(ohlc, size, 60, 8, &s);
    printf("%s\n", chart);

    free(chart);
    free(ohlc);
    return 0;
}

Compile with -lm (math lib). CCHARTS_IMPLEMENTATION must be defined in exactly one translation unit; every other unit can include the header as-is. C++ code can use the header for declarations (see the doc comment in ccharts.h for details).

Run the demo with make test — it compiles main.c and runs the binary, rendering prices.txt as a line chart and two candlestick variants.

Python usage

make test-py        # builds the extension and runs the test suite

from ccharts import Chart

chart = Chart(open("prices.txt").read())
print(chart.line(width=60, height=8, show_prices=True, show_times=True))
print(chart.candle(width=60, height=8))

To develop locally (builds the extension in place):

python3 -m pip install -e .      # or: make test-py

Building a wheel by hand also works and is a good local smoke test:

python3 -m pip wheel . --no-deps -w /tmp/ccharts_wheel

Settings

Field	Meaning	Default
`rise_color`	color for rising values / candles	green
`fall_color`	color for falling values / candles	red
`bg_color`	background of empty cells	none
`area_color`	fill below the line chart	none
`single_color`	1 = one line color; 0 = per-segment colors	0
`show_prices`	print max/min price labels	0
`show_times`	print first/last timestamp footer	0

Any unset field falls back to its default, so only the fields you want to override need to be set (see cc_settings_resolve).

Input constraints

Timestamps — ISO8601 strings may carry a UTC offset (+03:00, +0300, +03, Z; a missing offset is treated as UTC). The offset is applied, so the stored epoch is the true instant: 2026-07-20T00:00:00+03:00 becomes 2026-07-19T21:00:00 UTC. Plain epoch-seconds numbers (including negative) are accepted as-is. Malformed timestamps parse to 0.
Dimensions — width/height must be positive and are capped at CC_MAX_DIM (100000) per side and CC_MAX_CELLS (1000000) total cells. Invalid dimensions make the C chart functions return an empty string and make the Python bindings raise ValueError — no unchecked giant allocation, no stack overflow.
CSV — lines may be arbitrarily long and at most size lines are read.
JSON — must be an array of objects with ts, open, high, low, close (plus optional ignored fields like volume). The parser is an iterative mini-scanner: keys are matched exactly, so a substring like "open" inside a string value can never cause a false match. Malformed or empty documents make the parsers fail cleanly.

Windows / MSVC

The header is VLA-free and uses only portable C89 constructs, so it compiles with MSVC out of the box: gmtime_r is swapped for gmtime_s on _WIN32 and all functions get internal linkage (static) through the CC_INLINE macro, sidestepping MSVC's lack of C11 inline semantics. No extra flags or libraries are required beyond the standard ones.

Releases

Releases are published automatically from GitHub Actions: pushing a tag v<version> (e.g. v0.2.0) runs .github/workflows/publish.yml, which verifies that the tag matches the version in pyproject.toml, builds the sdist and all platform wheels with cibuildwheel, and uploads them to PyPI.

Publishing currently authenticates with the PYPI_API_TOKEN repository secret (an API token scoped to the ccharts project). An alternative is trusted publishing, which removes the token entirely: link the pypi GitHub environment to PyPI, then delete the password input from the publish step in the workflow.

Repository layout

ccharts.h — the whole C library (single header, heavily documented).
main.c — C demo using prices.txt.
prices.txt — sample JSON OHLC data (THYAO).
ccharts/ — Python package: __init__.py (high-level Chart) and wrapper.c (CPython extension ccharts._core).
tests/ — Python test suite (tests/test_python_api.py).

Download files

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

Source Distribution

ccharts-0.2.0.tar.gz (25.4 kB view details)

Uploaded Aug 18, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ccharts-0.2.0-cp314-cp314-win_amd64.whl (22.5 kB view details)

Uploaded Aug 18, 2026 CPython 3.14Windows x86-64

ccharts-0.2.0-cp314-cp314-musllinux_1_2_x86_64.whl (50.3 kB view details)

Uploaded Aug 18, 2026 CPython 3.14musllinux: musl 1.2+ x86-64

ccharts-0.2.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (51.8 kB view details)

Uploaded Aug 18, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

ccharts-0.2.0-cp314-cp314-macosx_11_0_arm64.whl (19.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.14macOS 11.0+ ARM64

ccharts-0.2.0-cp314-cp314-macosx_10_15_x86_64.whl (19.4 kB view details)

Uploaded Aug 18, 2026 CPython 3.14macOS 10.15+ x86-64

ccharts-0.2.0-cp313-cp313-win_amd64.whl (22.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.13Windows x86-64

ccharts-0.2.0-cp313-cp313-musllinux_1_2_x86_64.whl (50.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.13musllinux: musl 1.2+ x86-64

ccharts-0.2.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (51.7 kB view details)

Uploaded Aug 18, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

ccharts-0.2.0-cp313-cp313-macosx_11_0_arm64.whl (19.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.13macOS 11.0+ ARM64

ccharts-0.2.0-cp313-cp313-macosx_10_13_x86_64.whl (19.4 kB view details)

Uploaded Aug 18, 2026 CPython 3.13macOS 10.13+ x86-64

ccharts-0.2.0-cp312-cp312-win_amd64.whl (22.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.12Windows x86-64

ccharts-0.2.0-cp312-cp312-musllinux_1_2_x86_64.whl (50.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.12musllinux: musl 1.2+ x86-64

ccharts-0.2.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (51.7 kB view details)

Uploaded Aug 18, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

ccharts-0.2.0-cp312-cp312-macosx_11_0_arm64.whl (19.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.12macOS 11.0+ ARM64

ccharts-0.2.0-cp312-cp312-macosx_10_13_x86_64.whl (19.4 kB view details)

Uploaded Aug 18, 2026 CPython 3.12macOS 10.13+ x86-64

ccharts-0.2.0-cp311-cp311-win_amd64.whl (22.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.11Windows x86-64

ccharts-0.2.0-cp311-cp311-musllinux_1_2_x86_64.whl (50.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.11musllinux: musl 1.2+ x86-64

ccharts-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (51.5 kB view details)

Uploaded Aug 18, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

ccharts-0.2.0-cp311-cp311-macosx_11_0_arm64.whl (19.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.11macOS 11.0+ ARM64

ccharts-0.2.0-cp311-cp311-macosx_10_9_x86_64.whl (19.4 kB view details)

Uploaded Aug 18, 2026 CPython 3.11macOS 10.9+ x86-64

ccharts-0.2.0-cp310-cp310-win_amd64.whl (22.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.10Windows x86-64

ccharts-0.2.0-cp310-cp310-musllinux_1_2_x86_64.whl (50.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.10musllinux: musl 1.2+ x86-64

ccharts-0.2.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (51.5 kB view details)

Uploaded Aug 18, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

ccharts-0.2.0-cp310-cp310-macosx_11_0_arm64.whl (19.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.10macOS 11.0+ ARM64

ccharts-0.2.0-cp310-cp310-macosx_10_9_x86_64.whl (19.4 kB view details)

Uploaded Aug 18, 2026 CPython 3.10macOS 10.9+ x86-64

ccharts-0.2.0-cp39-cp39-win_amd64.whl (22.0 kB view details)

Uploaded Aug 18, 2026 CPython 3.9Windows x86-64

ccharts-0.2.0-cp39-cp39-musllinux_1_2_x86_64.whl (49.9 kB view details)

Uploaded Aug 18, 2026 CPython 3.9musllinux: musl 1.2+ x86-64

ccharts-0.2.0-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (51.3 kB view details)

Uploaded Aug 18, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64manylinux: glibc 2.28+ x86-64

ccharts-0.2.0-cp39-cp39-macosx_11_0_arm64.whl (19.2 kB view details)

Uploaded Aug 18, 2026 CPython 3.9macOS 11.0+ ARM64

ccharts-0.2.0-cp39-cp39-macosx_10_9_x86_64.whl (19.4 kB view details)

Uploaded Aug 18, 2026 CPython 3.9macOS 10.9+ x86-64

File details

Details for the file ccharts-0.2.0.tar.gz.

File metadata

Download URL: ccharts-0.2.0.tar.gz
Upload date: Aug 18, 2026
Size: 25.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ccharts-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`b551137bc4f45c7ea47ace1c0e8a41c7ac881c1db8780b73ce9edaf127864115`
MD5	`9f69c569a22906c71610a2be33c86cb4`
BLAKE2b-256	`f49375e035e51fc4c0dc5cb916f49aecae0e5b56b69d2fa5de7eeaa3b71ea22c`

Algorithm	Hash digest
SHA256	`bcb250248164366612a302b81af0cab0ba9c14b49c31256496723b30aacf7411`
MD5	`668554a161a0650748034d79a7079eaa`
BLAKE2b-256	`39510de029a1fc2ba3361ebde64cf5470b75e400049bcf6a87ee0559106d3728`

Algorithm	Hash digest
SHA256	`af9ad2ae19e45fad47ba60532d5585a2654249fcf3d2467aa7bafd0ceb6706ea`
MD5	`818eea83c7c36c16654c39437aaf3cca`
BLAKE2b-256	`7288d57c57c0c3a3b8f874d28162f35c81c8b21a50d46d8b8f3cbcb888d377f8`

Algorithm	Hash digest
SHA256	`661bc30d9a66336fe2ab0513c478d4956288fa343ecf3fd80f4d2bb61ce40cd7`
MD5	`0edaf14dee6bc0ef78f14d75730aed9c`
BLAKE2b-256	`7c8fabc65efb717456afc09e352458d6181b310c881b8515c2332e5ba110a867`

Algorithm	Hash digest
SHA256	`fbde8034f5f07d9cc2c4be519ddc01c7b99596b89b9c6ed4256e9ead46a0c933`
MD5	`cc232c7cf725a801baddd2be5579f733`
BLAKE2b-256	`7ebd27a92f303528677ad937753b98fc62dff0c1c80935f3119df121a6175578`

Algorithm	Hash digest
SHA256	`733b30f9c199d669ef30614f4ae7b196611bbe0f423f256dd43ea1e545e66a81`
MD5	`ad3ac9b229c4330fbf6bfb6ae5b240d6`
BLAKE2b-256	`33ce6c161a80b5162d08473629c25d701c14e6a2745b921fe56e88ae86bd3b80`

Algorithm	Hash digest
SHA256	`e74c3bcf04fa1472b8003ce3d308fdb3bce4e708d22ce74f629664193baa1a04`
MD5	`362c290316ca4ce28fa57934a1a83d12`
BLAKE2b-256	`7c357d44d41a2edefed91cd98e22c39c8db64cced0a1445d7e27f8ff545196a9`

Algorithm	Hash digest
SHA256	`e083ecc902cb8637ea3ed691401c86dfa2386238dcf30e171d78d2c1af4c3734`
MD5	`345646e8c7657d0b05aedeb2f030c824`
BLAKE2b-256	`c14d90d162cee22582f2b130fae1160260fcb5e810a8a77c6b6750b138cb85d4`

Algorithm	Hash digest
SHA256	`91a464844f1062bf74d05d47dceed0243b26efa589c7613ed3f9759be7005414`
MD5	`d83319d5d8fb8f9a59d48b40b3278cf9`
BLAKE2b-256	`d335b43ee51e62c11bf0cbfe8bbf9cbac6e6f5b723026d88c678f01fd1328080`

Algorithm	Hash digest
SHA256	`4ae608740ba4450daed698f6cf4c0c01ba6fa3a1bdc59ccf1a06fb1466ac57a5`
MD5	`da8bd1364d3084c299be5536344ad880`
BLAKE2b-256	`a3dd59b0c1fcaed8ae0b412ae3628c24574b3b510656d2444377de209a510220`

Algorithm	Hash digest
SHA256	`311ff38114b22941d4ca05f0fed831f9468f2617550a30d2a946a227f430b697`
MD5	`8a68514e65b873d0db735ffbc92a4342`
BLAKE2b-256	`1c202f00fc945bfcf85f6ad31154403dcacc952286afc740497b834c5fedba2c`

Algorithm	Hash digest
SHA256	`32e6c5dda6893374794e0fd5a287ba419562bdc15015c083b37f07b1023bd640`
MD5	`049d9cc99d514acfe2b6250569cff078`
BLAKE2b-256	`e4a6a55898ec2f8f91e884b0e7e0878c715b506cc57a3b3c226c2b2cfbb4d18b`

Algorithm	Hash digest
SHA256	`2c4d33da41208d7e78767619dad918b6c0cf2bb04395a5e6e4f6fdf03c685c7c`
MD5	`55aa26bab9e7e5d8cc8e65b3bdc58909`
BLAKE2b-256	`7174303a25e2f9ab393e8e70d34fa01e5531bc631766ae67d061e1da6f63ea8e`

Algorithm	Hash digest
SHA256	`dad57fbdd069247fb53f8061079930dc767148fdbbf1d90169167fea18367af5`
MD5	`ccfa7dcc3c4361b78d2cf90b79398857`
BLAKE2b-256	`2ddc6446cf500330f85a3e203810495aa8049881ce95d8e756b7508740111cea`

Algorithm	Hash digest
SHA256	`29ea3cb556b834c2a1332cfcf6dec036e3696e1ea9061a62d93825faa5f5a116`
MD5	`ecdca15637357e16a8e9a7091eba3347`
BLAKE2b-256	`ea64cf0537c1ce999b15a05a78ac9ce0e068c12fe8eaab3d6c32c837ecf3e861`

Algorithm	Hash digest
SHA256	`d2c29c5ea658deb95fc844499d5bb2bd95c6e8a1157d4e86ca52ee48d05aa1f8`
MD5	`b81c27c215a3325b7838994bb260568b`
BLAKE2b-256	`171de2e0fe9b64877718d2e2f5e7d90b8a47361dc73e281105cf857288b4f7f5`

Algorithm	Hash digest
SHA256	`bb395cc57b19e10f23630d9b19f067a10118bea09d0756ae9099812ad9e05765`
MD5	`5fd018c05da78f88cd9cf1e00053cba4`
BLAKE2b-256	`739f2c1c55fb1fed3a827672e272e25bd1b0d27b25e62e600633371cc65fef05`

Algorithm	Hash digest
SHA256	`d3daa082c4383bc434f3353852bc579c4fdddba9edd1cbf54037b40009eabe75`
MD5	`234df57e67ab4e2167ba6426725d1e86`
BLAKE2b-256	`dd7bd22cd213877dff6346702ed5ed770187662c06e9c470b42b31793d0cc3c0`

Algorithm	Hash digest
SHA256	`b494db5bbe0593121d327475d7c8a3f865edf9eebf28fc2dd7013500c644dfb8`
MD5	`dd54afd22625af508873da4e43fafee5`
BLAKE2b-256	`dfed20c8a28f418a9d2587bfe5d94096d8b594233c974bd8181eebee2d091cac`

Algorithm	Hash digest
SHA256	`58c4926fe02d69bfb7ddb743fc3c957f2a0a94cb2e3dab593dc7a0fcb9c1faca`
MD5	`1f8887a9ff1e2f52987a1a126df39c4e`
BLAKE2b-256	`4053a5e2085cb5ff81e2493f640f57846574f1bfa0dc9ac8e7cd0f0ce708abfc`

Algorithm	Hash digest
SHA256	`03c8670dd90d2c6442ea006fc51d16e7f2aeb69c7c01cd32a1eebcb5813d114e`
MD5	`e441c6ceb250bcdf49d4a4bf76da7ab6`
BLAKE2b-256	`af8c788e008d44e70fd609b1f473781dbb05c89bdbaba5df1ae2781300d02eec`

ccharts 0.2.0

ccharts

Installation

Features

C usage

Python usage

Settings

Input constraints

Windows / MSVC

Releases

Repository layout

Project links

Key dates

1 maintainer

Credits

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`e18f8253bb0dfd7c214ea9ff9ee1618bed72454af9ccae6fae22392de6548c5c`
MD5	`f635a99962c9acefe55c4c38fbf5aee2`
BLAKE2b-256	`630711e1c98caa86daf9977d73cf37c7dc5379068186be4f43e78d4a2f9431c1`

Algorithm	Hash digest
SHA256	`0e17832e6f556dae337c5ee255e01a6fbc7c0269b01ddcf012e53cc07da06fce`
MD5	`9efcc1e20021e400eb76bd33b537d011`
BLAKE2b-256	`5aec4943f930f071c73b57ae36981eb72ad38d9bac1c65bd6df6a2006bba66ca`

Algorithm	Hash digest
SHA256	`d7351e47c4d9ab0933637940160e6f1d00d2fbba4c566c92309513254a992f38`
MD5	`25670530d8a5bfc8b93ba7c832b17274`
BLAKE2b-256	`a90f896b7f4a82432d1db7cc9a1418ae81468a5a4ac5c646434ab72a8e009954`

Algorithm	Hash digest
SHA256	`371760480c852613c4a46aaa8e9641428bec3bc123b6d675b0d2dc4222c00899`
MD5	`8361f4035ec46c4740ff407fbd7e92d7`
BLAKE2b-256	`62a5ee90113d4299cda4d2f485a35ae50513628acf2fbfd5c59f0711a2d3676d`

Algorithm	Hash digest
SHA256	`62e060ff963dbf870daa1f2cfefd6f4ffc30f22582b6b5916ef4092ae004f230`
MD5	`303a483b30ef1acfd0d4def9cb8478c4`
BLAKE2b-256	`c4546c1dae5e78bd2ba89dc984d92f33a16270daa29dafa87f13c9fe3de2f923`

Algorithm	Hash digest
SHA256	`6318411f7bdfe06c73535b2e2ef0cab6c7de076f646ed6ebeafe0a06e1a8b1fb`
MD5	`db6fa1f3b1f85d868d9fbcfbc661420e`
BLAKE2b-256	`1ff7066649f39a4f1370785a37d81b6f95ced7c5bde9092aada0351640b20def`

Algorithm	Hash digest
SHA256	`cc06835228c6f9a4de7a7fc35759ef560e6a8a2e32efbb849d01f61bd7a48a66`
MD5	`372d80693c9501c64bd402b94ee16371`
BLAKE2b-256	`a1e3f34a37321c7e5bbe23ad1af91674d55df3512c805007c39e02f244f5249c`

Algorithm	Hash digest
SHA256	`d038c80e8e837c5aa8808a9661708e2b20b9212ad4802954eb3ba0b8109eae8d`
MD5	`8c2186d7d1c785360d759f828ce8b58e`
BLAKE2b-256	`cb12eda85bc153773ab91f901478cecd4f56987371aabaff771941bd898e233c`

Algorithm	Hash digest
SHA256	`0c59fa795a4d0c5514b0f1caec15a4a85fb46b761ec1df1376e3474b58738141`
MD5	`eaa63e089eb10c72aed6f6a179eda0b5`
BLAKE2b-256	`b2c85352f98e707e5fa627fc4d8ee5aa07f9e542b39768c2224e0ceecdcfdce9`

Algorithm	Hash digest
SHA256	`27b93a63a4c08fb5435c91baad291442cc576d8db89ee50129d81d723db7510b`
MD5	`8701c584d7203109e54aa63d3da9fdb3`
BLAKE2b-256	`340c605e132acfcc6ad1a95a03d14d2bcd484ba2b9cc7397cabfa2e222baf0f2`