Binance 衍生品交易-投资组合保证金技能 是做什么的?
使用经过认证的 API 端点在 Binance 上发起衍生品交易-投资组合保证金请求。某些端点需要 API 密钥和秘密密钥。结果以 JSON 格式返回。
快速参考
| 端点 | 描述 | 必需参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
/papi/v1/balance (GET) | 账户余额(USER_DATA) | 无 | asset, recvWindow | 是 |
/papi/v1/account (GET) | 账户信息(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/bnb-transfer (POST) | BNB 转账 (TRADE) | amount, transferSide | recvWindow | 是 |
/papi/v1/cm/leverageBracket (GET) | CM 名义价值和杠杆区间(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/repay-futures-switch (POST) | 更改自动还款期货状态(TRADE) | autoRepay | recvWindow | 是 |
/papi/v1/repay-futures-switch (GET) | 获取自动还款期货状态(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/cm/leverage (POST) | 更改 CM 初始杠杆 (TRADE) | symbol, leverage | recvWindow | 是 |
/papi/v1/cm/positionSide/dual (POST) | 更改 CM 持仓模式(TRADE) | dualSidePosition | recvWindow | 是 |
/papi/v1/cm/positionSide/dual (GET) | 获取 CM 当前持仓模式(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/um/leverage (POST) | 更改 UM 初始杠杆(TRADE) | symbol, leverage | recvWindow | 是 |
/papi/v1/um/positionSide/dual (POST) | 更改 UM 持仓模式(TRADE) | dualSidePosition | recvWindow | 是 |
/papi/v1/um/positionSide/dual (GET) | 获取 UM 当前持仓模式(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/auto-collection (POST) | 资金自动归集(TRADE) | 无 | recvWindow | 是 |
/papi/v1/asset-collection (POST) | 按资产归集资金(TRADE) | asset | recvWindow | 是 |
/papi/v1/cm/account (GET) | 获取 CM 账户详情(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/cm/income (GET) | 获取 CM 收入历史(USER_DATA) | 无 | symbol, incomeType, startTime, endTime, page, limit, recvWindow | 是 |
/papi/v1/um/order/asyn (GET) | 获取 UM 期货订单历史下载 ID (USER_DATA) | startTime, endTime | recvWindow | 是 |
/papi/v1/um/trade/asyn (GET) | 获取 UM 期货交易历史下载 ID (USER_DATA) | startTime, endTime | recvWindow | 是 |
/papi/v1/um/income/asyn (GET) | 获取 UM 期货交易历史下载 ID (USER_DATA) | startTime, endTime | recvWindow | 是 |
/papi/v1/margin/marginInterestHistory (GET) | 获取保证金借贷利息历史(USER_DATA) | 无 | asset, startTime, endTime, current, size, archived, recvWindow | 是 |
/papi/v2/um/account (GET) | 获取 UM 账户详情 V2(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/um/account (GET) | 获取 UM 账户详情(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/um/accountConfig (GET) | UM 期货账户配置(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/um/order/asyn/id (GET) | 通过 ID 获取 UM 期货订单下载链接(USER_DATA) | downloadId | recvWindow | 是 |
/papi/v1/um/symbolConfig (GET) | UM 期货交易对配置(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/um/trade/asyn/id (GET) | 通过 ID 获取 UM 期货交易下载链接(USER_DATA) | downloadId | recvWindow | 是 |
/papi/v1/um/income/asyn/id (GET) | 通过 ID 获取 UM 期货交易下载链接(USER_DATA) | downloadId | recvWindow | 是 |
/papi/v1/um/income (GET) | 获取 UM 收入历史(USER_DATA) | 无 | symbol, incomeType, startTime, endTime, page, limit, recvWindow | 是 |
/papi/v1/cm/commissionRate (GET) | 获取 CM 用户手续费率(USER_DATA) | symbol | recvWindow | 是 |
/papi/v1/um/commissionRate (GET) | 获取 UM 用户手续费率(USER_DATA) | symbol | recvWindow | 是 |
/papi/v1/margin/maxBorrowable (GET) | 保证金最大可借(USER_DATA) | asset | recvWindow | 是 |
/papi/v1/um/apiTradingStatus (GET) | 投资组合保证金 UM 交易量化规则指标(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/cm/positionRisk (GET) | 查询 CM 持仓信息(USER_DATA) | 无 | marginAsset, pair, recvWindow | 是 |
/papi/v1/margin/marginLoan (GET) | 查询保证金贷款记录(USER_DATA) | asset | txId, startTime, endTime, current, size, archived, recvWindow | 是 |
/papi/v1/margin/maxWithdraw (GET) | 查询保证金最大可提现(USER_DATA) | asset | recvWindow | 是 |
/papi/v1/margin/repayLoan (GET) | 查询保证金还款记录(USER_DATA) | asset | txId, startTime, endTime, current, size, archived, recvWindow | 是 |
/papi/v1/portfolio/interest-history (GET) | 查询投资组合保证金负余额利息历史(USER_DATA) | 无 | asset, startTime, endTime, size, recvWindow | 是 |
/papi/v1/um/positionRisk (GET) | 查询 UM 持仓信息(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/portfolio/negative-balance-exchange-record (GET) | 查询用户负余额自动兑换记录 (USER_DATA) | startTime, endTime | recvWindow | 是 |
/papi/v1/rateLimit/order (GET) | 查询用户速率限制 (USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/repay-futures-negative-balance (POST) | 偿还期货负余额(USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/um/leverageBracket (GET) | UM 名义价值和杠杆区间 (USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/ping (GET) | 测试连接性 | 无 | 无 | 否 |
/papi/v1/cm/userTrades (GET) | CM 账户交易列表(USER_DATA) | 无 | symbol, pair, startTime, endTime, fromId, limit, recvWindow | 是 |
/papi/v1/cm/adlQuantile (GET) | CM 持仓 ADL 分位数估算(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/cm/conditional/allOpenOrders (DELETE) | 取消所有 CM 开放条件订单(TRADE) | symbol | recvWindow | 是 |
/papi/v1/cm/allOpenOrders (DELETE) | 取消所有 CM 开放订单(TRADE) | symbol | recvWindow | 是 |
/papi/v1/um/conditional/allOpenOrders (DELETE) | 取消所有 UM 开放条件订单 (TRADE) | symbol | recvWindow | 是 |
/papi/v1/um/allOpenOrders (DELETE) | 取消所有 UM 开放订单(TRADE) | symbol | recvWindow | 是 |
/papi/v1/cm/conditional/order (DELETE) | 取消 CM 条件订单(TRADE) | symbol | strategyId, newClientStrategyId, recvWindow | 是 |
/papi/v1/cm/conditional/order (POST) | 新建 CM 条件订单(TRADE) | symbol, side, strategyType | positionSide, timeInForce, quantity, reduceOnly, price, workingType, priceProtect, newClientStrategyId, stopPrice, activationPrice, callbackRate, recvWindow | 是 |
/papi/v1/cm/order (DELETE) | 取消 CM 订单(TRADE) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/cm/order (PUT) | 修改 CM 订单(TRADE) | symbol, side, quantity, price | orderId, origClientOrderId, priceMatch, recvWindow | 是 |
/papi/v1/cm/order (POST) | 新建 CM 订单(TRADE) | symbol, side, type | positionSide, timeInForce, quantity, reduceOnly, price, priceMatch, newClientOrderId, newOrderRespType, recvWindow | 是 |
/papi/v1/cm/order (GET) | 查询 CM 订单(USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/margin/allOpenOrders (DELETE) | 取消保证金账户上所有开放订单(TRADE) | symbol | recvWindow | 是 |
/papi/v1/margin/orderList (DELETE) | 取消保证金账户 OCO 订单(TRADE) | symbol | orderListId, listClientOrderId, newClientOrderId, recvWindow | 是 |
/papi/v1/margin/orderList (GET) | 查询保证金账户的 OCO (USER_DATA) | 无 | orderListId, origClientOrderId, recvWindow | 是 |
/papi/v1/margin/order (DELETE) | 取消保证金账户订单(TRADE) | symbol | orderId, origClientOrderId, newClientOrderId, recvWindow | 是 |
/papi/v1/margin/order (POST) | 新建保证金订单(TRADE) | symbol, side, type | quantity, quoteOrderQty, price, stopPrice, newClientOrderId, newOrderRespType, icebergQty, sideEffectType, timeInForce, selfTradePreventionMode, autoRepayAtCancel, recvWindow | 是 |
/papi/v1/margin/order (GET) | 查询保证金账户订单 (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/um/conditional/order (DELETE) | 取消 UM 条件订单(TRADE) | symbol | strategyId, newClientStrategyId, recvWindow | 是 |
/papi/v1/um/conditional/order (POST) | 新建 UM 条件订单 (TRADE) | symbol, side, strategyType | positionSide, timeInForce, quantity, reduceOnly, price, workingType, priceProtect, newClientStrategyId, stopPrice, activationPrice, callbackRate, priceMatch, selfTradePreventionMode, goodTillDate, recvWindow | 是 |
/papi/v1/um/order (DELETE) | 取消 UM 订单(TRADE) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/um/order (PUT) | 修改 UM 订单(TRADE) | symbol, side, quantity, price | orderId, origClientOrderId, priceMatch, recvWindow | 是 |
/papi/v1/um/order (POST) | 新建 UM 订单 (TRADE) | symbol, side, type | positionSide, timeInForce, quantity, reduceOnly, price, newClientOrderId, newOrderRespType, priceMatch, selfTradePreventionMode, goodTillDate, recvWindow | 是 |
/papi/v1/um/order (GET) | 查询 UM 订单 (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/um/feeBurn (GET) | 获取 UM 期货 BNB 燃烧状态 (USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/um/feeBurn (POST) | 切换 UM 期货交易中的 BNB 燃烧 (TRADE) | feeBurn | recvWindow | 是 |
/papi/v1/marginLoan (POST) | 保证金账户借入(MARGIN) | asset, amount | recvWindow | 是 |
/papi/v1/margin/order/oco (POST) | 保证金账户新建 OCO(TRADE) | symbol, side, quantity, price, stopPrice | listClientOrderId, limitClientOrderId, limitIcebergQty, stopClientOrderId, stopLimitPrice, stopIcebergQty, stopLimitTimeInForce, newOrderRespType, sideEffectType, recvWindow | 是 |
/papi/v1/margin/repay-debt (POST) | 保证金账户偿还债务(TRADE) | asset | amount, specifyRepayAssets, recvWindow | 是 |
/papi/v1/repayLoan (POST) | 保证金账户还款(MARGIN) | asset, amount | recvWindow | 是 |
/papi/v1/margin/myTrades (GET) | 保证金账户交易列表 (USER_DATA) | symbol | orderId, startTime, endTime, fromId, limit, recvWindow | 是 |
/papi/v1/cm/conditional/allOrders (GET) | 查询所有 CM 条件订单(USER_DATA) | 无 | symbol, strategyId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/cm/allOrders (GET) | 查询所有 CM 订单 (USER_DATA) | symbol | pair, orderId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/cm/conditional/openOrders (GET) | 查询所有当前 CM 开放条件订单 (USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/cm/openOrders (GET) | 查询所有当前 CM 开放订单(USER_DATA) | 无 | symbol, pair, recvWindow | 是 |
/papi/v1/um/conditional/openOrders (GET) | 查询所有当前 UM 开放条件订单(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/um/openOrders (GET) | 查询所有当前 UM 开放订单(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/margin/allOrders (GET) | 查询所有保证金账户订单 (USER_DATA) | symbol | orderId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/um/conditional/allOrders (GET) | 查询所有 UM 条件订单(USER_DATA) | 无 | symbol, strategyId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/um/allOrders (GET) | 查询所有 UM 订单(USER_DATA) | symbol | orderId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/cm/conditional/orderHistory (GET) | 查询 CM 条件订单历史(USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | 是 |
/papi/v1/cm/orderAmendment (GET) | 查询 CM 修改订单历史(TRADE) | symbol | orderId, origClientOrderId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/cm/conditional/openOrder (GET) | 查询当前 CM 开放条件订单(USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | 是 |
/papi/v1/cm/openOrder (GET) | 查询当前 CM 开放订单 (USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/margin/openOrders (GET) | 查询当前保证金开放订单 (USER_DATA) | symbol | recvWindow | 是 |
/papi/v1/um/conditional/openOrder (GET) | 查询当前 UM 开放条件订单(USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | 是 |
/papi/v1/um/openOrder (GET) | 查询当前 UM 开放订单(USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | 是 |
/papi/v1/margin/openOrderList (GET) | 查询保证金账户的开放 OCO (USER_DATA) | 无 | recvWindow | 是 |
/papi/v1/margin/allOrderList (GET) | 查询保证金账户的所有 OCO (USER_DATA) | 无 | fromId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/um/conditional/orderHistory (GET) | 查询 UM 条件订单历史(USER_DATA) | symbol | strategyId, newClientStrategyId, recvWindow | 是 |
/papi/v1/um/orderAmendment (GET) | 查询 UM 修改订单历史(TRADE) | symbol | orderId, origClientOrderId, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/cm/forceOrders (GET) | 查询用户的 CM 强平订单(USER_DATA) | 无 | symbol, autoCloseType, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/margin/forceOrders (GET) | 查询用户的保证金强平订单(USER_DATA) | 无 | startTime, endTime, current, size, recvWindow | 是 |
/papi/v1/um/forceOrders (GET) | 查询用户的 UM 强平订单 (USER_DATA) | 无 | symbol, autoCloseType, startTime, endTime, limit, recvWindow | 是 |
/papi/v1/um/userTrades (GET) | UM 账户交易列表(USER_DATA) | symbol | startTime, endTime, fromId, limit, recvWindow | 是 |
/papi/v1/um/adlQuantile (GET) | UM 持仓 ADL 分位数估算(USER_DATA) | 无 | symbol, recvWindow | 是 |
/papi/v1/listenKey (DELETE) | 关闭用户数据流(USER_STREAM) | 无 | 无 | 否 |
/papi/v1/listenKey (PUT) | 保持用户数据流活跃(USER_STREAM) | 无 | 无 | 否 |
/papi/v1/listenKey (POST) | 创建用户数据流(USER_STREAM) | 无 | 无 | 否 |
身份验证
- 所有标记为“是”的端点都需要在请求头中包含 API 密钥和秘密密钥。
- 请将您的 API 密钥和秘密密钥存储在环境变量
BINANCE_API_KEY和BINANCE_SECRET_KEY中。 - 对于测试网请求,请使用测试网的 API 端点并将环境变量
BINANCE_TESTNET设置为true。
示例
要获取账户余额:
import os
import requests
from hashlib import sha256
import hmac
import time
api_key = os.environ['BINANCE_API_KEY']
secret_key = os.environ['BINANCE_SECRET_KEY']
testnet = os.environ.get('BINANCE_TESTNET', 'false').lower() == 'true'
if testnet:
base_url = 'https://testnet.binancefuture.com'
else:
base_url = 'https://api.binance.com'
def get_signature(params):
query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
signature = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), sha256).hexdigest()
return signature
params = {
'timestamp': int(time.time() * 1000)
}
params['signature'] = get_signature(params)
headers = {
'X-MBX-APIKEY': api_key
}
response = requests.get(f'{base_url}/papi/v1/balance', params=params, headers=headers)
print(response.json())