Skip to main content
LI.FI Perps 是一个 TypeScript SDK,通过一个统一接口在多个交易场所交易永续期货。你调用相同的方法即可在任意受支持的交易场所下单,该交易场所的签名方案、凭证生命周期和行情数据结构均由 SDK 处理。 它要解决的不是路由问题。每个永续合约交易场所都有各自的授权模型、订单语义和推送协议,因此通常支持第二个交易场所就意味着要再写一套集成。而在这里,交易场所只是一个参数。

你将获得什么

一个接口,多个交易场所

无论由哪个交易场所执行,都用相同的调用方式下单、修改和取消订单。

无需每笔订单弹出钱包

用户在设置阶段签名一次。此后的交易由 SDK 管理的凭证进行授权。

内置推送能力

通过 WebSocket 获取价格、订单簿、成交和订单状态,连接按通道共享。

端到端类型化

线路类型来自核心 SDK 与每个交易场所插件共用的一个零依赖包。

支持的交易场所

每个交易场所都维护各自的设置状态和各自的交易签名方。在其中一个完成设置,并不代表在另一个也已完成设置。各交易场所特有的行为详见交易场所

各个包如何配合

核心 SDK 是一个包,每个交易场所是另一个包。你安装核心包,再加上你所需的交易场所对应的包。
底层是一个零依赖的线路类型包。各交易场所插件直接依赖它,并将核心 SDK 作为对等依赖,因此无论项目注册了多少个交易场所,最终都只会有一份 SDK。 SDK 暴露两层接口。服务函数是底层接口,接受一个客户端并返回交易场所数据。PerpsClient 位于其上层,负责整条操作流水线,也是大多数集成会使用的方式。

访问权限

Perps 不通过公共 API 主机提供服务。SDK 面向一个受限访问的接口,未获授权的请求会被拒绝。仅从 Partner Portal 获取 API 密钥并不足够;Perps API 的访问权限需要单独授予。

联系 LI.FI 销售团队

联系我们为你的集成商开通 Perps API 访问权限,确保你的集成所指向的环境是真正可以访问的。

后续步骤

快速开始

安装、创建客户端、读取行情、下单。

概念

创建、授权、执行这一模式,以及凭证存放在哪里。

交易场所

各交易场所的签名模型、设置、存款和提款。

完整 SDK 参考

方法级参考、API 参考和错误码。