Back to Details

simple-earn

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Binance Simple-earn Skill

Binance Simple-earn 技能

Simple-earn request on Binance using authenticated API endpoints. Requires API key and secret key for certain endpoints. Return the result in JSON format.
通过已认证的API端点调用Binance的Simple-earn服务。部分端点需提供API密钥和Secret Key，返回结果为JSON格式。

Quick Reference

快速参考

EndpointDescriptionRequiredOptionalAuthentication
/sapi/v1/bfusd/account
(GET)		Get BFUSD Account (USER_DATA)NonerecvWindowYes
/sapi/v1/bfusd/quota
(GET)		Get BFUSD Quota Details (USER_DATA)NonerecvWindowYes
/sapi/v1/bfusd/redeem
(POST)		Redeem BFUSD(TRADE)amount, typerecvWindowYes
/sapi/v1/bfusd/subscribe
(POST)		Subscribe BFUSD(TRADE)asset, amountrecvWindowYes
/sapi/v1/bfusd/history/rateHistory
(GET)		Get BFUSD Rate History (USER_DATA)NonestartTime, endTime, current, size, recvWindowYes
/sapi/v1/bfusd/history/redemptionHistory
(GET)		Get BFUSD Redemption History (USER_DATA)NonestartTime, endTime, current, size, recvWindowYes
/sapi/v1/bfusd/history/rewardsHistory
(GET)		Get BFUSD Rewards History (USER_DATA)NonestartTime, endTime, current, size, recvWindowYes
/sapi/v1/bfusd/history/subscriptionHistory
(GET)		Get BFUSD subscription history(USER_DATA)Noneasset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/flexible/personalLeftQuota
(GET)		Get Flexible Personal Left Quota(USER_DATA)productIdrecvWindowYes
/sapi/v1/simple-earn/flexible/position
(GET)		Get Flexible Product Position(USER_DATA)Noneasset, productId, current, size, recvWindowYes
/sapi/v1/simple-earn/locked/personalLeftQuota
(GET)		Get Locked Personal Left Quota(USER_DATA)projectIdrecvWindowYes
/sapi/v1/simple-earn/locked/position
(GET)		Get Locked Product PositionNoneasset, positionId, projectId, current, size, recvWindowYes
/sapi/v1/simple-earn/flexible/list
(GET)		Get Simple Earn Flexible Product List(USER_DATA)Noneasset, current, size, recvWindowYes
/sapi/v1/simple-earn/locked/list
(GET)		Get Simple Earn Locked Product List(USER_DATA)Noneasset, current, size, recvWindowYes
/sapi/v1/simple-earn/account
(GET)		Simple Account(USER_DATA)NonerecvWindowYes
/sapi/v1/simple-earn/flexible/subscriptionPreview
(GET)		Get Flexible Subscription Preview(USER_DATA)productId, amountrecvWindowYes
/sapi/v1/simple-earn/locked/subscriptionPreview
(GET)		Get Locked Subscription Preview(USER_DATA)projectId, amountautoSubscribe, recvWindowYes
/sapi/v1/simple-earn/flexible/redeem
(POST)		Redeem Flexible Product(TRADE)productIdredeemAll, amount, destAccount, recvWindowYes
/sapi/v1/simple-earn/locked/redeem
(POST)		Redeem Locked Product(TRADE)positionIdrecvWindowYes
/sapi/v1/simple-earn/flexible/setAutoSubscribe
(POST)		Set Flexible Auto Subscribe(USER_DATA)productId, autoSubscriberecvWindowYes
/sapi/v1/simple-earn/locked/setAutoSubscribe
(POST)		Set Locked Auto Subscribe(USER_DATA)positionId, autoSubscriberecvWindowYes
/sapi/v1/simple-earn/locked/setRedeemOption
(POST)		Set Locked Product Redeem Option(USER_DATA)positionId, redeemTorecvWindowYes
/sapi/v1/simple-earn/flexible/subscribe
(POST)		Subscribe Flexible Product(TRADE)productId, amountautoSubscribe, sourceAccount, recvWindowYes
/sapi/v1/simple-earn/locked/subscribe
(POST)		Subscribe Locked Product(TRADE)projectId, amountautoSubscribe, sourceAccount, redeemTo, recvWindowYes
/sapi/v1/simple-earn/flexible/history/collateralRecord
(GET)		Get Collateral Record(USER_DATA)NoneproductId, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/flexible/history/redemptionRecord
(GET)		Get Flexible Redemption Record(USER_DATA)NoneproductId, redeemId, asset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/flexible/history/rewardsRecord
(GET)		Get Flexible Rewards History(USER_DATA)typeproductId, asset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/flexible/history/subscriptionRecord
(GET)		Get Flexible Subscription Record(USER_DATA)NoneproductId, purchaseId, asset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/locked/history/redemptionRecord
(GET)		Get Locked Redemption Record(USER_DATA)NonepositionId, redeemId, asset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/locked/history/rewardsRecord
(GET)		Get Locked Rewards History(USER_DATA)NonepositionId, asset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/locked/history/subscriptionRecord
(GET)		Get Locked Subscription Record(USER_DATA)NonepurchaseId, asset, startTime, endTime, current, size, recvWindowYes
/sapi/v1/simple-earn/flexible/history/rateHistory
(GET)		Get Rate History(USER_DATA)productIdaprPeriod, startTime, endTime, current, size, recvWindowYes
/sapi/v1/rwusd/quota
(GET)		Get RWUSD Quota Details (USER_DATA)NonerecvWindowYes
/sapi/v1/rwusd/account
(GET)		Get RWUSD Account (USER_DATA)NonerecvWindowYes
/sapi/v1/rwusd/redeem
(POST)		Redeem RWUSD(TRADE)amount, typerecvWindowYes
/sapi/v1/rwusd/subscribe
(POST)		Subscribe RWUSD(TRADE)asset, amountrecvWindowYes
/sapi/v1/rwusd/history/rateHistory
(GET)		Get RWUSD Rate History (USER_DATA)NonestartTime, endTime, current, size, recvWindowYes
/sapi/v1/rwusd/history/redemptionHistory
(GET)		Get RWUSD Redemption History (USER_DATA)NonestartTime, endTime, current, size, recvWindowYes
/sapi/v1/rwusd/history/rewardsHistory
(GET)		Get RWUSD Rewards History (USER_DATA)NonestartTime, endTime, current, size, recvWindowYes
/sapi/v1/rwusd/history/subscriptionHistory
(GET)		Get RWUSD subscription history(USER_DATA)Noneasset, startTime, endTime, current, size, recvWindowYes
Endpoint描述必填参数可选参数认证要求
/sapi/v1/bfusd/account
(GET)		获取BFUSD账户（USER_DATA）无recvWindow是
/sapi/v1/bfusd/quota
(GET)		获取BFUSD额度详情（USER_DATA）无recvWindow是
/sapi/v1/bfusd/redeem
(POST)		赎回BFUSD（TRADE）amount, typerecvWindow是
/sapi/v1/bfusd/subscribe
(POST)		申购BFUSD（TRADE）asset, amountrecvWindow是
/sapi/v1/bfusd/history/rateHistory
(GET)		获取BFUSD利率历史（USER_DATA）无startTime, endTime, current, size, recvWindow是
/sapi/v1/bfusd/history/redemptionHistory
(GET)		获取BFUSD赎回历史（USER_DATA）无startTime, endTime, current, size, recvWindow是
/sapi/v1/bfusd/history/rewardsHistory
(GET)		获取BFUSD奖励历史（USER_DATA）无startTime, endTime, current, size, recvWindow是
/sapi/v1/bfusd/history/subscriptionHistory
(GET)		获取BFUSD申购历史（USER_DATA）无asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/flexible/personalLeftQuota
(GET)		获取活期产品剩余可申购额度（USER_DATA）productIdrecvWindow是
/sapi/v1/simple-earn/flexible/position
(GET)		获取活期产品持仓（USER_DATA）无asset, productId, current, size, recvWindow是
/sapi/v1/simple-earn/locked/personalLeftQuota
(GET)		获取定期产品剩余可申购额度（USER_DATA）projectIdrecvWindow是
/sapi/v1/simple-earn/locked/position
(GET)		获取定期产品持仓无asset, positionId, projectId, current, size, recvWindow是
/sapi/v1/simple-earn/flexible/list
(GET)		获取Simple Earn活期产品列表（USER_DATA）无asset, current, size, recvWindow是
/sapi/v1/simple-earn/locked/list
(GET)		获取Simple Earn定期产品列表（USER_DATA）无asset, current, size, recvWindow是
/sapi/v1/simple-earn/account
(GET)		Simple Earn账户信息（USER_DATA）无recvWindow是
/sapi/v1/simple-earn/flexible/subscriptionPreview
(GET)		获取活期产品申购预览（USER_DATA）productId, amountrecvWindow是
/sapi/v1/simple-earn/locked/subscriptionPreview
(GET)		获取定期产品申购预览（USER_DATA）projectId, amountautoSubscribe, recvWindow是
/sapi/v1/simple-earn/flexible/redeem
(POST)		赎回活期产品（TRADE）productIdredeemAll, amount, destAccount, recvWindow是
/sapi/v1/simple-earn/locked/redeem
(POST)		赎回定期产品（TRADE）positionIdrecvWindow是
/sapi/v1/simple-earn/flexible/setAutoSubscribe
(POST)		设置活期产品自动申购（USER_DATA）productId, autoSubscriberecvWindow是
/sapi/v1/simple-earn/locked/setAutoSubscribe
(POST)		设置定期产品自动申购（USER_DATA）positionId, autoSubscriberecvWindow是
/sapi/v1/simple-earn/locked/setRedeemOption
(POST)		设置定期产品赎回选项（USER_DATA）positionId, redeemTorecvWindow是
/sapi/v1/simple-earn/flexible/subscribe
(POST)		申购活期产品（TRADE）productId, amountautoSubscribe, sourceAccount, recvWindow是
/sapi/v1/simple-earn/locked/subscribe
(POST)		申购定期产品（TRADE）projectId, amountautoSubscribe, sourceAccount, redeemTo, recvWindow是
/sapi/v1/simple-earn/flexible/history/collateralRecord
(GET)		获取质押记录（USER_DATA）无productId, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/flexible/history/redemptionRecord
(GET)		获取活期产品赎回记录（USER_DATA）无productId, redeemId, asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/flexible/history/rewardsRecord
(GET)		获取活期产品奖励历史（USER_DATA）typeproductId, asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/flexible/history/subscriptionRecord
(GET)		获取活期产品申购记录（USER_DATA）无productId, purchaseId, asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/locked/history/redemptionRecord
(GET)		获取定期产品赎回记录（USER_DATA）无positionId, redeemId, asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/locked/history/rewardsRecord
(GET)		获取定期产品奖励历史（USER_DATA）无positionId, asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/locked/history/subscriptionRecord
(GET)		获取定期产品申购记录（USER_DATA）无purchaseId, asset, startTime, endTime, current, size, recvWindow是
/sapi/v1/simple-earn/flexible/history/rateHistory
(GET)		获取利率历史（USER_DATA）productIdaprPeriod, startTime, endTime, current, size, recvWindow是
/sapi/v1/rwusd/quota
(GET)		获取RWUSD额度详情（USER_DATA）无recvWindow是
/sapi/v1/rwusd/account
(GET)		获取RWUSD账户（USER_DATA）无recvWindow是
/sapi/v1/rwusd/redeem
(POST)		赎回RWUSD（TRADE）amount, typerecvWindow是
/sapi/v1/rwusd/subscribe
(POST)		申购RWUSD（TRADE）asset, amountrecvWindow是
/sapi/v1/rwusd/history/rateHistory
(GET)		获取RWUSD利率历史（USER_DATA）无startTime, endTime, current, size, recvWindow是
/sapi/v1/rwusd/history/redemptionHistory
(GET)		获取RWUSD赎回历史（USER_DATA）无startTime, endTime, current, size, recvWindow是
/sapi/v1/rwusd/history/rewardsHistory
(GET)		获取RWUSD奖励历史（USER_DATA）无startTime, endTime, current, size, recvWindow是
/sapi/v1/rwusd/history/subscriptionHistory
(GET)		获取RWUSD申购历史（USER_DATA）无asset, startTime, endTime, current, size, recvWindow是

Parameters

参数说明

Common Parameters

通用参数

  • recvWindow: The value cannot be greater than 60000 (ms) (e.g., 5000)
  • amount: Amount (e.g., 1.0)
  • type: FAST or STANDARD, defaults to STANDARD (e.g., s)
  • asset: USDT or USDC (whichever is eligible)
  • startTime: (e.g., 1623319461670)
  • endTime: (e.g., 1641782889000)
  • current: Currently querying page. Starts from 1. Default: 1 (e.g., 1)
  • size: Number of results per page. Default: 10, Max: 100 (e.g., 10)
  • asset: USDC or USDT
  • productId: (e.g., 1)
  • productId: (e.g., 1)
  • projectId: (e.g., 1)
  • positionId: (e.g., 1)
  • projectId: (e.g., 1)
  • autoSubscribe: true or false, default true. (e.g., true)
  • redeemAll: true or false, default to false
  • amount: if redeemAll is false, amount is mandatory (e.g., 1.0)
  • destAccount: 
    SPOT
    ,
    FUND
    , default 
    SPOT
    (e.g., SPOT)
  • positionId: (e.g., 1)
  • autoSubscribe: true or false
  • redeemTo: 
    SPOT
    ,'FLEXIBLE'
  • sourceAccount: 
    SPOT
    ,
    FUND
    ,
    ALL
    , default 
    SPOT
    (e.g., SPOT)
  • redeemTo: 
    SPOT
    ,
    FLEXIBLE
    , default 
    SPOT
    (e.g., SPOT)
  • redeemId: (e.g., 1)
  • purchaseId: (e.g., 1)
  • aprPeriod: "DAY","YEAR",default"DAY" (e.g., DAY)
  • recvWindow: 取值不能超过60000（毫秒），例如5000
  • amount: 金额，例如1.0
  • type: 可选FAST或STANDARD，默认STANDARD
  • asset: 可选USDT或USDC（以实际支持为准）
  • startTime: 起始时间戳，例如1623319461670
  • endTime: 结束时间戳，例如1641782889000
  • current: 当前查询页码，从1开始，默认1，例如1
  • size: 每页结果数量，默认10，最大100，例如10
  • asset: 可选USDC或USDT
  • productId: 产品ID，例如1
  • projectId: 项目ID，例如1
  • positionId: 持仓ID，例如1
  • autoSubscribe: 布尔值，可选true或false，默认true，例如true
  • redeemAll: 布尔值，可选true或false，默认false
  • amount: 当redeemAll为false时，该参数为必填，例如1.0
  • destAccount: 可选
    SPOT
    、
    FUND
    ，默认
    SPOT
    ，例如SPOT
  • redeemTo: 可选
    SPOT
    、
    FLEXIBLE
  • sourceAccount: 可选
    SPOT
    、
    FUND
    、
    ALL
    ，默认
    SPOT
    ，例如SPOT
  • redeemTo: 可选
    SPOT
    、
    FLEXIBLE
    ，默认
    SPOT
    ，例如SPOT
  • redeemId: 赎回ID，例如1
  • purchaseId: 申购ID，例如1
  • aprPeriod: 可选"DAY"、"YEAR"，默认"DAY"，例如DAY

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密钥（用于请求头）
  • secretKey: Binance API密钥（用于签名）
基础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密钥和Secret Key

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密钥和Secret Key文件的存储位置。
切勿将API密钥和Secret Key发送至主网和测试网以外的任何网站。

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: ***...aws

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: your_mainnet_api_key
  • Secret: your_mainnet_secret

TOOLS.md Structure

TOOLS.md文件结构

bash
undefined
bash
undefined

Binance Accounts

Binance Accounts

main

main

  • API Key: abc123...xyz
  • Secret: secret123...key
  • Description: Primary trading account
  • API Key: abc123...xyz
  • Secret: secret123...key
  • Description: Primary trading account

futures-keys

futures-keys

  • API Key: futures789...def
  • Secret: futuressecret...uvw
  • Description: Futures trading account
undefined
  • API Key: futures789...def
  • Secret: futuressecret...uvw
  • Description: Futures trading account
undefined

Agent Behavior

代理行为规范

  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-simple-earn/1.0.0 (Skill)
See 
references/authentication.md
 for implementation details.
请求头中需包含
User-Agent
，值为：
binance-simple-earn/1.0.0 (Skill)
实现细节请参考
references/authentication.md
。