什么是Stove Taker Api
Stove Taker API 是专为券商或托管机构（Taker）设计的交易接口服务，基于 Stove Protocol 构建，支持在去中心化金融生态中高效执行订单操作。该 API 提供完整的订单生命周期管理能力，包括订单校验、锁定、成交与撤单响应，同时支持实时查询订单状态与历史成交记录。通过标准化的 HTTP 接口和 WebSocket 推送机制，Taker 可无缝集成至自动化做市系统或量化交易平台，实现低延迟、高可靠性的交易撮合流程。其设计遵循 RESTful 规范，采用 JSON 格式传输数据，并通过 API Key 进行身份认证，确保接口调用的安全性与可追溯性。无论是测试环境还是生产部署，Taker API 均保持一致的交互逻辑，便于开发者在不同阶段快速验证与上线。
核心功能特点
- 支持订单校验、锁定、解锁、部分/全部成交及拒绝等全流程订单操作
- 提供 Taker 侧订单列表与成交记录的批量查询功能，支持按标的、交易所、状态筛选
- 内置命令行工具封装常用接口调用，仅需 Python 标准库即可运行，无需额外依赖
- 支持 WebSocket 实时订阅订单状态变更与撤单事件，实现低延迟通知机制
- 采用 X-API-Key 认证方式，保障接口访问安全，兼容测试与生产双环境
适用场景
Stove Taker API 主要面向需要主动参与链上订单匹配的金融机构或专业交易机构，典型应用场景包括自动化做市策略、流动性提供者管理系统以及跨交易所套利机器人。例如，当 Maker 在链上发布限价订单后，Taker 可通过 API 快速校验订单有效性并决定是否承接；若接受，则可立即锁定订单以防止重复撮合，随后根据市场情况选择部分或全部成交，并在完成后更新订单状态。此外，机构可通过定期拉取订单列表与成交记录，监控自身交易表现并优化风控模型。对于高频交易场景，WebSocket 推送机制允许 Taker 实时接收订单状态变化，从而缩短响应周期，提升资金利用效率。该 API 尤其适用于希望将传统券商系统与 DeFi 协议桥接的机构，在不依赖第三方撮合平台的前提下自主控制交易流程。