跳到主要内容

钱包与资产指南

在 BigONE，您的资产为了不同目的被隔离在不同的“账户”（钱包）中。了解如何在这些账户之间转移资金对于高级交易策略至关重要。

账户类型​

  1. 资金账户 (FUND): 中心枢纽。充值到账于此，提现也从此开始。
  2. 现货账户 (SPOT): 用于现货交易。
  3. 合约账户 (CONTRACT): 用于合约（永续）交易。
信息

您无法使用现货账户中的资金进行合约交易。您必须先 划转 资金。

第一课：内部转账 (划转)​

内部转账是即时且免费的。这对于套利机器人或将利润转移到安全账户至关重要。

端点: POST /viewer/transfer

逻辑​

将 1 BTC 从现货账户划转到合约账户：

  • from: "SPOT"
  • to: "CONTRACT"
  • symbol: "BTC"
  • amount: "1.0"
import requests
import time
import jwt
import uuid

# 认证设置 ...
# ...

payload = {
    "guid": str(uuid.uuid4()), # 唯一 ID 用于幂等性
    "symbol": "BTC",
    "amount": "1.00000000",
    "from": "SPOT",
    "to": "CONTRACT"
}

response = requests.post(f"{BASE_URL}/viewer/transfer", json=payload, headers=headers)
print(response.json())

第二课：处理充值​

要接收资金，您需要一个地址。

端点: GET /viewer/assets/{symbol}/address

逻辑​

  1. 请求特定链的地址（例如：TRC20 的 USDT）。
  2. 向用户或发送方展示此地址。
  3. 监控: 使用 GET /viewer/deposits 检测资金何时到账。
# 获取 USDT-TRC20 地址
res = requests.get(f"{BASE_URL}/viewer/assets/USDT/address", headers=headers)
addresses = res.json()
trc20 = next(a for a in addresses if a['chain'] == 'TRX')

print(f"充值 USDT 到: {trc20['value']}")

第三课：自动化提现​

提现允许您将资金转出交易所。

端点: POST /withdrawals

准备工作​

  • 白名单: 目标地址必须已添加到 BigONE 界面的可信地址列表中。
  • 2FA: 用于提现的 API Key 通常需要 IP 白名单和特殊权限。
payload = {
    "guid": str(uuid.uuid4()),
    "symbol": "USDT",
    "amount": "100.0",
    "target_address": "Txyz123...", # 必须在白名单中
    "gateway_name": "Tron"          # 指定链
}

response = requests.post(f"{BASE_URL}/withdrawals", json=payload, headers=headers)
print(f"提现 ID: {response.json()['id']}")

结论​

管理资产流与交易策略一样重要。

要点:

  • 隔离: 始终检查您的资金在哪个账户（SPOT vs CONTRACT）。
  • 幂等性: 始终为转账和提现发送唯一的 guid，以防止网络重试期间的双重花费。
  • 安全性: 提现需要更严格的 API 权限和地址白名单。

下一步: