Harbor SDK
manifest
manifest 是策略的声明。平台用它决定策略能碰哪些交易所、哪些市场、哪些交易对,以及创建实例时要让用户填哪些参数。
| 字段 | 写法 | 作用 |
|---|---|---|
| name | 字符串 | 策略名称,显示在实例上 |
| version | 字符串,如 1.0.0 | 策略版本 |
| ccxtIds | 字符串数组,如 ["binance"] | 允许的交易所 |
| markets | ["spot"]、["swap"] 或两者 | 现货、永续,或同时使用 |
| symbolMode | single、dual、basket | 单标的、双腿或篮子 |
| symbols | Harbor symbol 数组 | dual 和 basket 必须写明 |
| params | 参数定义 | 创建实例时展示给用户的字段 |
| permissions | market、order、account | 声明要用到的运行时能力 |
01symbolMode
- single:一个交易对。创建页选择即可,symbols 可以不写。
- dual:两条腿,例如现货 BINANCE:BTC/USDT 加永续 BINANCE:BTC/USDT:USDT。必须写 symbols,两条都要列出来。
- basket:多个交易对之间切换或再平衡。必须写 symbols。运行中只能使用这份名单。
02params
每个参数有 type、label,枚举还要有 options。type 可以是 number、string、boolean、enum。label 是创建页上的字段名。用户填的值在实例参数里,不要在代码里再写死一份不同的数量。
const manifest = {
name: "示例",
version: "1.0.0",
ccxtIds: ["binance"],
markets: ["spot"],
symbolMode: "single",
params: {
amount: { type: "number", label: "数量" },
},
permissions: ["market", "order", "account"],
};