Back to Details

assets

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Binance Assets Skill

Binance 资产Skill

Assets request on Binance using authenticated API endpoints. Requires API key and secret key for certain endpoints. Return the result in JSON format.
通过经过身份验证的API端点发起币安资产相关请求，部分端点需要提供API key和secret key，返回结果为JSON格式。

Quick Reference

快速参考

EndpointDescriptionRequiredOptionalAuthentication
/sapi/v1/account/apiTradingStatus
(GET)		Account API Trading Status (USER_DATA)NonerecvWindowYes
/sapi/v1/account/info
(GET)		Account info (USER_DATA)NonerecvWindowYes
/sapi/v1/account/status
(GET)		Account Status (USER_DATA)NonerecvWindowYes
/sapi/v1/account/apiRestrictions
(GET)		Get API Key Permission (USER_DATA)NonerecvWindowYes
/sapi/v1/accountSnapshot
(GET)		Daily Account Snapshot (USER_DATA)typestartTime, endTime, limit, recvWindowYes
/sapi/v1/account/disableFastWithdrawSwitch
(POST)		Disable Fast Withdraw Switch (USER_DATA)NonerecvWindowYes
/sapi/v1/account/enableFastWithdrawSwitch
(POST)		Enable Fast Withdraw Switch (USER_DATA)NonerecvWindowYes
/sapi/v1/bnbBurn
(POST)		Toggle BNB Burn On Spot Trade And Margin Interest (USER_DATA)NonespotBNBBurn, interestBNBBurn, recvWindowYes
/sapi/v1/asset/assetDetail
(GET)		Asset Detail (USER_DATA)Noneasset, recvWindowYes
/sapi/v1/asset/dust-btc
(POST)		Get Assets That Can Be Converted Into BNB (USER_DATA)NoneaccountType, recvWindowYes
/sapi/v1/asset/assetDividend
(GET)		Asset Dividend Record (USER_DATA)Noneasset, startTime, endTime, limit, recvWindowYes
/sapi/v1/asset/ledger-transfer/cloud-mining/queryByPage
(GET)		Get Cloud-Mining payment and refund history (USER_DATA)startTime, endTimetranId, clientTranId, asset, current, sizeYes
/sapi/v1/asset/dust-convert/convert
(POST)		Dust Convert (USER_DATA)assetclientId, targetAsset, thirdPartyClientId, dustQuotaAssetToTargetAssetPriceYes
/sapi/v1/asset/dust-convert/query-convertible-assets
(POST)		Dust Convertible Assets (USER_DATA)targetAssetdustQuotaAssetToTargetAssetPriceYes
/sapi/v1/asset/dribblet
(GET)		DustLog(USER_DATA)NoneaccountType, startTime, endTime, recvWindowYes
/sapi/v1/asset/dust
(POST)		Dust Transfer (USER_DATA)assetaccountType, recvWindowYes
/sapi/v1/asset/get-funding-asset
(POST)		Funding Wallet (USER_DATA)Noneasset, needBtcValuation, recvWindowYes
/sapi/v1/spot/open-symbol-list
(GET)		Get Open Symbol List (MARKET_DATA)NoneNoneNo
/sapi/v1/asset/custody/transfer-history
(GET)		Query User Delegation History(For Master Account)(USER_DATA)email, startTime, endTimetype, asset, current, size, recvWindowYes
/sapi/v1/asset/transfer
(GET)		Query User Universal Transfer History(USER_DATA)typestartTime, endTime, current, size, fromSymbol, toSymbol, recvWindowYes
/sapi/v1/asset/transfer
(POST)		User Universal Transfer (USER_DATA)type, asset, amountfromSymbol, toSymbol, recvWindowYes
/sapi/v1/asset/wallet/balance
(GET)		Query User Wallet Balance (USER_DATA)NonequoteAsset, recvWindowYes
/sapi/v1/spot/delist-schedule
(GET)		Get symbols delist schedule for spot (MARKET_DATA)NonerecvWindowNo
/sapi/v1/asset/tradeFee
(GET)		Trade Fee (USER_DATA)Nonesymbol, recvWindowYes
/sapi/v3/asset/getUserAsset
(POST)		User Asset (USER_DATA)Noneasset, needBtcValuation, recvWindowYes
/sapi/v1/capital/config/getall
(GET)		All Coins' Information (USER_DATA)NonerecvWindowYes
/sapi/v1/capital/deposit/address
(GET)		Deposit Address(supporting network) (USER_DATA)coinnetwork, amount, recvWindowYes
/sapi/v1/capital/deposit/hisrec
(GET)		Deposit History (supporting network) (USER_DATA)NoneincludeSource, coin, status, startTime, endTime, offset, limit, recvWindow, txIdYes
/sapi/v1/capital/deposit/address/list
(GET)		Fetch deposit address list with network(USER_DATA)coinnetworkYes
/sapi/v1/capital/withdraw/address/list
(GET)		Fetch withdraw address list (USER_DATA)NoneNoneYes
/sapi/v1/capital/withdraw/quota
(GET)		Fetch withdraw quota (USER_DATA)NoneNoneYes
/sapi/v1/capital/deposit/credit-apply
(POST)		One click arrival deposit apply (for expired address deposit) (USER_DATA)NonedepositId, txId, subAccountId, subUserIdYes
/sapi/v1/capital/withdraw/history
(GET)		Withdraw History (supporting network) (USER_DATA)Nonecoin, withdrawOrderId, status, offset, limit, idList, startTime, endTime, recvWindowYes
/sapi/v1/capital/withdraw/apply
(POST)		Withdraw(USER_DATA)coin, address, amountwithdrawOrderId, network, addressTag, transactionFeeFlag, name, walletType, recvWindowYes
/sapi/v1/system/status
(GET)		System Status (System)NoneNoneNo
/sapi/v1/addressVerify/list
(GET)		Fetch address verification list (USER_DATA)NonerecvWindowYes
/sapi/v1/localentity/broker/deposit/provide-info
(PUT)		Submit Deposit Questionnaire (For local entities that require travel rule) (supporting network) (USER_DATA)subAccountId, depositId, questionnaire, beneficiaryPii, signaturenetwork, coin, amount, address, addressTagYes
/sapi/v1/localentity/broker/withdraw/apply
(POST)		Broker Withdraw (for brokers of local entities that require travel rule) (USER_DATA)address, coin, amount, withdrawOrderId, questionnaire, originatorPii, signatureaddressTag, network, addressName, transactionFeeFlag, walletTypeYes
/sapi/v2/localentity/deposit/history
(GET)		Deposit History V2 (for local entities that required travel rule) (supporting network) (USER_DATA)NonedepositId, txId, network, coin, retrieveQuestionnaire, startTime, endTime, offset, limitYes
/sapi/v1/localentity/deposit/history
(GET)		Deposit History (for local entities that required travel rule) (supporting network) (USER_DATA)NonetrId, txId, tranId, network, coin, travelRuleStatus, pendingQuestionnaire, startTime, endTime, offset, limitYes
/sapi/v2/localentity/deposit/provide-info
(PUT)		Submit Deposit Questionnaire V2 (For local entities that require travel rule) (supporting network) (USER_DATA)depositId, questionnaireNoneYes
/sapi/v1/localentity/deposit/provide-info
(PUT)		Submit Deposit Questionnaire (For local entities that require travel rule) (supporting network) (USER_DATA)tranId, questionnaireNoneYes
/sapi/v1/localentity/vasp
(GET)		VASP list (for local entities that require travel rule) (supporting network) (USER_DATA)NonerecvWindowYes
/sapi/v1/localentity/questionnaire-requirements
(GET)		Check Questionnaire Requirements (for local entities that require travel rule) (supporting network) (USER_DATA)NonerecvWindowYes
/sapi/v2/localentity/withdraw/history
(GET)		Withdraw History V2 (for local entities that require travel rule) (supporting network) (USER_DATA)NonetrId, txId, withdrawOrderId, network, coin, travelRuleStatus, offset, limit, startTime, endTime, recvWindowYes
/sapi/v1/localentity/withdraw/history
(GET)		Withdraw History (for local entities that require travel rule) (supporting network) (USER_DATA)NonetrId, txId, withdrawOrderId, network, coin, travelRuleStatus, offset, limit, startTime, endTime, recvWindowYes
/sapi/v1/localentity/withdraw/apply
(POST)		Withdraw (for local entities that require travel rule) (USER_DATA)coin, address, amount, questionnairewithdrawOrderId, network, addressTag, transactionFeeFlag, name, walletType, recvWindowYes
Endpoint描述必填参数选填参数身份验证
/sapi/v1/account/apiTradingStatus
(GET)		账户API交易状态（USER_DATA）无recvWindow是
/sapi/v1/account/info
(GET)		账户信息（USER_DATA）无recvWindow是
/sapi/v1/account/status
(GET)		账户状态（USER_DATA）无recvWindow是
/sapi/v1/account/apiRestrictions
(GET)		获取API Key权限（USER_DATA）无recvWindow是
/sapi/v1/accountSnapshot
(GET)		每日账户快照（USER_DATA）typestartTime, endTime, limit, recvWindow是
/sapi/v1/account/disableFastWithdrawSwitch
(POST)		关闭快速提现开关（USER_DATA）无recvWindow是
/sapi/v1/account/enableFastWithdrawSwitch
(POST)		开启快速提现开关（USER_DATA）无recvWindow是
/sapi/v1/bnbBurn
(POST)		切换现货交易和杠杆利息的BNB抵扣设置（USER_DATA）无spotBNBBurn, interestBNBBurn, recvWindow是
/sapi/v1/asset/assetDetail
(GET)		资产详情（USER_DATA）无asset, recvWindow是
/sapi/v1/asset/dust-btc
(POST)		获取可转换为BNB的资产列表（USER_DATA）无accountType, recvWindow是
/sapi/v1/asset/assetDividend
(GET)		资产分红记录（USER_DATA）无asset, startTime, endTime, limit, recvWindow是
/sapi/v1/asset/ledger-transfer/cloud-mining/queryByPage
(GET)		获取云挖矿支付和退款历史（USER_DATA）startTime, endTimetranId, clientTranId, asset, current, size是
/sapi/v1/asset/dust-convert/convert
(POST)		小额资产转换（USER_DATA）assetclientId, targetAsset, thirdPartyClientId, dustQuotaAssetToTargetAssetPrice是
/sapi/v1/asset/dust-convert/query-convertible-assets
(POST)		可转换小额资产列表（USER_DATA）targetAssetdustQuotaAssetToTargetAssetPrice是
/sapi/v1/asset/dribblet
(GET)		小额资产转换日志（USER_DATA）无accountType, startTime, endTime, recvWindow是
/sapi/v1/asset/dust
(POST)		小额资产划转（USER_DATA）assetaccountType, recvWindow是
/sapi/v1/asset/get-funding-asset
(POST)		资金钱包（USER_DATA）无asset, needBtcValuation, recvWindow是
/sapi/v1/spot/open-symbol-list
(GET)		获取开放交易对列表（MARKET_DATA）无无否
/sapi/v1/asset/custody/transfer-history
(GET)		查询用户委托历史（仅主账户可用）（USER_DATA）email, startTime, endTimetype, asset, current, size, recvWindow是
/sapi/v1/asset/transfer
(GET)		查询用户通用划转历史（USER_DATA）typestartTime, endTime, current, size, fromSymbol, toSymbol, recvWindow是
/sapi/v1/asset/transfer
(POST)		用户通用划转（USER_DATA）type, asset, amountfromSymbol, toSymbol, recvWindow是
/sapi/v1/asset/wallet/balance
(GET)		查询用户钱包余额（USER_DATA）无quoteAsset, recvWindow是
/sapi/v1/spot/delist-schedule
(GET)		获取现货交易对下线计划（MARKET_DATA）无recvWindow否
/sapi/v1/asset/tradeFee
(GET)		交易手续费（USER_DATA）无symbol, recvWindow是
/sapi/v3/asset/getUserAsset
(POST)		用户资产（USER_DATA）无asset, needBtcValuation, recvWindow是
/sapi/v1/capital/config/getall
(GET)		所有币种信息（USER_DATA）无recvWindow是
/sapi/v1/capital/deposit/address
(GET)		充值地址（支持多网络）（USER_DATA）coinnetwork, amount, recvWindow是
/sapi/v1/capital/deposit/hisrec
(GET)		充值历史（支持多网络）（USER_DATA）无includeSource, coin, status, startTime, endTime, offset, limit, recvWindow, txId是
/sapi/v1/capital/deposit/address/list
(GET)		获取对应网络的充值地址列表（USER_DATA）coinnetwork是
/sapi/v1/capital/withdraw/address/list
(GET)		获取提现地址列表（USER_DATA）无无是
/sapi/v1/capital/withdraw/quota
(GET)		获取提现额度（USER_DATA）无无是
/sapi/v1/capital/deposit/credit-apply
(POST)		一键充值到账申请（适用于过期地址充值场景）（USER_DATA）无depositId, txId, subAccountId, subUserId是
/sapi/v1/capital/withdraw/history
(GET)		提现历史（支持多网络）（USER_DATA）无coin, withdrawOrderId, status, offset, limit, idList, startTime, endTime, recvWindow是
/sapi/v1/capital/withdraw/apply
(POST)		提现（USER_DATA）coin, address, amountwithdrawOrderId, network, addressTag, transactionFeeFlag, name, walletType, recvWindow是
/sapi/v1/system/status
(GET)		系统状态（系统接口）无无否
/sapi/v1/addressVerify/list
(GET)		获取地址验证列表（USER_DATA）无recvWindow是
/sapi/v1/localentity/broker/deposit/provide-info
(PUT)		提交充值问卷（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）subAccountId, depositId, questionnaire, beneficiaryPii, signaturenetwork, coin, amount, address, addressTag是
/sapi/v1/localentity/broker/withdraw/apply
(POST)		经纪商提现（适用于需要旅行规则的本地主体经纪商）（USER_DATA）address, coin, amount, withdrawOrderId, questionnaire, originatorPii, signatureaddressTag, network, addressName, transactionFeeFlag, walletType是
/sapi/v2/localentity/deposit/history
(GET)		充值历史V2（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）无depositId, txId, network, coin, retrieveQuestionnaire, startTime, endTime, offset, limit是
/sapi/v1/localentity/deposit/history
(GET)		充值历史（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）无trId, txId, tranId, network, coin, travelRuleStatus, pendingQuestionnaire, startTime, endTime, offset, limit是
/sapi/v2/localentity/deposit/provide-info
(PUT)		提交充值问卷V2（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）depositId, questionnaire无是
/sapi/v1/localentity/deposit/provide-info
(PUT)		提交充值问卷（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）tranId, questionnaire无是
/sapi/v1/localentity/vasp
(GET)		VASP列表（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）无recvWindow是
/sapi/v1/localentity/questionnaire-requirements
(GET)		检查问卷要求（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）无recvWindow是
/sapi/v2/localentity/withdraw/history
(GET)		提现历史V2（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）无trId, txId, withdrawOrderId, network, coin, travelRuleStatus, offset, limit, startTime, endTime, recvWindow是
/sapi/v1/localentity/withdraw/history
(GET)		提现历史（适用于需要旅行规则的本地主体，支持多网络）（USER_DATA）无trId, txId, withdrawOrderId, network, coin, travelRuleStatus, offset, limit, startTime, endTime, recvWindow是
/sapi/v1/localentity/withdraw/apply
(POST)		提现（适用于需要旅行规则的本地主体）（USER_DATA）coin, address, amount, questionnairewithdrawOrderId, network, addressTag, transactionFeeFlag, name, walletType, recvWindow是

Parameters

参数说明

Common Parameters

通用参数

  • recvWindow: (e.g., 5000)
  • type:
  • startTime: (e.g., 1623319461670)
  • endTime: (e.g., 1641782889000)
  • limit: min 7, max 30, default 7 (e.g., 7)
  • spotBNBBurn: "true" or "false"; Determines whether to use BNB to pay for trading fees on SPOT
  • interestBNBBurn: "true" or "false"; Determines whether to use BNB to pay for margin loan's interest
  • asset: If asset is blank, then query all positive assets user have.
  • accountType: 
    SPOT
    or 
    MARGIN
    ,default 
    SPOT
    (e.g., SPOT)
  • tranId: The transaction id (e.g., 1)
  • clientTranId: The unique flag (e.g., 1)
  • startTime: (e.g., 1623319461670)
  • endTime: (e.g., 1641782889000)
  • current: current page, default 1, the min value is 1 (e.g., 1)
  • size: page size, default 10, the max value is 100 (e.g., 10)
  • asset:
  • clientId: A unique id for the request (e.g., 1)
  • targetAsset:
  • thirdPartyClientId: (e.g., 1)
  • dustQuotaAssetToTargetAssetPrice: (e.g., 1.0)
  • targetAsset:
  • needBtcValuation: true or false
  • email:
  • type: Delegate/Undelegate
  • fromSymbol:
  • toSymbol:
  • quoteAsset: 
    USDT
    , 
    ETH
    , 
    USDC
    , 
    BNB
    , etc. default 
    BTC
    (e.g., BTC)
  • symbol:
  • needBtcValuation: Whether need btc valuation or not.
  • amount: (e.g., 1.0)
  • coin:
  • network:
  • amount: (e.g., 1.0)
  • includeSource: Default: 
    false
    , return 
    sourceAddress
    field when set to 
    true
  • coin:
  • status: 0(0:Email Sent, 2:Awaiting Approval 3:Rejected 4:Processing 6:Completed)
  • offset: Default: 0
  • txId: (e.g., 1)
  • depositId: Deposit record Id, priority use (e.g., 1)
  • subAccountId: Sub-accountId of Cloud user (e.g., 1)
  • subUserId: Sub-userId of parent user (e.g., 1)
  • withdrawOrderId: client side id for withdrawal, if provided in POST 
    /sapi/v1/capital/withdraw/apply
    , can be used here for query. (e.g., 1)
  • idList: id list returned in the response of POST 
    /sapi/v1/capital/withdraw/apply
    , separated by 
    ,
  • address:
  • addressTag: Secondary address identifier for coins like XRP,XMR etc.
  • transactionFeeFlag: When making internal transfer, 
    true
    for returning the fee to the destination account; 
    false
    for returning the fee back to the departure account. Default 
    false
    .
  • name: Description of the address. Address book cap is 200, space in name should be encoded into 
    %20
  • walletType: The wallet type for withdraw，0-spot wallet ，1-funding wallet. Default walletType is the current "selected wallet" under wallet->Fiat and Spot/Funding->Deposit
  • subAccountId: External user ID. (e.g., 1)
  • depositId: Wallet deposit ID (e.g., 1)
  • questionnaire: JSON format questionnaire answers.
  • beneficiaryPii: JSON format beneficiary Pii.
  • address:
  • signature: Must be the last parameter.
  • addressName: Description of the address. Address book cap is 200, space in name should be encoded into 
    %20
  • withdrawOrderId: withdrawID defined by the client (i.e. client's internal withdrawID) (e.g., 1)
  • originatorPii: JSON format originator Pii, see StandardPii section below
  • depositId: Comma(,) separated list of wallet tran Ids. (e.g., 1)
  • retrieveQuestionnaire: true: return 
    questionnaire
    within response.
  • trId: Comma(,) separated list of travel rule record Ids. (e.g., 1)
  • tranId: Comma(,) separated list of wallet tran Ids. (e.g., 1)
  • travelRuleStatus: 0:Completed,1:Pending,2:Failed
  • pendingQuestionnaire: true: Only return records that pending deposit questionnaire. false/not provided: return all records.
  • tranId: Wallet tran ID (e.g., 1)
  • recvWindow: （例如：5000）
  • type:
  • startTime: （例如：1623319461670）
  • endTime: （例如：1641782889000）
  • limit: 最小7，最大30，默认7（例如：7）
  • spotBNBBurn: "true" 或 "false"；指定是否使用BNB抵扣现货交易手续费
  • interestBNBBurn: "true" 或 "false"；指定是否使用BNB抵扣杠杆借贷利息
  • asset: 若asset为空，则查询用户所有持有的正余额资产
  • accountType: 
    SPOT
    或 
    MARGIN
    ，默认
    SPOT
    （例如：SPOT）
  • tranId: 交易ID（例如：1）
  • clientTranId: 唯一标识（例如：1）
  • startTime: （例如：1623319461670）
  • endTime: （例如：1641782889000）
  • current: 当前页码，默认1，最小值为1（例如：1）
  • size: 每页条数，默认10，最大值为100（例如：10）
  • asset:
  • clientId: 请求唯一ID（例如：1）
  • targetAsset:
  • thirdPartyClientId: （例如：1）
  • dustQuotaAssetToTargetAssetPrice: （例如：1.0）
  • targetAsset:
  • needBtcValuation: true 或 false
  • email:
  • type: 委托/取消委托
  • fromSymbol:
  • toSymbol:
  • quoteAsset: 
    USDT
    、
    ETH
    、
    USDC
    、
    BNB
    等，默认
    BTC
    （例如：BTC）
  • symbol:
  • needBtcValuation: 是否需要换算为BTC估值
  • amount: （例如：1.0）
  • coin:
  • network:
  • amount: （例如：1.0）
  • includeSource: 默认：
    false
    ，设置为
    true
    时返回
    sourceAddress
    字段
  • coin:
  • status: 0(0:邮件已发送, 2:待审核 3:已拒绝 4:处理中 6:已完成)
  • offset: 默认：0
  • txId: （例如：1）
  • depositId: 充值记录ID，优先使用该参数（例如：1）
  • subAccountId: 云用户子账户ID（例如：1）
  • subUserId: 主账户的子用户ID（例如：1）
  • withdrawOrderId: 客户端侧提现ID，若在POST 
    /sapi/v1/capital/withdraw/apply
    接口中传入了该参数，可在此处用于查询（例如：1）
  • idList: POST 
    /sapi/v1/capital/withdraw/apply
    接口返回的ID列表，用英文逗号
    ,
    分隔
  • address:
  • addressTag: 部分币种的二级地址标识，如XRP、XMR等
  • transactionFeeFlag: 进行内部转账时，
    true
    表示将手续费返还到目标账户；
    false
    表示将手续费返还到转出账户。默认
    false
  • name: 地址描述，地址簿上限为200条，名称中的空格需要编码为
    %20
  • walletType: 提现钱包类型，0-现货钱包，1-资金钱包。默认walletType为钱包->法币和现货/资金->充值页面下当前「选中的钱包」
  • subAccountId: 外部用户ID（例如：1）
  • depositId: 钱包充值ID（例如：1）
  • questionnaire: JSON格式的问卷答案
  • beneficiaryPii: JSON格式的收款人个人身份信息
  • address:
  • signature: 必须是最后一个参数
  • addressName: 地址描述，地址簿上限为200条，名称中的空格需要编码为
    %20
  • withdrawOrderId: 客户端定义的提现ID（即客户端内部提现ID）（例如：1）
  • originatorPii: JSON格式的付款人个人身份信息，参考下文StandardPii部分
  • depositId: 钱包交易ID列表，用英文逗号
    ,
    分隔（例如：1）
  • retrieveQuestionnaire: true：响应中返回
    questionnaire
    字段
  • trId: 旅行规则记录ID列表，用英文逗号
    ,
    分隔（例如：1）
  • tranId: 钱包交易ID列表，用英文逗号
    ,
    分隔（例如：1）
  • travelRuleStatus: 0:已完成,1:处理中,2:失败
  • pendingQuestionnaire: true：仅返回待填写充值问卷的记录。false/未传入：返回所有记录
  • tranId: 钱包交易ID（例如：1）

Authentication

身份认证

For endpoints that require authentication, you will need to provide Binance API credentials. Required credentials:
  • apiKey: Your Binance API key (for header)
  • secretKey: Your Binance API secret (for signing)
Base URLs:
需要身份认证的端点，你需要提供Binance API凭证。 所需凭证：
  • apiKey: 你的Binance API key（放在请求头中）
  • secretKey: 你的Binance API secret（用于签名）
基础URL：

Security

安全说明

Share Credentials

凭证分享

Users can provide Binance API credentials by sending a file where the content is in the following format:
bash
abc123...xyz
secret123...key
用户可以通过发送文件的方式提供Binance API凭证，文件内容格式如下：
bash
abc123...xyz
secret123...key

Never Disclose API Key and Secret

切勿泄露API Key和Secret

Never disclose the location of the API key and secret file.
Never send the API key and secret to any website other than Mainnet and Testnet.
切勿泄露API key和secret文件的存储位置。
除了主网和测试网之外，切勿将API key和secret发送给任何其他网站。

Never Display Full Secrets

切勿完整展示密钥

When showing credentials to users:
  • API Key: Show first 5 + last 4 characters: 
    su1Qc...8akf
  • Secret Key: Always mask, show only last 5: 
    ***...aws1
Example response when asked for credentials: Account: main API Key: su1Qc...8akf Secret: ***...aws1
向用户展示凭证时：
  • API Key: 仅展示前5位 + 最后4位：
    su1Qc...8akf
  • Secret Key: 始终脱敏，仅展示最后5位：
    ***...aws1
被询问凭证时的示例响应： 账户: main API Key: su1Qc...8akf Secret: ***...aws1

Listing Accounts

账户列表展示

When listing accounts, show names and environment only — never keys: Binance Accounts:
  • main (Mainnet)
  • futures-keys (Mainnet)
列出账户时，仅展示名称和环境，绝对不要展示密钥： Binance 账户列表:
  • main (主网)
  • futures-keys (主网)

Transactions in Mainnet

主网交易

When performing transactions in mainnet, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.
在主网执行交易操作时，必须先和用户确认，要求用户输入"CONFIRM"后再继续。

Binance Accounts

Binance 账户

main

main

  • API Key: your_mainnet_api_key
  • Secret: your_mainnet_secret
  • API Key: 你的主网API key
  • Secret: 你的主网secret

TOOLS.md Structure

TOOLS.md 结构

bash
undefined
bash
undefined

Binance Accounts

Binance 账户

main

main

  • API Key: abc123...xyz
  • Secret: secret123...key
  • Description: Primary trading account
  • API Key: abc123...xyz
  • Secret: secret123...key
  • 描述: 主交易账户

futures-keys

futures-keys

  • API Key: futures789...def
  • Secret: futuressecret...uvw
  • Description: Futures trading account
undefined
  • API Key: futures789...def
  • Secret: futuressecret...uvw
  • 描述: 合约交易账户
undefined

Agent Behavior

Agent 行为规范

  1. Credentials requested: Mask secrets (show last 5 chars only)
  2. Listing accounts: Show names and environment, never keys
  3. Account selection: Ask if ambiguous, default to main
  4. When doing a transaction in mainnet, confirm with user before by asking to write "CONFIRM" to proceed
  5. New credentials: Prompt for name, environment, signing mode
  1. 被请求查看凭证：脱敏展示密钥（仅展示最后5位）
  2. 列出账户：仅展示名称和环境，绝对不要展示密钥
  3. 账户选择：存在歧义时询问用户，默认使用main账户
  4. 在主网执行交易时，要求用户输入"CONFIRM"确认后再继续
  5. 新增凭证：提示用户输入账户名称、环境、签名模式

Adding New Accounts

新增账户

When user provides new credentials:
  • Ask for account name
  • Store in 
    TOOLS.md
    with masked display confirmation
用户提供新的凭证时：
  • 询问账户名称
  • 存储到
    TOOLS.md
    中，并返回脱敏后的确认信息

Signing Requests

请求签名

For trading endpoints that require a signature:
  1. Build query string with all parameters, including the timestamp (Unix ms).
  2. Percent-encode the parameters using UTF-8 according to RFC 3986.
  3. Sign query string with secretKey using HMAC SHA256, RSA, or Ed25519 (depending on the account configuration).
  4. Append signature to query string.
  5. Include 
    X-MBX-APIKEY
    header.
Otherwise, do not perform steps 3–5.
需要签名的交易接口：
  1. 构建包含所有参数的查询字符串，包含时间戳（Unix毫秒级）。
  2. 按照RFC 3986规范使用UTF-8对参数进行百分号编码。
  3. 使用secretKey对查询字符串进行签名，支持HMAC SHA256、RSA或Ed25519（取决于账户配置）。
  4. 将签名追加到查询字符串中。
  5. 添加
    X-MBX-APIKEY
    请求头。
不需要签名的接口无需执行3-5步。

User Agent Header

User-Agent 请求头

Include 
User-Agent
header with the following string: 
binance-wallet/1.0.0 (Skill)
See 
references/authentication.md
 for implementation details.
请求头中需包含
User-Agent
字段，值为：
binance-wallet/1.0.0 (Skill)
参考
references/authentication.md
了解实现细节。