Binance 现货交易 API 使用指南 - 交易所信息、订单管理、市场数据接口

spot by binance/binance-skills-hub

1,800 周安装量

516 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/binance/binance-skills-hub --skill spot

开发区块链

🇨🇳中文介绍

Binance 现货技能

使用经过身份验证的 API 端点对 Binance 进行现货请求。某些端点需要 API 密钥和密钥。以 JSON 格式返回结果。

快速参考

端点	描述	必填	可选	身份验证
`/api/v3/exchangeInfo` (GET)	交易所信息	无	symbol, symbols, permissions, showPermissionSets, symbolStatus	否
`/api/v3/ping` (GET)	测试连接性	无	无	否
`/api/v3/time` (GET)	检查服务器时间	无

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

685,800 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

240,900 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

193,000 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

125,300 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

symbol : 要查询的交易对（例如，BNBUSDT）
symbols : 要查询的交易对列表
permissions : 要查询的权限列表
showPermissionSets : 控制是否填充 permissionSets 字段的内容。默认为 true（例如，true）
symbol : （例如，BNBUSDT）
fromId : 获取聚合交易的起始 ID（包含）。（例如，1）
startTime : 获取聚合交易的起始时间戳（毫秒，包含）。（例如，1735693200000）
endTime : 获取聚合交易的结束时间戳（毫秒，包含）。（例如，1735693200000）
limit : 默认值：500；最大值：1000。（例如，500）
timeZone : 默认值：0 (UTC)
recvWindow : 该值不能大于 60000。支持最多三位小数的精度（例如，6000.346），以便可以指定微秒。（例如，5000）
timestamp : （例如，1）
quantity : （例如，1）
quoteOrderQty : （例如，1）
price : （例如，400）
newClientOrderId : 未成交订单中的唯一 ID。如果未发送则自动生成。只有当上一个订单成交后，具有相同 newClientOrderID 的订单才能被接受，否则订单将被拒绝。
strategyId : （例如，1）
strategyType : 该值不能小于 1000000。（例如，1）
stopPrice : 与 STOP_LOSS、STOP_LOSS_LIMIT、TAKE_PROFIT 和 TAKE_PROFIT_LIMIT 订单一起使用。（例如，1）
trailingDelta : 参见追踪止损订单常见问题。（例如，1）
icebergQty : 与 LIMIT、STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 一起使用以创建冰山订单。（例如，1）
pegOffsetValue : 钉住价格的价格水平（最大值：100）。参见钉住订单信息（例如，1）
orderId : （例如，1）
origClientOrderId :
newQty : newQty 必须大于 0 且小于订单数量。（例如，1）
cancelNewClientOrderId : 用于唯一标识此取消操作。默认自动生成。
cancelOrigClientOrderId : 必须发送 cancelOrderId 或 cancelOrigClientOrderId 中的一个。如果同时提供了 cancelOrderId 和 cancelOrigClientOrderId 参数，则首先搜索 cancelOrderId，然后检查该结果中的 cancelOrigClientOrderId 是否与该订单匹配。如果两个条件都不满足，请求将被拒绝。
cancelOrderId : 必须发送 cancelOrderId 或 cancelOrigClientOrderId 中的一个。如果同时提供了 cancelOrderId 和 cancelOrigClientOrderId 参数，则首先搜索 cancelOrderId，然后检查该结果中的 cancelOrigClientOrderId 是否与该订单匹配。如果两个条件都不满足，请求将被拒绝。（例如，1）
listClientOrderId : 整个订单列表的唯一 ID
quantity : （例如，1）
limitClientOrderId : 限价订单的唯一 ID
price : （例如，1）
limitStrategyId : （例如，1）
limitStrategyType : 该值不能小于 1000000。（例如，1）
limitIcebergQty : 用于使 LIMIT_MAKER 订单成为冰山订单。（例如，1）
stopClientOrderId : 止损/止损限价订单的唯一 ID
stopPrice : （例如，1）
stopStrategyId : （例如，1）
stopStrategyType : 该值不能小于 1000000。（例如，1）
stopLimitPrice : 如果提供，则需要 stopLimitTimeInForce。（例如，1）
stopIcebergQty : 与 STOP_LOSS_LIMIT 订单一起使用以创建冰山订单。（例如，1）
computeCommissionRates : 默认值：false 参见佣金常见问题以了解更多信息。
orderListId : 必须提供 orderListId 或 listClientOrderId 中的一个（例如，1）
aboveClientOrderId : 上方订单在未成交订单中的任意唯一 ID。如果未发送则自动生成
aboveIcebergQty : 请注意，这只能在 aboveTimeInForce 为 GTC 时使用。（例如，1）
abovePrice : 如果 aboveType 是 STOP_LOSS_LIMIT、LIMIT_MAKER 或 TAKE_PROFIT_LIMIT，可用于指定限价。（例如，1）
aboveStopPrice : 如果 aboveType 是 STOP_LOSS、STOP_LOSS_LIMIT、TAKE_PROFIT、TAKE_PROFIT_LIMIT，可以使用。必须指定 aboveStopPrice 或 aboveTrailingDelta 或两者。（例如，1）
aboveTrailingDelta : 参见追踪止损订单常见问题。（例如，1）
aboveStrategyId : 标识订单策略中上方订单的任意数值。（例如，1）
aboveStrategyType : 标识上方订单策略的任意数值。小于 1000000 的值被保留，不能使用。（例如，1）
abovePegOffsetValue : （例如，1）
belowClientOrderId : 下方订单在未成交订单中的任意唯一 ID。如果未发送则自动生成
belowIcebergQty : 请注意，这只能在 belowTimeInForce 为 GTC 时使用。（例如，1）
belowPrice : 如果 belowType 是 STOP_LOSS_LIMIT、LIMIT_MAKER 或 TAKE_PROFIT_LIMIT，可用于指定限价。（例如，1）
belowStopPrice : 如果 belowType 是 STOP_LOSS、STOP_LOSS_LIMIT, TAKE_PROFIT 或 TAKE_PROFIT_LIMIT 可以使用。必须指定 belowStopPrice 或 belowTrailingDelta 或两者。（例如，1）
belowTrailingDelta : 参见追踪止损订单常见问题。（例如，1）
belowStrategyId : 标识订单策略中下方订单的任意数值。（例如，1）
belowStrategyType : 标识下方订单策略的任意数值。小于 1000000 的值被保留，不能使用。（例如，1）
belowPegOffsetValue : （例如，1）
workingClientOrderId : 工作订单在未成交订单中的任意唯一 ID。如果未发送则自动生成。
workingPrice : （例如，1）
workingQuantity : 设置工作订单的数量。（例如，1）
workingIcebergQty : 这只能在 workingTimeInForce 为 GTC，或者 workingType 为 LIMIT_MAKER 时使用。（例如，1）
workingStrategyId : 标识订单策略中工作订单的任意数值。（例如，1）
workingStrategyType : 标识工作订单策略的任意数值。小于 1000000 的值被保留，不能使用。（例如，1）
workingPegOffsetValue : （例如，1）
pendingClientOrderId : 挂单在未成交订单中的任意唯一 ID。如果未发送则自动生成。
pendingPrice : （例如，1）
pendingStopPrice : （例如，1）
pendingTrailingDelta : （例如，1）
pendingIcebergQty : 这只能在 pendingTimeInForce 为 GTC 或者 pendingType 为 LIMIT_MAKER 时使用。（例如，1）
pendingStrategyId : 标识订单策略中挂单的任意数值。（例如，1）
pendingStrategyType : 标识挂单策略的任意数值。小于 1000000 的值被保留，不能使用。（例如，1）
pendingPegOffsetValue : （例如，1）
pendingAboveClientOrderId : 上方挂单在未成交订单中的任意唯一 ID。如果未发送则自动生成。
pendingAbovePrice : 如果 pendingAboveType 是 STOP_LOSS_LIMIT、LIMIT_MAKER 或 TAKE_PROFIT_LIMIT，可用于指定限价。（例如，1）
pendingAboveStopPrice : 如果 pendingAboveType 是 STOP_LOSS、STOP_LOSS_LIMIT、TAKE_PROFIT、TAKE_PROFIT_LIMIT 可以使用（例如，1）
pendingAboveTrailingDelta : 参见追踪止损常见问题（例如，1）
pendingAboveIcebergQty : 这只能在 pendingAboveTimeInForce 为 GTC 或者 pendingAboveType 为 LIMIT_MAKER 时使用。（例如，1）
pendingAboveStrategyId : 标识订单策略中上方挂单的任意数值。（例如，1）
pendingAboveStrategyType : 标识上方挂单策略的任意数值。小于 1000000 的值被保留，不能使用。（例如，1）
pendingAbovePegOffsetValue : （例如，1）
pendingBelowClientOrderId : 下方挂单在未成交订单中的任意唯一 ID。如果未发送则自动生成。
pendingBelowPrice : 如果 pendingBelowType 是 STOP_LOSS_LIMIT 或 TAKE_PROFIT_LIMIT，可用于指定限价（例如，1）
pendingBelowStopPrice : 如果 pendingBelowType 是 STOP_LOSS、STOP_LOSS_LIMIT, TAKE_PROFIT 或 TAKE_PROFIT_LIMIT 可以使用。必须指定 pendingBelowStopPrice 或 pendingBelowTrailingDelta 或两者。（例如，1）
pendingBelowTrailingDelta : （例如，1）
pendingBelowIcebergQty : 这只能在 pendingBelowTimeInForce 为 GTC，或者 pendingBelowType 为 LIMIT_MAKER 时使用。（例如，1）
pendingBelowStrategyId : 标识订单策略中下方挂单的任意数值。（例如，1）
pendingBelowStrategyType : 标识下方挂单策略的任意数值。小于 1000000 的值被保留，不能使用。（例如，1）
pendingBelowPegOffsetValue : （例如，1）
pendingQuantity : 设置挂单的数量。（例如，1）
omitZeroBalances : 当设置为 true 时，仅显示账户的非零余额。默认值：false
fromAllocationId : （例如，1）
timestamp : （例如，1）
preventedMatchId : （例如，1）
fromPreventedMatchId : （例如，1）
orderId : （例如，1）
fromExecutionId : （例如，1）
limit : 默认值：500；最大值：1000（例如，500）

interval : 1s | 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M
windowSize : 1m | 2m | 3m | 4m | 5m | 6m | 7m | 8m | 9m | 10m | 11m | 12m | 13m | 14m | 15m | 16m | 17m | 18m | 19m | 20m | 21m | 22m | 23m | 24m | 25m | 26m | 27m | 28m | 29m | 30m | 31m | 32m | 33m | 34m | 35m | 36m | 37m | 38m | 39m | 40m | 41m | 42m | 43m | 44m | 45m | 46m | 47m | 48m | 49m | 50m | 51m | 52m | 53m | 54m | 55m | 56m | 57m | 58m | 59m | 1h | 2h | 3h | 4h | 5h | 6h | 7h | 8h | 9h | 10h | 11h | 12h | 13h | 14h | 15h | 16h | 17h | 18h | 19h | 20h | 21h | 22h | 23h | 1d | 2d | 3d | 4d | 5d | 6d
type : FULL | MINI
type : MARKET | LIMIT | STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT | LIMIT_MAKER | NON_REPRESENTABLE
selfTradePreventionMode : NONE | EXPIRE_TAKER | EXPIRE_MAKER | EXPIRE_BOTH | DECREMENT | NON_REPRESENTABLE
symbolStatus : TRADING | END_OF_DAY | HALT | BREAK | NON_REPRESENTABLE
timeInForce : GTC | IOC | FOK | NON_REPRESENTABLE
pegPriceType : PRIMARY_PEG | MARKET_PEG | NON_REPRESENTABLE
pegOffsetType : PRICE_LEVEL | NON_REPRESENTABLE
newOrderRespType : ACK | RESULT | FULL | MARKET | LIMIT
cancelRestrictions : ONLY_NEW | NEW | ONLY_PARTIALLY_FILLED | PARTIALLY_FILLED
cancelReplaceMode : STOP_ON_FAILURE | ALLOW_FAILURE
orderRateLimitExceededMode : DO_NOTHING | CANCEL_ONLY
stopLimitTimeInForce : GTC | IOC | FOK
side : BUY | SELL
aboveType : STOP_LOSS_LIMIT | STOP_LOSS | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_LIMIT
aboveTimeInForce : GTC | IOC | FOK
abovePegPriceType : PRIMARY_PEG | MARKET_PEG
abovePegOffsetType : PRICE_LEVEL
belowType : STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT
belowTimeInForce : GTC | IOC | FOK
belowPegPriceType : PRIMARY_PEG | MARKET_PEG
belowPegOffsetType : PRICE_LEVEL
workingType : LIMIT | LIMIT_MAKER
workingPegPriceType : PRIMARY_PEG | MARKET_PEG
workingPegOffsetType : PRICE_LEVEL
pendingPegPriceType : PRIMARY_PEG | MARKET_PEG
pendingPegOffsetType : PRICE_LEVEL
pendingAboveType : STOP_LOSS_LIMIT | STOP_LOSS | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_LIMIT
pendingAbovePegPriceType : PRIMARY_PEG | MARKET_PEG
pendingAbovePegOffsetType : PRICE_LEVEL
pendingBelowType : STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT
pendingBelowPegPriceType : PRIMARY_PEG | MARKET_PEG
pendingBelowPegOffsetType : PRICE_LEVEL
workingSide : BUY | SELL
workingTimeInForce : GTC | IOC | FOK
pendingType : LIMIT | MARKET | STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT | LIMIT_MAKER
pendingSide : BUY | SELL
pendingTimeInForce : GTC | IOC | FOK
pendingAboveTimeInForce : GTC | IOC | FOK
pendingBelowTimeInForce : GTC | IOC | FOK

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

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

用户可以通过发送文件来提供 Binance API 凭证，文件内容格式如下：

abc123...xyz
secret123...key

切勿显示完整密钥

向用户显示凭证时：

API 密钥： 显示前 5 位 + 后 4 位字符：su1Qc...8akf
密钥： 始终进行掩码处理，仅显示最后 5 位：***...aws1

当被问及凭证时的示例响应：账户：主网 API 密钥：su1Qc...8akf 密钥：***...aws1 环境：主网

列出账户时，仅显示名称和环境——切勿显示密钥：Binance 账户：

main (主网/测试网)
testnet-dev (测试网)
futures-keys (主网)

在主网执行交易时，始终在继续之前通过要求用户输入 "CONFIRM" 来与用户确认。

API 密钥：your_mainnet_api_key
密钥：your_mainnet_secret
测试网：false

API 密钥：your_testnet_api_key
密钥：your_testnet_secret
测试网：true

## Binance 账户

### main
- API 密钥：abc123...xyz
- 密钥：secret123...key
- 测试网：false
- 描述：主要交易账户

### testnet-dev
- API 密钥：test456...abc
- 密钥：testsecret...xyz
- 测试网：true
- 描述：开发/测试

### futures-keys
- API 密钥：futures789...def
- 密钥：futuressecret...uvw
- 测试网：false
- 描述：期货交易账户

请求凭证时：对密钥进行掩码处理（仅显示最后 5 个字符）
列出账户时：显示名称和环境，永不显示密钥
账户选择：如果不明确则询问，默认为 main
在主网进行交易时，通过要求用户输入 "CONFIRM" 来与用户确认
新凭证：提示输入名称、环境、签名模式

当用户提供新凭证时：

询问账户名称
询问：主网、测试网还是演示环境
存储在 TOOLS.md 中，并显示掩码后的确认信息

所有交易端点都需要 HMAC SHA256 签名：

使用所有参数 + 时间戳（Unix 毫秒）构建查询字符串
使用 secretKey 通过 HMAC SHA256、RSA 或 Ed25519（取决于账户配置）对查询字符串进行签名
将签名附加到查询字符串
包含 X-MBX-APIKEY 请求头

用户代理请求头

包含 User-Agent 请求头，其字符串如下：binance-spot/1.0.1 (Skill)

有关实现细节，请参见 references/authentication.md。

🇺🇸English

Binance Spot Skill

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

Quick Reference

Endpoint	Description	Required	Optional	Authentication
`/api/v3/exchangeInfo` (GET)	Exchange information	None	symbol, symbols, permissions, showPermissionSets, symbolStatus	No
`/api/v3/ping` (GET)	Test connectivity	None	None	No
`/api/v3/time` (GET)	Check server time	None	None	No
`/api/v3/aggTrades` (GET)	Compressed/Aggregate trades list	symbol	fromId, startTime, endTime, limit	No
`/api/v3/avgPrice` (GET)	Current average price	symbol	None	No
`/api/v3/depth` (GET)	Order book	symbol	limit, symbolStatus	No
`/api/v3/historicalTrades` (GET)	Old trade lookup	symbol	limit, fromId	No
`/api/v3/klines` (GET)	Kline/Candlestick data	symbol, interval	startTime, endTime, timeZone, limit	No
`/api/v3/ticker` (GET)	Rolling window price change statistics	None	symbol, symbols, windowSize, type, symbolStatus	No
`/api/v3/ticker/24hr` (GET)	24hr ticker price change statistics	None	symbol, symbols, type, symbolStatus	No
`/api/v3/ticker/bookTicker` (GET)	Symbol order book ticker	None	symbol, symbols, symbolStatus	No
`/api/v3/ticker/price` (GET)	Symbol price ticker	None	symbol, symbols, symbolStatus	No
`/api/v3/ticker/tradingDay` (GET)	Trading Day Ticker	None	symbol, symbols, timeZone, type, symbolStatus	No
`/api/v3/trades` (GET)	Recent trades list	symbol	limit	No
`/api/v3/uiKlines` (GET)	UIKlines	symbol, interval	startTime, endTime, timeZone, limit	No
`/api/v3/openOrders` (DELETE)	Cancel All Open Orders on a Symbol	symbol	recvWindow	Yes
`/api/v3/openOrders` (GET)	Current open orders	None	symbol, recvWindow	Yes
`/api/v3/order` (POST)	New order	symbol, side, type	timeInForce, quantity, quoteOrderQty, price, newClientOrderId, strategyId, strategyType, stopPrice, trailingDelta, icebergQty, newOrderRespType, selfTradePreventionMode, pegPriceType, pegOffsetValue, pegOffsetType, recvWindow	Yes
`/api/v3/order` (DELETE)	Cancel order	symbol	orderId, origClientOrderId, newClientOrderId, cancelRestrictions, recvWindow	Yes
`/api/v3/order` (GET)	Query order	symbol	orderId, origClientOrderId, recvWindow	Yes
`/api/v3/order/amend/keepPriority` (PUT)	Order Amend Keep Priority	symbol, newQty	orderId, origClientOrderId, newClientOrderId, recvWindow	Yes
`/api/v3/order/cancelReplace` (POST)	Cancel an Existing Order and Send a New Order	symbol, side, type, cancelReplaceMode	timeInForce, quantity, quoteOrderQty, price, cancelNewClientOrderId, cancelOrigClientOrderId, cancelOrderId, newClientOrderId, strategyId, strategyType, stopPrice, trailingDelta, icebergQty, newOrderRespType, selfTradePreventionMode, cancelRestrictions, orderRateLimitExceededMode, pegPriceType, pegOffsetValue, pegOffsetType, recvWindow	Yes
`/api/v3/order/oco` (POST)	New OCO - Deprecated	symbol, side, quantity, price, stopPrice	listClientOrderId, limitClientOrderId, limitStrategyId, limitStrategyType, limitIcebergQty, trailingDelta, stopClientOrderId, stopStrategyId, stopStrategyType, stopLimitPrice, stopIcebergQty, stopLimitTimeInForce, newOrderRespType, selfTradePreventionMode, recvWindow	Yes
`/api/v3/order/test` (POST)	Test new order	symbol, side, type	computeCommissionRates, timeInForce, quantity, quoteOrderQty, price, newClientOrderId, strategyId, strategyType, stopPrice, trailingDelta, icebergQty, newOrderRespType, selfTradePreventionMode, pegPriceType, pegOffsetValue, pegOffsetType, recvWindow	Yes
`/api/v3/orderList` (DELETE)	Cancel Order list	symbol	orderListId, listClientOrderId, newClientOrderId, recvWindow	Yes
`/api/v3/orderList` (GET)	Query Order list	None	orderListId, origClientOrderId, recvWindow	Yes
`/api/v3/orderList/oco` (POST)	New Order list - OCO	symbol, side, quantity, aboveType, belowType	listClientOrderId, aboveClientOrderId, aboveIcebergQty, abovePrice, aboveStopPrice, aboveTrailingDelta, aboveTimeInForce, aboveStrategyId, aboveStrategyType, abovePegPriceType, abovePegOffsetType, abovePegOffsetValue, belowClientOrderId, belowIcebergQty, belowPrice, belowStopPrice, belowTrailingDelta, belowTimeInForce, belowStrategyId, belowStrategyType, belowPegPriceType, belowPegOffsetType, belowPegOffsetValue, newOrderRespType, selfTradePreventionMode, recvWindow	Yes
`/api/v3/orderList/opo` (POST)	New Order List - OPO	symbol, workingType, workingSide, workingPrice, workingQuantity, pendingType, pendingSide	listClientOrderId, newOrderRespType, selfTradePreventionMode, workingClientOrderId, workingIcebergQty, workingTimeInForce, workingStrategyId, workingStrategyType, workingPegPriceType, workingPegOffsetType, workingPegOffsetValue, pendingClientOrderId, pendingPrice, pendingStopPrice, pendingTrailingDelta, pendingIcebergQty, pendingTimeInForce, pendingStrategyId, pendingStrategyType, pendingPegPriceType, pendingPegOffsetType, pendingPegOffsetValue, recvWindow	Yes
`/api/v3/orderList/opoco` (POST)	New Order List - OPOCO	symbol, workingType, workingSide, workingPrice, workingQuantity, pendingSide, pendingAboveType	listClientOrderId, newOrderRespType, selfTradePreventionMode, workingClientOrderId, workingIcebergQty, workingTimeInForce, workingStrategyId, workingStrategyType, workingPegPriceType, workingPegOffsetType, workingPegOffsetValue, pendingAboveClientOrderId, pendingAbovePrice, pendingAboveStopPrice, pendingAboveTrailingDelta, pendingAboveIcebergQty, pendingAboveTimeInForce, pendingAboveStrategyId, pendingAboveStrategyType, pendingAbovePegPriceType, pendingAbovePegOffsetType, pendingAbovePegOffsetValue, pendingBelowType, pendingBelowClientOrderId, pendingBelowPrice, pendingBelowStopPrice, pendingBelowTrailingDelta, pendingBelowIcebergQty, pendingBelowTimeInForce, pendingBelowStrategyId, pendingBelowStrategyType, pendingBelowPegPriceType, pendingBelowPegOffsetType, pendingBelowPegOffsetValue, recvWindow	Yes
`/api/v3/orderList/oto` (POST)	New Order list - OTO	symbol, workingType, workingSide, workingPrice, workingQuantity, pendingType, pendingSide, pendingQuantity	listClientOrderId, newOrderRespType, selfTradePreventionMode, workingClientOrderId, workingIcebergQty, workingTimeInForce, workingStrategyId, workingStrategyType, workingPegPriceType, workingPegOffsetType, workingPegOffsetValue, pendingClientOrderId, pendingPrice, pendingStopPrice, pendingTrailingDelta, pendingIcebergQty, pendingTimeInForce, pendingStrategyId, pendingStrategyType, pendingPegPriceType, pendingPegOffsetType, pendingPegOffsetValue, recvWindow	Yes
`/api/v3/orderList/otoco` (POST)	New Order list - OTOCO	symbol, workingType, workingSide, workingPrice, workingQuantity, pendingSide, pendingQuantity, pendingAboveType	listClientOrderId, newOrderRespType, selfTradePreventionMode, workingClientOrderId, workingIcebergQty, workingTimeInForce, workingStrategyId, workingStrategyType, workingPegPriceType, workingPegOffsetType, workingPegOffsetValue, pendingAboveClientOrderId, pendingAbovePrice, pendingAboveStopPrice, pendingAboveTrailingDelta, pendingAboveIcebergQty, pendingAboveTimeInForce, pendingAboveStrategyId, pendingAboveStrategyType, pendingAbovePegPriceType, pendingAbovePegOffsetType, pendingAbovePegOffsetValue, pendingBelowType, pendingBelowClientOrderId, pendingBelowPrice, pendingBelowStopPrice, pendingBelowTrailingDelta, pendingBelowIcebergQty, pendingBelowTimeInForce, pendingBelowStrategyId, pendingBelowStrategyType, pendingBelowPegPriceType, pendingBelowPegOffsetType, pendingBelowPegOffsetValue, recvWindow	Yes
`/api/v3/sor/order` (POST)	New order using SOR	symbol, side, type, quantity	timeInForce, price, newClientOrderId, strategyId, strategyType, icebergQty, newOrderRespType, selfTradePreventionMode, recvWindow	Yes
`/api/v3/sor/order/test` (POST)	Test new order using SOR	symbol, side, type, quantity	computeCommissionRates, timeInForce, price, newClientOrderId, strategyId, strategyType, icebergQty, newOrderRespType, selfTradePreventionMode, recvWindow	Yes
`/api/v3/account` (GET)	Account information	None	omitZeroBalances, recvWindow	Yes
`/api/v3/account/commission` (GET)	Query Commission Rates	symbol	None	Yes
`/api/v3/allOrderList` (GET)	Query all Order lists	None	fromId, startTime, endTime, limit, recvWindow	Yes
`/api/v3/allOrders` (GET)	All orders	symbol	orderId, startTime, endTime, limit, recvWindow	Yes
`/api/v3/myAllocations` (GET)	Query Allocations	symbol	startTime, endTime, fromAllocationId, limit, orderId, recvWindow	Yes
`/api/v3/myFilters` (GET)	Query relevant filters	symbol	recvWindow	Yes
`/api/v3/myPreventedMatches` (GET)	Query Prevented Matches	symbol	preventedMatchId, orderId, fromPreventedMatchId, limit, recvWindow	Yes
`/api/v3/myTrades` (GET)	Account trade list	symbol	orderId, startTime, endTime, fromId, limit, recvWindow	Yes
`/api/v3/openOrderList` (GET)	Query Open Order lists	None	recvWindow	Yes
`/api/v3/order/amendments` (GET)	Query Order Amendments	symbol, orderId	fromExecutionId, limit, recvWindow	Yes
`/api/v3/rateLimit/order` (GET)	Query Unfilled Order Count	None	recvWindow	Yes

Parameters

Common Parameters

symbol : Symbol to query (e.g., BNBUSDT)
symbols : List of symbols to query
permissions : List of permissions to query
showPermissionSets : Controls whether the content of the permissionSets field is populated or not. Defaults to true (e.g., true)
symbol : (e.g., BNBUSDT)
fromId : ID to get aggregate trades from INCLUSIVE. (e.g., 1)
startTime : Timestamp in ms to get aggregate trades from INCLUSIVE. (e.g., 1735693200000)
endTime : Timestamp in ms to get aggregate trades until INCLUSIVE. (e.g., 1735693200000)
limit : Default: 500; Maximum: 1000. (e.g., 500)
timeZone : Default: 0 (UTC)
recvWindow : The value cannot be greater than 60000. Supports up to three decimal places of precision (e.g., 6000.346) so that microseconds may be specified. (e.g., 5000)
timestamp : (e.g., 1)
quantity : (e.g., 1)
quoteOrderQty : (e.g., 1)
price : (e.g., 400)

Enums

interval : 1s | 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 6h | 8h | 12h | 1d | 3d | 1w | 1M
windowSize : 1m | 2m | 3m | 4m | 5m | 6m | 7m | 8m | 9m | 10m | 11m | 12m | 13m | 14m | 15m | 16m | 17m | 18m | 19m | 20m | 21m | 22m | 23m | 24m | 25m | 26m | 27m | 28m | 29m | 30m | 31m | 32m | 33m | 34m | 35m | 36m | 37m | 38m | 39m | 40m | 41m | 42m | 43m | 44m | 45m | 46m | 47m | 48m | 49m | 50m | 51m | 52m | 53m | 54m | 55m | 56m | 57m | 58m | 59m | 1h | 2h | 3h | 4h | 5h | 6h | 7h | 8h | 9h | 10h | 11h | 12h | 13h | 14h | 15h | 16h | 17h | 18h | 19h | 20h | 21h | 22h | 23h | 1d | 2d | 3d | 4d | 5d | 6d
type : FULL | MINI
type : MARKET | LIMIT | STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT | LIMIT_MAKER | NON_REPRESENTABLE
selfTradePreventionMode : NONE | EXPIRE_TAKER | EXPIRE_MAKER | EXPIRE_BOTH | DECREMENT | NON_REPRESENTABLE
symbolStatus : TRADING | END_OF_DAY | HALT | BREAK | NON_REPRESENTABLE
timeInForce : GTC | IOC | FOK | NON_REPRESENTABLE
pegPriceType : PRIMARY_PEG | MARKET_PEG | NON_REPRESENTABLE
pegOffsetType : PRICE_LEVEL | NON_REPRESENTABLE
newOrderRespType : ACK | RESULT | FULL | MARKET | LIMIT
cancelRestrictions : ONLY_NEW | NEW | ONLY_PARTIALLY_FILLED | PARTIALLY_FILLED
cancelReplaceMode : STOP_ON_FAILURE | ALLOW_FAILURE
orderRateLimitExceededMode : DO_NOTHING | CANCEL_ONLY
stopLimitTimeInForce : GTC | IOC | FOK
side : BUY | SELL
aboveType : STOP_LOSS_LIMIT | STOP_LOSS | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_LIMIT

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:

Security

Share Credentials

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

abc123...xyz
secret123...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 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 in Mainnet

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

Binance Accounts

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 Structure

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

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

Adding New Accounts

When user provides new credentials:

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

Signing Requests

All trading endpoints require HMAC SHA256 signature:

Build query string with all params + timestamp (Unix ms)
Sign query string with secretKey using HMAC SHA256, RSA, or Ed25519 (depending on account config)
Append signature to query string
Include X-MBX-APIKEY header

User Agent Header

Include User-Agent header with the following string: binance-spot/1.0.1 (Skill)

See references/authentication.md for implementation details.

Weekly Installs

504

Repository

binance/binance…ills-hub

GitHub Stars

366

First Seen

7 days ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

codex487

opencode486

cursor485

gemini-cli485

github-copilot485

amp484

newClientOrderId : A unique id among open orders. Automatically generated if not sent. Orders with the same newClientOrderID can be accepted only when the previous one is filled, otherwise the order will be rejected.

strategyId : (e.g., 1)

strategyType : The value cannot be less than 1000000. (e.g., 1)

stopPrice : Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders. (e.g., 1)

trailingDelta : See Trailing Stop order FAQ. (e.g., 1)

icebergQty : Used with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order. (e.g., 1)

pegOffsetValue : Priceleveltopegthepriceto(max:100). SeePeggedOrdersInfo (e.g., 1)

orderId : (e.g., 1)

origClientOrderId :

newQty : newQty must be greater than 0 and less than the order's quantity. (e.g., 1)

cancelNewClientOrderId : Used to uniquely identify this cancel. Automatically generated by default.

cancelOrigClientOrderId : Either cancelOrderId or cancelOrigClientOrderId must be sent. If both cancelOrderId and cancelOrigClientOrderId parameters are provided, the cancelOrderId is searched first, then the cancelOrigClientOrderId from that result is checked against that order. If both conditions are not met the request will be rejected.

cancelOrderId : Either cancelOrderId or cancelOrigClientOrderId must be sent. If both cancelOrderId and cancelOrigClientOrderId parameters are provided, the cancelOrderId is searched first, then the cancelOrigClientOrderId from that result is checked against that order. If both conditions are not met the request will be rejected. (e.g., 1)

listClientOrderId : A unique Id for the entire orderList

quantity : (e.g., 1)

limitClientOrderId : A unique Id for the limit order

price : (e.g., 1)

limitStrategyId : (e.g., 1)

limitStrategyType : The value cannot be less than 1000000. (e.g., 1)

limitIcebergQty : Used to make the LIMIT_MAKER leg an iceberg order. (e.g., 1)

stopClientOrderId : A unique Id for the stop loss/stop loss limit leg

stopPrice : (e.g., 1)

stopStrategyId : (e.g., 1)

stopStrategyType : The value cannot be less than 1000000. (e.g., 1)

stopLimitPrice : If provided, stopLimitTimeInForce is required. (e.g., 1)

stopIcebergQty : Used with STOP_LOSS_LIMIT leg to make an iceberg order. (e.g., 1)

computeCommissionRates : Default: false See Commissions FAQ to learn more.

orderListId : Either orderListId or listClientOrderId must be provided (e.g., 1)

aboveClientOrderId : Arbitrary unique ID among open orders for the above order. Automatically generated if not sent

aboveIcebergQty : Note that this can only be used if aboveTimeInForce is GTC. (e.g., 1)

abovePrice : Can be used if aboveType is STOP_LOSS_LIMIT , LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price. (e.g., 1)

aboveStopPrice : Can be used if aboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT. Either aboveStopPrice or aboveTrailingDelta or both, must be specified. (e.g., 1)

aboveTrailingDelta : See Trailing Stop order FAQ. (e.g., 1)

aboveStrategyId : Arbitrary numeric value identifying the above order within an order strategy. (e.g., 1)

aboveStrategyType : Arbitrary numeric value identifying the above order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)

abovePegOffsetValue : (e.g., 1)

belowClientOrderId : Arbitrary unique ID among open orders for the below order. Automatically generated if not sent

belowIcebergQty : Note that this can only be used if belowTimeInForce is GTC. (e.g., 1)

belowPrice : Can be used if belowType is STOP_LOSS_LIMIT, LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price. (e.g., 1)

belowStopPrice : Can be used if belowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT or TAKE_PROFIT_LIMIT Either belowStopPrice or belowTrailingDelta or both, must be specified. (e.g., 1)

belowTrailingDelta : See Trailing Stop order FAQ. (e.g., 1)

belowStrategyId : Arbitrary numeric value identifying the below order within an order strategy. (e.g., 1)

belowStrategyType : Arbitrary numeric value identifying the below order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)

belowPegOffsetValue : (e.g., 1)

workingClientOrderId : Arbitrary unique ID among open orders for the working order. Automatically generated if not sent.

workingPrice : (e.g., 1)

workingQuantity : Sets the quantity for the working order. (e.g., 1)

workingIcebergQty : This can only be used if workingTimeInForce is GTC, or if workingType is LIMIT_MAKER. (e.g., 1)

workingStrategyId : Arbitrary numeric value identifying the working order within an order strategy. (e.g., 1)

workingStrategyType : Arbitrary numeric value identifying the working order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)

workingPegOffsetValue : (e.g., 1)

pendingClientOrderId : Arbitrary unique ID among open orders for the pending order. Automatically generated if not sent.

pendingPrice : (e.g., 1)

pendingStopPrice : (e.g., 1)

pendingTrailingDelta : (e.g., 1)

pendingIcebergQty : This can only be used if pendingTimeInForce is GTC or if pendingType is LIMIT_MAKER. (e.g., 1)

pendingStrategyId : Arbitrary numeric value identifying the pending order within an order strategy. (e.g., 1)

pendingStrategyType : Arbitrary numeric value identifying the pending order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)

pendingPegOffsetValue : (e.g., 1)

pendingAboveClientOrderId : Arbitrary unique ID among open orders for the pending above order. Automatically generated if not sent.

pendingAbovePrice : Can be used if pendingAboveType is STOP_LOSS_LIMIT , LIMIT_MAKER, or TAKE_PROFIT_LIMIT to specify the limit price. (e.g., 1)

pendingAboveStopPrice : Can be used if pendingAboveType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT (e.g., 1)

pendingAboveTrailingDelta : See Trailing Stop FAQ (e.g., 1)

pendingAboveIcebergQty : This can only be used if pendingAboveTimeInForce is GTC or if pendingAboveType is LIMIT_MAKER. (e.g., 1)

pendingAboveStrategyId : Arbitrary numeric value identifying the pending above order within an order strategy. (e.g., 1)

pendingAboveStrategyType : Arbitrary numeric value identifying the pending above order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)

pendingAbovePegOffsetValue : (e.g., 1)

pendingBelowClientOrderId : Arbitrary unique ID among open orders for the pending below order. Automatically generated if not sent.

pendingBelowPrice : Can be used if pendingBelowType is STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT to specify limit price (e.g., 1)

pendingBelowStopPrice : Can be used if pendingBelowType is STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT or TAKE_PROFIT_LIMIT. Either pendingBelowStopPrice or pendingBelowTrailingDelta or both, must be specified. (e.g., 1)

pendingBelowTrailingDelta : (e.g., 1)

pendingBelowIcebergQty : This can only be used if pendingBelowTimeInForce is GTC, or if pendingBelowType is LIMIT_MAKER. (e.g., 1)

pendingBelowStrategyId : Arbitrary numeric value identifying the pending below order within an order strategy. (e.g., 1)

pendingBelowStrategyType : Arbitrary numeric value identifying the pending below order strategy. Values smaller than 1000000 are reserved and cannot be used. (e.g., 1)

pendingBelowPegOffsetValue : (e.g., 1)

pendingQuantity : Sets the quantity for the pending order. (e.g., 1)

omitZeroBalances : When set to true, emits only the non-zero balances of an account. Default value: false

fromAllocationId : (e.g., 1)

timestamp : (e.g., 1)

preventedMatchId : (e.g., 1)

fromPreventedMatchId : (e.g., 1)

orderId : (e.g., 1)

fromExecutionId : (e.g., 1)

limit : Default:500; Maximum: 1000 (e.g., 500)

aboveTimeInForce : GTC | IOC | FOK

abovePegPriceType : PRIMARY_PEG | MARKET_PEG

abovePegOffsetType : PRICE_LEVEL

belowType : STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT

belowTimeInForce : GTC | IOC | FOK

belowPegPriceType : PRIMARY_PEG | MARKET_PEG

belowPegOffsetType : PRICE_LEVEL

workingType : LIMIT | LIMIT_MAKER

workingPegPriceType : PRIMARY_PEG | MARKET_PEG

workingPegOffsetType : PRICE_LEVEL

pendingPegPriceType : PRIMARY_PEG | MARKET_PEG

pendingPegOffsetType : PRICE_LEVEL

pendingAboveType : STOP_LOSS_LIMIT | STOP_LOSS | LIMIT_MAKER | TAKE_PROFIT | TAKE_PROFIT_LIMIT

pendingAbovePegPriceType : PRIMARY_PEG | MARKET_PEG

pendingAbovePegOffsetType : PRICE_LEVEL

pendingBelowType : STOP_LOSS | STOP_LOSS_LIMIT | TAKE_PROFIT | TAKE_PROFIT_LIMIT

pendingBelowPegPriceType : PRIMARY_PEG | MARKET_PEG

pendingBelowPegOffsetType : PRICE_LEVEL

workingSide : BUY | SELL

workingTimeInForce : GTC | IOC | FOK

pendingSide : BUY | SELL

pendingTimeInForce : GTC | IOC | FOK

pendingAboveTimeInForce : GTC | IOC | FOK

pendingBelowTimeInForce : GTC | IOC | FOK

Binance 现货交易 API 使用指南 - 交易所信息、订单管理、市场数据接口

🇨🇳中文介绍

Binance 现货技能

快速参考

相关 Skills

参数

通用参数

枚举

身份验证

安全性

共享凭证

切勿显示完整密钥

列出账户

主网交易

Binance 账户

main

testnet-dev

TOOLS.md 结构

代理行为

添加新账户

签名请求

用户代理请求头

🇺🇸English

Binance Spot Skill

Quick Reference

Parameters

Common Parameters

Enums

Authentication

Security

Share Credentials

Never Display Full Secrets

Listing Accounts

Transactions in Mainnet

Binance Accounts

main

testnet-dev

TOOLS.md Structure

Agent Behavior

Adding New Accounts

Signing Requests

User Agent Header