TradePose Models
TradePose Models contains independently versioned Pydantic and Polars contracts shared by the public TradePose Client and private TradePose systems. It keeps serialized strategy, execution, result, and market-data shapes consistent across those boundaries.
Installation
Ordinary users should install only tradepose-client:
uv add tradepose-client
Do not install or manually pin tradepose-models directly. The Client dependency
constraints select a compatible Models version for its public API and wire contracts.
If a package resolver reports a Models conflict, upgrade tradepose-client instead of
guessing a Models version:
uv lock --upgrade-package tradepose-client
uv sync
Direct installation is intended only for maintainers of systems that implement the shared TradePose contracts.
Canonical research Workloads
Maintainers can import the closed research execution contract from
tradepose_models.research. Workload and TaskSourceBinding use only the exact
current typed schema and carry no schema-version field. They require the
canonical-json-v1 and research-execution-v1 capability revisions; unknown,
missing, legacy schema-version, and extra fields fail closed. Use
canonical_workload_bytes() and canonical_task_source_binding_bytes() for transport, the typed ref helpers for
content identity, and binding_requirements() to derive source roles solely from the
Workload's MarketDataSpec.
Use validate_research_result_frame() at Python artifact boundaries to verify a typed
ResearchTaskRequest, its kind-required Workload/Indicator manifests, exact physical
Polars schema and nullability, indicator Struct fields, and canonical Policy row order.
The validator intentionally does not cast: accepting a convertible dtype would hide a
Worker wire-schema violation. Perform any desired data conversion only after canonical
artifact admission, outside this contract check.
For trades, all 45 Core columns are mandatory in their producer order and retain
their exact dtype through Parquet, including empty and all-null scenarios. The Worker
adds only a non-null trailing policy_ref. Missing, extra, reordered, physical Null,
or castable-but-wrong columns are rejected without compatibility fallback.
MarketDataSpec contains the complete direct/resampled source lineage and normalized
indicator computation DAG. market_data_spec_from_compiled_graph() is the sole narrow
projection from the validated authoring graph; it verifies every physical computation
identity and preserves typed dependencies, selected multi-output fields, shift, and
publication alignment. It is not a second runtime contract.
This package does not compile authoring sources, resolve catalogs, admit Tasks, or execute Workloads. Those remain separate service boundaries.
Runtime requirements
- Python 3.13 or newer
- Pydantic 2.12.1 or newer
- Polars 1.33.1
Models is Alpha software. Its version is independent from the Client version, and contract-breaking changes may require a coordinated Client upgrade.
Support and license
- Homepage: tradepose.com
- Support: admin@tradepose.com
- Status: Alpha
- License: MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tradepose_models-2.11.0.tar.gz.
File metadata
- Download URL: tradepose_models-2.11.0.tar.gz
- Upload date:
- Size: 190.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
356898e97f2a90be12bce09fa9bc776818c017ab730b3a7243726f4b0894d4b9
|
|
| MD5 |
b3875a746ebeaca29b774f32def2855c
|
|
| BLAKE2b-256 |
362bd7ff4bd2485bf0807c95a797e0b4027e28d68d80f257b887facb622a76d9
|
File details
Details for the file tradepose_models-2.11.0-py3-none-any.whl.
File metadata
- Download URL: tradepose_models-2.11.0-py3-none-any.whl
- Upload date:
- Size: 182.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8b4691e39a04dba833419de848158c6a7b9bf3a4545d38eeb820a5cba938e16c
|
|
| MD5 |
8444c7af71124054bcef84549cb4a155
|
|
| BLAKE2b-256 |
1fc012176f35d273f1738ca15c91b520ed2377b6ed51ee13e671b96aa828fae7
|
