深入了解 Origami Tech 中的 Percept Labs 图表集成
简介
当价格图表不仅能展示市场，还能展示交易者账户内发生的情况时，它的价值就会大大提升。
Origami Tech 集成了 Percept Labs 的图表技术，将市场数据与成交记录、活跃订单、未平仓位、盈亏平衡价位和强平线一并显示。此次集成基于 Origami Tech 交易终端内提供的图表层 PerceptChart，以及 Percept Labs 开发的金融图表库 TitanCharts。
对于运行加密货币交易机器人或管理多个自动化策略的交易者而言，这在市场走势与实际执行之间建立了直接联系。
从市场价格到交易背景
传统图表展示的是某一品种的价格随时间的变化。而交易终端还必须展示用户或自动化策略与这一走势的互动情况。
在 Origami Tech 中，PerceptChart 将这两层信息结合在一起。
交易者可以在同一张图表上对照相应的价格走势查看已完成的成交，监控活跃订单，跟踪未平仓位，并查看盈亏平衡价位和强平价位。用户无需把订单表中的时间戳与单独的行情界面逐一比对，就能在当时的市场背景下复盘交易。
这样可以更容易地了解策略在何处入场、成交后价格如何变动，以及当前仓位相对于近期波动性的结构。
这一区别对自动化交易机器人尤为重要。已实现 PnL、未实现 PnL、手续费、交易量和交易次数等汇总指标描述的是策略的结果，却未必能解释这一结果是如何产生的。
成交标记和仓位价位提供了另一层分析维度。交易者可以看到订单是否按预期价位下达、多笔成交是否集中在某一区域，以及市场转向时机器人如何反应。
PerceptChart 和 TitanCharts 如何融入 Origami Tech
PerceptChart 是嵌入 Origami Tech 的面向用户的图表界面。TitanCharts 则提供底层金融图表技术。
此次集成可分为三个功能层：
层级 作用 Origami Tech 连接交易所、账户、机器人、订单、仓位和执行工作流程 PerceptChart 在交易终端内显示市场和账户活动 TitanCharts 处理金融数据、渲染图表，并支持交易叠加层和图表交互
Percept Labs 专注于图表基础设施。Origami Tech 则将这一基础设施与交易所数据、交易账户和订单执行连接起来。
这种分工很重要，因为图表本身并不独立执行交易。它负责显示市场和交易信息，并返回用户交互产生的事件。Origami Tech 处理这些事件，应用自身的账户和交易逻辑，并将生成的指令路由到所连接的交易所。
因此，对于多交易所加密货币交易机器人平台而言，图表是更大的执行环境的一部分，而不是一款独立的分析产品。
在图表上查看订单、仓位和成交
PerceptChart 让账户活动能够与市场行情同屏显示。
根据所选市场和账户，界面可以显示：
- 活跃订单；
- 已完成的成交；
- 未平仓位；
- 盈亏平衡价线；
- 强平线；
- 与所选品种相关的交易信息。
这让交易者能够更清楚地看到未平仓位与市场之间的关系。
某个仓位在特定时刻可能盈利，也可能亏损，但仅凭 PnL 数字无法看出每笔成交后市场的走向。图表则可以揭示该仓位是在突破期间建立的、在多个价位逐步累积的，还是在长时间的大幅波动后与当前价格相距甚远。
对于加密货币机器人交易而言，这种可视化背景还有助于对比预期的策略逻辑与交易所的实际执行情况。
策略可能被配置为在特定价位下单，但最终结果仍可能受到市场走势、订单状态、部分成交和流动性变化的影响。将实际成交显示在图表上，可以更方便地复盘这些行为。
从历史成交出发管理交易
Origami Tech 还将历史成交与下单工作流程连接了起来。
交易者可以在图表上选择一笔已完成的交易，打开下单界面，配置反向交易并提交新订单，同时保持原始成交可见。
当市场出现大幅或持续的波动而现有仓位仍未平仓时，这一工作流程会很有用。交易者无需手动重建背景信息，可以直接从需要关注的那笔成交开始操作。
下一步操作可能包括减少部分敞口、围绕现有仓位再下一笔订单、调整平均入场价，或捕捉反方向的短线行情。
这类工作流程还可用于围绕未平仓位进行主观剥头皮交易。但不应将其与全自动的加密货币剥头皮机器人混为一谈：该示例展示的是交易者通过图表界面主动发起反向交易。
建议图注：
交易者选择一笔历史成交，打开订单面板，配置反向交易并提交，同时原始交易仍显示在图表上。
图表为这一流程提供可视化和交互层。账户状态、订单验证、交易逻辑以及将订单路由到所连接交易所的工作，仍由 Origami Tech 负责。
交易信息如何传递到图表
TitanCharts 提供交易 API，应用程序可通过该 API 将交易状态传递到图表中。
这些状态可能包括仓位、活跃订单、成交记录以及止盈或止损括号单。TitanCharts 会将提供的数据转换为线条、标记、标签和交互控件等可视元素。
总体关系如下：
Connected exchange
↓
Origami Tech market and account layer
↓
Normalized candles, orders, positions, and executions
↓
PerceptChart powered by TitanCharts
↓
Chart lines, markers, labels, and interactions当用户从图表发起操作时，方向则相反：
Interaction with a chart element
↓
TitanCharts event
↓
Origami Tech trading and validation logic
↓
Connected exchange这种分工使可视化与执行保持分离。
即使订单管理操作始于图表，也必须先经过 Origami Tech，才能到达交易所。
有关可用交易对象和交互模型的更多信息，请参阅官方 TitanCharts Trading API 文档。
历史与实时市场数据
TitanCharts 旨在处理历史 K线和实时市场更新。
当交易者打开图表时，应用程序可以加载所选品种和时间周期的初始价格历史。当用户在图表上向前回溯时，可以加载更早的 K线，而流式更新则让最新的市场信息保持实时。
TitanCharts 使用以下官方 IOHLCV 结构表示 K线数据：
interface IOHLCV {
time: number; // Unix timestamp in seconds
open: number;
high: number;
low: number;
close: number;
volume?: number;
}每个对象包含一根 K线的时间戳、开盘价、最高价、最低价、收盘价以及可选的成交量。
time 字段使用 Unix 秒。这一点很重要，因为交易所和金融数据提供商返回的时间戳可能采用不同的单位或结构。Origami Tech 必须先对交易所数据进行规范化，再将其传递给图表层。
TitanCharts 还支持实时数据更新。其文档中说明的 updateMainData(tick) 方法会根据所选时间周期，判断传入的更新应修改当前 K线还是创建新的 K线。
官方实现细节请参阅 TitanCharts Core Concepts 和 Data Loading 部分。
WebSocket 数据与中断后的恢复
实时金融图表通常使用 WebSocket 连接来接收持续的市场更新，而无需反复请求完整数据集。
然而，WebSocket 连接可能会断开，或在中断期间丢失数据。因此，TitanCharts 支持一种生产环境的数据加载模型，可将流式更新与历史数据请求和定期轮询结合使用。
历史加载提供初始数据集和更早的 K线。WebSocket 更新让最新的市场信息保持实时。轮询则有助于恢复临时连接问题后丢失的数据。
在信息到达 PerceptChart 之前，Origami Tech 负责处理与交易所的连接。
这是必要的，因为不同交易所可能使用不同的品种标识符、订阅格式、K线结构和时间戳约定。交易终端会对这些信息进行规范化，使图表层能够使用一致的数据模型。
因此，TitanCharts 无需为 Origami Tech 支持的每个交易场所单独编写渲染逻辑。
TitanCharts 4 中的统一市场模型
TitanCharts 4 引入了统一的 Market 模型，取代了此前将交易品种和交易所视为独立属性的做法。
这一变化对多交易所交易终端尤为重要。
仅凭代码并不总能确定一个市场。同一标的资产可能在多个交易场所上线，名称各不相同，也可能分属现货和永续合约等不同的市场类型。
因此，所选图表必须与正确的品种、交易场所、K线历史、活跃订单和仓位数据保持同步。
统一市场模型让图表层能够将品种和交易所视为同一市场背景的组成部分。
对 Origami Tech 而言，这让界面中所选市场与其相关交易信息之间的对应关系更加清晰。
有关 TitanCharts 4 架构变化的详细信息，请参阅官方 TitanCharts v4 迁移指南。
对比不同图表和时间周期
Origami Tech 支持在多个图表面板之间进行同步交互。
缩放、水平移动和十字光标位置可以在各图表之间保持一致。这样，交易者无需逐个操作每个面板，就能比较多个时间周期、相关品种或同一市场的不同视图。
例如，交易者可以在短时间周期上复盘一笔成交，同时让更长周期的图表对齐到同一时段。
短时间周期展示成交前后的即时状况，较长时间周期则呈现更宏观的市场结构。
这在复盘自动化策略时非常有用，因为同一笔交易在不同时间周期下看起来可能截然不同。5 分钟图上的急剧波动，可能只是更大趋势中的小幅震荡。
同步图表可以同时保留对同一事件的两种视角。
为何基于图表的执行数据至关重要
自动化策略可能会下达数十甚至数百笔订单。仅通过表格复盘这些活动，很难理清事件的先后顺序。
基于图表的执行数据提供了一种更直接的方式来检视策略的运行情况。
交易者可以查看订单的下达位置、每笔成交后市场的走势、仓位的演变过程，以及仓位距离盈亏平衡价或强平价有多近。
这并不能取代业绩分析。
图表无法判断策略使用的资金量是否合适、是否承担了过高风险，或是否产生了可持续的回报。这些问题需要借助已实现和未实现 PnL、手续费、敞口、资金配置和最大回撤等账户指标来回答。
图表回答的是另一个问题：策略在市场中的表现如何？
对于使用交易机器人的交易者而言，这两个层面缺一不可。业绩指标描述财务结果，而图表数据解释其背后的执行背景。
Percept Labs 与 Origami Tech
Percept Labs 致力于开发金融图表和实时市场数据技术。
其 TitanCharts 库为金融应用提供无头图表核心、框架集成、历史和流式数据支持、交易叠加层以及交互式图表工具。
Origami Tech 将这项技术与交易所、交易账户、机器人、订单、仓位和执行工作流程连接起来。
两套系统共同打造出一个让价格分析与账户活动不再割裂的交易界面。
交易者可以查看成交发生的位置，监控活跃订单和仓位价位，复盘自动化策略，并在保留原始交易背景的同时发起新的操作。
常见问题
Origami Tech 中的 PerceptChart 是什么？
PerceptChart 是嵌入 Origami Tech 交易终端的图表界面。它由 Percept Labs 的 TitanCharts 技术驱动，将市场数据与成交记录、活跃订单、未平仓位、盈亏平衡价位和强平线一并显示。
PerceptChart 和 TitanCharts 有什么区别？
PerceptChart 是 Origami Tech 内面向用户的图表层。TitanCharts 是 Percept Labs 开发的底层金融图表库。Origami Tech 将图表层与交易所数据、账户、机器人、仓位、订单和执行工作流程连接起来。
TitanCharts 可以直接执行交易吗？
TitanCharts 提供可视化、交易叠加层和图表交互事件，但不会独立执行交易。Origami Tech 负责处理操作，应用账户和交易逻辑，并将指令路由到所连接的交易所。
此次集成可以用于复盘加密货币交易机器人吗？
可以。成交记录、活跃订单、仓位、盈亏平衡价位和强平线都可以对照市场价格走势显示。这有助于交易者对比交易机器人的预期策略与实际执行行为。
TitanCharts 支持哪些市场数据？
TitanCharts 支持历史和实时金融数据，包括 OHLCV K线。它可以加载更早的市场历史、接收流式更新、在不同时间周期之间切换，并在新数据到达时更新当前 K线或创建新的 K线。
