📦 Binance Derivatives — 币安衍生品交易

技能文档

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

Quick Reference

Parameters

Common Parameters

recvWindow: (e.g., 5000) startTime: 时间戳 在...中 ms (e.g., 1623319461670) endTime: 时间戳 在...中 ms (e.g., 1641782889000) downloadId: 获取 由 下载 id api (e.g., 1) symbol: incomeType: "TRANSFER","WELCOME_BONUS", "FUNDING_FEE", "REALIZED_PNL", "COMMISSION", "INSURANCE_CLEAR", 和 "DELIVERED_SETTELMENT" startTime: (e.g., 1623319461670) endTime: (e.g., 1641782889000) page: limit: 默认 100; max 1000 (e.g., 100) pair: symbol: pair: BTCUSD fromId: ID 到 获取 aggregate trades 从 INCLUSIVE. (e.g., 1) asset: orderId: (e.g., 1) orderId: (e.g., 1) countdownTime: countdown 时间, 1000 对于 1 第二个. 0 到 取消 timer orderIdList: max length 10 e.g. [1234567,2345678] origClientOrderIdList: max length 10 e.g. ["my_id_1","my_id_2"], 编码 double quotes. 否 space 之后 comma. origClientOrderId: (e.g., 1) leverage: target initial leverage: int 从 1 到 125 dualSidePosition: "真": Hedge Mode; "假": One-way Mode 类型: 1: 添加 position margin,2: 归约 position margin amount: (e.g., 1.0) batchOrders: order 列表. Max 5 orders quantity: quantity measured 由 contract 数字, Cannot sent 带有 closePosition=真 (e.g., 1.0) price: (e.g., 1.0) reduceOnly: "真" 或 "假". 默认 "假". Cannot sent 在...中 Hedge Mode; cannot sent 带有 closePosition=真(关闭-所有) newClientOrderId: unique id 在...之中 打开 orders. Automatically generated 如果 不 sent. 可以 仅 字符串 following rule: ^[\.-Z\:/-z0-9_-]{1,36}$ (e.g., 1) stopPrice: Used 带有 停止/STOP_MARKET 或 TAKE_PROFIT/TAKE_PROFIT_MARKET orders. (e.g., 1.0) closePosition: 真, 假；关闭-所有,used 带有 STOP_MARKET 或 TAKE_PROFIT_MARKET. activationPrice: Used 带有 TRAILING_STOP_MARKET orders, 默认 作为 latest price(supporting 不同 workingType) (e.g., 1.0) callbackRate: Used 带有 TRAILING_STOP_MARKET orders, min 0.1, max 10 在哪里 1 对于 1% (e.g., 1.0) priceProtect: "真" 或 "假", 默认 "假". Used 带有 停止/STOP_MARKET 或 TAKE_PROFIT/TAKE_PROFIT_MARKET orders. batchOrders: order 列表. Max 5 orders marginAsset:

Enums

contractType: PERPETUAL | CURRENT_QUARTER | NEXT_QUARTER | CURRENT_QUARTER_DELIVERING | NEXT_QUARTER_DELIVERING | PERPETUAL_DELIVERING period: 5m | 15m | 30m | 1h | 2h | 4h | 6h | 12h | 1d 间隔: 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M marginType: ISOLATED | CROSSED positionSide: BOTH | LONG | SHORT 类型: LIMIT | MARKET | 停止 | STOP_MARKET | TAKE_PROFIT | TAKE_PROFIT_MARKET | TRAILING_STOP_MARKET side: BUY | SELL priceMatch: 无 | OPPONENT | OPPONENT_5 | OPPONENT_10 | OPPONENT_20 | 队列 | QUEUE_5 | QUEUE_10 | QUEUE_20 timeInForce: GTC | IOC | FOK | GTX workingType: MARK_PRICE | CONTRACT_PRICE newOrderRespType: ACK | 结果 selfTradePreventionMode: 无 | EXPIRE_TAKER | EXPIRE_BOTH | EXPIRE_MAKER autoCloseType: LIQUIDATION | ADL

Authentication

For endpoints that require authentication, you will need to provide Binance API credentials. Required credentials:

apiKey: Binance API 键 (对于 页头) secretKey: Binance API secret (对于 signing)

Base URLs: Mainnet: https://dapi.binance.com Testnet: https://testnet.binancefuture.com

Security

分享 Credentials

Users can provide Binance API credentials by sending a file where the content is in the following format:

abc123...xyz
secret123...key

Never Disclose API 键 和 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.

Never Display 满 Secrets

When showing credentials to users:

• API 键: Show 第一个 5 + 最后的 4 characters: su1Qc...8akf
• Secret 键: Always mask, show 仅 最后的 5: ...aws1

Example response when asked for credentials: Account: main API Key: su1Qc...8akf Secret: ...aws1 Environment: Mainnet

Listing Accounts

When listing accounts, show names and environment only — never keys: Binance Accounts: main (Mainnet/Testnet) testnet-dev (Testnet) futures-keys (Mainnet)

Transactions 在...中 Mainnet

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

Binance Accounts

main

## 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

Ask 对于 账户 name Ask: Mainnet, Testnet Store 在...中 TOOLS.md 带有 masked display confirmation

Signing Requests

For trading endpoints that require a signature:

• Build 查询 字符串 带有 所有 parameters, 包括 时间戳 (Unix ms).
• Percent-编码 parameters 使用 UTF-8 according 到 RFC 3986.
• 签名 查询 字符串 带有 secretKey 使用 HMAC SHA256, RSA, 或 Ed25519 (depending 在...上 账户 configuration).
• Append signature 到 查询 字符串.
• Include X-MBX-APIKEY 页头.

Otherwise, do not perform steps 3–5.

新的 Client Order ID

For endpoints that include the newClientOrderId parameter, the value must always start with agent-. If the parameter is not provided, agent- followed by 18 random alphanumeric characters will be generated automatically. If a value is provided, it will be prefixed with agent-

Example: agent-1a2b3c4d5e6f7g8h9i

用户 Agent 页头

Include User-Agent header with the following string: binance-derivatives-trading-coin-futures/1.0.0 (Skill)

See references/authentication.md for implementation details.