Mobius 使用文档 · 更新于 2026-10-15
从看行情开始,再接入交易账户
先完成账户接入和读取核对,再理解两腿与规则。不要用“开仓”测试 API,也不要照着参考截图把权限全部勾上。
只想看行情?可以先不添加账户。未添加账户时可以查看交易所行情,但不能下单。接入表单要求“交易(不含提现)”权限。
创建前准备好这四项
- 可登录的目标主 / 子账户与官方站点,确认是真实资金主网还是独立测试环境。
- 页面要求的身份验证、2FA 或已连接的主钱包;密码和验证码只在官方页面输入。
- 当前 SM FUND 部署的固定 API 请求公网出口 IP。先向部署维护者确认;它不一定是网站域名解析地址,也不一定是你电脑的 IP。
- 可信的密码管理器或加密存储,用来成组保存 Key / Secret / Passphrase 或专用 API 钱包私钥。
实际操作路径
在“设置”中添加交易所账户
- 打开“设置”
选择左侧未添加的交易所;也可在“全部交易所”的对应行点“添加”。
- 填写账户名称与专用凭据
账户名称由你自定义,用于区分同一交易所的不同账户,并显示在价差两腿上。不要填 UID、登录密码或主钱包助记词。
- 确认“验证并保存”
凭据会提交到当前部署的服务端并加密保存,之后不再显示。只在你信任的部署中填写。
- 查看识别结果
核对账户类型、API 权限、可交易产品与私有账户流。需要更换密钥时使用“更换”,新密钥必须对应同一个交易所账户。
凭据保存在服务端,不只在本机浏览器给交易所设置 IP 白名单时,应确认该部署实际请求的公网出口 IP;不要默认填个人电脑或域名解析的地址。
账户类型如何判断
表单没有手动切换经典 / 统一、全仓 / 逐仓、单向 / 双向模式的选项,验证后会自动读取账户信息。“标准账户”是站内展示标签,不代表交易所具体的保证金模式。不要为了接入去改账户模式或杠杆。
| 交易所 | 可见产品 | 账户模式说明 |
|---|
| Hyperliquid | 永续合约 / 现货 | 已接入详情显示“标准账户”;不是对全仓、逐仓或其他模式的完整支持证明。 |
| OKX | 现货 / 永续合约 | 已接入详情显示“标准账户”;实际账户模式由验证读取,未展示独立的保证金模式选择框。 |
| Binance | 现货 / 股票合约 / U 本位合约 | 已接入详情显示“统一账户(Portfolio Margin)”;不代表新用户必须升级,也不证明其他模式都已验证。 |
| Bybit | 现货 / 期货 | 未接入表单提示验证后自动识别账户类型与产品;未实测具体账户或保证金模式。 |
| Gate | 现货 / 期货 / 股票合约 / CrossEx 合约 / CrossEx 现货 | 验证后识别账户类型与已开通产品;显示模块不等于账户有权限或已经通过交易测试。 |
| Bitget | 现货 / 期货 | 验证后自动识别;当前表单没有账户模式或单向 / 双向选择框。 |
| Aster | 期货 / 现货 | 验证后识别;当前表单没有主账户地址 user 或代理地址 signer 输入框。 |
产品名称是界面标签;列出某个模块不代表该账户已开通、所有合约都支持,或某种模式已完成交易测试。
按平台查看
选择你的交易所
先在交易所创建凭据,再回到 SM FUND 按实际字段填写。
API 钱包Hyperliquid 接入
交易所设置入口 ↗官方指南 ↗
第一步:在交易所创建专用凭据
已补 More 导航、名称、Generate / Authorize API Wallet、有效期与最终 Authorize 位置;私钥显示区与主钱包签名弹窗不收录。
步骤 1
确认账户并找到入口
在官方应用连接实际用于交易的主钱包,确认主网及目标账户;首次使用先按官方页面核查账户是否已开通。主钱包助记词和私钥不填写到套利工具。 登录后的导航入口可从 More → API 找到。
图 1从 More 菜单进入 API
在上方 More 下拉菜单找到 API;这是登录后的导航示例,账户连接仍由你在官方页面完成。

步骤 2
命名专用 API 钱包
打开 API 页面,填写独立的 API 钱包名称,例如 arbitrage-tool,点击 Generate(生成),生成专用 API 钱包地址。
图 2官方 API 钱包入口
对应“打开 API 页面”:先认清名称、API Wallet Address、Generate 和 Authorize API Wallet 的位置。
本次仅查看未连接钱包的空白页面,未生成或授权。页面提示地区限制,已保留在图中;适用性以官方规则为准。

图 3填写独立 API 钱包名称
在名称输入框填写自己的用途名称,例如 arbitrage-tool。
CryptoCopy 是原教程的名称示例,无需注册或接入该工具。

步骤 3
生成并打开授权窗口
点击 Authorize API Wallet(授权 API 钱包)打开授权窗口。此时是在打开窗口,还未完成最终授权。
图 4生成地址,再打开授权窗口
先点击 Generate,再点击 Authorize API Wallet。图中长串 0x 值是 API 钱包地址,不是私钥,也不是主账户地址。
不要复制图中的示例地址;当前 SM FUND 主账户不需要输入主地址。

步骤 4
保存私钥与设置有效期
在授权窗口设置有效天数,把显示的专用 API 钱包私钥保存到可信密码管理器或加密存储;核对其对应地址,确认已保存后再继续。
图 5有效期与最终 Authorize 按钮
先保存专用私钥,再在 Days Valid 设置有效期,最后由主钱包确认授权签名。
本图不含私钥显示区。180 天 / MAX 是原教程示例,不是通用要求;以官方当前可选范围和自己的需求为准。

步骤 5
签名并核对授权成功
核对官方域名、有效期和授权内容,点击窗口内的授权按钮,并由主钱包完成签名确认。返回 API 管理页确认该代理已列出且未过期;只有生成地址而没有完成授权不算完成。
第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 Hyperliquid,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| 子账户地址(主账户留空) | 主账户留空;接入子账户时填真实子账户 0x 地址 |
| API Wallet 私钥 | 已授权专用 API 钱包的私钥,非主钱包私钥 |
最容易填错的地方主账户:子账户地址留空,只填专用 API Wallet 私钥。子账户:在“子账户地址”填真实子账户 0x 地址,再填被授权的 API Wallet 私钥。当前表单没有主钱包 Address 输入框。
首次添加看字段,不找“更换”按钮下图来自已有账户的空白“更换”区域,只用于核对凭据名称。首次添加还要填账户名称,并使用“验证并保存”;“验证并更换”只用于已有账户更新凭据,且必须仍是同一交易所账户。
图 6 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
Hyperliquid 接入后重点核对先比对官方同一主 / 子账户、同一现货或永续市场的余额、持仓和挂单。主账户接入时“子账户地址”必须留空;子账户接入填真实子账户地址,不能填 API 钱包地址。若主账户识别仍失败,保留脱敏错误联系支持,当前表单没有主地址输入框。
平台注意事项API 钱包用于代理签名。不同交易进程宜使用不同 API 钱包,减少 nonce 冲突。撤销或过期后新建代理,不复用已撤销的地址。
已接入详情显示“标准账户”;不是对全仓、逐仓或其他模式的完整支持证明。
API KeyOKX 接入
交易所设置入口 ↗官方指南 ↗
这份教程使用什么权限?SM FUND 添加表单要求“交易(不含提现)”。保留必要读取,只开所需市场的交易权限,提现关闭;只看公开行情可以先不添加账户。
第一步:在交易所创建专用凭据
已补头像入口、Create API、用途 / 名称 / 口令 / IP 完整表单、权限与创建后列表;不收录完整凭据和二维码,2FA 按官方页面提示处理。
步骤 1
打开 API 创建入口
登录实际持有资金的主账户或子账户,进入头像菜单 → API 与连接(API and connections)→ 创建 API。
图 1从头像菜单进入 API
右上角头像菜单 → API。新版可能合并为 API 与连接,按官方当前页面进入。

图 2点击 Create API
在 APIs 页面右上角找到 + Create API。

步骤 2
填写用途、名称与 API 口令
填写用途名称,核对 Account(账户)和 Used for(用途)。本手册走自行填写 Key / Secret 的接入路径;不要把其他应用的第三方绑定当作 SM FUND 授权。设置并保存本组 API Passphrase,它不是登录密码。
图 3用途、名称、Passphrase 与 IP 表单
手工 Key / Secret 接入选择 API trading;填写 API name、自定义 Passphrase,并在 IP address allowlist 填真实执行端公网出口。
这是公开教程的界面参考;空白或 optional 不表示应省略当前部署的白名单。图中规则与界面若变化,以官方指南为准。

步骤 3
绑定实际执行端 IP
填入当前 SM FUND 部署实际发请求的固定公网出口 IP;不知道时先向部署维护者确认,不用域名解析地址或截图示例代替。
步骤 4
核对所需市场与权限
保留读取,并为计划使用的现货或永续开启交易权限。提现关闭;另外逐项检查 Transfer(划转)、Loan(借贷)、Earn(理财),不因 Trade 已勾选就忽略它们。
图 4读取、交易与提现开关
在权限区保留 Read,按需要选 Trade,Withdraw 不选。
此图没有展示新版 Transfer / Loan / Earn,请在完整页面另外逐项核对。

图 5创建 API 的交易市场与权限
对应“设置权限”:读取与所需交易市场匹配,提现关闭。
图中同时选择现货 / 杠杆及永续,不是所有用户必须全选;额外检查 Transfer、Loan、Earn 开关。

步骤 5
验证并保存同组凭据
提交后完成页面要求的安全验证。把生成的 API Key、Secret Key 与自己设置的 Passphrase 作为一组安全保存;不要关闭页面后才尝试找回 Secret 或口令。
图 6创建后列表核对名称与权限
创建成功后核对自定义名称、用途和权限;完整 Key / Secret 要在自己的官方展示页安全保存,星号不是可用 Key。
Coinrule Trading API 仅为来源账户的名称示例;无需连接 Coinrule。图中不展示完整密钥。

第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 OKX,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| API Key | 交易所生成的 API Key,不是 UID |
| API Secret | 与上方 Key 同一组的 Secret |
| Passphrase | 创建本组 API 时自己设置的 API 口令 |
最容易填错的地方Key 与 Secret 填同一组 API 凭据,Passphrase 填创建这一组 API 时自己设置的口令,不是登录密码。
首次添加看字段,不找“更换”按钮下图来自已有账户的空白“更换”区域,只用于核对凭据名称。首次添加还要填账户名称,并使用“验证并保存”;“验证并更换”只用于已有账户更新凭据,且必须仍是同一交易所账户。
图 7 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
OKX 接入后重点核对核对主 / 子账户与账户类型,并逐项比对现货、永续的余额、持仓和挂单。口令错误先检查本组 API Passphrase;模式不匹配时保留错误核查兼容性,不直接切换账户模式。
平台注意事项除读取与交易外,还要检查 Transfer(划转)、Loan(借贷)、Earn(理财)及 Withdraw(提现)开关。OKX 当前 FAQ 说明,部分原先启用 Trade 的密钥在权限更新后会自动启用前三项;检查旧密钥的实际权限,不能只确认“提现关闭”。Passphrase 遗失需重建密钥。
已接入详情显示“标准账户”;实际账户模式由验证读取,未展示独立的保证金模式选择框。
系统生成 APIBinance 接入
交易所设置入口 ↗官方指南 ↗
这份教程使用什么权限?SM FUND 添加表单要求“交易(不含提现)”。保留必要读取,只开所需市场的交易权限,提现关闭;只看公开行情可以先不添加账户。
第一步:在交易所创建专用凭据
已补 Account / API 管理入口、API 命名、安全验证与 IP 限制区域;经典 / 统一权限图二选一参考。IP 图不含二维码和凭据区域。
步骤 1
打开 API 管理并创建
登录 Binance 目标账户,进入账户菜单 → API 管理 → 创建 API。官方指南列有身份验证、2FA 与现货钱包入金激活前提;创建受限时先核查页面提示,本次不执行入金。
图 1头像菜单进入 Account
右上角头像 → Account,随后进入 API Management。

图 2API Management → Create API
左侧 API Management,右上角点击 Create API;不要选税务报告 API 或删除入口。
本图的默认安全限制保持勾选,不为打开交易权限而关闭。

步骤 2
选择 HMAC 类型与名称
选择系统生成类型(HMAC),填写独立的 API 名称;本产品使用 Key / Secret,不选择自行生成的 RSA / Ed25519。
图 3选择系统生成的 API 密钥
对应“创建 API → 系统生成”:本产品使用 Key / Secret,不选自行生成的 RSA / Ed25519。

图 4给 API 填写独立名称
在 Label API Key to proceed 中填写自己的用途名称,再继续。

步骤 3
完成安全验证并保存密钥
完成官方安全验证,在生成页面安全保存同一组 API Key 和 Secret;不要把 Secret 当作 Key,也不要混用两组凭据。
图 5完成安全验证要求
按页面要求完成 Authenticator、邮箱、Passkey 等安全验证;图中展示的是验证方式选择。
不把验证码或账户密码填写到 SM FUND。具体方式由官方账户安全设置决定。

步骤 4
设置受信任的固定 IP
进入编辑权限,先设置“只访问受信任的 IP”为当前部署实际请求的固定公网出口。HMAC 交易权限不可选时先核对 IP 和账户条件,不通过关闭默认安全限制排错。
图 6只允许受信任 IP 访问
选择 Restrict access to trusted IPs only,填写当前部署的真实固定公网出口,再保存。
该截图只保留 IP 设置区,排除了二维码与凭据区域。Unrestricted 仅为原参考图状态,本教程不采用。

步骤 5
按账户类型保存交易权限
保留读取,仅开启目标市场需要的交易权限。经典账户与已存在的统一账户参考不同权限图,提现和非必要借贷、划转关闭;最后保存权限并按页面完成安全确认。
图 7经典账户权限参考
对应“编辑权限”:只有你的账户是对应类型时才参考本图。
不要为了与图片一致切换账户类型;只开放所需市场,提现及非必要资金权限关闭。

图 8统一账户权限参考
已使用统一账户时,核对“开启统一账户交易”与所需产品权限。
这张图是对应账户的参考,不代表必须升级统一账户,也不证明所有模式已实盘验证。

第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 Binance,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| API Key | 交易所生成的 API Key,不是 UID |
| API Secret | 与上方 Key 同一组的 Secret |
最容易填错的地方使用工具支持的系统生成 Key / Secret。当前凭据表单没有需要用户选择的经典 / 统一账户下拉框,账户类型在验证后显示。
首次添加看字段,不找“更换”按钮下图来自已有账户的空白“更换”区域,只用于核对凭据名称。首次添加还要填账户名称,并使用“验证并保存”;“验证并更换”只用于已有账户更新凭据,且必须仍是同一交易所账户。
图 9 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
Binance 接入后重点核对核对验证识别的账户类型,以及现货 / U 本位合约的余额、持仓、挂单和同步时间。经典账户看不到合约权限时,检查是否先开通合约再创建 Key;Portfolio Margin 的权限标签与经典账户不同,不为匹配截图升级或降级账户。
平台注意事项现货和 U 本位 / 币本位合约属于不同市场,本产品表单列出的是 U 本位合约。账户有资产不等于该市场有可用保证金;经典账户的合约权限不可用时先核对合约开通时间及 Key 创建时间,不为排错升级统一账户。
已接入详情显示“统一账户(Portfolio Margin)”;不代表新用户必须升级,也不证明其他模式都已验证。
系统生成 APIBybit 接入
交易所设置入口 ↗官方指南 ↗
这份教程使用什么权限?SM FUND 添加表单要求“交易(不含提现)”。保留必要读取,只开所需市场的交易权限,提现关闭;只看公开行情可以先不添加账户。
第一步:在交易所创建专用凭据
已补头像入口、API Transaction / 名称 / IP 完整配置、安全验证与成功保存画面。原图的只读 / 不限制 IP 选项明确作为未完成配置示例,不能照搬。
步骤 1
进入网页版 API 管理
使用网页版登录目标主网账户,进入头像菜单 → API → API Management。App 不能创建;新注册账户前 48 小时可能受限。测试网账户与密钥独立,不在此主网路径中混用。
图 1头像菜单中的 API 入口
右上角头像菜单 → API。原教程已遮挡账户标识。

图 2官方 API 管理创建入口
对应“API Management → Create New Key”:图中红框标出新建入口。

步骤 2
选择系统生成与 API Transaction
点击 Create New Key(新建密钥),选择系统生成的 API 密钥(System-generated),填写用途名称;本产品走 Key / Secret 手工接入,使用 API Transaction(API 交易)用途。
图 3选择系统生成的 API 密钥
对应“新建密钥 → 系统生成”:然后按实际账户选择读取与所需交易权限。

图 4API Transaction、名称、权限与 IP 全表单
在 API Key Usage 选择 API Transaction,填写用途名称,按本手册选择交易需求和可信执行端 IP。
官方原图为未完成配置示例,显示 Read-Only 和 No IP restriction;SM FUND 接入按正文使用所需读写交易权限和固定 IP,不照搬示例勾选。

步骤 3
选择所需交易权限
为本产品接入选择 Read-Write(读写),在 Unified Trading(统一交易账户)下只勾选需要的订单、持仓和 / 或现货交易权限。资产划转等另行判断,提现关闭。
图 5统一交易账户权限参考
对应“读写权限与目标产品”:核对所需现货、合约订单及持仓权限。
参考图选了“不进行 IP 限制”;应按自己的可信执行端配置固定出口 IP,不要照图关闭限制。

步骤 4
绑定可信公网出口 IP
选择只允许指定 IP 访问,填入当前部署真实公网出口 IP。参考图中“不进行 IP 限制”的选择不作为推荐配置。
步骤 5
完成验证并保存 Key / Secret
核实配置,提交并完成 Google Authenticator 等页面要求的安全验证。立即将 API Key 和 API Secret 成组安全保存;官方说明 Secret 在创建时只显示一次。
图 6安全验证与 Key successfully added
左侧为邮箱 / Google 2FA 输入,右侧为创建成功后的 Key / Secret 保存位置;凭据已由官方来源遮挡。
在自己的官方页面复制同一组 Key / Secret 后安全保存;不要复制教程截图或把验证码发给客服。

第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 Bybit,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| API Key | 交易所生成的 API Key,不是 UID |
| API Secret | 与上方 Key 同一组的 Secret |
最容易填错的地方填写同一组 Key 与 Secret。表单中的“期货”是站内产品名称,不可据此推断所有交割合约、保证金和持仓模式都受支持。
图 7 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
Bybit 接入后重点核对核对目标主网账户、识别的账户类型及现货 / 期货产品,再比对私有账户流的同步时间与官方余额、持仓、挂单。新账户为空时确认查询成功状态;公开行情正常不能证明私有凭据有效。
平台注意事项使用主网 Key 对应主网账户,不混用测试网或模拟环境。全仓、逐仓、组合保证金与单向 / 双向持仓是不同设置;本次未验证所有模式的兼容性,不为接入随意切换。
未接入表单提示验证后自动识别账户类型与产品;未实测具体账户或保证金模式。
API v4Gate 接入
交易所设置入口 ↗官方指南 ↗官方创建教程 ↗
这份教程使用什么权限?SM FUND 添加表单要求“交易(不含提现)”。保留必要读取,只开所需市场的交易权限,提现关闭;只看公开行情可以先不添加账户。
第一步:在交易所创建专用凭据
已补头像入口、创建按钮、风险提示、资金密码与二次验证;API v4 / 账户类型 / IP 和模块权限均有参考。最终 Secret 保存页未收录,创建后按文字步骤立即备份。
步骤 1
进入 API 管理并创建
登录 Gate 目标账户,进入头像菜单 → API 管理 → 创建 API Key。
图 1头像菜单中的 APIs 入口
点击头像,在菜单中找到 APIs / API 管理。
官方图片采用重点高亮,只需找到标出的入口。

图 2API Key 管理中的创建按钮
进入 API Key 管理后,点击右上角创建 API Key。

步骤 2
选择 API v4 与现有账户类型
填写独立用途备注,选择 API v4 Key。按自己现有账户选择对应账户类型;经典 / 统一 / 模拟不是随意互换的选项,当前主网接入不混用模拟账户密钥。
图 3官方 API v4 类型、账户与 IP 选择
创建步骤 2–3:在 API Key 类型中选择 API v4 Key;账户类型与当前账户一致;绑定实际执行端 IP。
图中 abc / abd 是官方教程示意,abd 不是有效 IP;不要复制。原图采用重点高亮,其余区域较暗,点击可查看原尺寸。

步骤 3
绑定固定公网出口 IP
选择绑定 IP,填入当前部署发起 API 请求的固定公网出口,不复制教程里的示意值。
步骤 4
配置必要模块权限
为实际使用的现货、永续等模块配置读取及所需交易读写权限;账户、钱包等读取需求按实际错误核查。提现关闭,不照图额外开放 TradFi、借贷或资金划转。
图 4模块读写权限参考
按本次需要选择现货、永续等模块的读取 / 读写权限;类型与账户选择见前一张官方表单。
原图还开启了 TradFi、钱包、Account 和保证金等模块,它们不是通用必选项;本图未显示提现开关,需在完整表单另行确认提现关闭。

步骤 5
确认风险提示并安全验证
核实后提交,阅读风险提示,由你完成资金密码与页面要求的二次验证,再确认创建。
图 5提交后的风险提示
核对配置后会出现风险提示,由你阅读并决定是否确认继续。
仅说明真实界面位置;本次未接受条款、确认风险提示或创建任何 API。

图 6资金密码与二次验证
官方示例显示资金密码、二次验证方式及验证码输入区,确认后完成创建。
123456 为官方教程示意,不是可用验证码;只在自己的官方页面输入当时生成的验证信息。

步骤 6
成组保存 API Key / Secret
在创建成功页立即保存同一组 API Key 和 API Secret 到可信密码管理器或加密存储。只保存 Key 不够;Secret 未保存或丢失时,先按官方页面核查能否重新查看,否则重建专用凭据。
第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 Gate,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| API Key | 交易所生成的 API Key,不是 UID |
| API Secret | 与上方 Key 同一组的 Secret |
最容易填错的地方使用 API v4 的 Key / Secret。只启用实际需要的产品,CrossEx、股票合约与普通现货或合约分别判断。
图 7 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
Gate 接入后重点核对先确认 API v4 和正确账户类型,再分别核对现货 / 合约的私有账户流、余额、持仓与挂单。现货成功、合约异常时检查模块权限、结算币种和账户模式;不能以现货成功替代全部接入验收。
平台注意事项Gate 合约下单数量可能以张数表示,必须结合合约乘数换算币数量。RISK_LIMIT_EXCEEDED 应先检查仓位和限额,不应直接提高限额。
验证后识别账户类型与已开通产品;显示模块不等于账户有权限或已经通过交易测试。
系统生成 APIBitget 接入
交易所设置入口 ↗官方指南 ↗
这份教程使用什么权限?SM FUND 添加表单要求“交易(不含提现)”。保留必要读取,只开所需市场的交易权限,提现关闭;只看公开行情可以先不添加账户。
第一步:在交易所创建专用凭据
已补较新 API keys 入口、Create API key、Note / Passphrase、官方 IP 字段以及 Key / Secret 保存位置;第三方只读示例与 SM FUND 读写要求单独标明,旧版官方表单只认字段。
步骤 1
找到 API keys 并开始创建
登录 Bitget 目标账户,进入个人中心 → API 管理 → 新建 API Key。子账户若没有创建入口,先请账户管理员核查其 API Key Management 权限,不改用主账户凭据冒充子账户。
图 1头像菜单中的 API keys 入口
在账户头像菜单中找到 API keys;主 / 子账户先确认正确。

图 2API keys 页面点击 Create API key
在 API keys 页面点击 + Create API key,并核对当前所选账户。
图中账户名称属于公开教程示例,不是你的账户;本手册不使用 Bulk create 批量创建。

步骤 2
选择系统生成、备注与口令
选择系统生成的 API 密钥,填写用途备注,设置并安全记下本组 API Passphrase;口令不是登录密码,遗失后无法找回。
图 3选择系统生成的 API 密钥
对应“新建 API Key → 系统生成”:同时准备自己设置的 API Passphrase。

图 4填写 Note 与 Passphrase
Note 填用途名称,Passphrase 设置自己的 API 口令并安全保存。
原教程面向只读资产工具,图中 Read-only、Select all 以及示例口令不照搬;SM FUND 所需读写权限见下一步。

步骤 3
配置所需读写和账户权限
为本产品选择读写权限,仅启用所需现货或合约市场。经典 / 统一账户按实际现状参考对应权限图;现货杠杆不是普通现货的必选项,提现关闭,非必要划转、还款不开放。
图 5经典账户现货与合约权限参考
创建步骤 3:图中同时展示合约订单 / 持仓、现货和现货杠杆,按本次需要的市场核对。
图中还勾选了现货杠杆;普通现货不要求照搬。只参考自己现有账户类型,不因截图切换模式。

图 6统一账户权限参考
已使用统一账户时,分别查看“管理”和“交易”的实际权限说明。
“管理”可能包含资金划转与还款;不因截图勾选就默认开启,不使用“全选”排错。

步骤 4
绑定固定 IP 并安全验证
绑定当前部署真实公网出口 IP,核对配置后继续,并完成页面要求的安全验证。
图 7官方 IP 绑定字段参考
在 Link IP address 填当前部署真实固定公网出口;新版表单名称或位置可能变化,查找 IP 绑定 / 白名单字段。
这是 Bitget 官方 2023 年旧版表单,仅用于认清 Notes / Passphrase / Link IP 字段;权限与账户模式使用前面的对应类型图,不采用旧版参数限制。

步骤 5
保存同组 Key / Secret / Passphrase
将生成的 API Key、Secret Key 和自己设置的 Passphrase 成组保存。填写工具时三项必须来自同一组;不要用主账户口令替代 API Passphrase。
图 8Access APIKey 与 SecretKey 保存位置
在自己的官方凭据页分别保存 Access APIKey 和 SecretKey,与创建时的 Passphrase 成组保管。
原图的值已遮挡,只用于辨认保存字段。No record 的 IP 状态和大量权限标签不是本产品推荐配置,不照图开放。

第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 Bitget,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| API Key | 交易所生成的 API Key,不是 UID |
| API Secret | 与上方 Key 同一组的 Secret |
| Passphrase | 创建本组 API 时自己设置的 API 口令 |
最容易填错的地方填写同组 Key、Secret 和 API Passphrase。经典或统一账户的实际识别结果在验证后核查,不要为了匹配教程随意升级账户。
图 9 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
Bitget 接入后重点核对核对验证后识别的账户、产品与私有账户流,再与官方同账户的现货 / 合约余额、持仓、挂单逐项比对。签名失败时先检查三项是否同组、口令是否准确、IP 和执行端时间,不通过增加资金权限排错。
平台注意事项Passphrase 遗失后无法找回,需按官方规则重建专用密钥。经典与统一账户的权限区域不同;“管理”可能包含划转及还款,不照图全选。后续实盘前还需单独确认现货市价买单的数量单位。
验证后自动识别;当前表单没有账户模式或单向 / 双向选择框。
V3 API 钱包Aster 接入
交易所设置入口 ↗官方指南 ↗
第一步:在交易所创建专用凭据
已补 Pro API 授权入口、名称 / Generate、IP / Authorize 安全局部;权限及有效期沿用已遮挡的参考图。主钱包签名弹窗和授权结果列表没有实操截图。
步骤 1
进入主网 API 钱包与 Pro API
连接 Aster 官方应用,确认实际交易主钱包与目标账户。本产品名称是 Aster,使用 V3 API 钱包;先核对官方要求的账户开通前提。
图 1Pro API → Authorize new API wallet
进入 API 钱包页面的 Pro API 区域,找到 Authorize new API wallet。
这是公开教程的已连接钱包视图;本次未连接钱包、授权或修改账户。

步骤 2
命名、生成并保存专用私钥
打开 API 钱包页面,点击授权新的 API 钱包,生成专用 API 钱包地址;把显示的专用私钥安全保存,不使用主钱包私钥或助记词。
图 2API wallet name 与 Generate(安全局部)
填写独立 API 钱包名称,使用 Generate 生成专用 API 钱包;私钥显示区未收录在图中。
图中 0x 地址是示例 API 钱包地址,不复制,不把主钱包私钥用于接入。

图 3授权 API 钱包的生成、权限与有效期
对应“授权新的 API 钱包”:保存生成的专用私钥,选择需要的现货或永续权限,再确认授权。
图片里的地址与私钥已由原来源遮挡;示例有效期和双市场勾选不是强制配置。提现保持关闭。

步骤 3
核对权限、有效期与 IP
仅选择需要的现货和 / 或永续权限,提现关闭。按实际需求设置页面支持的有效期与 IP 限制;IP 使用当前部署真实公网出口,示例有效期和双市场勾选不强制照搬。
图 4IP restrictions 与 Authorize(安全局部)
按实际需要设置 IP restrictions,确认专用私钥已安全保存后,再由主钱包完成 Authorize 授权。
该局部截图排除了完整私钥。原教程未展示新版权限细分时,以前一张权限图和官方当前页面为准。

步骤 4
签名并确认授权有效
确认私钥已保存,核对官方域名与钱包签名内容,再由主钱包完成授权。回到 API 钱包列表,确认该专用钱包已授权且在有效期内;只生成私钥不算授权完成。
第二步:回到 SM FUND 填写接入字段
- 打开“设置”,选择左侧未添加的 Aster,或在“全部交易所”对应行点击“添加”。
- 先填写自定义账户名称,再按下表粘贴刚保存的专用凭据。保持原值,不附加空格、引号或换行,不混用不同组的 Key / Secret / 口令。
| 界面字段 | 怎么填写 |
|---|
| 账户名称 | 自定义易识别名称,例如“套利专用” |
| API 钱包私钥 | 已授权专用 API 钱包的私钥,非主钱包私钥 |
最容易填错的地方只填已授权专用 API 钱包的私钥。当前表单没有 user / signer 输入框;旧版只提供 API Key / Secret 的部署不能直接套用此步骤,应先核查 V3 兼容性。账户识别失败时保留脱敏错误联系支持,绝不改填主钱包私钥。
图 5 · SM FUND 实际接入字段(空白表单)第三步:验证保存并只读核对
- 确认信任当前部署后,点击“验证并保存”。
凭据由服务端加密保存,之后不再显示;保存前确保自己已有安全备份。
- 成功后核对账户身份、识别类型、已开通产品,以及私有账户流和最后同步时间。
与官方同账户、同市场核对余额、持仓和挂单。
- 验证失败或持续加载时,记录脱敏错误码、时间与目标市场。
先检查凭据组、IP、权限和账户环境;不要反复新增账户、全开权限或用下单测试连接。
Aster 接入后重点核对核对 API 钱包已授权给预期交易主账户且未过期,再比对官方同账户的现货 / 合约余额、持仓、挂单和同步时间。当前表单不要求 user / signer;识别失败时保留脱敏错误。出现 -5050,核查官方入金前提,由你决定后续处理,不反复重建密钥或改填主钱包私钥。
平台注意事项Aster 官方推荐新接入使用 V3;自 2026-03-25 起不再支持创建 V1 新 API Key。旧版密钥与 V3 API 钱包不是同一种凭据。本文不替用户执行入金。 官方另规定自 2026-09-01 起,相关 V3 私有账户与交易接口要求关联主钱包已完成入金;出现 -5050 时核查此前提,不靠反复重建密钥解决。
验证后识别;当前表单没有主账户地址 user 或代理地址 signer 输入框。
交易前先停在读取核对
怎样判断接入完成
| 看哪里 | 什么结果才算通过 | 异常时先做什么 |
|---|
| 账户类型与名称 | 目标账户与环境正确;主子账户没有混淆 | 核对凭据来源;不要用其他账户密钥临时顶替 |
| 私有账户流 / 最后同步 | 能看到状态与新鲜的同步时间 | 持续未连接、报错或加载,不算读取成功 |
| 余额、持仓、挂单 | 与官方同账户、同市场、同币种口径一致 | 总权益不等于可用余额;空数据要区分“确实为空”和“读取失败” |
| 产品 / 允许交易 | 只包含本次需要且账户实际开通的产品 | 只看行情的产品不会作为可交易腿;不要盲目增加权限 |
| 执行状态 | 没有因验证接入而新增订单或开启策略 | 检查远程实例、策略开关和官方未成交订单 |
三个开关,三个作用账户“启用”控制同步;产品“允许交易”控制能否成为可交易腿;价差“启用策略”控制按规则自动执行。接入成功不等于策略正在交易,也不等于两腿执行已经通过。
准备实盘前再核对
- A / B 账户、产品、原生品种、方向和数量单位。
- 两边合约乘数、步长、最低名义价值与可成交深度。
- 每批金额、规模上限、保证金、手续费、资金费与退出成本。
- 单腿失败、超时或部分成交时,如何停止新增操作、查单和处理敞口。
先看方向,再看规则
A 是买入腿,B 是卖出腿
添加价差局部截图A · 买入腿建仓时买入
选择账户、市场与原生品种。普通现货只能在已有库存或已验证借币路径下卖出。
B · 卖出腿建仓时卖出
“交换两腿”会调换 A / B。两腿可以是不同交易所、不同产品或不同币种;异币不代表完全对冲。
从加入自选到设置规则
- 点击“+ 添加价差”,分别选择 A 与 B,核对账户、产品、原生品种。
- “加入自选”与“加入并设置规则”是不同入口;创建自选不等于已经完成交易验收。
- 点卡片名称打开详情;详情的两腿行情显示“A 买 / B 卖”,在“编辑策略”查看规则。
- 先核对“差价 / 比值”和单位,再填入场、出场阈值。比值模式下回归比例会影响阈值口径,不要跨口径复制数字。
| 操作或设置 | 界面含义 | 需要注意 |
|---|
| 启用策略 | 启用后按规则自动交易 | 可能触发真实订单;不要为测试连接而开启 |
| 单回合 | 一次建仓和平仓完成后自动暂停 | 可能分多批;不等于单次下单 |
| 开仓至上限 | 卡片手动开仓,目标为规模上限 | 不是最小测试单 |
| 清仓 | 清理该价差持仓的交易操作 | 核对最终实际成交与剩余持仓 |
| 禁开 / 禁清 | 禁开暂停建仓;禁清暂停信号平仓 | 禁清时止损和风险强减仍然生效 |
| 规模上限 / 单笔金额 | 较大腿名义上限 / 每批定量范围 | 规模上限只限制建仓;两边最低额也须满足 |
| 首腿偏好 | 自动 / 先 A / 先 B | 双腿不保证同时全部成交 |
| 全部平仓并重置 | 设置中的全账户清理操作 | 绝不能当作重新连接或清除提示使用 |
暂停、撤单、平仓是三件事暂停规则不代表旧挂单已撤,也不代表仓位或借贷已清零。关闭网页也不会停止远程服务。核对官方持仓、订单和负债后再恢复。
随用随查
55 个日常问题
共 55 个问题
接入与安全
API 连上了,就可以开始套利吗?
还不可以。核对私有账户流、账户类型、产品开关、余额、持仓、订单;再核对 A 买 / B 卖、数量单位、交易所最低额、规模上限和每批金额。添加账户或加入自选不会替代交易验收,启用策略和手动开仓都可能产生真实订单。
为什么能看行情,余额却读取失败?
公开行情通常不需要私有权限。先看错误码,再检查密钥组、口令、IP 白名单、时间同步、站点、实盘或测试网,以及资金所在账户。不要用行情成功证明 API 凭据有效。
API 一定要开启提现吗?
不需要。本产品添加界面明确要求“交易(不含提现)”;关闭提现,其他资金类权限也按必要性核对。关闭提现不能消除交易权限被滥用造成亏损的风险。
IP 白名单应该填电脑还是服务器?
填真正向交易所发请求的公网出口。使用本手册的 SM FUND 部署时,先向部署维护者确认固定 API 请求出口 IP;自建时核对实际服务器、代理和请求路由。不要用域名解析地址、家里网络 IP 或 192.168.x.x 等内网地址代替。出口变化后重新核对,不通过取消白名单排错。
可以把 API 截图发给客服排错吗?
可以发已脱敏的权限页、错误码和时间。遮挡 Key、Secret、Passphrase、API 钱包私钥、二维码及敏感账户信息。客服排错不需要你的完整密钥或助记词。
API 泄露或怀疑被盗怎么办?
立即停止策略,在官方页面撤销泄露密钥或代理授权,核对持仓、未成交订单及资产记录。撤销密钥不等于自动撤掉旧订单或平仓,仍须在官方页面确认并按既定方案处理;不要只改工具内密码。重建专用凭据并复查权限。
提示 CORS、451 或连接超时,是 API 坏了吗?
分别排查浏览器跨域、地区访问限制和网络路由。CORS 不代表签名失败;451 不应靠反复换密钥解决。使用产品支持的安全连接方式,不建议关闭浏览器安全保护。
旧密钥突然失效怎么办?
核对过期、IP 变化、权限调整、主子账户切换及官方公告。先停止自动执行,保留脱敏错误记录;凭据恢复后先查询已有订单,避免重启时重复下单。
只读、读写和 API 钱包有什么区别?
只读密钥通常不能下单;读写按授权模块允许交易或其他操作;API 钱包是代理签名凭据,不能假定只读。本产品添加界面提示“只开交易权限,不开提现权限”。如果只想观察行情,可以先不添加账户,不保证纯只读凭据能通过“验证并保存”。
Secret 或 API 钱包私钥忘记保存怎么办?
不要用截图中的示例值,也不要输入主钱包私钥。返回官方页面核查能否重新查看;不能查看时新建密钥或新代理并撤销不用的旧授权。保存好新凭据,再更新工具并先只读核对。
在哪里填写 API?显示“已保存”就成功了吗?
进入“设置”,选择左侧未添加的交易所(或从“全部交易所”点“添加”),填写账户名称及本指南列出的字段,再由你确认“验证并保存”。已保存不等于所有功能验证通过:继续看“私有账户流”、最后同步时间、账户类型、产品和实际余额 / 持仓 / 挂单。
为什么账户为空,能否用下单测试连接?
不要用真实下单猜连接状态。新账户可以确实没有余额、持仓和订单;先检查明确的查询成功时间和账户身份。查询报错、持续加载和数据为空是不同状态。Hyperliquid 主账户的子账户地址留空,接入子账户填真实子账户地址;Aster 核对已授权给预期主账户、V3 兼容及官方入金前提,不寻找不存在的地址输入框。
提示时间戳、签名或 nonce 错误怎么办?
时间戳错误先检查执行电脑或服务器的自动校时;签名错误再核对完整的一组凭据、口令、环境及 API 版本。nonce 是用于防止同一签名被重复执行的编号;代理钱包被多个进程共用时可能冲突,应停止重复执行并交给技术支持排查。不要反复重发下单请求。
换电脑、换服务器或恢复浏览器后要做什么?
页面声明凭据由服务端加密保存,之后不再显示,不能把它当作仅在本机浏览器保存。换电脑先确认连的是同一可信部署;换服务器核对出口 IP、账户同步及旧服务是否仍在运行。先查已有挂单与持仓,避免两套服务重复执行。加密实现与服务端安全本次未审计。
套利基础
S-S、S-F、F-F 分别是什么?
S-S 是现货对现货,S-F 是现货对合约,F-F 是合约对合约。两腿必须对齐实际标的、数量和计价单位;名称相近不等于同一种资产。F-F 先观察,完整验证后再考虑执行。
本产品的 A 腿和 B 腿分别是什么方向?
“添加价差”明确标示 A · 买入腿、B · 卖出腿;“交换两腿”会调换两边。详情的两腿行情也显示 A 买、B 卖。本产品不是用 +A-B / -A+B 按钮选择方向;开仓前核对各腿账户、产品与原生品种,平仓以实际已有持仓反向减仓。
页面显示正价差,为什么实际亏钱?
显示值可能基于最新成交价,未包含真实可成交深度。还要扣双边开平仓手续费、滑点、资金费、借贷利息、划转或链上成本,并计入退出时价差变化。
开仓该看最新价、买一还是卖一?
用可成交方向计算:买入 A 看 A 的卖盘,卖出 B 看 B 的买盘。数量较大时按该数量扫过的订单簿估算平均成交价;只看买一卖一仍可能低估滑点。
怎样计算一个方向的入场价差?
先看本产品选择的是“差价”还是“比值”,以及显示单位。比值设置中可见 A/B;填写“回归比例”后,页面说明按相对目标比例的偏离设置开平线。下方计算示例仅用于理解价格差与成本,不是本产品差价公式的确认;不能把一种口径的阈值复制到另一种口径。
资金费率为正,谁支付?
对于采用常见永续规则的产品,正费率通常是多头付给空头,负费率反之;具体以该合约官方规则为准。每一腿独立计算,不要把整个组合的收益直接等同于单腿费率。
资金费率看起来很高,就值得开仓吗?
还要核对下一次结算时间、持仓是否跨过结算、费率是否预测值、费率上限和价格风险。费率可能在结算前变化,年化数字不是保本收益承诺。
不同交易所资金费率可以直接比较吗?
先统一结算周期、费率符号和观察时间;再计算相同持仓时段两腿实际收付。不要直接把每小时费率和每八小时费率放在一起比较。
两边都是 100 USDT 就完全对冲了吗?
不一定。对冲应按实际标的敞口匹配;名义金额、合约乘数、线性或反向合约、成交价格和部分成交都可能造成偏差。优先换算为同一标的的实际币数量。
现货卖出需要先准备币吗?
普通现货卖出需要已有该币库存。没有币时,不能把卖出理解成自动做空;借币卖出需要另行验证杠杆账户、借币额度、利息及归还路径。S-S 跨所套利通常需要买入侧有计价币、卖出侧有标的币,或其他已验证的资金路径。
同名币、1000 倍合约或股票代币能直接配对吗?
不能只看名称。核对实际标的、代币合约地址或资产映射、合约乘数、交易时段、结算币种及是否线性合约。1000 倍标的需要按单位换算;股票代币与股票指数或永续可能存在不同权利和价格机制,不应默认完全对冲。
保证金模式、持仓模式和杠杆是同一个设置吗?
不是。保证金模式决定哪些资金共同承担风险;持仓模式决定同一合约是净持仓还是可同时持多空;杠杆影响所需保证金及风险。三项要分别核对。单向持仓不代表不能做空;也不能用“切全仓、调高杠杆”作为通用连接修复。
下单与异常
为什么价差达到阈值却没有下单?
依次检查是否启动执行、方向是否正确、行情是否新鲜、深度是否足够、余额及保证金是否充足、数量是否达标,以及是否被频率或风控限制拦截。保留触发时的时间、报价和拦截原因。
订单提交成功,就代表成交了吗?
不代表。区分请求受理、挂单、部分成交、全部成交、撤销和拒绝;以交易所订单与成交记录为准。两腿都提交成功也不代表已对冲。
一边成交,另一边失败怎么办?
先暂停循环和新增订单,查询两边真实订单状态、累计成交量及持仓,确认裸露敞口。再按事先约定的最大敞口与止损方案决定补腿或退出,不能盲目重复原订单。
请求超时后能直接重试吗?
不能直接重发写请求。超时可能发生在交易所已经接单之后;先用订单 ID 或客户端订单 ID 查询状态,再决定是否补发,避免重复成交。
提示最小数量、NOTIONAL 或精度错误怎么办?
分别检查最小币数量、最小名义价值、数量步长、价格步长以及合约张数单位。两边都达标才可验证,不应仅为了绕过报错而大幅增加下单金额。
市价单不是一定能成交吗?
不是。交易所保护机制、价格限制、深度或 IOC 规则可能导致拒单或部分成交;成交价也可能滑动。使用前核查该市场规则,成交后重新核对敞口。
为什么平仓反而开出新仓?
检查平仓方向、持仓模式、positionSide / posSide、reduceOnly 及实际仓位。参数要求随接口变化;使用产品的平仓流程后仍要核对剩余持仓,不能只看按钮提示。
网页余额很多,为什么提示资金不足?
总资产、可用余额和可用保证金不同。核对资金账户、交易账户、主子账户、挂单占用、保证金占用及借贷负债;转入错误账户的资金不会自动成为可用保证金。
可以同时用多个工具操作同一个账户吗?
会增加持仓变化、撤单冲突和重复下单风险。建议为工具分配独立子账户;Hyperliquid 等代理签名场景还应为不同进程使用独立代理,避免 nonce 冲突。
429、限频或维护提示怎么办?
停止连续刷新和重试,保留错误码及发生时间,按官方限制等待或降低请求频率;维护期间停止新增敞口。订单状态不明时先查单,不同时重复提交原订单。具体等待时间以交易所当前限制或响应为准。
价差卡住或断网了,如何判断还能不能交易?
检查最后更新时间、网络状态和官方页面行情。数据不刷新或连接状态不明时暂停新增执行,并从官方页面核对持仓和挂单;不能假设网页断开就代表服务器策略也停了。恢复后先核查已有交易,再继续。
日常运行
本产品的“单回合”是不是只下一笔单?
不是。策略设置的“单回合”说明为“完成一次建仓和平仓后自动暂停”。一个回合可能分多批成交;它不是其他工具的 Once,也不代表只发一笔订单。“启用策略”会按规则自动交易,初次验证应先明确小额规模、单笔范围和异常退出方案,再由你决定是否执行。
已经对冲,为什么还会爆仓?
两边交易所分别管理保证金,一边盈利不会自动补到另一边;价格波动、标记价格差异和维持保证金变化都可能触发单边强平。持续检查每一腿的保证金和强平距离。
什么时候应该退出?
在入场前约定净收益目标、最大亏损、最大持有时间、费率反转、保证金阈值、流动性下降和系统故障退出条件。退出后复查两边持仓、挂单、借贷与最终账单。
每天运行前检查什么?
检查 API 有效期和权限、行情时间、未成交订单、两腿持仓、可用保证金、资金费结算、借贷余额、交易所维护和网络状态。异常未解释清楚前,不扩大仓位。
怎么计算这笔套利真正赚了多少?
先核对账单口径:若已实现盈亏是未扣成本的毛盈亏,净收益 = 两腿毛盈亏 + 实收资金费 − 实付资金费 − 开平仓手续费 − 借贷利息 − 调拨成本。若官方净盈亏已经包含某项费用,不要重复扣除。未平仓时单列未实现盈亏;资金划转不是利润。
向客服反馈问题,需要提供什么?
提供交易所、市场、账户模式、操作时间及时区、脱敏订单 ID、错误码、预期行为和实际行为。涉及部分成交时补充两腿累计成交量;不要提供完整凭据。
暂停策略、关闭网页和撤销 API 会自动平仓吗?
不能这样假设。停止触发、撤掉挂单和平掉持仓是三个不同动作;远程服务也可能在网页关闭后继续运行。停止后逐项确认:策略不再触发、未成交订单已按需处理、持仓及借贷是否仍存在。撤销 API 后可能需要在官方页面处理剩余订单。
现货杠杆平仓后,还需要检查什么?
核查借币本金、利息和自动还款结果。成交完成不等于借贷结清;若仍有负债,应在官方页面按规则归还并确认。不要仅凭两腿仓位为零判断整个回合已经结束。
什么情况下不能直接重启或扩大仓位?
单腿成交未处理、订单状态不明、价格数据陈旧、保证金不足、密钥疑似泄露、账户模式不清楚或恢复后存在重复执行风险时,先停止新增操作。把现有敞口、挂单和负债核对清楚,再按原定限额恢复。
产品操作
“账户启用”“允许交易”和“启用策略”有什么区别?
账户同步的“启用”控制该账户所有市场同步;“允许交易”控制对应产品是否可作为可交易腿;“启用策略”控制价差按规则自动执行。前两项不是开仓按钮,也不能用关闭其中一项代替平仓。修改任何开关前先理解现有仓位与挂单影响。
“开仓至上限”和“清仓”会做什么?
卡片把手动操作标为“开仓 至上限”和“清仓”。前者是按策略规模上限发起开仓,不应理解为只下一笔最小单;后者是清理该价差持仓的交易操作。它们不是连接测试。本次只核对标签,未点击,成交细节与确认流程未实盘验证。
“禁开”“禁清”和暂停有什么区别?
页面说明:“禁开”暂停建仓,平仓照常;“禁清”暂停按信号平仓,但止损和风险强减仍生效;“已暂停 / 启用策略”控制策略自动执行。“只减仓”在策略暂停时不适用。不要把这些状态混用,更不要假定它们已经撤销所有旧订单。
单笔金额、规模上限和交易所最低额怎样一起看?
规模上限按较大一腿名义价值计算,只限制建仓;单笔金额是每批定量范围,页面说明会结合盘口深度与交易所最小额。若最低额超过每批上限或剩余可开规模,不能靠反复点击强行成交;先重新核对两腿最小数量、换算和风险预算。
“重新验证”“更换”和“移除账户”有什么区别?
重新验证会重新读取账户类型、权限与可交易产品;更换界面要求先验证仍为同一个交易所账户,通过才替换,失败保留原密钥;移除后该交易所只能看行情,页面说明历史订单与成交保留。移除账户不等于撤销交易所 API,也不等于平仓。
“全部平仓并重置”能用来排查连接吗?
不能。页面将它列在“危险操作”,说明会停止自动下单并逐交易所清理挂单、持仓与余额,成功后重置交易状态。它可能影响整个账户体系,不是重试连接按钮,也不能替代针对某一笔异常的查单。
图表上的虚线能当成可成交价差吗?
不能。详情明确提示本地无数据时会按交易所成交价估算,虚线“非可成交”。入场 / 出场判断应结合当前盘口、更新时间和对应指标,不能把历史估算线当作能立即执行的报价。
双腿交易是不是保证两边同时全部成交?
不是。执行设置包含“首腿偏好:自动 / 先 A / 先 B”,说明需要考虑执行顺序;一边受理也不代表另一边成交。始终核对两腿实际成交、剩余挂单和净敞口,连接或单腿异常时先停止新增操作。
为什么交易所能看行情,却不能选成可交易腿?
未添加账户时页面明确提示只能看行情;账户添加后,产品若设为只看行情,也不会出现在可交易腿中。核对是否已验证账户、同步启用及该产品是否允许交易,而不是误把行情连接当成下单权限。
全部是假设数字
价差、资金费与张数怎么算
以下只解释计算方式,不是当前报价、实际费率或开仓建议。
例 1:入场价差不等于利润
A 卖盘可买价 100 USDT,B 买盘可卖价 100.20 USDT。买 1 单位 A、卖 1 单位 B 的入场差为 0.20 USDT,即 0.20%。假设退出时两边实际成交价相同、且四次交易手续费合计 0.24 USDT,即使忽略滑点和其他费用仍会亏 0.04 USDT。真实净收益要结合最终退出价计算。
例 2:两腿资金费要分别算
假设同一结算时点、两腿名义价值均为 1,000 USDT,且采用正费率多付空收的规则:A 多头费率 +0.01%,支付 0.10 USDT;B 空头费率 +0.03%,收到 0.30 USDT。净资金费收入为 0.20 USDT,尚未扣交易费用与价格盈亏。持仓没跨过对应结算时点时,不能直接计入这笔收入。
例 3:合约张数先换算
假设一张线性合约对应 0.001 BTC,那么 10 张对应 0.01 BTC;要匹配 0.01 BTC 现货,比较的是实际币数量,不是两边都输入 10。每个市场的乘数、步长和最小名义价值都要重新查询;此例不适用于所有反向或特殊合约。
字段速查
看懂凭据与交易术语
| 术语 | 含义 | 避免混淆 |
|---|
| API Key / API Secret | 一组用于标识及验证接口请求的专用凭据 | 不是 UID、登录密码或资金密码 |
| Passphrase | 创建 OKX / Bitget API 时自行设置的 API 口令 | 不是登录密码;丢失时按官方规则重建 |
| API Wallet 私钥 / API 钱包私钥 | 专用代理的签名凭据 | 不是主钱包私钥或助记词 |
| 主地址 / user、代理地址 / signer | 官方协议中的实际账户与签名代理标识 | 不是每个产品都提供输入框;按本文档实际字段填写 |
| 子账户地址 | Hyperliquid 实际子账户 0x 地址 | 主账户接入留空 |
| 主网 / 测试网 / 模拟盘 | 真实资金环境 / 独立模拟环境 | 密钥与资产不能混用 |
| 单向 / 双向持仓 | 净持仓或可同时持多空的持仓方式 | 单向也能做空;与全仓 / 逐仓不是同一设置 |
| 全仓 / 逐仓 | 保证金如何承担仓位风险 | 不要因为接入就随意切换 |
| tick / 滑点 | 最小价格变动单位 / 预计与实际成交价差 | 5 tick 不是固定 5% |
| 净敞口 | 两腿换算后的未对冲风险 | 异币、不同乘数与部分成交可能留下敞口 |
S-S 为现货对现货,S-F 为现货对合约,F-F 为合约对合约。不同资产的配对可能是方向性策略,不能默认属于无风险套利。