derivatives-trading-options

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Binance Derivatives-trading-options Skill

Binance衍生品交易选项Skill

Derivatives-trading-options request on Binance using authenticated API endpoints. Requires API key and secret key for certain endpoints. Return the result in JSON format.

使用已认证的API端点在Binance上发起衍生品交易选项请求。部分端点需提供API密钥与Secret Key，返回结果为JSON格式。

Quick Reference

快速参考

Endpoint	Description	Required	Optional	Authentication
`/eapi/v1/bill` (GET)	Account Funding Flow (USER_DATA)	currency	recordId, startTime, endTime, limit, recvWindow	Yes
`/eapi/v1/marginAccount` (GET)	Option Margin Account Information (USER_DATA)	None	recvWindow	Yes
`/eapi/v1/block/order/execute` (POST)	Accept Block Trade Order (TRADE)	blockOrderMatchingKey	recvWindow	Yes
`/eapi/v1/block/order/execute` (GET)	Query Block Trade Details (USER_DATA)	blockOrderMatchingKey	recvWindow	Yes
`/eapi/v1/block/user-trades` (GET)	Account Block Trade List (USER_DATA)	None	endTime, startTime, underlying, recvWindow	Yes
`/eapi/v1/block/order/create` (DELETE)	Cancel Block Trade Order (TRADE)	blockOrderMatchingKey	recvWindow	Yes
`/eapi/v1/block/order/create` (PUT)	Extend Block Trade Order (TRADE)	blockOrderMatchingKey	recvWindow	Yes
`/eapi/v1/block/order/create` (POST)	New Block Trade Order (TRADE)	liquidity, legs	recvWindow	Yes
`/eapi/v1/block/order/orders` (GET)	Query Block Trade Order (TRADE)	None	blockOrderMatchingKey, endTime, startTime, underlying, recvWindow	Yes
`/eapi/v1/ticker` (GET)	24hr Ticker Price Change Statistics	None	symbol	No
`/eapi/v1/time` (GET)	Check Server Time	None	None	No
`/eapi/v1/exchangeInfo` (GET)	Exchange Information	None	None	No
`/eapi/v1/exerciseHistory` (GET)	Historical Exercise Records	None	underlying, startTime, endTime, limit	No
`/eapi/v1/klines` (GET)	Kline/Candlestick Data	symbol, interval	startTime, endTime, limit	No
`/eapi/v1/openInterest` (GET)	Open Interest	underlyingAsset, expiration	None	No
`/eapi/v1/mark` (GET)	Option Mark Price	None	symbol	No
`/eapi/v1/depth` (GET)	Order Book	symbol	limit	No
`/eapi/v1/blockTrades` (GET)	Recent Block Trades List	None	symbol, limit	No
`/eapi/v1/trades` (GET)	Recent Trades List	symbol	limit	No
`/eapi/v1/index` (GET)	Index Price	underlying	None	No
`/eapi/v1/ping` (GET)	Test Connectivity	None	None	No
`/eapi/v1/countdownCancelAllHeartBeat` (POST)	Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE)	underlyings	recvWindow	Yes
`/eapi/v1/countdownCancelAll` (GET)	Get Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)	None	underlying, recvWindow	Yes
`/eapi/v1/countdownCancelAll` (POST)	Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)	underlying, countdownTime	recvWindow	Yes
`/eapi/v1/mmp` (GET)	Get Market Maker Protection Config (TRADE)	None	underlying, recvWindow	Yes
`/eapi/v1/mmpReset` (POST)	Reset Market Maker Protection Config (TRADE)	None	underlying, recvWindow	Yes
`/eapi/v1/mmpSet` (POST)	Set Market Maker Protection Config (TRADE)	None	underlying, windowTimeInMilliseconds, frozenTimeInMilliseconds, qtyLimit, deltaLimit, recvWindow	Yes
`/eapi/v1/userTrades` (GET)	Account Trade List (USER_DATA)	None	symbol, fromId, startTime, endTime, limit, recvWindow	Yes
`/eapi/v1/allOpenOrdersByUnderlying` (DELETE)	Cancel All Option Orders By Underlying (TRADE)	underlying	recvWindow	Yes
`/eapi/v1/batchOrders` (DELETE)	Cancel Multiple Option Orders (TRADE)	symbol	orderIds, clientOrderIds, recvWindow	Yes
`/eapi/v1/batchOrders` (POST)	Place Multiple Orders(TRADE)	orders	recvWindow	Yes
`/eapi/v1/order` (DELETE)	Cancel Option Order (TRADE)	symbol	orderId, clientOrderId, recvWindow	Yes
`/eapi/v1/order` (POST)	New Order (TRADE)	symbol, side, type, quantity	price, timeInForce, reduceOnly, postOnly, newOrderRespType, clientOrderId, isMmp, recvWindow	Yes
`/eapi/v1/order` (GET)	Query Single Order (TRADE)	symbol	orderId, clientOrderId, recvWindow	Yes
`/eapi/v1/allOpenOrders` (DELETE)	Cancel all Option orders on specific symbol (TRADE)	symbol	recvWindow	Yes
`/eapi/v1/position` (GET)	Option Position Information (USER_DATA)	None	symbol, recvWindow	Yes
`/eapi/v1/openOrders` (GET)	Query Current Open Option Orders (USER_DATA)	None	symbol, orderId, startTime, endTime, recvWindow	Yes
`/eapi/v1/historyOrders` (GET)	Query Option Order History (TRADE)	symbol	orderId, startTime, endTime, limit, recvWindow	Yes
`/eapi/v1/commission` (GET)	User Commission (USER_DATA)	None	recvWindow	Yes
`/eapi/v1/exerciseRecord` (GET)	User Exercise Record (USER_DATA)	None	symbol, startTime, endTime, limit, recvWindow	Yes
`/eapi/v1/listenKey` (DELETE)	Close User Data Stream (USER_STREAM)	None	None	No
`/eapi/v1/listenKey` (PUT)	Keepalive User Data Stream (USER_STREAM)	None	None	No
`/eapi/v1/listenKey` (POST)	Start User Data Stream (USER_STREAM)	None	None	No

端点	描述	必填参数	可选参数	认证要求
`/eapi/v1/bill` (GET)	账户资金流水（USER_DATA）	currency	recordId, startTime, endTime, limit, recvWindow	是
`/eapi/v1/marginAccount` (GET)	期权保证金账户信息（USER_DATA）	无	recvWindow	是
`/eapi/v1/block/order/execute` (POST)	接受大宗交易订单（TRADE）	blockOrderMatchingKey	recvWindow	是
`/eapi/v1/block/order/execute` (GET)	查询大宗交易详情（USER_DATA）	blockOrderMatchingKey	recvWindow	是
`/eapi/v1/block/user-trades` (GET)	账户大宗交易列表（USER_DATA）	无	endTime, startTime, underlying, recvWindow	是
`/eapi/v1/block/order/create` (DELETE)	取消大宗交易订单（TRADE）	blockOrderMatchingKey	recvWindow	是
`/eapi/v1/block/order/create` (PUT)	延长大宗交易订单有效期（TRADE）	blockOrderMatchingKey	recvWindow	是
`/eapi/v1/block/order/create` (POST)	新建大宗交易订单（TRADE）	liquidity, legs	recvWindow	是
`/eapi/v1/block/order/orders` (GET)	查询大宗交易订单（TRADE）	无	blockOrderMatchingKey, endTime, startTime, underlying, recvWindow	是
`/eapi/v1/ticker` (GET)	24小时价格变动统计	无	symbol	否
`/eapi/v1/time` (GET)	检查服务器时间	无	无	否
`/eapi/v1/exchangeInfo` (GET)	交易所信息	无	无	否
`/eapi/v1/exerciseHistory` (GET)	历史行权记录	无	underlying, startTime, endTime, limit	否
`/eapi/v1/klines` (GET)	K线/蜡烛图数据	symbol, interval	startTime, endTime, limit	否
`/eapi/v1/openInterest` (GET)	未平仓合约量	underlyingAsset, expiration	无	否
`/eapi/v1/mark` (GET)	期权标记价格	无	symbol	否
`/eapi/v1/depth` (GET)	订单簿	symbol	limit	否
`/eapi/v1/blockTrades` (GET)	近期大宗交易列表	无	symbol, limit	否
`/eapi/v1/trades` (GET)	近期交易列表	symbol	limit	否
`/eapi/v1/index` (GET)	指数价格	underlying	无	否
`/eapi/v1/ping` (GET)	测试连通性	无	无	否
`/eapi/v1/countdownCancelAllHeartBeat` (POST)	自动取消所有挂单（止损开关）心跳包（TRADE）	underlyings	recvWindow	是
`/eapi/v1/countdownCancelAll` (GET)	获取自动取消所有挂单（止损开关）配置（TRADE）	无	underlying, recvWindow	是
`/eapi/v1/countdownCancelAll` (POST)	设置自动取消所有挂单（止损开关）配置（TRADE）	underlying, countdownTime	recvWindow	是
`/eapi/v1/mmp` (GET)	获取做市商保护配置（TRADE）	无	underlying, recvWindow	是
`/eapi/v1/mmpReset` (POST)	重置做市商保护配置（TRADE）	无	underlying, recvWindow	是
`/eapi/v1/mmpSet` (POST)	设置做市商保护配置（TRADE）	无	underlying, windowTimeInMilliseconds, frozenTimeInMilliseconds, qtyLimit, deltaLimit, recvWindow	是
`/eapi/v1/userTrades` (GET)	账户交易列表（USER_DATA）	无	symbol, fromId, startTime, endTime, limit, recvWindow	是
`/eapi/v1/allOpenOrdersByUnderlying` (DELETE)	根据标的取消所有期权订单（TRADE）	underlying	recvWindow	是
`/eapi/v1/batchOrders` (DELETE)	批量取消期权订单（TRADE）	symbol	orderIds, clientOrderIds, recvWindow	是
`/eapi/v1/batchOrders` (POST)	批量下单（TRADE）	orders	recvWindow	是
`/eapi/v1/order` (DELETE)	取消期权订单（TRADE）	symbol	orderId, clientOrderId, recvWindow	是
`/eapi/v1/order` (POST)	新建订单（TRADE）	symbol, side, type, quantity	price, timeInForce, reduceOnly, postOnly, newOrderRespType, clientOrderId, isMmp, recvWindow	是
`/eapi/v1/order` (GET)	查询单个订单（TRADE）	symbol	orderId, clientOrderId, recvWindow	是
`/eapi/v1/allOpenOrders` (DELETE)	取消指定标的的所有期权挂单（TRADE）	symbol	recvWindow	是
`/eapi/v1/position` (GET)	期权持仓信息（USER_DATA）	无	symbol, recvWindow	是
`/eapi/v1/openOrders` (GET)	查询当前期权挂单（USER_DATA）	无	symbol, orderId, startTime, endTime, recvWindow	是
`/eapi/v1/historyOrders` (GET)	查询期权订单历史（TRADE）	symbol	orderId, startTime, endTime, limit, recvWindow	是
`/eapi/v1/commission` (GET)	用户手续费（USER_DATA）	无	recvWindow	是
`/eapi/v1/exerciseRecord` (GET)	用户行权记录（USER_DATA）	无	symbol, startTime, endTime, limit, recvWindow	是
`/eapi/v1/listenKey` (DELETE)	关闭用户数据流（USER_STREAM）	无	无	否
`/eapi/v1/listenKey` (PUT)	保持用户数据流活跃（USER_STREAM）	无	无	否
`/eapi/v1/listenKey` (POST)	启动用户数据流（USER_STREAM）	无	无	否

Parameters

参数

Common Parameters

通用参数

currency: Asset type, only support USDT as of now
recordId: Return the recordId and subsequent data, the latest data is returned by default, e.g 100000 (e.g., 1)
startTime: Start Time, e.g 1593511200000 (e.g., 1623319461670)
endTime: End Time, e.g 1593512200000 (e.g., 1641782889000)
limit: Number of result sets returned Default:100 Max:1000 (e.g., 100)
recvWindow: (e.g., 5000)
blockOrderMatchingKey:
underlying: underlying, e.g BTCUSDT
liquidity: Taker or Maker
legs: Max 1 (only single leg supported), list of legs parameters in JSON; example: eapi/v1/block/order/create?orders=[{"symbol":"BTC-210115-35000-C", "price":"100","quantity":"0.0002","side":"BUY","type":"LIMIT"}]
blockOrderMatchingKey: If specified, returns the specific block trade associated with the blockOrderMatchingKey
symbol: Option trading pair, e.g BTC-200730-9000-C
symbol: Option trading pair, e.g BTC-200730-9000-C
interval: Time interval
underlyingAsset: underlying asset, e.g ETH/BTC
expiration: expiration date, e.g 221225
underlying: Option underlying, e.g BTCUSDT
underlyings: Option Underlying Symbols, e.g BTCUSDT,ETHUSDT
countdownTime: Countdown time in milliseconds (ex. 1,000 for 1 second). 0 to disable the timer. Negative values (ex. -10000) are not accepted. Minimum acceptable value is 5,000
windowTimeInMilliseconds: MMP Interval in milliseconds; Range (0,5000]
frozenTimeInMilliseconds: MMP frozen time in milliseconds, if set to 0 manual reset is required
qtyLimit: quantity limit (e.g., 1.0)
deltaLimit: net delta limit (e.g., 1.0)
fromId: Trade id to fetch from. Default gets most recent trades, e.g 4611875134427365376 (e.g., 1)
orderIds: Order ID, e.g [4611875134427365377,4611875134427365378]
clientOrderIds: User-defined order ID, e.g ["my_id_1","my_id_2"]
orderId: Order ID, e.g 4611875134427365377 (e.g., 1)
clientOrderId: User-defined order ID, e.g 10000 (e.g., 1)
quantity: Order Quantity (e.g., 1.0)
price: Order Price (e.g., 1.0)
reduceOnly: Reduce Only（Default false） (e.g., false）)
postOnly: Post Only（Default false） (e.g., false）)
isMmp: is market maker protection order, true/false
orders: order list. Max 10 orders

currency: 资产类型，目前仅支持USDT
recordId: 返回该recordId及之后的数据，默认返回最新数据，例如 100000（示例：1）
startTime: 开始时间，例如 1593511200000（示例：1623319461670）
endTime: 结束时间，例如 1593512200000（示例：1641782889000）
limit: 返回结果集数量，默认100，最大值1000（示例：100）
recvWindow: （示例：5000）
blockOrderMatchingKey:
underlying: 标的资产，例如 BTCUSDT
liquidity: Taker或Maker
legs: 最多1个（仅支持单腿），JSON格式的legs参数列表；示例：eapi/v1/block/order/create?orders=[{"symbol":"BTC-210115-35000-C", "price":"100","quantity":"0.0002","side":"BUY","type":"LIMIT"}]
blockOrderMatchingKey: 若指定，返回与该blockOrderMatchingKey关联的特定大宗交易
symbol: 期权交易对，例如 BTC-200730-9000-C
symbol: 期权交易对，例如 BTC-200730-9000-C
interval: 时间间隔
underlyingAsset: 标的资产，例如 ETH/BTC
expiration: 到期日期，例如 221225
underlying: 期权标的，例如 BTCUSDT
underlyings: 期权标的符号，例如 BTCUSDT,ETHUSDT
countdownTime: 倒计时时间（毫秒），例如1000代表1秒。设置为0则禁用计时器，不接受负值（如-10000），最小值为5000
windowTimeInMilliseconds: MMP间隔（毫秒），范围(0,5000]
frozenTimeInMilliseconds: MMP冻结时间（毫秒），设置为0则需手动重置
qtyLimit: 数量限制（示例：1.0）
deltaLimit: 净Delta限制（示例：1.0）
fromId: 起始交易ID，默认获取最新交易，例如 4611875134427365376（示例：1）
orderIds: 订单ID列表，例如 [4611875134427365377,4611875134427365378]
clientOrderIds: 用户自定义订单ID列表，例如 ["my_id_1","my_id_2"]
orderId: 订单ID，例如 4611875134427365377（示例：1）
clientOrderId: 用户自定义订单ID，例如10000（示例：1）
quantity: 订单数量（示例：1.0）
price: 订单价格（示例：1.0）
reduceOnly: 仅减仓（默认false）（示例：false）
postOnly: 仅挂单（默认false）（示例：false）
isMmp: 是否为做市商保护订单，true/false
orders: 订单列表，最多10个订单

Enums

枚举值

side: BUY | SELL
type: LIMIT
timeInForce: GTC | IOC | FOK | GTX
newOrderRespType: ACK | RESULT

side: BUY（买入）| SELL（卖出）
type: LIMIT（限价单）
timeInForce: GTC（取消前有效）| IOC（立即成交剩余撤销）| FOK（全部成交否则撤销）| GTX（仅挂单成交）
newOrderRespType: ACK（确认）| RESULT（结果）

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:

Mainnet: https://eapi.binance.com
Testnet: https://testnet.binancefuture.com

对于需要认证的端点，您需要提供Binance API凭证。所需凭证：

apiKey: 您的Binance API密钥（用于请求头）
secretKey: 您的Binance API密钥（用于签名）

基础URL：

Mainnet: https://eapi.binance.com
Testnet: https://testnet.binancefuture.com

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发送至Mainnet和Testnet以外的任何网站。

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 Environment: Mainnet

向用户展示凭证时：

API Key: 显示前5位+后4位：
```
su1Qc...8akf
```
Secret Key: 始终掩码，仅显示最后5位：
```
***...aws1
```

询问凭证时的示例回复：账户：main API Key: su1Qc...8akf Secret: ***...aws1 环境：Mainnet

Listing Accounts

列出账户

When listing accounts, show names and environment only — never keys: Binance Accounts:

main (Mainnet/Testnet)
testnet-dev (Testnet)
futures-keys (Mainnet)

列出账户时，仅显示名称和环境，绝不显示密钥： Binance账户：

main（Mainnet/Testnet）
testnet-dev（Testnet）
futures-keys（Mainnet）

Transactions in Mainnet

Mainnet交易

When performing transactions in mainnet, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.

在Mainnet执行交易时，必须先请求用户确认，要求用户输入"CONFIRM"方可继续。

Binance Accounts

Binance账户

main

API Key: your_mainnet_api_key
Secret: your_mainnet_secret
Testnet: false

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

API Key: your_testnet_api_key
Secret: your_testnet_secret
Testnet: true

TOOLS.md Structure

TOOLS.md结构

bash

undefined

bash

undefined

Binance Accounts

main

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

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

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

undefined

API Key: futures789...def
Secret: futuressecret...uvw
Testnet: false
Description: Futures trading account

undefined

Agent Behavior

Agent行为

Credentials requested: Mask secrets (show last 5 chars only)
Listing accounts: Show names and environment, never keys
Account selection: Ask if ambiguous, default to main
When doing a transaction in mainnet, confirm with user before by asking to write "CONFIRM" to proceed
New credentials: Prompt for name, environment, signing mode

请求凭证时：掩码密钥（仅显示最后5位）
列出账户时：仅显示名称和环境，绝不显示密钥
账户选择：若存在歧义则询问用户，默认选择main账户
在Mainnet执行交易前，必须要求用户输入"CONFIRM"确认后方可继续
添加新凭证时：提示用户输入账户名称、环境、签名模式

Adding New Accounts

添加新账户

When user provides new credentials:

Ask for account name
Ask: Mainnet, Testnet
Store in
```
TOOLS.md
```
with masked display confirmation

当用户提供新凭证时：

询问账户名称
询问：Mainnet还是Testnet
存储至
```
TOOLS.md
```
并显示掩码后的凭证供用户确认

Signing Requests

请求签名

For trading endpoints that require a signature:

Build query string with all parameters, including the timestamp (Unix ms).
Percent-encode the parameters using UTF-8 according to RFC 3986.
Sign query string with secretKey using HMAC SHA256, RSA, or Ed25519 (depending on the account configuration).
Append signature to query string.
Include
```
X-MBX-APIKEY
```
header.

Otherwise, do not perform steps 3–5.

对于需要签名的交易端点：

构建包含所有参数的查询字符串，包括时间戳（毫秒级Unix时间）。
根据RFC 3986标准使用UTF-8对参数进行百分号编码。
使用secretKey通过HMAC SHA256、RSA或Ed25519（取决于账户配置）对查询字符串进行签名。
将签名追加至查询字符串。
在请求头中包含
```
X-MBX-APIKEY
```
。

若无需签名，则跳过步骤3-5。

User Agent Header

User Agent请求头

Include

User-Agent

header with the following string:

binance-derivatives-trading-options/1.0.0 (Skill)

See

references/authentication.md

for implementation details.

请求头中需包含

User-Agent

字段，值为：

binance-derivatives-trading-options/1.0.0 (Skill)

详见

references/authentication.md

中的实现细节。