ta4j
id:ta4j/ta4j ·
· 目录记录
项目概述
ta4j是用于技术分析和交易系统研究的开源Java库:把OHLCV数据放入BarSeries,用指标与规则组成策略,在明确成本与成交假设下回测,并可用同一套策略逻辑在应用中做实时评估。它提供研究与信号框架,但不是订单管理系统,也不保证盈利。运行核心库需要Java 25+。
原项目介绍
忠实中文 / 作者自述整理
作者强调可复现研究而非保证回报,帮助把交易想法精确表述并在显式假设下测试。特性包括多种BarSeries、指标与形态目录、可组合的Indicator/Rule/Strategy API、回测与走步研究、交易成本/滑点/部分成交等执行真实感、绩效准则与图表,以及预测和把策略逻辑复用到实时应用(数据与下单仍由应用负责)。安装只需ta4j-core(文档示例0.29.0);示例模块含Yahoo/Coinbase/CSV等数据源。Quick start可用自带Bitcoin数据跑示例,或按BarSeries→Indicator→Rule→Strategy→TradingRecord编写EMA交叉。许可为MIT,并声明回测不是未来盈利证据。
短摘 / 原文
ta4j is an open-source Java library for technical analysis and trading-system research.
出处:https://github.com/ta4j/ta4j/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
ta4j是用于技术分析和交易系统研究的开源Java库:把OHLCV数据放入BarSeries,用指标与规则组成策略,在明确成本与成交假设下回测,并可用同一套策略逻辑在应用中做实时评估。它提供研究与信号框架,但不是订单管理系统,也不保证盈利。运行核心库需要Java 25+。
谁会用
希望在JVM应用中用Java构建、回测或复用交易策略逻辑,而不依赖Python桥或不想使用专有策略DSL的开发者与研究者。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
Java应用需要在显式假设下构建、回测和评估交易策略,并把同一套规则用于后续实时判断。
文档化使用场景(编辑归纳)
用Java 25+引入ta4j-core,将OHLCV载入BarSeries并组合指标/规则回测;活盘下单与对账须由应用自建,回测不是盈利证明。
主要能力与用途
核心模型为BarSeries上的指标、规则与策略,再生成TradingRecord;可用BarSeriesManager在历史序列上运行,并用交易成本/借贷成本模型计算净收益与回撤等准则。
指标与形态覆盖均线、动量、波动、成交量、K线形态等目录;也提供预测类指标接口,文档强调在索引i只使用到i的数据以避免前视偏差。
ta4j-examples提供可运行示例、Yahoo Finance/Coinbase/CSV/JSON等数据加载以及基于JFreeChart的作图;这些示例不是核心库的运行时依赖。
文档区分回测与活盘:同一Strategy可评估新到达的K线,但活盘必须由应用负责下单、成交确认、去重、重启对账和部成/拒单,并在收盘K与未收盘K之间显式选择。
如何使用 / 既有稿流程
文档场景:用Maven引入ta4j-core(Java 25+)→把自有或示例OHLCV载入BarSeries→编写指标与入场/出场规则组成Strategy→用BarSeriesManager(可加成本模型)回测并查看准则或图表。若尝试活盘,须另建自己的数据与订单适配,并阅读官方live runbook。本研究不运行mvnw示例,不连接Yahoo/Coinbase,不下单。
用法证据状态
documented_workflow_only_not_executed
公开限制
需要Java 25+;更低JDK不能按当前文档直接使用。
作者明确ta4j不是OMS,也不承诺正确性或盈利;回测只反映所编码的假设。
交易所/券商连接、数据清洗和公司行动调整需调用方自己处理;示例数据源可用性未验证。
元数据许可快照为NOASSERTION,README写MIT,全文未读,以原文为准。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
NOASSERTION
discussion_zh
README写明MIT License;元数据快照为NOASSERTION。全文未读。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
Java应用需要在显式假设下构建、回测和评估交易策略,并把同一套规则用于后续实时判断。
documented_use_case_zh
用Java 25+引入ta4j-core,将OHLCV载入BarSeries并组合指标/规则回测;活盘下单与对账须由应用自建,回测不是盈利证明。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:56:36.081628+08:00
来源
https://github.com/ta4j/ta4j/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/ta4j/ta4j/README.md.phase036-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:56:16.344705+08:00", "sha256": "af8df5ad6a9f06a4395a8b1fb6ce5d78fb81f327b75e8226c88b23db820ebb91", "read_scope": "选读README的定位、特性表、安装、Quick start与核心工作流、活盘边界及风险声明;不运行示例,不当回测为收益证明", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:16+08:00", "description": "A Java library for technical analysis.", "topics": [ "bitcoin", "ethereum", "forex", "java", "java-library", "stocks", "ta4j", "technical-analysis", "trading", "trading-algorithms", "trading-strategies" ], "record_sha256": "a5ac435b6a90cb2eba4b1cf1e2a21dcdb3807b7915a987bcbf962d202c3ff0f2", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "选读README的定位、特性表、安装、Quick start与核心工作流、活盘边界及风险声明;不运行示例,不当回测为收益证明",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "91d89435c990ab5c81088e3dee908095b8d62512bf141514c7d87ef540e6b40c"
}