关于 derivatives-trading-usds-futures
供使用 Binance USDⓈ-M 合约 API 的 Agent 调用,涵盖行情、账户、仓位及订单操作,并以 JSON 返回结果。
主要功能
- 01查询合约行情与市场数据
- 02查看账户、余额和仓位
- 03创建、修改及取消订单
- 04管理保证金与持仓模式
- 05获取资金费率及交易历史
适用场景
- 01检查合约账户和当前仓位
- 02按行情数据分析合约市场
- 03提交或管理合约订单
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ binance/ binance-skills-hub --skill derivatives-trading-usds-futures安装后在 Claude Code 中输入/derivatives-trading-usds-futures确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CHANGELOG.mdLICENSE.mdreferences/authentication.md详细介绍
Binance 衍生品交易 usds 期货 Skill
使用经过身份验证的 API 端点在 Binance 上请求衍生品交易 usds 期货。某些端点需要 API key 和 secret key。以 JSON 格式返回结果。
快速参考
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
/fapi/v1/accountConfig (GET) | 合约账户配置(USER_DATA) | None | recvWindow | Yes |
/fapi/v2/account (GET) | 账户信息 V2(USER_DATA) | None | recvWindow | Yes |
/fapi/v3/account (GET) | 账户信息 V3(USER_DATA) | None | recvWindow | Yes |
/fapi/v2/balance (GET) | 合约账户余额 V2(USER_DATA) | None | recvWindow | Yes |
/fapi/v3/balance (GET) | 合约账户余额 V3(USER_DATA) | None | recvWindow | Yes |
/fapi/v1/apiTradingStatus (GET) | 合约交易量化规则指标(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v1/feeBurn (GET) | 获取 BNB 销毁状态(USER_DATA) | None | recvWindow | Yes |
/fapi/v1/feeBurn (POST) | 切换合约交易中的 BNB 销毁状态(TRADE) | feeBurn | recvWindow | Yes |
/fapi/v1/multiAssetsMargin (GET) | 获取当前多资产模式(USER_DATA) | None | recvWindow | Yes |
/fapi/v1/multiAssetsMargin (POST) | 更改多资产模式(TRADE) | multiAssetsMargin | recvWindow | Yes |
/fapi/v1/positionSide/dual (GET) | 获取当前持仓模式(USER_DATA) | None | recvWindow | Yes |
/fapi/v1/positionSide/dual (POST) | 更改持仓模式(TRADE) | dualSidePosition | recvWindow | Yes |
/fapi/v1/order/asyn (GET) | 获取合约订单历史记录的下载 ID(USER_DATA) | startTime, endTime | recvWindow | Yes |
/fapi/v1/trade/asyn (GET) | 获取合约交易历史记录的下载 ID(USER_DATA) | startTime, endTime | recvWindow | Yes |
/fapi/v1/income/asyn (GET) | 获取合约交易记录历史的下载 ID(USER_DATA) | startTime, endTime | recvWindow | Yes |
/fapi/v1/order/asyn/id (GET) | 根据 ID 获取合约订单历史记录下载链接(USER_DATA) | downloadId | recvWindow | Yes |
/fapi/v1/trade/asyn/id (GET) | 根据 ID 获取合约交易记录下载链接(USER_DATA) | downloadId | recvWindow | Yes |
/fapi/v1/income/asyn/id (GET) | 根据 ID 获取合约交易记录历史下载链接(USER_DATA) | downloadId | recvWindow | Yes |
/fapi/v1/income (GET) | 获取收益历史记录(USER_DATA) | None | symbol, incomeType, startTime, endTime, page, limit, recvWindow | Yes |
/fapi/v1/leverageBracket (GET) | 名义价值和杠杆档位(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v1/rateLimit/order (GET) | 查询用户速率限制(USER_DATA) | None | recvWindow | Yes |
/fapi/v1/symbolConfig (GET) | 交易对配置(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v1/commissionRate (GET) | 用户手续费率(USER_DATA) | symbol | recvWindow | Yes |
/fapi/v1/convert/acceptQuote (POST) | 接受报价(USER_DATA) | quoteId | recvWindow | Yes |
/fapi/v1/convert/exchangeInfo (GET) | 列出所有兑换交易对 | None | fromAsset, toAsset | No |
/fapi/v1/convert/orderStatus (GET) | 订单状态(USER_DATA) | None | orderId, quoteId | Yes |
/fapi/v1/convert/getQuote (POST) | 发送报价请求(USER_DATA) | fromAsset, toAsset | fromAmount, toAmount, validTime, recvWindow | Yes |
/fapi/v1/ticker/24hr (GET) | 24 小时价格变动统计 | None | symbol | No |
/fapi/v1/symbolAdlRisk (GET) | ADL 风险 | None | symbol | No |
/futures/data/basis (GET) | 基差 | pair, contractType, period, limit | startTime, endTime | No |
/fapi/v1/time (GET) | 检查服务器时间 | None | None | No |
/fapi/v1/indexInfo (GET) | 综合指数交易对信息 | None | symbol | No |
/fapi/v1/aggTrades (GET) | 压缩/聚合交易列表 | symbol | fromId, startTime, endTime, limit | No |
/fapi/v1/continuousKlines (GET) | 连续合约 K 线/蜡烛图数据 | pair, contractType, interval | startTime, endTime, limit | No |
/futures/data/delivery-price (GET) | 季度合约结算价格 | pair | None | No |
/fapi/v1/exchangeInfo (GET) | 交易所信息 | None | None | No |
/fapi/v1/fundingRate (GET) | 获取资金费率历史记录 | None | symbol, startTime, endTime, limit | No |
/fapi/v1/fundingInfo (GET) | 获取资金费率信息 | None | None | No |
/fapi/v1/constituents (GET) | 查询指数价格成分 | symbol | None | No |
/fapi/v1/indexPriceKlines (GET) | 指数价格 K 线/蜡烛图数据 | pair, interval | startTime, endTime, limit | No |
/fapi/v1/insuranceBalance (GET) | 查询保险基金余额快照 | None | symbol | No |
/fapi/v1/klines (GET) | K 线/蜡烛图数据 | symbol, interval | startTime, endTime, limit | No |
/futures/data/globalLongShortAccountRatio (GET) | 多空比 | symbol, period | limit, startTime, endTime | No |
/fapi/v1/markPriceKlines (GET) | 标记价格 K 线/蜡烛图数据 | symbol, interval | startTime, endTime, limit | No |
/fapi/v1/premiumIndex (GET) | 标记价格 | None | symbol | No |
/fapi/v1/assetIndex (GET) | 多资产模式资产指数 | None | symbol | No |
/fapi/v1/historicalTrades (GET) | 查询历史交易(MARKET_DATA) | symbol | limit, fromId | No |
/futures/data/openInterestHist (GET) | 未平仓合约统计 | symbol, period | limit, startTime, endTime | No |
/fapi/v1/openInterest (GET) | 未平仓合约 | symbol | None | No |
/fapi/v1/rpiDepth (GET) | RPI 订单簿 | symbol | limit | No |
/fapi/v1/depth (GET) | 订单簿 | symbol | limit | No |
/fapi/v1/premiumIndexKlines (GET) | 溢价指数 K 线数据 | symbol, interval | startTime, endTime, limit | No |
/fapi/v1/trades (GET) | 最近交易列表 | symbol | limit | No |
/fapi/v1/ticker/bookTicker (GET) | 交易对订单簿行情 | None | symbol | No |
/fapi/v2/ticker/price (GET) | 交易对价格行情 V2 | None | symbol | No |
/fapi/v1/ticker/price (GET) | 交易对价格行情 | None | symbol | No |
/futures/data/takerlongshortRatio (GET) | 主动买入/卖出量 | symbol, period | limit, startTime, endTime | No |
/fapi/v1/ping (GET) | 测试连通性 | None | None | No |
/futures/data/topLongShortAccountRatio (GET) | 顶级交易者多空比(账户) | symbol, period | limit, startTime, endTime | No |
/futures/data/topLongShortPositionRatio (GET) | 顶级交易者多空比(持仓) | symbol, period | limit, startTime, endTime | No |
/fapi/v1/tradingSchedule (GET) | 交易时间表 | None | None | No |
/fapi/v1/pmAccountInfo (GET) | 经典投资组合保证金账户信息(USER_DATA) | asset | recvWindow | Yes |
/fapi/v1/userTrades (GET) | 账户交易列表(USER_DATA) | symbol | orderId, startTime, endTime, fromId, limit, recvWindow | Yes |
/fapi/v1/allOrders (GET) | 所有订单(USER_DATA) | symbol | orderId, startTime, endTime, limit, recvWindow | Yes |
/fapi/v1/countdownCancelAll (POST) | 自动取消所有未平仓订单(TRADE) | symbol, countdownTime | recvWindow | Yes |
/fapi/v1/algoOrder (DELETE) | 取消算法订单(TRADE) | None | algoId, clientAlgoId, recvWindow | Yes |
/fapi/v1/algoOrder (POST) | 新建算法订单(TRADE) | algoType, symbol, side, type | positionSide, timeInForce, quantity, price, triggerPrice, workingType, priceMatch, closePosition, priceProtect, reduceOnly, activatePrice, callbackRate, clientAlgoId, newOrderRespType, selfTradePreventionMode, goodTillDate, recvWindow | Yes |
/fapi/v1/algoOrder (GET) | 查询算法订单(USER_DATA) | None | algoId, clientAlgoId, recvWindow | Yes |
/fapi/v1/algoOpenOrders (DELETE) | 取消所有未平仓算法订单(TRADE) | symbol | recvWindow | Yes |
/fapi/v1/allOpenOrders (DELETE) | 取消所有未平仓订单(TRADE) | symbol | recvWindow | Yes |
/fapi/v1/batchOrders (DELETE) | 取消多个订单(TRADE) | symbol | orderIdList, origClientOrderIdList, recvWindow | Yes |
/fapi/v1/batchOrders (PUT) | 修改多个订单(TRADE) | batchOrders | recvWindow | Yes |
/fapi/v1/batchOrders (POST) | 下达多个订单(TRADE) | batchOrders | recvWindow | Yes |
/fapi/v1/order (DELETE) | 取消订单(TRADE) | symbol | orderId, origClientOrderId, recvWindow | Yes |
/fapi/v1/order (PUT) | 修改订单(TRADE) | symbol, side, quantity, price | orderId, origClientOrderId, priceMatch, recvWindow | Yes |
/fapi/v1/order (POST) | 新建订单(TRADE) | symbol, side, type | positionSide, timeInForce, quantity, reduceOnly, price, newClientOrderId, newOrderRespType, priceMatch, selfTradePreventionMode, goodTillDate, recvWindow | Yes |
/fapi/v1/order (GET) | 查询订单(USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Yes |
/fapi/v1/leverage (POST) | 更改初始杠杆(TRADE) | symbol, leverage | recvWindow | Yes |
/fapi/v1/marginType (POST) | 更改保证金类型(TRADE) | symbol, marginType | recvWindow | Yes |
/fapi/v1/openAlgoOrders (GET) | 当前所有未平仓算法订单(USER_DATA) | None | algoType, symbol, algoId, recvWindow | Yes |
/fapi/v1/openOrders (GET) | 当前所有未平仓订单(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v1/orderAmendment (GET) | 获取订单修改历史记录(USER_DATA) | symbol | orderId, origClientOrderId, startTime, endTime, limit, recvWindow | Yes |
/fapi/v1/positionMargin/history (GET) | 获取持仓保证金变更历史记录(TRADE) | symbol | type, startTime, endTime, limit, recvWindow | Yes |
/fapi/v1/positionMargin (POST) | 修改逐仓持仓保证金(TRADE) | symbol, amount, type | positionSide, recvWindow | Yes |
/fapi/v1/order/test (POST) | 测试订单(TRADE) | symbol, side, type | positionSide, timeInForce, quantity, reduceOnly, price, newClientOrderId, stopPrice, closePosition, activationPrice, callbackRate, workingType, priceProtect, newOrderRespType, priceMatch, selfTradePreventionMode, goodTillDate, recvWindow | Yes |
/fapi/v1/adlQuantile (GET) | 持仓 ADL 分位数估算(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v2/positionRisk (GET) | 持仓信息 V2(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v3/positionRisk (GET) | 持仓信息 V3(USER_DATA) | None | symbol, recvWindow | Yes |
/fapi/v1/allAlgoOrders (GET) | 查询所有算法订单(USER_DATA) | symbol | algoId, startTime, endTime, page, limit, recvWindow | Yes |
/fapi/v1/openOrder (GET) | 查询当前未平仓订单(USER_DATA) | symbol | orderId, origClientOrderId, recvWindow | Yes |
/fapi/v1/stock/contract (POST) | 合约 TradFi 永续合约(USER_DATA) | None | recvWindow | Yes |
/fapi/v1/forceOrders (GET) | 用户强制平仓订单(USER_DATA) | None | symbol, autoCloseType, startTime, endTime, limit, recvWindow | Yes |
/fapi/v1/listenKey (DELETE) | 关闭用户数据流(USER_STREAM) | None | None | No |
/fapi/v1/listenKey (PUT) | 维持用户数据流连接(USER_STREAM) | None | None | No |
/fapi/v1/listenKey (POST) | 启动用户数据流(USER_STREAM) | None | None | No |
参数
通用参数
- recvWindow: (例如,5000)
- symbol:
- startTime:毫秒时间戳(例如,1623319461670)
- endTime:毫秒时间戳(例如,1641782889000)
- downloadId:通过 download id api 获取(例如,1)
- incomeType:TRANSFER、WELCOME_BONUS、REALIZED_PNL、FUNDING_FEE、COMMISSION、INSURANCE_CLEAR、REFERRAL_KICKBACK、COMMISSION_REBATE、API_REBATE、CONTEST_REWARD、CROSS_COLLATERAL_TRANSFER、OPTIONS_PREMIUM_FEE、OPTIONS_SETTLE_PROFIT、INTERNAL_TRANSFER、AUTO_EXCHANGE、DELIVERED_SETTELMENT、COIN_SWAP_DEPOSIT、COIN_SWAP_WITHDRAW、POSITION_LIMIT_INCREASE_FEE、STRATEGY_UMFUTURES_TRANSFER,FEE_RETURN,BFUSD_REWARD
- startTime:(例如,1623319461670)
- endTime:(例如,1641782889000)
- page:
- limit:默认值为 100;最大值为 1000(例如,100)
- feeBurn: "true":开启手续费折扣;"false":关闭手续费折扣
- symbol:
- quoteId:(例如,1)
- fromAsset:用户支付的币种
- toAsset:用户收到的币种
- orderId:必须提供 orderId 或 quoteId(例如,1)
- quoteId:必须提供 orderId 或 quoteId(例如,1)
- fromAsset:
- toAsset:
- fromAmount:指定时,这是转换后将从您的账户扣除的金额(例如,1.0)
- toAmount:指定时,这是转换后将记入您账户的金额(例如,1.0)
- validTime:10s,默认值为 10s(例如,10s)
- pair:
- limit:默认值为 30,最大值为 500(例如,30)
- fromId:从此 ID 开始获取聚合交易,包含此 ID。(例如,1)
- asset:
- orderId:(例如,1)
- countdownTime:倒计时,1000 表示 1 秒。0 表示取消计时器
- algoId:(例如,1)
- clientAlgoId:(例如,1)
- orderIdList:最大长度为 10,例如 [1234567,2345678]
- origClientOrderIdList:最大长度为 10,例如 ["my_id_1","my_id_2"],对双引号进行编码。逗号后不要留空格。
- origClientOrderId:(例如,1)
- leverage:目标初始杠杆:1 到 125 的整数
- multiAssetsMargin:"true":多资产模式;"false":单资产模式
- dualSidePosition:"true":双向持仓模式;"false":单向持仓模式
- algoType:
- type:1:增加仓位保证金,2:减少仓位保证金
- amount:(例如,1.0)
- type:
- batchOrders:订单列表。最多 5 个订单
- quantity:订单数量,不能与
closePosition=true一起发送(例如,1.0) - price:(例如,1.0)
- algoType:仅支持
CONDITIONAL - quantity:(例如,1.0)
- price:(例如,1.0)
- triggerPrice:(例如,1.0)
- closePosition:
true、false;全部平仓,与STOP_MARKET或TAKE_PROFIT_MARKET配合使用。 - priceProtect:"TRUE" 或 "FALSE",默认值为 "FALSE"。与
STOP/STOP_MARKET或TAKE_PROFIT/TAKE_PROFIT_MARKET订单配合使用。 - reduceOnly:"true" 或 "false"。默认值为 "false"。不能在双向持仓模式下发送
- activatePrice:与
TRAILING_STOP_MARKET订单配合使用,默认为最新价格(支持不同的workingType)(例如,1.0) - callbackRate:与
TRAILING_STOP_MARKET订单配合使用,最小值为 0.1,最大值为 5,其中 1 表示 1%(例如,1.0) - goodTillDate:
GTD的订单取消时间;当timeInforce设置为GTD时为必填项;订单时间戳仅保留秒级精度,毫秒部分将被忽略;goodTillDate 时间戳必须大于当前时间加 600 秒,且小于 253402300799000 - newClientOrderId:未结订单中的唯一 ID。如果未发送,则自动生成。只能是符合以下规则的字符串:
^[\.A-Z\:/a-z0-9_-]{1,36}$(例如,1) - stopPrice:与
STOP/STOP_MARKET或TAKE_PROFIT/TAKE_PROFIT_MARKET订单配合使用。(例如,1.0) - activationPrice:与
TRAILING_STOP_MARKET订单配合使用,默认为最新价格(支持不同的workingType)(例如,1.0) - batchOrders:订单列表。最多 5 个订单
枚举
- contractType:PERPETUAL | CURRENT_MONTH | NEXT_MONTH | CURRENT_QUARTER | NEXT_QUARTER | PERPETUAL_DELIVERING
- period:5m | 15m | 30m | 1h | 2h | 4h | 6h | 12h | 1d
- interval:1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M
- marginType:ISOLATED | CROSSED
- positionSide:BOTH | LONG | SHORT
- side:BUY | SELL
- priceMatch:NONE | OPPONENT | OPPONENT_5 | OPPONENT_10 | OPPONENT_20 | QUEUE | QUEUE_5 | QUEUE_10 | QUEUE_20
- timeInForce:GTC | IOC | FOK | GTX | GTD | RPI
- workingType:MARK_PRICE | CONTRACT_PRICE
- newOrderRespType:ACK | RESULT
- selfTradePreventionMode:EXPIRE_TAKER | EXPIRE_BOTH | EXPIRE_MAKER
- autoCloseType:LIQUIDATION | ADL
身份验证
对于需要身份验证的端点,你需要提供 Binance API 凭据。 所需凭据:
- apiKey:你的 Binance API 密钥(用于请求头)
- secretKey:你的 Binance API 密钥(用于签名)
基础 URL:
安全
共享凭据
用户可以通过不同方式提供 Binance API 凭据。Agent 会尝试通过前两种方式自动获取凭据;用户也可以明确告知 Agent 已设置凭据或将凭据存储在 .env 文件中,此时 Agent 应重新读取该文件。使用前两种方法发送 HTTP 请求时,Agent 也无需用户确认。
- 环境变量
仅搜索以下指定变量(绝不要转储完整环境变量):
已授权的环境变量
- 主网:
BINANCE_API_KEY和BINANCE_SECRET_KEY - 测试网:
BINANCE_TESTNET_API_KEY和BINANCE_TESTNET_SECRET_KEY
在单个 exec 调用中读取并使用,避免原始密钥进入 Agent 的上下文:
KEY="$BINANCE_API_KEY"
SECRET="$BINANCE_SECRET_KEY"
response=$(curl -s -X GET "$URL" \
-H "X-MBX-APIKEY: $KEY" \
--data-urlencode "param1=value1")
echo "$response"
必须在 OpenClaw 启动前设置环境变量。环境变量会在进程启动时继承,无法注入正在运行的实例。如果需要在不重启的情况下添加或更新凭据,请使用密钥文件(见选项 2)。
- 密钥文件(.env)
检查 ~/.openclaw/secrets.env、~/.env 或工作区中的 .env 文件。使用 grep 读取单个密钥,绝不要加载整个文件:
# Try all credential locations in order
API_KEY=$(grep '^BINANCE_API_KEY=' ~/.openclaw/secrets.env 2>/dev/null | cut -d= -f2-)
SECRET_KEY=$(grep '^BINANCE_SECRET_KEY=' ~/.openclaw/secrets.env 2>/dev/null | cut -d= -f2-)
# Fallback: search .env in known directories (KEY=VALUE then raw line format)
for dir in ~/.openclaw ~; do
[ -n "$API_KEY" ] && break
env_file="$dir/.env"
[ -f "$env_file" ] || continue
# Read first two lines
line1=$(sed -n '1p' "$env_file")
line2=$(sed -n '2p' "$env_file")
# Check if lines contain '=' indicating KEY=VALUE format
if [[ "$line1" == *=* && "$line2" == *=* ]]; then
API_KEY=$(grep '^BINANCE_API_KEY=' "$env_file" 2>/dev/null | cut -d= -f2-)
SECRET_KEY=$(grep '^BINANCE_SECRET_KEY=' "$env_file" 2>/dev/null | cut -d= -f2-)
else
# Treat lines as raw values
API_KEY="$line1"
SECRET_KEY="$line2"
fi
done
此文件可随时更新,无需重启 OpenClaw;每次调用都会重新读取密钥。用户可以告知你变量现已设置或已存储在 .env 文件中,此时你应重新读取该文件。
- 内联文件
发送内容采用以下格式的文件:
abc123...xyz
secret123...key
- 绝不要运行
printenv、env、export或不带特定变量名的set - 绝不要在未锚定到特定密钥('
^VARNAME=')的情况下对env文件运行grep - 绝不要将密钥文件加载到 shell 环境中(
source .env或. .env) - 仅读取当前任务明确需要的凭据
- 绝不要在输出或回复中回显或记录原始凭据
- 如果
TOOLS.md包含真实凭据,绝不要将其提交到版本控制;应将其添加到.gitignore
绝不泄露 API 密钥和密钥
绝不泄露 API 密钥和密钥文件的位置。
绝不要将 API 密钥和密钥发送到主网和测试网以外的任何网站。
绝不显示完整密钥
向用户显示凭据时:
- API 密钥: 显示前 5 位和后 4 位:
su1Qc...8akf - 密钥: 始终遮蔽,仅显示最后 5 位:
***...aws1
用户询问凭据时的回复示例: 账户:main API 密钥:su1Qc...8akf 密钥:***...aws1 环境:主网
列出账户
列出账户时,仅显示名称和环境,绝不显示密钥: Binance 账户:
- main(主网/测试网)
- testnet-dev(测试网)
- futures-keys(主网)
主网交易
在主网上执行交易时,务必先向用户确认,并要求他们输入“CONFIRM”以继续。
Binance 账户
main
- API Key:your_mainnet_api_key
- Secret:your_mainnet_secret
- Testnet:false
testnet-dev
- API Key:your_testnet_api_key
- Secret:your_testnet_secret
- Testnet:true
TOOLS.md 结构
## Binance Accounts
### main
- API Key: abc123...xyz
- Secret: secret123...key
- Testnet: false
- Description: Primary trading account
### testnet-dev
- API Key: test456...abc
- Secret: testsecret...xyz
- Testnet: true
- Description: Development/testing
### futures-keys
- API Key: futures789...def
- Secret: futuressecret...uvw
- Testnet: false
- Description: Futures trading account
Agent 行为
- 请求凭证:遮蔽密钥(仅显示最后 5 个字符)
- 列出账户:显示名称和环境,绝不显示密钥
- 选择账户:如果存在歧义则询问,默认选择 main
- 在主网执行交易时,先询问用户是否确认,并要求用户输入“CONFIRM”以继续
- 新凭证:提示用户提供名称、环境和签名模式
- 如果请求需要签名,而该请求不是订单,且 API 密钥未注明是
mainnet或testnet密钥,则尝试向不同的 base url 发送请求,查看是否可行,无需询问用户。如果可行,则将密钥与对应环境一并保存。
添加新账户
用户通过内联文件或消息提供新凭证时:
- 询问账户名称
- 询问:Mainnet、Testnet
- 将凭证存储在
TOOLS.md中,并确认时遮蔽密钥
签名请求
对于需要签名的交易端点:
- 先检测密钥类型,在签名前检查密钥格式。
- 使用所有参数(包括时间戳,单位为 Unix 毫秒)构建查询字符串。
- 根据 RFC 3986 使用 UTF-8 对参数进行百分号编码。
- 使用 secretKey 根据账户配置采用 HMAC SHA256、RSA 或 Ed25519 对查询字符串签名。
- 将签名附加到查询字符串。
- 添加
X-MBX-APIKEY请求头。
否则,不要执行第 4–6 步。
新客户端订单 ID
对于包含 newClientOrderId 参数的端点,其值必须始终以 agent- 开头。如果未提供该参数,将自动生成由 agent- 加 18 个随机字母数字字符组成的值。如果提供了值,则会为其添加 agent- 前缀。
示例:agent-1a2b3c4d5e6f7g8h9i
User Agent 请求头
添加 User-Agent 请求头,其值为以下字符串:binance-derivatives-trading-usds-futures/1.1.0 (Skill)
实现细节请参阅 references/authentication.md。