Buy/Sell Bitcoin, Ether and Altcoins | Cryptocurrency Exchange | Binance
Buy/Sell Bitcoin, Ether and Altcoins | Cryptocurrency Exchange | Binance
Error 403 Forbidden - This request is blocked.
For security reasons you can't connect to the server for this app or website at this time.
It maybe that you have too many requests or the illegal request payload is identified as an attack.
Please try again later.
BNB Chain - Build Web3 dApps on the Most Popular Blockchain
Chain - Build Web3 dApps on the Most Popular BlockchainBuild Web3 on BNB ChainA community-driven blockchain ecosystemof Layer-1 and Layer-2 scaling solutions.Develop with BNB ChainExplore dAppsWhat's NEW at BNB ChainLearn MoreJoin the BNB Chain EcosystemGet started in 3 steps to dive into the world of BNB Chain.Download a walletA wallet helps you connect to BNB Chain and manage your funds.Download WalletGet BNBBNB is the currency of BNB Chain - you can use it in dApps.Get BNBUse a dAppDiscover the hottest projects on BNB Chain.Find Your First dAppBuild on BNB ChainBNB Smart Chain (BSC) supports the most popular programming languages, flexible tools, and comes with clear and canonical documentation. You can quickly start and deploy your application on a blockchain designed with real use in mind.Start BuildingRead the DocsBest EVM CompatibleThe best-performing EVM compatible layer 1. Fully compatible tooling for EVM with up to 35 times of capacity.Massive User BaseHandling the largest daily active users and the highest peak EVM transactions with economical fees.Most Diversified Assets APIsFull support on all popular tokens via the most powerful Binance Bridge. The greatest opportunity for composability.Strongest EcosystemSupported by a robust ecosystem of top-tier RPC plants, wallets, blockchain explorers, data indices, and substantial grants.BNB GreenfieldA Decentralized Data Storage System and EconomyBNB Greenfield is decentralized storage infrastructure within the broader BNB Chain ecosystem where users and dApps can create, store and exchange data with full ownership to form a new data economy.Learn MoreDeveloper ProgramsBuilder GrantAwarding grants to innovative projects building open sourced infrastructure and developer tooling.Learn MoreGas GrantGet up to $15k monthly rewards to accelerate your dApp's growth.Learn MoreSee All ProgramsScale with BNB SidechainBNB Sidechain is an infrastructure introduced to help developers and the application community to build and run their dedicated blockchain as a focused value system for a massive number of users while still maintaining a close connection with BNB Chain.DedicationA blockchain dedicated to the application logic with the independent community governance and economy.SustainabilityBNB Sidechain is a high-performance blockchain with high TPS and ultra-low gas fees.IntegrationProjects that own a BNB Sidechain are also a part of the broader BNB Chain ecosystem.SupportBNB Sidechain is backed by the largest community of users and developers.Discover dApps on DappBayEasily navigate relevant dApps, swiftly explore and discover profitable early-stage projects, and effortlessly identify risky dApps on DappBay.Explore DappBay NowGet Involved, Be Part of the CommunityBNB Chain is a global, decentralized network with developers, validators, users, HODLers and enthusiasts.DiscordTwitterYouTubeTelegramGitHubExploreTrust WalletBNB Chain WalletDappBayBuildDevelopersSDKsWhitepaperBuild N’ Build ForumBridgesParticipateEventsMVB ProgramHackathonDeveloper ProgramsMartians ProgramBug BountyAboutPrivacy Policy Terms of UseCareersVerificationContact Us© 2024 bnbchain.org. All rights reserved. EnglishEnglishBahasa IndonesiaEspañol (Latinoamérica)FrançaisPortuguês (Brasil)Tiếng ViệtTürkçeРусский简体中文繁币安_百度百科
度百科 网页新闻贴吧知道网盘图片视频地图文库资讯采购百科百度首页登录注册进入词条全站搜索帮助首页秒懂百科特色百科知识专题加入百科百科团队权威合作下载百科APP个人中心收藏查看我的收藏0有用+10币安播报讨论上传视频区块链交易平台币安（Binance）为区块链交易平台之一 [3]，创始人赵长鹏 [1]。旗下运营区块链资产交易平台币安网。 [2]2024年2月24日消息：币安支付43亿美元罚款的认罪协议获美国法官批准，该公司已承认洗钱和违反制裁规定。 [40]中文名币安外文名Binance创始人赵长鹏性 质区块链交易平台目录1发展历程2创始人3企业事件4所获荣誉发展历程播报编辑2021年3月，币安宣布聘请前美国驻华大使Max Baucus担任监管顾问 [6]。2021年3月，区块链交易平台币安受到美国方面的调查 [3]。2021年3月11日，币安（Binance）的官方微博账号被封 [4-5]。2021年10月13日，币安发布《关于下架C2CCNY交易区及中国大陆地区用户清查的通知》，称为响应当地政府监管政策要求，币安C2C东八区时间2021年12月31日24:00下架CNY交易区，同时将对平台用户进行清查 [8]。2022年2月15日，加密货币交易所币安发布消息，原币安智能链（BSC）将更名为BNB Chain。BNB是币安交易所的平台币，以及币安智能链的生态代币。 [9]2022年2月18日，《华尔街日报》报道，全球交易量最大的加密货币交易所币安（Binance）的美国部门任命了一位新的首席合规官。 [12]2022年5月5日讯，币安宣布Binance France SAS已经获得法国金融审慎监理总署（ACPR）批准，并由法国金融监管局（AMF）授予币安法国数字资产服务提供商（DASP）注册许可，将作为持牌数字资产服务提供商在法国展开营运。 [13]2022年7月18日，路透社消息，荷兰央行对加密货币交易所币安罚款330万欧元（约合335万美元），因后者在尚未于荷兰注册的情况下就提供服务 [14]。2022年11月17日，加密货币交易所币安发布公告称，已暂停USDC（SOL）、USDT（SOL）代币的充值业务。 [16]2023年3月1日，币安宣布投资新成立的加密风险基金Nomad Capital。 [17]2023年3月28日，据《华尔街日报》报道，全球交易所币安的美国关联公司Binance.US暂缓从破产平台Voyager Digital Ltd.收购数千个加密货币客户帐户的交易，以待美国政府的上诉。 [20]2023年5月12日，全球最大加密货币交易所币安宣布将退出加拿大市场，并称这是由于“与稳定币相关的新指南和对加密货币交易所的投资者限制”不再适合币安。 [23]2023年5月21日，币安公告称，将暂停波场币（TORN）存款，直至另行通知。 [24]据《华尔街日报》和彭博2023年6月13日消息，被美国证监会（SEC）起诉的币安美国可能不会面临全面资产冻结，该公司曾表示全面资产冻结或致其业务严重受损。 [27]2023年7月4日，澳大利亚证券投资委员会（ASIC）对币安澳大利亚网点进行了搜查。 [29]2023年7月5日，知情人士透露，澳大利亚金融市场监管机构搜查了币安的办公室，以对该加密货币交易所现已关闭的本地衍生品业务进行持续调查。 [29]2023年8月15日，币安公告，决定8月22日11:00停止交易并下架以下币种：Sonm (SNM)、Serum (SRM)、DFI.Money (YFII)。 [30]2023年10月16日，加密货币交易所币安表示，将停止在英国接受新客户，以遵守限制海外数字资产公司在英国宣传的新规定。 [31]2023年10月16日，加密货币交易所币安美国分部更新部分条款，已停止客户从该平台提取美元。“如果客户希望从账户中提取美元资金，他们可以将美元资金兑换成稳定币或其他数字资产，然后再提取。”条款中写道。 [32]2023年11月28日，加密货币交易所币安美国（Binance.US）在一份声明中说，因与币安分别独立运营，币安美国并不是上周宣布的和解协议的一方，与美国司法部、金融犯罪执法局、外国资产控制办公室或商品期货交易委员会也没有任何悬而未决的执行事宜，该交易所保持全面运营。币安创始人赵长鹏决定辞去币安美国的董事会主席职务，并通过代理安排转让投票权。 [37]创始人播报编辑赵长鹏，币安创始人兼大股东。 [36]何一，币安联合创始人兼CMO。 [7]Tammy Weinrib，首席合规官。 [11]企业事件播报编辑 SEC 调查2022年，据华尔街见闻报道，SEC 怀疑币安与两家交易附属公司之间有不正当关系。币安美国交易所在其官网上公布，相关做市商可能会在交易所进行交易，但并未说明哪些交易公司可能会这样做。根据 SEC 的要求，币安美国交易所需要提供有关这两家交易公司的具体信息。知情人士透露，SEC 关注的是币安美国交易所如何向客户披露其与交易公司的联系。 [10]被荷兰央行罚款2022年7月18日，路透社消息，荷兰央行已经对加密货币交易所币安罚款330万欧元（约合335万美元），因后者在尚未于荷兰注册的情况下就提供服务 [14]。黑客盗窃北京时间2022年10月7日凌晨，智能合约平台币安链(BNB Chain)遭遇黑客攻击，2小时内，200万枚币安币被洗劫一空。币安首席执行官赵长鹏在社交平台表示，受损金额估计为1亿美元(约合人民币7.1亿元)。币安已经暂停投资者充值和提现。 [15]起诉2023年3月27日，据彭博，币安及其首席执行官赵长鹏因涉嫌违反交易规则被美国商品期货交易委员会起诉。 [18]3月28日，在美国商品期货交易委员会（CFTC）指控币安及其创始人赵长鹏非法经营数字资产衍生品交易所后，币安在官网博客发布了赵长鹏对CFTC起诉的回应。 [19]当地时间2023年6月5日，美国证券交易委员会表示，因违反美国证券交易规则，该委员会已对全球最大的加密货币交易所——币安交易所及其首席执行官提起诉讼。美国证交会向华盛顿特区联邦法院提起诉讼，指控币安及其首席执行官赵长鹏经营未注册的交易所、出售未注册的证券，以及存在滥用客户资金等违规行为 。美国证交会还指控币安，至少在2019年9月到2022年6月之间，从事虚假交易、夸大交易量等。 [25]因可能违反对俄制裁面临美国调查2023年5月，美国司法部正在调查币安是否被非法用于让俄罗斯人逃避美国制裁，并通过这个全球最大的加密货币交易所转移资金。 [22]2023年6月，尼日利亚宣布币安在该国运营“非法”。 [26]接受法国当局的调查2023年6月16日，加密货币行业新闻网站CoinDesk援引巴黎检察官办公室的话报道称，币安因涉嫌非法提供数字资产服务和严重洗钱行为正在接受法国当局的调查。 [28]美国司法部将宣布与币安的和解协议2023年11月，币安与美国司法部达成协议：赵长鹏认罪辞去CEO职务，并支付43亿美元罚款。 [33]根据报道，该协议可能使币安拥有继续运营的能力，此外据悉赵长鹏将保留在币安的多数股权。 [34]涉嫌洗钱，赵长鹏宣布认罪辞职2023年11月22日，据媒体报道，赵长鹏宣布辞职，称当前辞职是正确之举，并将为自己所犯的错误担起责任。赵长鹏还称保证资金是安全的，与美国司法部达成的和解协议不涉及资金挪用、市场操纵。 [35]屏蔽网址2023年12月28日印度金融情报部门声明称，一些海外加密货币交易所在印度非法经营，已向包括币安在内的平台发出了所谓的合规通知，将要求信息部屏蔽这九家实体的网址。 [38]延期宣判2024年2月，根据美国西雅图联邦法院发布的一份通知，币安创始人赵长鹏涉嫌洗钱案件的刑事判决已被推迟至4月30日。 [39]所获荣誉播报编辑2023年4月18日，币安以1380亿人民币的企业估值入选《2023·胡润全球独角兽榜》，排名17名。 [21]新手上路成长任务编辑入门编辑规则本人编辑我有疑问内容质疑在线客服官方贴吧意见反馈投诉建议举报不良信息未通过词条申诉投诉侵权信息封禁查询与解封©2024 Baidu 使用百度前必读 | 百科协议 | 隐私政策 | 百度百科合作平台 | 京ICP证030173号 京公网安备110000020000Buy and Sell BTC, DOGE, Crypto and More Securely
Buy and Sell BTC, DOGE, Crypto and More Securely
企业入口和出口NFT结账成为我们的合作伙伴登录商户门户个人买卖加密货币关于我们Binance Connect简介简体中文欢迎使用Binance Connect一架桥梁，助您通往金融的未来Bifinity先进的支付基础设施将传统金融与世界领先的新兴区块链连接起来，改变了全球企业和个人的收付款方式。我们的愿景是创建开放的金融世界，让各行各业的从业者和各种规模的企业能够共同参与，实现各自的金融目标。我们的承诺 User-focusedWe protect our users and put users’ needs at the forefront of all our initiatives. We make products which help solve our users' problems while promising service excellence. SecurityOur team is assembled with top security experts who are committed to consistently strengthen our infrastructure. ComplianceWe adhere to industry standards and regulatory requirements from trusted authorities. IntegrityWe are accountable for our actions and always act with the highest ethical standards.Binance Connect关于我们博客新闻中心即将推出隐私声明Cookie政策Cookie偏好设置交易条款产品列表产品列表入口和出口NFT结账个人买卖加密货币联系客服常见问题客服买币购买比特币购买BNBCopyright © 2021-2022 Binancecnt.com All rights reserved.
Binance API Documentation
Binance API Documentation
v1
//
//
// v1
//
//
// v2
//
现货/杠杆/币安宝
U本位合约
币本位合约
欧式期权
WebSocket API
统一账户
简体中文
更新日志
介绍
API Key 设置
API Key 权限设置
账户
API 代码库
联系我们
基本信息
API 基本信息
访问限制
数据来源
接口鉴权类型
SIGNED (TRADE、USER_DATA AND MARGIN) Endpoint security
公开 API 参数
过滤器
钱包接口
系统状态(System)
获取所有币信息 (USER_DATA)
查询每日资产快照 (USER_DATA)
关闭站内划转 (USER_DATA)
开启站内划转 (USER_DATA)
提币 (USER_DATA)
获取充值历史(支持多网络) (USER_DATA)
获取提币历史 (支持多网络) (USER_DATA)
获取充值地址 (支持多网络) (USER_DATA)
账户状态 (USER_DATA)
账户API交易状态(USER_DATA)
小额资产转换BNB历史 (USER_DATA)
获取可以转换成BNB的小额资产 (USER_DATA)
小额资产转换 (USER_DATA)
资产利息记录 (USER_DATA)
上架资产详情 (USER_DATA)
交易手续费率查询 (USER_DATA)
用户万向划转 (USER_DATA)
查询用户万向划转历史 (USER_DATA)
资金账户 (USER_DATA)
用户持仓 (USER_DATA)
稳定币自动兑换划转 (TRADE)
稳定币自动兑换划转查询 (USER_DATA)
云算力历史记录分页查询 (USER_DATA)
查询用户API Key权限 (USER_DATA)
查询用户稳定币与 BUSD 互相转换的设置 (USER_DATA)
修改哪些稳定币可与 BUSD 互相转换(USER_DATA)
一键上账 (充值到过期地址) (USER_DATA)
查询充值地址列表(USER_DATA)
查询用户钱包余额 (USER_DATA)
查询用户委托资金历史(适用主账户)(USER_DATA)
查询现货币对的下架计划 (MARKET_DATA)
子母账户接口
创建虚拟子账户（适用主账户）
查询子账户列表（适用主账户）
查询子账户现货资金划转历史 (适用主账户)
查询子账户合约资金划转历史 (适用主账户)
执行子账户合约资金划转 (适用主账户)
查询子账户资产 (适用主账户)
查询子账户现货资产汇总 (适用主账户)
获取子账户充值地址 (适用主账户)
获取子账户充值记录 (适用主账户)
查询子账户Margin/Futures状态 (适用主账户)
为子账户开通Margin (适用主账户)
查询子账户Margin账户详情 (适用主账户)
查询子账户Margin账户汇总 (适用主账户)
为子账户开通Futures (适用主账户)
查询子账户Futures账户详情 (适用主账户)
查询子账户Futures账户汇总 (适用主账户)
查询子账户合约持仓信息 (仅适用主账户)
子账户Futures划转 (仅适用主账户)
子账户Margin划转 (仅适用主账户)
向共同主账户下的子账户主动划转 (仅适用子账户)
向主账户主动划转 (仅适用子账户)
查询子账户划转历史 (仅适用子账户)
子母账户万能划转 (适用主账户)
查询子母账户万能划转历史 (适用主账户)
查询子账户Futures账户详情V2 (适用主账户)
查询子账户Futures账户汇总V2 (适用主账户)
查询子账户合约持仓信息V2 (仅适用主账户)
为子账户开通杠杆代币 (适用母账户)
查询子账户API Key IP白名单 (适用母账户)
删除子账户API Key IP白名单 (适用母账户)
为子账户API Key增加IP白名单 (适用母账户)
投资人账户为托管子账户充值资产 (适用投资人母账户)
投资人账户查询托管子账户资产 (适用投资人母账户)
投资人账户为托管子账户提币资产 (适用投资人母账户)
查询托管子账户资产快照 (适用投资人母账户)
查询托管子账户的划转记录(适用投资人母账户) (USER_DATA)
查询托管子账户的划转记录(适用交易团队母账户)(USER_DATA)
投资人账户查询托管子账户期货资产 (适用投资人母账户) (USER_DATA)
投资人账户查询托管子账户杠杆资产 (适用投资人母账户) (USER_DATA)
查询子账户资产(适用主账户)(USER_DATA)
查询托管子账户列表 (适用投资人母账户)(USER_DATA)
查询子账户交易量统计列表 (适用母账户)(USER_DATA)
获取托管子账户充值地址 (适用投资人母账户)(USER_DATA)
为子账户开通期权(适用主账户)(USER_DATA)
查询托管子账户的划转记录(适用交易团队子账户)(USER_DATA)
行情接口
测试服务器连通性
获取服务器时间
交易规范信息
深度信息
近期成交列表
查询历史成交
近期成交(归集)
K线数据
当前平均价格
UIK线数据
24hr 价格变动情况
交易日行情(Ticker)
最新价格
当前最优挂单
滚动窗口价格变动统计
Websocket 行情推送
实时订阅/取消数据流
归集交易流
逐笔交易
K线 Streams
按 Symbol 的精简Ticker
全市场所有Symbol的精简Ticker
按Symbol的完整Ticker
全市场所有交易对的完整Ticker
按Symbol的最优挂单信息
平均价格
有限档深度信息
增量深度信息
按Symbol的滚动窗口统计
全市场滚动窗口统计
如何正确在本地维护一个orderbook副本
现货交易接口
测试下单 (TRADE)
下单 (TRADE)
撤销订单 (TRADE)
撤销单一交易对的所有挂单 (TRADE)
撤消挂单再下单 (TRADE)
查询订单 (USER_DATA)
当前挂单 (USER_DATA)
查询所有订单 (USER_DATA)
OCO下单(TRADE)
取消 OCO 订单(TRADE)
查询 OCO (USER_DATA)
查询所有 OCO (USER_DATA)
查询 OCO 挂单 (USER_DATA)
下 SOR 订单 (TRADE)
测试 SOR 下单接口 (TRADE)
现货账户接口
账户信息 (USER_DATA)
账户成交历史 (USER_DATA)
查询目前下单数 (TRADE)
获取 Prevented Matches (USER_DATA)
查询分配结果 (USER_DATA)
查询佣金费率 (USER_DATA)
杠杆账户和交易接口
杠杆账户借贷/还款(MARGIN)
查询借贷/还款记录(USER_DATA)
获取所有杠杆资产信息 (MARKET_DATA)
获取所有全仓杠杆交易对(MARKET_DATA)
查询杠杆价格指数 (MARKET_DATA)
杠杆账户下单 (TRADE)
杠杆账户撤销订单 (TRADE)
杠杆账户撤销单一交易对的所有挂单 (TRADE)
调整全仓最大杠杆 (USER_DATA)
获取全仓杠杆划转历史 (USER_DATA)
获取利息历史 (USER_DATA)
获取账户强制平仓记录(USER_DATA)
查询全仓杠杆账户详情 (USER_DATA)
查询杠杆账户订单 (USER_DATA)
查询杠杆账户挂单记录 (USER_DATA)
查询杠杆账户的所有订单 (USER_DATA)
杠杆账户 OCO 下单(TRADE)
取消杠杆账户 OCO 订单(TRADE)
查询杠杆账户 OCO (USER_DATA)
查询特定杠杆账户所有 OCO (USER_DATA)
查询杠杆账户 OCO 挂单 (USER_DATA)
查询杠杆账户交易历史 (USER_DATA)
查询账户最大可借贷额度(USER_DATA)
查询最大可转出额 (USER_DATA)
查询Margin账户信息汇总 (USER_DATA)
查询杠杆逐仓账户信息 (USER_DATA)
杠杆逐仓账户停用 (TRADE)
杠杆逐仓账户启用 (TRADE)
查询杠杆逐仓账户启用限制 (USER_DATA)
获取所有逐仓杠杆交易对(USER_DATA)
现货交易和杠杆利息BNB抵扣开关(USER_DATA)
获取BNB抵扣开关状态 (USER_DATA)
获取杠杆利率历史 (USER_DATA)
获取全仓杠杆利率及限额 (USER_DATA)
获取逐仓杠杆利率及限额 (USER_DATA)
获取逐仓档位信息 (USER_DATA)
查询目前杠杆账户下单数 (TRADE)
全仓币种质押率 (MARKET_DATA)
查询可小额负债转换的资产 (USER_DATA)
全仓杠杆小额负债转换 (MARGIN)
查询全仓杠杆小额负债转换历史 (USER_DATA)
查询下小时预估利率 (USER_DATA)
查询全仓/逐仓资金流水(USER_DATA)
查询全仓和逐仓的币种或币对的下架计划 (MARKET_DATA)
杠杆可用放贷库存查询(USER_DATA)
杠杆手动强平(MARGIN)
查询全仓杠杆Pro模式下的负债币种杠杆与保证金率(MARKET_DATA)
Websocket账户信息推送
Listen Key(现货账户)
Listen Key(杠杆账户)
Listen Key(逐仓杠杆账户)
Payload: 账户更新
Payload: 余额更新
Payload: 订单更新
Margin账户信息推送
Listen Key
Payload: 负债变化事件
Payload: Margin Call事件
赚币接口
查询赚币活期产品列表 (USER_DATA)
查询赚币定期产品列表(USER_DATA)
申购活期产品 (TRADE)
申购定期产品(TRADE)
赎回活期产品 (TRADE)
赎回定期产品(TRADE)
获取活期产品持仓(USER_DATA)
获取定期产品持仓 (USER_DATA)
赚币账户(USER_DATA)
查询活期申购记录(USER_DATA)
查询定期申购记录 (USER_DATA)
查询活期赎回记录 (USER_DATA)
查询定期赎回记录 (USER_DATA)
查询活期收益记录 (USER_DATA)
查询定期收益记录 (USER_DATA)
设置活期自动申购 (USER_DATA)
设置定期自动申购 (USER_DATA)
查询活期个人剩余额度 (USER_DATA)
查询定期个人剩余额度 (USER_DATA)
活期申购预览(USER_DATA)
定期申购预览(USER_DATA)
获取利率历史(USER_DATA)
获取抵押物记录(USER_DATA)
双币投资接口
获得双币产品列表(USER_DATA)
申购双币产品(USER_DATA)
获得双币产品持仓状态(USER_DATA)
查询双币产品账户(USER_DATA)
改变自动复投状态(USER_DATA)
定投接口
查询允许申购币种列表 (USER_DATA)
查询申购币种投资回报率(USER_DATA)
查询申购币种和投资币种列表(USER_DATA)
查询投资币种列表(USER_DATA)
创建定投计划 (TRADE)
编辑定投计划 (TRADE)
定投计划状态管理 (TRADE)
查询定投计划列表 (USER_DATA)
查询定投计划详情 (USER_DATA)
查询申购历史 (USER_DATA)
查询指数信息(USER_DATA)
查询指数关连计划详情（USER_DATA）
单次申购(TRADE)
单次申购交易结果查询(USER_DATA)
指数关连计划赎回交易(TRADE)
指数关连计划赎回交易历史查询(USER_DATA)
指数关连计划调仓历史记录(USER_DATA)
Staking 接口
质押 ETH (TRADE)
质押 ETH V2(TRADE)
赎回 ETH (TRADE)
查询 ETH 质押记录 (USER_DATA)
查询 ETH 赎回记录 (USER_DATA)
查询 BETH 质押收益记录 (USER_DATA)
查询当前 ETH 质押限额 (USER_DATA)
查询 WBETH 汇率历史 (USER_DATA)
ETH 质押账户(USER_DATA)
ETH 质押账户V2(USER_DATA)
封装 BETH(TRADE)
查询 WBETH 封装记录 (USER_DATA)
查询WBETH去封装记录(USER_DATA)
查询WBETH去封装记录(USER_DATA)
矿池接口
获取算法(MARKET_DATA)
获取币种(MARKET_DATA)
请求矿工列表明细 (USER_DATA)
请求矿工列表 (USER_DATA)
收益列表 (USER_DATA)
其他收益列表 (USER_DATA)
算力转让详情列表 (USER_DATA)
算力转让列表 (USER_DATA)
算力转让详情 (USER_DATA)
算力转让请求 (USER_DATA)
取消算力转让设置 (USER_DATA)
统计列表 (USER_DATA)
账号列表 (USER_DATA)
矿池账户收益列表 (USER_DATA)
合约接口
合约资金划转 (USER_DATA)
获取合约资金划转历史 (USER_DATA)
获取合约订单薄历史数据下载地址(USER_DATA)
合约策略交易接口
成交量份额参与算法(VP)下单 (TRADE)
时间加权平均价格策略(Twap)下单 (TRADE)
取消策略订单 (TRADE)
查询当前策略订单挂单 (USER_DATA)
查询历史策略订单 (USER_DATA)
查询执行子订单 (USER_DATA)
现货策略交易接口
时间加权平均价格策略(Twap)下单 (TRADE)
取消TWAP策略订单 (TRADE)
查询当前策略订单挂单 (USER_DATA)
查询历史策略订单 (USER_DATA)
查询执行子订单 (USER_DATA)
经典统一账户接口
查询经典统一账户信息 (USER_DATA)
经典统一账户资产质押率 (MARKET_DATA)
查询经典统一账户穿仓借贷金额 (USER_DATA)
偿还经典统一账户穿仓负债
查询经典统一账户期货负余额收息历史(USER_DATA)
查询统一账户资产价格指数(MARKET_DATA)
资金归集(USER_DATA)
特定资产资金归集(USER_DATA)
BNB划转(USER_DATA)
更改自动清还合约负余额模式(TRADE)
查询自动清还合约负余额模式(USER_DATA)
清还合约负余额(USER_DATA)
查询统一账户资产支持杠杆倍数(USER_DATA)
杠杆代币接口
杠杆代币信息 (MARKET_DATA)
杠杆代币历史净值K线
申购代币 (USER_DATA)
查询申购记录 (USER_DATA)
赎回代币 (USER_DATA)
查询赎回记录 (USER_DATA)
查询用户每日申购赎回限额 (USER_DATA)
Websocket 杠杆代币信息更新
Websocket 杠杆代币净值K线更新
法币接口
获取法币充值/提现历史记录 (USER_DATA)
获取法币支付历史记录 (USER_DATA)
C2C 接口
获取 C2C 交易历史记录 (USER_DATA)
VIP借币接口
查询VIP借币借款中订单 (USER_DATA)
VIP借币还款 (TRADE)
查询VIP借币还款记录历史 (USER_DATA)
VIP 借币续期 (TRADE)
查询VIP子账户冻结抵押物金额 (USER_DATA)
VIP 借币借款 (TRADE)
查询VIP借币可借币种数据(USER_DATA)
查询VIP借币抵押币种数据（USER_DATA）
查询申请状态（USER_DATA）
查询借款利率（USER_DATA）
质押借币接口
获取质押借币资金流水 (USER_DATA)
借币 - 质押借币借贷 (TRADE)
借币 - 查询质押借币历史记录 (USER_DATA)
借币 - 查询借款中订单列表 (USER_DATA)
还款 - 质押借币还款 (TRADE)
还款 - 查询还款记录历史 (USER_DATA)
调整质押率 - 质押借币调整质押率 (TRADE)
调整质押率 - 查询质押率调整历史 (USER_DATA)
查询可借币种数据 (USER_DATA)
查询抵押币种数据 (USER_DATA)
查询抵押币种还款汇率 (USER_DATA)
质押借币自定义补仓质押率 (TRADE)
借币 - 活期借币借贷 (TRADE)
借币 - 查询活期借款中订单列表 (USER_DATA)
借币 - 查询活期借币历史记录 (USER_DATA)
还款 - 活期借币还款 (TRADE)
还款 - 查询活期借币还款记录历史 (USER_DATA)
调整质押率 - 活期借币调整质押率 (TRADE)
调整质押率 - 查询活期借币质押率调整历史
查询活期借币可借币种数据 (USER_DATA)
查询活期借币抵押币种数据 (USER_DATA)
Pay 接口
获取 Pay 交易历史记录 (USER_DATA)
闪兑接口
查询可交易币对信息
查询可交易币种精度 (USER_DATA)
发送获取报价请求 (USER_DATA)
接受报价 (TRADE)
查询订单状态 (USER_DATA)
创建闪兑限价单(USER_DATA)
取消闪兑限价单 (USER_DATA)
查询闪兑限价单 (USER_DATA)
获取闪兑交易记录 (USER_DATA)
返佣接口
获取现货返佣历史记录 (USER_DATA)
NFT 接口
获取 NFT 资金流水记录 (USER_DATA)
获取 NFT 充值记录 (USER_DATA)
获取 NFT 提现记录 (USER_DATA)
获取 NFT 资产 (USER_DATA)
币安礼品卡接口
创建单币种礼品卡 (USER_DATA)
创建双币种礼品卡（固定价值，设置折扣） (TRADE)
兑现币安礼品卡 (USER_DATA)
通过礼品卡卡号验证币安礼品卡 (USER_DATA)
获取RSA Public Key (USER_DATA)
获取货币使用限制 (USER_DATA)
错误代码
10xx -常规服务器或网络问题
11xx - 2xxx Request issues
3xxx-5xxx SAPI 具体问题
6XXX - 币安宝相关
70xx - 期货
20xxx - 合约/现货策略交易
过滤器故障
10xxx - 质押借币
13xxx - 杠杆代币
12xxx - 流动性挖矿
18xxx - 币安码
21xxx - 統一帳戶
订单拒绝错误
关于 POST /api/v3/order/cancelReplace 的错误
备注说明
请求参数
Binance Exchange
更新日志
2024-02-28
将于 2024 年 3 月 5 日生效。
简单二进制编码 (SBE) 将部署到现货的 Rest API 和 WebSocket API 生产系统上。
更多关于SBE的信息, 请参考常见问题解答 (FAQ)。
2024-02-27
根据币安借币（浮动利率）的最新升级 ，
币安借币已于 2024-02-27 08:00 (UTC) 添加以下 /v2 SAPI 接口。用户可以使用 v2 SAPI 接口来下单、还款和管理 2024-02-27 08:00 (UTC) 之后创建的 币安借币（浮动利率 新版）订单。
POST /sapi/v2/loan/flexible/borrow
GET /sapi/v2/loan/flexible/ongoing/orders
GET /sapi/v2/loan/flexible/borrow/history
POST /sapi/v2/loan/flexible/repay
GET /sapi/v2/loan/flexible/repay/history
POST /sapi/v2/loan/flexible/adjust/ltv
GET /sapi/v2/loan/flexible/ltv/adjustment/history
GET /sapi/v2/loan/flexible/loanable/data
GET /sapi/v2/loan/flexible/collateral/data
此外，币安借币将在以下时间停止维护 /v1 SAPI 接口：
在2024-02-27 08:00 (UTC):
POST /sapi/v1/loan/flexible/borrow
GET /sapi/v1/loan/flexible/loanable/data
GET /sapi/v1/loan/flexible/collateral/data
在2024-04-24 03:00 (UTC):
GET /sapi/v1/loan/flexible/ongoing/orders
POST /sapi/v1/loan/flexible/repay
POST /sapi/v1/loan/flexible/adjust/ltv
币安借币还将继续维护以下 /v1 SAPI 接口，以便用户查看在 2024-02-27 08:00 (UTC) 之前浮动利率的订单历史。
GET /sapi/v1/loan/flexible/borrow/history
GET /sapi/v1/loan/flexible/repay/history
GET /sapi/v1/loan/flexible/ltv/adjustment/history
2024-02-23
新增双币投资接口:
GET /sapi/v1/dci/product/list: 获得双币产品列表
POST /sapi/v1/dci/product/subscribe: 申购双币产品
GET /sapi/v1/dci/product/positions: 获得双币产品持仓状态
GET /sapi/v1/dci/product/accounts: 查询双币产品账户
POST /sapi/v1/dci/product/auto_compound/edit-status: 改变自动复投状态
2024-02-08
现货的 WebSocket API 现在在测试网上支持简单二进制编码(SBE)。
SBE 模式已经更新了 WebSocket API 元数据，但并没有增加 schemaId 或者 version。
仅在 REST API 上使用 SBE 的用户可以继续使用 SBE 模式 128b94b2591944a536ae427626b795000100cf1d，或者更新到新提交的 SBE 模式。
希望在 WebSocket API 上使用 SBE 的用户，需要更新到最新的 SBE 模式。
SBE 的 FAQ 已经更新。
2024-01-24
新增闪兑接口:
POST /sapi/v1/convert/limit/placeOrder：创建闪兑限价单
POST /sapi/v1/convert/limit/cancelOrder：取消闪兑限价单
GET /sapi/v1/convert/limit/queryOpenOrders：查询闪兑限价单
2024-01-19
根据公告，币安理财将于2024年1月26日12:00（东八区时间）下架以下币安挖矿口:
GET /sapi/v1/bswap/pools
GET /sapi/v1/bswap/liquidity
POST /sapi/v1/bswap/liquidityAdd
POST /sapi/v1/bswap/liquidityRemove
GET /sapi/v1/bswap/liquidityOps
GET /sapi/v1/bswap/quote
POST /sapi/v1/bswap/swap
GET /sapi/v1/bswap/swap
GET /sapi/v1/bswap/poolConfigure
GET /sapi/v1/bswap/addLiquidityPreview
GET /sapi/v1/bswap/removeLiquidityPreview
GET /sapi/v1/bswap/unclaimedRewards
POST /sapi/v1/bswap/claimRewards
GET /sapi/v1/bswap/claimedHistory
wss://api.binance.com/sapi/wss 对于Bswap数据流 earn_swapprice_
根据公告，币安理财将于2024年1月26日12:00（东八区时间）下架以下Staking SAPI接口:
GET /sapi/v1/staking/productList
POST /sapi/v1/staking/purchase
POST /sapi/v1/staking/redeem
GET /sapi/v1/staking/position
GET /sapi/v1/staking/stakingRecord
POST /sapi/v1/staking/setAutoStaking
GET /sapi/v1/staking/personalLeftQuota
2024-01-15
新增钱包接口:
GET /sapi/v1/spot/delist-schedule：查询现货币对的下架计划
更新钱包接口:
GET /sapi/v1/asset/dribblet：增加参数accountType
POST /sapi/v1/asset/dust-btc：增加参数accountType
POST /sapi/v1/asset/dust：增加参数accountType
2024-01-09
根据公告，币安杠杆将于2024年03月31日12:00（东八区时间）下架以下SAPI接口，请及时更换为对应替代接口:
将下架POST /sapi/v1/margin/transfer，应替换为POST /sapi/v1/asset/transfer万能划转
将下架POST /sapi/v1/margin/isolated/transfer，应替换为POST /sapi/v1/asset/transfer万能划转
将下架POST /sapi/v1/margin/loan，应替换为POST /sapi/v1/margin/borrow-repay借还款接口（新增）
将下架POST /sapi/v1/margin/repay，应替换为POST /sapi/v1/margin/borrow-repay借还款接口（新增）
将下架GET /sapi/v1/margin/isolated/transfer，应替换为GET /sapi/v1/margin/transfer获取全仓杠杆划转历史
将下架GET /sapi/v1/margin/asset，应替换为GET /sapi/v1/margin/allAssets
将下架GET /sapi/v1/margin/pair，应替换为GET /sapi/v1/margin/allPairs
将下架GET /sapi/v1/margin/isolated/pair，应替换为GET /sapi/v1/margin/isolated/allPairs
将下架GET /sapi/v1/margin/loan，应替换为GET /sapi/v1/margin/borrow-repay
将下架GET /sapi/v1/margin/repay，应替换为GET /sapi/v1/margin/borrow-repay
将下架GET /sapi/v1/margin/dribblet，应替换为GET /sapi/v1/asset/dribblet
将下架GET /sapi/v1/margin/dust，应替换为POST /sapi/v1/asset/dust-btc
将下架POST /sapi/v1/margin/dust，应替换为POST /sapi/v1/asset/dust
新增杠杆交易接口:
POST /sapi/v1/margin/borrow-repay：杠杆账户借贷/还款
GET /sapi/v1/margin/borrow-repay：查询借贷/还款记录
更新3个杠杆交易接口:
GET /sapi/v1/margin/transfer：新增参数 isolatedSymbol，新增响应信息
GET /sapi/v1/margin/allAssets：新增参数asset，新增响应信息
GET /sapi/v1/margin/allPairs：新增参数symbol
GET /sapi/v1/margin/isolated/allPairs：新增参数symbol
2023-12-22
更新staking接口:
GET /sapi/v1/eth-staking/eth/history/wbethRewardsHistory: 新增接口以查询WBETH收益记录
POST /sapi/v2/eth-staking/eth/stake: 新增接口质押ETH获得WBETH。 现有v1接口POST /sapi/v1/eth-staking/eth/stake 将被弃用, 具体时间待定
GET /sapi/v2/eth-staking/account: 新增接口查询已质押ETH的对应持仓和30天收益。现有v1接口GET /sapi/v1/eth-staking/account 将被弃用, 具体时间待定
POST /sapi/v1/eth-staking/wbeth/unwrap: 移除本接口。POST /sapi/v1/eth-staking/eth/redeem已经支持相同功能
POST /sapi/v1/eth-staking/eth/redeem: 新增入参asset, 新增返回字段ethAmount, conversionRatio。
GET /sapi/v1/eth-staking/eth/history/stakingHistory: 新增返回字段 distributeAsset, distributeAmount, conversionRatio
GET /sapi/v1/eth-staking/eth/history/redemptionHistory 新增返回字段asset, distributeAsset, distributeAmount, conversionRatio
POST /sapi/v1/eth-staking/wbeth/wrap: 新增返回字段wbethAmount, exchangeRate
新增杠杆交易Websocket：
新的base url为wss://margin-stream.binance.com，推送两类事件：负债变化事件和Margin Call事件
2023-12-08
简单二进制编码 (SBE) 已经在现货测试网上线。
生产系统会在随后支持。
更多关于SBE的信息, 请参考常见问题解答 (FAQ)
2023-12-04
注意： 以下的变更将逐步推出，并预计需要大约一周的时间完成。
错误消息 Precision is over the maximum defined for this asset. 被改为 Parameter '%s' has too much precision.
当参数的精度超出允许范围时，将返回此错误消息。例如，如果“基础资产”（base asset）精度为6，但是设置“quantity=0.1234567”，则会出现此错误消息。
这会影响所有具有以下参数的请求:
quantity
quoteOrderQty
icebergQty
limitIcebergQty
stopIcebergQty
price
stopPrice
stopLimitPrice
现在，请求查询OCO开单时会正确返回升序的结果。这会影响以下请求：
REST API: GET /api/v3/openOrderList
现在，当指定startTime或fromId时，请求查询所有 OCO 订单会正确返回升序的结果。这会影响以下请求：
REST API: GET /api/v3/allOrderList
修复了一个错误。订单查询请求不再会对新下的订单错误返回-2026 ORDER_ARCHIVED错误。
REST API: GET /api/v3/order
REST API
新接口 GET /api/v3/account/commission
新接口 GET /api/v3/ticker/tradingDay
GET /api/v3/avgPrice 新加字段 closeTime, 用于显示最后交易时间。
GET /api/v3/klines 和 /api/v3/uiKlines 新加可选参数 timeZone.
POST /api/v3/order/test 和 POST /api/v3/sor/order/test 新加可选参数 computeCommissionRates.
关于发送无效接口的变动：
以前，如果查询一个不存在的端点（例如 curl -X GET "https://api.binance.com/api/v3/exchangie"），你会收到 HTTP 404 状态码，以及响应 "
404 Not found
"。从现在开始，只有当接受请求头中包含text/html时，HTML响应才会出现在这种情况下。HTTP状态码将保持不变。
WebSocket Streams
新数据流
请求中的id现在支持和 WebSocket API 里id一样的值:
64位有符号整数 (之前是无符号整数)
字母数字字符串；最大长度36
null
修复了一个错误，之前在发送 ping 之前未经请求发送的 pongs 会导致断开连接。
User Data Streams
当事件类型为executionReport，而执行类型（x）为TRADE_PREVENTION时，字段l、L和Y现在将始终为0。新增字段pl、pL和pY将描述被阻止执行的数量、被阻止执行的价格和被阻止执行的名义金额。这些新字段显示了如果接收方订单没有启用自成交防止功能时，l、L和Y会是什么值。
以下将在发布日期后大约一周后生效:
交易对权限将仅影响下单，而不影响取消订单。
permissions仍然适用于撤消挂单再下单（Cancel-Replace orders）（比如，如果您的账户有使用此请求下单的权限，则将不允许取消操作）。
2023-11-21
新增钱包接口:
GET /sapi/v1/capital/deposit/address/list: 根据网络币种或币种获取充值地址列表
更新杠杆接口
POST /sapi/v1/margin/order: 参数sideEffectType增加AUTO_BORROW_REPAY选项
POST /sapi/v1/margin/order/oco: 参数sideEffectType增加AUTO_BORROW_REPAY选项
GET /sapi/v1/margin/available-inventory: 响应增加返回参数 updateTime ，表示放贷库存的获取时间
2023-11-17
新增杠杠接口支持全仓Pro模式FAQ:
GET /sapi/v1/margin/leverageBracket: 查询全仓杠杆Pro模式下的负债币种杠杆与保证金率
更新杠杠接口:
POST /sapi/v1/margin/max-leverage: 增加 maxLeverage入参10以支持全仓Pro模式
GET /sapi/v1/margin/account: 新增响应字段accountType, MARGIN_2 以支持全仓Pro模式
2023-11-02
钱包接口更新:
GET /sapi/v1/account/apiRestrictions: 新增相应字段 enablePortfolioMarginTrading
2023-10-19
从 2023-10-19 00:00 UTC 开始生效
调高如下接口的请求权重:
SPOT API
条件
之前的权重
调整后权重
GET /api/v3/trades
N/A
2
10
GET /api/v3/depth
Limit 1-100
2
5
Limit 101-500
10
25
Limit 501-1000
20
50
Limit 1001-5000
100
250
2023-10-16
新增杠杆接口:
GET /sapi/v1/margin/available-inventory: 杠杆可用放贷库存查询
POST /sapi/v1/margin/manual-liquidation: 杠杆手动强平
2023-10-11
新增VIP借币:
GET /sapi/v1/loan/vip/request/interestRate: 查询借币利率
2023-10-03
下单量的退回(Order decrement)功能在 06:15 UTC上线.
此功能的更详细信息, 请参考 FAQ
2023-09-25
新增合约接口:
GET /sapi/v1/futures/histDataLink: 查询订单薄历史数据下载链接
删除合约已下线混合保证金业务接口:
GET /sapi/v1/futures/loan/borrow/history
GET /sapi/v1/futures/loan/repay/history
GET /sapi/v2/futures/loan/wallet
GET /sapi/v1/futures/loan/adjustCollateral/history
GET /sapi/v1/futures/loan/liquidationHistory
GET /sapi/v1/futures/loan/interestHistory
2023-09-22
新增钱包接口：
GET /sapi/v1/asset/wallet/balance: 查询用户钱包余额
GET /sapi/v1/asset/custody/transfer-history: 查询用户委托资金历史(适用主账户)
VIP借币接口改动：
GET /sapi/v1/loan/vip/loanable/data: 新增返回字段_flexibleDailyInterestRate，_flexibleYearlyInterestRate
GET /sapi/v1/loan/vip/ongoing/orders: 新增返回字段loanDate，loanRate，loanTerm，expirationTime
经典统一账户接口更新：
POST /sapi/v1/portfolio/repay: 新增入参from
2023-09-18
新增定投接口：
GET /sapi/v1/lending/auto-invest/index/info: 查询指数信息
GET /sapi/v1/lending/auto-invest/index/user-summary: 查询指数关连计划详情
POST /sapi/v1/lending/auto-invest/one-off: 单次申购
GET /sapi/v1/lending/auto-invest/one-off/status:单次申购交易结果查询
POST /sapi/v1/lending/auto-invest/redeem:指数关连计划赎回交易
GET /sapi/v1/lending/auto-invest/redeem/history:指数关连计划赎回交易历史查询
GET /sapi/v1/lending/auto-invest/rebalance/history: 指数关连计划调仓历史记录
VIP借币接口改动：
新增入参type
移除入参transFrom，transTo
2023-09-14
新增经典统一账户接口：
GET /sapi/v1/portfolio/margin-asset-leverage: 查询统一账户资产支持杠杆倍数
使用下列接口API key权限从允许现货及杠杆交易更改为允许万向划转：
POST /sapi/v1/portfolio/auto-collection
POST /sapi/v1/portfolio/asset-collection
POST /sapi/v1/portfolio/bnb-transfer
2023-09-04
钱包接口限频调整：
GET /sapi/v1/capital/withdraw/history: Weight(UID)调整为18000，每秒最多请求10次。请查看接口描述获得更详细内容
2023-08-31
新增杠杆接口：
/sapi/v1/margin/capital-flow: 查询全仓/逐仓资金流水
2023-08-26
更新赚币接口：
GET /sapi/v1/simple-earn/flexible/history/subscriptionRecord: 在响应中增加字段：sourceAccount，amtFromSpot，amtFromFunding
GET /sapi/v1/simple-earn/locked/history/subscriptionRecord:在响应中增加字段：sourceAccount，amtFromSpot，amtFromFunding
GET /sapi/v1/simple-earn/flexible/history/redemptionRecord:在响应中增加字段：destAccount
POST /sapi/v1/simple-earn/flexible/subscribe: 新增参数sourceAccount
POST /sapi/v1/simple-earn/locked/subscribe: 新增参数sourceAccount
POST /sapi/v1/simple-earn/flexible/redeem: 新增参数destAccount
新增质押借币接口：
POST /sapi/v1/loan/flexible/borrow: 活期借币借贷
GET /sapi/v1/loan/flexible/ongoing/orders: 查询活期借款中订单列表
GET /sapi/v1/loan/flexible/borrow/history: 查询活期借币历史记录
POST /sapi/v1/loan/flexible/repay: 活期借币还款
POST /sapi/v1/loan/flexible/repay/history: 查询活期借币还款记录历史
POST /sapi/v1/loan/flexible/adjust/ltv: 调整活期借币质押率
GET /sapi/v1/loan/flexible/ltv/adjustment/history: 查询活期借币质押率调整历史
GET /sapi/v1/loan/flexible/loanable/data: 查询活期借币可借币种数据
GET /sapi/v1/loan/flexible/collateral/data: 查询活期借币抵押币种数据
2023-08-25
下面的变更会在UTC时间 2023-08-25 00:00 上线
REST API 中的 REQUEST_WEIGHT 调整为每分钟6,000.
REST API 中的 RAW_REQUESTS 调整为每5分钟61,000.
如下现货接口的权重有所调整, 具体细节请参考此表格:
请求接口
之前请求权重
新请求权重
GET /api/v3/order
2
4
GET /api/v3/orderList
2
4
GET /api/v3/openOrders - 带 symbol
3
6
GET /api/v3/openOrders- 不带 symbol
40
80
GET /api/v3/openOrderList
3
6
GET /api/v3/allOrders
10
20
GET /api/v3/allOrderList
10
20
GET /api/v3/myTrades
10
20
GET /api/v3/myAllocations
10
20
GET /api/v3/myPreventedMatches - 使用 preventedMatchId
1
2
GET /api/v3/myPreventedMatches - 使用 orderId
10
20
GET /api/v3/account
10
20
GET /api/v3/rateLimit/order
20
40
GET /api/v3/exchangeInfo
10
20
GET /api/v3/depth - Limit 1-100
1
2
GET /api/v3/depth - Limit 101-500
5
10
GET /api/v3/depth - Limit 501-1000
10
20
GET /api/v3/depth - Limit 1001-5000
50
100
GET /api/v3/aggTrades
1
2
GET /api/v3/trades
1
2
GET /api/v3/historicalTrades
5
10
GET /api/v3/klines
1
2
GET /api/v3/uiKlines
1
2
GET /api/v3/ticker/bookTicker - 带 symbol
1
2
GET /api/v3/ticker/bookTicker - 不带 symbol 或者 带 symbols
2
4
GET /api/v3/ticker/price- 带 symbol
1
2
GET /api/v3/ticker/price- 不带 symbol 或者 带 symbols
2
4
GET /api/v3/ticker/24hr - 带 symbol or 带 symbols 1-20 交易对
1
2
GET /api/v3/ticker/24hr - 带 symbols 21-100 交易对
20
40
GET /api/v3/ticker/24hr - 不带 symbol 或者 symbols 包括101个或者更多交易对
40
80
GET /api/v3/avgPrice
1
2
GET /api/v3/ticker
2
4
GET /api/v3/ticker - 请求的最大权重
100
200
POST /api/v3/userDataStream
1
2
PUT /api/v3/userDataStream
1
2
DELETE /api/v3/userDataStream
1
2
2023-08-18
更新VIP借币接口：
POST /sapi/v1/loan/vip/borrow: 增加参数isFlexibleRate以支持浮动利率借贷
2023-08-08
智能订单路由(Smart Order Routing：SOR）添加到 API 中。您可以在SOR 常见问题文档中找到更多详细信息。 具体上线时间请关注相关公告。
REST API
GET /api/v3/exchangeInfo 变动：
返回数据中添加新字段: sors, 用于描述交易中是否使用了 SOR。
GET /api/v3/myPreventedMatches 变动：
对于所有的 Prevented Matches， 返回数据中添加新字段 makerSymbol 。
为了在下单时使用 SOR 而添加的新接口：
POST /api/v3/sor/order
POST /api/v3/sor/order/test
添加新接口: GET /api/v3/myAllocations
USER DATA STREAM
executionReport 变动：
以下这些字段只适用于下单时使用 SOR 的情况：
新字段 b 代表 matchType
新字段 a 代表 allocId
新字段 k 代表 workingFloor
这个字段只适用于订单因为触发 STP 而将过期的情况：
新字段 Cs 代表 counterSymbol
2023-08-02
自 2023 年 8 月 21 日起，创建礼品卡将增收 1% 的服务费。下列接口受影响：
POST /sapi/v1/giftcard/createCode
POST /sapi/v1/giftcard/buyCode
2023-07-20
根据此公告，自 2023 年 7 月 20 日起，创建功能仅允许已通过 KYB 的企业帐户使用。下列接口受影响：
POST /sapi/v1/giftcard/createCode
POST /sapi/v1/giftcard/buyCode
新增经典统一账户接口：
POST /sapi/v1/portfolio/asset-collection: 特定资产账户资金归集
2023-07-18
现在支持使用 Ed25519 类型的 API key ( UI 会在本周发布更新支持 )
Ed25519 API keys 是 RSA API keys 的替代品，使用非对称加密技术来验证您的 API 请求。
我们建议切换到 Ed25519 以提高性能和安全性。
详情请参考API Key 类型。
文档已更新，包括了有关如何使用 Ed25519 key 对有效载荷进行签名的说明。
2023-07-14
新增经典统一账户接口：
POST /sapi/v1/portfolio/repay-futures-switch: 更改自动清还合约负余额模式
GET /sapi/v1/portfolio/repay-futures-switch: 查询自动清还合约负余额模式
POST /sapi/v1/portfolio/repay-futures-negative-balance: 清还合约负余额
新增VIP借币接口：
POST /sapi/v1/loan/vip/renew: VIP 借币续期
2023-07-11
注意: 所有更改都将逐步推出，可能需要一周时间才能完成。
错误消息的变动:
之前当发送重复交易对时，会返回错误信息: "Mandatory parameter symbols was not sent, was empty/null, or malformed."
现在则返回消息: "Symbol is present multiple times in the list", with a new error code -1151
受影响的接口:
GET /api/v3/exchangeInfo
GET /api/v3/ticker/24hr
GET /api/v3/ticker/price
GET/api/v3/ticker/bookTicker
修复一个bug，当查询没有被存档的订单时候，可能返回错误消息称已经被存档。
GET /api/v3/account 变动：
返回数据中添加新字段 preventSor.
返回数据中添加用户ID的新字段 uid.
GET /api/v3/historicalTrades 变动：
鉴权类型从 MARKET_DATA 变更为 NONE.
不需要设置 X-MBX-APIKEY 到请求的header中.
修改了几个bugs: 当下单时设置 type=MARKET 和 quoteOrderQty, 也被称为“反向市价单”:
当处于极端市场情况下, 订单不会返回部分成交，或者成交的数量为0甚至是负数.
当这种反向市价单的成交数量超过交易对的 maxQty, 订单会因为违反MARKET_LOT_SIZE 过滤器而被拒绝.
修复一个OCO订单的bug: 当使用 trailingDelta 时候, 当任何leg被触发时, trailingTime 值可能不正确.
这些接口的返回数据中添加新字段 transactTime :
DELETE /api/v3/order
POST /api/v3/order/cancelReplace
DELETE /api/v3/openOrders
DELETE /api/v3/orderList
2023-07-07
新增杠杆接口：
POST /sapi/v1/margin/max-leverage: 调整全仓最大杠杆倍数
2023-06-29
Staking接口中新增一系列ETH Staking相关接口
新增杠杆接口：
GET /sapi/v1/margin/dust: 获取可以转换成 BNB 的小额资产列表
POST /sapi/v1/margin/dust: 把小额资产转换成BNB
新增VIP借币接口(2023-06-30生效)：
POST /sapi/v1/loan/vip/borrow: VIP借币借款
GET /sapi/v1/loan/vip/loanable/data: 查询VIP借币可借币种数据
GET /sapi/v1/loan/vip/collateral/data: 查询VIP借币抵押币种数据
GET /sapi/v1/loan/vip/request/data: 查询申请状态
2023-06-22
新增子母账户接口：
POST /sapi/v1/sub-account/eoptions/enable：为子账户开通期权
GET /sapi/v1/managed-subaccount/query-trans-log：查询托管子账户的划转记录(适用交易团队子账户)
更新杠杆接口：
POST /sapi/v1/margin/order：增加参数autoRepayAtCancel和 selfTradePreventionMode
POST /sapi/v1/margin/order/oco: 增加参数 selfTradePreventionMode
新增一系列赚币接口
删除借币接口：
GET /sapi/v1/lending/daily/product/list
GET /sapi/v1/lending/daily/userLeftQuota
POST /sapi/v1/lending/daily/purchase
GET /sapi/v1/lending/daily/userRedemptionQuota
POST /sapi/v1/lending/daily/redeem
GET /sapi/v1/lending/daily/token/position
GET /sapi/v1/lending/union/account
GET /sapi/v1/lending/union/purchaseRecord
GET /sapi/v1/lending/union/redemptionRecord
GET /sapi/v1/lending/union/interestHistory
2023-06-20
新增定投接口：
GET /sapi/v1/lending/auto-invest/target-asset/list：查询定投允许申购的币种列表
GET /sapi/v1/lending/auto-invest/target-asset/roi/list：申购币种投资回报率接口
GET /sapi/v1/lending/auto-invest/all/asset：查询定投申购币种和投资币种列表
GET /sapi/v1/lending/auto-invest/source-asset/list：查询定投投资的币种列表
POST /sapi/v1/lending/auto-invest/plan/add：创建定投计划
POST/sapi/v1/lending/auto-invest/plan/edit：编辑定投计划
POST /sapi/v1/lending/auto-invest/plan/edit-status：计划管理定投状态
GET /sapi/v1/lending/auto-invest/plan/list：查询定投计划列表
GET /sapi/v1/lending/auto-invest/plan/id：查询计划持仓详情
GET /sapi/v1/lending/auto-invest/history/list：查询申购历史
新增杠杆接口：
GET /sapi/v1/margin/delist-schedule：查询全仓和逐仓的币种或币对的下架计划
2023-06-09
以下改动仅对 经典统一账户/统一账户 生效，改动会在2023-06-22发布: 往统一账户的资金划转仅能通过全仓杠杆账户。 对POST /sapi/v1/asset/transfer，经典统一账户/统一账户仅支持以下参数: MAIN_PORTFOLIO_MARGIN 和 PORTFOLIO_MARGIN_MAIN
经典统一账户/统一账户从UM/CM划转到非统一账户将不再支持，对POST /sapi/v1/asset/transfer，经典统一账户/统一账户将不支持以下参数:
MAIN_UMFUTURE
MAIN_CMFUTURE
UMFUTURE_MAIN
UMFUTURE_MARGIN
CMFUTURE_MARGIN
MARGIN_UMFUTURE
MARGIN_CMFUTURE
FUNDING_UMFUTURE
UMFUTURE_FUNDING
FUNDING_CMFUTURE
CMFUTURE_FUNDING
UMFUTURE_OPTION
OPTION_UMFUTURE
POST /sapi/v1/sub-account/futures/internalTransfer 不支持
POST /sapi/v1/sub-account/futures/transfer 不支持
POST /sapi/v1/futures/transfer不支持
POST /sapi/v1/sub-account/universalTransfer不再支持以下划转:
从SPOT划转到USDT_FUTURE, COIN_FUTURE
USDT_FUTURE, COIN_FUTURE划转到SPOT
新增经典统一账户接口(6月9日生效)：
POST /sapi/v1/portfolio/auto-collection：账户资金归集，将除BNB外资产从合约账户划转到杠杆账户
POST /sapi/v1/portfolio/bnb-transfer：BNB在杠杆账户和UM期货账户划转
2023-06-06
为了提供系统的冗余能力，新加一个API接入网址: https://api-gcp.binance.com/
此网址利用了 GCP (Google Cloud Platform) 的CDN，可能在性能上比api1-api4要慢.
2023-06-01
新增挖矿接口WEBSOCKET：
新的base url为 wss://api.binance.com/sapi/wss 对于Bswap数据流 earn_swapprice_
2023-05-30
更新Pay接口：
GET /sapi/v1/pay/transactions：在fundsDetail中增加多个内容
2023-05-26
注意: 所有更改都将逐步推出到我们的所有服务器，并可能需要一周时间才能完成。
以下基本接口可能会提供比 https://api.binance.com 更好的性能但其稳定性略为逊色:
https://api1.binance.com
https://api2.binance.com
https://api3.binance.com
https://api4.binance.com
2023-05-24
以前的市场数据 URL 已不建议使用。请立即更新您的代码，以防止来自我们的服务被中断。
来自 data.binance.com 的 API 市场数据现在可以从 data-api.binance.vision 访问。
来自 data-stream.binance.com 的 Websocket 市场数据现在可以从 data-stream.binance.vision 访问。
GET /sapi/v1/portfolio/interest-rate已被停用，用户可用GET /sapi/v1/margin/interestRateHistory获取利率信息。
2023-05-18
新增钱包接口：
POST /sapi/v1/capital/deposit/credit-apply：申请充值到过期地址的一键上账
2023-05-09
新增统一账户接口：
GET /sapi/v1/portfolio/asset-index-price：查询统一账户资产价格指数
更新钱包接口：
POST /sapi/v1/asset/transfer：增加枚举类型MAIN_PORTFOLIO_MARGIN 和 PORTFOLIO_MARGIN_MAIN
2023-04-20
新增子母账户接口：
GET /sapi/v1/managed-subaccount/deposit/address：支持获取投资人之托管子账户充值地址
更新VIP借币接口：
GET /sapi/v1/loan/vip/ongoing/orders：增加字段totalCollateralValueAfterHaircut 和 lockedCollateralValue
2023-04-18
新增现货策略交易接口：
POST /sapi/v1/algo/spot/newOrderTwap 以支持现货策略下单
DELETE /sapi/v1/algo/spot/order 以支持现货策略委托撤单
GET /sapi/v1/algo/spot/openOrders 以支持查询现货策略当前委托
GET /sapi/v1/algo/spot/historicalOrders 以支持查询现货策略历史订单
GET /sapi/v1/algo/spot/subOrders 以支持查询现货策略子订单
2023-03-23
更新子母账户接口:
GET /sapi/v1/managed-subaccount/queryTransLogForInvestor: 响应出参增加字段tranId
GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent: 响应出参增加字段tranId
添加子母账户接口:
GET /sapi/v1/managed-subaccount/info: 查询托管子账户列表
GET /sapi/v1/sub-account/transaction-statistics: 查询子账户交易量统计列表
2023-03-13
注意: 所有更改都将逐步推出到我们的所有服务器，并可能需要一周时间才能完成。
某些问题的错误消息已经改进，以便更轻松地进行解决。
情况
之前的错误消息
新错误消息
由于交易权限被禁用，账户无法下订单或取消订单。
This action is disabled on this account.
This account may not place or cancel orders.
当配置在交易对上的权限与账户上的权限不匹配时。
This symbol is not permitted for this account.
当账户在其没有权限的交易对上下订单时。
This symbol is restricted for this account.
当 symbol 不在 TRADING 时下订单。
Unsupported order combination.
This order type is not possible in this trading phase.
在不支持 IOC 或 FOK 的交易阶段上使用 timeinForce = IOC 或 FOK 下订单时。
Limit orders require GTC for this phase.
更正了查询归档订单的错误消息：
之前，如果查询了一个归档订单（即状态为 CANCELED 或 EXPIRED，executedQty == 0 而且最后的更新在 90 天以前），错误消息将是：
{"code": -2013,"msg": "Order does not exist."}
现在，错误消息为：
{"code": -2026,"msg": "Order was canceled or expired with no executed qty over 90 days ago and has been archived."}
API 请求使用 startTime 和 endTime 的行为：
之前，如果 startTime == endTime，一些请求会失败。
现在，所有接受 startTime 和 endTime 的 API 请求会允许这些参数相等。这适用于以下接口：
Rest API
GET /api/v3/aggTrades
GET /api/v3/klines
GET /api/v3/allOrderList
GET /api/v3/allOrders
GET /api/v3/myTrades
Websocket API
trades.aggregate
klines
allOrderList
allOrders
myTrades
如果用户的IP地址因违反 IP 速率限制（状态码为 418）而被禁止，那么连接到 WebSocket API 的用户将被断开连接。
虽然以下更改将在发布日期后 大约一周内生效，但是与其相关的文档已经被更改了：
过滤器评估的更改：
之前的行为: LOT_SIZE 和 MARKET_LOT_SIZE 要求 (quantity - minQty) % stepSize == 0.
新行为: 现在已更改为 (quantity % stepSize) == 0。
使用 quoteOrderQty 的 MARKET 订单的错误修复：
之前的行为: 订单的状态将始终为 FILLED，即使订单没有完全成交。
新行为: 如果订单由于流动性不足而没有完全成交，则订单状态将为 EXPIRED，仅当订单完全成交时状态为 FILLED。
现货 API
DELETE /api/v3/order 和 POST /api/v3/order/cancelReplace 的更改:
新的可选参数 cancelRestrictions，该参数用于决定是否能成功取消状态为 NEW 或 PARTIALLY_FILLED的订单。
如果由于 cancelRestrictions 而取消订单失败，错误将是：
{"code": -2011,"msg": "Order was not canceled due to cancel restrictions."}
2023-02-27
新增杠杆接口:
/sapi/v1/margin/next-hourly-interest-rate: 查询用户币种预估下小时利率
新增统一账户接口:
GET /sapi/v1/portfolio/interest-history: 查询统一账户期货负余额收息历史
GET /sapi/v1/portfolio/interest-rate: 查询统一账户期货负余额利率水平
2023-02-21
修改质押借币接口:
POST /sapi/v1/loan/borrow: 参数loanTerm仅可传7或30
2023-02-17
WebSocket频率限制变动
Websocket Stream 现在限制每个IP地址、每5分钟可以发送连接请求的上限是300次。
2023-02-13
添加子母账户接口:
GET /sapi/v4/sub-account/assets: 查询子账户资产
2023-02-02
添加杠杆接口:
GET /sapi/v1/margin/exchange-small-liability: 查询可小额负债转换的资产
POST /sapi/v1/margin/exchange-small-liability: 全仓杠杆小额负债转换
GET /sapi/v1/margin/exchange-small-liability-history: 查询全仓杠杆小额负债转换历史
更新钱包接口:
万能划转POST /sapi/v1/asset/transfer支持期权
2023-01-26
根据此公告，Self-Trade Prevention 将在 2023-01-26 08:00 UTC 发布。
2023-01-23
添加了新的 API 集群 https://api4.binance.com
2023-01-23
实际发布日期待定
新功能：Self-Trade Prevention（STP）会添加到系统中。此功能将阻止订单与来自同一账户或者同一 tradeGroupId 账户的订单交易。
请使用现货 REST API 的 GET /api/v3/exchangeInfo 或 Websocket API 的 exchangeInfo 看 STP 的状态。
现货 API
"defaultSelfTradePreventionMode": "NONE", // selfTradePreventionMode 的默认值
"allowedSelfTradePreventionModes": [ // selfTradePrevention 的可用模式
"NONE",
"EXPIRE_TAKER",
"EXPIRE_BOTH",
"EXPIRE_MAKER"
]
新的订单状态：EXPIRED_IN_MATCH - 订单由于 STP 触发而过期。
新的接口：
GET /api/v3/myPreventedMatches - 获取由于 STP 触发而过期的订单。
新的可选参数 selfTradePreventionMode 已添加到以下的接口：
POST /api/v3/order
POST /api/v3/order/oco
POST /api/v3/order/cancelReplace
如果有预防自我交易(Prevented Match)，所有下单相关的接口会出现新字段：
tradeGroupId - 仅当账户配置为 tradeGroupId 时才会出现。
preventedQuantity - 被防止交易的订单数量。
preventedMatches 数组会有以下的字段：
preventedMatchId
makerOrderId
price
takerPreventedQuantity - 仅当 selfTradePreventionMode 设置为 EXPIRE_TAKER 或 EXPIRE_BOTH 时才会出现。
makerPreventedQuantity - 仅当 selfTradePreventionMode 设置为 EXPIRE_MAKER 或 EXPIRE_BOTH 时才会出现。
如果订单因 STP 触发而过期，以下查询订单接口的响应中可以出现新的字段 preventedMatchId 和 preventedQuantity：
GET /api/v3/order
GET /api/v3/openOrders
GET /api/v3/allOrders
Websocket 账户信息推送
新的执行类型：TRADE_PREVENTION。
executionReport 的新字段（这些字段只会在订单因 STP 触发而过期时出现）：
u - tradeGroupId
v - preventedMatchId
U - counterOrderId
A - preventedQuantity
B - lastPreventedQuantity
2023-01-13
以下接口将于1月 13, 2023 6:00 AM UTC停止使用：
POST /sapi/v1/sub-account/subAccountApi/ipRestriction 以支持母账户为子账户API Key开启或关闭IP白名单
POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList 以支持母账户为子账户API Key添加IP白名单地址列表
添加子母账户接口：
GET /sapi/v1/managed-subaccount/fetch-future-asset: Investor can use this api to query managed sub account futures asset details
GET /sapi/v1/managed-subaccount/marginAsset: Investor can use this api to query managed sub account margin asset details
添加杠杆账户接口：
GET /sapi/v1/margin/crossMarginCollateralRatio: 获取全仓币种质押率信息
2023-01-05
添加子母账户接口:
GET /sapi/v1/managed-subaccount/queryTransLogForInvestor: 投资人可以根据此接口查询其托管子账户划转记录
GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent: 交易团队可以根据此接口查询其托管子账户划转记录
2022-12-26
添加钱包接口：
GET /sapi/v1/capital/contract/convertible-coins: 查询用户充值/提现时候稳定币与 BUSD 互转的设置
POST /sapi/v1/capital/contract/convertible-coins: 修改哪些稳定币可与 BUSD 互相转换
2022-12-15
添加新的RSA签名验证方式
添加了有关于如何创建 RSA keys 的信息。
出于安全原因，我们建议在生成 API key 时使用 RSA keys。
我们接受 PKCS#8（BEGIN PUBLIC KEY）。
稍后将添加有关如何上传 RSA public key 的更多详细信息。
2022-12-13
REST API
错误代码 -1003 的一些错误消息改动：
之前的错误消息:
Too much request weight used; current limit is %s request weight per %s %s. Please use the websocket for live updates to avoid polling the API.
改成了：
Too much request weight used; current limit is %s request weight per %s. Please use WebSocket Streams for live updates to avoid polling the API.
之前的错误消息:
Way too much request weight used; IP banned until %s. Please use the websocket for live updates to avoid bans.
改成了：
Way too much request weight used; IP banned until %s Please use WebSocket Streams for live updates to avoid bans.
2022-12-05
备注： 这些更新正在逐步部署到我们所有的服务器，大约需要一周时间才能完成。
WEBSOCKET
!bookTicker 在 2022-12-07 下线。 请改用按 symbol 的最优挂单信息的数据流（
可以通过一个连接订阅多个
REST API
新的错误代码 -1135
如果参数是无效的 JSON 格式，则会出现此错误代码。
新的错误代码 -1108
如果发送的参数的值太长，可能会导致溢出，则会发生此错误。
此错误代码可能出现在以下接口：
POST /api/v3/order
POST /api/v3/order/cancelReplace
POST /api/v3/order/oco
GET /api/v3/aggTrades 更新
之前的规则: startTime 和 endTime 必须结合使用，并且只能相隔一个小时。
新的规则: startTime 和 endTime 可以单独使用，一个小时的限制已被取消。
仅使用 startTime 时，如果limit的值为N, 将返回从此时间开始的N条交易。
仅使用 endTime 时，如果limit的值为N, 将返回到此时间的N条交易。
如果不提供 limit，无论是组合使用还是单独发送，服务器端点都将使用默认的 limit。
GET /api/v3/myTrades 更新
修复了在不提供 limit 时, symbol + orderId 组合可以返回交易数量超过 limit 默认值500条的错误
之前的行为： API 将根据发送的参数组合发送特定的错误消息。 例如：
{
"code": -1106,
"msg": "Parameter X was sent when not required."
}
新的行为: 如果接口不支持可选参数组合，那么服务器会返回一般性的错误:
{
"code": -1128,
"msg": "Combination of optional parameters invalid."
}
添加一个新的参数组合: symbol + orderId + fromId.
下面的参数组合不再支持:
symbol + fromId + startTime
symbol + fromId + endTime
symbol + fromId + startTime + endTime
当前支持的所有参数组合：
symbol
symbol + orderId
symbol + startTime
symbol + endTime
symbol + fromId
symbol + startTime + endTime
symbol+ orderId + fromId
备注： 这些新字段将在发布日期后大约一周出现。
GET /api/v3/exchangeInfo 更新
新字段 defaultSelfTradePreventionMode 和 allowedSelfTradePreventionModes
下单，查询订单和撤销订单接口的更新:
响应中会出现新的字段 selfTradePreventionMode。
以下接口会受到影响:
POST /api/v3/order
POST /api/v3/order/oco
POST /api/v3/order/cancelReplace
GET /api/v3/order
DELETE /api/v3/order
DELETE /api/v3/orderList
GET /api/v3/account 更新
响应中会出现新的字段 requireSelfTradePrevention.
以下接口的响应中会出现新字段 workingTime（指示订单何时添加到了订单薄）：
POST /api/v3/order
GET /api/v3/order
POST /api/v3/order/cancelReplace
POST /api/v3/order/oco
GET /api/v3/order
GET /api/v3/openOrders
GET /api/v3/allOrders
如果trailingDelta作为参数提供给了TAKE_PROFIT，TAKE_PROFIT_LIMIT，STOP_LOSS或 STOP_LOSS_LIMIT的订单，那么下面接口中会出现trailingTime, 用来表示追踪单被激活和跟踪价格变化的时间:
POST /api/v3/order
GET /api/v3/order
GET /api/v3/openOrders
GET /api/v3/allOrders
POST /api/v3/order/cancelReplace
DELETE /api/v3/order
字段 commissionRates 会在 GET /api/v3/acccount 的响应中出现。
USER DATA STREAM
eventType executionReport 有新的字段
V - selfTradePreventionMode
D - trailing_time (追踪单被激活会出现)
W - workingTime (如果 isWorking=true 会出现)
2022-12-02
新增一个用于访问市场信息的RESTful API URL: https://data.binance.com.
新增一个用于访问市场信息的WebSocket URL: wss://data-stream.binance.com.
2022-11-29
添加VIP借币接口：
GET /sapi/v1/loan/vip/collateral/account: 查询VIP子账户冻结抵押物金额
2022-11-22
新增闪兑接口：
GET /sapi/v1/convert/exchangeInfo: 查询可交易的币对的信息，以及它们分别所支持交易金额的上下限。
GET /sapi/v1/convert/assetInfo: 查询每个可交易币种的精度信息。
POST /sapi/v1/convert/getQuote: 对所需的币对发送获取报价请求。
POST /sapi/v1/convert/acceptQuote: 通过 quote ID 来接受报价。
GET /sapi/v1/convert/orderStatus: 通过 order ID 来查询订单状态。
2022-11-18
新增钱包接口:
GET /sapi/v1/asset/ledger-transfer/cloud-mining/queryByPage: 云算力支付和退款历史分页查询
新增子母账户接口:
POST /sapi/v2/sub-account/subAccountApi/ipRestriction: 为子账户API Key更新IP白名单
2022-11-14
添加VIP借币接口：
GET /sapi/v1/loan/vip/ongoing/orders：查询VIP借币借款中订单
POST /sapi/v1/loan/vip/repay：VIP借币还款
GET /sapi/v1/loan/vip/repay/history：查询VIP借币还款记录历史
2022-11-02
更新钱包接口：
POST /sapi/v1/capital/withdraw/apply： 权重改至 Weight(UID) 600。
2022-11-01
添加质押借币接口：
GET /sapi/v1/loan/loanable/data： 获取可借币种的利率和借贷限额。借入限额以美元价值显示。
GET /sapi/v1/loan/collateral/data： 获取抵押币种质押率信息和质押限额。质押限额以美元价值显示。
GET /sapi/v1/loan/repay/collateral/rate： 获取抵押物还款时，抵押/借贷币种的汇率价格。汇率价格有效时间为8秒。
POST /sapi/v1/loan/customize/margin_call： 质押借币自定义补仓质押率，仅可针对进行中订单，自定义补仓质押率。
2022-10-28
更新钱包接口：
POST /sapi/v1/asset/convert-transfer: 增加 accountType 参数
POST /sapi/v1/asset/convert-transfer/queryByPage: 改为 GET 请求方式，增加 clientTranId 参数
2022-10-15
添加币安码接口：
POST /sapi/v1/giftcard/buyCode：用于购买一个币安码
GET /sapi/v1/giftcard/buyCode/token-limit：用来查看你所支付的数字货币，可以购买的面额与数量限制
2022-09-30
删除合约混合保证金接口：
POST /sapi/v1/futures/loan/borrow
POST /sapi/v1/futures/loan/repay
GET /sapi/v1/futures/loan/configs
GET /sapi/v2/futures/loan/configs
GET /sapi/v1/futures/loan/calcAdjustLevel
GET /sapi/v2/futures/loan/calcAdjustLevel
GET /sapi/v1/futures/loan/calcMaxAdjustAmount
GET /sapi/v2/futures/loan/calcMaxAdjustAmount
POST /sapi/v1/futures/loan/adjustCollateral
POST /sapi/v2/futures/loan/adjustCollateral
GET /sapi/v1/futures/loan/collateralRepayLimit
GET /sapi/v1/futures/loan/collateralRepay
POST /sapi/v1/futures/loan/collateralRepay
GET /sapi/v1/futures/loan/collateralRepayResult
2022-09-30
!bookTicker的WebSocket推送的变更.
全市场最优挂单信息推送(!bookTicker)计划在2022年11月下线, 具体下线的时间会在后面通告.
请使用按Symbol的最优挂单信息推送(
多个
比如 wss://stream.binance.com:9443/stream?streams=btcusdt@bookTicker/bnbbtc@bookTicker
2022-09-29
添加钱包接口：
POST /sapi/v1/asset/convert-transfer: 稳定币自动兑换划转
POST /sapi/v1/asset/convert-transfer/queryByPage: 稳定币自动兑换划转查询
2022-09-22
更新子母账户接口：
POST /sapi/v1/sub-account/subAccountApi/ipRestriction：添加一个新的参数 thirdParty
POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList：添加一个新的参数 thirdPartyName
DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList：添加一个新的参数 thirdPartyName
添加频次限制：
GET /sapi/v1/bswap/liquidity：每个账户每个池子最多每秒三次
GET /sapi/v1/bswap/quote：每个账户每个池子最多每秒三次
POST /sapi/v1/lending/daily/purchase：每个账户最多三秒一次
POST /sapi/v1/lending/customizedFixed/purchase：每个账户最多三秒一次
POST /sapi/v1/staking/purchase：每个账户最多三秒一次
2022-09-16
添加杠杆账户接口：
GET /sapi/v1/margin/tradeCoeff：获取用户个人杠杆账户信息汇总
2022-09-15
添加质押借币接口：
POST /sapi/v1/loan/borrow：借币 - 质押借币借贷
GET /sapi/v1/loan/borrow/history：借币 - 查询质押借币历史记录
GET/sapi/v1/loan/ongoing/orders：借币 - 查询借款中订单列表
POST/sapi/v1/loan/repay：还款 - 质押借币还款
GET/sapi/v1/loan/repay/history：还款 - 查询还款记录历史
POST/sapi/v1/loan/adjust/ltv：调整质押率 - 质押借币调整质押率
GET/sapi/v1/loan/ltv/adjustment/history：调整质押率 - 查询质押率调整历史
2022-09-15
这些变动会是滚动发布，可能需要几天才会部署到所有服务器.
接口 GET /api/v3/exchangeInfo 的变动
添加一个新的参数 permissions , 用于查询适用于相应权限的所有交易对.
如果查询时不提供此参数, 则默认值是 ["SPOT","MARGIN","LEVERAGED"].
这表示如果请求 GET /api/v3/exchangeInfo 时候没有任何参数, 则会返回拥有权限是 SPOT, MARGIN, LEVERAGED 的交易对.
如果要查询其他交易权限, 比如TRD_GRP_004等, 需要在查询参数里设置(比如permissions=TRD_GRP_004).
此参数不可以同时和 symbol 或者 symbols 使用.
2022-09-12
更新子母账户接口：
GET /sapi/v1/sub-account/subAccountApi/ipRestriction：
以支持母账户为子账户API Key查询三方IP白名单
2022-09-05
删除期货接口：
GET /sapi/v1/futures/loan/wallet
2022-08-23
这些变动会是滚动发布，可能需要几天才会部署到所有服务器.
接口 GET /api/v3/ticker 与 GET /api/v3/ticker/24hr 变动
添加新可选参数 type
type 可接受的参数值有 FULL 与 MINI
FULL 是默认值， 也是原来接口所返回的响应
MINI 省略了以下字段: priceChangePercent, weightedAvgPrice, bidPrice, bidQty, askPrice, askQty 与 lastQty
添加新错误代码 -1008
每当服务器的请求超载时都会发送此消息
此错误代码只会在 SPOT API 里出现
接口 GET /api/v3/account 添加新参数 brokered
添加新接口: GET /api/v3/uiKlines
添加新k线间隔: 1s
2022-08-18
更新闪兑接口：
GET /sapi/v1/convert/tradeFlow: 权重自 Weight(IP) 3000改至 Weight(UID) 3000。
2022-08-08
REST API
接口 POST /api/v3/order 与 POST /api/v3/order/cancelReplace 变动
添加新可选参数 strategyId 是用于将订单标识为某策略的参数。
添加新可选参数 strategyType 是用于标识在执行的策略。(例如：如果所有订单属于现货网格策略，订单可设置为strategyType=1000000)
接口 POST /api/v3/order/oco 变动
添加新可选参数 limitStrategyId, limitStrategyType, stopStrategyId, stopStrategyType
这些是OCO订单里两个leg的策略元数据
limitStrategyType 和 stopStrategyType 都不能低于 1000000
接口 GET /api/v3/order, GET /api/v3/openOrders 与 GET /api/v3/allOrders 变动
新增参数 strategyId 与 strategyType 必须在下单时填上字段才会在回应JSON里返回
接口 DELETE /api/v3/order 与 DELETE /api/v3/openOrders 变动
新增参数 strategyId 与 strategyType 必须在下单时填上字段才会在回应JSON里返回
USER DATA STREAM
eventType executionReport 新增参数
j 代表 strategyId
J 代表 strategyType
必须在下单时填上字段才会在回应里返回
2022-08-05
更新闪兑接口：
GET /sapi/v1/convert/tradeFlow: 权重自 Weight(IP) 100改至 Weight(IP) 3000。
2022-07-21
添加新统一账户接口：
GET /sapi/v1/portfolio/pmLoan 查询统一账户穿仓借贷记录。
POST /sapi/v1/portfolio/repay 偿还统一账户穿仓负债。
2022-07-18
添加新统一账户接口：
GET /sapi/v1/portfolio/collateralRate 获取统一账户资产质押率。
2022-07-01
添加新钱包接口：
POST /sapi/v3/asset/getUserAsset 获取用户持仓。
添加新杠杆账户接口：
GET /sapi/v1/margin/dribblet 查询用户杠杆账户小额资产转换BNB历史信息。
更新闪兑接口：
GET /sapi/v1/convert/tradeFlow：权重自3000改至100。
更新杠杆账户接口：
GET /sapi/v1/margin/repay： 响应出参增加字段rawAsset，表示原始币种。
2022-06-20
接口 GET /api/v3/ticker 变动
权重从每symbol 5 降低到 2.
每次请求最多可以有100个交易对.
如果symbols请求超过100个交易对, 会收到如下错误信息:
{
"code": -1101,
"msg": "Too many values sent for parameter 'symbols', maximum allowed up to 100."
}
单请求的权重上限为100.
比如，如果请求的交易对超过50个，请求的权重是100.
2022-06-15
注意: 此变动不会立刻可用, 会在后面几天上线。
SPOT API
添加新接口 GET /api/v3/ticker
基于 windowSize 返回最近的价格变动。
无需像 GET /api/v3/ticker/24hr 提供symbols参数。
如果不提供 windowSize 参数，默认值是1d。
响应和 GET /api/v3/ticker/24hr 相似，但不包括以下数据：prevClosePrice, lastQty, bidPrice, bidQty, askPrice, askQty
添加新接口 POST /api/v3/order/cancelReplace
撤消当前的挂单并在同样的交易对上下新订单。
过滤器会在撤单前做判断。
例如，MAX_NUM_ORDERS 是 10，如果目前挂单也是10，调用 POST /api/v3/order/cancelReplace会失败。撤单与下单的操作都不会被执行。
更新将在几天后上线，升级完毕后才会开启此功能。
GET /api/v3/exchangeInfo 在symbols列表里返回新数据cancelReplaceAllowed。
添加新的过滤器 NOTIONAL
基于minNotional 与 maxNotional 值来限制名义价值 (price * quantity)
添加新的过滤器 EXCHANGE_MAX_NUM_ICEBERG_ORDERS
账号最大冰山挂单数
WEBSOCKETS
新的symbol ticker流, 可以选择1h 或者 4h时间窗口：
单个交易对:
市场所有交易对: !ticker_
2022-06-02
更新子母账户接口:
GET /sapi/v1/sub-account/sub/transfer/history：fromEmail及toEmail可以是母账户email。
2022-05-27
更新法币接口：
GET /sapi/v1/fiat/orders： 权重自 UID(3000) 改至 UID(90000)
更新Pay接口：
GET /sapi/v1/pay/transactions：参数
名称改变： startTimestamp -> startTime； endTimestamp -> endTime
2022-05-26
更新法币接口：
GET /sapi/v1/fiat/orders： 权重自 IP(1) 改至 UID(3000)
更新杠杆账户接口： 查询时间范围最大不得超过30天：
GET /sapi/v1/margin/transfer
GET /sapi/v1/margin/loan
GET /sapi/v1/margin/repay
GET /sapi/v1/margin/isolated/transfer
GET /sapi/v1/margin/interestHistory
2022-05-23
Order Book 深度的变动
之前深度的数量在一些极端情况下会出现负数.
之后深度数量不会溢出, 而是限制在64位的最大值, 这表示深度的数量达到，或者超过了最大值. 最大值和交易对的base asset的精度有关. 比如如果精度是8位小数，最大值则为92,233,720,368.54775807.
原有的深度价位, 在修复上线后, 需要价位上有变动, 才能体现新的修复.
哪里有影响?
现货深度接口
GET /api/v3/depth
Websocket Streams
MAX_POSITION 的更新
如果一个订单的数量(quantity) 可能导致持有仓位溢出, 会触发过滤器 MAX_POSITION.
2022-05-19
更新矿池接口參數:
GET /sapi/v1/mining/pub/algoList 及 GET /sapi/v1/mining/pub/coinList：不需要参数
新增统一帐户相关错误代码（21xxx）： -21001, -21002, -21003
2022-05-17
GET api/v3/aggTrades 更新
如果同时提供 startTime 和 endTime, 旧的记录会返回.
如果接口 GET /api/v3/myTrades 中没有提供参数 symbol, 错误消息变为:
{
"code": -1102,
"msg": "Mandatory parameter 'symbol' was not sent, was empty/null, or malformed."
}
下面的接口提供参数 symbols 用于查询多个symbol.
GET /api/v3/ticker/24hr
GET /api/v3/ticker/price
GET /api/v3/ticker/bookTicker
上面接口的权重取决于请求 symbols 的数量, 具体请看下面的列表:
接口
Symbols的数量
权重
GET /api/v3/ticker/price
Any
2
GET /api/v3/ticker/bookTicker
Any
2
GET /api/v3/ticker/24hr
1-20
1
GET /api/v3/ticker/24hr
21-100
20
GET /api/v3/ticker/24hr
>= 101
40
2022-05-05
新增Binance Code接口:
GET /sapi/v1/giftcard/cryptography/rsa-public-key，以查询RSA public key。
更新Binance Code接口:
POST /sapi/v1/giftcard/redeemCode: 新增参数 externalUid。每个外部用户 ID 代表合作伙伴平台上的某个用户。该功能帮助您识别不同用户的兑现行为。
2022-04-28
新增Staking接口:
GET /sapi/v1/staking/productList 以查询Staking可锁仓产品列表
POST /sapi/v1/staking/purchase 以锁仓Staking产品
POST /sapi/v1/staking/redeem 以赎回Staking产品
GET /sapi/v1/staking/position 以查询Staking产品的持仓
GET /sapi/v1/staking/stakingRecord以查询锁仓产品的历史记录
POST /sapi/v1/staking/setAutoStaking 以设置Staking产品的自动续期
GET /sapi/v1/staking/personalLeftQuota 以查询个人锁仓限额
2022-04-27
新增合约策略交易接口：
POST /sapi/v1/algo/futures/newOrderTwap 以支持合约Twap策略下单
FAQ: 时间加权平均价格策略(Twap) 介绍
2022-04-26
新增接口 GET /sapi/v1/margin/rateLimit/order
回传用户在当前时间区间内的杠杆账户下单总数
2022-04-20
新增统一账户接口:
GET /sapi/v1/portfolio/account 以支持查询统一账户信息
FAQ: 币安合约统一账户总览
目前仅对特定用户开放此功能，详情：加入统一账户计划
2022-04-19
更新币安宝接口:
新增返回参数avgAnnualInterestRate和tierAnnualInterestRate 于接口GET /sapi/v1/lending/daily/product/list和GET /sapi/v1/lending/daily/token/position以支持查询阶梯利率
2022-04-13
新增合约策略交易接口：
POST /sapi/v1/algo/futures/newOrderVp 以支持合约vp策略下单
DELETE /sapi/v1/algo/futures/order 以支持合约策略委托撤单
GET /sapi/v1/algo/futures/openOrders 以支持查询合约策略当前委托
GET /sapi/v1/algo/futures/historicalOrders 以支持查询合约策略历史订单
GET /sapi/v1/algo/futures/subOrders 以支持查询合约策略子订单
FAQ: 成交量份额参与算法(VP) 介绍
2022-04-13
支持追踪止损订单
REST API
现货交易支持追踪止损(Trailing Stop)订单.
追踪止损通过一个新的参数trailingDelta来设置基于市场价的一个自动触发价格.
只适用于订单类型: STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, TAKE_PROFIT_LIMIT.
参数trailingDelta的单位为基点(BIPS).
比如一个STOP_LOSS卖单设置trailingDelta为100, 那么订单会在当前市场价格从下单后的最高点下降1%的时候被触发。(100 / 10,000 => 0.01 => 1%)
用于OCO订单的时候, 如果市场变动触发了STOP_LOSS订单, 那么此止损订单变成追踪止损订单.
当参数trailingDelta和stopPrice一起使用时, 一旦stopPrice条件被触发，系统会开始追踪当前的价格变动. 从stopPrice价格开始，到基于trailingDelta值之间变动.
如果没有提供stopPrice, 系统开始追踪价格从最新价到基于trailingDelta值之间变动.
POST /api/v3/order 变动
添加新可选参数 trailingDelta
POST /api/v3/order/test 变动
添加新可选参数 trailingDelta
POST /api/v3/order/oco 变动
添加新可选参数 trailingDelta
添加新的过滤器 TRAILING_DELTA
用于限定 trailingDelta 的最大和最小值.
USER DATA STREAM
User Data Stream 的executionReport添加新参数
"d" 代表trailingDelta
2022-04-12
Note: 下面的变更会在后面几天上线.
GET api/v3/allOrders 如果没有提供 symbol, 则返回错误信息:
{
"code": -1102,
"msg": "Mandatory parameter 'symbol' was not sent, was empty/null, or malformed."
}
修复一个错误信息中的拼写错误。 如果账号被禁用了相应的权限(比如提款，交易等), 则服务器返回错误:
"This action is disabled on this account."
在市场数据(market data)审计中，发现了一些现货的聚合交易数据(aggTrades)中的问题.
丢失的记录已经被补回.
重复的记录被标记成无效，具体的值设置成如下:
p = '0' // price
q = '0' // qty
f = -1 // first_trade_id
l = -1 // last_trade_id
2022-04-08
更新杠杆代币WEBSOCKET：
更换base url为 wss://nbstream.binance.com/lvt-p 对于杠杆代币数据流
详情见: Websocket 杠杆代币信息更新 and Websocket 杠杆代币净值K线更新
2022-3-29
以下更新于3月 31, 2022 08:00 AM UTC生效
更新子母账户接口：
GET /sapi/v1/sub-account/universalTransfer
接口查询时间窗口缩短为30天；若startTime和endTime没传，则默认返回最近30天数据。
2022-03-25
更新子母账户接口:
新增接口 GET /sapi/v1/managed-subaccount/accountSnapshot以支持投资人母账户查询托管子账户资产快照
2022-03-08
更新子母账户接口:
新增划转类型MARGIN,ISOLATED_MARGIN以及传参symbol于子母账户万能划转接口POST /sapi/v1/sub-account/universalTransfer 以支持母账户现货账户划转到子账户杠杆全仓账户和杠杆逐仓账户
2022-02-28
在接口GET /api/v3/exchangeInfo中添加新字段allowTrailingStop.
2022-02-22**
现货API
现货规则PRICE_FILTER里面的 (price-minPrice) % tickSize == 0 改成 price % tickSize == 0
新添加了一个规则 PERCENT_PRICE_BY_SIDE.
接口 GET api/v3/depth 的变动:
limit 原先必须是固定值(比如 5, 10, 20, 50, 100, 500, 1000, 5000), 现在可以是在1-5000之间的任意的正整数, 服务器会返回指定的limit数量。(比如如果设置limit=3, 会返回前3个最好的卖价和买价)
如果limit超过5000, 服务器也最多返回5000条记录.
相应的, 此接口的权重变成:
Limit
Request Weight
1-100
1
101-500
5
501-1000
10
1001-5000
50
GET api/v3/aggTrades 接口的变动:
当同时提供参数 startTime 和 endTime, 最旧的订单会优先返回.
2022-2-18
更新子母账户接口:
新增响应参数 isManagedSubAccount和 isAssetManagementSubAccount 于接口 GET /sapi/v1/sub-account/list 以支持查询子账户是否是托管子账户或资产管理子账户
font size=4>2022-2-17
以下更新于2月 24, 2022 08:00 AM UTC生效
更新钱包接口：
GET /sapi/v1/accountSnapshot
接口查询范围缩短为仅支持查询最近一个月数据，即startTime不支持选定最近1个月之外的时间。
2022-2-09
新增钱包接口:
POST /sapi/v1/asset/dust-btc 以获取可以转换成BNB的小额资产
2022-1-25
自1月 28, 2022 4:00 AM UTC起，您需要使用开通允许现货和杠杆交易权限的API Key调用以下接口:
POST /sapi/v1/asset/dust 小额资产转换
POST /sapi/v1/lending/daily/purchase 申购币安宝活期产品
POST /sapi/v1/lending/daily/redeem 赎回币安宝活期产品
POST /sapi/v1/lending/customizedFixed/purchase 申购币安宝定期/活动产品
POST /sapi/v1/lending/positionChanged 币安宝定期/活动持仓转活期持仓
POST /sapi/v1/bswap/liquidityAdd 币安挖矿添加流动性
POST /sapi/v1/bswap/liquidityRemove 币安挖矿移除流动性
POST /sapi/v1/bswap/swap 币安挖矿交易
POST /sapi/v1/bswap/claimRewards 币安挖矿领取奖励
2022-1-21
新增币安码接口:
POST /sapi/v1/giftcard/createCode 以支持创建币安码
POST /sapi/v1/giftcard/redeemCode 以支持兑现币安码
GET /sapi/v1/giftcard/verify 以支持验证币安码
2022-1-4
新增矿池接口:
GET /sapi/v1/mining/payment/uid 以获取矿池账户收益列表
新增币安挖矿接口:
GET /sapi/v1/bswap/unclaimedRewards 以查询未领取的奖励数量
POST /sapi/v1/bswap/claimRewards 以领取奖励
GET /sapi/v1/bswap/claimedHistory 以获取已领取奖励记录
2021-12-30
更新杠杆接口：
获取杠杆利率历史接口GET /sapi/v1/margin/interestRateHistory移除参数limit，查询时间间隔更改为最大1个月
更新钱包接口：
由于矿池钱包合并于资金账户钱包,用户万向划转接口 POST /sapi/v1/asset/transfer的以下划转类型 MAIN_MINING, MINING_MAIN, MINING_UMFUTURE, MARGIN_MINING,和 MINING_MARGIN将于 1月 05, 2022 08:00 AM UTC 停止使用
2021-12-29
移除交易对类型枚举
新增权限枚举
2021-12-24
更新子母账户接口:
新增传参clientTranId于子母账户万能划转接口POST /sapi/v1/sub-account/universalTransfer 和查询子母账户万能划转历史接口 GET /sapi/v1/sub-account/universalTransfer 以支持用户自定义划转id
2021-12-03
新增杠杆接口:
新增接口 GET /sapi/v1/margin/crossMarginData 以获取全仓杠杆利率及限额
新增接口 GET /sapi/v1/margin/isolatedMarginData 以获取逐仓杠杆利率及限额
新增接口 GET /sapi/v1/margin/isolatedMarginTier 以获取逐仓档位信息
新增NFT接口:
新增接口 GET /sapi/v1/nft/history/transactions 以支持用户查询NFT资金流水历史记录
新增接口 GET /sapi/v1/nft/history/deposit 以支持用户查询NFT充值历史记录
新增接口 GET /sapi/v1/nft/history/withdraw 以支持用户查询NFT提现历史记录
新增接口 GET /sapi/v1/nft/user/getAsset 以支持用户查询NFT资产
2021-11-30
新增闪兑接口:
新增接口 GET /sapi/v1/convert/tradeFlow 以支持用户查询闪兑交易历史记录
更新返佣接口:
新增接口 GET /sapi/v1/rebate/taxQuery 以支持用户查询现货返佣历史记录
2021-11-19
新增Pay接口:
新增接口 GET /sapi/v1/pay/transactions 以支持用户查询Pay交易历史记录
更新钱包接口:
新增响应参数 info 于接口 GET /sapi/v1/capital/withdraw/history 以显示提币失败原因
2021-11-18
以下更新于11月 25, 2021 08:00 AM UTC生效
更新钱包接口：
GET /sapi/v1/accountSnapshot
接口查询范围缩短为仅支持查询最近半年内的数据，即startTime不支持选定最近6个月之外的时间。若您没有传入startTime和endTime，则默认返回最近7天的数据
2021-11-17
以下接口将于11月 17, 2021 13:00 PM UTC停止使用:
POST /sapi/v1/account/apiRestrictions/ipRestriction 以支持用户为API Key开启或关闭IP白名单
POST /sapi/v1/account/apiRestrictions/ipRestriction/ipList 以支持用户为API Key添加IP白名单地址列表
GET /sapi/v1/account/apiRestrictions/ipRestriction 以支持用户为API Key查询IP白名单
DELETE /sapi/v1/account/apiRestrictions/ipRestriction/ipList 以支持用户为API Key删除IP白名单地址列表
2021-11-16
新增子母账户接口:
POST /sapi/v1/sub-account/subAccountApi/ipRestriction 以支持母账户为子账户API Key开启或关闭IP白名单
POST /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList 以支持母账户为子账户API Key添加IP白名单地址列表
GET /sapi/v1/sub-account/subAccountApi/ipRestriction 以支持母账户为子账户API Key查询IP白名单
DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList 以支持母账户为子账户API Key删除IP白名单地址列表
2021-11-09
新增钱包接口:
POST /sapi/v1/account/apiRestrictions/ipRestriction 以支持用户为API Key开启或关闭IP白名单
POST /sapi/v1/account/apiRestrictions/ipRestriction/ipList 以支持用户为API Key添加IP白名单地址列表
GET /sapi/v1/account/apiRestrictions/ipRestriction 以支持用户为API Key查询IP白名单
DELETE /sapi/v1/account/apiRestrictions/ipRestriction/ipList 以支持用户为API Key删除IP白名单地址列表
2021-11-08
新增质押借币接口:
新增查询质押借币资金流水接口GET /sapi/v1/loan/income以支持用户查询质押借币资金流水历史
2021-11-05
更新钱包接口:
新增参数 walletType于提币接口POST /sapi/v1/capital/withdraw/apply以支持用户选择从现货钱包或资金钱包进行提币
2021-11-04
以下更新于11月 11, 2021 08:00 AM UTC生效
更新接口：
GET /sapi/v1/asset/transfer
GET /sapi/v1/futures/transfer
接口查询范围缩短为仅支持查询最近半年内的数据，即startTime不支持选定最近6个月之外的时间。若您没有传入startTime和endTime，则默认返回最近7天的数据
2021-11-01
新增接口 GET /api/v3/rateLimit/order
回传用户在当前时间区间内的下单总数
此接口的权重为 20
2021-10-22
钱包接口更新:
新增划转类型 MAIN_FUNDING,FUNDING_MAIN,FUNDING_UMFUTURE,UMFUTURE_FUNDING,MARGIN_FUNDING,FUNDING_MARGIN,FUNDING_CMFUTUREand CMFUTURE_FUNDING 于用户万向划转接口 POST /sapi/v1/asset/transfer 和 GET /sapi/v1/asset/transfer 以支持资金账户和现货账户，杠杆全仓账户，U本位合约账户，币本位合约账户之间相互划转
由于C2C账户，币安支付、币安卡等业务合并至资金账户，用户万向划转接口POST /sapi/v1/asset/transfer 和 GET /sapi/v1/asset/transfer 的以下划转类型MAIN_C2C,C2C_MAIN,C2C_UMFUTURE,C2C_MINING,UMFUTURE_C2C,MINING_C2C,MARGIN_C2C,C2C_MARGIN,MAIN_PAY和PAY_MAIN 将于11月 04, 2021 08:00 AM UTC 停止使用
2021-10-14
以下杠杆账户接口更新返回数据的时间范围，startTime与endTime时间跨度不能超过30天，如果不传时间参数默认返回最近7天数据，如果archived参数为true，则默认返回6个月以前的最后7天数据:
GET /sapi/v1/margin/transfer
GET /sapi/v1/margin/loan
GET /sapi/v1/margin/repay
GET /sapi/v1/margin/isolated/transfer
GET /sapi/v1/margin/interestHistory
2021-09-18
新增币安挖矿接口:
新增接口 GET /sapi/v1/bswap/poolConfigure 以支持查询币对池的配置信息
新增接口 GET /sapi/v1/bswap/addLiquidityPreview 以支持查询添加流动性的试算
新增接口 GET /sapi/v1/bswap/removeLiquidityPreview 以查询移除流动性的试算
2021-09-17
访问限制介绍中新增/api/* 和 /sapi/*相关接口限频说明
2021-09-08
新增以下杠杆账户接口支持杠杆逐仓账户启用限制:
新增接口 DELETE /sapi/v1/margin/isolated/account 以支持杠杆逐仓账户停用
新增接口 POST /sapi/v1/margin/isolated/account 以支持杠杆逐仓账户启用
新增接口 GET /sapi/v1/margin/isolated/accountLimit 以查询杠杆逐仓账户上限
查询杠杆逐仓账户信息接口 GET /sapi/v1/margin/isolated/account 响应加入字段 "enabled" 判断账户是否启用
2021-09-03
更新钱包接口:
新增响应内容 sameAddress，depositDust 和 specialWithdrawTips于GET /sapi/v1/capital/config/getall
sameAddress 表示需要输入memo的币种
depositDust 表示最小可上帐金额
specialWithdrawTips 表示提现时的特殊说明
新增响应内容 confirmNo于GET /sapi/v1/capital/withdraw/history 以支持查询提现确认数
2021-08-27
更新钱包接口:
新增参数 withdrawOrderId 于 GET /sapi/v1/capital/withdraw/history 以支持查询指定withdrawOrderId的提币历史记录
新增响应内容 unlockConfirm 于 GET /sapi/v1/capital/deposit/hisrec 以支持查询解锁需要的网络确认次数
2021-08-23
新增杠杆账户 OCO 接口:
POST /sapi/v1/margin/order/oco
DELETE /sapi/v1/margin/orderList
GET /sapi/v1/margin/orderList
GET /sapi/v1/margin/allOrderList
GET /sapi/v1/margin/openOrderList
用法与现货账户 OCO 相同
2021-08-20
更新钱包接口:
新增参数fromSymbol，toSymbol和新增划转类型 ISOLATEDMARGIN_MARGIN， MARGIN_ISOLATEDMARGIN， ISOLATEDMARGIN_ISOLATEDMARGIN 于接口 POST /sapi/v1/asset/transfer 和 GET /sapi/v1/asset/transfer 以支持杠杆逐仓钱包与杠杆全仓钱包之前相互划转
2021-08-12
GET api/v3/myTrades 添加新的参数 orderId
2021-08-05
新增C2C接口:
GET /sapi/v1/c2c/orderMatch/listUserOrderHistory 以查询用户C2C交易历史记录
2021-08-05
币安宝接口更新:
GET /sapi/v1/lending/union/purchaseRecord
GET /sapi/v1/lending/union/redemptionRecord
GET /sapi/v1/lending/union/interestHistory
以上接口查询范围更改为：仅支持startTime和endTime查询最大间隔为30天，若startTime和 endTime均未发送，则默认返回最近30天记录
2021-07-29
子母账户接口更新:
GET /sapi/v1/sub-account/transfer/subUserHistory 如果startTime和endTime均未发送，默认只返回最近30天数据
2021-07-27
新增法币接口:
GET /sapi/v1/fiat/orders 以查询用户法币充值和提币历史记录
GET /sapi/v1/fiat/payments 以查询用户法币支付（买卖）历史记录
2021-07-16
新增钱包接口:
GET /sapi/v1/account/apiRestrictions 以查询用户API Key权限
2021-07-09
新增钱包接口:
POST /sapi/v1/asset/get-funding-asset 以查询资金账户资产，目前支持查询的业务为：Binance Pay, Binance Card, Binance Gift Card, Stock Token
2021-06-24
钱包接口更新:
GET /sapi/v1/capital/withdraw/history 现有的 limit 参数增加默认值1000，最大值1000的限制
GET /sapi/v1/capital/deposit/hisrec 现有的 limit 参数增加默认值1000，最大值1000的限制
2021-06-17
币安宝接口更新:
GET /sapi/v1/lending/daily/product/list 增加新参数 current 和 size
2021-06-15
新增子母账户接口:
POST /sapi/v1/managed-subaccount/deposit 以支持投资人账户为托管子账户充值资产（仅投资人账户方使用）
GET /sapi/v1/managed-subaccount/asset 以支持投资人账户查询托管子账户资产（仅投资人账户方使用）
POST /sapi/v1/managed-subaccount/withdraw以支持投资人账户为托管子账户提币资产（仅投资人账户方使用）
2021-06-04
从 八月 01, 2021 02:00 AM UTC 开始，以下WAPI接口将停止使用：
GET /wapi/v3/systemStatus.html
POST /wapi/v3/withdraw.html
GET /wapi/v3/depositHistory.html
GET /wapi/v3/withdrawHistory.html
GET /wapi/v3/depositAddress.html
GET /wapi/v3/accountStatus.html
GET /wapi/v3/apiTradingStatus.html
GET /wapi/v3/userAssetDribbletLog.html
GET /wapi/v3/assetDetail.html
GET /wapi/v3/tradeFee.html
GET /wapi/v3/sub-account/list.html
GET /wapi/v3/sub-account/transfer/history.html
POST /wapi/v3/sub-account/transfer.html
GET /wapi/v3/sub-account/assets.html
目前WAPI已从API文档中移除，为了保证您的所有交易策略顺利执行，强烈建议所有API用户尽快更新交易程序，替换成现有的SAPI接口
2021-05-26
更新钱包接口：
用户万向划转接口 POST /sapi/v1/asset/transfer 和GET /sapi/v1/asset/transfer 新增划转类型MAIN_PAY , PAY_MAIN 以支持现货和支付账户之间相互划转
2021-05-12
在文档中添加接口的数据来源说明
在每个接口中添加相应的数据源
GET api/v3/exchangeInfo 现在支持单或多交易对查询
2021-04-28
从 May 15, 2021 08:00 UTC 开始, 以下创建逐仓杠杆账户接口将关闭:
POST /sapi/v1/margin/isolated/create
后续，用户可通过逐仓杠杆账户划转 POST /sapi/v1/margin/isolated/transfer 直接完成逐仓杠杆账户的创建与交易准备，无需调用接口创建账户
2021-04-26
从 April 28, 2021 00:00 UTC 开始,下面接口的权重有如下变动:
GET /api/v3/order 权重改为 2
GET /api/v3/openOrders 权重改为 3
GET /api/v3/allOrders 权重改为 10
GET /api/v3/orderList 权重改为 2
GET /api/v3/openOrderList 权重改为 3
GET /api/v3/account 权重改为 10
GET /api/v3/myTrades 权重改为 10
GET /api/v3/exchangeInfo 权重改为 10
2021-04-08
子母账户接口更新:
GET /sapi/v1/sub-account/futures/accountSummary 和 GET /sapi/v2/sub-account/futures/accountSummary 接口返回字段asset 更新为以USD计价的资产汇总，即子账户USDT，BUSD等保证金总和
2021-04-02
新增钱包接口:
GET /sapi/v1/system/status 以获取系统状态
GET /sapi/v1/account/status 以获取账户状态
GET /sapi/v1/account/apiTradingStatus 以获取账户API交易状态
GET /sapi/v1/asset/dribblet 以获取小额资产转换BNB历史
GET /sapi/v1/asset/assetDetail 以获取上架资产详情
GET /sapi/v1/asset/tradeFee 以获取交易手续费率查询
新增子母账户接口:
GET /sapi/v3/sub-account/assets 以查询子账户资产
2021-04-01
子母账户接口更新:
GET /sapi/v1/sub-account/transfer/subUserHistory 新增返回字段 fromAccountType 和 toAccountType为用户转出账户类型和转入账户类型
2021-03-31
子母账户接口更新:
GET /wapi/v3/sub-account/transfer/history.html 新增参数 fromEmail 和 toEmail，原有参数email 将默认查询fromEmail的记录
2021-03-08
新增子母账户接口：
POST /sapi/v1/sub-account/virtualSubAccount 以支持母账户创建虚拟子账户
GET /sapi/v1/sub-account/list 以支持查询子账户列表
POST /sapi/v1/sub-account/blvt/enable 以支持为子账户开通杠杆代币
2021-03-05
新增杠杆接口：
GET /sapi/v1/margin/interestRateHistory 以支持杠杆利率历史查询
2021-02-08
新增合约接口：
GET /sapi/v2/futures/loan/wallet 混合保证金钱包 V2 接口，以支持 BUSD 借款查询
GET /sapi/v2/futures/loan/configs 混合保证金信息 V2 接口，以支持 BUSD 借款查询
GET /sapi/v2/futures/loan/calcAdjustLevel 计算调整后的混合保证金质押率 V2 接口，以支持 BUSD 借款查询
GET /sapi/v2/futures/loan/calcMaxAdjustAmount 可供调整混合保证金质押率的最大额 V2 接口，以支持 BUSD 借款质押率的调整
POST /sapi/v2/futures/loan/adjustCollateral 调整混合保证金质押率 V2 接口，以支持 BUSD 借款质押率的调整
更新合约接口：
GET /sapi/v1/futures/loan/adjustCollateral/history 混合保证金调整质押率历史接口，加入参数与响应字段 loanCoin 以支持 BUSD 借款查询
GET /sapi/v1/futures/loan/liquidationHistory 混合保证金强平历史历史接口，加入参数与响应字段 loanCoin 以支持 BUSD 借款查询
2021-02-04
更新钱包接口：
用户万向划转接口 POST /sapi/v1/asset/transfer 和GET /sapi/v1/asset/transfer 新增划转类型 MARGIN_MINING ,MINING_MARGIN, MARGIN_C2C ,C2C_MARGIN, MARGIN_CMFUTURE, CMFUTURE_MARGIN 以支持全仓杠杆，矿池，C2C，币本位合约账户间划转。
2021-01-15
杠杆交易添加新接口 DELETE /sapi/v1/margin/openOrders
此接口便于用户撤销单一交易对的所有挂单, 包括OCO的挂单。
2021-01-10
矿池接口 GET /sapi/v1/mining/payment/list 新增可选参数 pageSize
矿池接口 GET /sapi/v1/mining/payment/list 新增返回字段：
"type" 表示收益类型
"hashTransfer" 表示已转让算力
"transferAmount" 表示已转让收益
新增矿池接口:
GET /sapi/v1/mining/payment/other
GET /sapi/v1/mining/hash-transfer/config/details
GET /sapi/v1/mining/hash-transfer/config/details/list
GET /sapi/v1/mining/hash-transfer/profit/details
POST /sapi/v1/mining/hash-transfer/config
POST /sapi/v1/mining/hash-transfer/config/cancel
2021-01-01
USER DATA STREAM
移除outboundAccountInfo事件.
2020-12-30
新增钱包接口:
POST /sapi/v1/asset/transfer 用户万向划转接口，以支持现货，全仓杠杆，合约，C2C，矿池账户间划转。
GET /sapi/v1/asset/transfer 以支持查询用户万向划转历史记录。
2020-12-22
新增子母账户接口:
GET /sapi/v1/sub-account/sub/transfer/history 以支持查询子母账户现货资金划转历史。
2020-12-11
更新合约混合保证金接口:
接口GET /sapi/v1/futures/loan/wallet 新增返回参数 interestFreeLimit表示混合保证金总免息额度，interestFreeLimitUsed 表示占用混合保证金免息额度。
接口GET /sapi/v1/futures/loan/interestHistory 新增返回参数 interestFreeLimitUsed 表示占用混合保证金免息额度。
2020-12-04
更新杠杆代币接口:
接口GET /sapi/v1/blvt/tokenInfo 新增返回参数 currentBaskets(包括 symbol， amount ， notionalValue )，purchaseFeePct申购费率，dailyPurchaseLimit每日申购数量上限，redeemFeePct赎回费率，dailyRedeemLimit每日赎回数量上限。
新增杠杆代币接口:
GET /sapi/v1/blvt/userLimit 以查询用户每日申购赎回限额。
2020-12-02
新增子母账户接口:
GET /sapi/v2/sub-account/futures/account 以支持查询子账户USDT合约和币本位合约账户详情。
GET /sapi/v2/sub-account/futures/accountSummary 以支持查询子账户USDT合约和币本位合约账户汇总。
GET /sapi/v2/sub-account/futures/positionRisk 以支持查询子账户USDT合约和币本位合约持仓信息。
2020-12-01
更新杠杆交易接口:
POST /sapi/v1/margin/order 加入参数 quoteOrderQty 支持"报价总额市价单"。
2020-11-27
为了优化性能，除了当前的api.binance.com，新加了一些API的集群。如果访问api.binance.com有性能问题，也可以尝试访问:
https://api1.binance.com/api/v3/*
https://api2.binance.com/api/v3/*
https://api3.binance.com/api/v3/*
2020-11-16
更新杠杆接口加入 archived 参数以支持查询6个月以前数据:
GET /sapi/v1/margin/loan
GET /sapi/v1/margin/repay
GET /sapi/v1/margin/interestHistory
2020-11-13
新增子母账户接口:
POST /sapi/v1/sub-account/universalTransfer 以支持子母账户，现货和合约账户之间相互划转。
GET /sapi/v1/sub-account/universalTransfer 以查询划转记录。
2020-11-10
新增BNB抵扣开关接口:
POST /sapi/v1/bnbBurn BNB现货交易和杠杆利息抵扣开关。
GET /sapi/v1/bnbBurn 获取BNB抵扣开关状态。
2020-11-09
新增返回字段 tranId 于子母账户接口:
GET /sapi/v1/sub-account/futures/internalTransfer
GET /sapi/v1/sub-account/transfer/subUserHistory
2020-11-03
更新合约接口:
接口 GET /sapi/v1/futures/loan/repay/history 新增返回参数repayType（NORMAL为混合保证金普通还款，COLLATERAL为抵押物还款），price（抵押物还款兑换比率），repayCollateral（还款所用抵押物数量）。
接口 GET /sapi/v1/futures/loan/wallet 新增返回参数totalInterest（混合保证金总利息），principalForInterest（混合保证金计息本金），interest(混合保证金利息)。
接口 GET /sapi/v1/futures/loan/configs 新增返回参数interestRate（混合保证金利率），interestGracePeriod（混合保证金免息天数）。
新增合约接口:
接口 GET /sapi/v1/futures/loan/collateralRepayLimit 以查询混合保证金抵押物还款上下限。
接口 GET /sapi/v1/futures/loan/collateralRepay 以获取混合保证金抵押物还款兑换比率。
接口 POST /sapi/v1/futures/loan/collateralRepay 混合保证金以抵押物还款。
接口 GET /sapi/v1/futures/loan/collateralRepayResult 以查询混合保证金以抵押物还款结果。
接口 GET /sapi/v1/futures/loan/interestHistory 以查询混合保证金利息收取历史。
2020-10-14
合约接口更新:
POST /sapi/v1/futures/loan/borrow 与 GET /sapi/v1/futures/loan/borrow/history 返回新字段 borrowId 为用户混合保证金借款唯一 ID。
POST /sapi/v1/futures/loan/repay 与 GET /sapi/v1/futures/loan/repay/history 返回新字段 repayId 为用户混合保证金还款唯一 ID。
2020-10-10
子母账户接口POST /sapi/v1/sub-account/futures/transfer新增划转类型type 以支持子账户现货账户和币本位合约账户间相互划转。
2020-09-30
杠杆账户接口更新:
GET /sapi/v1/margin/maxBorrowable 返回新字段 borrowLimit 为用户账户借贷限额。
2020-09-28
新增币安宝接口:
POST /sapi/v1/lending/positionChanged 以支持定期/活动持仓转成活期持仓。
以下币安宝接口，lendingType里参数 ACTIVITY 替换 REGULAR以代表币安宝活动产品：
GET /sapi/v1/lending/project/list
POST /sapi/v1/lending/customizedFixed/purchase
GET /sapi/v1/lending/project/position/list
GET /sapi/v1/lending/union/purchaseRecord
GET /sapi/v1/lending/union/interestHistory
2020-09-23
新增币安挖矿接口:
接口 GET /sapi/v1/bswap/pools 以从某个资金池移除流动性。
接口 GET /sapi/v1/bswap/liquidity 以获取流动资金池具体信息。
接口 POST /sapi/v1/bswap/liquidityAdd 以添加流动性。
接口 POST /sapi/v1/bswap/liquidityRemove 以移除流动性。
接口 GET /sapi/v1/bswap/liquidityOps 以获取流动性操作记录。
接口 GET /sapi/v1/bswap/quote 以获取报价。
接口 POST /sapi/v1/bswap/swap 以交易。
接口 GET /sapi/v1/bswap/swap 以获取交易记录。
2020-09-16
新增杠杆代币接口:
接口GET /sapi/v1/blvt/tokenInfo 以查询杠杆代币信息。
接口POST /sapi/v1/blvt/subscribe 以申购代币。
接口GET /sapi/v1/blvt/subscribe/record 以查询申购代币记录。
接口POST /sapi/v1/blvt/redeem 以赎回代币。
接口GET /sapi/v1/blvt/redeem/record 以查询赎回代币记录。
以下杠杆代币功能请使用合约接口:
杠杆代币历史净值K线接口。
WebSocket 杠杆代币信息更新和净值K线更新
2020-09-09
用户数据 STREAM
outboundAccountInfo事件不再推荐使用。
outboundAccountInfo事件以后会被删除(具体时间未定) 请使用 outboundAccountPosition 事件.
outboundAccountInfo只推送余额不为0，以及余额刚变成0的资产。
2020-09-03
新增子母账户接口POST /sapi/v1/sub-account/futures/internalTransfer 以执行子账户合约资金直接划转。
新增子母账户接口GET /sapi/v1/sub-account/futures/internalTransfer 以查询子账户合约资金直接划转历史。
2020-09-01
子母账户接口GET /sapi/v1/sub-account/spotSummary 返回内容中新增字段 masterAccountTotalAsset以获取BTC计价的母账户资产。
2020-08-27
新增接口 GET /sapi/v1/sub-account/spotSummary 以获取BTC计价的子账户现货资产汇总。
2020-08-26
逐仓杠杆接口 GET /sapi/v1/margin/isolated/account 新增可选参数 symbols, 以支持查询至多5个指定symbol的杠杆逐仓资产。
2020-07-28
逐仓杠杆相关接口
以下接口新增可选参数"isIsolated", 并在返回内容中新增字段 "symbol":
POST /sapi/v1/margin/loan
POST /sapi/v1/margin/repay
以下接口新增可选参数"isIsolated", 并在返回内容中新增字段 "isIsolated":
POST /sapi/v1/margin/order
DELETE /sapi/v1/margin/order
GET /sapi/v1/margin/order
GET /sapi/v1/margin/openOrders
GET /sapi/v1/margin/allOrders
GET /sapi/v1/margin/myTrades
以下接口新增可选参数"isolatedSymbol", 并在返回内容中新增字段 "isolatedSymbol":
GET /sapi/v1/margin/loan
GET /sapi/v1/margin/repay
GET /sapi/v1/margin/interestHistory
接口 GET /sapi/v1/margin/forceLiquidationRec 新增可选参数"isolatedSymbol", 并在返回内容中新增字段 "isIsolated"
以下接口新增可选参数"isolatedSymbol":
GET /sapi/v1/margin/maxBorrowable
GET /sapi/v1/margin/maxTransferable
新增以下逐仓杠杆功能接口:
POST /sapi/v1/margin/isolated/create
POST /sapi/v1/margin/isolated/transfer
GET /sapi/v1/margin/isolated/transfer
GET /sapi/v1/margin/isolated/account
GET /sapi/v1/margin/isolated/pair
GET /sapi/v1/margin/isolated/allPairs
新增以下接口，管理逐仓杠杆账户listenKey:
POST /sapi/v1/userDataStream/isolated
PUT /sapi/v1/userDataStream/isolated
DELETE /sapi/v1/userDataStream/isolated
2020-07-20
接口GET /sapi/v1/margin/allOrders 参数"limit"的可传最大值更新为500.
2020-07-17
接口 GET /sapi/v1/margin/allOrders 增加访问限制为每个IP最多每分钟60次
2020-07-13
新增合约混合保证金相关的SAPI接口:
POST /sapi/v1/futures/loan/borrow
GET /sapi/v1/futures/loan/borrow/history
POST /sapi/v1/futures/loan/repay
GET /sapi/v1/futures/loan/repay/history
GET /sapi/v1/futures/loan/wallet
GET /sapi/v1/futures/loan/configs
GET /sapi/v1/futures/loan/calcAdjustLevel
GET /sapi/v1/futures/loan/calcMaxAdjustAmount
POST /sapi/v1/futures/loan/adjustCollateral
GET /sapi/v1/futures/loan/adjustCollateral/history
GET /sapi/v1/futures/loan/liquidationHistory
2020-06-28
服务于合约的相关SAPI接口内容转移至本文档:
POST /sapi/v1/futures/transfer
GET /sapi/v1/futures/transfer
2020-05-06
新增矿池接口:
GET /sapi/v1/mining/pub/algoList
GET /sapi/v1/mining/pub/coinList
GET /sapi/v1/mining/worker/detail
GET /sapi/v1/mining/worker/list
GET /sapi/v1/mining/payment/list
GET /sapi/v1/mining/statistics/user/status
GET /sapi/v1/mining/statistics/user/list
2020-05-01
从2020-05-01 UTC 00:00开始, 所有交易对都会有最多200个挂单的限制, 体现在过滤器MAX_NUM_ORDERS上.
已经存在的挂单不会被移除或者撤销。
单交易对(symbol)的挂单数量达到或超过200的账号, 无法在此交易对上下新的订单, 除非挂单数量低于200。
OCO订单在被触发成LIMIT订单, 或者被触发成STOP_LOSS(或者STOP_LOSS_LIMIT)前, 被认为是2个挂单量. 一旦OCO订单被触发, 就只被算作一个挂单。
2020-04-25
现货 API
添加新字段 permissions
这个字段定义了对于账户、交易对(symbol)的交易权限。
permissions 是个enum数组, 可能的值:
SPOT
MARGIN
在未来的版本(v4)中, permissions 将会在 GET api/v3/exchangeInfo 中替换 isSpotTradingAllowed 和 isMarginTradingAllowed。
如果账户想在一个交易对下做交易, 账户和交易对必须同时拥有对应的权限。
接口 GET api/v3/exchangeInfo 的更新
添加新字段 permissions。
添加新字段 quoteAssetPrecision。此字段和 quotePrecision 重复。在未来的版本(v4)中 quotePrecision 会被移除。
接口 GET api/v3/account 的更新
添加新字段 permissions 。
添加新接口 DELETE api/v3/openOrders
此接口便于用户撤销单一交易对的所有挂单, 包括OCO的挂单。
如果交易对处于 BREAK 或者 HALT 状态, 挂单也可以被撤销。
用户数据 STREAM
OutboundAccountInfo 消息会显示一个新字段 P, 用来显示账户的交易权限。
2020-04-23
WEB SOCKET 连接限制
Websocket服务器每秒最多接受5个消息。消息包括:
PING帧
PONG帧
JSON格式的消息, 比如订阅, 断开订阅.
如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。
单个连接最多可以订阅 1024 个Streams。
2020-04-16
币安宝接口GET /sapi/v1/lending/daily/token/position返回内容新增字段：
todayPurchasedAmount 表示用户今日申购的活期产品数量
新增以下币安宝接口用以支持灵活定期产品:
GET /sapi/v1/lending/project/list
POST /sapi/v1/lending/customizedFixed/purchase
GET /sapi/v1/lending/project/position/list
2020-04-02
接口 GET /sapi/v1/capital/config/getall 返回内容新增字段：
minConfirm 表示资产上账所需的最小确认数
unLockConfirm 表示资产解锁需所需确认数
2020-03-24
添加过滤器 MAX_POSITION.
这个过滤器定义账户允许的基于base asset的最大仓位。一个用户的仓位可以定义为如下资产的总和:
base asset的可用余额
base asset的锁定余额
所有处于open的买单的数量总和
如果用户的仓位大于最大的允许仓位，买单会被拒绝。
2020-03-13
新增可选参数 transactionFeeFlag 于以下提币接口:
POST /sapi/v1/capital/withdraw/apply
POST /wapi/v3/withdraw.html
2020-02-05
新增子账户相关接口:
POST /sapi/v1/sub-account/futures/transfer: 对子账户实施futures账户划转
POST /sapi/v1/sub-account/margin/transfer: 对子账户实施margin账户划转
POST /sapi/v1/sub-account/transfer/subToSub: 向兄弟子账户划转
POST /sapi/v1/sub-account/transfer/subToMaster: 向母账户划转
GET /sapi/v1/sub-account/transfer/subUserHistory: 子账户获取自身划转历史
2020-01-15
接口POST /wapi/v3/withdraw.html 新增参数 withdrawOrderId: 用户自定义提币id
接口GET /wapi/v3/withdrawHistory.html 返回内容新增字段 withdrawOrderId: 该笔提币的用户自定义id
2019-12-25
新增币安宝接口：
GET /sapi/v1/lending/daily/product/list
GET /sapi/v1/lending/daily/userLeftQuota
POST /sapi/v1/lending/daily/purchase
GET /sapi/v1/lending/daily/userRedemptionQuota
POST /sapi/v1/lending/daily/redeem
GET /sapi/v1/lending/daily/token/position
GET /sapi/v1/lending/union/account
GET /sapi/v1/lending/union/purchaseRecord
GET /sapi/v1/lending/union/redemptionRecord
GET /sapi/v1/lending/union/interestHistory
新增请求时间间隔于以下接口
GET /sapi/v1/capital/withdraw/history,
GET /wapi/v3/withdrawHistory.html,
GET /sapi/v1/capital/deposit/hisrec and
GET /wapi/v3/depositHistory.html:
默认startTime为当前时间起90天前， 默认endTime为当前时间；
请注意startTime 与 endTime 的默认时间戳，保证请求时间间隔不超过90天；
同时提交startTime 与 endTime间隔不得超过90天.
2019-12-18
新增接口用以获取账户每日资产快照:
GET /sapi/v1/accountSnapshot
2019-11-30
接口POST /sapi/v1/margin/order (HMAC SHA256)新增参数sideEffectType，可选内容如下:
NO_SIDE_EFFECT: 普通交易订单;
MARGIN_BUY: 自动借款交易订单;
AUTO_REPAY: 自动还款交易订单.
New field marginBuyBorrowAmount and marginBuyBorrowAsset in FULL response to POST /sapi/v1/margin/order (HMAC SHA256)
2019-11-28
新增SAPI接口用以关闭账户站内划转功能：
POST /sapi/v1/account/disableFastWithdrawSwitch (HMAC SHA256)
新增SAPI接口用以开启账户站内划转功能：
POST /sapi/v1/account/enableFastWithdrawSwitch (HMAC SHA256)
2019-11-22
"报价总额市价单"作为新的市价单方式已在各交易对投入使用。
"报价总额市价单" 允许用户在市价单MARKET中设置总的购买投入金额或卖出预计回收金额 quoteOrderQty。
"报价总额市价单"不会突破LOT_SIZE的限制规则; 报单会按给定的quoteOrderQty尽可能接近地被执行。
以BNBBTC交易对为例:
On the BUY side, the order will buy as many BNB as quoteOrderQty BTC can.
买单: 给定quoteOrderQty的BTC会被用来市价买入尽可能多的BNB。
On the SELL side, the order will sell as much BNB as needed to receive quoteOrderQty BTC.
卖单: 持有BNB会被尽可能多地以市价卖出以获取给定quoteOrderQty的BTC。
2019-11-19
GET /sapi/v1/sub-account/margin/account 返回内容新增:
marginTradeCoeffVo 其中包括
forceLiquidationBar: 强平风险率;
marginCallBar: 补仓风险率;
normalBar: 初始风险率
2019-11-13
Rest API
"api/v3/exchangeInfo" 新增内容:
quoteOrderQtyMarketAllowed
baseCommissionPrecision
quoteCommissionPrecision
MARKET orders (市价单)新增可选参数: quoteOrderQty指定买入或卖出的报价数量，不可与 quantity(数量)同时使用.
能够有效配合该参数使用MARKET orders(市价单)的确切时间和进一步详细信息将由后续声明予以通告。
所有订单查询接口增加新的返回内容：origQuoteOrderQty (e.g. GET api/v3/allOrders)
{
"code": -1128,
"msg": "Combination of optional parameters invalid. Recommendation: 'stopLimitTimeInForce' should also be sent."
}
错误代码更新: -1128
发送OCO订单中有stopLimitPrice但是没有stopLimitTimeInForce，将会受到错误信息:
错误代码更新: -1003, 明确了使用请求权重作为限制而不是请求数量。
v1 接口将被弃用:
2020年一季度末，以下接口将被移除。目前文档已经将这些接口更新为v3版本。
GET api/v1/depth
GET api/v1/historicalTrades
GET api/v1/aggTrades
GET api/v1/klines
GET api/v1/ticker/24hr
GET api/v1/ticker/price
GET api/v1/exchangeInfo
POST api/v1/userDataStream
PUT api/v1/userDataStream
GET api/v1/ping
GET api/v1/time
GET api/v1/ticker/bookTicker
以下接口将不会移植到v3版本，请使用新接口予以替换
旧的 V1 接口
新的 V3 接口
GET api/v1/ticker/allPrices
GET api/v3/ticker/price
GET api/v1/ticker/allBookTickers
GET api/v3/ticker/bookTicker
USER DATA STREAM
事件executionReport(订单更新)更新内容:
如果 C 值为空, 将返回 null, 而不是"null".
新增返回值 Q, 表示 quoteOrderQty.
新增事件类型balanceUpdate(余额更新)
当资金存入或从帐户中提取时，发生余额更新。
WEB SOCKET STREAM
WSS 现在支持实时订阅和取消数据流。
2019-11-08
新增以下sapi接口用以管理子账户的杠杆与期货：
GET /sapi/v1/sub-account/status (HMAC SHA256)
POST /sapi/v1/sub-account/margin/enable (HMAC SHA256)
GET /sapi/v1/sub-account/margin/account (HMAC SHA256)
GET /sapi/v1/sub-account/margin/accountSummary (HMAC SHA256)
POST /sapi/v1/sub-account/futures/enable (HMAC SHA256)
GET /sapi/v1/sub-account/futures/account (HMAC SHA256)
GET /sapi/v1/sub-account/futures/accountSummary (HMAC SHA256)
GET /sapi/v1/sub-account/futures/positionRisk (HMAC SHA256)
2019-11-04
新增管理子账户充值功能相关的sapi接口
GET /sapi/v1/capital/deposit/subAddress (HMAC SHA256)): 获取子账户充值地址。
GET /sapi/v1/capital/deposit/subHisrec (HMAC SHA256)): 获取子账户充值记录。
2019-10-29
新增钱包提币功能相关的sapi接口
POST /sapi/v1/capital/withdraw/apply (HMAC SHA256): 提币。
Get /sapi/v1/capital/withdraw/history (HMAC SHA256): 获取提币历史(支持多网络)。
2019-10-14
新增钱包功能相关的sapi接口
GET /sapi/v1/capital/config/getall (HMAC SHA256): 获取针对用户的所有币种信息。
GET /sapi/v1/capital/deposit/hisrec (HMAC SHA256): 获取充值历史(支持多网络)。
GET /sapi/v1/capital/deposit/address (HMAC SHA256): 获取充值地址(支持多网络).
2019-10-11
POST /wapi/v3/withdraw.html,增加参数 network,支持多网络提币。
2019-09-09
新增bookTicker行情流:
2019-09-03
更新频率达到100ms的更快的 order book 信息流选项:
Websocket Market Streams 增加 Update Speed 更新速度
2019-08-16
10000 限额 的接口已被临时删除： GET api/v1/depth
在2017年第四季度，以下接口已被弃用并将其从API文档中删除。 从此版本开始，以下接口已从API中永久删除。 对于原始变更日志如有遗漏，我们深表歉意:
GET api/v1/order
GET api/v1/openOrders
POST api/v1/order
DELETE api/v1/order
GET api/v1/allOrders
GET api/v1/account
GET api/v1/myTrades
在此存储库的文档中描述的流、接口、参数、有效负载等均被 官方认证 且 得到支持。 任何其他流、接口、参数或有效负载等的使用不受支持， 自行使用的风险将由您自己承担，没有任何保证。
2019-09-15
Rest API
新订单类型: OCO ("One Cancels the Other")
一个 OCO 有 2 个订单: (在财务术语中也称为 legs)
STOP_LOSS 或 STOP_LOSS_LIMIT leg
LIMIT_MAKER leg
价格限制:
SELL Orders : 限价 > 成交价>止损价
BUY Orders : 限价<成交价<止损价
如前所述，价格必须"横跨"交易品种的最后交易价格。 例如：如果最后价格是10:
卖出OCO的限制价格必须大于10，止损价格小于10。
买入OCO的限制价格必须小于10，止损价格大于10。
数量限制:
两个 legs 的数量必须相同。
但是，ICEBERG的数量不必相同。
执行顺序:
如果触发了LIMIT_MAKER，则在取消止损leg之前将首先执行限价支路。
如果市场价格移动到将触发"STOP_LOSS"或"STOP_LOSS_LIMIT"，则在执行"STOP_LOSS"支路之前，限价单支路将被取消。
取消一个 OCO 订单
取消任一订单的 leg 将取消整个 OCO 订单.
可通过orderListId 或 listClientOrderId取消整个 OCO 订单。
OCO的新枚举:
ListStatusType
RESPONSE - 当ListStatus响应失败的操作时使用。 (下单或取消订单)
EXEC_STARTED - 在下订单列表或列表状态更新时使用。
ALL_DONE - 当订单清单完成执行且不再有效时使用。
ListOrderStatus
EXECUTING - 在下订单列表或列表状态更新时使用。
ALL_DONE - 当订单清单完成执行且不再有效时使用。
REJECT - 当ListStatus响应失败的操作时使用。 (下单或取消订单)
ContingencyType
OCO - 指定订单列表的类型。
新的接口:
POST api/v3/order/oco
DELETE api/v3/orderList
GET api/v3/orderList
recvWindow cannot exceed 60000.
New intervalLetter values for headers:
SECOND => S
MINUTE => M
HOUR => H
DAY => D
新标头"X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)"将为(intervalNum)(intervalLetter)速率限制器提供您当前使用的请求权重。 例如，如果设置了一分钟的请求速率权重限制器，则响应中将获得一个"X-MBX-USED-WEIGHT-1M"标头。 旧标头X-MBX-USED-WEIGHT仍将返回，并代表一分钟请求速率权重限制的当前使用权重。
新标头"X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter)"会在任何有效的订单位置上更新，并跟踪该间隔的当前订单数； 拒绝/不成功的订单不保证在响应中具有X-MBX-ORDER-COUNT-**标头。
例如： "X-MBX-ORDER-COUNT-1S"用于"每1秒钟的订单"，X-MBX-ORDER-COUNT-1D用于"每1天的订单"
GET api / v1 / depth现在支持limit 5000和10000; 权重分别是50和100。
GET api / v1 / exchangeInfo具有一个新参数" ocoAllowed"。
用户数据流
executionReport事件现在包含具有orderListId`的"g"； 对于非OCO订单，它将设置为-1。
新事件类型listStatus; listStatus是在更新任何OCO订单时发送的。
新事件类型outboundAccountPosition; 每当帐户余额发生变化时，就会发送outboundAccountPosition，并包含可能导致余额发生变化的事件(存款，提款，交易，下单或取消)更改的资产。
新的错误码
-1131 BAD_RECV_WINDOW
recvWindow 必须小于 60000
-1099未被找到，被认证或被授权
*替换错误代码-1999
新的-2011错误内容
OCO_BAD_ORDER_PARAMS
其中一个订单的参数不正确。
OCO_BAD_PRICES
订单价格之间的关系不正确。
UNSUPPORTED_ORD_OCO
此交易对不支持OCO订单。
2019-03-12
Rest API
X-MBX-USED-WEIGHT标头已添加到Rest API响应中。
Retry-After标头已添加到Rest API 418和429响应中。
取消Rest API时，如果交易对的"状态"不是" TRADING"，则现在可以返回"errorCode" -1013或-2011。
api/v1/depth不再具有被忽略和为空的[[]。
*api/v3/myTrades现在返回quoteQty`; 价格交易数量。
Websocket 流
系统改进
匹配引擎稳定性/可靠性改进。
Rest API性能改进。
2018-11-13
Rest API
现在可以在限制交易期间通过Rest API取消订单。
新的过滤器：PERCENT_PRICE，MARKET_LOT_SIZE，MAX_NUM_ICEBERG_ORDERS。
添加了RAW_REQUESTS速率限制。 限制取决于X分钟内的请求数量(不考虑重量)。
无交易对查询的/api/v3/ticker/price权重增加到2。
/api/v3/ticker/bookTicker对于无符号查询增加了2的权重。
DELETE /api/v3/order现在将返回订单最终状态的执行报告。
MIN_NOTIONAL过滤器有两个新参数：
applyToMarket(过滤器是否应用于MARKET订单)
avgPriceMins(平均价格的分钟数)。
intervalNum已添加到/api/v1/exchangeInfo限制中。 intervalNum描述间隔的数量。 例如：intervalNum 5，带有interval分钟，表示"每5分钟"。
平均价格的计算规则解释:
[过去5分钟所有订单的数量*价格求和] / 过去5分钟所有订单的数量
如果最近5分钟内没有交易，则以5分钟窗口外发生的第一笔交易为准。
例如，如果最后一次交易是在20分钟前，则该交易的价格为5分钟的平均值。
如果代码上没有交易，则没有平均价格，因此无法下达市价单。对于在MIN_NOTIONAL过滤器上启用了applyToMarket的新交易对，除非有至少一笔交易，才能下达市价单。
当前的平均价格可以在这里查看：https://api.binance.com/api/v3/avgPrice?symbol=
例如:
https://api.binance.com/api/v3/avgPrice?symbol=BNBUSDT
用户数据流
将"最后报价资产交易量"(作为变量" Y")添加到执行报告中。 代表lastPrice
lastQty(L *l)。
2018-07-18
Rest API
新的过滤器：ICEBERG_PARTS
post api/v3/order为newOrderRespType`的新默认值。 ACK，RESULT或FULL； "MARKET"和"LIMIT"订单类型默认为"FULL"，所有其他订单默认为"ACK"。
POST api/v3 orderRESULT和FULL响应现在具有"cummulativeQuoteQty"
GET/api/v3/ openOrders的交易对权重减少到40。
GET/api/v3/ ticker / 24hr，且交易对权重未降低至40。
GET/api/v1/ trades的最大交易量增加到1000。
GET/api/v1/ historicalTrades的最大交易量增加到1000。
GET/api/v1/ aggTrades的最大总交易量增加到1000。
GET/api/v1/ klines的最大总交易量增加到1000。
剩余的API订单查询现在返回updateTime，它代表订单的最后更新时间； time是订单创建时间。
订单查找接口现在将返回"cummulativeQuoteQty"。如果"cummulativeQuoteQty"小于0，则表示该时间该数据不可用。
REQUESTS速率限制类型更改为REQUEST_WEIGHT。从逻辑上讲，此限制始终是请求权重，并且其先前的名称引起混乱。
用户数据流
在订单响应和执行报告中添加了"cummulativeQuoteQty"字段(作为变量"Z")。 表示已花费(使用"买入"订单)或已收到(使用"卖出"订单)的"报价"的累计金额。 历史订单在该字段中的值将小于0，这表明该数据目前不可用。 "cummulativeQuoteQty"除以"cummulativeQty"将得出订单的平均价格。
O(订单创建时间)添加到执行报告中
2018-01-23
GET/api/v1/ historicalTrades权重降低到5
GET/api/v1/ aggTrades权重降至1
GET/api/v1/ klines权重降至1
GET/api/v1/ticker / 24hr，所有交易品种的权重降低到交易交易品种的数量/ 2
GET/api/v3/ allOrders权重降低到5
GET/api/v3/ myTrades权重降低到5
GET/api/v3/帐户权重降低到5
GET/api/v1/深度限制= 500重量减少到5
GET/api/v1/深度限制= 1000重量减少到10
-1003错误消息已更新，可将用户定向到websocket
2018-01-20
GET/api/v1/ticker / 24hr单个符号权重降至1
GET/api/v3/ openOrders所有交易对权重下降至交易交易品种数量/ 2
GET/api/v3/allOrders权重降低到15
GET/api/v3/ myTrades权重降低到15
GET/api/v3/订单权重降至1
myTrades现在将返回自交易/清洗交易的双方
2018-01-14
GET/api/v1/aggTrades权重更改为2
GET/api/v1/klines权重更改为2
GET/api/v3/订单权重更改为2
GET/api/v3/ allOrders权重更改为20
GET/api/v3/帐户权重更改为20
GET/api/v3/ myTrades权重更改为20
GET/api/v3/ historicalTrades权重更改为20
介绍API Key 设置
很多接口需要API Key才可以访问. 请参考这个页面来设置API Key.
设置API Key的同时，为了安全，建议设置IP访问白名单.
永远不要把你的API key/secret告诉给任何人
如果不小心泄露了API key，请立刻删除此Key, 并可以另外生产新的Key.
API Key 权限设置
新创建的API的默认权限是 只读。
如果需要通过API提款, 需要在UI修改权限, 选中 允许提现。
账户现货账户
新注册的币安账号都会有一个现货(SPOT)账号。
杠杆账户
为了开设杠杆(MARGIN)账户, 可以参考Binance杠杆交易账户设置指南
现货测试网
用户可以使用现货的测试网来体验SPOT交易. 现在只能通过API来交易。
更多信息请参考现货测试网。
API 代码库Connectors
以下有一些轻量级的代码库，使不同语言的用户能够直接调用现货的 Binance 公共 API：
Python https://github.com/binance/binance-connector-python
Node.js https://github.com/binance/binance-connector-node
Ruby https://github.com/binance/binance-connector-ruby
DotNET C# https://github.com/binance/binance-connector-dotnet
Java https://github.com/binance/binance-connector-java
Rust https://github.com/binance/binance-spot-connector-rust
PHP https://github.com/binance/binance-connector-php
Go https://github.com/binance/binance-connector-go
Typescript https://github.com/binance/binance-connector-typescript
Postman Collections
Postman 集合现已推出。推荐给寻求快速和轻松地开始使用 API 的新用户。
https://github.com/binance/binance-api-postman
Swagger
以下有提供包含 RESTful API 的 OpenAPI 规范的 YAML 文件，以及可供参考的 Swagger UI 页面。
https://github.com/binance/binance-api-swagger
联系我们
币安API电报群
咨询关于API或者Websockets性能方面的问题.
咨询文档中没有提及的API问题.
币安开发者社区
咨询关于API/Websockets代码实现，或者任何API/Websockets的问题.
币安客服
咨询关于账户，钱包，2FA等.
基本信息API 基本信息
接口可能需要用户的 API Key，如何创建API-KEY请参考这里
本篇列出接口的 base URL 有:
https://api.binance.com
https://api-gcp.binance.com
https://api1.binance.com
https://api2.binance.com
https://api3.binance.com
https://api4.binance.com
上述列表的最后4个接口 (api1-api4) 可能会提供更好的性能，但其稳定性略为逊色。因此，请务必使用最适合您现有配置的那款。
所有接口的响应都是 JSON 格式。
响应中如有数组，数组元素以时间升序排列，越早的数据越提前。
所有时间、时间戳均为UNIX时间，单位为毫秒。
对于仅发送公开市场数据的 API，您可以使用 base URL https://data-api.binance.vision 。
GET /api/v3/aggTrades
GET /api/v3/avgPrice
GET /api/v3/depth
GET /api/v3/exchangeInfo
GET /api/v3/klines
GET /api/v3/ping
GET /api/v3/ticker
GET /api/v3/ticker/24hr
GET /api/v3/ticker/bookTicker
GET /api/v3/ticker/price
GET /api/v3/time
GET /api/v3/trades
GET /api/v3/uiKlines
HTTP 返回代码
HTTP 4XX 错误码用于指示错误的请求内容、行为、格式。问题在于请求者。
HTTP 403 错误码表示违反WAF限制(Web应用程序防火墙)。
HTTP 409 错误码表示重新下单(cancelReplace)的请求部分成功。(比如取消订单失败，但是下单成功了)
HTTP 429 错误码表示警告访问频次超限，即将被封IP。
HTTP 418 表示收到429后继续访问，于是被封了。
HTTP 5XX 错误码用于指示Binance服务侧的问题。
接口错误代码
使用接口 /api/v3, 以及 /sapi/v1/margin时, 每个接口都有可能抛出异常;
API 与 SAPI 的错误代码返回形式如下:
{
"code": -1121,
"msg": "Invalid symbol."
}
具体的错误码及其解释在 错误代码.
接口的基本信息
GET 方法的接口, 参数必须在 query string中发送。
POST, PUT, 和 DELETE 方法的接口,参数可以在内容形式为application/x-www-form-urlencoded的 query string 中发送，也可以在 request body 中发送。 如果你喜欢，也可以混合这两种方式发送参数。
对参数的顺序不做要求。
但如果同一个参数名在query string和request body中都有，query string中的会被优先采用。
访问限制访问限制基本信息
以下 是intervalLetter 作为头部值:
SECOND => S
MINUTE => M
HOUR => H
DAY => D
在 /api/v3/exchangeInfo rateLimits 数组中包含与交易的有关RAW_REQUESTS，REQUEST_WEIGHT和ORDERS速率限制相关的对象。这些在 限制种类 (rateLimitType) 下的 枚举定义 部分中进一步定义。
违反任何一个速率限制时（访问频次限制或下单速率限制），将返回429。
IP 访问限制
每个请求将包含一个X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)的头，其中包含当前IP所有请求的已使用权重。
每一个接口均有一个相应的权重(weight)，有的接口根据参数不同可能拥有不同的权重。越消耗资源的接口权重就会越大。
收到429时，您有责任停止发送请求，不得滥用API。
收到429后仍然继续违反访问限制，会被封禁IP，并收到418错误码
频繁违反限制，封禁时间会逐渐延长，从最短2分钟到最长3天。
Retry-After的头会与带有418或429的响应发送，并且会给出以秒为单位的等待时长(如果是429)以防止禁令，或者如果是418，直到禁令结束。
访问限制是基于IP的，而不是API Key
建议您尽可能多地使用websocket消息获取相应数据，以减少请求带来的访问限制压力。
下单频率限制
每个成功的下单回报将包含一个X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter)的头，其中包含当前账户已用的下单限制数量。
当下单数超过限制时，会收到带有429但不含Retry-After头的响应。请检查 GET api/v3/exchangeInfo 的下单频率限制 (rateLimitType = ORDERS) 并等待封禁时间结束。
被拒绝或不成功的下单并不保证回报中包含以上头内容。
下单频率限制是基于每个账户计数的。
用户可以通过接口 GET api/v3/rateLimit/order 来查询当前的下单量.
WEB SOCKET 连接限制
Websocket服务器每秒最多接受5个消息。消息包括:
PING帧
PONG帧
JSON格式的消息, 比如订阅, 断开订阅.
如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。
单个连接最多可以订阅 1024 个Streams。
每IP地址、每5分钟最多可以发送300次连接请求。
/api/ 与 /sapi/ 接口限频说明
/api/*接口和 /sapi/*接口采用两套不同的访问限频规则, 两者互相独立。
/api/*的接口相关：
按IP和按UID(account)两种模式分别统计, 两者互相独立。
以 /api/*开头的接口按IP限频，且所有接口共用每分钟6,000限制。
每个请求将包含一个 X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)的头，包含当前IP所有请求的已使用权重。
每个成功的下单回报将包含一个X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter)的头，其中包含当前账户已用的下单限制数量。
/sapi/*的接口相关：
按IP和按UID(account)两种模式分别统计, 两者互相独立。
以/sapi/*开头的接口采用单接口限频模式。按IP统计的权重单接口权重总额为每分钟12000；按照UID统计的单接口权重总额是每分钟180000。
每个接口会标明是按照IP或者按照UID统计, 以及相应请求一次的权重值。
按照IP统计的接口, 请求返回头里面会包含X-SAPI-USED-IP-WEIGHT-1M=
按照UID统计的接口, 请求返回头里面会包含X-SAPI-USED-UID-WEIGHT-1M=
数据来源
因为API系统是异步的, 所以返回的数据有延时很正常, 也在预期之中。
在每个接口中，列出了其数据的来源，可以用于理解数据的时效性。
系统一共有3个数据来源，按照更新速度的先后排序。排在前面的数据最新，在后面就有可能存在延迟。
撮合引擎 - 表示数据来源于撮合引擎
缓存 - 表示数据来源于内部或者外部的缓存
数据库 - 表示数据直接来源于数据库
有些接口有不止一个数据源, 比如 `缓存 => 数据库`, 这表示接口会先从第一个数据源检查，如果没有数据，则检查下一个数据源。
接口鉴权类型
每个接口都有自己的鉴权类型，鉴权类型决定了访问时应当进行何种鉴权。
鉴权类型会在本文档中各个接口名称旁声明，如果没有特殊声明即默认为 NONE。
如果需要 API-keys，应当在HTTP头中以 X-MBX-APIKEY字段传递。
API-keys 与 secret-keys 是大小写敏感的。
API-keys可以被配置为只拥有访问一些接口的权限。
例如, 一个 API-key 仅可用于发送交易指令, 而另一个 API-key 则可访问除交易指令外的所有路径。
默认 API-keys 可访问所有鉴权路径.
鉴权类型
描述
NONE
不需要鉴权的接口
TRADE
需要有效的 API-Key 和签名
MARGIN
需要有效的 API-Key 和签名
USER_DATA
需要有效的 API-Key 和签名
USER_STREAM
需要有效的 API-Key
MARKET_DATA
需要有效的 API-Key
TRADE, MARGIN 和USER_DATA 接口是 签名(SIGNED)接口.
SIGNED (TRADE、USER_DATA AND MARGIN) Endpoint security
调用SIGNED 接口时，除了接口本身所需的参数外，还需要在query string 或 request body中传递 signature, 即签名参数。
签名 大小写不敏感.
各种签名方式(比如 HMAC, RSA, Ed25519)，请参考下面的签名的示例。
时间同步安全
签名接口均需要传递 timestamp参数，其值应当是请求发送时刻的unix时间戳(毫秒)。
服务器收到请求时会判断请求中的时间戳，如果是5000毫秒之前发出的，则请求会被认为无效。这个时间空窗值可以通过发送可选参数 recvWindow来定义。
逻辑伪代码如下:
if (timestamp < (serverTime + 1000) && (serverTime - timestamp) <= recvWindow)
{
// process request
}
else
{
// reject request
}
关于交易时效性 互联网状况并不完全稳定可靠,因此你的程序本地到币安服务器的时延会有抖动。这是我们设置recvWindow的目的所在，如果你从事高频交易，对交易时效性有较高的要求，可以灵活设置recvWindow以达到你的要求。
推荐使用5秒以下的 recvWindow! 最多不能超过 60秒!
POST /api/v3/order 的示例 - HMAC Keys
以下是在 linux bash 环境下使用 echo openssl 和 curl 工具实现的一个调用接口下单的示例 apikey、secret仅供示范
Key
Value
apiKey
vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A
secretKey
NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j
参数
取值
symbol
LTCBTC
side
BUY
type
LIMIT
timeInForce
GTC
quantity
1
price
0.1
recvWindow
5000
timestamp
1499827319559
示例 1: 所有参数通过 request body 发送
示例 1
HMAC SHA256 signature:
$ echo -n "symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000×tamp=1499827319559" | openssl dgst -sha256 -hmac "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j"
(stdin)= c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71
curl command:
(HMAC SHA256)
$ curl -H "X-MBX-APIKEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" -X POST 'https://api.binance.com/api/v3/order' -d 'symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000×tamp=1499827319559&signature=c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71'
requestBody:
symbol=LTCBTC
&side=BUY
&type=LIMIT
&timeInForce=GTC
&quantity=1
&price=0.1
&recvWindow=5000
×tamp=1499827319559
示例 2: 所有参数通过 query string 发送
示例 2
HMAC SHA256 signature:
$ echo -n "symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000×tamp=1499827319559" | openssl dgst -sha256 -hmac "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j"
(stdin)= c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71
curl command:
(HMAC SHA256)
$ curl -H "X-MBX-APIKEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" -X POST 'https://api.binance.com/api/v3/order?symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1&price=0.1&recvWindow=5000×tamp=1499827319559&signature=c8db56825ae71d6d79447849e617115f4a920fa2acdcab2b053c4b2838bd6b71'
queryString:
symbol=LTCBTC
&side=BUY
&type=LIMIT
&timeInForce=GTC
&quantity=1
&price=0.1
&recvWindow=5000
×tamp=1499827319559
示例 3: 混合使用 query string 和 request body
示例 3
HMAC SHA256 signature:
$ echo -n "symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTCquantity=1&price=0.1&recvWindow=5000×tamp=1499827319559" | openssl dgst -sha256 -hmac "NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j"
(stdin)= 0fd168b8ddb4876a0358a8d14d0c9f3da0e9b20c5d52b2a00fcf7d1c602f9a77
curl command:
(HMAC SHA256)
$ curl -H "X-MBX-APIKEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A" -X POST 'https://api.binance.com/api/v3/order?symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC' -d 'quantity=1&price=0.1&recvWindow=5000×tamp=1499827319559&signature=0fd168b8ddb4876a0358a8d14d0c9f3da0e9b20c5d52b2a00fcf7d1c602f9a77'
queryString:
symbol=LTCBTC&side=BUY&type=LIMIT&timeInForce=GTC
requestBody:
quantity=1&price=0.1&recvWindow=5000×tamp=1499827319559
请注意，签名与示例3不同。
"GTC"和"quantity = 1"之间没有＆。
POST /api/v3/order 的示例 - RSA Keys
这将逐步介绍如何通过有效的签名发送 payload。
我们接受 PKCS#8 格式的 RSA Key。
要获取 API Key，您需要在您的账户上上传您的 RSA Public Key。
对于这个例子，Private Key 将被引用为test-prv-key.pem。
Key
Value
apiKey
CAvIjXy3F44yW6Pou5k8Dy1swsYDWJZLeoK2r8G4cFDnE9nosRppc2eKc1T8TRTQ
参数
取值
symbol
BTCUSDT
side
SELL
type
LIMIT
timeInForce
GTC
quantity
1
price
0.2
recvWindow
5000
timestamp
1668481559918
有列出参数的签名 payload：
symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=0.2×tamp=1668481559918&recvWindow=5000
第1步: Payload
将参数列表排列成一个 string。 用 & 分隔每个参数。对于上述参数，签名 payload 如右所示。
第2步: 计算签名
2.1 - 将签名有效负载编码为 ASCII 数据。
第2.2步
$ echo -n 'symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=0.2×tamp=1668481559918&recvWindow=5000' | openssl dgst -sha256 -sign ./test-prv-key.pem
2.2 - 使用带有 SHA-256 hash 函数的 RSASSA-PKCS1-v1_5 算法对 payload 进行签名。
第2.3步
$ echo -n 'symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=0.2×tamp=1668481559918&recvWindow=5000' | openssl dgst -sha256 -sign ./test-prv-key.pem | openssl enc -base64 -A
HZ8HOjiJ1s/igS9JA+n7+7Ti/ihtkRF5BIWcPIEluJP6tlbFM/Bf44LfZka/iemtahZAZzcO9TnI5uaXh3++lrqtNonCwp6/245UFWkiW1elpgtVAmJPbogcAv6rSlokztAfWk296ZJXzRDYAtzGH0gq7CgSJKfH+XxaCmR0WcvlKjNQnp12/eKXJYO4tDap8UCBLuyxDnR7oJKLHQHJLP0r0EAVOOSIbrFang/1WOq+Jaq4Efc4XpnTgnwlBbWTmhWDR1pvS9iVEzcSYLHT/fNnMRxFc7u+j3qI//5yuGuu14KR0MuQKKCSpViieD+fIti46sxPTsjSemoUKp0oXA==
2.3 - 将输出编码为 base64 string。
第2.4步
HZ8HOjiJ1s%2FigS9JA%2Bn7%2B7Ti%2FihtkRF5BIWcPIEluJP6tlbFM%2FBf44LfZka%2FiemtahZAZzcO9TnI5uaXh3%2B%2BlrqtNonCwp6%2F245UFWkiW1elpgtVAmJPbogcAv6rSlokztAfWk296ZJXzRDYAtzGH0gq7CgSJKfH%2BXxaCmR0WcvlKjNQnp12%2FeKXJYO4tDap8UCBLuyxDnR7oJKLHQHJLP0r0EAVOOSIbrFang%2F1WOq%2BJaq4Efc4XpnTgnwlBbWTmhWDR1pvS9iVEzcSYLHT%2FfNnMRxFc7u%2Bj3qI%2F%2F5yuGuu14KR0MuQKKCSpViieD%2BfIti46sxPTsjSemoUKp0oXA%3D%3D
2.4 - 由于签名可能包含 / 和 =，这可能会导致发送请求时出现问题。 所以签名必须是 URL 编码的。
第2.5步
curl -H "X-MBX-APIKEY: CAvIjXy3F44yW6Pou5k8Dy1swsYDWJZLeoK2r8G4cFDnE9nosRppc2eKc1T8TRTQ" -X POST 'https://api.binance.com/api/v3/order?symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=0.2×tamp=1668481559918&recvWindow=5000&signature=HZ8HOjiJ1s%2FigS9JA%2Bn7%2B7Ti%2FihtkRF5BIWcPIEluJP6tlbFM%2FBf44LfZka%2FiemtahZAZzcO9TnI5uaXh3%2B%2BlrqtNonCwp6%2F245UFWkiW1elpgtVAmJPbogcAv6rSlokztAfWk296ZJXzRDYAtzGH0gq7CgSJKfH%2BXxaCmR0WcvlKjNQnp12%2FeKXJYO4tDap8UCBLuyxDnR7oJKLHQHJLP0r0EAVOOSIbrFang%2F1WOq%2BJaq4Efc4XpnTgnwlBbWTmhWDR1pvS9iVEzcSYLHT%2FfNnMRxFc7u%2Bj3qI%2F%2F5yuGuu14KR0MuQKKCSpViieD%2BfIti46sxPTsjSemoUKp0oXA%3D%3D'
2.5 - curl 命令
Bash 脚本
#!/usr/bin/env bash
# 设置身份验证：
API_KEY="替换成您的 API Key"
PRIVATE_KEY_PATH="test-prv-key.pem"
# 设置您的请求:
API_METHOD="POST"
API_CALL="api/v3/order"
API_PARAMS="symbol=BTCUSDT&side=SELL&type=LIMIT&timeInForce=GTC&quantity=1&price=0.2"
# 计算签名：
timestamp=$(date +%s000)
api_params_with_timestamp="$API_PARAMS×tamp=$timestamp"
signature=$(echo -n "$api_params_with_timestamp" \
| openssl dgst -sha256 -sign "$PRIVATE_KEY_PATH" \
| openssl enc -base64 -A)
# 发送请求：
curl -H "X-MBX-APIKEY: $API_KEY" -X "$API_METHOD" \
"https://api.binance.com/$API_CALL?$api_params_with_timestamp" \
--data-urlencode "signature=$signature"
右边有示例 Bash 脚本执行上述类似的步骤.
POST /api/v3/order 的示例 - Ed25519 Keys
*我们建议使用 Ed25519 API keys**，因为它在所有受支持的 API key 类型中提供最佳性能和安全性。
参数
取值
symbol
BTCUSDT
side
SELL
type
LIMIT
timeInForce
GTC
quantity
1
price
0.2
timestamp
1668481559918
Python 脚本
#!/usr/bin/env python3
import base64
import requests
import time
from cryptography.hazmat.primitives.serialization import load_pem_private_key
# 设置身份验证：
API_KEY='替换成您的 API Key'
PRIVATE_KEY_PATH='test-prv-key.pem'
# 加载 private key。
# 在这个例子中，private key 没有加密，但我们建议使用强密码以提高安全性。
with open(PRIVATE_KEY_PATH, 'rb') as f:
private_key = load_pem_private_key(data=f.read(), password=None)
# 设置请求参数：
params = {
'symbol': 'BTCUSDT',
'side': 'SELL',
'type': 'LIMIT',
'timeInForce': 'GTC',
'quantity': '1.0000000',
'price': '0.20',
}
# 参数中加时间戳：
timestamp = int(time.time() * 1000) # 以毫秒为单位的 UNIX 时间戳
params['timestamp'] = timestamp
# 参数中加签名：
payload = '&'.join([f'{param}={value}' for param, value in params.items()])
signature = base64.b64encode(private_key.sign(payload.encode('ASCII')))
params['signature'] = signature
# 发送请求：
headers = {
'X-MBX-APIKEY': API_KEY,
}
response = requests.post(
'https://api.binance.com/api/v3/order',
headers=headers,
data=params,
)
print(response.json())
右边有 Python 脚本来示例如何使用 Ed25519 key 签名。
公开 API 参数术语
这里的术语适用于全部文档，建议特别是新手熟读，也便于理解。
base asset 指一个交易对的交易对象，即写在靠前部分的资产名, 比如BTCUSDT, BTC是base asset。
quote asset 指一个交易对的定价资产，即写在靠后部分的资产名, 比如BTCUSDT, USDT是quote asset。
枚举定义
交易对状态 (状态 status):
PRE_TRADING 交易前
TRADING 交易中
POST_TRADING 交易后
END_OF_DAY
HALT
AUCTION_MATCH
BREAK
交易对类型:
SPOT 现货
MARGIN 杠杆
LEVERAGED 杠杆代币
TRD_GRP_002 交易组 002
TRD_GRP_003 交易组 003
TRD_GRP_004 交易组 004
TRD_GRP_005 交易组 005
TRD_GRP_006 交易组 006
TRD_GRP_007 交易组 007
TRD_GRP_008 交易组 008
TRD_GRP_009 交易组 009
TRD_GRP_010 交易组 010
TRD_GRP_011 交易组 011
TRD_GRP_012 交易组 012
TRD_GRP_013 交易组 013
TRD_GRP_014 交易组 014
TRD_GRP_015 交易组 015
TRD_GRP_016 交易组 016
TRD_GRP_017 交易组 017
TRD_GRP_018 交易组 018
TRD_GRP_019 交易组 019
TRD_GRP_020 交易组 020
TRD_GRP_021 交易组 021
TRD_GRP_022 交易组 022
TRD_GRP_023 交易组 023
TRD_GRP_024 交易组 024
TRD_GRP_025 交易组 025
订单状态 (状态 status):
状态
描述
NEW
订单被交易引擎接
PARTIALLY_FILLED
部分订单被成交
FILLED
订单完全成交
CANCELED
用户撤销了订单
PENDING_CANCEL
撤销中（目前并未使用）
REJECTED
订单没有被交易引擎接受，也没被处理
EXPIRED
订单被交易引擎取消，比如：LIMIT FOK 订单没有成交市价单没有完全成交强平期间被取消的订单交易所维护期间被取消的订单
EXPIRED_IN_MATCH
表示订单由于 STP 触发而过期 （e.g. 带有 EXPIRE_TAKER 的订单与订单簿上属于同账户或同 tradeGroupId 的订单撮合）
OCO 状态 (状态类型集 listStatusType):
状态
描述
RESPONSE
当ListStatus响应失败的操作时使用。 (订单完成或取消订单)
EXEC_STARTED
当已经下单或者订单有更新时
ALL_DONE
当订单执行结束或者不在激活状态
OCO 订单状态 (订单状态集 listOrderStatus):
状态
描述
EXECUTING
当已经下单或者订单有更新时
ALL_DONE
当订单执行结束或者不在激活状态
REJECT
当订单状态响应失败(订单完成或取消订单)
指定订单的类型
OCO 选择性委托订单
分配类型 (allocationtype, type):
SOR 智能订单路由
工作平台
EXCHANGE - 常规交易
SOR - 智能订单路由
订单类型 (orderTypes, type):
LIMIT 限价单
MARKET 市价单
STOP_LOSS 止损单
STOP_LOSS_LIMIT 限价止损单
TAKE_PROFIT 止盈单
TAKE_PROFIT_LIMIT 限价止盈单
LIMIT_MAKER 限价只挂单
订单返回类型 (newOrderRespType):
ACK
RESULT
FULL
订单方向 (方向 side):
BUY 买入
SELL 卖出
有效方式 (timeInForce):
这里定义了订单多久能够失效
状态
描述
GTC
成交为止 订单会一直有效，直到被成交或者取消。
IOC
无法立即成交的部分就撤销 订单在失效前会尽量多的成交。
FOK
无法全部立即成交就撤销 如果无法全部成交，订单会失效。
K线间隔:
s -> 秒; m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月
1s
1m
3m
5m
15m
30m
1h
2h
4h
6h
8h
12h
1d
3d
1w
1M
限制种类 (rateLimitType)
REQUEST_WEIGHT
{
"rateLimitType": "REQUEST_WEIGHT",
"interval": "MINUTE",
"intervalNum": 1,
"limit": 6000
}
ORDERS
{
"rateLimitType": "ORDERS",
"interval": "SECOND",
"intervalNum": 10,
"limit": 100
},
{
"rateLimitType": "ORDERS",
"interval": "DAY",
"intervalNum": 1,
"limit": 200000
}
RAW_REQUESTS
{
"rateLimitType": "RAW_REQUESTS",
"interval": "MINUTE",
"intervalNum": 5,
"limit": 5000
}
REQUEST_WEIGHT 单位时间请求权重之和上限
ORDERS 单位时间下单次数限制
RAW_REQUESTS 单位时间请求次数上限
限制间隔 (interval)
SECOND 秒
MINUTE 分
DAY 天
过滤器
过滤器，即Filter，定义了一系列交易规则。 共有两类，分别是针对交易对的过滤器symbol filters，和针对整个交易所的过滤器 exchange filters
交易对过滤器PRICE_FILTER 价格过滤器
/exchangeInfo 响应中的格式:
{
"filterType": "PRICE_FILTER",
"minPrice": "0.00000100",
"maxPrice": "100000.00000000",
"tickSize": "0.00000100"
}
价格过滤器 用于检测订单中 price 参数的合法性。包含以下三个部分:
minPrice 定义了 price/stopPrice 允许的最小值。
maxPrice 定义了 price/stopPrice 允许的最大值。
tickSize 定义了 price/stopPrice 的步进间隔，即price必须等于minPrice+(tickSize的整数倍)
以上每一项均可为0，为0时代表这一项不再做限制。
逻辑伪代码如下:
price >= minPrice
price <= maxPrice
price % tickSize == 0
PERCENT_PRICE 价格振幅过滤器
/exchangeInfo 响应中的格式:
{
"filterType": "PERCENT_PRICE",
"multiplierUp": "5",
"multiplierDown": "0.2",
"avgPriceMins": 5
}
PERCENT_PRICE过滤器基于先前交易的平均值来定义价格的有效范围。
avgPriceMins是计算平均价格的分钟数。 0表示使用最后的价格。
为了通过"价格百分比"，"价格"必须符合以下条件：
price <=weightedAveragePrice *multiplierUp
price> =weightedAveragePrice *multiplierDown
PERCENT_PRICE_BY_SIDE 基于买卖方向的价格振幅过滤器
ExchangeInfo format:
{
"filterType": "PERCENT_PRICE_BY_SIDE",
"bidMultiplierUp": "1.2",
"bidMultiplierDown": "0.2",
"askMultiplierUp": "5",
"askMultiplierDown": "0.8",
"avgPriceMins": 1
}
PERCENT_PRICE_BY_SIDE 过滤器定义了基于交易对平均价格的合法价格范围. 取决于BUY或者SELL, 价格范围可能有所不同.
avgPriceMins 是用来计算平均价格的分钟数. 0 表示用最新价(last price).
买向订单需要满足:
Order price <= weightedAveragePrice * bidMultiplierUp
Order price >= weightedAveragePrice * bidMultiplierDown
卖向订单需要满足:
Order Price <= weightedAveragePrice * askMultiplierUp
Order Price >= weightedAveragePrice * askMultiplierDown
LOT_SIZE 订单尺寸
/exchangeInfo 响应中的格式:
{
"filterType": "LOT_SIZE",
"minQty": "0.00100000",
"maxQty": "100000.00000000",
"stepSize": "0.00100000"
}
Lots是拍卖术语，LOT_SIZE 过滤器对订单中的 quantity 也就是数量参数进行合法性检查。包含三个部分:
minQty 表示 quantity/icebergQty 允许的最小值。
maxQty 表示 quantity/icebergQty 允许的最大值。
stepSize 表示 quantity/icebergQty 允许的步进值。
逻辑伪代码如下:
quantity >= minQty
quantity <= maxQty
quantity % stepSize == 0
MIN_NOTIONAL 最小名义价值(成交额)
/exchangeInfo 响应中的格式:
{
"filterType": "MIN_NOTIONAL",
"minNotional": "0.00100000",
"applyToMarket": true,
"avgPriceMins": 5
}
MIN_NOTIONAL过滤器定义了交易对订单所允许的最小名义价值(成交额)。
订单的名义价值是价格*数量。
如果是高级订单(比如止盈止损订单STOP_LOSS_LIMIT)，名义价值会按照stopPrice * quantity来计算。
如果是冰山订单，名义价值会按照price * icebergQty来计算。
applyToMarket确定 MIN_NOTIONAL过滤器是否也将应用于MARKET订单。
由于MARKET订单没有价格，因此会在最后avgPriceMins分钟内使用平均价格。
avgPriceMins是计算平均价格的分钟数。 0表示使用最后的价格。
NOTIONAL 名义价值
/exchangeInfo 响应中的格式:
{
"filterType": "NOTIONAL",
"minNotional": "10.00000000",
"applyMinToMarket": false,
"maxNotional": "10000.00000000",
"applyMaxToMarket": false,
"avgPriceMins": 5
}
名义价值过滤器(NOTIONAL)定义了订单在一个交易对上可以下单的名义价值区间.
applyMinToMarket 定义了 minNotional 是否适用于市价单(MARKET)
applyMaxToMarket 定义了 maxNotional 是否适用于市价单(MARKET).
要通过此过滤器, 订单的名义价值 (单价 x 数量, price * quantity) 需要满足如下条件:
price * quantity <= maxNotional
price * quantity >= minNotional
对于市价单(MARKET), 用于计算的价格采用的是在 avgPriceMins 定义的时间之内的平均价.
如果 avgPriceMins 为 0, 则采用最新的价格.
ICEBERG_PARTS 冰山订单拆分数
/exchangeInfo 响应中的格式:
{
"filterType": "ICEBERG_PARTS",
"limit": 10
}
ICEBERG_PARTS 代表冰山订单最多可以拆分成多少个小订单。
计算方法为 向上取整(qty / icebergQty)。
MARKET_LOT_SIZE 市价订单尺寸
**/exchangeInfo 响应中的格式:*
{
"filterType": "MARKET_LOT_SIZE",
"minQty": "0.00100000",
"maxQty": "100000.00000000",
"stepSize": "0.00100000"
}
MARKET_LOT_SIZE过滤器为交易对上的MARKET订单定义了数量(即拍卖中的"手数")规则。 共有3部分：
minQty定义了允许的最小quantity。
maxQty定义了允许的最大数量。
stepSize定义了可以增加/减少数量的间隔。
为了通过market lot size，quantity必须满足以下条件：
quantity >= minQty
quantity <= maxQty
quantity % stepSize == 0
MAX_NUM_ORDERS 最多订单数
/exchangeInfo 响应中的格式:
{
"filterType": "MAX_NUM_ORDERS",
"maxNumOrders": 25
}
定义了某个交易对最多允许的挂单数量(不包括已关闭的订单)
普通订单与条件订单均计算在内
MAX_NUM_ALGO_ORDERS 最多条件单数
/exchangeInfo 响应中的格式:
{
"filterType": "MAX_NUM_ALGO_ORDERS",
"maxNumAlgoOrders": 5
}
MAX_NUM_ALGO_ORDERS过滤器定义允许账户在交易对上开设的"algo"订单的最大数量。
"Algo"订单是STOP_LOSS，STOP_LOSS_LIMIT，TAKE_PROFIT和TAKE_PROFIT_LIMIT止盈止损单。
MAX_NUM_ICEBERG_ORDERS 最多冰山单数
MAX_NUM_ICEBERG_ORDERS过滤器定义了允许在交易对上开设账户的ICEBERG订单的最大数量。
ICEBERG订单是icebergQty大于0的任何订单。.
/exchangeInfo 响应中的格式:
{
"filterType": "MAX_NUM_ICEBERG_ORDERS",
"maxNumIcebergOrders": 5
}
MAX_POSITION 过滤器
这个过滤器定义账户允许的基于base asset的最大仓位。一个用户的仓位可以定义为如下资产的总和:
1. base asset的可用余额
1. base asset的锁定余额
1. 所有处于open的买单的数量总和
如果用户的仓位大于最大的允许仓位，买单会被拒绝。
如果一个订单的数量(quantity) 可能导致持有仓位溢出, 会触发过滤器 MAX_POSITION.
/exchangeInfo 响应中的格式:
{
"filterType": "MAX_POSITION",
"maxPosition": "10.00000000"
}
TRAILING_DELTA
ExchangeInfo format:
{
"filterType": "TRAILING_DELTA",
"minTrailingAboveDelta": 10,
"maxTrailingAboveDelta": 2000,
"minTrailingBelowDelta": 10,
"maxTrailingBelowDelta": 2000
}
此过滤器定义了参数trailingDelta的最大和最小值.
下追踪止损订单, 需要满足条件:
对于 STOP_LOSS BUY, STOP_LOSS_LIMIT_BUY, TAKE_PROFIT SELL 和 TAKE_PROFIT_LIMIT SELL 订单:
trailingDelta >= minTrailingAboveDelta
trailingDelta <= maxTrailingAboveDelta
对于 STOP_LOSS SELL, STOP_LOSS_LIMIT SELL, TAKE_PROFIT BUY, 和 TAKE_PROFIT_LIMIT BUY 订单:
trailingDelta >= minTrailingBelowDelta
trailingDelta <= maxTrailingBelowDelta
交易所级别过滤器EXCHANGE_MAX_NUM_ORDERS 最多订单数
/exchangeInfo 响应中的格式:
{
"filterType": "EXCHANGE_MAX_NUM_ORDERS",
"maxNumOrders": 1000
}
EXCHANGE_MAX_NUM_ORDERS过滤器定义了允许在交易对上开设账户的最大订单数。
请注意，此过滤器同时计算"algo"订单和常规订单。
EXCHANGE_MAX_ALGO_ORDERS 交易最大ALGO订单数
/exchangeInfo 响应中的格式:
{
"filterType": "EXCHANGE_MAX_ALGO_ORDERS",
"maxNumAlgoOrders": 200
}
EXCHANGE_MAX_ALGO_ORDERS过滤器定义了允许在交易上开设账户的"algo"订单的最大数量。
"Algo"订单是STOP_LOSS，STOP_LOSS_LIMIT，TAKE_PROFIT和TAKE_PROFIT_LIMIT订单。
EXCHANGE_MAX_NUM_ICEBERG_ORDERS 冰山订单的最大订单数
此过滤器定义了允许账号持有的最大冰山订单数量.
/exchangeInfo 响应中的格式:
{
"filterType": "EXCHANGE_MAX_NUM_ICEBERG_ORDERS",
"maxNumIcebergOrders": 10000
}
钱包接口系统状态(System)
响应
{
"status": 0, // 0: 正常，1：系统维护
"msg": "normal" // "normal", "system_maintenance"
}
GET /sapi/v1/system/status
获取系统状态。
权重(IP):
1
获取所有币信息 (USER_DATA)
获取针对用户的所有(Binance支持充提操作的)币种信息。
响应
[
{
"coin": "BTC",
"depositAllEnable": true,
"free": "0.08074558",
"freeze": "0.00000000",
"ipoable": "0.00000000",
"ipoing": "0.00000000",
"isLegalMoney": false,
"locked": "0.00000000",
"name": "Bitcoin",
"networkList": [
{
"addressRegex": "^(bnb1)[0-9a-z]{38}$",
"coin": "BTC",
"depositDesc": "Wallet Maintenance, Deposit Suspended", // 仅在充值关闭时返回
"depositEnable": false,
"isDefault": false,
"memoRegex": "^[0-9A-Za-z\\-_]{1,120}$",
"minConfirm": 1, // 上账所需的最小确认数
"name": "BEP2",
"network": "BNB",
"resetAddressStatus": false,
"specialTips": "Both a MEMO and an Address are required to successfully deposit your BEP2-BTCB tokens to Binance.",
"unLockConfirm": 0, // 解锁需要的确认数
"withdrawDesc": "Wallet Maintenance, Withdrawal Suspended", // 仅在提现关闭时返回
"withdrawEnable": false,
"withdrawFee": "0.00000220",
"withdrawIntegerMultiple": "0.00000001",
"withdrawMax": "9999999999.99999999",
"withdrawMin": "0.00000440",
"sameAddress": true, // 是否需要memo
"estimatedArrivalTime": 25,
"busy": false
},
{
"addressRegex": "^[13][a-km-zA-HJ-NP-Z1-9]{25,34}$|^(bc1)[0-9A-Za-z]{39,59}$",
"coin": "BTC",
"depositEnable": true,
"isDefault": true,
"memoRegex": "",
"minConfirm": 1, // 上账所需的最小确认数
"name": "BTC",
"network": "BTC",
"resetAddressStatus": false,
"specialTips": "",
"unLockConfirm": 0, // 解锁需要的确认数
"withdrawEnable": true,
"withdrawFee": "0.00050000",
"withdrawIntegerMultiple": "0.00000001",
"withdrawMax": "750",
"withdrawMin": "0.00100000",
"sameAddress": false,
"estimatedArrivalTime": 25,
"busy": false
}
],
"storage": "0.00000000",
"trading": true,
"withdrawAllEnable": true,
"withdrawing": "0.00000000"
}
]
GET /sapi/v1/capital/config/getall
权重(IP):
10
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询每日资产快照 (USER_DATA)
响应
{
"code":200, // 200表示返回正确，否则即为错误码
"msg":"", // 与错误码对应的报错信息
"snapshotVos":[
{
"data":{
"balances":[
{
"asset":"BTC",
"free":"0.09905021",
"locked":"0.00000000"
},
{
"asset":"USDT",
"free":"1.89109409",
"locked":"0.00000000"
}
],
"totalAssetOfBtc":"0.09942700"
},
"type":"spot",
"updateTime":1576281599000
}
]
}
或
{
"code":200, // 200表示返回正确，否则即为错误码
"msg":"", // 与错误码对应的报错信息
"snapshotVos":[
{
"data":{
"marginLevel":"2748.02909813",
"totalAssetOfBtc":"0.00274803",
"totalLiabilityOfBtc":"0.00000100",
"totalNetAssetOfBtc":"0.00274750",
"userAssets":[
{
"asset":"XRP",
"borrowed":"0.00000000",
"free":"1.00000000",
"interest":"0.00000000",
"locked":"0.00000000",
"netAsset":"1.00000000"
}
]
},
"type":"margin",
"updateTime":1576281599000
}
]
}
或
{
"code":200, // 200表示返回正确，否则即为错误码
"msg":"", // 与错误码对应的报错信息
"snapshotVos":[
{
"data":{
"assets":[
{
"asset":"USDT",
"marginBalance":"118.99782335", // 不会实时更新，可以忽略
"walletBalance":"120.23811389"
}
],
"position":[
{
"entryPrice":"7130.41000000",
"markPrice":"7257.66239673",
"positionAmt":"0.01000000",
"symbol":"BTCUSDT",
"unRealizedProfit":"1.24029054" // 只显示开仓当时的未实现盈亏，不会实时更新，可以忽略
}
]
},
"type":"futures",
"updateTime":1576281599000
}
]
}
GET /sapi/v1/accountSnapshot
权重(IP):
2400
参数:
名称
类型
是否必需
描述
type
STRING
YES
"SPOT", "MARGIN", "FUTURES"
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
min 7, max 30, default 7
recvWindow
LONG
NO
timestamp
LONG
YES
查询时间范围最大不得超过30天
仅支持查询最近 1 个月数据
若startTime和endTime没传，则默认返回最近7天数据
关闭站内划转 (USER_DATA)
响应
{}
POST /sapi/v1/account/disableFastWithdrawSwitch
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
注意:
此请求会关闭您账户的站内快速划转。您需要为api-key开通"trade"权限才能发送此请求。
开启站内划转 (USER_DATA)
响应
{}
POST /sapi/v1/account/enableFastWithdrawSwitch
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
此请求会开启您账户的站内快速划转。您需要为api-key开通"trade"权限才能发送此请求。
开启以后, 如果收款方为币安账户地址，转账费用为0, 速度快, 不需要提交上链请求。
提币 (USER_DATA)
响应
{
"id":"7213fea8e94b4a5593d507237e5a555b"
}
POST /sapi/v1/capital/withdraw/apply
Submit a withdraw request.
权重(UID):
600
参数:
名称
类型
是否必需
描述
coin
STRING
YES
withdrawOrderId
STRING
NO
自定义提币ID
network
STRING
NO
提币网络
address
STRING
YES
提币地址
addressTag
STRING
NO
某些币种例如 XRP,XMR 允许填写次级地址标签
amount
DECIMAL
YES
数量
transactionFeeFlag
BOOLEAN
NO
当站内转账时免手续费, true: 手续费归资金转入方; false: 手续费归资金转出方; . 默认 false.
name
STRING
NO
地址的备注，填写该参数后会加入该币种的提现地址簿。地址簿上限为20，超出后会造成提现失败。地址中的空格需要encode成%20
walletType
INTEGER
NO
表示出金使用的钱包，0为现货钱包，1为资金钱包。默认walletType为"充币账户"是您设置在钱包->现货账户或资金账户->充值。
recvWindow
LONG
NO
timestamp
LONG
YES
如果不发送 network, 将按该币种默认网络返回结果；
可以在接口Get /sapi/v1/capital/config/getall (HMAC SHA256)的返回值中某币种的networkList 获取 network网络字段和isDefault是否为默认网络。
获取充值历史(支持多网络) (USER_DATA)
响应
[
{
"id": "769800519366885376",
"amount": "0.001",
"coin": "BNB",
"network": "BNB",
"status": 0,
"address": "bnb136ns6lfw4zs5hg4n85vdthaad7hq5m4gtkgf23",
"addressTag": "101764890",
"txId": "98A3EA560C6B3336D348B6C83F0F95ECE4F1F5919E94BD006E5BF3BF264FACFC",
"insertTime": 1661493146000,
"transferType": 0,
"confirmTimes": "1/1",
"unlockConfirm": 0,
"walletType": 0
},
{
"id": "769754833590042625",
"amount":"0.50000000",
"coin":"IOTA",
"network":"IOTA",
"status":1,
"address":"SIZ9VLMHWATXKV99LH99CIGFJFUMLEHGWVZVNNZXRJJVWBPHYWPPBOSDORZ9EQSHCZAMPVAPGFYQAUUV9DROOXJLNW",
"addressTag":"",
"txId":"ESBFVQUTPIWQNJSPXFNHNYHSQNTGKRVKPRABQWTAXCDWOAKDKYWPTVG9BGXNVNKTLEJGESAVXIKIZ9999",
"insertTime":1599620082000,
"transferType":0,
"confirmTimes": "1/1",
"unlockConfirm": 0,
"walletType": 0
}
]
GET /sapi/v1/capital/deposit/hisrec
权重(IP):
1
参数:
名称
类型
是否必需
描述
includeSource
Boolean
NO
默认 false，如果为true时会返回sourceAddress字段
coin
STRING
NO
status
INT
NO
0(0:pending,6: credited but cannot withdraw,7=Wrong Deposit,8=Waiting User confirm,1:success)
startTime
LONG
NO
默认当前时间90天前的时间戳
endTime
LONG
NO
默认当前时间戳
offset
INT
NO
默认:0
limit
INT
NO
默认：1000，最大1000
recvWindow
LONG
NO
timestamp
LONG
YES
txId
STRING
NO
请注意startTime 与 endTime 的默认时间戳，保证请求时间间隔不超过90天.
同时提交startTime 与 endTime间隔不得超过90天.
请注意，由于网络特定的特性，返回的源地址可能不准确。 如果找到多个源地址，则仅返回第一个地址
获取提币历史 (支持多网络) (USER_DATA)
响应
[
{
"id": "b6ae22b3aa844210a7041aee7589627c", // 该笔提现在币安的id
"amount": "8.91000000", // 提现转出金额
"transactionFee": "0.004", // 手续费
"coin": "USDT",
"status": 6,
"address": "0x94df8b352de7f46f64b01d3666bf6e936e44ce60",
"txId": "0xb5ef8c13b968a406cc62a93a8bd80f9e9a906ef1b3fcf20a2e48573c17659268" // 提现交易id
"applyTime": "2019-10-12 11:12:02", // UTC 时间
"network": "ETH",
"transferType": 0 // 1: 站内转账, 0: 站外转账
"withdrawOrderId": "WITHDRAWtest123", // 自定义ID, 如果没有则不返回该字段
"info": "The address is not valid. Please confirm with the recipient", // 提币失败原因
"confirmNo":3, // 提现确认数
"walletType": 1, //1: 资金钱包 0:现货钱包
"txKey": "",
"completeTime": "2023-03-23 16:52:41" // 提现完成，成功下账时间(UTC)
},
{
"id": "156ec387f49b41df8724fa744fa82719",
"amount": "0.00150000",
"transactionFee": "0.004",
"coin": "BTC",
"status": 6,
"address": "1FZdVHtiBqMrWdjPyRPULCUceZPJ2WLCsB",
"txId": "60fd9007ebfddc753455f95fafa808c4302c836e4d1eebc5a132c36c1d8ac354"
"applyTime": "2019-09-24 12:43:45",
"network": "BTC",
"transferType": 0,
"info": "",
"confirmNo": 2,
"walletType": 1,
"txKey": "",
"completeTime": "2023-03-23 16:52:41"
}
]
GET /sapi/v1/capital/withdraw/history
权重(UID):
18000
本接口特别采用每秒UID速率限制，用户的总秒级 UID 速率限制为180000/秒。从该接口收到的响应包含key X-SAPI-USED-UID-WEIGHT-1S，该key定义了当前 UID 使用的权重
请求限制: 每秒10次
参数:
名称
类型
是否必需
描述
coin
STRING
NO
withdrawOrderId
STRING
NO
status
INT
NO
0(0:已发送确认Email,1:已被用户取消 2:等待确认 3:被拒绝 4:处理中 5:提现交易失败 6 提现完成)
offset
INT
NO
limit
INT
NO
默认：1000， 最大：1000
startTime
LONG
NO
默认当前时间90天前的时间戳
endTime
LONG
NO
默认当前时间戳
recvWindow
LONG
NO
timestamp
LONG
YES
支持多网络提币前的历史记录可能不会返回network字段.
请注意startTime 与 endTime 的默认时间戳，保证请求时间间隔不得超过90天.
同时提交startTime 与 endTime间隔不得超过90天.
若传了withdrawOrderId，则请求的startTime 与 endTime的时间间隔不得超过7天.
若传了withdrawOrderId，没传startTime 与 endTime，则默认返回最近7天数据.
获取充值地址 (支持多网络) (USER_DATA)
响应
{
"address": "1HPn8Rx2y6nNSfagQBKy27GB99Vbzg89wv",
"coin": "BTC",
"tag": "",
"url": "https://btc.com/1HPn8Rx2y6nNSfagQBKy27GB99Vbzg89wv"
}
GET /sapi/v1/capital/deposit/address
权重(IP):
10
参数:
名称
类型
是否必需
描述
coin
STRING
YES
network
STRING
NO
amount
DECIMAL
NO
recvWindow
LONG
NO
timestamp
LONG
YES
如果不发送 network, 将按该币种默认网络返回结果；
可以在接口Get /sapi/v1/capital/config/getall (HMAC SHA256)的返回值中某币种的networkList 获取 network网络字段和isDefault是否为默认网络。
使用LIGHTNING网络时，amount必须传
账户状态 (USER_DATA)
响应
{
"data": "Normal"
}
GET /sapi/v1/account/status
获取账户状态详情。
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
账户API交易状态(USER_DATA)
响应
{
"data": { // 账户API交易状态详情
"isLocked": false, // API交易功能是否被锁
"plannedRecoverTime": 0, // API交易功能被锁情况下的预计恢复时间
"triggerCondition": {
"GCR": 150, // Number of GTC orders
"IFER": 150, // Number of FOK/IOC orders
"UFR": 300 // Number of orders
},
"updateTime": 1547630471725
}
}
GET /sapi/v1/account/apiTradingStatus
获取 api 账户交易状态详情。
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
小额资产转换BNB历史 (USER_DATA)
响应
{
"total": 8, //共计发生过的转换笔数
"userAssetDribblets": [
{
"operateTime": 1615985535000,
"totalTransferedAmount": "0.00132256", //本次转换所得BNB
"totalServiceChargeAmount": "0.00002699", //本次转换手续费(BNB)
"transId": 45178372831,
"userAssetDribbletDetails": [ //本次转换的细节
{
"transId": 4359321,
"serviceChargeAmount": "0.000009",
"amount": "0.0009",
"operateTime": 1615985535000,
"transferedAmount": "0.000441",
"fromAsset": "USDT"
},
{
"transId": 4359321,
"serviceChargeAmount": "0.00001799",
"amount": "0.0009",
"operateTime": 1615985535000,
"transferedAmount": "0.00088156",
"fromAsset": "ETH"
}
]
},
{
"operateTime":1616203180000,
"totalTransferedAmount": "0.00058795",
"totalServiceChargeAmount": "0.000012",
"transId": 4357015,
"userAssetDribbletDetails": [
{
"transId": 4357015,
"serviceChargeAmount": "0.00001"
"amount": "0.001",
"operateTime": 1616203180000,
"transferedAmount": "0.00049",
"fromAsset": "USDT"
},
{
"transId": 4357015,
"serviceChargeAmount": "0.000002"
"amount": "0.0001",
"operateTime": 1616203180000,
"transferedAmount": "0.00009795",
"fromAsset": "ETH"
}
]
}
]
}
}
GET /sapi/v1/asset/dribblet
权重(IP):
1
参数:
名称
类型
是否必需
描述
accountType
STRING
NO
SPOT或MARGIN,默认SPOT
startTime
LONG
NO
endTime
LONG
NO
recvWindow
LONG
NO
timestamp
LONG
YES
只返回最近100条记录
只返回 2020/12/01 之后记录
获取可以转换成BNB的小额资产 (USER_DATA)
响应
{
"details": [
{
"asset": "ADA", //资产名
"assetFullName": "ADA", //资产全称
"amountFree": "6.21", //可转换数量
"toBTC": "0.00016848", //等值BTC
"toBNB": "0.01777302", //可转换BNB（未扣除手续费）
"toBNBOffExchange": "0.01741756", //可转换BNB（已扣除手续费）
"exchange": "0.00035546" //手续费
}
],
"totalTransferBtc": "0.00016848",//全部资产等值BTC
"totalTransferBNB": "0.01777302",//总共可以转换的BNB数量
"dribbletPercentage": "0.02" //转换手续费
}
POST /sapi/v1/asset/dust-btc
获取可以转换成 BNB 的小额资产列表.
权重(IP):
1
参数:
名称
类型
是否必需
描述
accountType
STRING
NO
SPOT或MARGIN,默认SPOT
recvWindow
LONG
NO
timestamp
LONG
YES
小额资产转换 (USER_DATA)
响应
{
"totalServiceCharge":"0.02102542",
"totalTransfered":"1.05127099",
"transferResult":[
{
"amount":"0.03000000",
"fromAsset":"ETH",
"operateTime":1563368549307,
"serviceChargeAmount":"0.00500000",
"tranId":2970932918,
"transferedAmount":"0.25000000"
},
{
"amount":"0.09000000",
"fromAsset":"LTC",
"operateTime":1563368549404,
"serviceChargeAmount":"0.01548000",
"tranId":2970932918,
"transferedAmount":"0.77400000"
},
{
"amount":"248.61878453",
"fromAsset":"TRX",
"operateTime":1563368549489,
"serviceChargeAmount":"0.00054542",
"tranId":2970932918,
"transferedAmount":"0.02727099"
}
]
}
POST /sapi/v1/asset/dust
把小额资产转换成 BNB.
权重(UID):
10
参数:
名称
类型
是否必需
描述
asset
ARRAY
YES
正在转换的资产。 例如：asset=BTC,USDT
accountType
STRING
NO
SPOT或MARGIN,默认SPOT
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
资产利息记录 (USER_DATA)
响应
{
"rows":[
{
"id":1637366104,
"amount":"10.00000000",
"asset":"BHFT",
"divTime":1563189166000,
"enInfo":"BHFT distribution",
"tranId":2968885920
},
{
"id": 1631750237,
"amount":"10.00000000",
"asset":"BHFT",
"divTime":1563189165000,
"enInfo":"BHFT distribution",
"tranId":2968885920
}
],
"total":2
}
GET /sapi/v1/asset/assetDividend
获取资产利息记录。
权重(IP):
10
参数:
名称
类型
是否必需
描述
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
Default 20, max 500
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 与 endTime之间最多只可以相差180天。
上架资产详情 (USER_DATA)
响应
{
"CTR": {
"minWithdrawAmount": "70.00000000", //最小提现数量
"depositStatus": false, //是否可以充值(只有所有网络都关闭充值才为false)
"withdrawFee": 35, // 提现手续费
"withdrawStatus": true, //是否开放提现(只有所有网络都关闭提币才为false)
"depositTip": "Delisted, Deposit Suspended" //暂停充值的原因(如果暂停才有这一项)
},
"SKY": {
"minWithdrawAmount": "0.02000000",
"depositStatus": true,
"withdrawFee": 0.01,
"withdrawStatus": true
}
}
GET /sapi/v1/asset/assetDetail
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
充提币信息，建议查询 GET /sapi/v1/capital/config/getall 获取详情。
交易手续费率查询 (USER_DATA)
响应
[
{
"symbol": "ADABNB",
"makerCommission": "0.001",
"takerCommission": "0.001"
},
{
"symbol": "BNBBTC",
"makerCommission": "0.001",
"takerCommission": "0.001"
}
]
GET /sapi/v1/asset/tradeFee
权重(IP):
1
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
用户万向划转 (USER_DATA)
响应:
{
"tranId":13526853623
}
POST /sapi/v1/asset/transfer
您需要开通api key 允许万向划转权限来调用此接口。
权重(UID)):
900
参数:
名称
类型
是否必需
描述
type
ENUM
YES
asset
STRING
YES
amount
DECIMAL
YES
fromSymbol
STRING
NO
toSymbol
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
fromSymbol 必须要发送，当类型为 ISOLATEDMARGIN_MARGIN 和 ISOLATEDMARGIN_ISOLATEDMARGIN
toSymbol 必须要发送，当类型为 MARGIN_ISOLATEDMARGIN 和 ISOLATEDMARGIN_ISOLATEDMARGIN
目前支持的type划转类型:
MAIN_UMFUTURE 现货钱包转向U本位合约钱包
MAIN_CMFUTURE 现货钱包转向币本位合约钱包
MAIN_MARGIN 现货钱包转向杠杆全仓钱包
UMFUTURE_MAIN U本位合约钱包转向现货钱包
UMFUTURE_MARGIN U本位合约钱包转向杠杆全仓钱包
CMFUTURE_MAIN 币本位合约钱包转向现货钱包
MARGIN_MAIN 杠杆全仓钱包转向现货钱包
MARGIN_UMFUTURE 杠杆全仓钱包转向U本位合约钱包
MARGIN_CMFUTURE 杠杆全仓钱包转向币本位合约钱包
CMFUTURE_MARGIN 币本位合约钱包转向杠杆全仓钱包
ISOLATEDMARGIN_MARGIN 杠杆逐仓钱包转向杠杆全仓钱包
MARGIN_ISOLATEDMARGIN 杠杆全仓钱包转向杠杆逐仓钱包
ISOLATEDMARGIN_ISOLATEDMARGIN 杠杆逐仓钱包转向杠杆逐仓钱包
MAIN_FUNDING 现货钱包转向资金钱包
FUNDING_MAIN 资金钱包转向现货钱包
FUNDING_UMFUTURE 资金钱包转向U本位合约钱包
UMFUTURE_FUNDING U本位合约钱包转向资金钱包
MARGIN_FUNDING 杠杆全仓钱包转向资金钱包
FUNDING_MARGIN 资金钱包转向杠杆全仓钱包
FUNDING_CMFUTURE 资金钱包转向币本位合约钱包
CMFUTURE_FUNDING 币本位合约钱包转向资金钱包
MAIN_OPTION 现货钱包转向期权钱包
OPTION_MAIN 期权钱包转向现货钱包
UMFUTURE_OPTION U本位合约钱包转向期权钱包
OPTION_UMFUTURE 期权钱包转向U本位合约钱包
MARGIN_OPTION 杠杆全仓钱包转向期权钱包
OPTION_MARGIN 期权全仓钱包转向杠杆钱包
FUNDING_OPTION 资金钱包转向期权钱包
OPTION_FUNDING 期权钱包转向资金钱包
MAIN_PORTFOLIO_MARGIN 现货钱包转向统一账户钱包
PORTFOLIO_MARGIN_MAIN 统一账户钱包转向现货钱包
MAIN_ISOLATED_MARGIN 现货钱包转向逐仓账户钱包
ISOLATED_MARGIN_MAIN 逐仓钱包转向现货账户钱包
查询用户万向划转历史 (USER_DATA)
响应:
{
"total":2,
"rows":[
{
"asset":"USDT",
"amount":"1",
"type":"MAIN_UMFUTURE"
"status": "CONFIRMED", // status: CONFIRMED / FAILED / PENDING
"tranId": 11415955596,
"timestamp":1544433328000
},
{
"asset":"USDT",
"amount":"2",
"type":"MAIN_UMFUTURE",
"status": "CONFIRMED",
"tranId": 11366865406,
"timestamp":1544433328000
}
]
}
GET /sapi/v1/asset/transfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
type
ENUM
YES
startTime
LONG
NO
endTime
LONG
NO
current
INT
NO
默认 1
size
INT
NO
默认 10, 最大 100
fromSymbol
STRING
NO
toSymbol
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
fromSymbol 必须要发送，当类型为 ISOLATEDMARGIN_MARGIN 和 ISOLATEDMARGIN_ISOLATEDMARGIN
toSymbol 必须要发送，当类型为 MARGIN_ISOLATEDMARGIN 和 ISOLATEDMARGIN_ISOLATEDMARGIN
仅支持查询最近半年（6个月）数据
若startTime和endTime没传，则默认返回最近7天数据
资金账户 (USER_DATA)
响应
[
{
"asset": "USDT",
"free": "1", // 可用余额
"locked": "0", // 锁定资金
"freeze": "0", //冻结资金
"withdrawing": "0", // 提币
"btcValuation": "0.00000091" // btc估值
}
]
POST /sapi/v1/asset/get-funding-asset
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
NO
needBtcValuation
STRING
NO
true or false
recvWindow
LONG
NO
timestamp
LONG
YES
目前仅支持查询以下业务资产：Binance Pay, Binance Card, Binance Gift Card, Stock Token
用户持仓 (USER_DATA)
响应
[
{
"asset": "AVAX",
"free": "1",
"locked": "0",
"freeze": "0",
"withdrawing": "0",
"ipoable": "0",
"btcValuation": "0"
},
{
"asset": "BCH",
"free": "0.9",
"locked": "0",
"freeze": "0",
"withdrawing": "0",
"ipoable": "0",
"btcValuation": "0"
},
{
"asset": "BNB",
"free": "887.47061626",
"locked": "0",
"freeze": "10.52",
"withdrawing": "0.1",
"ipoable": "0",
"btcValuation": "0"
},
{
"asset": "BUSD",
"free": "9999.7",
"locked": "0",
"freeze": "0",
"withdrawing": "0",
"ipoable": "0",
"btcValuation": "0"
},
{
"asset": "SHIB",
"free": "532.32",
"locked": "0",
"freeze": "0",
"withdrawing": "0",
"ipoable": "0",
"btcValuation": "0"
},
{
"asset": "USDT",
"free": "50300000001.44911105",
"locked": "0",
"freeze": "0",
"withdrawing": "0",
"ipoable": "0",
"btcValuation": "0"
},
{
"asset": "WRZ",
"free": "1",
"locked": "0",
"freeze": "0",
"withdrawing": "0",
"ipoable": "0",
"btcValuation": "0"
}
]
POST /sapi/v3/asset/getUserAsset
获取用户持仓，仅返回>0的数据。
权重(IP):
5
参数:
名称
类型
是否必需
描述
asset
STRING
NO
如果资产为空，则查询用户所有的正资产。
needBtcValuation
BOOLEAN
NO
是否需要返回兑换成BTC的估值
recvWindow
LONG
NO
timestamp
LONG
YES
稳定币自动兑换划转 (TRADE)
响应
{
"tranId": 118263407119,
"status": "S"
}
POST /sapi/v1/asset/convert-transfer
稳定币和BUSD之间的自动划转
权重(UID):
5
参数
名称
类型
是否必需
描述
clientTranId
STRING
YES
用户自定义流水号，唯一标志，限制最短长度为20
asset
STRING
YES
当前资产
amount
BigDecimal
YES
数量必须为正数
targetAsset
String
YES
目标资产
accountType
String
NO
仅支持MAIN和CARD，如果为空，默认查询主账户MAIN
如果clientTranId你之前使用过，不会进行第二次自动转化，而是把之前划转的结果返回
稳定币自动兑换划转查询 (USER_DATA)
响应
{
"total":3,
"rows":
[
{
"tranId":118263615991,
"type":244,
"time":1664442078000,
"deductedAsset":"BUSD",
"deductedAmount":"1",
"targetAsset":"USDC",
"targetAmount":"1",
"status":"S",
"accountType":"MAIN"
},{
"tranId":118263598801,
"type":244,
"time":1664442061000,
"deductedAsset":"BUSD",
"deductedAmount":"1",
"targetAsset":"USDC",
"targetAmount":"1",
"status":"S",
"accountType":"MAIN"
},{
"tranId":118263407119,
"type":244,
"time":1664441820000,
"deductedAsset":"BUSD",
"deductedAmount":"1",
"targetAsset":"USDC",
"targetAmount":"1",
"status":"S",
"accountType":"MAIN"
}
]
}
GET /sapi/v1/asset/convert-transfer/queryByPage
权重(UID):
5
参数
名称
类型
是否必需
描述
tranId
LONG
NO
流水号
clientTranId
STRING
NO
用户自定义流水号
asset
STRING
NO
不传或者空字符串查全部, 匹配扣除币种和目标币种
startTime
LONG
YES
开始时间（包含），单位：毫秒
endTime
LONG
YES
结束时间（不包含），单位：毫秒
accountType
STRING
NO
账户类型: MAIN-主账户。CARD-资金账户。如果传入则仅返回对应wallet的记录，不传或者传null则返回该用户spot和card钱包的记录。
current
INTEGER
NO
当前页面，默认1，最小值为1
size
INTEGER
NO
页面大小，默认10，最大值为100
types类型:
244 sapi请求兑换
11 入金自动兑换
32 提现自动兑换
34 提现失败
254 busd自动兑换任务
云算力历史记录分页查询 (USER_DATA)
响应:
{
"total":5,
"rows":[
{"createTime":1667880112000,"tranId":121230610120,"type":248,"asset":"USDT","amount":"25.0068","status":"S"},
{"createTime":1666776366000,"tranId":119991507468,"type":249,"asset":"USDT","amount":"0.027","status":"S"},
{"createTime":1666764505000,"tranId":119977966327,"type":248,"asset":"USDT","amount":"0.027","status":"S"},
{"createTime":1666758189000,"tranId":119973601721,"type":248,"asset":"USDT","amount":"0.018","status":"S"},
{"createTime":1666757278000,"tranId":119973028551,"type":248,"asset":"USDT","amount":"0.018","status":"S"}
]
}
GET /sapi/v1/asset/ledger-transfer/cloud-mining/queryByPage
云算力支付和退款历史分页查询
权重(UID):
600
参数:
名称
类型
是否必需
描述
tranId
LONG
NO
流水号
clientTranId
STRING
NO
外部唯一流水号
asset
STRING
NO
不传或者空字符串查全部
startTime
LONG
YES
开始时间（包含），单位：毫秒
endTime
LONG
YES
结束时间（不包含），单位：毫秒
current
INTEGER
NO
当前页面，默认1，最小值为1
size
INTEGER
NO
页面大小，默认10，最大值为100
仅返回支付和退款成功的记录。
对于响应来说，type = 248 代表着支付记录，type = 249 代表着退款记录, status =S 代表成功。
查询用户API Key权限 (USER_DATA)
响应
{
"ipRestrict": false, // 是否限制ip访问
"createTime": 1623840271000, // 创建时间
"enableInternalTransfer": true, // 此选项授权此密钥在您的母账户和子账户之间划转资金
"enableFutures": false, // 合约交易权限，需注意开通合约账户之前创建的API Key不支持合约API功能
"enablePortfolioMarginTrading":true, // 统一账户交易权限
"enableVanillaOptions": false, // 欧式期权交易权限
"permitsUniversalTransfer": true, // 授权该密钥可用于专用的万向划转接口，用以操作其支持的多种类型资金划转。各业务自身的划转接口使用权限，不受本授权影响
"enableReading": true,
"enableSpotAndMarginTrading": false, // 现货和杠杆交易权限
"enableWithdrawals": false, // 此选项允许通过此api提现。开启提现选项必须添加IP访问限制过滤器
"enableMargin": false // 此选项在全仓账户完成划转后可编辑
}
GET /sapi/v1/account/apiRestrictions
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询用户稳定币与 BUSD 互相转换的设置 (USER_DATA)
响应:
{
"convertEnabled": true,
"coins": [
"USDC",
"USDP",
"TUSD"
],
"exchangeRates": {
"USDC": "1",
"TUSD": "1",
"USDP": "1"
}
}
GET /sapi/v1/capital/contract/convertible-coins
查询用户充值/提现时候稳定币与 BUSD 互转的设置
权重(UID):
600
参数:
None
修改哪些稳定币可与 BUSD 互相转换(USER_DATA)
响应:
成功返回 200，无 body
POST /sapi/v1/capital/contract/convertible-coins
修改哪些稳定币可与 BUSD 互相转换
权重(UID):
600
参数:
名称
类型
是否必需
描述
coin
STRING
YES
USDC、USDP、TUSD 中的一个
enable
BOOLEAN
YES
true: 打开转换。false: 关闭转换
参数应在POST BODY
一键上账 (充值到过期地址) (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data":true,
"success": true
}
POST /sapi/v1/capital/deposit/credit-apply
申请充值到过期地址的一键上账.
权重(IP):
1
参数:
名称
类型
是否必需
描述
depositId
LONG
NO
充值记录Id，优先使用
txId
STRING
NO
充值txId，当depositId没指定时使用
subAccountId
LONG
NO
Cloud的子账户ID
subUserId
LONG
NO
母账户的子账户userId
参数应在POST BODY
查询充值地址列表(USER_DATA)
响应:
[
{
"coin": "ETH",
"address": "0xD316E95Fd9E8E237Cb11f8200Babbc5D8D177BA4",
"isDefault": 0
},
{
"coin": "ETH",
"address": "0xD316E95Fd9E8E237Cb11f8200Babbc5D8D177BA4",
"isDefault": 0
},
{
"coin": "ETH",
"address": "0x00003ada75e7da97ba0db2fcde72131f712455e2",
"isDefault": 1
}
]
GET /sapi/v1/capital/deposit/address/list
根据网络币种或币种获取充值地址列表
权重(IP):
10
参数:
名称
类型
是否必需
描述
coin
STRING
YES
coin是网络的地址空间名称
network
STRING
NO
网络
timestamp
LONG
YES
时间戳
如果没传网络，会返回网络对应的默认网络。
可以通过后面的接口，来获取网络和 isDefault 字段，在返回的响应里Get /sapi/v1/capital/config/getall.
查询用户钱包余额 (USER_DATA)
响应:
[
{
"activate": true,
"balance": "0",
"walletName": "Spot"
},
{
"activate": true,
"balance": "0",
"walletName": "Funding"
},
{
"activate": true,
"balance": "0",
"walletName": "Cross Margin"
},
{
"activate": true,
"balance": "0",
"walletName": "Isolated Margin"
},
{
"activate": true,
"balance": "0.71842752",
"walletName": "USDⓈ-M Futures"
},
{
"activate": true,
"balance": "0",
"walletName": "COIN-M Futures"
},
{
"activate": true,
"balance": "0",
"walletName": "Earn"
},
{
"activate": false,
"balance": "0",
"walletName": "Options"
}
]
GET /sapi/v1/asset/wallet/balance
查询用户钱包余额
权重(IP):
60
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Permits Universal Transfer 权限以使用此接口
查询用户委托资金历史(适用主账户)(USER_DATA)
响应:
{
"total": 3316,
"rows": [
{
"clientTranId": "293915932290879488",
"transferType": "Undelegate",
"asset": "ETH",
"amount": "1",
"time": 1695205406000
},
{
"clientTranId": "293915892281413632",
"transferType": "Delegate",
"asset": "ETH",
"amount": "1",
"time": 1695205396000
}
]
}
GET /sapi/v1/asset/custody/transfer-history
查询用户委托资金历史
权重(IP):
60
参数:
名称
类型
是否必需
描述
STRING
YES
startTime
LONG
YES
endTime
LONG
YES
type
ENUM
NO
Delegate/Undelegate
asset
STRING
NO
current
INTEGER
NO
默认 1
size
INTEGER
NO
默认 10, 最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Enable Spot & Margin Trading 权限以使用此接口
查询现货币对的下架计划 (MARKET_DATA)
GET /sapi/v1/spot/delist-schedule
查询现货币对的下架计划
响应:
[
{
"delistTime": 1686161202000,
"symbols": [
"ADAUSDT",
"BNBUSDT"
]
},
{
"delistTime": 1686222232000,
"symbols": [
"ETHUSDT"
]
}
]
权重(IP):
100
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
子母账户接口
这些接口的文档适用于企业账户。
关于如何成为企业用户，请参考: 企业账户申请。
创建虚拟子账户（适用主账户）
响应:
{
"email":"addsdd_virtual@aasaixwqnoemail.com"
}
POST /sapi/v1/sub-account/virtualSubAccount
权重(IP):
1
参数:
名称
类型
是否必需
描述
subAccountString
STRING
YES
请输入字符串，我们将为您创建一个虚拟邮箱进行注册
recvWindow
LONG
NO
timestamp
LONG
YES
该请求会为您的母账户生成一个虚拟子账户
您需要为母账户apikey开通"允许现货及杠杆交易" 权限调用此接口
查询子账户列表（适用主账户）
响应:
{
"subAccounts":[
{
"email":"testsub@gmail.com",
"isFreeze":false,
"createTime":1544433328000,
"isManagedSubAccount": false,
"isAssetManagementSubAccount": false
},
{
"email":"virtual@oxebmvfonoemail.com",
"isFreeze":false,
"createTime":1544433328000,
"isManagedSubAccount": false,
"isAssetManagementSubAccount": false
}
]
}
GET /sapi/v1/sub-account/list
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
NO
Sub-account email
isFreeze
STRING
NO
true or false
page
INT
NO
默认: 1
limit
INT
NO
默认: 1, 最大: 200
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户现货资金划转历史 (适用主账户)
响应:
[
{
"from":"aaa@test.com",
"to":"bbb@test.com",
"asset":"BTC",
"qty":"10",
"status": "SUCCESS",
"tranId": 6489943656,
"time":1544433328000
},
{
"from":"bbb@test.com",
"to":"ccc@test.com",
"asset":"ETH",
"qty":"2",
"status": "SUCCESS",
"tranId": 6489938713,
"time":1544433328000
}
]
GET /sapi/v1/sub-account/sub/transfer/history
权重(IP):
1
参数:
名称
类型
是否必需
描述
fromEmail
STRING
NO
toEmail
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
page
INT
NO
默认: 1
limit
INT
NO
默认: 500
recvWindow
LONG
NO
timestamp
LONG
YES
fromEmail 和 toEmail 不可以同时发送
若 fromEmail 和 toEmail 都未传，默认返回fromEmail 为母账户的记录。
查询子账户合约资金划转历史 (适用主账户)
响应
{
"success":true,
"futuresType": 2,
"transfers":[
{
"from":"aaa@test.com",
"to":"bbb@test.com",
"asset":"BTC",
"qty":"1",
"tranId":11897001102,
"time":1544433328000
},
{
"from":"bbb@test.com",
"to":"ccc@test.com",
"asset":"ETH",
"qty":"2",
"tranId":11631474902,
"time":1544433328000
}
]
}
GET /sapi/v1/sub-account/futures/internalTransfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
futuresType
LONG
YES
1:USDT合约，2: 币本位合约
startTime
LONG
NO
默认返回100天内历史记录
endTime
LONG
NO
默认返回100天内历史记录
page
INT
NO
默认值: 1
limit
INT
NO
默认值: 50, 最大值：500
recvWindow
LONG
NO
timestamp
LONG
YES
执行子账户合约资金划转 (适用主账户)
响应
{
"success":true,
"txnId":"2934662589"
}
POST /sapi/v1/sub-account/futures/internalTransfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
fromEmail
STRING
YES
发送者邮箱 备注
toEmail
STRING
YES
接收者邮箱 备注
futuresType
LONG
YES
1:USDT合约， 2: 币本位合约
asset
STRING
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
每个母账户每分钟上限2000次
您期货钱包中须有足够保证金余额才能执行转账
查询子账户资产 (适用主账户)
响应
{
"balances":[
{
"asset":"ADA",
"free":10000,
"locked":0
},
{
"asset":"BNB",
"free":10003,
"locked":0
},
{
"asset":"BTC",
"free":11467.6399,
"locked":0
},
{
"asset":"ETH",
"free":10004.995,
"locked":0
},
{
"asset":"USDT",
"free":11652.14213,
"locked":0
}
],
}
GET /sapi/v3/sub-account/assets
权重(UID):
60
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户现货资产汇总 (适用主账户)
响应:
{
"totalCount":2,
"masterAccountTotalAsset":"0.23231201",
"spotSubUserAssetBtcVoList":[
{
"email":"sub123@test.com",
"totalAsset":"9999.00000000"
},
{
"email":"test456@test.com",
"totalAsset":"0.00000000"
}
]
}
获取BTC计价的子账户现货资产汇总。
GET /sapi/v1/sub-account/spotSummary
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
NO
子账户邮箱
page
LONG
NO
分页，默认 1
size
LONG
NO
单页条目数, 默认 10, 最大 20
recvWindow
LONG
NO
timestamp
LONG
YES
获取子账户充值地址 (适用主账户)
响应
{
"address":"TDunhSa7jkTNuKrusUTU1MUHtqXoBPKETV",
"coin":"USDT",
"tag":"",
"url":"https://tronscan.org/#/address/TDunhSa7jkTNuKrusUTU1MUHtqXoBPKETV"
}
GET /sapi/v1/capital/deposit/subAddress (HMAC SHA256)
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
coin
STRING
YES
network
STRING
NO
amount
DECIMAL
NO
recvWindow
LONG
NO
timestamp
LONG
YES
使用LIGHTNING网络时，amount必须传
获取子账户充值记录 (适用主账户)
响应
[
{
"id": "769800519366885376",
"amount": "0.001",
"coin": "BNB",
"network": "BNB",
"status": 0,
"address": "bnb136ns6lfw4zs5hg4n85vdthaad7hq5m4gtkgf23",
"addressTag": "101764890",
"txId": "98A3EA560C6B3336D348B6C83F0F95ECE4F1F5919E94BD006E5BF3BF264FACFC",
"insertTime": 1661493146000,
"transferType": 0,
"confirmTimes": "1/1",
"unlockConfirm": 0,
"walletType": 0
},
{
"id": "769754833590042625",
"amount":"0.50000000",
"coin":"IOTA",
"network":"IOTA",
"status":1,
"address":"SIZ9VLMHWATXKV99LH99CIGFJFUMLEHGWVZVNNZXRJJVWBPHYWPPBOSDORZ9EQSHCZAMPVAPGFYQAUUV9DROOXJLNW",
"addressTag":"",
"txId":"ESBFVQUTPIWQNJSPXFNHNYHSQNTGKRVKPRABQWTAXCDWOAKDKYWPTVG9BGXNVNKTLEJGESAVXIKIZ9999",
"insertTime":1599620082000,
"transferType":0,
"confirmTimes": "1/1",
"unlockConfirm": 0,
"walletType": 0
}
]
GET /sapi/v1/capital/deposit/subHisrec
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
coin
STRING
NO
status
INT
NO
0(0:pending,6: credited but cannot withdraw,7:Wrong Deposit,8:Waiting User confirm,1:success)
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
offset
INT
NO
default:0
recvWindow
LONG
NO
timestamp
LONG
YES
txId
STRING
NO
查询子账户Margin/Futures状态 (适用主账户)
响应
[
{
"email":"123@test.com", // user email
"isSubUserEnabled": true, // true or false
"isUserActive": true, // true or false
"insertTime": 1570791523523, // sub account create time
"isMarginEnabled": true, // true or false for margin
"isFutureEnabled": true, // true or false for futures.
"mobile": 1570791523523 // user mobile number
}
]
GET /sapi/v1/sub-account/status
权重(IP):
10
参数:
名称
类型
是否必需
描述
STRING
NO
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
如果不提交子账户email，返回所有子账户情况。
为子账户开通Margin (适用主账户)
响应
{
"email":"123@test.com",
"isMarginEnabled": true
}
POST /sapi/v1/sub-account/margin/enable
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户Margin账户详情 (适用主账户)
响应
{
"email":"123@test.com",
"marginLevel": "11.64405625",
"totalAssetOfBtc": "6.82728457",
"totalLiabilityOfBtc": "0.58633215",
"totalNetAssetOfBtc": "6.24095242",
"marginTradeCoeffVo":
{
"forceLiquidationBar": "1.10000000", // 强平风险率
"marginCallBar": "1.50000000", // 补仓风险率
"normalBar": "2.00000000" // 初始风险率
},
"marginUserAssetVoList": [
{
"asset": "BTC",
"borrowed": "0.00000000",
"free": "0.00499500",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00499500"
},
{
"asset": "BNB",
"borrowed": "201.66666672",
"free": "2346.50000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "2144.83333328"
},
{
"asset": "ETH",
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000"
},
{
"asset": "USDT",
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000"
}
]
}
GET /sapi/v1/sub-account/margin/account
权重(IP):
10
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户Margin账户汇总 (适用主账户)
响应
{
"totalAssetOfBtc": "4.33333333",
"totalLiabilityOfBtc": "2.11111112",
"totalNetAssetOfBtc": "2.22222221",
"subAccountList":[
{
"email":"123@test.com",
"totalAssetOfBtc": "2.11111111",
"totalLiabilityOfBtc": "1.11111111",
"totalNetAssetOfBtc": "1.00000000"
},
{
"email":"345@test.com",
"totalAssetOfBtc": "2.22222222",
"totalLiabilityOfBtc": "1.00000001",
"totalNetAssetOfBtc": "1.22222221"
}
]
}
GET /sapi/v1/sub-account/margin/accountSummary
权重(IP):
10
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
为子账户开通Futures (适用主账户)
响应
{
"email":"123@test.com",
"isFuturesEnabled": true // true or false
}
POST /sapi/v1/sub-account/futures/enable
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户Futures账户详情 (适用主账户)
响应
{
"email": "abc@test.com",
"asset": "USDT",
"assets":[
{
"asset": "USDT",
"initialMargin": "0.00000000",
"maintenanceMargin": "0.00000000",
"marginBalance": "0.88308000",
"maxWithdrawAmount": "0.88308000",
"openOrderInitialMargin": "0.00000000",
"positionInitialMargin": "0.00000000",
"unrealizedProfit": "0.00000000",
"walletBalance": "0.88308000"
}
],
"canDeposit": true,
"canTrade": true,
"canWithdraw": true,
"feeTier": 2,
"maxWithdrawAmount": "0.88308000",
"totalInitialMargin": "0.00000000",
"totalMaintenanceMargin": "0.00000000",
"totalMarginBalance": "0.88308000",
"totalOpenOrderInitialMargin": "0.00000000",
"totalPositionInitialMargin": "0.00000000",
"totalUnrealizedProfit": "0.00000000",
"totalWalletBalance": "0.88308000",
"updateTime": 1576756674610
}
GET /sapi/v1/sub-account/futures/account
权重(IP):
10
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户Futures账户汇总 (适用主账户)
响应
{
"totalInitialMargin": "9.83137400",
"totalMaintenanceMargin": "0.41568700",
"totalMarginBalance": "23.03235621",
"totalOpenOrderInitialMargin": "9.00000000",
"totalPositionInitialMargin": "0.83137400",
"totalUnrealizedProfit": "0.03219710",
"totalWalletBalance": "22.15879444",
"asset": "USD", //USDT和BUSD资产汇总
"subAccountList":[
{
"email": "123@test.com",
"totalInitialMargin": "9.00000000",
"totalMaintenanceMargin": "0.00000000",
"totalMarginBalance": "22.12659734",
"totalOpenOrderInitialMargin": "9.00000000",
"totalPositionInitialMargin": "0.00000000",
"totalUnrealizedProfit": "0.00000000",
"totalWalletBalance": "22.12659734",
"asset": "USD" //USDT和BUSD资产汇总
},
{
"email": "345@test.com",
"totalInitialMargin": "0.83137400",
"totalMaintenanceMargin": "0.41568700",
"totalMarginBalance": "0.90575887",
"totalOpenOrderInitialMargin": "0.00000000",
"totalPositionInitialMargin": "0.83137400",
"totalUnrealizedProfit": "0.03219710",
"totalWalletBalance": "0.87356177",
"asset": "USD"
}
]
}
GET /sapi/v1/sub-account/futures/accountSummary
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户合约持仓信息 (仅适用主账户)
响应
[
{
"entryPrice": "9975.12000",
"leverage": "50", // current initial leverage
"maxNotional": "1000000", // notional value limit of current initial leverage
"liquidationPrice": "7963.54",
"markPrice": "9973.50770517",
"positionAmount": "0.010",
"symbol": "BTCUSDT",
"unrealizedProfit": "-0.01612295"
}
]
GET /sapi/v1/sub-account/futures/positionRisk
权重(IP):
10
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
recvWindow
LONG
NO
timestamp
LONG
YES
子账户Futures划转 (仅适用主账户)
响应
{
"txnId":"2966662589"
}
POST /sapi/v1/sub-account/futures/transfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
asset
STRING
YES
划转资产, e.g., USDT
amount
DECIMAL
YES
划转数量
type
INT
YES
1: 由子账户的现货账户划转至其USDT本位合约账户; 2: 由子账户的USDT本位合约账户划转至其现货账户； 3:由子账户现货账户划转至其COIN本位合约账户；4: 由子账户COIN本位合约账户划转至其现货账户
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Spot & Margin Trading 权限以使用此接口。
子账户Margin划转 (仅适用主账户)
响应
{
"txnId":"2966662589"
}
POST /sapi/v1/sub-account/margin/transfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
asset
STRING
YES
划转资产, e.g., USDT
amount
DECIMAL
YES
划转数量
type
INT
YES
1: 由子账户的现货账户划转至其杠杆账户; 2: 由子账户的杠杆账户划转至其现货账户
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Spot & Margin Trading 权限以使用此接口。
向共同主账户下的子账户主动划转 (仅适用子账户)
响应
{
"txnId":"2966662589"
}
POST /sapi/v1/sub-account/transfer/subToSub
权重(IP):
1
参数:
名称
类型
是否必需
描述
toEmail
STRING
YES
接收者子邮箱地址 备注
asset
STRING
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Spot & Margin Trading 权限以使用此接口。
向主账户主动划转 (仅适用子账户)
响应
{
"txnId":"2966662589"
}
POST /sapi/v1/sub-account/transfer/subToMaster
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Spot & Margin Trading 权限以使用此接口。
查询子账户划转历史 (仅适用子账户)
响应
[
{
"counterParty":"master",
"email":"master@test.com",
"type":1, // 1 for transfer in , 2 for transfer out
"asset":"BTC",
"qty":"1",
"fromAccountType":"SPOT",
"toAccountType":"SPOT",
"status":"SUCCESS", // status: PROCESS / SUCCESS / FAILURE
"tranId":11798835829,
"time":1544433325000
},
{
"counterParty": "subAccount",
"email": "sub2@test.com",
"type": 1,
"asset":"ETH",
"qty":"2",
"fromAccountType":"SPOT",
"toAccountType":"SPOT",
"status":"SUCCESS",
"tranId":11798829519,
"time":1544433326000
}
]
GET /sapi/v1/sub-account/transfer/subUserHistory
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
NO
如不提供，返回所有asset 划转记录
type
INT
NO
1: transfer in, 2: transfer out; 如不提供，返回transfer out方向划转记录
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认值: 500
returnFailHistory
BOOLEAN
NO
默认False，返回PROCESS和SUCCESS状态的数据；如果传True返回PROCESS、SUCCESS、FAILURE状态的数据
recvWindow
LONG
NO
timestamp
LONG
YES
如果startTime和endTime均未发送，默认只返回最近30天数据
子母账户万能划转 (适用主账户)
响应
{
"tranId":11945860693,
"clientTranId":"test"
}
POST /sapi/v1/sub-account/universalTransfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
fromEmail
STRING
NO
toEmail
STRING
NO
fromAccountType
STRING
YES
"SPOT","USDT_FUTURE","COIN_FUTURE","MARGIN"(Cross),"ISOLATED_MARGIN"
toAccountType
STRING
YES
"SPOT","USDT_FUTURE","COIN_FUTURE","MARGIN"(Cross),"ISOLATED_MARGIN"
clientTranId
STRING
NO
不可重复
symbol
STRING
NO
仅在ISOLATED_MARGIN类型下使用
asset
STRING
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
需要开启母账户apikey“允许子母账户划转”权限。
若 fromEmail 未传，默认从母账户转出。
若 toEmail 未传，默认转入母账户。
最少指定fromEmail和toEmail 其中之一。
该接口支持的划转操作有：
现货账户划转到现货账户、U本位合约账户、币本位合约账户（无论母账户或子账户）
现货账户、U本位合约账户、币本位合约账户划转到现货账户（无论母账户或子账户）
母账户现货账户划转到子账户杠杆全仓账户、杠杆逐仓账户
子账户杠杆全仓账户、杠杆逐仓账户划转到母账户现货账户
子账户杠杆全仓账户划转到子账户杠杆全仓账户
查询子母账户万能划转历史 (适用主账户)
响应
{
"result": [
{
"tranId": 92275823339,
"fromEmail": "abctest@gmail.com",
"toEmail": "deftest@gmail.com",
"asset": "BNB",
"amount": "0.01",
"createTimeStamp": 1640317374000,
"fromAccountType": "USDT_FUTURE",
"toAccountType": "SPOT",
"status": "SUCCESS",
"clientTranId": "test"
}
],
"totalCount": 1
}
GET /sapi/v1/sub-account/universalTransfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
fromEmail
STRING
NO
toEmail
STRING
NO
clientTranId
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
page
INT
NO
默认 1
limit
INT
NO
默认 500, 最大 500
recvWindow
LONG
NO
timestamp
LONG
YES
本查询接口只可以单边查询，fromEmail 和 toEmail 不能同时传入。
若 fromEmail 和 toEmail 都未传，默认返回 fromEmail 为母账户的划转记录。
若 startTime 和 endTime 都未传，则只可查询最近30天的记录。
查询时间范围最大不得超过30天。
查询子账户Futures账户详情V2 (适用主账户)
响应
USDT Margined Futures：
{
"futureAccountResp": {
"email": "abc@test.com",
"assets":[
{
"asset": "USDT",
"initialMargin": "0.00000000",
"maintenanceMargin": "0.00000000",
"marginBalance": "0.88308000",
"maxWithdrawAmount": "0.88308000",
"openOrderInitialMargin": "0.00000000",
"positionInitialMargin": "0.00000000",
"unrealizedProfit": "0.00000000",
"walletBalance": "0.88308000"
}
],
"canDeposit": true,
"canTrade": true,
"canWithdraw": true,
"feeTier": 2,
"maxWithdrawAmount": "0.88308000",
"totalInitialMargin": "0.00000000",
"totalMaintenanceMargin": "0.00000000",
"totalMarginBalance": "0.88308000",
"totalOpenOrderInitialMargin": "0.00000000",
"totalPositionInitialMargin": "0.00000000",
"totalUnrealizedProfit": "0.00000000",
"totalWalletBalance": "0.88308000",
"updateTime": 1576756674610
}
COIN Margined Futures：
{
"deliveryAccountResp": {
"email": "abc@test.com",
"assets":[
{
"asset": "BTC",
"initialMargin": "0.00000000",
"maintenanceMargin": "0.00000000",
"marginBalance": "0.88308000",
"maxWithdrawAmount": "0.88308000",
"openOrderInitialMargin": "0.00000000",
"positionInitialMargin": "0.00000000",
"unrealizedProfit": "0.00000000",
"walletBalance": "0.88308000"
}
],
"canDeposit": true,
"canTrade": true,
"canWithdraw": true,
"feeTier": 2,
"updateTime": 1598959682001
}
}
GET /sapi/v2/sub-account/futures/account
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
futuresType
INT
YES
1:USDT Margined Futures, 2:COIN Margined Futures
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户Futures账户汇总V2 (适用主账户)
响应
USDT Margined Futures：
{
"futureAccountSummaryResp": {
"totalInitialMargin": "9.83137400",
"totalMaintenanceMargin": "0.41568700",
"totalMarginBalance": "23.03235621",
"totalOpenOrderInitialMargin": "9.00000000",
"totalPositionInitialMargin": "0.83137400",
"totalUnrealizedProfit": "0.03219710",
"totalWalletBalance": "22.15879444",
"asset": "USD", //USDT和BUSD资产汇总
"subAccountList":[
{
"email": "123@test.com",
"totalInitialMargin": "9.00000000",
"totalMaintenanceMargin": "0.00000000",
"totalMarginBalance": "22.12659734",
"totalOpenOrderInitialMargin": "9.00000000",
"totalPositionInitialMargin": "0.00000000",
"totalUnrealizedProfit": "0.00000000",
"totalWalletBalance": "22.12659734",
"asset": "USD" //USDT和BUSD资产汇总
},
{
"email": "345@test.com",
"totalInitialMargin": "0.83137400",
"totalMaintenanceMargin": "0.41568700",
"totalMarginBalance": "0.90575887",
"totalOpenOrderInitialMargin": "0.00000000",
"totalPositionInitialMargin": "0.83137400",
"totalUnrealizedProfit": "0.03219710",
"totalWalletBalance": "0.87356177",
"asset": "USD"
}
]
}
COIN Margined Futures：
{
"deliveryAccountSummaryResp": {
"totalMarginBalanceOfBTC": "25.03221121",
"totalUnrealizedProfitOfBTC": "0.12233410",
"totalWalletBalanceOfBTC": "22.15879444",
"asset": "BTC",
"subAccountList":[
{
"email": "123@test.com",
"totalMarginBalance": "22.12659734",
"totalUnrealizedProfit": "0.00000000",
"totalWalletBalance": "22.12659734",
"asset": "BTC"
},
{
"email": "345@test.com",
"totalMarginBalance": "0.90575887",
"totalUnrealizedProfit": "0.03219710",
"totalWalletBalance": "0.87356177",
"asset": "BTC"
}
]
}
}
GET /sapi/v2/sub-account/futures/accountSummary
权重(IP):
10
参数:
名称
类型
是否必需
描述
futuresType
INT
YES
1:USDT Margined Futures, 2:COIN Margined Futures
page
INT
NO
default:1
limit
INT
NO
default:10, max:20
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户合约持仓信息V2 (仅适用主账户)
响应
USDT Margined Futures：
{
"futurePositionRiskVos": [
{
"entryPrice": "9975.12000",
"leverage": "50", // current initial leverage
"maxNotional": "1000000", // notional value limit of current initial leverage
"liquidationPrice": "7963.54",
"markPrice": "9973.50770517",
"positionAmount": "0.010",
"symbol": "BTCUSDT",
"unrealizedProfit": "-0.01612295"
}
]
}
COIN Margined Futures：
{
"deliveryPositionRiskVos": [
{
"entryPrice": "9975.12000",
"markPrice": "9973.50770517",
"leverage": "20",
"isolated": "false",
"isolatedWallet": "9973.50770517",
"isolatedMargin": "0.00000000",
"isAutoAddMargin": "false",
"positionSide": "BOTH",
"positionAmount": "1.230",
"symbol": "BTCUSD_201225",
"unrealizedProfit": "-0.01612295"
}
]
}
GET /sapi/v2/sub-account/futures/positionRisk
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
子账户邮箱 备注
futuresType
INT
YES
1:USDT Margined Futures, 2:COIN Margined Futures
recvWindow
LONG
NO
timestamp
LONG
YES
为子账户开通杠杆代币 (适用母账户)
响应
{
"email":"123@test.com",
"enableBlvt":true
}
POST /sapi/v1/sub-account/blvt/enable
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
Sub-account email
enableBlvt
BOOLEAN
YES
Only true for now
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户API Key IP白名单 (适用母账户)
响应:
{
"ipRestrict": "true",
"ipList": [
"69.210.67.14",
"8.34.21.10"
],
"updateTime": 1636371437000,
"apiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf"
}
GET /sapi/v1/sub-account/subAccountApi/ipRestriction
权重(UID):
3000
参数:
名称
类型
是否必需
描述
STRING
YES
Sub-account email
subAccountApiKey
STRING
YES
recvWindow
LONG
NO
timestamp
LONG
YES
删除子账户API Key IP白名单 (适用母账户)
响应:
{
"ipRestrict": "true",
"ipList": [
"69.210.67.14",
"8.34.21.10"
],
"updateTime": 1636371437000,
"apiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf"
}
DELETE /sapi/v1/sub-account/subAccountApi/ipRestriction/ipList
权重(UID):
3000
参数:
名称
类型
是否必需
描述
STRING
YES
Sub-account email
subAccountApiKey
STRING
YES
ipAddress
STRING
NO
可批量删除，用逗号分隔
recvWindow
LONG
NO
timestamp
LONG
YES
调用此端口前需要在api管理页开启允许现货及杠杆交易选项
为子账户API Key增加IP白名单 (适用母账户)
响应:
{
"status": "2",
"ipList": [
"69.210.67.14",
"8.34.21.10", //只当您有开启IP白名单且添加了IP白名单地址时才返回
],
"updateTime": 1636371437000,
"apiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf"
}
POST /sapi/v2/sub-account/subAccountApi/ipRestriction
权重(UID):
3000
参数:
名称
类型
是否必需
描述
STRING
YES
Sub-account email
subAccountApiKey
STRING
YES
status
STRING
YES
IP限制状态。1或不填入(null) = IP未受限。2 = 仅限受信任IP访问。
ipAddress
STRING
NO
可批量填入IP，以逗号区隔
recvWindow
LONG
NO
timestamp
LONG
YES
调用此端口前需要在api管理页开启允许现货及杠杆交易选项
投资人账户为托管子账户充值资产 (适用投资人母账户)
响应
{
"tranId":66157362489
}
POST /sapi/v1/managed-subaccount/deposit
权重(IP):
1
参数:
名称
类型
是否必需
描述
toEmail
STRING
YES
asset
STRING
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
您需要开通API Key允许现货和杠杆交易权限
投资人账户查询托管子账户资产 (适用投资人母账户)
响应
[
{
"coin": "INJ", //币种
"name": "Injective Protocol", //名称
"totalBalance": "0", //总资产
"availableBalance": "0", //可用资产
"inOrder": "0", //下单冻结
"btcValue": "0" //btc估值
},
{
"coin": "FILDOWN",
"name": "FILDOWN",
"totalBalance": "0",
"availableBalance": "0",
"inOrder": "0",
"btcValue": "0"
}
]
GET /sapi/v1/managed-subaccount/asset
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
recvWindow
LONG
NO
timestamp
LONG
YES
投资人账户为托管子账户提币资产 (适用投资人母账户)
响应
{
"tranId":66157362489
}
POST /sapi/v1/managed-subaccount/withdraw
权重(IP):
1
参数:
名称
类型
是否必需
描述
fromEmail
STRING
YES
asset
STRING
YES
amount
DECIMAL
YES
transferDate
LONG
NO
提币会自动发生在选择的日期(UTC0)，如果没有选择日期，提币会立即生效
recvWindow
LONG
NO
timestamp
LONG
YES
您需要开通API Key允许现货和杠杆交易权限
查询托管子账户资产快照 (适用投资人母账户)
响应
{
"code":200, // 200表示返回正确，否则即为错误码
"msg":"", // 与错误码对应的报错信息
"snapshotVos":[
{
"data":{
"balances":[
{
"asset":"BTC",
"free":"0.09905021",
"locked":"0.00000000"
},
{
"asset":"USDT",
"free":"1.89109409",
"locked":"0.00000000"
}
],
"totalAssetOfBtc":"0.09942700"
},
"type":"spot",
"updateTime":1576281599000
}
]
}
或
{
"code":200, // 200表示返回正确，否则即为错误码
"msg":"", // 与错误码对应的报错信息
"snapshotVos":[
{
"data":{
"marginLevel":"2748.02909813",
"totalAssetOfBtc":"0.00274803",
"totalLiabilityOfBtc":"0.00000100",
"totalNetAssetOfBtc":"0.00274750",
"userAssets":[
{
"asset":"XRP",
"borrowed":"0.00000000",
"free":"1.00000000",
"interest":"0.00000000",
"locked":"0.00000000",
"netAsset":"1.00000000"
}
]
},
"type":"margin",
"updateTime":1576281599000
}
]
}
或
{
"code":200, // 200表示返回正确，否则即为错误码
"msg":"", // 与错误码对应的报错信息
"snapshotVos":[
{
"data":{
"assets":[
{
"asset":"USDT",
"marginBalance":"118.99782335",
"walletBalance":"120.23811389"
}
],
"position":[
{
"entryPrice":"7130.41000000",
"markPrice":"7257.66239673",
"positionAmt":"0.01000000",
"symbol":"BTCUSDT",
"unRealizedProfit":"1.24029054" //只显示开仓当时的未实现盈亏，不会实时更新，可以忽略
}
]
},
"type":"futures",
"updateTime":1576281599000
}
]
}
GET /sapi/v1/managed-subaccount/accountSnapshot
权重(IP):
2400
参数:
名称
类型
是否必需
描述
STRING
YES
type
STRING
YES
"SPOT"（现货）, "MARGIN"（全仓）, "FUTURES"（U本位合约）
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
min 7, max 30, default 7
recvWindow
LONG
NO
timestamp
LONG
YES
查询时间范围最大不得超过30天
仅支持查询最近 1 个月数据
若startTime和endTime没传，则默认返回最近7天数据
查询托管子账户的划转记录(适用投资人母账户) (USER_DATA)
响应
{
managerSubTransferHistoryVos: [
0: {
fromEmail: "test_0_virtual@kq3kno9imanagedsub.com"
fromAccountType: "SPOT"
toEmail: "wdywl0lddakh@test.com"
toAccountType: "SPOT"
asset: "BNB"
amount: "0.01"
scheduledData: 1679416673000
createTime: 1679416673000
status: "SUCCESS"
tranId: 91077779
}
1: {
fromEmail: "wdywl0lddakh@test.com"
fromAccountType: "SPOT"
toEmail: "test_0_virtual@kq3kno9imanagedsub.com"
toAccountType: "SPOT"
asset: "BNB"
amount: "1"
scheduledData: 1679416616000
createTime: 1679416616000
status: "SUCCESS"
tranId: 91077676
}
]
count: 2
}
GET /sapi/v1/managed-subaccount/queryTransLogForInvestor
投资人可以根据此接口查询其托管子账户划转记录。此接口可供托管子账户的投资者使用。托管子账户是为重视资产配置与账户应用灵活性，并同时将交易委托专业交易团队的投资者的子账户类型。
请参阅链接
权重(UID):
60
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
startTime
LONG
YES
开始时间
endTime
LONG
YES
结束时间(开始时间结束时间间隔不能超过半年)
page
INT
YES
页数
limit
INT
YES
每页数量 (最大值: 500)
transfers
STRING
NO
划转方向 (from/to)
transferFunctionAccountType
STRING
NO
划转账户类型 (SPOT/MARGIN/ISOLATED_MARGIN/USDT_FUTURE/COIN_FUTURE)
查询托管子账户的划转记录(适用交易团队母账户)(USER_DATA)
响应
{
managerSubTransferHistoryVos: [
0: {
fromEmail: "test_0_virtual@kq3kno9imanagedsub.com"
fromAccountType: "SPOT"
toEmail: "wdywl0lddakh@test.com"
toAccountType: "SPOT"
asset: "BNB"
amount: "0.01"
scheduledData: 1679416673000
createTime: 1679416673000
status: "SUCCESS"
tranId: 91077779
}
1: {
fromEmail: "wdywl0lddakh@test.com"
fromAccountType: "SPOT"
toEmail: "test_0_virtual@kq3kno9imanagedsub.com"
toAccountType: "SPOT"
asset: "BNB"
amount: "1"
scheduledData: 1679416616000
createTime: 1679416616000
status: "SUCCESS"
tranId: 91077676
}
]
count: 2
}
GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent
交易团队可以根据此接口查询其托管子账户划转记录。此接口可供托管子账户的交易团队使用。托管子账户是为重视资产配置与账户应用灵活性，并同时将交易委托专业交易团队的投资者的子账户类型。
请参阅链接
权重(UID):
60
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
startTime
LONG
YES
开始时间
endTime
LONG
YES
结束时间(开始时间结束时间间隔不能超过半年)
page
INT
YES
页数
limit
INT
YES
每页数量 (最大值: 500)
transfers
STRING
NO
划转方向 (FROM/TO)
transferFunctionAccountType
STRING
NO
划转账户类型 (SPOT/MARGIN/ISOLATED_MARGIN/USDT_FUTURE/COIN_FUTURE)
投资人账户查询托管子账户期货资产 (适用投资人母账户) (USER_DATA)
响应
{
"code": "200",
"message": "OK",
"snapshotVos": [
{
"type": "FUTURES",
"updateTime": 1672893855394,
"data": {
"assets": [
{
"asset": "USDT",
"marginBalance": 100,
"walletBalance": 120
}
],
"position": [
{
"symbol": "BTCUSDT",
"entryPrice": 17000,
"markPrice": 17000,
"positionAmt": 0.0001
}
]
}
}
]
}
GET /sapi/v1/managed-subaccount/fetch-future-asset
投资人可以根据此接口查询其托管子账户期货资产
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
投资人账户查询托管子账户杠杆资产 (适用投资人母账户) (USER_DATA)
响应
{
marginLevel:"999"
totalAssetOfBtc:"0"
totalLiabilityOfBtc:"0"
totalNetAssetOfBtc:"0"
userAssets:[
0:{
asset:"MATIC"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
1:{
asset:"VET"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
2:{
asset:"BAKE"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
3:{
asset:"SHIB"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
4:{
asset:"USDT"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
5:{
asset:"DOGE"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
6:{
asset:"AAVE"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
7:{
asset:"ONT"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
8:{
asset:"XRP"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
9:{
asset:"XLM"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
10:{
asset:"LINK"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
11:{
asset:"QTUM"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
12:{
asset:"ETHW"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
13:{
asset:"XTZ"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
14:{
asset:"LUNA"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
15:{
asset:"EUR"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
16:{
asset:"IOST"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
17:{
asset:"BCH"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
18:{
asset:"BTC"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
19:{
asset:"IOTA"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
20:{
asset:"CREAM"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
21:{
asset:"BAT"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
22:{
asset:"BNB"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
23:{
asset:"ETH"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
24:{
asset:"ZEC"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
25:{
asset:"USDC"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
26:{
asset:"LTC"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
27:{
asset:"BUSD"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
28:{
asset:"ZIL"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
29:{
asset:"THETA"
borrowed:"0"
free:"0"
interest:"0"
locked:"0"
netAsset:"0"
}
]
}
GET /sapi/v1/managed-subaccount/marginAsset
投资人可以根据此接口查询其托管子账户杠杆资产
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
查询子账户资产(适用主账户)(USER_DATA)
响应
{
"balances":[
{
"asset":"ADA",
"free":"10000",
"locked":"0"
},
{
"asset":"BNB",
"free":"10003",
"locked":"0"
},
{
"asset":"BTC",
"free":"11467.6399",
"locked":"0"
}
]
}
GET /sapi/v4/sub-account/assets
获取子账户资产
权重(UID):
60
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
recvWindow
LONG
NO
timestamp
LONG
YES
查询托管子账户列表 (适用投资人母账户)(USER_DATA)
响应
{
"total": 3,
"managerSubUserInfoVoList": [
{
"rootUserId": 1000138475670,
"managersubUserId": 1000137842513,
"bindParentUserId": 1000138475669,
"email": "test_0_virtual@kq3kno9imanagedsub.com",
"insertTimeStamp": 1678435149000,
"bindParentEmail": "wdyw8xsh8pey@test.com",
"isSubUserEnabled": true,
"isUserActive": true,
"isMarginEnabled": false,
"isFutureEnabled": false,
"isSignedLVTRiskAgreement": false
},
{
"rootUserId": 1000138475670,
"managersubUserId": 1000137842514,
"bindParentUserId": 1000138475669,
"email": "test_1_virtual@4qd2u7zxmanagedsub.com",
"insertTimeStamp": 1678435152000,
"bindParentEmail": "wdyw8xsh8pey@test.com",
"isSubUserEnabled": true,
"isUserActive": true,
"isMarginEnabled": false,
"isFutureEnabled": false,
"isSignedLVTRiskAgreement": false
},
{
"rootUserId": 1000138475670,
"managersubUserId": 1000137842515,
"bindParentUserId": 1000138475669,
"email": "test_2_virtual@akc05o8hmanagedsub.com",
"insertTimeStamp": 1678435153000,
"bindParentEmail": "wdyw8xsh8pey@test.com",
"isSubUserEnabled": true,
"isUserActive": true,
"isMarginEnabled": false,
"isFutureEnabled": false,
"isSignedLVTRiskAgreement": false
}
]
}
GET /sapi/v1/managed-subaccount/info
获取投资人之托管子账户列表
权重(UID):
60
参数:
名称
类型
是否必需
描述
STRING
NO
托管子账户邮箱
page
INT
NO
默认值: 1
limit
INT
NO
默认值: 20, 最大值: 20
recvWindow
LONG
NO
timestamp
LONG
YES
查询子账户交易量统计列表 (适用母账户)(USER_DATA)
响应
{
"recent30BtcTotal": "0",
"recent30BtcFuturesTotal": "0",
"recent30BtcMarginTotal": "0",
"recent30BusdTotal": "0",
"recent30BusdFuturesTotal": "0",
"recent30BusdMarginTotal": "0",
"tradeInfoVos": []
}
{
"recent30BtcTotal": "0",
"recent30BtcFuturesTotal": "0",
"recent30BtcMarginTotal": "0",
"recent30BusdTotal": "0",
"recent30BusdFuturesTotal": "0",
"recent30BusdMarginTotal": "0",
"tradeInfoVos": [
{
"userId": 1000138138384,
"btc": 0,
"btcFutures": 0,
"btcMargin": 0,
"busd": 0,
"busdFutures": 0,
"busdMargin": 0,
"date": 1676851200000
},
{
"userId": 1000138138384,
"btc": 0,
"btcFutures": 0,
"btcMargin": 0,
"busd": 0,
"busdFutures": 0,
"busdMargin": 0,
"date": 1676937600000
},
{
"userId": 1000138138384,
"btc": 0,
"btcFutures": 0,
"btcMargin": 0,
"busd": 0,
"busdFutures": 0,
"busdMargin": 0,
"date": 1677024000000
}
]
}
GET /sapi/v1/sub-account/transaction-statistics
查询子账户交易量统计列表 (适用母账户)
权重(UID):
60
参数:
名称
类型
是否必需
描述
STRING
Yes
子账户邮箱
recvWindow
LONG
NO
timestamp
LONG
YES
获取托管子账户充值地址 (适用投资人母账户)(USER_DATA)
响应
{
"coin": "USDT",
"address": "0x206c22d833bb0bb2102da6b7c7d4c3eb14bcf73d",
"tag": "",
"url": "https://etherscan.io/address/0x206c22d833bb0bb2102da6b7c7d4c3eb14bcf73d"
}
GET /sapi/v1/managed-subaccount/deposit/address
获取投资人之托管子账户充值地址
权重(UID):
1
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
coin
STRING
YES
network
STRING
NO
网络可以在GET /sapi/v1/capital/deposit/address获取
recvWindow
LONG
NO
timestamp
LONG
YES
network不传时，返回该coin默认的network.
为子账户开通期权(适用主账户)(USER_DATA)
响应
{
"email":"123@test.com",
"isEOptionsEnabled": true // true or false
}
POST /sapi/v1/sub-account/eoptions/enable
为子账户开通期权 (适用主账户)
权重(IP):
1
参数:
名称
类型
是否必需
描述
STRING
YES
托管子账户邮箱
recvWindow
LONG
NO
timestamp
LONG
YES
查询托管子账户的划转记录(适用交易团队子账户)(USER_DATA)
响应
{
"managerSubTransferHistoryVos": [
{
"fromEmail": "test_0_virtual@kq3kno9imanagedsub.com",
"fromAccountType": "SPOT",
"toEmail": "wdywl0lddakh@test.com",
"toAccountType": "SPOT",
"asset": "BNB",
"amount": "0.01",
"scheduledData": 1679416673000,
"createTime": 1679416673000,
"status": "SUCCESS",
"tranId": 91077779
},
{
"fromEmail": "wdywl0lddakh@test.com",
"fromAccountType": "SPOT",
"toEmail": "test_0_virtual@kq3kno9imanagedsub.com",
"toAccountType": "SPOT",
"asset": "BNB",
"amount": "1",
"scheduledData": 1679416616000,
"createTime": 1679416616000,
"status": "SUCCESS",
"tranId": 91077676
}
],
"count": 2
}
GET /sapi/v1/managed-subaccount/query-trans-log
查询托管子账户的划转记录(适用交易团队子账户)
权重(UID):
60
参数:
Name
Type
Mandatory
Description
startTime
LONG
YES
开始时间
endTime
LONG
YES
结束时间(开始时间结束时间间隔不能超过半年)
page
INT
YES
页数
limit
INT
YES
每页数量 (最大值: 500)
transfers
STRING
NO
划转方向 (FROM/TO)
transferFunctionAccountType
STRING
NO
划转账户类型 (SPOT/MARGIN/ISOLATED_MARGIN/USDT_FUTURE/COIN_FUTURE)
recvWindow
LONG
NO
timestamp
LONG
YES
行情接口测试服务器连通性
响应
{}
GET /api/v3/ping
测试能否联通 Rest API。
权重(IP):
1
参数:
NONE
数据源:
缓存
获取服务器时间
响应
{
"serverTime": 1499827319559
}
GET /api/v3/time
测试能否联通 Rest API 并 获取服务器时间。
权重(IP):
1
参数:
NONE
数据源:
缓存
交易规范信息
响应
{
"timezone": "UTC",
"serverTime": 1565246363776,
"rateLimits": [
{
//这些在"限制种类 (rateLimitType)"下的"枚举定义"部分中定义
//所有限制都是可选的
}
],
"exchangeFilters": [
//这些是"过滤器"部分中定义的过滤器
//所有限制都是可选的
],
"symbols": [
{
"symbol": "ETHBTC",
"status": "TRADING",
"baseAsset": "ETH",
"baseAssetPrecision": 8,
"quoteAsset": "BTC",
"quotePrecision": 8,
"quoteAssetPrecision": 8,
"orderTypes": [
"LIMIT",
"LIMIT_MAKER",
"MARKET",
"STOP_LOSS",
"STOP_LOSS_LIMIT",
"TAKE_PROFIT",
"TAKE_PROFIT_LIMIT"
],
"icebergAllowed": true,
"ocoAllowed": true,
"quoteOrderQtyMarketAllowed": false,
"allowTrailingStop": false,
"isSpotTradingAllowed": true,
"isMarginTradingAllowed": true,
"cancelReplaceAllowed": false,
"filters": [
//这些在"过滤器"部分中定义
//所有限制都是可选的
],
"permissions": [
"SPOT",
"MARGIN"
],
"defaultSelfTradePreventionMode": "NONE",
"allowedSelfTradePreventionModes": [
"NONE"
]
}
]
}
GET /api/v3/exchangeInfo
获取交易规则和交易对信息。
权重(IP):
20
参数:
有四种用法
用法
举例
不需要交易对
curl -X GET "https://api.binance.com/api/v3/exchangeInfo"
单个交易对
curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"
多个交易对
curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbols=%5B%22BNBBTC%22,%22BTCUSDT%22%5D" 或者 curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?symbols=["BTCUSDT","BNBBTC"]'
交易权限
curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT" 或者 curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=%5B%22MARGIN%22%2C%22LEVERAGED%22%5D" 或者 curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?permissions=["MARGIN","LEVERAGED"]'
备注:
如果参数 symbol 或者 symbols 提供的交易对不存在, 系统会返回错误并提示交易对不正确.
所有的参数都是可选的.
permissions 支持单个或者多个值, 比如 SPOT, ["MARGIN","LEVERAGED"].
如果permissions值没有提供, 其默认值为 ["SPOT","MARGIN","LEVERAGED"].
如果想显示所有交易权限，需要分别指定(比如，["SPOT","MARGIN",...]). 从 账户与交易对权限 查看交易权限列表.
数据源:
缓存
深度信息
响应
{
"lastUpdateId": 1027024,
"bids": [
[
"4.00000000", // 价位
"431.00000000" // 挂单量
]
],
"asks": [
[
"4.00000200",
"12.00000000"
]
]
}
GET /api/v3/depth
权重(IP):
基于限制调整:
限制
权重
1-100
5
101-500
25
501-1000
50
1001-5000
250
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
limit
INT
NO
默认 100; 最大 5000. 可选值:[5, 10, 20, 50, 100, 500, 1000, 5000] 如果 limit > 5000, 最多返回5000条数据.
数据源:
缓存
近期成交列表
响应
[
{
"id": 28457,
"price": "4.00000100",
"qty": "12.00000000",
"time": 1499865549590, // 交易成交时间, 和websocket中的T一致.
"isBuyerMaker": true,
"isBestMatch": true
}
]
GET /api/v3/trades
获取近期成交
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
limit
INT
NO
默认 500; 最大值 1000.
数据源:
缓存
查询历史成交
响应
[
{
"id": 28457,
"price": "4.00000100",
"qty": "12.00000000",
"quoteQty": "48.000012",
"time": 1499865549590,
"isBuyerMaker": true,
"isBestMatch": true
}
]
GET /api/v3/historicalTrades
获取历史成交。
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
limit
INT
NO
默认 500; 最大值 1000.
fromId
LONG
NO
从哪一条成交id开始返回. 缺省返回最近的成交记录。
数据源:
数据库
近期成交(归集)
响应
[
{
"a": 26129, // 归集成交ID
"p": "0.01633102", // 成交价
"q": "4.70443515", // 成交量
"f": 27781, // 被归集的首个成交ID
"l": 27781, // 被归集的末个成交ID
"T": 1498793709153, // 成交时间
"m": true, // 是否为主动卖出单
"M": true // 是否为最优撮合单(可忽略，目前总为最优撮合)
}
]
GET /api/v3/aggTrades
归集交易与逐笔交易的区别在于，同一价格、同一方向、同一时间的trade会被聚合为一条
权重(IP):
2
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
fromId
LONG
NO
从包含fromId的成交id开始返回结果
startTime
LONG
NO
从该时刻之后的成交记录开始返回结果
endTime
LONG
NO
返回该时刻为止的成交记录
limit
INT
NO
默认 500; 最大 1000.
如果没有发送任何筛选参数(fromId, startTime,endTime)，默认返回最近的成交记录
如果一个trade有下面的值，表示这是一个重复的记录，并被标记为无效(invalid):
p = '0' // price
q = '0' // qty
f = -1 // first_trade_id
l = -1 // last_trade_id
数据源:
数据库
K线数据
响应
[
[
1499040000000, // k线开盘时间
"0.01634790", // 开盘价
"0.80000000", // 最高价
"0.01575800", // 最低价
"0.01577100", // 收盘价(当前K线未结束的即为最新价)
"148976.11427815", // 成交量
1499644799999, // k线收盘时间
"2434.19055334", // 成交额
308, // 成交笔数
"1756.87402397", // 主动买入成交量
"28.46694368", // 主动买入成交额
"17928899.62484339" // 请忽略该参数
]
]
GET /api/v3/klines
每根K线代表一个交易对。
每根K线的开盘时间可视为唯一ID
权重(IP):
2
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
interval
ENUM
YES
详见枚举定义：K线间隔
startTime
LONG
NO
endTime
LONG
NO
timeZone
STRING
NO
默认: 0 (UTC)
limit
INT
NO
默认 500; 最大 1000.
如果未发送 startTime 和 endTime ，默认返回最近的交易。
timeZone支持的值包括：
小时和分钟（例如 -1:00，05:45）
仅小时（例如 0，8，4）
接受的值范围严格为 [-12:00 到 +14:00]（包括边界）
如果提供了timeZone，K线间隔将在该时区中解释，而不是在UTC中。
请注意，无论timeZone如何，startTime和endTime始终以UTC时区解释。
数据源:
数据库
当前平均价格
响应
{
"mins": 5,
"price": "9.35751834",
"closeTime": 1694061154503
}
GET /api/v3/avgPrice
权重(IP):
2
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
数据源:
缓存
UIK线数据
响应
[
[
1499040000000, // k线开盘时间
"0.01634790", // 开盘价
"0.80000000", // 最高价
"0.01575800", // 最低价
"0.01577100", // 收盘价(当前K线未结束的即为最新价)
"148976.11427815", // 成交量
1499644799999, // k线收盘时间
"2434.19055334", // 成交额
308, // 成交笔数
"1756.87402397", // 主动买入成交量
"28.46694368", // 主动买入成交额
"0" // 请忽略该参数
]
]
GET /api/v3/uiKlines
请求参数与响应和k线接口相同。
uiKlines 返回修改后的k线数据，针对k线图的呈现进行了优化。
权重(IP):
2
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
interval
ENUM
YES
startTime
LONG
NO
endTime
LONG
NO
timeZone
STRING
NO
Default: 0 (UTC)
limit
INT
NO
默认 500; 最大 1000.
如果未发送 startTime 和 endTime ，默认返回最近的交易。
timeZone支持的值包括：
小时和分钟（例如 -1:00，05:45）
仅小时（例如 0，8，4）
接受的值范围严格为 [-12:00 到 +14:00]（包括边界）
如果提供了timeZone，K线间隔将在该时区中解释，而不是在UTC中。
请注意，无论timeZone如何，startTime和endTime始终以UTC时区解释。
数据源:
数据库
24hr 价格变动情况
响应 - FULL
{
"symbol": "BNBBTC",
"priceChange": "-94.99999800",
"priceChangePercent": "-95.960",
"weightedAvgPrice": "0.29628482",
"prevClosePrice": "0.10002000",
"lastPrice": "4.00000200",
"lastQty": "200.00000000",
"bidPrice": "4.00000000",
"bidQty": "100.00000000",
"askPrice": "4.00000200",
"askQty": "100.00000000",
"openPrice": "99.00000000",
"highPrice": "100.00000000",
"lowPrice": "0.10000000",
"volume": "8913.30000000",
"quoteVolume": "15.30000000",
"openTime": 1499783499040,
"closeTime": 1499869899040,
"firstId": 28385, // 首笔成交id
"lastId": 28460, // 末笔成交id
"count": 76 // 成交笔数
}
OR
[
{
"symbol": "BNBBTC",
"priceChange": "-94.99999800",
"priceChangePercent": "-95.960",
"weightedAvgPrice": "0.29628482",
"prevClosePrice": "0.10002000",
"lastPrice": "4.00000200",
"lastQty": "200.00000000",
"bidPrice": "4.00000000",
"bidQty": "100.00000000",
"askPrice": "4.00000200",
"askQty": "100.00000000",
"openPrice": "99.00000000",
"highPrice": "100.00000000",
"lowPrice": "0.10000000",
"volume": "8913.30000000",
"quoteVolume": "15.30000000",
"openTime": 1499783499040,
"closeTime": 1499869899040,
"firstId": 28385,
"lastId": 28460,
"count": 76
}
]
Response - MINI
{
"symbol": "BNBBTC", // 交易对
"openPrice": "99.00000000", // 间隔开盘价
"highPrice": "100.00000000", // 间隔最高价
"lowPrice": "0.10000000", // 间隔最低价
"lastPrice": "4.00000200", // 间隔收盘价
"volume": "8913.30000000", // 总交易量 (base asset)
"quoteVolume": "15.30000000", // 总交易量 (quote asset)
"openTime": 1499783499040, // ticker间隔的开始时间
"closeTime": 1499869899040, // ticker间隔的结束时间
"firstId": 28385, // 统计时间内的第一笔trade id
"lastId": 28460, // 统计时间内的最后一笔trade id
"count": 76 // 统计时间内交易笔数
}
OR
[
{
"symbol": "BNBBTC",
"openPrice": "99.00000000",
"highPrice": "100.00000000",
"lowPrice": "0.10000000",
"lastPrice": "4.00000200",
"volume": "8913.30000000",
"quoteVolume": "15.30000000",
"openTime": 1499783499040,
"closeTime": 1499869899040,
"firstId": 28385,
"lastId": 28460,
"count": 76
},
{
"symbol": "LTCBTC",
"openPrice": "0.07000000",
"highPrice": "0.07000000",
"lowPrice": "0.07000000",
"lastPrice": "0.07000000",
"volume": "11.00000000",
"quoteVolume": "0.77000000",
"openTime": 1656908192899,
"closeTime": 1656994592899,
"firstId": 0,
"lastId": 10,
"count": 11
}
]
GET /api/v3/ticker/24hr
24 小时滚动窗口价格变动数据。 请注意，不携带symbol参数会返回全部交易对数据，不仅数据庞大，而且权重极高
权重(IP):
参数
提供Symbol数量
权重
symbol
1
2
不提供symbol
80
symbols
1-20
2
21-100
40
>= 101
80
不提供symbol
80
参数:
名称
类型
是否强制要求
详情
symbol
STRING
NO
参数 `symbol` 和 `symbols` 不可以一起使用 如果都不提供, 所有symbol的ticker数据都会返回.
symbols参数可接受的格式：
["BTCUSDT","BNBUSDT"]
或
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbols
STRING
NO
type
ENUM
NO
可接受的参数: FULL 或 MINI. 如果不提供, 默认值为 FULL
数据源:
缓存
交易日行情(Ticker)
响应 - FULL
{
"symbol": "BTCUSDT",
"priceChange": "-83.13000000", // 绝对价格变动
"priceChangePercent": "-0.317", // 相对价格变动百分比
"weightedAvgPrice": "26234.58803036", // 报价成交量 / 成交量
"openPrice": "26304.80000000",
"highPrice": "26397.46000000",
"lowPrice": "26088.34000000",
"lastPrice": "26221.67000000",
"volume": "18495.35066000", // 基础资产的成交量
"quoteVolume": "485217905.04210480", // 报价资产的成交量
"openTime": 1695686400000,
"closeTime": 1695772799999,
"firstId": 3220151555, // 区间内的第一个交易的交易ID
"lastId": 3220849281, // 区间内的最后一个交易的交易ID
"count": 697727 // 区间内的交易数量
}
或者
[
{
"symbol": "BTCUSDT",
"priceChange": "-83.13000000",
"priceChangePercent": "-0.317",
"weightedAvgPrice": "26234.58803036",
"openPrice": "26304.80000000",
"highPrice": "26397.46000000",
"lowPrice": "26088.34000000",
"lastPrice": "26221.67000000",
"volume": "18495.35066000",
"quoteVolume": "485217905.04210480",
"openTime": 1695686400000,
"closeTime": 1695772799999,
"firstId": 3220151555,
"lastId": 3220849281,
"count": 697727
},
{
"symbol": "BNBUSDT",
"priceChange": "2.60000000",
"priceChangePercent": "1.238",
"weightedAvgPrice": "211.92276958",
"openPrice": "210.00000000",
"highPrice": "213.70000000",
"lowPrice": "209.70000000",
"lastPrice": "212.60000000",
"volume": "280709.58900000",
"quoteVolume": "59488753.54750000",
"openTime": 1695686400000,
"closeTime": 1695772799999,
"firstId": 672397461,
"lastId": 672496158,
"count": 98698
}
]
响应: - MINI
{
"symbol": "BTCUSDT",
"openPrice": "26304.80000000",
"highPrice": "26397.46000000",
"lowPrice": "26088.34000000",
"lastPrice": "26221.67000000",
"volume": "18495.35066000", // 基础资产的成交量
"quoteVolume": "485217905.04210480", // 报价资产的成交量
"openTime": 1695686400000,
"closeTime": 1695772799999,
"firstId": 3220151555, // 区间内的第一个交易的交易ID
"lastId": 3220849281, // 区间内的最后一个交易的交易ID
"count": 697727 // 区间内的交易数量
}
或者
[
{
"symbol": "BTCUSDT",
"openPrice": "26304.80000000",
"highPrice": "26397.46000000",
"lowPrice": "26088.34000000",
"lastPrice": "26221.67000000",
"volume": "18495.35066000",
"quoteVolume": "485217905.04210480",
"openTime": 1695686400000,
"closeTime": 1695772799999,
"firstId": 3220151555,
"lastId": 3220849281,
"count": 697727
},
{
"symbol": "BNBUSDT",
"openPrice": "210.00000000",
"highPrice": "213.70000000",
"lowPrice": "209.70000000",
"lastPrice": "212.60000000",
"volume": "280709.58900000",
"quoteVolume": "59488753.54750000",
"openTime": 1695686400000,
"closeTime": 1695772799999,
"firstId": 672397461,
"lastId": 672496158,
"count": 98698
}
]
GET /api/v3/ticker/tradingDay
交易日价格变动统计。
权重:
每个交易对占用4个权重.
当请求中的交易对数量超过50，此请求的权重将限制在200。
参数:
参数名
类型
是否必需
描述
symbol
STRING
YES
symbol 或者 symbols 必须提供之一
symbols 可以接受的格式:
["BTCUSDT","BNBUSDT"]
或者
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbols 最多可以发送100个
symbols
timeZone
STRING
NO
Default: 0 (UTC)
type
ENUM
NO
可接受值: FULL 或 MINI 默认值: FULL
注意:
timeZone支持的值包括：
小时和分钟（例如 -1:00，05:45）
仅小时（例如 0，8，4）
数据源:
数据库
最新价格
响应
{
"symbol": "LTCBTC",
"price": "4.00000200"
}
OR
[
{
"symbol": "LTCBTC",
"price": "4.00000200"
},
{
"symbol": "ETHBTC",
"price": "0.07946600"
}
]
GET /api/v3/ticker/price
获取交易对最新价格
权重(IP):
参数
Symbols数量
权重
symbol
1
2
不提供symbol
4
symbols
不限
4
参数:
参数名
类型
是否强制
详情
symbol
STRING
NO
参数 `symbol` 和 `symbols` 不可以一起使用
如果都不提供, 所有`symbol`的价格数据都会返回
`symbols`参数可接受的格式：
["BTCUSDT","BNBUSDT"]
或
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbols
STRING
NO
不发送交易对参数，则会返回所有交易对信息
数据源:
缓存
当前最优挂单
响应
{
"symbol": "LTCBTC",
"bidPrice": "4.00000000",
"bidQty": "431.00000000",
"askPrice": "4.00000200",
"askQty": "9.00000000"
}
OR
[
{
"symbol": "LTCBTC",
"bidPrice": "4.00000000",
"bidQty": "431.00000000",
"askPrice": "4.00000200",
"askQty": "9.00000000"
},
{
"symbol": "ETHBTC",
"bidPrice": "0.07946700",
"bidQty": "9.00000000",
"askPrice": "100000.00000000",
"askQty": "1000.00000000"
}
]
GET /api/v3/ticker/bookTicker
返回当前最优的挂单(最高买单，最低卖单)
权重(IP):
参数
Symbols数量
权重
symbol
1
2
不提供symbol
4
symbols
不限
4
参数:
参数名
类型
是否强制
详情
symbol
STRING
NO
参数 `symbol` 和 `symbols` 不可以一起使用 如果都不提供, 所有symbol的价格数据都会返回.
symbols参数可接受的格式：
["BTCUSDT","BNBUSDT"]
或
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbols
STRING
NO
数据源:
缓存
滚动窗口价格变动统计
响应 - FULL
{
"symbol": "BNBBTC",
"priceChange": "-8.00000000", // 价格变化
"priceChangePercent": "-88.889", // 价格变化百分比
"weightedAvgPrice": "2.60427807",
"openPrice": "9.00000000",
"highPrice": "9.00000000",
"lowPrice": "1.00000000",
"lastPrice": "1.00000000",
"volume": "187.00000000",
"quoteVolume": "487.00000000",
"openTime": 1641859200000, // ticker的开始时间
"closeTime": 1642031999999, // ticker的结束时间
"firstId": 0, // 统计时间内的第一笔trade id
"lastId": 60,
"count": 61 // 统计时间内交易笔数
}
或者
[
{
"symbol": "BTCUSDT",
"priceChange": "-154.13000000",
"priceChangePercent": "-0.740",
"weightedAvgPrice": "20677.46305250",
"openPrice": "20825.27000000",
"highPrice": "20972.46000000",
"lowPrice": "20327.92000000",
"lastPrice": "20671.14000000",
"volume": "72.65112300",
"quoteVolume": "1502240.91155513",
"openTime": 1655432400000,
"closeTime": 1655446835460,
"firstId": 11147809,
"lastId": 11149775,
"count": 1967
},
{
"symbol": "BNBBTC",
"priceChange": "0.00008530",
"priceChangePercent": "0.823",
"weightedAvgPrice": "0.01043129",
"openPrice": "0.01036170",
"highPrice": "0.01049850",
"lowPrice": "0.01033870",
"lastPrice": "0.01044700",
"volume": "166.67000000",
"quoteVolume": "1.73858301",
"openTime": 1655432400000,
"closeTime": 1655446835460,
"firstId": 2351674,
"lastId": 2352034,
"count": 361
}
]
响应 - MINI
{
"symbol": "LTCBTC",
"openPrice": "0.10000000",
"highPrice": "2.00000000",
"lowPrice": "0.10000000",
"lastPrice": "2.00000000",
"volume": "39.00000000",
"quoteVolume": "13.40000000", // 此k线内所有交易的price(价格) x volume(交易量)的总和
"openTime": 1656986580000, // ticker窗口的开始时间
"closeTime": 1657001016795, // ticker窗口的结束时间
"firstId": 0, // 首笔成交id
"lastId": 34,
"count": 35 // 统计时间内交易笔数
}
OR
[
{
"symbol": "BNBBTC",
"openPrice": "0.10000000",
"highPrice": "2.00000000",
"lowPrice": "0.10000000",
"lastPrice": "2.00000000",
"volume": "39.00000000",
"quoteVolume": "13.40000000", // 此k线内所有交易的price(价格) x volume(交易量)的总和
"openTime": 1656986880000, // ticker窗口的开始时间
"closeTime": 1657001297799, // ticker窗口的结束时间
"firstId": 0, // 首笔成交id
"lastId": 34,
"count": 35 // 统计时间内交易笔数
},
{
"symbol": "LTCBTC",
"openPrice": "0.07000000",
"highPrice": "0.07000000",
"lowPrice": "0.07000000",
"lastPrice": "0.07000000",
"volume": "33.00000000",
"quoteVolume": "2.31000000",
"openTime": 1656986880000,
"closeTime": 1657001297799,
"firstId": 0,
"lastId": 32,
"count": 33
}
]
GET /api/v3/ticker
注意: 此接口和 GET /api/v3/ticker/24hr 有所不同.
此接口统计的时间范围比请求的windowSize多不超过59999ms.
接口的 openTime 是某一分钟的起始，而结束是当前的时间. 所以实际的统计区间会比请求的时间窗口多不超过59999ms.
比如, 结束时间 closeTime 是 1641287867099 (January 04, 2022 09:17:47:099 UTC) , windowSize 为 1d. 那么开始时间 openTime 则为 1641201420000 (January 3, 2022, 09:17:00 UTC)
权重(IP):
4/交易对。 如果symbols请求的交易对超过50, 上限是200。
参数
Name
Type
Mandatory
Description
symbol
STRING
YES
提供 symbol 或者 symbols 其中之一
symbols 可以传入的格式:
["BTCUSDT","BNBUSDT"]
或
%5B%22BTCUSDT%22,%22BNBUSDT%22%5D
symbols 允许最多100个交易对
symbols
windowSize
ENUM
NO
默认为 1d windowSize 支持的值:
如果是分钟: 1m, 2m, ..., 59m
如果是小时: 1h, 2h, ..., 23h
如果是天: 1d, ..., 7d
不可以组合使用，比如 1d2h
type
ENUM
NO
可接受的参数: FULL 或 MINI
如果不提供, 默认值为 FULL
数据源:
数据库
Websocket 行情推送
本篇所列出的所有 wss 接口的 base URL 为: wss://stream.binance.com:9443 或者 wss://stream.binance.com:443
Streams 有单一原始 stream 或组合 stream。
用户可以侦听/订阅数个数据流。
单一原始 streams 格式为 /ws/
组合 streams 的 URL 格式为 /stream?streams=
订阅组合 streams 时，事件 payload 会以这样的格式封装: {"stream":"
stream 名称中所有交易对均为 小写。
每个到 stream.binance.com 的链接有效期不超过24小时，请妥善处理断线重连。
Websocket 服务器每3分钟发送Ping消息。
如果Websocket服务器在10分钟之内没有收到Pong消息应答，连接会被断开。
当客户收到ping消息，必需尽快回复pong消息，同时payload需要和ping消息一致。
未经请求的pong消息是被允许的，但是不会保证连接不断开。对于这些pong消息，建议payload为空
wss://data-stream.binance.vision 可以用来订阅仅有市场信息的数据流。账户信息无法从此 URL 获得。
实时订阅/取消数据流
以下数据可以通过websocket发送以实现订阅或取消订阅数据流。示例如下。
请求中的id被用作唯一标识来区分来回传递的消息。以下格式被接受:
64位有符号整数
字母数字字符串；最大长度36
null
如果相应内容中的 result 为 null，表示请求发送成功。
订阅一个信息流
响应
{
"result": null,
"id": 1
}
请求
{
"method": "SUBSCRIBE",
"params":
[
"btcusdt@aggTrade",
"btcusdt@depth"
],
"id": 1
}
取消订阅一个信息流
响应
{
"result": null,
"id": 312
}
请求
{
"method": "UNSUBSCRIBE",
"params":
[
"btcusdt@depth"
],
"id": 312
}
已订阅信息流
响应
{
"result": [
"btcusdt@aggTrade"
],
"id": 3
}
请求
{
"method": "LIST_SUBSCRIPTIONS",
"id": 3
}
设定属性
当前，唯一可以设置的属性是设置是否启用combined("组合")信息流。
当使用/ws/("原始信息流")进行连接时，combined属性设置为false，而使用 /stream/进行连接时则将属性设置为true。
响应
{
"result": null,
"id": 5
}
请求
{
"method": "SET_PROPERTY",
"params":
[
"combined",
true
],
"id": 5
}
检索属性
响应
{
"result": true, // Indicates that combined is set to true.
"id": 2
}
请求
{
"method": "GET_PROPERTY",
"params":
[
"combined"
],
"id": 2
}
错误信息
错误信息
描述
{"code": 0, "msg": "Unknown property"}
SET_PROPERTY 或 GET_PROPERTY中应用的参数无效
{"code": 1, "msg": "Invalid value type: expected Boolean", "id": '%s'}
仅接受true或false
{"code": 2, "msg": "Invalid request: property name must be a string"}
提供的属性名无效
{"code": 2, "msg": "Invalid request: request ID must be an unsigned integer"}
参数id未提供或id值是无效类型
{"code": 2, "msg": "Invalid request: unknown variant %s, expected one of SUBSCRIBE, UNSUBSCRIBE, LIST_SUBSCRIPTIONS, SET_PROPERTY, GET_PROPERTY at line 1 column 28"}
错字提醒，或提供的值不是预期类型
{"code": 2, "msg": "Invalid request: too many parameters"}
数据中提供了不必要参数
{"code": 2, "msg": "Invalid request: property name must be a string"}
未提供属性名
{"code": 2, "msg": "Invalid request: missing field method at line 1 column 73"}
数据未提供method
{"code":3,"msg":"Invalid JSON: expected value at line %s column %s"}
JSON 语法有误.
归集交易流
Payload:
{
"e": "aggTrade", // 事件类型
"E": 1672515782136, // 事件时间
"s": "BNBBTC", // 交易对
"a": 12345, // 归集交易ID
"p": "0.001", // 成交价格
"q": "100", // 成交数量
"f": 100, // 被归集的首个交易ID
"l": 105, // 被归集的末次交易ID
"T": 1672515782136, // 成交时间
"m": true, // 买方是否是做市方。如true，则此次成交是一个主动卖出单，否则是一个主动买入单。
"M": true // 请忽略该字段
}
归集交易 stream 推送交易信息，是对单一订单的集合。
Stream 名称:
更新速度: 实时
逐笔交易
Payload:
{
"e": "trade", // 事件类型
"E": 1672515782136, // 事件时间
"s": "BNBBTC", // 交易对
"t": 12345, // 交易ID
"p": "0.001", // 成交价格
"q": "100", // 成交数量
"b": 88, // 买方的订单ID
"a": 50, // 卖方的订单ID
"T": 1672515782136, // 成交时间
"m": true, // 买方是否是做市方。如true，则此次成交是一个主动卖出单，否则是一个主动买入单。
"M": true // 请忽略该字段
}
Stream 名称:
逐笔交易推送每一笔成交的信息。
成交（或者说交易）的定义是仅有一个吃单者与一个挂单者相互交易。
更新速度: 实时
K线 Streams
Payload:
{
"e": "kline", // 事件类型
"E": 1672515782136, // 事件时间
"s": "BNBBTC", // 交易对
"k": {
"t": 123400000, // 这根K线的起始时间
"T": 123460000, // 这根K线的结束时间
"s": "BNBBTC", // 交易对
"i": "1m", // K线间隔
"f": 100, // 这根K线期间第一笔成交ID
"L": 200, // 这根K线期间末一笔成交ID
"o": "0.0010", // 这根K线期间第一笔成交价
"c": "0.0020", // 这根K线期间末一笔成交价
"h": "0.0025", // 这根K线期间最高成交价
"l": "0.0015", // 这根K线期间最低成交价
"v": "1000", // 这根K线期间成交量
"n": 100, // 这根K线期间成交笔数
"x": false, // 这根K线是否完结(是否已经开始下一根K线)
"q": "1.0000", // 这根K线期间成交额
"V": "500", // 主动买入的成交量
"Q": "0.500", // 主动买入的成交额
"B": "123456" // 忽略此参数
}
}
K线stream逐秒推送所请求的K线种类(最新一根K线)的更新。
Stream 名称:
更新速度: 1s 1000ms，其它间隔 2000ms
K线图间隔参数:
s -> 秒; m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月
1s
1m
3m
5m
15m
30m
1h
2h
4h
6h
8h
12h
1d
3d
1w
1M
按 Symbol 的精简Ticker
Payload:
{
"e": "24hrMiniTicker", // 事件类型
"E": 1672515782136, // 事件时间
"s": "BNBBTC", // 交易对
"c": "0.0025", // 最新成交价格
"o": "0.0010", // 24小时前开始第一笔成交价格
"h": "0.0025", // 24小时内最高成交价
"l": "0.0010", // 24小时内最低成交价
"v": "10000", // 成交量
"q": "18" // 成交额
}
按Symbol刷新的最近24小时精简ticker信息
Stream 名称:
更新速度: 1000ms
全市场所有Symbol的精简Ticker
Payload:
[
{
// 数组每一个元素对应一个交易对，内容与 \
}
]
同上，只是推送所有交易对.需要注意的是，只有更新的ticker才会被推送.
Stream 名称: !miniTicker@arr
更新速度: 1000ms
按Symbol的完整Ticker
Payload:
{
"e": "24hrTicker", // 事件类型
"E": 1672515782136, // 事件时间
"s": "BNBBTC", // 交易对
"p": "0.0015", // 24小时价格变化
"P": "250.00", // 24小时价格变化(百分比)
"w": "0.0018", // 平均价格
"x": "0.0009", // 整整24小时之前，向前数的最后一次成交价格
"c": "0.0025", // 最新成交价格
"Q": "10", // 最新成交交易的成交量
"b": "0.0024", // 目前最高买单价
"B": "10", // 目前最高买单价的挂单量
"a": "0.0026", // 目前最低卖单价
"A": "100", // 目前最低卖单价的挂单量
"o": "0.0010", // 整整24小时前，向后数的第一次成交价格
"h": "0.0025", // 24小时内最高成交价
"l": "0.0010", // 24小时内最低成交价
"v": "10000", // 24小时内成交量
"q": "18", // 24小时内成交额
"O": 0, // 统计开始时间
"C": 86400000, // 统计结束时间
"F": 0, // 24小时内第一笔成交交易ID
"L": 18150, // 24小时内最后一笔成交交易ID
"n": 18151 // 24小时内成交数
}
每秒推送单个交易对的过去24小时滚动窗口标签统计信息。
Stream 名称:
更新速度: 1000ms
全市场所有交易对的完整Ticker
Payload:
[
{
// Same as
}
]
Stream 名称: !ticker@arr
更新速度: 1000ms
推送全市场所有交易对刷新的24小时完整ticker信息。需要注意的是，没有更新的ticker不会被推送。
按Symbol的最优挂单信息
Payload:
{
"u":400900217, // order book updateId
"s":"BNBUSDT", // 交易对
"b":"25.35190000", // 买单最优挂单价格
"B":"31.21000000", // 买单最优挂单数量
"a":"25.36520000", // 卖单最优挂单价格
"A":"40.66000000" // 卖单最优挂单数量
}
实时推送指定交易对最优挂单信息
多个
Stream 名称:
更新速度: 实时
平均价格
Payload:
{
"e": "avgPrice", // Event type
"E": 1693907033000, // Event time
"s": "BTCUSDT", // Symbol
"i": "5m", // Average price interval
"w": "25776.86000000", // Average price
"T": 1693907032213 // Last trade time
}
平均价格流推送在固定时间间隔内的平均价格变动。
Stream 名称:
更新速度: 1000ms
有限档深度信息
Payload:
{
"lastUpdateId": 160, // Last update ID
"bids": [ // Bids to be updated
[
"0.0024", // Price level to be updated
"10" // Quantity
]
],
"asks": [ // Asks to be updated
[
"0.0026", // Price level to be updated
"100" // Quantity
]
]
}
每秒或每100毫秒推送有限档深度信息。levels表示几档买卖单信息, 可选 5/10/20档
Stream 名称:
更新速度: 1000ms 或 100ms
增量深度信息
Payload:
{
"e": "depthUpdate", // 事件类型
"E": 1672515782136, // 事件时间
"s": "BNBBTC", // 交易对
"U": 157, // 从上次推送至今新增的第一个 update Id
"u": 160, // 从上次推送至今新增的最后一个 update Id
"b": [ // 变动的买单深度
[
"0.0024", // 变动的价格档位
"10" // 数量
]
],
"a": [ // 变动的卖单深度
[
"0.0026", // 变动的价格档位
"100" // 数量
]
]
}
每秒或每100毫秒推送orderbook的变化部分(如果有)
Stream 名称:
更新速度: 1000ms 或 100ms
按Symbol的滚动窗口统计
Payload:
{
"e": "1hTicker", // Event type
"E": 1672515782136, // Event time
"s": "BNBBTC", // Symbol
"p": "0.0015", // Price change
"P": "250.00", // Price change percent
"o": "0.0010", // Open price
"h": "0.0025", // High price
"l": "0.0010", // Low price
"c": "0.0025", // Last price
"w": "0.0018", // Weighted average price
"v": "10000", // Total traded base asset volume
"q": "18", // Total traded quote asset volume
"O": 0, // Statistics open time
"C": 86400000, // Statistics close time
"F": 0, // First trade ID
"L": 18150, // Last trade Id
"n": 18151 // Total number of trades
}
单个symbol的滚动窗口统计, 支持多个时间窗口。
Stream 名称:
Window Sizes: 1h, 4h,1d
更新速度: 1000ms
注意:
- 该数据流和
- O (open time) 会在每分钟整点开始, 而 C (closing time)是当前更新时间。
- 实际统计的时间范围会比
全市场滚动窗口统计
Payload:
[
{
// 同
// 间隔内更新的每个symbol。
}
]
全市场symbols的滚动窗口ticker统计，计算于多个窗口。
注意：有变动的ticker才会推送。
Stream 名称: !ticker_
Window Size: 1h, 4h,1d
更新速度: 1000ms
如何正确在本地维护一个orderbook副本
订阅 wss://stream.binance.com:9443/ws/bnbbtc@depth
开始缓存收到的更新。同一个价位，后收到的更新覆盖前面的。
访问Rest接口 https://api.binance.com/api/v3/depth?symbol=BNBBTC&limit=1000 获得一个1000档的深度快照
将目前缓存到的信息中u <= 步骤3中获取到的快照中的lastUpdateId的部分丢弃(丢弃更早的信息，已经过期)。
将深度快照中的内容更新到本地orderbook副本中，并从websocket接收到的第一个U <= lastUpdateId+1 且 u >= lastUpdateId+1 的event开始继续更新本地副本。
每一个新event的U应该恰好等于上一个event的u+1，否则可能出现了丢包，请从step3重新进行初始化。
每一个event中的挂单量代表这个价格目前的挂单量绝对值，而不是相对变化。
如果某个价格对应的挂单量为0，表示该价位的挂单已经撤单或者被吃，应该移除这个价位。
注意:
因为深度快照对价格档位数量有限制，初始快照之外的价格档位并且没有数量变化的价格档位不会出现在增量深度的更新信息内。因此，即使应用来自增量深度的所有更新，这些价格档位也不会在本地 order book 中可见，所以本地的 order book 与真实的 order book 可能会有一些差异。 不过对于大多数用例，5000 的深度限制足以有效地了解市场和交易。
现货交易接口测试下单 (TRADE)
响应
{}
或者
{
"standardCommissionForOrder": { // 订单交易的标准佣金率
"maker": "0.00000112",
"taker": "0.00000114",
},
"taxCommissionForOrder": { // 订单交易的税率
"maker": "0.00000112",
"taker": "0.00000114",
},
"discount": { // 以BNB支付时的标准佣金折扣。
"enabledForAccount": true,
"enabledForSymbol": true,
"discountAsset": "BNB",
"discount": "0.25000000" // 当用BNB支付佣金时，在标准佣金上按此比率打折
}
}
POST /api/v3/order/test
用于测试订单请求，但不会提交到撮合引擎
权重:
条件
请求权重
没有 computeCommissionRates
1
有 computeCommissionRates
20
参数:
除了 POST /api/v3/order 所有参数,
下面参数也支持:
参数名
类型
是否必需
描述
computeCommissionRates
BOOLEAN
NO
默认值: false
数据源:
缓存
下单 (TRADE)
Response ACK:
{
"symbol": "BTCUSDT",
"orderId": 28,
"orderListId": -1, // OCO订单ID，否则为 -1
"clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
"transactTime": 1507725176595
}
Response RESULT:
{
"symbol": "BTCUSDT",
"orderId": 28,
"orderListId": -1, // OCO订单ID，否则为 -1
"clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
"transactTime": 1507725176595,
"price": "0.00000000",
"origQty": "10.00000000",
"executedQty": "10.00000000",
"cummulativeQuoteQty": "10.00000000",
"status": "FILLED",
"timeInForce": "GTC",
"type": "MARKET",
"side": "SELL",
"workingTime": 1507725176595,
"selfTradePreventionMode": "NONE"
}
Response FULL:
{
"symbol": "BTCUSDT", // 交易对
"orderId": 28, // 系统的订单ID
"orderListId": -1, // OCO订单ID，否则为 -1
"clientOrderId": "6gCrw2kRUAF9CvJDGP16IP", // 客户自己设置的ID
"transactTime": 1507725176595, // 交易的时间戳
"price": "0.00000000", // 订单价格
"origQty": "10.00000000", // 用户设置的原始订单数量
"executedQty": "10.00000000", // 交易的订单数量
"cummulativeQuoteQty": "10.00000000", // 累计交易的金额
"status": "FILLED", // 订单状态
"timeInForce": "GTC", // 订单的时效方式
"type": "MARKET", // 订单类型， 比如市价单，现价单等
"side": "SELL", // 订单方向，买还是卖
"workingTime": 1507725176595, // 订单添加到 order book 的时间
"selfTradePreventionMode": "NONE", // 自我交易预防模式
"fills": [ // 订单中交易的信息
{
"price": "4000.00000000", // 交易的价格
"qty": "1.00000000", // 交易的数量
"commission": "4.00000000", // 手续费金额
"commissionAsset": "USDT", // 手续费的币种
"tradeId": 56 // 交易ID
},
{
"price": "3999.00000000",
"qty": "5.00000000",
"commission": "19.99500000",
"commissionAsset": "USDT",
"tradeId": 57
},
{
"price": "3998.00000000",
"qty": "2.00000000",
"commission": "7.99600000",
"commissionAsset": "USDT",
"tradeId": 58
},
{
"price": "3997.00000000",
"qty": "1.00000000",
"commission": "3.99700000",
"commissionAsset": "USDT",
"tradeId": 59
},
{
"price": "3995.00000000",
"qty": "1.00000000",
"commission": "3.99500000",
"commissionAsset": "USDT",
"tradeId": 60
}
]
}
POST /api/v3/order
发送下单。
权重(UID): 1
权重(IP): 1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
side
ENUM
YES
详见枚举定义：订单方向
type
ENUM
YES
详见枚举定义：订单类型
timeInForce
ENUM
NO
详见枚举定义：有效方式
quantity
DECIMAL
NO
quoteOrderQty
DECIMAL
NO
price
DECIMAL
NO
newClientOrderId
STRING
NO
客户自定义的唯一订单ID。 如果未发送，则自动生成。
stopPrice
DECIMAL
NO
仅 STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT 和 TAKE_PROFIT_LIMIT 需要此参数。
trailingDelta
LONG
NO
用于 STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT 和 TAKE_PROFIT_LIMIT 类型的订单。更多追踪止盈止损订单细节, 请参考 追踪止盈止损(Trailing Stop)订单常见问题。
icebergQty
DECIMAL
NO
仅使用 LIMIT, STOP_LOSS_LIMIT, 和 TAKE_PROFIT_LIMIT 创建新的 iceberg 订单时需要此参数。
newOrderRespType
ENUM
NO
设置响应JSON。ACK，RESULT 或 FULL；MARKET 和 LIMIT 订单类型默认为 FULL，所有其他订单默认为 ACK。
selfTradePreventionMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER，EXPIRE_MAKER，EXPIRE_BOTH，NONE。
strategyId
INT
NO
strategyType
INT
NO
不能低于 1000000
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
基于订单 type不同，强制要求某些参数:
类型
强制要求的参数
LIMIT
timeInForce, quantity, price
MARKET
quantity 或者 quoteOrderQty
STOP_LOSS
quantity, stopPrice 或者 trailingDelta
STOP_LOSS_LIMIT
timeInForce, quantity, price, stopPrice 或者 trailingDelta
TAKE_PROFIT
quantity, stopPrice 或者 trailingDelta
TAKE_PROFIT_LIMIT
timeInForce, quantity, price, stopPrice 或者 trailingDelta
LIMIT_MAKER
quantity, price
其他信息:
LIMIT_MAKER是LIMIT订单，如果它们立即匹配并成为吃单方将被拒绝。
当触发stopPrice时，STOP_LOSS和TAKE_PROFIT将执行MARKET订单。
任何LIMIT或LIMIT_MAKER类型的订单都可以通过发送icebergQty而成为iceberg订单。
任何带有icebergQty的订单都必须将timeInForce设置为GTC。
使用 quantity 的市价单 MARKET 明确的是用户想用市价单买入或卖出的数量。
比如在BTCUSDT上下一个市价单, quantity用户指明能够买进或者卖出多少BTC。
使用 quoteOrderQty 的市价单MARKET 明确的是通过买入(或卖出)想要花费(或获取)的报价资产数量; 此时的正确报单数量将会以市场流动性和quoteOrderQty被计算出来。
以BTCUSDT为例, quoteOrderQty=100:
下买单的时候, 订单会尽可能的买进价值100USDT的BTC.
下卖单的时候, 订单会尽可能的卖出价值100USDT的BTC.
使用 quoteOrderQty 的市价单MARKET不会突破LOT_SIZE的限制规则; 报单会按给定的quoteOrderQty尽可能接近地被执行。
除非之前的订单已经成交, 不然设置了相同的newClientOrderId订单会被拒绝。
对于 STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT_LIMIT 和 TAKE_PROFIT 订单, trailingDelta可以和 stopPrice一起使用.
MARKET版本和LIMIT版本针对市场价格触发订单价格规则：
价格高于市价：止损买入，获利卖出
价格低于市价：止损卖出，获利买入
关于 newOrderRespType 的三种选择
Response ACK: 返回速度最快，不包含成交信息，信息量最少
Response RESULT:返回速度居中，返回吃单成交的少量信息
Response FULL: 返回速度最慢，返回吃单成交的详细信息
订单响应中的特定条件时才会出现的字段
订单响应中的有一些字段仅在满足特定条件时才会出现。这些订单响应可以来自下订单，查询订单或取消订单，并且可以包括 OCO 订单类型。
下面列出了这些字段：
名称
描述
显示的条件
示例
icebergQty
冰山订单的数量。
只有在请求中发送 icebergQty 参数时才会出现。
"icebergQty": "0.00000000"
preventedMatchId
与 symbol 结合使用时，可用于查询因为 STP 导致订单失效的过期订单。
只有在因为 STP 导致订单失效时可见。
"preventedMatchId": 0
preventedQuantity
因为 STP 导致订单失效的数量。
只有在因为 STP 导致订单失效时可见。
"preventedQuantity": "1.200000"
stopPrice
用于设置逻辑订单中的触发价。
STOP_LOSS，TAKE_PROFIT，STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单时可见。
"stopPrice": "23500.00000000"
strategyId
策略单ID; 用以关联此订单对应的交易策略。
如果在请求中添加了参数，则会出现。
"strategyId": 37463720
strategyType
策略单类型; 用以显示此订单对应的交易策略。
如果在请求中添加了参数，则会出现。
"strategyType": 1000000
trailingDelta
用以定义追踪止盈止损订单被触发的价格差。
出现在追踪止损订单中。
"trailingDelta": 10
trailingTime
追踪单被激活和跟踪价格变化的时间。
出现在追踪止损订单中。
"trailingTime": -1
撤销订单 (TRADE)
响应
{
"symbol": "LTCBTC",
"origClientOrderId": "myOrder1",
"orderId": 4,
"orderListId": -1, // OCO订单ID，否则为 -1
"clientOrderId": "cancelMyOrder1",
"transactTime": 1684804350068,
"price": "2.00000000",
"origQty": "1.00000000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"selfTradePreventionMode": "NONE"
}
DELETE /api/v3/order
取消有效订单。
权重(IP):
1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
orderId
LONG
NO
origClientOrderId
STRING
NO
newClientOrderId
STRING
NO
用户自定义的本次撤销操作的ID(注意不是被撤销的订单的自定义ID)。如无指定会自动赋值。
cancelRestrictions
ENUM
NO
支持的值: ONLY_NEW - 如果订单状态为 NEW，订单取消将成功。 ONLY_PARTIALLY_FILLED - 如果订单状态为 PARTIALLY_FILLED，订单取消将成功。
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
orderId 或 origClientOrderId 必须至少发送一个
数据源:
撮合引擎
关于 cancelRestrictions
如果 cancelRestrictions 值不是任何受支持的值，则错误将是：
{"code": -1145,"msg": "Invalid cancelRestrictions"}
如果订单没有通过 cancelRestrictions 的条件，错误将是：
{"code": -2011,"msg": "Order was not canceled due to cancel restrictions."}
注意: 响应示例没有显示所有可以出现的字段，更多请看 "订单响应中的特定条件时才会出现的字段" 部分。
撤销单一交易对的所有挂单 (TRADE)
Response:
[
{
"symbol": "BTCUSDT",
"origClientOrderId": "E6APeyTJvkMvLMYMqu1KQ4",
"orderId": 11,
"orderListId": -1,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"transactTime": 1684804350068,
"price": "0.089853",
"origQty": "0.178622",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"selfTradePreventionMode": "NONE"
},
{
"symbol": "BTCUSDT",
"origClientOrderId": "A3EF2HCwxgZPFMrfwbgrhv",
"orderId": 13,
"orderListId": -1,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"transactTime": 1684804350068,
"price": "0.090430",
"origQty": "0.178622",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"selfTradePreventionMode": "NONE"
},
{
"orderListId": 1929,
"contingencyType": "OCO",
"listStatusType": "ALL_DONE",
"listOrderStatus": "ALL_DONE",
"listClientOrderId": "2inzWQdDvZLHbbAmAozX2N",
"transactionTime": 1585230948299,
"symbol": "BTCUSDT",
"orders": [
{
"symbol": "BTCUSDT",
"orderId": 20,
"clientOrderId": "CwOOIPHSmYywx6jZX77TdL"
},
{
"symbol": "BTCUSDT",
"orderId": 21,
"clientOrderId": "461cPg51vQjV3zIMOXNz39"
}
],
"orderReports": [
{
"symbol": "BTCUSDT",
"origClientOrderId": "CwOOIPHSmYywx6jZX77TdL",
"orderId": 20,
"orderListId": 1929,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"transactTime": 1684804350068,
"price": "0.668611",
"origQty": "0.690354",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "STOP_LOSS_LIMIT",
"side": "BUY",
"stopPrice": "0.378131",
"icebergQty": "0.017083",
"selfTradePreventionMode": "NONE"
},
{
"symbol": "BTCUSDT",
"origClientOrderId": "461cPg51vQjV3zIMOXNz39",
"orderId": 21,
"orderListId": 1929,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"transactTime": 1684804350068,
"price": "0.008791",
"origQty": "0.690354",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "BUY",
"icebergQty": "0.639962",
"selfTradePreventionMode": "NONE"
}
]
}
]
DELETE /api/v3/openOrders
撤销单一交易对下所有挂单, 包括OCO的挂单。
权重(IP):
1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
数据源:
撮合引擎
注意: 响应示例没有显示所有可以出现的字段，更多请看 "订单响应中的特定条件时才会出现的字段" 部分。
撤消挂单再下单 (TRADE)
响应：SUCCESS:
// 撤单和下单都成功
{
"cancelResult": "SUCCESS",
"newOrderResult": "SUCCESS",
"cancelResponse": {
"symbol": "BTCUSDT",
"origClientOrderId": "DnLo3vTAQcjha43lAZhZ0y",
"orderId": 9,
"orderListId": -1,
"clientOrderId": "osxN3JXAtJvKvCqGeMWMVR",
"transactTime": 1684804350068,
"price": "0.01000000",
"origQty": "0.000100",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "SELL",
"selfTradePreventionMode": "NONE"
},
"newOrderResponse": {
"symbol": "BTCUSDT",
"orderId": 10,
"orderListId": -1,
"clientOrderId": "wOceeeOzNORyLiQfw7jd8S",
"transactTime": 1652928801803,
"price": "0.02000000",
"origQty": "0.040000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"workingTime": 1669277163808,
"fills": [],
"selfTradePreventionMode": "NONE"
}
}
响应：选择了 STOP_ON_FAILURE，撤单出现错误
{
"code": -2022,
"msg": "Order cancel-replace failed.",
"data": {
"cancelResult": "FAILURE",
"newOrderResult": "NOT_ATTEMPTED",
"cancelResponse": {
"code": -2011,
"msg": "Unknown order sent."
},
"newOrderResponse": null
}
}
响应：撤单成功，下单失败
{
"code": -2021,
"msg": "Order cancel-replace partially failed.",
"data": {
"cancelResult": "SUCCESS",
"newOrderResult": "FAILURE",
"cancelResponse": {
"symbol": "BTCUSDT",
"origClientOrderId": "86M8erehfExV8z2RC8Zo8k",
"orderId": 3,
"orderListId": -1,
"clientOrderId": "G1kLo6aDv2KGNTFcjfTSFq",
"transactTime": 1684804350068,
"price": "0.006123",
"origQty": "10000.000000",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "SELL",
"selfTradePreventionMode": "NONE"
},
"newOrderResponse": {
"code": -2010,
"msg": "Order would immediately match and take."
}
}
}
响应：选择了 ALLOW_FAILURE，撤单出现错误
{
"code": -2021,
"msg": "Order cancel-replace partially failed.",
"data": {
"cancelResult": "FAILURE",
"newOrderResult": "SUCCESS",
"cancelResponse": {
"code": -2011,
"msg": "Unknown order sent."
},
"newOrderResponse": {
"symbol": "BTCUSDT",
"orderId": 11,
"orderListId": -1,
"clientOrderId": "pfojJMg6IMNDKuJqDxvoxN",
"transactTime": 1648540168818
}
}
}
响应：撤单和下单失败
{
"code": -2022,
"msg": "Order cancel-replace failed.",
"data": {
"cancelResult": "FAILURE",
"newOrderResult": "FAILURE",
"cancelResponse": {
"code": -2011,
"msg": "Unknown order sent."
},
"newOrderResponse": {
"code": -2010,
"msg": "Order would immediately match and take."
}
}
}
POST /api/v3/order/cancelReplace
撤消挂单并在同个交易对上重新下单。
在撤消订单和下单前会判断: 1) 过滤器参数, 以及 2) 目前下单数量。
即使请求中没有尝试发送新订单，比如(newOrderResult: NOT_ATTEMPTED)，下单的数量仍然会加1。
Weight(IP):
1
Parameters:
名称
类型
是否必需
描述
symbol
STRING
YES
side
ENUM
YES
type
ENUM
YES
cancelReplaceMode
ENUM
YES
指定类型：STOP_ON_FAILURE - 如果撤消订单失败将不会继续重新下单。 ALLOW_FAILURE - 不管撤消订单是否成功都会继续重新下单。
timeInForce
ENUM
NO
quantity
DECIMAL
NO
quoteOrderQty
DECIMAL
NO
price
DECIMAL
NO
cancelNewClientOrderId
STRING
NO
用户自定义的id，如空缺系统会自动赋值
cancelOrigClientOrderId
STRING
NO
必须提供cancelOrigClientOrderId 或者 cancelOrderId。 如果两个参数都提供, cancelOrderId 会占优先。
cancelOrderId
LONG
NO
必须提供cancelOrigClientOrderId 或者 cancelOrderId。 如果两个参数都提供, cancelOrderId 会占优先。
newClientOrderId
STRING
NO
用于辨识新订单。
strategyId
INT
NO
strategyType
INT
NO
不能低于 1000000
stopPrice
DECIMAL
NO
trailingDelta
LONG
NO
icebergQty
DECIMAL
NO
newOrderRespType
ENUM
NO
指定响应类型: 指定响应类型 ACK, RESULT, 或者 FULL; MARKET 与 LIMIT 订单默认为FULL, 其他默认为ACK.
selfTradePreventionMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER，EXPIRE_MAKER，EXPIRE_BOTH，NONE。
cancelRestrictions
ENUM
NO
支持的值: ONLY_NEW - 如果订单状态为 NEW，撤销将成功。 ONLY_PARTIALLY_FILLED - 如果订单状态为 PARTIALLY_FILLED，撤销将成功。
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
如同 POST /api/v3/order , 额外的强制参数取决于 type 。
响应格式根据消息的处理是成功、部分成功还是失败而有所不同。
数据来源:
撮合引擎
注意: 响应示例没有显示所有可以出现的字段，更多请看 "订单响应中的特定条件时才会出现的字段" 部分。
查询订单 (USER_DATA)
响应
{
"symbol": "LTCBTC", // 交易对
"orderId": 1, // 系统的订单ID
"orderListId": -1, // OCO订单的ID，不然就是-1
"clientOrderId": "myOrder1", // 客户自己设置的ID
"price": "0.1", // 订单价格
"origQty": "1.0", // 用户设置的原始订单数量
"executedQty": "0.0", // 交易的订单数量
"cummulativeQuoteQty": "0.0", // 累计交易的金额
"status": "NEW", // 订单状态
"timeInForce": "GTC", // 订单的时效方式
"type": "LIMIT", // 订单类型， 比如市价单，现价单等
"side": "BUY", // 订单方向，买还是卖
"stopPrice": "0.0", // 止损价格
"icebergQty": "0.0", // 冰山数量
"time": 1499827319559, // 订单时间
"updateTime": 1499827319559, // 最后更新时间
"isWorking": true, // 订单是否出现在orderbook中
"workingTime":1499827319559,
"origQuoteOrderQty": "0.000000", // 原始的交易金额
"selfTradePreventionMode": "NONE"
}
GET /api/v3/order
查询订单状态。
权重(IP):
4
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
orderId
LONG
NO
origClientOrderId
STRING
NO
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
注意:
至少需要发送 orderId 与 origClientOrderId中的一个
某些订单中cummulativeQuoteQty<0，是由于这些订单是cummulativeQuoteQty功能上线之前的订单。
响应示例没有显示所有可以出现的字段，更多请看 "订单响应中的特定条件时才会出现的字段" 部分。
数据源:
数据库
当前挂单 (USER_DATA)
响应
[
{
"symbol": "LTCBTC",
"orderId": 1,
"orderListId": -1, // OCO订单ID，否则为 -1
"clientOrderId": "myOrder1",
"price": "0.1",
"origQty": "1.0",
"executedQty": "0.0",
"cummulativeQuoteQty": "0.0",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"stopPrice": "0.0",
"icebergQty": "0.0",
"time": 1499827319559,
"updateTime": 1499827319559,
"isWorking": true,
"workingTime": 1499827319559,
"origQuoteOrderQty": "0.000000",
"selfTradePreventionMode": "NONE"
}
]
GET /api/v3/openOrders
获取交易对的所有当前挂单， 请小心使用不带交易对参数的调用。
权重(IP):
6 单一交易对;
80 交易对参数缺失;
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
不带symbol参数，会返回所有交易对的挂单
数据源:
数据库
注意: 响应示例没有显示所有可以出现的字段，更多请看 "订单响应中的特定条件时才会出现的字段" 部分。
查询所有订单 (USER_DATA)
响应
[
{
"symbol": "LTCBTC",
"orderId": 1,
"orderListId": -1, // OCO订单ID，否则为 -1
"clientOrderId": "myOrder1",
"price": "0.1",
"origQty": "1.0",
"executedQty": "0.0",
"cummulativeQuoteQty": "0.0",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"stopPrice": "0.0",
"icebergQty": "0.0",
"time": 1499827319559,
"updateTime": 1499827319559,
"isWorking": true,
"origQuoteOrderQty": "0.000000",
"workingTime": 1499827319559,
"selfTradePreventionMode": "NONE"
}
]
GET /api/v3/allOrders
获取所有帐户订单； 有效，已取消或已完成。
权重(IP):
20
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
orderId
LONG
NO
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 500; 最大 1000.
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
注意:
如设置 orderId , 订单量将 >= orderId。否则将返回最新订单。
一些历史订单 cummulativeQuoteQty < 0, 是指数据此时不存在。
如果设置 startTime 和 endTime, orderId 就不需要设置。
响应示例没有显示所有可以出现的字段，更多请看 "订单响应中的特定条件时才会出现的字段" 部分。
数据源:
数据库
OCO下单(TRADE)
响应
{
"orderListId": 0,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "JYVpp3F0f5CAG15DhtrqLp",
"transactionTime": 1563417480525,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 2,
"clientOrderId": "Kk7sqHb9J6mJWTMDVW7Vos"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"clientOrderId": "xTXKaGYd4bluPVp78IVRvl"
}
],
"orderReports": [
{
"symbol": "LTCBTC",
"orderId": 2,
"orderListId": 0,
"clientOrderId": "Kk7sqHb9J6mJWTMDVW7Vos",
"transactTime": 1563417480525,
"price": "0.000000",
"origQty": "0.624363",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "NEW",
"timeInForce": "GTC",
"type": "STOP_LOSS",
"side": "BUY",
"stopPrice": "0.960664",
"workingTime": -1,
"selfTradePreventionMode": "NONE"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"orderListId": 0,
"clientOrderId": "xTXKaGYd4bluPVp78IVRvl",
"transactTime": 1563417480525,
"price": "0.036435",
"origQty": "0.624363",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "BUY",
"stopPrice": "0.960664",
"workingTime": -1,
"selfTradePreventionMode": "NONE"
}
]
}
POST /api/v3/order/oco
发送新 OCO 订单。
权重(UID): 2
权重(IP): 1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
listClientOrderId
STRING
NO
整个orderList的唯一ID
side
ENUM
YES
详见枚举定义：订单方向
quantity
DECIMAL
YES
limitClientOrderId
STRING
NO
限价单的唯一ID
limitStrategyId
INT
NO
limitStrategyType
INT
NO
不能低于 1000000
price
DECIMAL
YES
limitIcebergQty
DECIMAL
NO
trailingDelta
LONG
NO
stopClientOrderId
STRING
NO
止损/止损限价单的唯一ID
stopPrice
DECIMAL
YES
stopStrategyId
INT
NO
stopStrategyType
INT
NO
不能低于 1000000
stopLimitPrice
DECIMAL
NO
如果提供，须配合提交stopLimitTimeInForce
stopIcebergQty
DECIMAL
NO
stopLimitTimeInForce
ENUM
NO
有效值 GTC/FOK/IOC
newOrderRespType
ENUM
NO
详见枚举定义：订单返回类型
selfTradePreventionMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER，EXPIRE_MAKER，EXPIRE_BOTH，NONE。｜
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
其他信息:
价格限制:
SELL: 限价 > 最新成交价 >触发价
BUY: 限价 < 最新成交价 < 触发价
数量限制:
两个 legs 必须具有同样的数量。
ICEBERG数量不必相同
下单rate
一个OCO订单被算成2个普通订单.
数据源:
撮合引擎
取消 OCO 订单(TRADE)
Response:
{
"orderListId": 0,
"contingencyType": "OCO",
"listStatusType": "ALL_DONE",
"listOrderStatus": "ALL_DONE",
"listClientOrderId": "C3wyj4WVEktd7u9aVBRXcN",
"transactionTime": 1574040868128,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 2,
"clientOrderId": "pO9ufTiFGg3nw2fOdgeOXa"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"clientOrderId": "TXOvglzXuaubXAaENpaRCB"
}
],
"orderReports": [
{
"symbol": "LTCBTC",
"origClientOrderId": "pO9ufTiFGg3nw2fOdgeOXa",
"orderId": 2,
"orderListId": 0,
"clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
"transactTime": 1688005070874,
"price": "1.00000000",
"origQty": "10.00000000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "STOP_LOSS_LIMIT",
"side": "SELL",
"stopPrice": "1.00000000",
"selfTradePreventionMode": "NONE"
},
{
"symbol": "LTCBTC",
"origClientOrderId": "TXOvglzXuaubXAaENpaRCB",
"orderId": 3,
"orderListId": 0,
"clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
"transactTime": 1688005070874,
"price": "3.00000000",
"origQty": "10.00000000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "SELL",
"selfTradePreventionMode": "NONE"
}
]
}
DELETE /api/v3/orderList
取消整个订单列表。
权重(IP): 1
参数
名称
类型
是否必需
描述
symbol
STRING
YES
orderListId
LONG
NO
orderListId 或 listClientOrderId 必须被提供
listClientOrderId
STRING
NO
orderListId 或 listClientOrderId 必须被提供
newClientOrderId
STRING
NO
用户自定义的本次撤销操作的ID(注意不是被撤销的订单的自定义ID)。如无指定会自动赋值。
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
其他注意点:
取消单个 leg 将取消整个 OCO 订单。
数据源:
撮合引擎
查询 OCO (USER_DATA)
响应
{
"orderListId": 27,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "h2USkA5YQpaXHPIrkd96xE",
"transactionTime": 1565245656253,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 4,
"clientOrderId": "qD1gy3kc3Gx0rihm9Y3xwS"
},
{
"symbol": "LTCBTC",
"orderId": 5,
"clientOrderId": "ARzZ9I00CPM8i3NhmU9Ega"
}
]
}
GET /api/v3/orderList
根据提供的可选参数检索特定的OCO。
权重(IP): 4
参数:
名称
类型
是否必需
描述
orderListId
LONG
NO
orderListId 或 origClientOrderId 必须提供一个。
origClientOrderId
STRING
NO
orderListId 或 origClientOrderId 必须提供一个。
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
数据源:
数据库
查询所有 OCO (USER_DATA)
响应
[
{
"orderListId": 29,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "amEEAXryFzFwYF1FeRpUoZ",
"transactionTime": 1565245913483,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 4,
"clientOrderId": "oD7aesZqjEGlZrbtRpy5zB"
},
{
"symbol": "LTCBTC",
"orderId": 5,
"clientOrderId": "Jr1h6xirOxgeJOUuYQS7V3"
}
]
},
{
"orderListId": 28,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "hG7hFNxJV6cZy3Ze4AUT4d",
"transactionTime": 1565245913407,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 2,
"clientOrderId": "j6lFOfbmFMRjTYA7rRJ0LP"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"clientOrderId": "z0KCjOdditiLS5ekAFtK81"
}
]
}
]
GET /api/v3/allOrderList
根据提供的可选参数检索所有的OCO。
权重(IP): 20
参数
名称
类型
是否必需
描述
fromId
LONG
NO
提供该项后, startTime 和 endTime 都不可提供
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认值: 500; 最大值: 1000
recvWindow
LONG
NO
赋值不能超过 60000
timestamp
LONG
YES
数据源:
数据库
查询 OCO 挂单 (USER_DATA)
响应
[
{
"orderListId": 31,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "wuB13fmulKj3YjdqWEcsnp",
"transactionTime": 1565246080644,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 4,
"clientOrderId": "r3EH2N76dHfLoSZWIUw1bT"
},
{
"symbol": "LTCBTC",
"orderId": 5,
"clientOrderId": "Cv1SnyPD3qhqpbjpYEHbd2"
}
]
}
]
GET /api/v3/openOrderList
权重(IP): 6
参数
名称
类型
是否必需
描述
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
数据源:
数据库
下 SOR 订单 (TRADE)
响应:
{
"symbol": "BTCUSDT",
"orderId": 2,
"orderListId": -1,
"clientOrderId": "sBI1KM6nNtOfj5tccZSKly",
"transactTime": 1689149087774,
"price": "31000.00000000",
"origQty": "0.50000000",
"executedQty": "0.50000000",
"cummulativeQuoteQty": "14000.00000000",
"status": "FILLED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"workingTime": 1689149087774,
"fills": [
{
"matchType": "ONE_PARTY_TRADE_REPORT",
"price": "28000.00000000",
"qty": "0.50000000",
"commission": "0.00000000",
"commissionAsset": "BTC",
"tradeId": -1,
"allocId": 0
}
],
"workingFloor": "SOR",
"selfTradePreventionMode": "NONE",
"usedSor": true
}
POST /api/v3/sor/order
发送使用智能订单路由 (SOR) 的新订单。
权重(IP):
1
参数
名称
类型
是否必需
描述
symbol
STRING
YES
side
ENUM
YES
type
ENUM
YES
timeInForce
ENUM
NO
quantity
DECIMAL
YES
price
DECIMAL
NO
newClientOrderId
STRING
NO
用户自定义的orderid，如空缺系统会自动赋值。如果几个订单具有相同的 newClientOrderID 赋值，那么只有在前一个订单成交后才可以接受下一个订单，否则该订单将被拒绝。
strategyId
INT
NO
strategyType
INT
NO
赋值不能小于 1000000.
icebergQty
DECIMAL
NO
仅有限价单可以使用该参数，含义为创建冰山订单并指定冰山订单的数量。
newOrderRespType
ENUM
NO
指定响应类型: 指定响应类型 ACK, RESULT 或 FULL; 默认为 FULL。
selfTradePreventionMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER，EXPIRE_MAKER，EXPIRE_BOTH，NONE。
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
请注意: POST /api/v3/sor/order 只支持 限价 和 市场 单， 并不支持 quoteOrderQty。
数据源:
撮合引擎
测试 SOR 下单接口 (TRADE)
响应:
{}
或者
{
"standardCommissionForOrder": { // 订单交易的标准佣金率
"maker": "0.00000112",
"taker": "0.00000114",
},
"taxCommissionForOrder": { // 订单交易的税率
"maker": "0.00000112",
"taker": "0.00000114",
},
"discount": { // 以BNB支付时的标准佣金折扣。
"enabledForAccount": true,
"enabledForSymbol": true,
"discountAsset": "BNB",
"discount": "0.25000000" // 当用BNB支付佣金时，在标准佣金上按此比率打折
}
}
POST /api/v3/sor/order/test
用于测试使用智能订单路由 (SOR) 的订单请求，但不会提交到撮合引擎
权重:
条件
请求权重
没有 computeCommissionRates
1
有 computeCommissionRates
20
参数:
除了 POST /api/v3/sor/order 所有参数,
如下参数也接受:
参数名
类型
是否必需
描述
computeCommissionRates
BOOLEAN
NO
默认值: false
数据源:
缓存
现货账户接口账户信息 (USER_DATA)
响应
{
"makerCommission": 15,
"takerCommission": 15,
"buyerCommission": 0,
"sellerCommission": 0,
"commissionRates": {
"maker": "0.00150000",
"taker": "0.00150000",
"buyer": "0.00000000",
"seller": "0.00000000"
},
"canTrade": true,
"canWithdraw": true,
"canDeposit": true,
"brokered": false,
"requireSelfTradePrevention": false,
"preventSor": false,
"updateTime": 123456789,
"accountType": "SPOT",
"balances": [
{
"asset": "BTC",
"free": "4723846.89208129",
"locked": "0.00000000"
},
{
"asset": "LTC",
"free": "4763368.68006011",
"locked": "0.00000000"
}
],
"permissions": [
"SPOT"
],
"uid": 354937868
}
GET /api/v3/account
获取当前账户信息。
权重(IP):
20
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
数据源:
缓存 => 数据库
账户成交历史 (USER_DATA)
响应
[
{
"symbol": "BNBBTC", // 交易对
"id": 28457, // trade ID
"orderId": 100234, // 订单ID
"orderListId": -1, // OCO订单的ID，不然就是-1
"price": "4.00000100", // 成交价格
"qty": "12.00000000", // 成交量
"quoteQty": "48.000012", // 成交金额
"commission": "10.10000000", // 交易费金额
"commissionAsset": "BNB", // 交易费资产类型
"time": 1499865549590, // 交易时间
"isBuyer": true, // 是否是买家
"isMaker": false, // 是否是挂单方
"isBestMatch": true
}
]
GET /api/v3/myTrades
获取账户指定交易对的成交历史
权重(IP):
20
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
orderId
LONG
NO
必须要和参数symbol一起使用.
startTime
LONG
NO
endTime
LONG
NO
fromId
LONG
NO
起始Trade id。 默认获取最新交易。
limit
INT
NO
默认 500; 最大 1000.
recvWindow
LONG
NO
赋值不能超过 60000
timestamp
LONG
YES
注意:
如果设定 fromId , 获取订单 >= fromId.
否则返回最近订单。
startTime和endTime设置的时间间隔不能超过24小时.
支持的所有参数组合：
symbol
symbol + orderId
symbol + startTime
symbol + endTime
symbol + fromId
symbol + startTime + endTime
symbol+ orderId + fromId
数据源:
数据库
查询目前下单数 (TRADE)
响应
[
{
"rateLimitType": "ORDERS",
"interval": "SECOND",
"intervalNum": 10,
"limit": 10000,
"count": 0
},
{
"rateLimitType": "ORDERS",
"interval": "DAY",
"intervalNum": 1,
"limit": 20000,
"count": 0
}
]
GET /api/v3/rateLimit/order
获取用户在当前时间区间内的下单总数。
权重(IP):
40
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
数据源:
缓存
获取 Prevented Matches (USER_DATA)
响应:
[
{
"symbol": "BTCUSDT",
"preventedMatchId": 1,
"takerOrderId": 5,
"makerOrderId": 3,
"tradeGroupId": 1,
"selfTradePreventionMode": "EXPIRE_MAKER",
"price": "1.100000",
"makerPreventedQuantity": "1.300000",
"transactTime": 1669101687094
}
]
GET /api/v3/myPreventedMatches
获取因 STP 触发而过期的订单列表。
对于什么是"阻止"匹配以及STP的更多相关信息，请参阅我们的 STP FAQ_CN 页面。
这些是支持的组合：
symbol + preventedMatchId
symbol + orderId
symbol + orderId + fromPreventedMatchId (limit 默认为 500)
symbol + orderId + fromPreventedMatchId + limit
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
preventedMatchId
LONG
NO
orderId
LONG
NO
fromPreventedMatchId
LONG
NO
limit
INT
NO
默认：500；最大：1000
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
权重(IP):
情况
权重
如果 symbol 是无效的
2
通过 preventedMatchId 查询
2
通过 orderId 查询
20
数据源:
数据库
查询分配结果 (USER_DATA)
响应:
[
{
"symbol": "BTCUSDT",
"allocationId": 0,
"allocationType": "SOR",
"orderId": 1,
"orderListId": -1,
"price": "1.00000000",
"qty": "5.00000000",
"quoteQty": "5.00000000",
"commission": "0.00000000",
"commissionAsset": "BTC",
"time": 1687506878118,
"isBuyer": true,
"isMaker": false,
"isAllocator": false
}
]
GET /api/v3/myAllocations
检索由 SOR 订单生成引起的分配结果。
权重:
20
参数:
名称
类型
是否必需
描述
symbol
STRING
Yes
startTime
LONG
No
endTime
LONG
No
fromAllocationId
INT
No
limit
INT
No
默认值 500； 最大值 1000
orderId
LONG
No
recvWindow
LONG
No
不能大于 60000
timestamp
LONG
No
支持的参数组合:
参数
响应
symbol
按从最旧到最新排序的分配
symbol + startTime
从 startTime 开始的最旧的分配
symbol + endTime
到 endTime 为止的最新的分配
symbol + startTime + endTime
在指定时间范围内的分配
symbol + fromAllocationId
从指定 AllocationId 开始的分配
symbol + orderId
按从最旧到最新排序并和特定订单关联的分配
symbol + orderId + fromAllocationId
从指定 AllocationId 开始并和特定订单关联的分配
注意: startTime 和 endTime 之间的时间不能超过 24 小时。
数据源:
数据库
查询佣金费率 (USER_DATA)
响应:
{
"symbol": "BTCUSDT",
"standardCommission": { // 订单交易的标准佣金率
"maker": "0.00000010",
"taker": "0.00000020",
"buyer": "0.00000030",
"seller": "0.00000040"
},
"taxCommission": { // 订单交易的税率
"maker": "0.00000112",
"taker": "0.00000114",
"buyer": "0.00000118",
"seller": "0.00000116"
},
"discount": { // 使用BNB支付时的佣金折扣。
"enabledForAccount": true,
"enabledForSymbol": true,
"discountAsset": "BNB",
"discount": "0.25000000" // 当用BNB支付佣金时，在标准佣金上按此比率打折
}
}
GET /api/v3/account/commission
获取当前账户的佣金费率。
权重:
20
参数:
参数名
类型
是否必需
描述
symbol
STRING
YES
数据源:
数据库
杠杆账户和交易接口杠杆账户借贷/还款(MARGIN)
响应
{
//transaction id
"tranId": 100000001
}
POST /sapi/v1/margin/borrow-repay
杠杆账户借贷/还款
权重(UID):
3000
参数:
名称
类型
是否必需
描述
asset
STRING
YES
isIsolated
STRING
YES
是否逐仓杠杆，TRUE, FALSE, 默认 FALSE
symbol
STRING
YES
逐仓交易对，配合逐仓使用
amount
STRING
YES
type
STRING
YES
操作类型：BORROW、REPAY
recvWindow
LONG
NO
The value cannot be greater than 60000
timestamp
LONG
YES
查询借贷/还款记录(USER_DATA)
响应
{
"rows": [
{
"isolatedSymbol": "BNBUSDT", // 逐仓还款 返回逐仓symbol; 若是全仓不会返回此字段
"amount": "14.00000000", // 还款总额
"asset": "BNB",
"interest": "0.01866667", // 支付的利息
"principal": "13.98133333", // 支付的本金
"status": "CONFIRMED", //状态: PENDING (等待执行), CONFIRMED (成功还款), FAILED (执行失败);
"timestamp": 1563438204000,
"txId": 2970933056
}
],
"total": 1
}
GET /sapi/v1/margin/borrow-repay
查询借贷/还款记录
权重(IP):
10
参数:
名称
类型
是否必需
描述
asset
STRING
NO
isolatedSymbol
STRING
NO
逐仓symbol
txId
LONG
NO
POST /sapi/v1/margin/loan中的tranId
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1。 默认:1
size
LONG
NO
默认:10 最大:100
type
STRING
YES
操作类型：BORROW、REPAY
recvWindow
LONG
NO
The value cannot be greater than 60000
timestamp
LONG
YES
必须发送txId或startTime，txId优先
响应返回为降序排列。
传了asset参数，最大查询时间范围为endTime往前30天；不传asset参数，最大查询时间范围为endTime往前7天。
若startTime和endTime没传，则默认返回最近7天数据
startTime不传，默认endTime-7天；结束时间不传，默认当前时间
获取所有杠杆资产信息 (MARKET_DATA)
响应
[
{
"assetFullName": "USD coin",
"assetName": "USDC",
"isBorrowable": true,
"isMortgageable": true,
"userMinBorrow": "0.00000000",
"userMinRepay": "0.00000000",
"delistTime": 1704973040
}
]
GET /sapi/v1/margin/allAssets
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
NO
获取所有全仓杠杆交易对(MARKET_DATA)
响应
[
{
"base": "BNB",
"id": 351637150141315861,
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "BNBBTC"
},
{
"base": "TRX",
"id": 351637923235429141,
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "TRXBTC",
"delistTime": 1704973040
},
{
"base": "XRP",
"id": 351638112213990165,
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "XRPBTC"
},
{
"base": "ETH",
"id": 351638524530850581,
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "ETHBTC"
}
]
GET /sapi/v1/margin/allPairs
权重(IP):
1
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
查询杠杆价格指数 (MARKET_DATA)
响应
{
"calcTime": 1562046418000,
"price": "0.00333930",
"symbol": "BNBBTC"
}
GET /sapi/v1/margin/priceIndex
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
杠杆账户下单 (TRADE)
Response ACK:
{
"symbol": "BTCUSDT",
"orderId": 28,
"clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
"isIsolated": true, // 是否是逐仓symbol交易
"transactTime": 1507725176595
}
Response RESULT:
{
"symbol": "BTCUSDT",
"orderId": 28,
"clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
"transactTime": 1507725176595,
"price": "1.00000000",
"origQty": "10.00000000",
"executedQty": "10.00000000",
"cummulativeQuoteQty": "10.00000000",
"status": "FILLED",
"timeInForce": "GTC",
"type": "MARKET",
"isIsolated": true, // 是否是逐仓symbol交易
"side": "SELL",
"selfTradePreventionMode": "NONE"
}
Response FULL:
{
"symbol": "BTCUSDT",
"orderId": 28,
"clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
"transactTime": 1507725176595,
"price": "0.00000000",
"origQty": "10.00000000",
"executedQty": "10.00000000",
"cummulativeQuoteQty": "10.00000000",
"status": "FILLED",
"timeInForce": "GTC",
"type": "MARKET",
"side": "SELL",
"marginBuyBorrowAmount": 5, // 下单后没有发生借款则不返回该字段
"marginBuyBorrowAsset": "BTC", // 下单后没有发生借款则不返回该字段
"isIsolated": true, // 是否是逐仓symbol交易
"selfTradePreventionMode": "NONE",
"fills": [
{
"price": "4000.00000000",
"qty": "1.00000000",
"commission": "4.00000000",
"commissionAsset": "USDT"
},
{
"price": "3999.00000000",
"qty": "5.00000000",
"commission": "19.99500000",
"commissionAsset": "USDT"
},
{
"price": "3998.00000000",
"qty": "2.00000000",
"commission": "7.99600000",
"commissionAsset": "USDT"
},
{
"price": "3997.00000000",
"qty": "1.00000000",
"commission": "3.99700000",
"commissionAsset": "USDT"
},
{
"price": "3995.00000000",
"qty": "1.00000000",
"commission": "3.99500000",
"commissionAsset": "USDT"
}
]
}
POST /sapi/v1/margin/order
权重(UID):
6
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
side
ENUM
YES
BUYSELL
type
ENUM
YES
详见枚举定义：订单类型
quantity
DECIMAL
NO
quoteOrderQty
DECIMAL
NO
price
DECIMAL
NO
stopPrice
DECIMAL
NO
与STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, 和 TAKE_PROFIT_LIMIT 订单一起使用.
newClientOrderId
STRING
NO
客户自定义的唯一订单ID。若未发送自动生成。
icebergQty
DECIMAL
NO
与 LIMIT, STOP_LOSS_LIMIT, 和 TAKE_PROFIT_LIMIT 一起使用创建 iceberg 订单.
newOrderRespType
ENUM
NO
设置响应: JSON. ACK, RESULT, 或 FULL; MARKET 和 LIMIT 订单类型默认为 FULL, 所有其他订单默认为 ACK.
sideEffectType
ENUM
NO
NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY,AUTO_BORROW_REPAY;默认为 NO_SIDE_EFFECT. 详见FAQ
timeInForce
ENUM
NO
GTC,IOC,FOK
selfTradePreventionMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER，EXPIRE_MAKER，EXPIRE_BOTH，NONE
autoRepayAtCancel
BOOLEAN
NO
只有在自动借款单或者自动借还单生效，true表示的是撤单后需要把订单产生的借款归还，默认为true
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
杠杆账户撤销订单 (TRADE)
响应
{
"symbol": "LTCBTC",
"orderId": "28",
"origClientOrderId": "myOrder1",
"clientOrderId": "cancelMyOrder1",
"price": "1.00000000",
"origQty": "10.00000000",
"executedQty": "8.00000000",
"cummulativeQuoteQty": "8.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "SELL",
"isIsolated": true // 是否是逐仓symbol交易
}
DELETE /sapi/v1/margin/order
杠杆账户撤销有效订单。
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
orderId
LONG
NO
origClientOrderId
STRING
NO
newClientOrderId
STRING
NO
用于唯一识别此撤销订单，默认自动生成。
recvWindow
LONG
NO
T赋值不能大于 60000
timestamp
LONG
YES
必须发送 orderId 或 origClientOrderId 其中一个。
杠杆账户撤销单一交易对的所有挂单 (TRADE)
响应:
[
{
"symbol": "BTCUSDT",
"isIsolated": true, // 是否是逐仓symbol交易
"origClientOrderId": "E6APeyTJvkMvLMYMqu1KQ4",
"orderId": 11,
"orderListId": -1,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"price": "0.089853",
"origQty": "0.178622",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"selfTradePreventionMode": "NONE"
},
{
"symbol": "BTCUSDT",
"isIsolated": false, // 是否是逐仓symbol交易
"origClientOrderId": "A3EF2HCwxgZPFMrfwbgrhv",
"orderId": 13,
"orderListId": -1,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"price": "0.090430",
"origQty": "0.178622",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
"selfTradePreventionMode": "NONE"
},
{
"orderListId": 1929,
"contingencyType": "OCO",
"listStatusType": "ALL_DONE",
"listOrderStatus": "ALL_DONE",
"listClientOrderId": "2inzWQdDvZLHbbAmAozX2N",
"transactionTime": 1585230948299,
"symbol": "BTCUSDT",
"isIsolated": true, // 是否是逐仓symbol交易
"orders": [
{
"symbol": "BTCUSDT",
"orderId": 20,
"clientOrderId": "CwOOIPHSmYywx6jZX77TdL"
},
{
"symbol": "BTCUSDT",
"orderId": 21,
"clientOrderId": "461cPg51vQjV3zIMOXNz39"
}
],
"orderReports": [
{
"symbol": "BTCUSDT",
"origClientOrderId": "CwOOIPHSmYywx6jZX77TdL",
"orderId": 20,
"orderListId": 1929,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"price": "0.668611",
"origQty": "0.690354",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "STOP_LOSS_LIMIT",
"side": "BUY",
"stopPrice": "0.378131",
"icebergQty": "0.017083"
},
{
"symbol": "BTCUSDT",
"origClientOrderId": "461cPg51vQjV3zIMOXNz39",
"orderId": 21,
"orderListId": 1929,
"clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
"price": "0.008791",
"origQty": "0.690354",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "BUY",
"icebergQty": "0.639962"
}
]
}
]
DELETE /sapi/v1/margin/openOrders
杠杆账户撤销单一交易对下所有挂单, 包括OCO的挂单。
权重(IP):
1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
调整全仓最大杠杆 (USER_DATA)
响应:
{
"success": true
}
POST /sapi/v1/margin/max-leverage
调整全仓最大杠杆倍数
权重(UID):
3000
访问限制:
1次/分钟/UID
参数:
名称
类型
是否必需
描述
maxLeverage
Integer
YES
只能调整3, 5 或者10,举例: maxLeverage=10 就是选择切换成全仓 Pro 模式，maxLeverage = 5 或者3是选择全仓Classic模式
当前的风险率需要大于调整后的初始风险率，3x的初始风险率是1.5，5x的初始风险率是1.25，10x 的初始风险率是2.5
获取全仓杠杆划转历史 (USER_DATA)
响应
{
"rows": [
{
"amount": "0.10000000",
"asset": "BNB",
"status": "CONFIRMED",
"timestamp": 1566898617,
"txId": 5240372201,
"type": "ROLL_IN",
"transFrom": "SPOT",//SPOT,FUTURES,FIAT,DELIVERY,MINING,ISOLATED_MARGIN,FUNDING,MOTHER_SPOT,OPTION,SUB_SPOT,SUB_MARGIN,CROSS_MARGIN
"transTo": "ISOLATED_MARGIN",//SPOT,FUTURES,FIAT,DELIVERY,MINING,ISOLATED_MARGIN,FUNDING,MOTHER_SPOT,OPTION,SUB_SPOT,SUB_MARGIN,CROSS_MARGIN
},
{
"amount": "5.00000000",
"asset": "USDT",
"status": "CONFIRMED",
"timestamp": 1566888436,
"txId": 5239810406,
"type": "ROLL_OUT",
"transFrom": "ISOLATED_MARGIN",//SPOT,FUTURES,FIAT,DELIVERY,MINING,ISOLATED_MARGIN,FUNDING,MOTHER_SPOT,OPTION,SUB_SPOT,SUB_MARGIN,CROSS_MARGIN
"transTo": "ISOLATED_MARGIN",//SPOT,FUTURES,FIAT,DELIVERY,MINING,ISOLATED_MARGIN,FUNDING,MOTHER_SPOT,OPTION,SUB_SPOT,SUB_MARGIN,CROSS_MARGIN
"fromSymbol": "BNBUSDT",
"toSymbol": "BTCUSDT"
},
{
"amount": "1.00000000",
"asset": "EOS",
"status": "CONFIRMED",
"timestamp": 1566888403,
"txId": 5239808703,
"type": "ROLL_IN"
}
],
"total": 3
}
GET /sapi/v1/margin/transfer
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
NO
type
STRING
NO
划转类型: ROLL_IN, ROLL_OUT
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 从 1开始。 默认:1
size
LONG
NO
默认:10 最大:100
isolatedSymbol
STRING
NO
逐仓交易对，适用于逐仓查询
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
响应返回为降序排列。
查询时间范围最大不得超过30天。
若startTime和endTime没传，则默认返回最近7天数据
获取利息历史 (USER_DATA)
响应
{
"rows": [
{
"txId": 1352286576452864727,
"interestAccuredTime": 1672160400000,
"asset": "USDT",
"rawAsset": “USDT”, // 逐仓不会返回此字段
"principal": "45.3313",
"interest": "0.00024995",
"interestRate": "0.00013233",
"type": "ON_BORROW",
"isolatedSymbol": "BNBUSDT" // 返回逐仓symbol; 若是全仓不会返回此字段
}
],
"total": 1
}
GET /sapi/v1/margin/interestHistory
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
NO
isolatedSymbol
STRING
NO
逐仓symbol
startTime
LONG
NO
精确到秒，忽略毫秒的数值
如XXXXXXXXXX000ms
endTime
LONG
NO
精确到秒，忽略毫秒的数值
如XXXXXXXXXX000ms
current
LONG
NO
当前查询页。 开始值 1. 默认:1
size
LONG
NO
默认:10 最大:100
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
响应返回为降序排列。
如果发送isolatedSymbol，返回指定逐仓symbol的记录。
查询时间范围最大不得超过30天。
若startTime和endTime没传，则默认返回最近7天数据
如果想查询6个月以前数据，设置 archived 为 true。
返回的type数据有4种类型:
PERIODIC 每小时收的利息
ON_BORROW 借款的时候第一次收的利息
PERIODIC_CONVERTED 每小时收的利息，用BNB抵扣
ON_BORROW_CONVERTED 借款的时候第一次收的利息，用BNB抵扣
PORTFOLIO 统一账户负余额每日利息
获取账户强制平仓记录(USER_DATA)
响应
{
"rows": [
{
"avgPrice": "0.00388359",
"executedQty": "31.39000000",
"orderId": 180015097,
"price": "0.00388110",
"qty": "31.39000000",
"side": "SELL",
"symbol": "BNBBTC",
"timeInForce": "GTC",
"isIsolated": ture, // 是否是逐仓
"updatedTime": 1558941374745
}
],
"total": 1
}
GET /sapi/v1/margin/forceLiquidationRec
权重(IP):
1
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
isolatedSymbol
STRING
NO
current
LONG
NO
当前查询页。 开始值 1. 默认:1
size
LONG
NO
默认:10 最大:100
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
响应返回为降序排列。
查询全仓杠杆账户详情 (USER_DATA)
响应
{
"borrowEnabled": true,
"marginLevel": "11.64405625",
"CollateralMarginLevel" : "3.2",
"totalAssetOfBtc": "6.82728457",
"totalLiabilityOfBtc": "0.58633215",
"totalNetAssetOfBtc": "6.24095242",
"TotalCollateralValueInUSDT": "5.82728457",
"tradeEnabled": true,
"transferEnabled": true,
"accountType": "Margin_1", // Margin_1 全仓Classic模式账户, Margin_2 全仓Pro模式账户
"userAssets": [
{
"asset": "BTC",
"borrowed": "0.00000000",
"free": "0.00499500",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00499500"
},
{
"asset": "BNB",
"borrowed": "201.66666672",
"free": "2346.50000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "2144.83333328"
},
{
"asset": "ETH",
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000"
},
{
"asset": "USDT",
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000"
}
]
}
GET /sapi/v1/margin/account
权重(IP):
10
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
查询杠杆账户订单 (USER_DATA)
响应
{
"clientOrderId": "ZwfQzuDIGpceVhKW5DvCmO",
"cummulativeQuoteQty": "0.00000000",
"executedQty": "0.00000000",
"icebergQty": "0.00000000",
"isWorking": true,
"orderId": 213205622,
"origQty": "0.30000000",
"price": "0.00493630",
"side": "SELL",
"status": "NEW",
"stopPrice": "0.00000000",
"symbol": "BNBBTC",
"isIsolated": true, // 是否是逐仓symbol交易
"time": 1562133008725,
"timeInForce": "GTC",
"type": "LIMIT",
"selfTradePreventionMode": "NONE",
"updateTime": 1562133008725
}
GET /sapi/v1/margin/order
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
orderId
LONG
NO
origClientOrderId
STRING
NO
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
必须发送 orderId 或 origClientOrderId 其中一个。
一些历史订单的 cummulativeQuoteQty < 0, 是指当前数据不存在。
查询杠杆账户挂单记录 (USER_DATA)
响应
[
{
"clientOrderId": "qhcZw71gAkCCTv0t0k8LUK",
"cummulativeQuoteQty": "0.00000000",
"executedQty": "0.00000000",
"icebergQty": "0.00000000",
"isWorking": true,
"orderId": 211842552,
"origQty": "0.30000000",
"price": "0.00475010",
"side": "SELL",
"status": "NEW",
"stopPrice": "0.00000000",
"symbol": "BNBBTC",
"isIsolated": true, // 是否是逐仓symbol交易
"time": 1562040170089,
"timeInForce": "GTC",
"type": "LIMIT",
"selfTradePreventionMode": "NONE",
"updateTime": 1562040170089
}
]
GET /sapi/v1/margin/openOrders
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
如未发送symbol，返回所有 symbols 订单记录。
当返回所有symbols时，针对限速器计数的请求数量等于当前在交易所交易的symbols数量。
如果 isIsolated = "TRUE", symbol 为必填
查询杠杆账户的所有订单 (USER_DATA)
响应
[
{
"clientOrderId": "D2KDy4DIeS56PvkM13f8cP",
"cummulativeQuoteQty": "0.00000000",
"executedQty": "0.00000000",
"icebergQty": "0.00000000",
"isWorking": false,
"orderId": 41295,
"origQty": "5.31000000",
"price": "0.22500000",
"side": "SELL",
"status": "CANCELED",
"stopPrice": "0.18000000",
"symbol": "BNBBTC",
"isIsolated": false, // 是否是逐仓symbol交易
"time": 1565769338806,
"timeInForce": "GTC",
"type": "TAKE_PROFIT_LIMIT",
"selfTradePreventionMode": "NONE",
"updateTime": 1565769342148
},
{
"clientOrderId": "gXYtqhcEAs2Rn9SUD9nRKx",
"cummulativeQuoteQty": "0.00000000",
"executedQty": "0.00000000",
"icebergQty": "1.00000000",
"isWorking": true,
"orderId": 41296,
"origQty": "6.65000000",
"price": "0.18000000",
"side": "SELL",
"status": "CANCELED",
"stopPrice": "0.00000000",
"symbol": "BNBBTC",
"isIsolated": false, // 是否是逐仓symbol交易
"time": 1565769348687,
"timeInForce": "GTC",
"type": "LIMIT",
"selfTradePreventionMode": "NONE",
"updateTime": 1565769352226
}
]
GET /sapi/v1/margin/allOrders
权重(IP):
200
访问限制
60次/分钟/IP
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
orderId
LONG
NO
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 500;最大500.
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
如果设置 orderId , 获取订单 >= orderId， 否则返回近期订单历史。
一些历史订单的 cummulativeQuoteQty < 0, 是指当前数据不存在。
杠杆账户 OCO 下单(TRADE)
响应
{
"orderListId": 0,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "JYVpp3F0f5CAG15DhtrqLp",
"transactionTime": 1563417480525,
"symbol": "LTCBTC",
"marginBuyBorrowAmount": "5", // 下单后没有发生借款则不返回该字段
"marginBuyBorrowAsset": "BTC", // 下单后没有发生借款则不返回该字段
"isIsolated": false, // 是否是逐仓symbol交易
"orders": [
{
"symbol": "LTCBTC",
"orderId": 2,
"clientOrderId": "Kk7sqHb9J6mJWTMDVW7Vos"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"clientOrderId": "xTXKaGYd4bluPVp78IVRvl"
}
],
"orderReports": [
{
"symbol": "LTCBTC",
"orderId": 2,
"orderListId": 0,
"clientOrderId": "Kk7sqHb9J6mJWTMDVW7Vos",
"transactTime": 1563417480525,
"price": "0.000000",
"origQty": "0.624363",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "NEW",
"timeInForce": "GTC",
"type": "STOP_LOSS",
"side": "BUY",
"stopPrice": "0.960664",
"selfTradePreventionMode": "NONE"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"orderListId": 0,
"clientOrderId": "xTXKaGYd4bluPVp78IVRvl",
"transactTime": 1563417480525,
"price": "0.036435",
"origQty": "0.624363",
"executedQty": "0.000000",
"cummulativeQuoteQty": "0.000000",
"status": "NEW",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "BUY",
"selfTradePreventionMode": "NONE"
}
]
}
POST /sapi/v1/margin/order/oco
杠杆账户发送新 OCO 订单。
权重(UID): 6
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
listClientOrderId
STRING
NO
整个orderList的唯一ID
side
ENUM
YES
详见枚举定义：订单方向
quantity
DECIMAL
YES
limitClientOrderId
STRING
NO
限价单的唯一ID
price
DECIMAL
YES
limitIcebergQty
DECIMAL
NO
stopClientOrderId
STRING
NO
止损/止损限价单的唯一ID
stopPrice
DECIMAL
YES
stopLimitPrice
DECIMAL
NO
如果提供，须配合提交stopLimitTimeInForce
stopIcebergQty
DECIMAL
NO
stopLimitTimeInForce
ENUM
NO
有效值 GTC/FOK/IOC
newOrderRespType
ENUM
NO
详见枚举定义：订单返回类型
sideEffectType
ENUM
NO
NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY,AUTO_BORROW_REPAY; 默认为 NO_SIDE_EFFECT;详见FAQ
selfTradePreventionMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有 EXPIRE_TAKER，EXPIRE_MAKER，EXPIRE_BOTH，NONE
autoRepayAtCancel
BOOLEAN
NO
只有在自动借款单或者自动借还单生效，true表示的是撤单后需要把订单产生的借款归还，默认为true
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
其他信息:
价格限制:
SELL: 限价 > 最新成交价 >触发价
BUY: 限价 < 最新成交价 < 触发价
数量限制:
两个 legs 必须具有同样的数量。
ICEBERG数量不必相同
下单rate
一个OCO订单被算成2个普通订单.
取消杠杆账户 OCO 订单(TRADE)
Response:
{
"orderListId": 0,
"contingencyType": "OCO",
"listStatusType": "ALL_DONE",
"listOrderStatus": "ALL_DONE",
"listClientOrderId": "C3wyj4WVEktd7u9aVBRXcN",
"transactionTime": 1574040868128,
"symbol": "LTCBTC",
"isIsolated": false, // 是否是逐仓symbol交易
"orders": [
{
"symbol": "LTCBTC",
"orderId": 2,
"clientOrderId": "pO9ufTiFGg3nw2fOdgeOXa"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"clientOrderId": "TXOvglzXuaubXAaENpaRCB"
}
],
"orderReports": [
{
"symbol": "LTCBTC",
"origClientOrderId": "pO9ufTiFGg3nw2fOdgeOXa",
"orderId": 2,
"orderListId": 0,
"clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
"price": "1.00000000",
"origQty": "10.00000000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "STOP_LOSS_LIMIT",
"side": "SELL",
"stopPrice": "1.00000000",
"selfTradePreventionMode": "NONE"
},
{
"symbol": "LTCBTC",
"origClientOrderId": "TXOvglzXuaubXAaENpaRCB",
"orderId": 3,
"orderListId": 0,
"clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
"price": "3.00000000",
"origQty": "10.00000000",
"executedQty": "0.00000000",
"cummulativeQuoteQty": "0.00000000",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT_MAKER",
"side": "SELL",
"selfTradePreventionMode": "NONE"
}
]
}
DELETE /sapi/v1/margin/orderList
取消杠杆账户订单列表。
权重(UID): 1
参数
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
orderListId
LONG
NO
orderListId 或 listClientOrderId 必须被提供
listClientOrderId
STRING
NO
orderListId 或 listClientOrderId 必须被提供
newClientOrderId
STRING
NO
用户自定义的本次撤销操作的ID(注意不是被撤销的订单的自定义ID)。如无指定会自动赋值。
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
其他注意点:
取消单个 leg 将取消整个 OCO 订单。
查询杠杆账户 OCO (USER_DATA)
响应
{
"orderListId": 27,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "h2USkA5YQpaXHPIrkd96xE",
"transactionTime": 1565245656253,
"symbol": "LTCBTC",
"isIsolated": true, // 是否是逐仓symbol交易
"orders": [
{
"symbol": "LTCBTC",
"orderId": 4,
"clientOrderId": "qD1gy3kc3Gx0rihm9Y3xwS"
},
{
"symbol": "LTCBTC",
"orderId": 5,
"clientOrderId": "ARzZ9I00CPM8i3NhmU9Ega"
}
]
}
GET /sapi/v1/margin/orderList
根据提供的可选参数检索特定的杠杆账户 OCO 订单。
权重(IP): 10
参数:
名称
类型
是否必需
描述
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
symbol
STRING
NO
逐仓杠杆必填，全仓杠杆不支持该参数
orderListId
LONG
NO
orderListId 或 origClientOrderId 必须提供一个。
origClientOrderId
STRING
NO
orderListId 或 origClientOrderId 必须提供一个。
recvWindow
LONG
NO
赋值不得大于 60000
timestamp
LONG
YES
查询特定杠杆账户所有 OCO (USER_DATA)
响应
[
{
"orderListId": 29,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "amEEAXryFzFwYF1FeRpUoZ",
"transactionTime": 1565245913483,
"symbol": "LTCBTC",
"isIsolated": true, // 是否是逐仓symbol交易
"orders": [
{
"symbol": "LTCBTC",
"orderId": 4,
"clientOrderId": "oD7aesZqjEGlZrbtRpy5zB"
},
{
"symbol": "LTCBTC",
"orderId": 5,
"clientOrderId": "Jr1h6xirOxgeJOUuYQS7V3"
}
]
},
{
"orderListId": 28,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "hG7hFNxJV6cZy3Ze4AUT4d",
"transactionTime": 1565245913407,
"symbol": "LTCBTC",
"orders": [
{
"symbol": "LTCBTC",
"orderId": 2,
"clientOrderId": "j6lFOfbmFMRjTYA7rRJ0LP"
},
{
"symbol": "LTCBTC",
"orderId": 3,
"clientOrderId": "z0KCjOdditiLS5ekAFtK81"
}
]
}
]
GET /sapi/v1/margin/allOrderList
根据提供的可选参数检索特定杠杆账户所有的 OCO 订单。
权重(IP): 200
参数
名称
类型
是否必需
描述
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
symbol
STRING
NO
逐仓杠杆必填，全仓杠杆不支持该参数
fromId
LONG
NO
提供该项后, startTime 和 endTime 都不可提供
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认值: 500; 最大值: 1000
recvWindow
LONG
NO
赋值不能超过 60000
timestamp
LONG
YES
查询杠杆账户 OCO 挂单 (USER_DATA)
响应
[
{
"orderListId": 31,
"contingencyType": "OCO",
"listStatusType": "EXEC_STARTED",
"listOrderStatus": "EXECUTING",
"listClientOrderId": "wuB13fmulKj3YjdqWEcsnp",
"transactionTime": 1565246080644,
"symbol": "LTCBTC",
"isIsolated": true, // 是否是逐仓symbol交易
"orders": [
{
"symbol": "LTCBTC",
"orderId": 4,
"clientOrderId": "r3EH2N76dHfLoSZWIUw1bT"
},
{
"symbol": "LTCBTC",
"orderId": 5,
"clientOrderId": "Cv1SnyPD3qhqpbjpYEHbd2"
}
]
}
]
GET /sapi/v1/margin/openOrderList
权重(IP): 10
参数
名称
类型
是否必需
描述
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
symbol
STRING
NO
逐仓杠杆必填，全仓杠杆不支持该参数
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
查询杠杆账户交易历史 (USER_DATA)
响应
[
{
"commission": "0.00006000",
"commissionAsset": "BTC",
"id": 34,
"isBestMatch": true,
"isBuyer": false,
"isMaker": false,
"orderId": 39324,
"price": "0.02000000",
"qty": "3.00000000",
"symbol": "BNBBTC",
"isIsolated": false, // 是否是逐仓symbol交易
"time": 1561973357171
},
{
"commission": "0.00002950",
"commissionAsset": "BTC",
"id": 32,
"isBestMatch": true,
"isBuyer": false,
"isMaker": true,
"orderId": 39319,
"price": "0.00590000",
"qty": "5.00000000",
"symbol": "BNBBTC",
"isIsolated": false, // 是否是逐仓symbol交易
"time": 1561964645345
}
]
GET /sapi/v1/margin/myTrades
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
orderId
LONG
NO
startTime
LONG
NO
endTime
LONG
NO
fromId
LONG
NO
获取TradeId，默认获取近期交易历史。
limit
INT
NO
默认 500; 最大 1000.
recvWindow
LONG
NO
默认值不能大于 60000
timestamp
LONG
YES
如果设置 fromId , 获取订单 id >= fromId， 否则返回近期订单历史。
查询账户最大可借贷额度(USER_DATA)
响应
{
"amount": "1.69248805", // 系统可借充足情况下用户账户当前最大可借额度
"borrowLimit": "60" // 平台限制的用户当前等级可以借的额度
}
GET /sapi/v1/margin/maxBorrowable
权重(IP):
50
参数:
名称
类型
是否必需
描述
asset
STRING
YES
isolatedSymbol
STRING
NO
逐仓交易对，适用于逐仓查询
recvWindow
LONG
NO
默认值不能大于 60000
timestamp
LONG
YES
borrowLimit 的值也可以查看 https://www.binance.com/cn/margin-fee
查询最大可转出额 (USER_DATA)
响应
{
"amount": "3.59498107"
}
GET /sapi/v1/margin/maxTransferable
权重(IP):
50
参数:
名称
类型
是否必需
描述
asset
STRING
YES
isolatedSymbol
STRING
NO
逐仓交易对，适用于逐仓查询
recvWindow
LONG
NO
默认值不能大于 60000
timestamp
LONG
YES
查询Margin账户信息汇总 (USER_DATA)
响应：
{
"normalBar": "1.5",
"marginCallBar": "1.3",
"forceLiquidationBar": "1.1"
}
GET /sapi/v1/margin/tradeCoeff
获取用户个人杠杆账户信息汇总
权重（IP）：
10
参数：
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询杠杆逐仓账户信息 (USER_DATA)
响应:
不传"symbols"的返回内容
{
"assets":[
{
"baseAsset":
{
"asset": "BTC",
"borrowEnabled": true,
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000",
"netAssetOfBtc": "0.00000000",
"repayEnabled": true,
"totalAsset": "0.00000000"
},
"quoteAsset":
{
"asset": "USDT",
"borrowEnabled": true,
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000",
"netAssetOfBtc": "0.00000000",
"repayEnabled": true,
"totalAsset": "0.00000000"
},
"symbol": "BTCUSDT"
"isolatedCreated": true,
"enabled": true, // 账户是否启用，true-启用，false-停用
"marginLevel": "0.00000000",
"marginLevelStatus": "EXCESSIVE", // "EXCESSIVE", "NORMAL", "MARGIN_CALL", "PRE_LIQUIDATION", "FORCE_LIQUIDATION"
"marginRatio": "0.00000000",
"indexPrice": "10000.00000000",
"liquidatePrice": "1000.00000000",
"liquidateRate": "1.00000000",
"tradeEnabled": true
}
],
"totalAssetOfBtc": "0.00000000",
"totalLiabilityOfBtc": "0.00000000",
"totalNetAssetOfBtc": "0.00000000"
}
传"symbols"的返回内容
{
"assets":[
{
"baseAsset":
{
"asset": "BTC",
"borrowEnabled": true,
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000",
"netAssetOfBtc": "0.00000000",
"repayEnabled": true,
"totalAsset": "0.00000000"
},
"quoteAsset":
{
"asset": "USDT",
"borrowEnabled": true,
"borrowed": "0.00000000",
"free": "0.00000000",
"interest": "0.00000000",
"locked": "0.00000000",
"netAsset": "0.00000000",
"netAssetOfBtc": "0.00000000",
"repayEnabled": true,
"totalAsset": "0.00000000"
},
"symbol": "BTCUSDT"
"isolatedCreated": true,
"enabled": true, // 账户是否启用，true-启用，false-停用
"marginLevel": "0.00000000",
"marginLevelStatus": "EXCESSIVE", // "EXCESSIVE", "NORMAL", "MARGIN_CALL", "PRE_LIQUIDATION", "FORCE_LIQUIDATION"
"marginRatio": "0.00000000",
"indexPrice": "10000.00000000",
"liquidatePrice": "1000.00000000",
"liquidateRate": "1.00000000",
"tradeEnabled": true
}
]
}
GET /sapi/v1/margin/isolated/account
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbols
STRING
NO
最多可以传5个symbol; 由","分隔的字符串表示. e.g. "BTCUSDT,BNBUSDT,ADAUSDT"
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
不传"symbols",返回所有杠杆逐仓资产
传"symbols", 将只会返回指定symbol的杠杆逐仓资产
杠杆逐仓账户停用 (TRADE)
响应
{
"success": true,
"symbol": "BTCUSDT"
}
DELETE /sapi/v1/margin/isolated/account
停用特定交易对的杠杆逐仓账户。每个交易对 24 小时内仅可停用一次。
权重(UID):
300
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
杠杆逐仓账户启用 (TRADE)
响应
{
"success": true,
"symbol": "BTCUSDT"
}
POST /sapi/v1/margin/isolated/account
启用特定交易对的杠杆逐仓账户（仅支持启用之前停用的账户）。
权重(UID):
300
参数
名称
类型
是否必需
描述
symbol
STRING
YES
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
查询杠杆逐仓账户启用限制 (USER_DATA)
响应
{
"enabledAccount": 5,
"maxAccount": 20
}
GET /sapi/v1/margin/isolated/accountLimit
查询杠杆逐仓账户启用限制。
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
获取所有逐仓杠杆交易对(USER_DATA)
响应:
[
{
"base": "BNB",
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "BNBBTC"
},
{
"base": "TRX",
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "TRXBTC",
"delistTime": 1704973040
},
{
"base": "XRP",
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "XRPBTC"
},
{
"base": "ETH",
"isBuyAllowed": true,
"isMarginTrade": true,
"isSellAllowed": true,
"quote": "BTC",
"symbol": "ETHBTC"
}
]
GET /sapi/v1/margin/isolated/allPairs
权重(IP):
10
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
现货交易和杠杆利息BNB抵扣开关(USER_DATA)
响应:
{
"spotBNBBurn":true,
"interestBNBBurn": false
}
POST /sapi/v1/bnbBurn
权重(IP):
1
参数:
名称
类型
是否必需
描述
spotBNBBurn
STRING
NO
"true" 或 "false", 是否使用BNB支付现货交易的手续费
interestBNBBurn
STRING
NO
"true" 或 "false", 是否使用BNB支付杠杆贷款的利息
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
"spotBNBBurn" 和 "interestBNBBurn" 二者必须传至少一个
获取BNB抵扣开关状态 (USER_DATA)
响应:
{
"spotBNBBurn":true,
"interestBNBBurn": false
}
GET /sapi/v1/bnbBurn
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
获取杠杆利率历史 (USER_DATA)
响应:
[
{
"asset": "BTC",
"dailyInterestRate": "0.00025000",
"timestamp": 1611544731000,
"vipLevel": 1
},
{
"asset": "BTC",
"dailyInterestRate": "0.00035000",
"timestamp": 1610248118000,
"vipLevel": 1
}
]
GET /sapi/v1/margin/interestRateHistory
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
YES
vipLevel
INT
NO
默认用户当前等级
startTime
LONG
NO
默认7天前
endTime
LONG
NO
默认当天，时间间隔最大为1个月
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
获取全仓杠杆利率及限额 (USER_DATA)
响应:
[
{
"vipLevel": 0,
"coin": "BTC",
"transferIn": true,
"borrowable": true,
"dailyInterest": "0.00026125",
"yearlyInterest": "0.0953",
"borrowLimit": "180",
"marginablePairs": [
"BNBBTC",
"TRXBTC",
"ETHBTC",
"BTCUSDT"
]
}
]
GET /sapi/v1/margin/crossMarginData
通过VIP等级或用户当前VIP等级获取全仓杠杆利率及限额， 如：https://www.binance.com/en/margin-fee
权重:
1 指定币种;
5 币种参数缺失
参数(IP):
名称
类型
是否必须
描述
vipLevel
INT
NO
当未发送参数vipLevel时，将返回用户当前vip等级的数据；当发送参数vipLevel时，将返回对应vip等级的数据
coin
STRING
NO
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
获取逐仓杠杆利率及限额 (USER_DATA)
响应:
[
{
"vipLevel": 0,
"symbol": "BTCUSDT",
"leverage": "10",
"data": [
{
"coin": "BTC",
"dailyInterest": "0.00026125",
"borrowLimit": "270"
},
{
"coin": "USDT",
"dailyInterest": "0.000475",
"borrowLimit": "2100000"
}
]
}
]
GET /sapi/v1/margin/isolatedMarginData
通过VIP等级或用户当前VIP等级获取逐仓杠杆利率及限额， 如： https://www.binance.com/en/margin-fee
权重(IP):
1 指定交易对;
10 交易对参数缺失
参数:
名称
类型
是否必须
描述
vipLevel
INT
NO
默认为用户当前VIP等级
symbol
STRING
NO
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
获取逐仓档位信息 (USER_DATA)
响应:
[
{
"symbol": "BTCUSDT",
"tier": 1,
"effectiveMultiple": "10",
"initialRiskRatio": "1.111",
"liquidationRiskRatio": "1.05",
"baseAssetMaxBorrowable": "9",
"quoteAssetMaxBorrowable": "70000"
}
]
GET /sapi/v1/margin/isolatedMarginTier
通过档位获取逐仓杠杆档位数据， 如： https://www.binance.com/en/margin-data
权重(IP):
1
参数:
名称
类型
是否必须
描述
symbol
STRING
YES
tier
INTEGER
NO
不传则返回所有逐仓杠杆档位
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
查询目前杠杆账户下单数 (TRADE)
响应:
[
{
"rateLimitType": "ORDERS",
"interval": "SECOND",
"intervalNum": 10,
"limit": 10000,
"count": 0
},
{
"rateLimitType": "ORDERS",
"interval": "DAY",
"intervalNum": 1,
"limit": 20000,
"count": 0
}
]
GET /sapi/v1/margin/rateLimit/order
获取用户在当前时间区间内的杠杆账户下单总数。
权重(IP):
20
参数:
名称
类型
是否必需
描述
isIsolated
STRING
NO
是否逐仓杠杆，"TRUE", "FALSE", 默认 "FALSE"
symbol
STRING
NO
逐仓交易对，查询逐仓杠杆账户必需
recvWindow
LONG
NO
赋值不能大于 60000
timestamp
LONG
YES
全仓币种质押率 (MARKET_DATA)
响应:
[
{
"collaterals": [
{
"minUsdValue": "0",
"maxUsdValue": "13000000",
"discountRate": "1"
},
{
"minUsdValue": "13000000",
"maxUsdValue": "20000000",
"discountRate": "0.975"
},
{
"minUsdValue": "20000000",
"discountRate": "0"
}
],
"assetNames": [
"BNX"
]
},
{
"collaterals": [
{
"minUsdValue": "0",
"discountRate": "1"
}
],
"assetNames": [
"BTC",
"BUSD",
"ETH",
"USDT"
]
}
]
GET /sapi/v1/margin/crossMarginCollateralRatio
权重(IP):
100
参数:
None
查询可小额负债转换的资产 (USER_DATA)
查询可小额负债转换的币种
响应:
[
{
"asset": "ETH",
"interest": "0.00083334",
"principal": "0.001",
"liabilityAsset": "USDT",
"liabilityQty": 0.3552
}
]
GET /sapi/v1/margin/exchange-small-liability
权重(IP):
100
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
全仓杠杆小额负债转换 (MARGIN)
全仓杠杆小额负债转换
POST /sapi/v1/margin/exchange-small-liability
权重(UID):
3000
参数:
名称
类型
是否必需
描述
assetNames
ARRAY
YES
小额转换的资产列表，举例: assetNames = BTC,ETH
recvWindow
LONG
NO
timestamp
LONG
YES
兑换请求限流6小时一次
币种负债小于10USDT
币种数量最大10个
查询全仓杠杆小额负债转换历史 (USER_DATA)
查询全仓杠杆小额负债转换历史
响应:
{
"total": 1,
"rows": [
{
"asset": "ETH",
"amount": "0.00083434",
"targetAsset": "BUSD",
"targetAmount": "1.37576819",
"bizType": "EXCHANGE_SMALL_LIABILITY",
"timestamp": 1672801339253
}
]
}
GET /sapi/v1/margin/exchange-small-liability-history
权重(UID):
100
参数:
名称
类型
是否必需
描述
current
INT
YES
当前页面，默认1，最小值为1
size
INT
YES
页面大小，默认10，最大值为100
startTime
LONG
NO
默认当前时间30天前的时间戳
endTime
LONG
NO
默认当前时间戳
recvWindow
LONG
NO
timestamp
LONG
YES
查询下小时预估利率 (USER_DATA)
GET /sapi/v1/margin/next-hourly-interest-rate
查询用户币种下小时预估利率
响应:
[
{
"asset": "BTC",
"nextHourlyInterestRate": "0.00000571"
},
{
"asset": "ETH",
"nextHourlyInterestRate": "0.00000578"
}
]
权重(IP):
100
参数:
名称
类型
是否必需
描述
assets
String
YES
资产列表，以逗号分隔，最多20个
isIsolated
Boolean
YES
是否逐仓杠杆，"TRUE", "FALSE"
查询全仓/逐仓资金流水(USER_DATA)
GET /sapi/v1/margin/capital-flow
查询全仓/逐仓资金流水
响应:
[
{
"id": 123456,
"tranId": 123123,
"timestamp": 1691116657000,
"asset": "USDT,
"symbol": "BTCUSDT",
"type": "BORROW",
"amount": "101"
},
{
"id": 123457,
"tranId": 123124,
"timestamp": 1691116658000,
"asset": "BTC",
"symbol": "BTCUSDT",
"type": "REPAY",
"amount": "10"
}
]
权重(IP):
100
参数:
名称
类型
是否必需
描述
asset
STRING
NO
symbol
STRING
NO
查询逐仓数据时必填
type
STRING
NO
startTime
LONG
NO
只支持查询最近90天的数据
endTime
LONG
NO
fromId
LONG
NO
如设置fromId, 将返回id > fromId的数据。否则将返回最新数据
limit
LONG
NO
每次返回的数据条数限制。默认 500; 最大 1000.
recvWindow
LONG
NO
timestamp
LONG
YES
只支持查询最近90天的数据
如设置fromId, 将返回id > fromId的数据。否则将返回最新订单。
查询逐仓数据，需要输入symbol
支持的type:
TRANSFER("Transfer", "转账")
BORROW("Borrow", "借款")
REPAY("Repay", "还款")
BUY_INCOME("Buy-Trading Income", "买单-交易收入")
BUY_EXPENSE("Buy-Trading Expense", "买单-交易支出")
SELL_INCOME("Sell-Trading Income", "卖单-交易收入")
SELL_EXPENSE("Sell-Trading Expense", "卖单-交易支出")
TRADING_COMMISSION("Trading Commission", "交易手续费")
BUY_LIQUIDATION("Buy by Liquidation", "强平买入")
SELL_LIQUIDATION("Sell by Liquidation", "强平卖出")
REPAY_LIQUIDATION("Repay by Liquidation", "强平还款")
OTHER_LIQUIDATION("Other Liquidation", "其他强平")
LIQUIDATION_FEE("Liquidation Fee", "强平清算费用")
SMALL_BALANCE_CONVERT("Small Balance Convert", "小额兑换")
COMMISSION_RETURN("Commission Return", "手续费返还")
SMALL_CONVERT("Small Convert", "强平小额转换")
查询全仓和逐仓的币种或币对的下架计划 (MARKET_DATA)
GET /sapi/v1/margin/delist-schedule
查询全仓和逐仓的币种或币对的下架计划
响应:
[
{
"delistTime": 1686161202000,
"crossMarginAssets": [
"BTC",
"USDT"
],
"isolatedMarginSymbols": [
"ADAUSDT",
"BNBUSDT"
]
},
{
"delistTime": 1686222232000,
"crossMarginAssets": [
"ADA"
],
"isolatedMarginSymbols": []
}
]
权重(IP):
100
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
杠杆可用放贷库存查询(USER_DATA)
GET /sapi/v1/margin/available-inventory
杠杆可用放贷库存查询
响应:
{
"assets": {
"MATIC": "100000000",
"STPT": "100000000",
"TVK": "100000000",
"SHIB": "97409653"
},
"updateTime": 1699272487
}
权重(UID):
50
参数:
名称
类型
是否必需
描述
type
STRING
YES
MARGIN,ISOLATED
recvWindow
LONG
NO
timestamp
LONG
YES
杠杆手动强平(MARGIN)
POST /sapi/v1/margin/manual-liquidation
杠杆手动强平
响应:
[
{
"asset": "ETH",
"interest": "0.00083334",
"principal": "0.001",
"liabilityAsset": "USDT",
"liabilityQty": 0.3552
}
]
权重(UID):
3000
参数:
名称
类型
是否必需
描述
type
STRING
YES
MARGIN,ISOLATED
symbol
STRING
NO
type选择ISOLATED后，symbol需要填入
recvWindow
LONG
NO
timestamp
LONG
YES
只有被限制交易的用户可以使用
查询全仓杠杆Pro模式下的负债币种杠杆与保证金率(MARKET_DATA)
GET /sapi/v1/margin/leverageBracket
查询全仓杠杆Pro模式下的负债币种杠杆与保证金率
响应:
[
{
"assetNames":[
"SHIB",
"FDUSD",
"BTC",
"ETH",
"USDC"
],
"rank":1,
"brackets":[
{
"leverage":10,
"maxDebt":1000000.00000000,
"maintenanceMarginRate":0.02000000,
"initialMarginRate":0.1112,
"fastNum":0
},
{
"leverage":3,
"maxDebt":4000000.00000000,
"maintenanceMarginRate":0.07000000,
"initialMarginRate":0.5000,
"fastNum":60000.0000000000000000
}
]
}
]
权重(IP):
1
Websocket账户信息推送
本篇所列出 API 接口的 base URL : https://api.binance.com
用于订阅账户数据的 listenKey 从创建时刻起有效期为60分钟。
可以通过 PUT 一个 listenKey 延长60分钟有效期。
可以通过 DELETE 一个 listenKey 立即关闭当前数据流，并使该 listenKey 无效。
在具有有效 listenKey 的帐户上执行POST将返回当前有效的 listenKey 并将其有效期延长60分钟。
一个listenKey就是一个数据流。
用户可以侦听/订阅数个数据流。
websocket 接口的 base URL: wss://stream.binance.com:9443
U订阅账户数据流的 stream 名称为 /ws/
每个链接有效期不超过24小时，请妥善处理断线重连。
账户数据流的消息不保证严格时间序; 请使用 E 字段进行排序
Listen Key(现货账户)生成 Listen Key (USER_STREAM)
响应
{
"listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1"
}
POST /api/v3/userDataStream
开始一个新的数据流。除非发送 keepalive，否则数据流于60分钟后关闭。如果该帐户具有有效的listenKey，则将返回该listenKey并将其有效期延长60分钟。
权重:
2
参数:
NONE
数据源:
缓存
延长 Listen Key 有效期 (USER_STREAM)
响应
{}
PUT /api/v3/userDataStream
有效期延长至本次调用后60分钟,建议每30分钟发送一个 ping 。
权重:
2
参数:
名称
类型
是否必需
描述
listenKey
STRING
YES
数据源:
缓存
关闭 Listen Key (USER_STREAM)
响应
{}
DELETE /api/v3/userDataStream
关闭用户数据流。
权重:
2
参数:
名称
类型
是否必需
描述
listenKey
STRING
YES
数据源:
缓存
Listen Key(杠杆账户)生成 Listen Key (USER_STREAM)
响应
{"listenKey": "T3ee22BIYuWqmvne0HNq2A2WsFlEtLhvWCtItw6ffhhdmjifQ2tRbuKkTHhr"}
POST /sapi/v1/userDataStream
权重:
1
参数:
NONE
延长 Listen Key 有效期 (USER_STREAM)
响应
{}
PUT /sapi/v1/userDataStream
权重:
1
参数:
名称
类型
是否必需
描述
listenKey
STRING
YES
关闭 ListenKey (USER_STREAM)
响应
{}
DELETE /sapi/v1/userDataStream
权重:
1
参数:
名称
类型
是否必需
描述
listenKey
STRING
YES
Listen Key(逐仓杠杆账户)生成 Listen Key (USER_STREAM)
响应:
{
"listenKey": "T3ee22BIYuWqmvne0HNq2A2WsFlEtLhvWCtItw6ffhhdmjifQ2tRbuKkTHhr"
}
POST /sapi/v1/userDataStream/isolated
权重:
1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
延长 Listen Key 有效期 (USER_STREAM)
响应:
{}
PUT /sapi/v1/userDataStream/isolated
权重:
1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
listenKey
STRING
YES
关闭 ListenKey (USER_STREAM)
响应:
{}
DELETE /sapi/v1/userDataStream/isolated
权重:
1
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
listenKey
STRING
YES
Payload: 账户更新
每当帐户余额发生更改时，都会发送一个事件outboundAccountPosition，其中包含可能由生成余额变动的事件而变动的资产。
Payload
{
"e": "outboundAccountPosition", // 事件类型
"E": 1564034571105, // 事件时间
"u": 1564034571073, // 账户末次更新时间戳
"B": [ // 余额
{
"a": "ETH", // 资产名称
"f": "10000.000000", // 可用余额
"l": "0.000000" // 冻结余额
}
]
}
Payload: 余额更新
Payload
{
"e": "balanceUpdate", //Event Type
"E": 1573200697110, //Event Time
"a": "ABC", //Asset
"d": "100.00000000", //Balance Delta
"T": 1573200697068 //Clear Time
}
当下列情形发生时更新:
账户发生充值或提取
交易账户之间发生划转(例如 现货向杠杆账户划转)
Payload: 订单更新
订单通过executionReport事件进行更新。
执行类型:
NEW - 新订单已被引擎接受。
CANCELED - 订单被用户取消。
REPLACED - (保留字段，当前未使用)
REJECTED - 新订单被拒绝 （这信息只会在撤消挂单再下单中发生，下新订单被拒绝但撤消挂单请求成功）。
TRADE - 订单有新成交。
EXPIRED - 订单已根据 Time In Force 参数的规则取消（e.g. 没有成交的 LIMIT FOK 订单或部分成交的 LIMIT IOC 订单）或者被交易所取消（e.g. 强平或维护期间取消的订单）。
TRADE_PREVENTION - 订单因 STP 触发而过期。
请查阅公开API参数文档获取更多枚举定义。
Payload
{
"e": "executionReport", // 事件类型
"E": 1499405658658, // 事件时间
"s": "ETHBTC", // 交易对
"c": "mUvoqJxFIILMdfAW5iGSOW", // clientOrderId
"S": "BUY", // 订单方向
"o": "LIMIT", // 订单类型
"f": "GTC", // 有效方式
"q": "1.00000000", // 订单原始数量
"p": "0.10264410", // 订单原始价格
"P": "0.00000000", // 止盈止损单触发价格
"F": "0.00000000", // 冰山订单数量
"g": -1, // OCO订单 OrderListId
"C": "", // 原始订单自定义ID(原始订单，指撤单操作的对象。撤单本身被视为另一个订单)
"x": "NEW", // 本次事件的具体执行类型
"X": "NEW", // 订单的当前状态
"r": "NONE", // 订单被拒绝的原因
"i": 4293153, // orderId
"l": "0.00000000", // 订单末次成交量
"z": "0.00000000", // 订单累计已成交量
"L": "0.00000000", // 订单末次成交价格
"n": "0", // 手续费数量
"N": null, // 手续费资产类别
"T": 1499405658657, // 成交时间
"t": -1, // 成交ID
"v": 3, // 被阻止撮合交易的ID; 这仅在订单因 STP 触发而过期时可见
"I": 8641984, // 请忽略
"w": true, // 订单是否在订单簿上？
"m": false, // 该成交是作为挂单成交吗？
"M": false, // 请忽略
"O": 1499405658657, // 订单创建时间
"Z": "0.00000000", // 订单累计已成交金额
"Y": "0.00000000", // 订单末次成交金额
"Q": "0.00000000", // Quote Order Quantity
"W": 1499405658657, // Working Time; 订单被添加到 order book 的时间
"V": "NONE" // SelfTradePreventionMode
}
备注: 通过将Z除以z可以找到平均价格。
如果订单是OCO，则除了显示executionReport事件外，还将显示一个名为ListStatus的事件。
executionReport 中的仅在满足特定条件时才会出现的字段：
字段
名称
描述
示例
d
Trailing Delta
出现在追踪止损订单中。
"d": 4
D
Trailing Time
"D": 1668680518494
j
Strategy Id
如果在请求中添加了strategyId参数，则会出现。
"j": 1
J
Strategy Type
如果在请求中添加了strategyType参数，则会出现。
"J": 1000000
v
Prevented Match Id
只有在因为 STP 导致订单失效时可见。
"v": 3
A
Prevented Quantity
"A":"3.000000"
B
Last Prevented Quantity
"B":"3.000000"
u
Trade Group Id
"u":1
U
Counter Order Id
"U":37
Cs
Counter Symbol
"Cs": "BTCUSDT"
pl
Prevented Execution Quantity
"pl":"2.123456"
pL
Prevented Execution Price
"pL":"0.10000001"
pY
Prevented Execution Quote Qty
"pY":"0.21234562"
W
Working Time
只有在订单在订单簿上时可见
"W": 1668683798379
b
Match Type
只有在订单有分配时可见
"b":"ONE_PARTY_TRADE_REPORT"
a
Allocation ID
"a":1234
k
Working Floor
只有在订单可能有分配时可见
"k":"SOR"
uS
UsedSor
只有在订单使用 SOR 时可见
"uS":true
Payload
{
"e": "listStatus", // 事件类型
"E": 1564035303637, // 事件时间
"s": "ETHBTC", // 交易对
"g": 2, // OrderListId
"c": "OCO", // Contingency Type
"l": "EXEC_STARTED", // List Status Type
"L": "EXECUTING", // List Order Status
"r": "NONE", // List 被拒绝的原因
"C": "F4QN4G8DlFATFlIUQ0cjdD", // List Client Order ID
"T": 1564035303625, // 成交时间
"O": [
{
"s": "ETHBTC", // 交易对
"i": 17, // orderId
"c": "AJYsMjErWJesZvqlJCTUgL" // clientOrderId
},
{
"s": "ETHBTC",
"i": 18,
"c": "bfYPSQdLoqAJeNrOr9adzq"
}
]
}
Margin账户信息推送
以下文档目前仅支持全仓杠杆账户
本篇所列出 API 接口的 base URL : https://api.binance.com
用于订阅账户数据的 listenKey 从创建时刻起有效期为24小时。
可以通过 PUT 一个 listenKey 延长24小时有效期。
可以通过 DELETE 一个 listenKey 立即关闭当前数据流，并使该 listenKey 无效。
在具有有效 listenKey 的帐户上执行POST将返回当前有效的 listenKey 并将其有效期延长24小时。
一个listenKey就是一个数据流。
用户可以侦听/订阅数个数据流。
websocket 接口的 base URL: wss://margin-stream.binance.com
U订阅账户数据流的 stream 名称为 /ws/
每个链接有效期不超过24小时，请妥善处理断线重连。
Listen Key获取杠杆账户websocket的Listen Key(USER_STREAM)
响应
{
"listenKey": "T3ee22BIYuWqmvne0HNq2A2WsFlEtLhvWCtItw6ffhhd"
}
POST /sapi/v1/margin/listen-key
开始一个新的杠杆数据流。
权重(UID):
1
参数:
NONE
延长 Listen Key 有效期 (USER_STREAM)
响应
{}
PUT /sapi/v1/margin/listen-key
有效期延长至本次调用后24小时。
权重(UID):
1
参数:
名称
类型
是否必需
描述
listenKey
STRING
YES
删除杠杆Listen Key (USER_STREAM)
响应
{}
DELETE /sapi/v1/margin/listen-key
关闭用户数据流。
权重(UID):
3000
参数:
名称
类型
是否必需
描述
listenKey
STRING
YES
Payload: 负债变化事件
当下列情形发生时,会推送此事件:
借款
计息
还款
Payload
{
"e": "USER_LIABILITY_CHANGE", // 事件类型
"E": 1701949801133, // 事件时间
"a": "BTC", // 资产
"t": "BORROW", // 负债变更类型
"p": "0.00000100", // 负债本金数量
"i": "0.00000000" // 利息数量
}
Payload: Margin Call事件
在用户 margin 账户发生 margin call 事件时,会推送此事件
Payload
{
"e": "MARGIN_LEVEL_STATUS_CHANGE", // 事件类型
"E": 1701949763462, // 事件时间
"l": "1.1", // 杠杆账户风险率
"s": "MARGIN_CALL" // 杠杆账户状态为Margin Call
}
赚币接口
您可以通过以下接口与币安赚币进行交互
· 有关这方面的更多信息，请参阅币安赚币页面。
查询赚币活期产品列表 (USER_DATA)
响应:
{
"rows": [
{
"asset": "BTC",
"latestAnnualPercentageRate": "0.05000000", // 实时年化收益率
"tierAnnualPercentageRate": { // 额外分级年化收益率
"0-5BTC": 0.05,
"5-10BTC": 0.03
},
"airDropPercentageRate": "0.05000000", // 空投年利率
"canPurchase": true,
"canRedeem": true,
"isSoldOut": true,
"hot": true, // 是否热推
"minPurchaseAmount": "0.01000000",
"productId": "BTC001",
"subscriptionStartTime": "1646182276000",
"status": "PURCHASING" // 预热，申购中，申购结束
}
],
"total": 1
}
GET /sapi/v1/simple-earn/flexible/list
权重(IP): 150
参数:
名称
类型
是否必需
描述
asset
STRING
NO
current
LONG
NO
当前查询页。 开始值 1，默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
查询赚币定期产品列表(USER_DATA)
响应:
{
"rows": [
{
"projectId": "Axs*90",
"detail": {
"asset": "AXS", //锁仓资产
"rewardAsset": "AXS", //收益资产
"duration": 90, //锁仓周期（天）
"renewable": true, //项目支持续期锁仓
"isSoldOut": true,
"apr": "1.2069",
"status": "CREATED", //CREATED新创建;PURCHASING申购中;
"subscriptionStartTime": "1646182276000",
"extraRewardAsset": "BNB",
"extraRewardAPR": "0.23"
},
"quota": {
"totalPersonalQuota": "2", //个人总额度
"minimum": "0.001" //单笔最小
}
}
],
"total": 1
}
GET /sapi/v1/simple-earn/locked/list
权重(IP): 150
参数:
名称
类型
是否必需
描述
asset
STRING
NO
current
LONG
NO
当前查询页。 开始值 1，默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
申购活期产品 (TRADE)
响应:
{
"purchaseId": 40607,
"success": true
}
POST /sapi/v1/simple-earn/flexible/subscribe
权重(IP): 1
频次限制：每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
productId
STRING
YES
amount
DECIMAL
YES
autoSubscribe
BOOLEAN
NO
true 或者 false, 默认 true.
sourceAccount
ENUM
NO
SPOT,FUND,ALL, 默认 SPOT
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
申购定期产品(TRADE)
响应:
{
"purchaseId": 40607,
"positionId": "12345",
"success": true
}
POST /sapi/v1/simple-earn/locked/subscribe
权重(IP): 1
频次限制：每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
projectId
STRING
YES
amount
DECIMAL
YES
autoSubscribe
BOOLEAN
NO
true 或者 false, 默认 true.
sourceAccount
ENUM
NO
SPOT,FUND,ALL, 默认 SPOT
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
赎回活期产品 (TRADE)
响应:
{
"redeemId": 40607,
"success": true
}
POST /sapi/v1/simple-earn/flexible/redeem
权重(IP): 1
频次限制：每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
productId
STRING
YES
redeemAll
BOOLEAN
NO
true 或者 false, 默认 false
amount
DECIMAL
NO
当redeemAll为false时必填
destAccount
ENUM
NO
SPOT,FUND,ALL, 默认 SPOT
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
赎回定期产品(TRADE)
响应:
{
"redeemId": 40607,
"success": true
}
POST /sapi/v1/simple-earn/locked/redeem
权重(IP): 1
频次限制：每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
positionId
STRING
YES
"1234"
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
获取活期产品持仓(USER_DATA)
响应:
{
"rows": [
{
"totalAmount": "75.46000000",
"tierAnnualPercentageRate": {
"0-5BTC": 0.05,
"5-10BTC": 0.03
},
"latestAnnualPercentageRate": "0.02599895",
"yesterdayAirdropPercentageRate": "0.02599895",
"asset": "USDT",
"airDropAsset": "BETH",
"canRedeem": true,
"collateralAmount": "232.23123213",
"productId": "USDT001",
"yesterdayRealTimeRewards": "0.10293829",
"cumulativeBonusRewards": "0.22759183",
"cumulativeRealTimeRewards": "0.22759183",
"cumulativeTotalRewards": "0.45459183",
"autoSubscribe": true
}
],
"total": 1
}
GET /sapi/v1/simple-earn/flexible/position
权重(IP): 150
参数:
名称
类型
是否必需
描述
asset
STRING
NO
productId
STRING
NO
current
LONG
NO
当前查询页。 开始值 1，默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
获取定期产品持仓 (USER_DATA)
响应:
{
"rows": [
{
"positionId": "123123",
"projectId": "Axs*90",
"asset": "AXS",
"amount": "122.09202928",
"purchaseTime": "1646182276000",
"duration": "60",
"accrualDays": "4",
"rewardAsset": "AXS",
"APY": "0.2032",
"rewardAmt": "5.17181528",
"extraRewardAsset": "BNB",
"extraRewardAPR": "0.0203",
"estExtraRewardAmt": "5.17181528",
"nextPay": "1.29295383",
"nextPayDate": "1646697600000",
"payPeriod": "1",
"redeemAmountEarly": "2802.24068892",
"rewardsEndDate": "1651449600000",
"deliverDate": "1651536000000",
"redeemPeriod": "1",
"redeemingAmt": "232.2323",
"partialAmtDeliverDate": "1651536000000",
"canRedeemEarly": true,
"canFastRedemption": true,
"autoSubscribe": true,
"type": "AUTO",
"status": "HOLDING",
"canReStake": true,
"reStakeInfo": {
"reStakeRate": "0.05",
"reStakeAmount": "0.02321232",
"reStakeDuration": "90",
"reStakeApr": "0.29",
"estRewards": "0.00232382",
"reStakeRewardsEndDate": "1651449600000",
"reStakeDeliverDate": "1651536000000"
}
}
],
"total": 1
}
GET /sapi/v1/simple-earn/locked/position
权重(IP): 150
参数:
名称
类型
是否必需
描述
asset
STRING
NO
positionId
STRING
NO
projectId
STRING
NO
current
LONG
NO
当前查询页。 开始值 1，默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
赚币账户(USER_DATA)
响应:
{
"totalAmountInBTC": "0.01067982",
"totalAmountInUSDT": "77.13289230",
"totalFlexibleAmountInBTC": "0.00000000",
"totalFlexibleAmountInUSDT": "0.00000000",
"totalLockedInBTC": "0.01067982",
"totalLockedInUSDT": "77.13289230"
}
GET /sapi/v1/simple-earn/account
权重(IP): 150
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询活期申购记录(USER_DATA)
响应:
{
"rows": [
{
"amount": "100.00000000",
"asset": "USDT",
"time": 1575018510000,
"purchaseId": 26055,
"type": "AUTO", // AUTO为自动申购，NORMAL为普通申购，CONVERT为定期转活期，LOAN为活期质押借币抵押物申购，AI为定投后申购，TRANSFER为币安宝定期转活期
"sourceAccount": "SPOT", // SPOT为现货账户, FUNDING为资金账户, SPOTANDFUNDING为现货和资金账户
"amtFromSpot": "30", // 仅当sourceAccount为SPOTANDFUNDING时展示
"amtFromFunding": "70", // 仅当sourceAccount为SPOTANDFUNDING时展示
"status": "SUCCESS" // PURCHASING 申购中/SUCCESS 申购成功/FAILED 申购失败
}
],
"total": 1
}
GET /sapi/v1/simple-earn/flexible/history/subscriptionRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
NO
purchaseId
STRING
NO
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送startTime，则会返回endTime之前30天的数据
查询定期申购记录 (USER_DATA)
响应:
{
"rows":[
{
"positionId": "123123",
"purchaseId": 26055,
"time": 1575018510000,
"asset": "BNB",
"amount": "21312.23223",
"lockPeriod": "30",
"type": "AUTO", // NORMAL为普通申购，AUTO为自动续期，ACTIVITY为活动类型申购，TRIAL为体验金申购，RESTAKE为续申购活动
"sourceAccount": "SPOT", //SPOT为现货账户, FUNDING为资金账户, SPOTANDFUNDING为现货和资金账户
"amtFromSpot": "30", //仅当sourceAccount为SPOTANDFUNDING时展示
"amtFromFunding": "70", //仅当sourceAccount为SPOTANDFUNDING时展示
"status": "SUCCESS" // PURCHASING 申购中/SUCCESS 申购成功/FAILED申购失败
}
],
"total": 1
}
GET /sapi/v1/simple-earn/locked/history/subscriptionRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
purchaseId
STRING
NO
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
...
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送startTime，则会返回endTime之前30天的数据
查询活期赎回记录 (USER_DATA)
响应:
{
"rows": [
{
"amount": "10.54000000",
"asset": "USDT",
"time": 1577257222000,
"projectId": "USDT001",
"redeemId": 40607,
"destAccount":"SPOT", // SPOT, FUNDING
"status": "PAID"
}
],
"total": 1
}
GET /sapi/v1/simple-earn/flexible/history/redemptionRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
NO
redeemId
STRING
NO
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
...
查询定期赎回记录 (USER_DATA)
响应:
{
"rows": [
{
"positionId":"123123",
"redeemId": 40607,
"time":1575018510000,
"asset":"BNB",
"lockPeriod":"30",
"amount":"21312.23223",
"type": "MATURE", //MATURE为赎回至现货账户，NEW_TRANSFERRED为赎回至活期产品，AHEAD为提前赎回类型
"deliverDate":"1575018510000", // 赎回到账时间
"status":"PAID" // CREATED赎回中，PAID赎回成功，FAILED赎回失败
}
]
"total": 1
}
GET /sapi/v1/simple-earn/locked/history/redemptionRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
positionId
STRING
NO
redeemId
STRING
NO
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送startTime，则会返回endTime之前30天的数据
查询活期收益记录 (USER_DATA)
响应:
{
"rows": [
{
"asset": "BUSD",
"rewards": "0.00006408",
"projectId": "USDT001",
"type": "BONUS",
"time": 1577233578000
},
{
"asset": "USDT",
"rewards": "0.00687654",
"projectId": "USDT001",
"type": "REALTIME",
"time": 1577233562000
}
],
"total": 2
}
GET /sapi/v1/simple-earn/flexible/history/rewardsRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
NO
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
type
ENUM
YES
"BONUS"额外分级收益,"REALTIME"实时收益,"REWARDS"历史收益
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送startTime，则会返回endTime之前30天的数据
查询定期收益记录 (USER_DATA)
响应:
{
"rows": [
{
"positionId": "123123",
"time": 1575018510000,
"asset": "BNB",
"lockPeriod": "30",
"amount": "21312.23223"
}
],
"total": 1
}
GET /sapi/v1/simple-earn/locked/history/rewardsRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
positionId
STRING
NO
asset
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送...
设置活期自动申购 (USER_DATA)
响应:
{
"success": true
}
POST /sapi/v1/simple-earn/flexible/setAutoSubscribe
为活期产品设置自动申购功能
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
YES
autoSubscribe
BOOLEAN
YES
true 或者 false
recvWindow
LONG
NO
timestamp
LONG
设置定期自动申购 (USER_DATA)
响应:
{
"success": true
}
POST /sapi/v1/simple-earn/locked/setAutoSubscribe
为定期产品设置自动申购功能
权重(IP): 150
参数:
名称
类型
是否必需
描述
positionId
STRING
YES
autoSubscribe
BOOLEAN
YES
true 或者 false
recvWindow
LONG
NO
timestamp
LONG
YES
查询活期个人剩余额度 (USER_DATA)
响应:
{
"leftPersonalQuota": "1000"
}
GET /sapi/v1/simple-earn/flexible/personalLeftQuota
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
YES
recvWindow
LONG
NO
timestamp
LONG
YES
查询定期个人剩余额度 (USER_DATA)
响应:
{
"leftPersonalQuota": "1000"
}
GET /sapi/v1/simple-earn/locked/personalLeftQuota
权重(IP): 150
参数:
名称
类型
是否必需
描述
projectId
STRING
YES
recvWindow
LONG
NO
timestamp
LONG
YES
活期申购预览(USER_DATA)
响应:
{
"totalAmount": "1232.32230982",
"rewardAsset": "BUSD",
"airDropAsset": "BETH",
"estDailyBonusRewards": "0.22759183",
"estDailyRealTimeRewards": "0.22759183",
"estDailyAirdropRewards": "0.22759183"
}
GET /sapi/v1/simple-earn/flexible/subscriptionPreview
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
定期申购预览(USER_DATA)
响应:
[
{
"rewardAsset": "AXS",
"totalRewardAmt": "5.17181528",
"extraRewardAsset": "BNB",
"estTotalExtraRewardAmt": "5.17181528",
"nextPay": "1.29295383",
"nextPayDate": "1646697600000",
"valueDate": "1646697600000",
"rewardsEndDate": "1651449600000",
"deliverDate": "1651536000000",
"nextSubscriptionDate": "1651536000000"
}
]
GET /sapi/v1/simple-earn/locked/subscriptionPreview
权重(IP): 150
参数:
名称
类型
是否必需
描述
projectId
STRING
YES
amount
DECIMAL
YES
autoSubscribe
BOOLEAN
NO
true 或者 false，默认true
recvWindow
LONG
NO
timestamp
LONG
YES
获取利率历史(USER_DATA)
响应:
{
"rows": [
{
"productId": "BUSD001",
"asset": "BUSD",
"annualPercentageRate": "0.00006408",
"time": 1577233578000
}
],
"total": "1"
}
GET /sapi/v1/simple-earn/flexible/history/rateHistory
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
YES
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送startTime，则会返回endTime之前30天的数据
获取抵押物记录(USER_DATA)
响应:
{
"rows": [
{
"amount": "100.00000000",
"productId": "BUSD001",
"asset": "USDT",
"createTime": 1575018510000,
"type": "REPAY",
"productName": "USDT",
"orderId": 26055
}
],
"total": "1"
}
GET /sapi/v1/simple-earn/flexible/history/collateralRecord
权重(IP): 150
参数:
名称
类型
是否必需
描述
productId
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。 开始值 1， 默认:1
size
LONG
NO
默认：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大间隔为3个月
如果startTime和endTime均未发送，则默认返回最近30天记录
如果发送了startTime但未发送endTime，则将返回从startTime开始的接下来30天的数据
如果发送了endTime，但未发送startTime，则会返回endTime之前30天的数据
双币投资接口获得双币产品列表(USER_DATA)
响应:
{
"total": 1,
"list": [
{
"id": "741590",
"investCoin": "USDT",
"exercisedCoin": "BNB",
"strikePrice": "380",
"duration": 4,
"settleDate": 1709020800000,
"purchaseDecimal": 8,
"purchaseEndTime": 1708934400000,
"canPurchase": true, //true, false
"apr": "0.6076",
"orderId": 8257205859,
"minAmount": "0.1",
"maxAmount": "25265.7",
"createTimestamp": 1708560084000,
"optionType": "PUT",
"isAutoCompoundEnable": true, //true, false
"autoCompoundPlanList": [
"STANDARD",
"ADVANCE"
]
}
]
}
GET /sapi/v1/dci/product/list
获得双币产品列表
权重(IP): 1
参数:
名称
类型
是否必需
描述
optionType
STRING
YES
输入CALL 或者 PUT
exercisedCoin
STRING
YES
行权币种，例如：如果您认购高卖产品（看涨期权），您应该输入:optionType:CALL,exercisedCoin:USDT,investCoin:BNB; 如果您认购低买产品（看跌期权），您应该输入: optionType:PUT,exercisedCoin:BNB,investCoin:USDT
investCoin
STRING
YES
申购币种，例如：如果您认购高卖产品（看涨期权），您应该输入:optionType:CALL,exercisedCoin:USDT,investCoin:BNB; 如果您认购低买产品（看跌期权），您应该输入: optionType:PUT,exercisedCoin:BNB,investCoin:USDT
pageSize
LONG
NO
默认： 10, 最大：100
pageIndex
INT
NO
默认：1
recvWindow
LONG
NO
该值不能大于 60000
timestamp
LONG
YES
申购双币产品(USER_DATA)
响应:
{
"positionId": 10208824,
"investCoin": "BNB",
"exercisedCoin": "USDT",
"subscriptionAmount": "0.002",
"duration": 4,
"autoCompoundPlan": "STANDARD", //基础计划, 进阶计划;autoCompoundPlan为None时此字段不显示
"strikePrice": "380",
"settleDate": 1709020800000,
"purchaseStatus": "PURCHASE_SUCCESS",
"apr": "0.7397",
"orderId": 8259117597,
"purchaseTime": 1708677583874,
"optionType": "CALL"
}
POST /sapi/v1/dci/product/subscribe
申购双币产品
权重(IP): 1
参数:
名称
类型
是否必需
描述
id
STRING
YES
从 /sapi/v1/dci/product/list 获得id
orderId
STRING
YES
从 /sapi/v1/dci/product/list 获得orderId
depositAmount
DECIMAL
YES
申购金额
autoCompoundPlan
ENUM
YES
输入参数：NONE, STANDARD, ADVANCED, NONE=关闭自动复投计划,STANDARD= 基础计划,ADVANCED= 进阶计划
recvWindow
LONG
NO
该值不能大于 60000
timestamp
LONG
YES
失败消息：
* Products are not available. 代表APR变小或者订单不可用。
* Failed. 代表系统或者网络错误。
获得双币产品持仓状态(USER_DATA)
响应:
{
"total": 1,
"list": [
{
"id": "10160533", //positionId
"investCoin": "USDT",
"exercisedCoin": "BNB",
"subscriptionAmount": "0.5",
"strikePrice": "330",
"duration": 4,
"settleDate": 1708416000000,
"purchaseStatus": "PURCHASE_SUCCESS",
"apr": "0.0365",
"orderId": 7973677530,
"purchaseEndTime": 1708329600000, //PENDING, PURCHASE_SUCCESS, SETTLED, PURCHASE_FAIL, REFUNDING, REFUND_SUCCESS, SETTLING
"optionType": "PUT",
"autoCompoundPlan": "STANDARD" //NULL, STANDARD, ADVANCED
}
]
}
GET /sapi/v1/dci/product/positions
获得双币产品持仓状态(批量接口)
权重(IP): 1
参数:
名称
类型
是否必需
描述
status
ENUM
NO
PENDING:产品申购中，将稍后给出结果;PURCHASE_SUCCESS:申购成功;SETTLED: 产品已经结算;PURCHASE_FAIL:申购失败;REFUNDING:退款中;REFUND_SUCCESS:退款成功，资金返回现货账户; SETTLING:产品正在结算中，如果不填写该字段，则返回所有持仓信息。
pageSize
LONG
NO
默认： 10, 最大：100
pageIndex
INT
NO
默认：1
recvWindow
LONG
NO
该值不能大于 60000
timestamp
LONG
YES
查询双币产品账户(USER_DATA)
响应:
{
"totalAmountInBTC": "0.01067982", //BTC总值
"totalAmountInUSDT": "77.13289230" //USDT等价于BTC的总值
}
GET /sapi/v1/dci/product/accounts
查询双币产品账户
权重(IP): 1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
该值不能大于 60000
timestamp
LONG
YES
改变自动复投状态(USER_DATA)
响应:
{
"positionId":"123456789"
"autoCompoundPlan":"ADVANCED", //NONE,STANDARD,ADVANCED
}
POST /sapi/v1/dci/product/auto_compound/edit-status
改变自动复投状态
权重(IP): 1
限频: 每个账户最多1次/秒
参数:
名称
类型
是否必需
描述
positionId
STRING
YES
从 /sapi/v1/dci/product/positions获得持仓id
AutoCompoundPlan
STRING
YES
NONE:关闭自动复投计划;STANDARD:基础计划;ADVANCED:进阶计划
recvWindow
LONG
NO
该值不能大于 60000
timestamp
LONG
YES
注意：
15:31 ~ 16:00 UTC+8 此功能关闭
定投接口
这些接口用于定投产品。更多细节, 请参考币安定投和币安定投FAQ页面。
查询允许申购币种列表 (USER_DATA)
响应:
{
"targetAssets": [
"BTC"
],
"autoInvestAssetList": [
{
"targetAsset": "BTC",
"roiAndDimensionTypeList": [
{
"simulateRoi": "5.004",
"dimensionValue": "3",
"dimensionUnit": "year"
},
{
"simulateRoi": "2.004",
"dimensionValue": "1",
"dimensionUnit": "year"
},
{
"simulateRoi": "1.004",
"dimensionValue": "6",
"dimensionUnit": "month"
},
{
"simulateRoi": "0.904",
"dimensionValue": "3",
"dimensionUnit": "month"
},
{
"simulateRoi": "0.14",
"dimensionValue": "7",
"dimensionUnit": "day"
}
]
}
]
}
GET /sapi/v1/lending/auto-invest/target-asset/list
权重(IP):
1
参数:
名称
类型
是否必需
描述
targetAsset
STRING
NO
size
LONG
NO
默认: 8, 最多:100
current
LONG
NO
当前查询页。 从 1开始。 默认:1
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
查询申购币种投资回报率(USER_DATA)
响应:
[
{
"date": "1648378800000", // ROI计算开始日期
"simulateRoi": "1.75"
},
{
"date": "1648478800000",
"simulateRoi": "2.9"
}
]
GET /sapi/v1/lending/auto-invest/target-asset/roi/list
查询定投允许申购的币种的投资回报率列表
权重(IP):
1
参数:
名称
类型
是否必需
描述
targetAsset
STRING
YES
e.g "BTC"
hisRoiType
ENUM
YES
FIVE_YEAR,THREE_YEAR,ONE_YEAR,SIX_MONTH,THREE_MONTH,SEVEN_DAY
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
查询申购币种和投资币种列表(USER_DATA)
响应:
{
"targetAssets": [
"BTC",
"BNB"
],
"sourceAssets": [
"USDT",
"BUSD"
],
}
GET /sapi/v1/lending/auto-invest/all/asset
查询定投申购币种和投资币种列表
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
查询投资币种列表(USER_DATA)
响应:
{
"feeRate": "0.002",
"taxRate": "0.001",
"sourceAssets": [
{
"sourceAsset": "USDT",
"assetMinAmount": "0.1" ,
"assetMaxAmount": "1000000",
"scale": "2",
"flexibleAmount":"1111"
},
{
"sourceAsset": "BUSD",
"assetMinAmount": "0.1" ,
"assetMaxAmount": "1000000",
"scale": "2",
"flexibleAmount":"1111"
}
]
}
GET /sapi/v1/lending/auto-invest/source-asset/list
查询定投投资的币种列表
权重(IP):
1
参数:
名称
类型
是否必需
描述
targetAsset
Array
NO
BTC、ETH、BNB
indexId
Long
NO
指数identifier, value = 1
usageType
STRING
YES
"RECURRING", "ONE_TIME"
flexibleAllowedToUse
BOOLEAN
NO
sourceType
ENUM
NO
MAIN_SITE Binance用户,TRBinance Turkey用户
recvWindow
LONG
NO
不能大于 60000
timestamp
LONG
YES
创建定投计划 (TRADE)
响应:
{
"planId": 12345, //成功创建后planId不变
"nextExecutionDateTime":1648378800000, //计划下次执行时间
}
POST /sapi/v1/lending/auto-invest/plan/add
创建定投计划
权重(IP):
1
参数:
名称
类型
是否必需
描述
sourceType
ENUM
YES
"MAIN_SITE" 币安,“TR”为币安土耳其
requestId
STRING
NO
若不为空, 字段规则为 sourceType + unique string e.g: TR12354859
planType
ENUM
YES
“SINGLE”,”PORTFOLIO”,”INDEX”
indexId
LONG
NO
只有当 planType = INDEX , value = 1
subscriptionAmount
DECIMAL
YES
Fiat&stablecoin: 2dp, BNB/ETH/BTC: 4dp
subscriptionCycle
ENUM
YES
"H1", "H4", "H8","H12", "WEEKLY","DAILY","MONTHLY","BI_WEEKLY"
subscriptionStartDay
INTEGER
NO
“1”,...”31”; 如果 “subscriptionCycleNumberUnit” = “MONTHLY”则必填,数值必须为 UTC+0
subscriptionStartWeekday
ENUM
NO
“MON”,”TUE”,”WED”,”THU”,”FRI”,”SAT”,”SUN”; 如果 “subscriptionCycleNumberUnit” = “MONTHLY”则必填,数值必须为 UTC+0
subscriptionStartTime
INTEGER
YES
“0,1,2,3,4,5,6,7,8,..23”;数值必须为 UTC+0
sourceAsset
STRING
YES
如 “USDT”
flexibleAllowedToUse
BOOLEAN
NO
true/false；true:使用 flexible wallet
details
Array
YES
sum(all node's percentage) == 100，若作为请求参数发送, 可参考以下格式details[0].targetAsset=BTC,请求参数的式例：details[0].targetAsset=BTC details[0].percentage=60 details[1].targetAsset=ETH details[1].percentage=40
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
单个账户每秒最多请求3次
编辑定投计划 (TRADE)
响应:
{
"planId": 12345, //成功创建后planId不变
"nextExecutionDateTime":1648378800000, //计划下次执行时间
}
POST /sapi/v1/lending/auto-invest/plan/edit
编辑定投计划
权重(IP):
1
参数:
名称
类型
是否必需
描述
planId
LONG
YES
计划编号
subscriptionAmount
DECIMAL
YES
Fiat&Stablecoin: 2dp, BNB/ETH/BTC: 4dp
subscriptionCycle
ENUM
YES
"H1", "H4", "H8","H12", "WEEKLY","DAILY","MONTHLY","BI_WEEKLY"
subscriptionStartDay
INTEGER
NO
“1”,...”31”; 如果 “subscriptionCycleNumberUnit” = “MONTHLY”则必填,数值必须为 UTC+0
subscriptionStartWeekday
ENUM
NO
“MON”,”TUE”,”WED”,”THU”,”FRI”,”SAT”,”SUN”; 如果 “subscriptionCycleNumberUnit” = “MONTHLY”则必填,数值必须为 UTC+0
subscriptionStartTime
INTEGER
YES
“0,1,2,3,4,5,6,7,8,..23”;Must be sent in form of UTC+0
sourceAsset
STRING
YES
如 “USDT”
flexibleAllowedToUse
BOOLEAN
NO
true/false；true:使用 flexible wallet
details
Array
YES
sum(all node's percentage) == 100，若作为请求参数发送, 可参考以下格式details[0].targetAsset=BTC,请求参数的式例：details[0].targetAsset=BTC details[0].percentage=60 details[1].targetAsset=ETH details[1].percentage=40
recvWindow
LONG
NO
no more than 60000
timestamp
LONG
YES
单个账户每秒最多请求3次
定投计划状态管理 (TRADE)
响应:
{
"planId": 12345,
"nextExecutionDateTime":1648378800000,
"status":"ONGOING" //状态
}
POST /sapi/v1/lending/auto-invest/plan/edit-status
定投计划状态管理
权重(IP):
1
参数:
名称
类型
是否必需
描述
planId
LONG
YES
计划编号
status
ENUM
YES
“ONGOING”,”PAUSED","REMOVED"
recvWindow
LONG
NO
no more than 60000
timestamp
LONG
YES
单个账户每秒最多请求3次
查询定投计划列表 (USER_DATA)
响应:
当planType为 SINGLE/PORTFOLIO
{
"planValueInUSD": "123",
"planValueInBTC":"0.1",
"pnlInUSD":"120",
"roi":"2.3",
"plans": [
{
"planId": 12345,
"planType": "SINGLE",
"editAllowed": "true",
"creationDateTime": 1648378800000,
"firstExecutionDateTime": 1648378800000, //first subscription date time
"nextExecutionDateTime": 1648378800000,
"status": "ONGOING", // ONGOING,PAUSED
"lastUpdatedDateTime": 1648378800000,
"targetAsset": "BTC",
"totalTargetAmount":"0.111",
"sourceAsset": "BUSD",
"totalInvestedInUSD":"4.555",
"subscriptionAmount": "0.1",
"subscriptionCycle": "WEEKLY",
"subscriptionStartDay": null,
"subscriptionStartWeekday" : "MON",
"subscriptionStartTime": "1",
"sourceWallet": "SPOT_WALLET",
"flexibleAllowedToUse": "false",
"planValueInUSD": "101.2",
"pnlInUSD": "101.2",
"roi": "1.02"
}
]
}
当planType为 INDEX
{
"planValueInUSD": "123",
"planValueInBTC": "0.1",
"plans": [
{
"planId": 12345,
"planType": "INDEX",
"editAllowed": "true",
"creationDateTime": 1648378800000,
"firstExecutionDateTime": 1648378800000, //first subscription date time
"nextExecutionDateTime": 1648378800000,
"status": "ONGOING",
"lastUpdatedDateTime": 1648378800000,
"targetAsset": "BTC",
"sourceAsset": "BUSD",
"totalInvestedInUSD":"4.555",
"subscriptionAmount": "0.1",
"subscriptionCycle": "DAILY",
"subscriptionStartDay": "1",
"subscriptionStartWeekday" : null,
"subscriptionStartTime": "2",
"sourceWallet": "SPOT",
"flexibleAllowedToUse": "false",
}
]
}
GET /sapi/v1/lending/auto-invest/plan/list
查询定投计划列表
权重(IP):
1
参数:
名称
类型
是否必需
描述
planType
STRING
YES
“SINGLE”,”PORTFOLIO”,”INDEX”用以区分查询计划类型
recvWindow
LONG
NO
不超过60000
timestamp
LONG
YES
单个账户每秒最多请求3次
查询定投计划详情 (USER_DATA)
响应:
{
"planId": 111212,
"planType": "INDEX", // this is the plan type: "SINGLE","PORTFOLIO","INDEX"
"editAllowed": "true", //whether this plan is allowed to be modified
"flexibleAllowedToUse": "false",
"creationDateTime": 1648378800000, // date time that this plan is created. YYYY-MM-DD HH:mm:SS e.g 2022-01-07 08:00:00
"firstExecutionDateTime": 1648378800000, //first subscription date time
"nextExecutionDateTime": 1648378800000, //next subscription date time
"status": "ONGOING", //plan status of the selected plan
"targetAsset": "BTC",
"sourceAsset": "BUSD", //source asset of the plan created
"planValueInUSD": "101.2", //market value of the plan
"pnlInUSD": "101.2", // PNL of the plan in USD
"roi": "1.023", //ROI of the plan
"totalInvestedInUSD": "122", //total source asset invested in equivilent of USD
"details": [
{
"targetAsset": "ADA",
"averagePriceInUSD": "3.4", //average price of the asset in USD
"totalInvestedInUSD": "222.21", //total source asset invested for this target asset in equivilent of USD
"purchasedAmount": "122.12345678", //purchased amount of target asset
"purchasedAmountUnit": "ADA",
"pnlInUSD": "109.2", //PNL denominated in USD
"roi": "0.1", //ROI calculated in decimal
"percentage": "50", //asset allocation in the plan. If it's single plan, then it's 100
"assetStatus":"ACTIVE", // ACTIVE / INACTIVE whether this asset is still being subscribed in this plan
"availableAmount": "122.12345678", // Only for planType = INDEX
"availableAmountUnit": "ADA", // Only for planType = INDEX
"redeemedAmout": "122.12345678", // Only for planType = INDEX
"redeemedAmoutUnit": "ADA", // Only for planType = INDEX
"assetValueInUSD": "101.2" // Only for planType = INDEX
}
]
}
GET /sapi/v1/lending/auto-invest/plan/id
查询计划详情
权重(IP):
1
参数:
名称
类型
是否必需
描述
planId
LONG
NO
计划编号
requestId
STRING
NO
创建时requestId
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
查询申购历史 (USER_DATA)
响应:
[
{
"id":1111,
"targetAsset":"BTC", //name of the asset
"planType":"SINGLE", //plan type of which this transaction is from
"planName":"BTC", // plan name of which this transaction is from
"planId":1234, // plan identifier of which this transaction is from
"transactionDateTime":1648378800000, //transaction timestamp
"transactionStatus":"SUCCESS", //status of the transaction: "SUCCESS","FAILED","PENDING"
"failedType":"INSUFFICIENT_BALANCE",// only show when transactionStatus = FAILED, INSUFFICIENT_BALANCE,TRANSACTION_REJECT/GCC_RJECT
"sourceAsset":"BUSD", //source asset of the transaction
"sourceAssetAmount":"297.12345", //amount of source asset used
"targetAssetAmount":"0.005", //purchased amount of the asset
"sourceWallet":"SPOT_WALLET", // SPOT_WALLET,FLEXIBLE_SAVINGS,SPOT_WALLET_FLEXIBLE_SAVINGS,REWARDS
"flexibleUsed":"false", //whether simple earn wallet is used
"transactionFee":"0.002", //transaction fee amount
"transactionFeeUnit":"BUSD", //denominated coin of the transaction fee
"executionPrice":"2342" //price of the subscription price. It's amount of source asset equivilent of 1 unit of target asset
"executionType":"RECURRING" //ONE_TIME,RECURRING
"subscriptionCycle": "WEEKLY"
}
]
GET /sapi/v1/lending/auto-invest/history/list
查询申购历史
权重(IP):
1
参数:
名称
类型
是否必需
描述
planId
LONG
NO
计划id
startTime
LONG
NO
endTime
LONG
NO
targetAsset
STRING
NO
planType
ENUM
NO
SINGLE, PORTFOLIO, INDEX, ALL
size
LONG
NO
默认10, 最大100
current
LONG
NO
当前查询页。 默认为1
recvWindow
LONG
NO
不超过60000
timestamp
LONG
YES
startTime与endTime不超过30天
如果不传startTime与endTime，默认30天
查询指数信息(USER_DATA)
响应:
{
"indexId": 1,
"indexName":"BINANCE TOP 10 EW ",
"status": "RUNNING", //RUNNING/REBALANCING/PAUSED
"assetAllocation": [
{
"targetAsset": "ADA", // for pie chart
"allocation":"10"
},
{
"targetAsset": "BTC",
"allocation":"10"
}
]
}
GET /sapi/v1/lending/auto-invest/index/info
查询指数信息
权重(IP):
1
参数:
名称
类型
是否必需
描述
indexId
LONG
YES
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
查询指数关连计划详情（USER_DATA）
响应:
{
"indexId": 1, // 指数id
"totalInvestedInUSD":"114.555", // 总投资额USD单位
"currentInvestedInUSD": "101.2", // 当前投资额USD单位
"pnlInUSD": "101.2", // PNL(USD)单位
"roi": "1.023", // ROI数值
"assetAllocation": [
{
"targetAsset": "ADA", // 申购币种，饼状图显示可使用
"allocation":"10" // 资产占比
},
{
"targetAsset": "BTC",
"allocation":"10"
}
]
"details": [
{
"targetAsset": "ADA", //申购币种
"averagePriceInUSD": "3.4", //平均投资价格USD单位
"totalInvestedInUSD": "222.21", //总投资额USD单位
"currentInvestedInUSD": "101.2", //当前投资USD单位
"purchasedAmount": "122.12345678", //购买的资产
"pnlInUSD": "109.2", //以USD计量的PNL
"roi": "0.1", //ROI以小数位计算
"percentage": "10", //币种的占比，如果是单币计划， 占比为100%
"availableAmount": "122.12345678", //资产数额
"redeemedAmount": "122.12345678", //赎回数额
"assetValueInUSD": "101.2" //资产价值USD价值
},
{
"targetAsset": "MATIC",
"averagePriceInUSD": "3.4",
"totalInvestedInUSD": "222.21",
"currentInvestedInUSD": "101.2",
"purchasedAmount": "122.12345678",
"pnlInUSD": "109.2",
"roi": "0.1",
"percentage": "10",
"availableAmount": "122.12345678",
"redeemedAmount": "122.12345678",
"assetValueInUSD": "101.2"
}
]
}
GET /sapi/v1/lending/auto-invest/index/user-summary
查询指数关连计划详情
权重(IP):
1
参数:
名称
类型
是否必需
描述
indexId
LONG
YES
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
单次申购(TRADE)
响应:
{
"transactionId": 12345, //交易id
"waitSecond": 5 // 需停留5秒，查询结果
}
POST /sapi/v1/lending/auto-invest/one-off
单次申购
权重(IP):
1
频次限制:
每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
sourceType
STRING
YES
"MAIN_SITE",“TR” 只有Binance Turkey使用TR入参
requestId
STRING
NO
if not null, must follow businessReference + unique string, e.g: TR12354859
subscriptionAmount
DECIMAL
YES
sourceAsset
STRING
YES
“USDT”,”BUSD”
flexibleAllowedToUse
BOOLEAN
NO
true/false，True:使用flexible wallet，TR业务使用false
planId
LONG
NO
PORTFOLIO plan Id
indexId
LONG
NO
目前只有 1
details
Array
YES
sum(all node's percentage) == 100，若作为请求参数发送, 可参考以下格式details[0].targetAsset=BTC,请求参数的式例：details[0].targetAsset=BTC details[0].percentage=60 details[1].targetAsset=ETH details[1].percentage=40
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
planId/indexId/details不能均为空
单次申购交易结果查询(USER_DATA)
响应:
{
"transactionId": 12345, //交易id
"status": "SUCCESS" //交易状态"成功“或”进行中“（"SUCCESS"/"CONVERTING")
}
GET /sapi/v1/lending/auto-invest/one-off/status
单次申购交易结果查询
权重(IP):
1
参数:
名称
类型
是否必需
描述
transactionId
LONG
YES
PORTFOLIO plan Id
requestId
STRING
NO
TR1212123123, sourceType + unique, transactionId and requestId 不能同时为空
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
指数关连计划赎回交易(TRADE)
响应:
{
"redemptionId":19, //赎回请求id
}
POST /sapi/v1/lending/auto-invest/redeem
指数关连计划赎回交易
权重(IP):
1
频次限制:
每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
indexId
LONG
YES
指数id
requestId
STRING
NO
TR1212123123, sourceType + unique, transactionId and requestId 不能同时为空
redemptionPercentage
LONG
YES
赎回的占比, 10/20/100..
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
指数关连计划赎回交易历史查询(USER_DATA)
响应:
[
{
"indexId":1, //指数id
"indexName":"BINANCE TOP 10 EW", //指数名称
"redemptionId":11, //赎回交易id
"status":"SUCCESS", //赎回结果（成功/失败 SUCCESS/FAILED ）
"asset":"BTC", //赎回资产
"amount":"0.005", //赎回数额
"redemptionDateTime":1648378800000, //赎回时间
"transactionFee":"0", //赎回手续费
"transactionFeeUnit":"USDT" //赎回数额USD单位
},
{
"indexId":1,
"indexName":"BINANCE TOP 10 EW",
"redemptionId":12 ,
"status":"SUCCESS",
"asset":"BNB",
"amount":"0.005",
"redemptionDateTime":1648378800000,
"transactionFee":"0",
"transactionFeeUnit":"USDT"
}
]
GET /sapi/v1/lending/auto-invest/redeem/history
指数关连计划赎回交易历史查询
权重(IP):
1
参数:
名称
类型
是否必需
描述
requestId
LONG
YES
请求id
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页，从1开始，1位默认值
asset
STRING
NO
size
LONG
NO
默认:10, 最大:100
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
startTime和endTime的最大间隔为30天
若startTime和endTime均未发送，则默认返回最近30天记录
指数关连计划调仓历史记录(USER_DATA)
响应:
[
{
"indexId":1, //指数id
"indexName":"BINANCE TOP 10 EW", //指数名称
"rebalanceId":11, //调仓请求id
"status":"SUCCESS", //调仓结果（成功/进行中 SUCCESS/INIT)
"rebalanceFee":"10", //调仓手续费
"rebalanceFeeUnit":"USDT", //调仓手续费单位
"transactionDetails":[
{
"asset":"BTC", //调仓资产
"transactionDateTime":1648378800000, //调仓交易时间
"rebalanceDirection":"BUY", //调仓交易方向
"rebalanceAmount":"0.005", //调仓数额
},
{
"asset":"ETH",
"transactionDateTime":1648378800000,
"rebalanceDirection":"BUY",
"rebalanceAmount":"0.005",
}
]
}
]
GET /sapi/v1/lending/auto-invest/rebalance/history
指数关连计划赎回交易历史查询
权重(IP):
1
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页，从1开始，1位默认值
size
LONG
NO
默认:10, 最大:100
recvWindow
LONG
NO
不超过 60000
timestamp
LONG
YES
startTime和endTime的最大间隔为30天
若startTime和endTime均未发送，则默认返回最近30天记录
Staking 接口
以下接口适用于币安Staking产品。更多细节, 请参考币安Staking页面
质押 ETH (TRADE)
响应:
{
"success": true
}
POST /sapi/v1/eth-staking/eth/stake
权重(IP): 150
频次限制：每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
amount
DECIMAL
YES
ETH 数量，限制4位小数
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
质押 ETH V2(TRADE)
响应:
{
"success": true,
"wbethAmount":"0.23092091",
"conversionRatio": "1.001212342342" // 每1WBETH的ETH数量
}
POST /sapi/v2/eth-staking/eth/stake
质押ETH获得WBETH
权重(IP): 150
频次限制：每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
amount
DECIMAL
YES
ETH 数量，限制4位小数
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
赎回 ETH (TRADE)
响应:
{
"success": true,
"arrivalTime": 1575018510000,
"ethAmount":"0.23092091",
"conversionRatio": "1.00121234"
}
POST /sapi/v1/eth-staking/eth/redeem
赎回WBETH或BETH并获得ETH
权重(IP):
150
频次限制：
每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
asset
STRING
NO
WBETH 或 BETH, 默认 BETH
amount
DECIMAL
YES
BETH 数量，限制8位小数
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
查询 ETH 质押记录 (USER_DATA)
响应:
{
"rows": [
{
"time": 1575018510000,
"asset": "ETH",
"amount": "21312.23223",
"status": "SUCCESS", //PENDING,SUCCESS,FAILED
"distributeAmount":"21286.42584",
"conversionRatio":"1.00121234"
}
],
"total": 1
}
GET /sapi/v1/eth-staking/eth/history/stakingHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1， 默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
查询 ETH 赎回记录 (USER_DATA)
响应:
{
"rows":[
{
"time":1575018510000,
"arrivalTime":1575018510000,
"asset":"BETH",
"amount":"21312.23223",
"status":"SUCCESS",
"asset":"WBETH",
"distributeAsset": "ETH", //PENDING,SUCCESS,FAILED
"distributeAmount": "21338.0699",
"conversionRatio": "1.00121234"
}
]
"total": 1
}
GET /sapi/v1/eth-staking/eth/history/redemptionHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1， 默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
查询 BETH 质押收益记录 (USER_DATA)
响应:
{
"rows": [
{
"time": 1575018510000,
"asset": "BETH",
"holding": "2.3223",
"amount": "0.23223",
"annualPercentageRate": "0.5",
"status": "SUCCESS"
}
],
"total": 1
}
GET /sapi/v1/eth-staking/eth/history/rewardsHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1， 默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
查询当前 ETH 质押限额 (USER_DATA)
响应:
{
"leftStakingPersonalQuota": "1000", // Show min(Daily available limit, total personal staking quota)
"leftRedemptionPersonalQuota": "1000" // Show min(Daily personal redeem quota, total redemption limit)
}
GET /sapi/v1/eth-staking/eth/quota
权重(IP):
150
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询 WBETH 汇率历史 (USER_DATA)
响应:
{
"rows": [
{
"annualPercentageRate": "0.00006408", // BETH APR
"exchangeRate": "1.00121234", // 1 WBETH等价的BETH数量
"time": 1577233578000
}
],
"total": "1"
}
GET /sapi/v1/eth-staking/eth/history/rateHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1，默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
ETH 质押账户(USER_DATA)
响应:
{
"cumulativeProfitInBETH": "0.01067982",
"lastDayProfitInBETH": "0.01067982"
}
GET /sapi/v1/eth-staking/account
权重(IP):
150
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
ETH 质押账户V2(USER_DATA)
响应:
{
"holdingInETH":"1.22330928",
"holdings":{
wbethAmount="1.10928781",
bethAmount="1.90002112"
},
"thirtyDaysProfitInETH":"0.22330928",
"profit":{
amountFromWBETH="0.12330928", //收益累计在WBETH中
amountFromBETH="0.1" //BETH发放至现货钱包
}
}
GET /sapi/v2/eth-staking/account
权重(IP):
150
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
封装 BETH(TRADE)
响应:
{
"success": true,
"wbethAmount": "0.23092091",
"exchangeRate": "1.001212343432"
}
POST /sapi/v1/eth-staking/wbeth/wrap
权重(IP):
150
频次限制： 每个账户最多三秒一次
参数:
名称
类型
是否必需
描述
amount
DECIMAL
YES
BETH 数量，限制 4 位小数
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为 API Key 开通允许现货和杠杆交易权限才能发送此请求
查询 WBETH 封装记录 (USER_DATA)
响应:
{
"rows": [
{
"time": 1575018510000,
"fromAsset": "BETH",
"fromAmount": "21312.23223",
"toAsset": "WBETH",
"toAmount": "21312.23223",
"exchangeRate": "1.01243253", // 每1个WBETH对应BETH数量
"status": "SUCCESS" //PENDING,SUCCESS,FAILED
}
],
"total": 1
}
GET /sapi/v1/eth-staking/wbeth/history/wrapHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1，默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
查询WBETH去封装记录(USER_DATA)
响应:
{
"rows": [
{
"time": 1575018510000,
"fromAsset": "WBETH",
"fromAmount": "21312.23223",
"toAsset": "BETH",
"toAmount": "21312.23223",
"exchangeRate": "1.01243253", // BETH value per 1 WBETH
"status": "SUCCESS" //PENDING,SUCCESS,FAILED
}
],
"total": 1
}
GET /sapi/v1/eth-staking/wbeth/history/unwrapHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1，默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
查询WBETH去封装记录(USER_DATA)
响应:
{
"estRewardsInETH":"1.23230920",
"rows":[
{
"time":1575018510000,
"amountInETH":"0.23223", // Estimated rewards accrued within WBETH
"holding":"2.3223", // WBETH holding balance
"holdingInETH":"2.4231",
"annualPercentageRate":"0.5",
}
],
"total": 1
}
GET /sapi/v1/eth-staking/eth/history/wbethRewardsHistory
权重(IP):
150
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页。开始值 1，默认 1
size
LONG
NO
默认 10，最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
startTime 和 endTime 的最大间隔为 3 个月
如果 startTime 和 endTime 均未发送，则默认返回最近 30 天记录
如果发送了 startTime 但未发送 endTime，则将返回从 startTime 开始的接下来 30 天的数据
如果发送了 endTime，但未发送 startTime，则会返回 endTime 之前 30 天的数据
矿池接口
这些接口作用于币安矿池。更多细节, 参考币安矿池页面。
获取算法(MARKET_DATA)
响应:
{
"code": 0,
"msg": "",
"data": [
{
"algoName": "sha256", // 算法名称
"algoId": 1, // 算法id
"poolIndex": 0, // 序列
"unit": "h/s" // 单位
}
]
}
GET /sapi/v1/mining/pub/algoList
权重(IP):
1
参数:
None
获取币种(MARKET_DATA)
响应:
{
"code": 0,
"msg": "",
"data": [
{
"coinName": "BTC", // 币种名称
"coinId": 1, // id
"poolIndex": 0, // 排序
"algoId": 1, // 所属算法
"algoName": "sha256" //所属算法名称
}
]
}
GET /sapi/v1/mining/pub/coinList
权重(IP):
1
参数:
None
请求矿工列表明细 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": [
{
"workerName": "bhdc1.16A10404B", //挖矿用户名
"type": "H_hashrate", // 小时算力类型
"hashrateDatas": [
{
"time": 1587902400000, // 时间
"hashrate": "0", // 算力
"reject": 0 //拒绝率
},
{
"time": 1587906000000,
"hashrate": "0",
"reject": 0
},
.......
]
},
{
"workerName": "bhdc1.16A10404B", //挖矿用户名
"type": "D_hashrate", //日均算力类型
"hashrateDatas": [
{
"time": 1587902400000, // 时间
"hashrate": "0", // 算力
"reject": 0 //拒绝率
},
{
"time": 1587906000000,
"hashrate": "0",
"reject": 0
},
.......
]
}
]
}
GET /sapi/v1/mining/worker/detail
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
userName
STRING
YES
挖矿用户名
test
workerName
STRING
YES
矿工用户名，必传
bhdc1.16A10404B
recvWindow
LONG
NO
timestamp
LONG
YES
请求矿工列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"workerDatas": [
{
"workerId": "1420554439452400131", //矿工id
"workerName": "2X73", //矿工姓名
"status": 3, // 状态：1 有效， 2 无效， 3 失效
"hashRate": 0, // 实时速率
"dayHashRate": 0, //日均算力
"rejectRate": 0, //实时拒绝率
"lastShareTime": 1587712919000 // 最后提交时间
},
{
"workerId": "7893926126382807951",
"workerName": "AZDC1.1A10101",
"status": 2,
"hashRate": 29711247541680,
"dayHashRate": 12697781298013.66,
"rejectRate": 0,
"lastShareTime": 1587969727000
},
......
],
"totalNum": 18530, // 总数量
"pageSize": 20 // 每页条数
}
}
GET /sapi/v1/mining/worker/list
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
userName
STRING
YES
挖矿用户名
test
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
sort
INTEGER
NO
排序方向(为空默认为0): 0 正序，1 倒序
sortColumn
INTEGER
NO
排序字段(默认为1): 1: 根据矿工名称排序，2: 根据实时算力排序， 3: 根据日均算力排序， 4: 根据实时拒绝率排序，5最后提交时间
workerStatus
INTEGER
NO
矿机状态(默认为0)：0 全部，1 有效， 2 无效， 3 失效
recvWindow
LONG
NO
timestamp
LONG
YES
收益列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"accountProfits": [
{
"time": 1586188800000, // 时间
"type": 31, // 0:矿池钱包,5:地址挖矿,7:矿池宝,8:已转让,31:收益转让 ,32:算力转让-矿池钱包 33:算力转让-矿池宝
"hashTransfer": null, // 已转让算力
"transferAmount": null, // 已转让收益
"dayHashRate": 129129903378244, // 算力
"profitAmount": 8.6083060304, //奖励数量
"coinName":"BTC", // 奖励币种
"status": 2 //支付状态：0:待支付， 1:支付中 2：已支付
},
{
"time": 1607529600000,
"coinName": "BTC",
"type": 0,
"dayHashRate": 9942053925926,
"profitAmount": 0.85426469,
"hashTransfer": 200000000000,
"transferAmount": 0.02180958,
"status": 2
},
{
"time": 1607443200000,
"coinName": "BTC",
"type": 31,
"dayHashRate": 200000000000,
"profitAmount": 0.02905916,
"hashTransfer": null,
"transferAmount": null,
"status": 2
}
],
"totalNum": 3, // 总条数
"pageSize": 20 // 每页数量
}
}
GET /sapi/v1/mining/payment/list
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
userName
STRING
YES
挖矿用户名
test
coin
STRING
NO
币种名称
startDate
Long
NO
搜索日期 毫秒时间戳，同时为空查询所有
endDate
Long
NO
搜索日期 毫秒时间戳，同时为空查询所有
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
pageSize
INTEGER
NO
分页数量,最小10,最大200
recvWindow
LONG
NO
timestamp
LONG
YES
其他收益列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"otherProfits": [
{
"time": 1607443200000, // 时间
"coinName": "BTC", // 奖励币种
"type": 4, // 1: 联合挖矿， 2: 活动奖励, 3:返点 4:机枪奖励 6:收益转让 7:矿池宝
"profitAmount": 0.0011859, //奖励数量
"status": 2 //支付状态：0:待支付， 1:支付中 2：已支付
}
],
"totalNum": 3, // 总条数
"pageSize": 20 // 每页数量
}
}
GET /sapi/v1/mining/payment/other
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
userName
STRING
YES
挖矿用户名
test
coin
STRING
NO
币种名称
startDate
Long
NO
搜索日期 毫秒时间戳，同时为空查询所有
endDate
Long
NO
搜索日期 毫秒时间戳，同时为空查询所有
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
pageSize
INTEGER
NO
分页数量,最小10,最大200
recvWindow
LONG
NO
timestamp
LONG
YES
算力转让详情列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"configDetails": [
{
"configId": 168, // 该配置的id
"poolUsername": "123", //转出子账户
"toPoolUsername": "user1", // 转入子账户
"algoName": "Ethash", // 转让算法名称
"hashRate": 5000000, // 转让算力
"startDay": 20201210, // 开始时间
"endDay": 20210405, //结束时间
"status": 1 //状态：0 进行中，1：已取消，2：已终止
},
{
"configId": 166,
"poolUsername": "pop",
"toPoolUsername": "111111",
"algoName": "Ethash",
"hashRate": 3320000,
"startDay": 20201226,
"endDay": 20201227,
"status": 0
}
],
"totalNum": 21,
"pageSize": 200
}
}
GET /sapi/v1/mining/hash-transfer/config/details
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
pageSize
INTEGER
NO
分页数量,最小10,最大200
recvWindow
LONG
NO
timestamp
LONG
YES
算力转让列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"configDetails": [
{
"configId": 168, // 该配置的id
"poolUsername": "123", //转出子账户
"toPoolUsername": "user1", // 转入子账户
"algoName": "Ethash", // 转让算法名称
"hashRate": 5000000, // 转让算力
"startDay": 20201210, // 开始时间
"endDay": 20210405, //结束时间
"status": 1, //状态：0 进行中，1：已取消，2：已终止
"type": 0 //状态：0 算力转让记录，1 算力接收记录
},
{
"configId": 166,
"poolUsername": "pop",
"toPoolUsername": "111111",
"algoName": "Ethash",
"hashRate": 3320000,
"startDay": 20201226,
"endDay": 20201227,
"status": 0,
"type": 0
}
],
"totalNum": 21,
"pageSize": 200
}
}
GET /sapi/v1/mining/hash-transfer/config/details/list
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
pageSize
INTEGER
NO
分页数量,最小10,最大200
recvWindow
LONG
NO
timestamp
LONG
YES
算力转让详情 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"profitTransferDetails": [{
"poolUsername": "test4001", // 转出子账户
"toPoolUsername": "pop", // 转入子账户
"algoName": "sha256", //转让算法名称
"hashRate": 200000000000, // 转让算力
"day": 20201213, //转让日期
"amount": 0.2256872, // 转让收益
"coinName": "BTC" // 收益币种
},
{
"poolUsername": "test4001",
"toPoolUsername": "pop",
"algoName": "sha256",
"hashRate": 200000000000,
"day": 20201213,
"amount": 0.2256872,
"coinName": "BTC"
}
],
"totalNum": 8,
"pageSize": 200
}
}
GET /sapi/v1/mining/hash-transfer/profit/details
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
configId
INTEGER
YES
配置的id
168
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
pageSize
INTEGER
NO
分页数量,最小10,最大200
recvWindow
LONG
NO
timestamp
LONG
YES
算力转让请求 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": 171 // 该配置的id
}
POST /sapi/v1/mining/hash-transfer/config
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
userName
STRING
YES
挖矿用户名
test
algo
STRING
YES
算法名称(sha256)
sha256
endDate
Long
YES
转让结束时间(毫秒时间戳)
1617659086000
startDate
Long
YES
转让结束时间(毫秒时间戳)
1607659086000
toPoolUser
STRING
YES
挖矿用户名
S19pro
hashRate
Long
YES
转让算力h/s必传(BTC 大于 500000000000 ETH大于 500000)
100000000
recvWindow
LONG
NO
timestamp
LONG
YES
取消算力转让设置 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": true
}
POST /sapi/v1/mining/hash-transfer/config/cancel
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
configId
INTEGER
YES
配置的id
168
userName
STRING
YES
挖矿用户名
test
recvWindow
LONG
NO
timestamp
LONG
YES
统计列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"fifteenMinHashRate": "457835490067496409.00000000", // 15分钟算力
"dayHashRate": "214289268068874127.65000000", // 日均算力
"validNum": 0, // 有效数量
"invalidNum": 17562, // 无效数量
"profitToday":{ // 今日预估
"BTC":"0.00314332",
"BSV":"56.17055953",
"BCH":"106.61586001"
},
"profitYesterday":{ // 昨日收益
"BTC":"0.00314332",
"BSV":"56.17055953",
"BCH":"106.61586001"
},
"userName": "test", // 挖矿账户
"unit": "h/s", // 算力单位
"algo": "sha256" // 所属算法
}
}
GET /sapi/v1/mining/statistics/user/status
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
userName
STRING
YES
挖矿用户名
test
recvWindow
LONG
NO
timestamp
LONG
YES
账号列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": [
{
"type": "H_hashrate", //小时算力类型
"userName": "test", // 账户名
"list": [
{
"time": 1585267200000, // 时间
"hashrate": "0.00000000", // 算力
"reject": "0.00000000" //拒绝率
},
{
"time": 1585353600000,
"hashrate": "0.00000000",
"reject": "0.00000000"
}
......
]
},
{
"type": "D_hashrate", //日均算力类型
"userName": "test", // 账户名
"list": [
{
"time": 1587906000000, // 时间
"hashrate": "0.00000000", // 算力
"reject": "0.00000000" //拒绝率
},
{
"time": 1587909600000,
"hashrate": "0.00000000",
"reject": "0.00000000"
} ......
]
}
]
}
GET /sapi/v1/mining/statistics/user/list
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
userName
STRING
YES
挖矿用户名
test
recvWindow
LONG
NO
timestamp
LONG
YES
矿池账户收益列表 (USER_DATA)
响应:
{
"code": 0,
"msg": "",
"data": {
"accountProfits": [
{
"time": 1607443200000, // 时间
"coinName": "BTC", // 币种
"type": 2, // 0:邀请返佣 1：邀请返现 2：返点
"puid": 59985472, //挖矿子账户id
"subName": "vdvaghani", //挖矿账户名
"amount": 0.09186957 //数量
}
],
"totalNum": 3, // 总条数
"pageSize": 20 // 每页数量
}
}
GET /sapi/v1/mining/payment/uid
权重(IP):
5
参数:
名称
类型
是否必需
描述
例子
algo
STRING
YES
算法名称(sha256)
sha256
startDate
Long
NO
搜索日期 毫秒时间戳，同时为空查询所有
endDate
Long
NO
搜索日期 毫秒时间戳，同时为空查询所有
pageIndex
INTEGER
NO
页码，为空默认第一页，从1开始
pageSize
INTEGER
NO
分页数量,最小10,最大200
recvWindow
LONG
NO
timestamp
LONG
YES
合约接口
列出为了服务于合约产品的接口
合约资金划转 (USER_DATA)
响应:
{
"tranId": 100000001 // 划转 ID
}
POST /sapi/v1/futures/transfer
执行现货账户与合约账户之间的划转
权重(IP):
1
参数:
名称
类型
是否必需
描述
asset
STRING
YES
The asset being transferred, e.g., USDT
amount
DECIMAL
YES
The amount to be transferred
type
INT
YES
1: 现货账户向USDT合约账户划转 2: USDT合约账户向现货账户划转 3: 现货账户向币本位合约账户划转 4: 币本位合约账户向现货账户划转
recvWindow
LONG
NO
timestamp
LONG
YES
您需要打开 API Key 的 Futures 权限以使用此接口。
获取合约资金划转历史 (USER_DATA)
响应:
{
"rows": [
{
"asset": "USDT", // 资产
"tranId": 100000001, // 划转ID
"amount": "40.84624400", // 数量
"type": "1", // 划转方向: 1( 现货向USDT本位合约), 2( USDT本位合约向现货), 3( 现货向币本位合约), and 4( 币本位合约向现货)
"timestamp": 1555056425000, // 时间戳
"status": "CONFIRMED" // PENDING (等待执行), CONFIRMED (成功划转), FAILED (执行失败);
}
],
"total": 1
}
GET /sapi/v1/futures/transfer
权重(IP):
10
参数:
名称
类型
是否必需
描述
asset
STRING
NO
startTime
LONG
YES
endTime
LONG
NO
current
LONG
NO
当前页面. 起始计数为1. 默认值1
size
LONG
NO
单页数据条目数，默认:10 最大:100
recvWindow
LONG
NO
timestamp
LONG
YES
仅支持查询最近半年（6个月）数据
获取合约订单薄历史数据下载地址(USER_DATA)
响应:
{
"data": [
{
"day": "2023-06-30",
"url": "https://bin-prod-user-rebate-bucket.s3.ap-northeast-1.amazonaws.com/future-data-symbol-update/2023-06-30/BTCUSDT_T_DEPTH_2023-06-30.tar.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230925T025710Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86399&X-Amz-Credential=AKIAVL364M5ZNFZ74IPP%2F20230925%2Fap-northeast-1%2Fs3%2Faws4_request&X-Amz-Signature=5fffcb390d10f34d71615726f81f99e42d80a11532edeac77b858c51a88cbf59"
}
]
}
GET /sapi/v1/futures/histDataLink
权重(IP):
200
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
交易对，如BTCUSDT或BTCUSD_PERP ｜
dataType
ENUM
YES
T_DEPTH for ticklevel orderbook data, S_DEPTH for orderbook snapshot data
startTime
LONG
YES
endTime
LONG
YES
recvWindow
LONG
NO
timestamp
LONG
YES
startTime与endTime的间隔不可超过7天
生成的下载链接1天内有效
仅VIP用户可以查询此接口
合约策略交易接口
币安合约算法交易API服务，旨在为用户提供一整套的算法交易解决方案，包括：自动执行订单，提高执行透明度和提供智能接口直达市场。
FAQ: 成交量份额参与算法(VP) 介绍
FAQ: 时间加权平均价格策略(Twap) 介绍
成交量份额参与算法(VP)下单 (TRADE)
响应:
{
"clientAlgoId": "00358ce6a268403398bd34eaa36dffe7", //用户自定义策略订单ID
"success": true,
"code": 0,
"msg": "OK"
}
POST /sapi/v1/algo/futures/newOrderVp
发送VP下单
仅支持U本位合约
权重(UID):
3000
注意:
您的 API Key 需要开通 允许合约交易 权限
请使用Base URL: https://api.binance.com
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
交易对 eg. BTCUSDT
side
ENUM
YES
买卖方向 ( BUY or SELL )
positionSide
ENUM
NO
持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT
quantity
DECIMAL
YES
下单数量， 以合约币种（base asset）个数下单; 名义价值 (quantity * 标记价格(base asset)) 需要大于 1,000 USDT，且不超过 1,000,000 USDT
urgency
ENUM
YES
代表当前执行的相对速率; ENUM: LOW（慢）, MEDIUM（中等）, HIGH（快）
clientAlgoId
STRING
NO
必须传入32位，如果未发送，则自动生成
reduceOnly
BOOLEAN
NO
true, false; 非双开模式下默认false；双开模式下不接受此参数； 开仓不接受此参数
limitPrice
DECIMAL
NO
限价单价格; 若未发送，则以市场价下单
recvWindow
LONG
NO
timestamp
LONG
YES
其他信息:
同时运行的Algo策略数量最多为20
杠杆倍数和持仓模式与您的合约账户设置相同，您可以通过合约交易页面设置或者通过fapi设置。
收到 "success": true 不代表您的订单一定会被执行。请通过查询订单接口（GET sapi/v1/algo/futures/openOrders 或者 GET sapi/v1/algo/futures/historicalOrders）以获取订单状态。
例如: 如果您的合约账户余额不足，或者开仓使用了reduce only参数，或者您下单选择的持仓模式与您设置的不符，这些情况您都会收到响应 "success": true，但订单状态会显示为 expired，代表订单过期。
时间加权平均价格策略(Twap)下单 (TRADE)
响应:
{
"clientAlgoId": "65ce1630101a480b85915d7e11fd5078", //用户自定义策略订单ID
"success": true,
"code": 0,
"msg": "OK"
}
POST /sapi/v1/algo/futures/newOrderTwap
发送Twap下单
仅支持U本位合约
权重(UID):
3000
注意:
您的 API Key 需要开通 允许合约交易 权限
请使用Base URL: https://api.binance.com
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
交易对 eg. BTCUSDT
side
ENUM
YES
买卖方向 ( BUY or SELL )
positionSide
ENUM
NO
持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT
quantity
DECIMAL
YES
下单数量， 以合约币种（base asset）个数下单; 名义价值 (quantity * 标记价格(base asset)) 需要大于 1,000 USDT，且不超过 1,000,000 USDT
duration
LONG
YES
请以秒为单位发送[300,86400]
clientAlgoId
STRING
NO
必须传入32位，如果未发送，则自动生成
reduceOnly
BOOLEAN
NO
true, false; 非双开模式下默认false；双开模式下不接受此参数； 开仓不接受此参数
limitPrice
DECIMAL
NO
限价单价格; 若未发送，则以市场价下单
recvWindow
LONG
NO
timestamp
LONG
YES
其他信息:
同时运行的Algo策略数量最多为20
杠杆倍数和持仓模式与您的合约账户设置相同，您可以通过合约交易页面设置或者通过fapi设置。
收到 "success": true 不代表您的订单一定会被执行。请通过查询订单接口（GET sapi/v1/algo/futures/openOrders 或者 GET sapi/v1/algo/futures/historicalOrders）以获取订单状态。
例如: 如果您的合约账户余额不足，或者开仓使用了reduce only参数，或者您下单选择的持仓模式与您设置的不符，这些情况您都会收到响应 "success": true，但订单状态会显示为 expired，代表订单过期。
quantity * 60 / duration 必须大于minQty。
duration 不能小于5分钟，且不能大于24小时。
对于U本位交割合约, TWAP 的结束时间必须早于交割时间1小时。
取消策略订单 (TRADE)
响应:
{
"algoId": 14511, //策略订单ID
"success": true,
"code": 0,
"msg": "OK"
}
DELETE /sapi/v1/algo/futures/order
撤销订单
权重(IP):
1
注意:
您的 API Key 需要开通 允许合约交易 权限
请使用Base URL: https://api.binance.com
参数:
名称
类型
是否必需
描述
algoId
LONG
YES
eg. 14511
recvWindow
LONG
NO
timestamp
LONG
YES
查询当前策略订单挂单 (USER_DATA)
响应:
{
"total": 1,
"orders": [
{
"algoId": 14517, //策略订单ID
"symbol": "ETHUSDT", //交易对
"side": "SELL", //买卖方向
"positionSide": "SHORT", //持仓模式
"totalQty": "5.000", //总共下单数量
"executedQty": "0.000", //执行数量
"executedAmt": "0.00000000", //执行价值
"avgPrice": "0.00", //平均价格
"clientAlgoId": "d7096549481642f8a0bb69e9e2e31f2e", //用户自定义策略订单ID
"bookTime": 1649756817004, //用户下单时间
"endTime": 0, //结束时间
"algoStatus": "WORKING", //策略订单状态
"algoType": "VP", //策略订单类型
"urgency": "LOW" //执行速率
}
]
}
GET /sapi/v1/algo/futures/openOrders
权重(IP):
1
注意:
您的 API Key 需要开通 允许合约交易 权限
请使用Base URL: https://api.binance.com
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询历史策略订单 (USER_DATA)
响应:
{
"total": 1,
"orders": [
{
"algoId": 14518, //策略订单ID
"symbol": "BNBUSDT", //交易对
"side": "BUY", //买卖方向
"positionSide": "BOTH", //持仓模式
"totalQty": "100.00", //总共下单数量
"executedQty": "0.00", //执行数量
"executedAmt": "0.00000000", //执行价值
"avgPrice": "0.000", //平均价格
"clientAlgoId": "acacab56b3c44bef9f6a8f8ebd2a8408", //用户自定义策略订单ID
"bookTime": 1649757019503, //用户下单时间
"endTime": 1649757088101, //结束时间
"algoStatus": "CANCELLED", //策略订单状态
"algoType": "VP", //策略订单类型
"urgency": "LOW" //执行速率
}
]
}
GET /sapi/v1/algo/futures/historicalOrders
权重(IP):
1
注意:
您的 API Key 需要开通 允许合约交易 权限
请使用Base URL: https://api.binance.com
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
交易对 eg. BTCUSDT
side
ENUM
NO
BUY 或者 SELL
startTime
LONG
NO
毫秒级时间戳 eg.1641522717552
endTime
LONG
NO
毫秒级时间戳 eg.1641522526562
page
INT
NO
默认 1
pageSize
INT
NO
最小 1, 最大 100; 默认 100
recvWindow
LONG
NO
timestamp
LONG
YES
查询执行子订单 (USER_DATA)
响应:
{
"total": 1,
"executedQty": "1.000",
"executedAmt": "3229.44000000",
"subOrders": [
{
"algoId": 13723, //策略订单ID
"orderId": 8389765519993908929, //子订单ID
"orderStatus": "FILLED", //子订单状态
"executedQty": "1.000", //执行数量
"executedAmt": "3229.44000000", //执行价值
"feeAmt": "-1.61471999", //手续费
"feeAsset": "USDT", //手续费币种
"bookTime": 1649319001964, //下单时间
"avgPrice": "3229.44", //平均价格
"side": "SELL", //买卖方向
"symbol": "ETHUSDT", //交易对
"subId": 1, //子订单执行顺序ID
"timeInForce": "IMMEDIATE_OR_CANCEL", //有效方式
"origQty": "1.000" //原始委托数量
}
]
}
GET /sapi/v1/algo/futures/subOrders
获取指定 algoId 的相应子订单
权重(IP):
1
注意:
您的 API Key 需要开通 允许合约交易 权限
请使用Base URL: https://api.binance.com
参数:
名称
类型
是否必需
描述
algoId
LONG
YES
page
INT
NO
默认1
pageSize
INT
NO
最小 1， 最大 100; 默认 100
recvWindow
LONG
NO
timestamp
LONG
YES
现货策略交易接口
币安现货算法交易API服务，旨在为用户提供一整套的算法交易解决方案，包括：自动执行订单，提高执行透明度和提供智能接口直达市场。在推广期间，TWAP订单不会有额外手续费，仅收取标准手续费。
时间加权平均价格策略(Twap)下单 (TRADE)
响应:
{
"clientAlgoId": "65ce1630101a480b85915d7e11fd5078", //用户自定义策略订单ID
"success": true,
"code": 0,
"msg": "OK"
}
POST /sapi/v1/algo/spot/newOrderTwap
通过算法服务进行时间加权平均价格策略（TWAP）下单交易
权重(UID):
3000
参数:
名称
类型
是否必需
描述
symbol
STRING
YES
交易对 eg. BTCUSDT
side
ENUM
YES
买卖方向 ( BUY or SELL )
quantity
DECIMAL
YES
下单数量， 以Base资产个数下单; 名义价值 (quantity * 最新价格(base asset)) 需要大于 1,000 USDT，且不超过 100,000 USDT
duration
LONG
YES
请以秒为单位发送[300,86400]；少于 5 分钟 => 默认为 5 分钟；大于 24h => 默认为 24h
clientAlgoId
STRING
NO
必须传入32位，如果未发送，则自动生成
limitPrice
DECIMAL
NO
限价单价格; 若未发送，则以市场价下单
stpMode
ENUM
NO
允许的 ENUM 取决于交易对的配置。支持的值有EXPIRE_TAKER, EXPIRE_MAKER, EXPIRE_BOTH, NONE
recvWindow
LONG
NO
timestamp
LONG
YES
其他信息:
同时运行的Algo策略数量最多为20
取消TWAP策略订单 (TRADE)
响应:
{
"algoId": 14511, //策略订单ID
"success": true,
"code": 0,
"msg": "OK"
}
DELETE /sapi/v1/algo/spot/order
取消正在委托的TWAP订单
权重(IP):
1
参数:
名称
类型
是否必需
描述
algoId
LONG
YES
eg. 14511
recvWindow
LONG
NO
timestamp
LONG
YES
查询当前策略订单挂单 (USER_DATA)
响应:
{
"total": 1,
"orders": [
{
"algoId": 14517, //策略订单ID
"symbol": "ETHUSDT", //交易对
"side": "SELL", //买卖方向
"totalQty": "5.000", //总共下单数量
"executedQty": "0.000", //执行数量
"executedAmt": "0.00000000", //执行价值
"avgPrice": "0.00", //平均价格
"clientAlgoId": "d7096549481642f8a0bb69e9e2e31f2e", //用户自定义策略订单ID
"bookTime": 1649756817004, //用户下单时间
"endTime": 0, //结束时间
"algoStatus": "WORKING", //策略订单状态
"algoType": "VP", //策略订单类型
"urgency": "LOW" //执行速率
}
]
}
GET /sapi/v1/algo/spot/openOrders
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询历史策略订单 (USER_DATA)
响应:
{
"total": 1,
"orders": [
{
"algoId": 14518, //策略订单ID
"symbol": "BNBUSDT", //交易对
"side": "BUY", //买卖方向
"totalQty": "100.00", //总共下单数量
"executedQty": "0.00", //执行数量
"executedAmt": "0.00000000", //执行价值
"avgPrice": "0.000", //平均价格
"clientAlgoId": "acacab56b3c44bef9f6a8f8ebd2a8408", //用户自定义策略订单ID
"bookTime": 1649757019503, //用户下单时间
"endTime": 1649757088101, //结束时间
"algoStatus": "CANCELLED", //策略订单状态
"algoType": "VP", //策略订单类型
"urgency": "LOW" //执行速率
}
]
}
GET /sapi/v1/algo/spot/historicalOrders
查询现货TWAP历史订单
权重(IP):
1
参数:
名称
类型
是否必需
描述
symbol
STRING
NO
交易对 eg. BTCUSDT
side
ENUM
NO
BUY 或者 SELL
startTime
LONG
NO
毫秒级时间戳 eg.1641522717552
endTime
LONG
NO
毫秒级时间戳 eg.1641522526562
page
INT
NO
默认 1
pageSize
INT
NO
最小 1, 最大 100; 默认 100
recvWindow
LONG
NO
timestamp
LONG
YES
查询执行子订单 (USER_DATA)
响应:
{
"total": 1,
"executedQty": "1.000",
"executedAmt": "3229.44000000",
"subOrders": [
{
"algoId": 13723, //策略订单ID
"orderId": 8389765519993908929, //子订单ID
"orderStatus": "FILLED", //子订单状态
"executedQty": "1.000", //执行数量
"executedAmt": "3229.44000000", //执行价值
"feeAmt": "-1.61471999", //手续费
"feeAsset": "USDT", //手续费币种
"bookTime": 1649319001964, //下单时间
"avgPrice": "3229.44", //平均价格
"side": "SELL", //买卖方向
"symbol": "ETHUSDT", //交易对
"subId": 1, //子订单执行顺序ID
"timeInForce": "IMMEDIATE_OR_CANCEL", //有效方式
"origQty": "1.000" //原始委托数量
}
]
}
GET /sapi/v1/algo/spot/subOrders
获取指定 algoId 的相应子订单
权重(IP):
1
参数:
名称
类型
是否必需
描述
algoId
LONG
YES
page
INT
NO
默认1
pageSize
INT
NO
最小 1， 最大 100; 默认 100
recvWindow
LONG
NO
timestamp
LONG
YES
经典统一账户接口
为了给币安合约用户提供更加优质的服务及提高用户的资金利用率，币安将推出经典统一账户计划。该计划将以合约钱包、现货杠杆钱包的总资产作为保证金来计算。
关于经典统一帐户：币安经典统一帐户计划是一项跨资产保证金计划，支持超过 200 种有效的加密资产。 U本位合约、币本位合约以及杠杆钱包中支持的加密资产和头寸将作为有效的联合抵押品，以确定经典统一账户的权益、保证金余额和维持保证金要求。
FAQ: 币安合约经典统一账户总览
仅对特定用户开放此功能，详情：加入经典统一账户计划
查询经典统一账户信息 (USER_DATA)
响应:
{
"uniMMR": "5167.92171923", // 经典统一账户模式维持保证金率
"accountEquity": "122607.35137903", // 经典统一账户总权益，单位为USD
"actualEquity": "142607.35137903", // 不考虑质押率经典统一账户总权益，单位为USD
"accountMaintMargin": "23.72469206", // 经典统一账户维持保证金，即账户开仓及借贷总共需要的维持保证金，单位为USD
"accountStatus": "NORMAL", // 经典统一账户当前账户状态:"NORMAL"正常状态, "MARGIN_CALL"补充保证金, "SUPPLY_MARGIN"再一次补充保证金, "REDUCE_ONLY"触发交易限制, "ACTIVE_LIQUIDATION"手动强制平仓, "FORCE_LIQUIDATION"强制平仓, "BANKRUPTED"破产
"accountType": "PM_1" //PM_1经典统一账户, PM_2统一账户
}
GET /sapi/v1/portfolio/account
权重(IP):
5
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
经典统一账户资产质押率 (MARKET_DATA)
响应：
[
{
"asset": "USDC",
"collateralRate": "1.0000" //质押率
},
{
"asset": "BUSD",
"collateralRate": "1.0000"
},
]
GET /sapi/v1/portfolio/collateralRate
经典统一账户资产质押率
权重(IP):
50
参数：
None
查询经典统一账户穿仓借贷金额 (USER_DATA)
响应：
{
"asset": "BUSD",
"amount": "579.45", // 统一账户用户强平穿仓负债，单位为BUSD
}
GET /sapi/v1/portfolio/pmLoan
查询经典统一账户穿仓借贷金额
权重(UID):
500
参数：
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
如果不存在经典统一账户穿仓负债，amount显示为0
偿还经典统一账户穿仓负债
响应：
{
"tranId": 58203331886213504
}
POST /sapi/v1/portfolio/repay
偿还经典统一账户穿仓负债
权重(UID):
3000
参数：
名称
类型
是否必需
描述
from
STRING
NO
SPOT或MARGIN，默认SPOT
recvWindow
LONG
NO
timestamp
LONG
YES
查询经典统一账户期货负余额收息历史(USER_DATA)
响应：
[
{
"asset": "USDT",
"interest": "24.4440", //利息金额
"interestAccruedTime": 1670227200000,
"interestRate": "0.0001164", //日利率
"principal": "210000"
}
]
GET /sapi/v1/portfolio/interest-history
查询经典统一账户期货负余额收息历史
权重(IP):
50
参数：
名称
类型
是否必需
描述
asset
STRING
NO
startTime
LONG
NO
起始时间
endTime
LONG
NO
结束时间
size
LONG
NO
返回的结果集数量 默认值:10 最大值:100
recvWindow
LONG
NO
timestamp
LONG
YES
查询统一账户资产价格指数(MARKET_DATA)
响应：
[
{
"asset": "BTC",
"assetIndexPrice": "28251.9136906", //USD价格指数
"time": 1683518338121
}
]
GET /sapi/v1/portfolio/asset-index-price
查询统一账户资产价格指数
权重(IP):
传asset为1 或不传asset*50*
参数：
名称
类型
是否必需
描述
asset
STRING
NO
资金归集(USER_DATA)
响应：
{
"msg": "success"
}
POST /sapi/v1/portfolio/auto-collection
账户资金归集，将除BNB外资产从合约账户划转到杠杆账户
权重(IP):
1500
参数：
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
本接口不会划转BNB资产
本接口每小时仅能被调用500次（滚动计算）
特定资产资金归集(USER_DATA)
响应：
{
"msg": "success"
}
POST /sapi/v1/portfolio/asset-collection
特定资产账户资金归集，从合约账户划转到杠杆账户
权重(IP):
60
参数：
名称
类型
是否必需
描述
asset
STRING
YES
recvWindow
LONG
NO
timestamp
LONG
YES
本接口不支持划转BNB资产
BNB划转(USER_DATA)
响应：
{
"tranId": 100000001
}
POST /sapi/v1/portfolio/bnb-transfer
BNB在杠杆账户和USD-M期货账户划转
权重(IP):
1500
参数：
名称
类型
是否必需
描述
amount
DECIMAL
YES
transferSide
STRING
YES
"TO_UM","FROM_UM"
recvWindow
LONG
NO
timestamp
LONG
YES
本接口每10分钟仅可以调用2次
更改自动清还合约负余额模式(TRADE)
响应：
{
"msg": "success"
}
POST /sapi/v1/portfolio/repay-futures-switch
更改自动支付合约负余额模式 (HMAC SHA256)
权重(IP):
1500
参数：
名称
类型
是否必需
描述
autoRepay
STRING
YES
默认为true; false代表关闭自动清还合约负余额
recvWindow
LONG
NO
timestamp
LONG
YES
查询自动清还合约负余额模式(USER_DATA)
响应：
{
"autoRepay": true // `true`代表自动清还合约负余额; `false`代表关闭自动清还合约负余额
}
GET /sapi/v1/portfolio/repay-futures-switch
查询自动清还合约负余额模式
权重(IP):
30
参数：
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
清还合约负余额(USER_DATA)
响应：
{
"msg": "success"
}
POST /sapi/v1/portfolio/repay-futures-negative-balance
清还合约负余额
权重(IP):
1500
参数：
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
查询统一账户资产支持杠杆倍数(USER_DATA)
响应：
[
{
"asset": "USDC",
"leverage": 10
},
{
"asset": "USDT",
"leverage": 10
}
]
GET /sapi/v1/portfolio/margin-asset-leverage
权重(IP):
50
杠杆代币接口杠杆代币信息 (MARKET_DATA)
响应:
[
{
"tokenName": "BTCDOWN",
"description": "3X Short Bitcoin Token",
"underlying": "BTC",
"tokenIssued": "717953.95",
"basket": "-821.474 BTCUSDT Futures",
"currentBaskets":[
{
"symbol":"BTCUSDT",
"amount":"-1183.984",
"notionalValue":"-22871089.96704"
}
],
"nav": "4.79",
"realLeverage": "-2.316",
"fundingRate": "0.001020",
"dailyManagementFee": "0.0001",
"purchaseFeePct": "0.0010", // 申购费率
"dailyPurchaseLimit": "100000.00", //每日申购数量上限
"redeemFeePct": "0.0010", // 赎回费率
"dailyRedeemLimit": "1000000.00", //每日赎回数量上限
"timestamp":1583127900000
},
{
"tokenName": "LINKUP",
"description": "3X LONG ChainLink Token",
"underlying": "LINK",
"tokenIssued": "163846.99",
"basket": "417288.870 LINKUSDT Futures",
"currentBaskets":[
{
"symbol":"LINKUSDT",
"amount":"1640883.83",
"notionalValue":"22596611.22293"
}
],
"nav": "9.60",
"realLeverage": "2.597",
"fundingRate": "-0.000917",
"dailyManagementFee": "0.0001",
"purchaseFeePct": "0.0010",
"dailyPurchaseLimit": "100000.00",
"redeemFeePct": "0.0010",
"dailyRedeemLimit": "1000000.00",
"timestamp":1583127900000
},
]
GET /sapi/v1/blvt/tokenInfo
权重(IP):
1
参数:
名称
类型
是否必需
描述
tokenName
STRING
NO
BTCDOWN, BTCUP
杠杆代币历史净值K线
杠杆代币净值系统基于合约架构，故该接口采用fapi
请前往这里查看相关接口，并按照fapi使用规范操作。
申购代币 (USER_DATA)
响应:
{
"id": 123,
"status": "S", // S, P, F 分别表示 "success", "pending", "failure"
"tokenName": "LINKUP",
"amount": "0.95590905", // 申购代币数量
"cost": "9.99999995", // 申购金额
"timestamp":1600249972899
}
POST /sapi/v1/blvt/subscribe
权重(IP):
1
参数:
名称
类型
是否必需
描述
tokenName
STRING
YES
BTCDOWN, BTCUP
cost
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
查询申购记录 (USER_DATA)
响应:
[
{
"id": 1,
"tokenName": "LINKUP",
"amount": "0.54216292",
"nav": "18.42621386", // usdt计价的申购净值
"fee": "0.00999000", // usdt计价的申购费用
"totalCharge": "9.99999991", //usdt计价的申购总金额
"timestamp":1599127217916
}
]
GET /sapi/v1/blvt/subscribe/record
权重(IP):
1
参数:
名称
类型
是否必需
描述
tokenName
STRING
NO
BTCDOWN, BTCUP
id
LONG
NO
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 1000, 最大 1000
recvWindow
LONG
NO
timestamp
LONG
YES
只可查询最近90天记录
赎回代币 (USER_DATA)
响应:
{
"id": 123,
"status": "S", // S, P, F 分别表示 "success", "pending", "failure"
"tokenName": "LINKUP",
"redeemAmount": "0.95590905", // 赎回代币数量
"amount": "10.05022099", // usdt计价的赎回金额
"timestamp":1600250279614
}
POST /sapi/v1/blvt/redeem
权重(IP):
1
参数:
名称
类型
是否必需
描述
tokenName
STRING
YES
BTCDOWN, BTCUP
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
您需要为API Key开通允许现货和杠杆交易权限才能发送此请求
查询赎回记录 (USER_DATA)
响应:
[
{
"id": 1,
"tokenName": "LINKUP",
"amount": "0.54216292", // 赎回数量
"nav": "18.36345064", // usdt计价的赎回净值
"fee": "0.00995598", // usdt计价的赎回费用
"netProceed": "9.94602604", // usdt计价的净赎回金额
"timestamp":1599128003050
}
]
GET /sapi/v1/blvt/redeem/record
权重(IP):
1
参数:
名称
类型
是否必需
描述
tokenName
STRING
NO
BTCDOWN, BTCUP
id
LONG
NO
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 1000, 最大 1000
recvWindow
LONG
NO
timestamp
LONG
YES
只可查询最近90天记录
查询用户每日申购赎回限额 (USER_DATA)
响应:
[
{
"tokenName": "LINKUP",
"userDailyTotalPurchaseLimit": "1000", //用户个人每日申购数量上限（USDT)
"userDailyTotalRedeemLimit": "1000" //用户个人每日赎回数量上限 (USDT)
},
{
"tokenName": "LINKDOWN",
"userDailyTotalPurchaseLimit": "1000", //用户个人每日申购数量上限（USDT)
"userDailyTotalRedeemLimit": "50000" //用户个人每日赎回数量上限 (USDT)
}
]
GET /sapi/v1/blvt/userLimit
权重(IP):
1
参数:
名称
类型
是否必需
描述
tokenName
STRING
NO
BTCDOWN, BTCUP
recvWindow
LONG
NO
timestamp
LONG
YES
Websocket 杠杆代币信息更新
Payload:
{
"e":"nav", // 事件类型
"E":1600245286355, // 事件时间
"s":"TRXDOWN", // 杠杆代币
"m":74164.75496502663, //已发行代币
"b":[ // 篮子
{
"s":"TRXUSDT", // 合约交易对
"n":-87988261 // 持仓数量
}
],
"n":14.78454447, // 净值
"l":2.1786579638117898, // 真实杠杆
"t":3, // 目标杠杆
"f":-0.0048925 // 资金费率
}
Stream 名称:
注意: 您需要使用 wss://nbstream.binance.com/lvt-p 来监听该数据流
注意: tokenName 请使用大写字母，例如"TRXDOWN@tokenNav"
更新速度: 3s
Websocket 杠杆代币净值K线更新
Payload:
{
"e":"kline", // 事件类型
"E":1600243159447, // 事件时间
"s":"TRXDOWN", // 杠杆代币
"k":{
"t":1600243140000, // 这根K线的起始时间
"T":1600243199999, // 这根K线的结束时间
"s":"TRXDOWN", // 杠杆代币
"i":"1m", // K线间隔
"f":1600243140484, //这根K线期间第一笔净值更新时间
"L":1600243159424, //这根K线期间末一笔净值更新时间
"o":"14.56800297", // 这根K线期间第一笔净值
"c":"14.59766270", // 这根K线期间末一笔净值
"h":"14.63325437", // 这根K线期间最高净值
"l":"14.56207102", // 这根K线期间最低净值
"v":"2.22524220", // 真实杠杆倍数
"n":33, // 这根K线期间更新的净值次数
"x":false, // 忽略此参数
"q":"0", // 忽略此参数
"V":"73.42663923", // 忽略此参数
"Q":"0", // 忽略此参数
"B":"0" // 忽略此参数
}
}
Stream 名称:
注意: 您需要使用 wss://nbstream.binance.com/lvt-p 来监听该数据流
注意: tokenName 请使用大写字母，例如"TRXDOWN@nav_kline_1d"
更新速度: 300ms
K线图间隔参数:
m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月
1m
3m
5m
15m
30m
1h
2h
4h
6h
8h
12h
1d
3d
1w
1M
法币接口获取法币充值/提现历史记录 (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": [
{
"orderNo":"7d76d611-0568-4f43-afb6-24cac7767365",
"fiatCurrency": "BRL", // 法币token
"indicatedAmount": "10.00", // 交易金额
"amount": "10.00", // 实际金额（扣除手续费）
"totalFee": "0.00", // 交易手续费
"method": "BankAccount", // 交易方式
"status": "Expired", // Processing, Failed, Successful, Finished, Refunding, Refunded, Refund Failed, Order Partial credit Stopped
"createTime": 1626144956000, // 订单创建时间
"updateTime": 1626400907000 // 订单更新时间
}
],
"total": 1,
"success": true
}
GET /sapi/v1/fiat/orders
权重(UID):
90000
参数:
名称
类型
是否必需
描述
transactionType
STRING
YES
0-deposit,1-withdraw
beginTime
LONG
NO
endTime
LONG
NO
page
INT
NO
默认 1
rows
INT
NO
默认 100, 最大 500
recvWindow
LONG
NO
timestamp
LONG
YES
若 beginTime和endTime均未发送,只返回最近30天数据
获取法币支付历史记录 (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": [
{
"orderNo": "353fca443f06466db0c4dc89f94f027a",
"sourceAmount": "20.0", // 法币交易数量
"fiatCurrency": "EUR", // 法币token
"obtainAmount": "4.462", // 数字货币交易数量
"cryptoCurrency": "LUNA", // 数字货币token
"totalFee": "0.2", // 交易手续费
"price": "4.437472", // 价格
"status": "Failed", // Processing处理中, Completed完成, Failed失败, Refunded退款
"paymentMethod": "Credit Card",
"createTime": 1624529919000, // 订单创建时间
"updateTime": 1624529919000 // 订单更新时间
}
],
"total": 1,
"success": true
}
GET /sapi/v1/fiat/payments
Weight(IP):
1
Parameters:
名称
类型
是否必需
描述
transactionType
STRING
YES
0-buy,1-sell
beginTime
LONG
NO
endTime
LONG
NO
page
INT
NO
默认 1
rows
INT
NO
默认 100, 最大 500
recvWindow
LONG
NO
timestamp
LONG
YES
若beginTime和endTime均未发送,只返回最近30天数据
paymentMethod：只有调用购买的历史纪录时（transactionType=0），回传值会有购买方式。目前有四种值：
Cash Balance
Credit Card
Online Banking
Bank Transfer
C2C 接口获取 C2C 交易历史记录 (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": [
{
"orderNumber":"20219644646554779648",
"advNo": "11218246497340923904",
"tradeType": "SELL",
"asset": "BUSD",
"fiat": "CNY",
"fiatSymbol": "￥",
"amount": "5000.00000000", // Quantity (in Crypto)
"totalPrice": "33400.00000000",
"unitPrice": "6.68", // Unit Price (in Fiat)
"orderStatus": "COMPLETED", // PENDING, TRADING, BUYER_PAYED, DISTRIBUTING, COMPLETED, IN_APPEAL, CANCELLED, CANCELLED_BY_SYSTEM
"createTime": 1619361369000,
"commission": "0", // Transaction Fee (in Crypto)
"counterPartNickName": "阿涛❤***",
"advertisementRole": "TAKER"
}
],
"total": 1,
"success": true
}
GET /sapi/v1/c2c/orderMatch/listUserOrderHistory
权重(IP):
1
参数:
名称
类型
是否必需
描述
tradeType
STRING
YES
BUY, SEll
startTimestamp
LONG
NO
endTimestamp
LONG
NO
page
INT
NO
default 1
rows
INT
NO
default 100, max 100
recvWindow
LONG
NO
timestamp
LONG
YES
若startTimestamp和endTimestamp均未发送,只返回最近30天数据。
startTimestamp和endTimestamp的最大时间间隔为30天。
只能查询最近 6 个月的数据。如果需要产看全部C2C订单，你可以前往 https://c2c.binance.com/zh-CN/fiatOrder
VIP借币接口查询VIP借币借款中订单 (USER_DATA)
响应:
{
"rows": [
{
"orderId": 100000001,
"loanCoin": "BUSD",
"totalDebt": "10000",
"loanRate": "0.0123", // 浮动利率为"flexible rate"
"residualInterest": "10.27687923",
"collateralAccountId": "12345678,23456789",
"collateralCoin": "BNB,BTC,ETH",
"totalCollateralValueAfterHaircut": "25000.27565492",
"lockedCollateralValue": "25000.27565492",
"currentLTV": "0.57",
"expirationTime": 1575018510000,
"loanDate": "1676851200000",
"loanTerm": "30days", // 活期则为"open term"
"expirationTime": 1575018510000 // 活期则为0
"initialLtv": "72%",
"marginCallLtv": "77%",
"liquidationLtv": "91%"
}
],
"total": 1
}
GET /sapi/v1/loan/vip/ongoing/orders
VIP借币仅对VIP用户开放
权重(IP):
400
参数:
名称
类型
是否必需
描述
orderId
LONG
NO
collateralAccountId
LONG
NO
loanCoin
STRING
NO
collateralCoin
STRING
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1，最大：1000
limit
LONG
NO
默认值：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
VIP借币还款 (TRADE)
响应:
{
"loanCoin": "BUSD",
"repayAmount": "200.5",
"remainingPrincipal": "100.5",
"remainingInterest": "0",
"collateralCoin": "BNB,BTC,ETH",
"currentLTV": "0.25",
"repayStatus": "Repaid" // Repaid, Repaying, Failed
}
POST /sapi/v1/loan/vip/repay
VIP借币仅对VIP用户开放
权重(UID):
6000
参数:
名称
类型
是否必需
描述
orderId
LONG
YES
amount
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
查询VIP借币还款记录历史 (USER_DATA)
响应:
{
"rows": [
{
"loanCoin": "BUSD",
"repayAmount": "10000",
"collateralCoin": "BNB,BTC,ETH",
"repayStatus": "Repaid", // Repaid, Repaying, Failed
"loanDate": "1676851200000",
"repayTime": "1575018510000",
"orderId": "756783308056935434"
}
],
"total": 1
}
GET /sapi/v1/loan/vip/repay/history
VIP借币仅对VIP用户开放
权重(IP):
400
参数:
名称
类型
是否必需
描述
orderId
LONG
NO
loanCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1，最大：1000
limit
LONG
NO
默认值：10，最大：100
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
VIP 借币续期 (TRADE)
响应:
{
"loanAccountId": "12345678",
"loanCoin": "BTC",
"loanAmount": "100.55",
"collateralAccountId": "12345677,12345678,12345679",
"collateralCoin": "BUSD,USDT,ETH",
"loanTerm": "30",
}
POST /sapi/v1/loan/vip/renew
VIP借币仅对VIP用户开放
权重(UID):
6000
参数:
名称
类型
是否必需
描述
orderId
LONG
YES
loanTerm
INT
NO
30/60 天
recvWindow
LONG
NO
timestamp
LONG
YES
查询VIP子账户冻结抵押物金额 (USER_DATA)
响应:
{
"rows": [
{
"collateralAccountId": "12345678",
"collateralCoin": "BNB,BTC,ETH",
}
],
[
{
"collateralAccountId": "23456789",
"collateralCoin": "BNB,BTC,ETH",
}
],
"total": 2
}
GET /sapi/v1/loan/vip/collateral/account
VIP借币仅对VIP用户开放
权重(IP):
6000
参数:
名称
类型
是否必需
描述
orderId
LONG
NO
collateralAccountId
LONG
NO
recvWindow
LONG
NO
timestamp
LONG
YES
如登陆账户为借贷账户，可查询该借贷账户下，对应的所有抵押账户。
如登陆账户为抵押账户，只可查询该抵押账户的抵押币种。
VIP 借币借款 (TRADE)
响应:
{
"loanAccountId": "12345678",
"requestId": "12345678",
"loanCoin": "BTC",
"isFlexibleRate": "No",
"loanAmount": "100.55",
"collateralAccountId": "12345678,12345678,12345678",
"collateralCoin": "BUSD,USDT,ETH",
"loanTerm": "30"
}
或
{
"loanAccountId": "12345678",
"requestId": "12345678",
"loanCoin": "BTC",
"isFlexibleRate": "Yes",
"loanAmount": "100.55",
"collateralAccountId": "12345678,12345678,12345678",
"collateralCoin": "BUSD,USDT,ETH"
}
POST /sapi/v1/loan/vip/borrow
VIP借币仅对VIP用户开放
权重(UID):
6000
频率限制: 1次/2秒/UID
参数:
名称
类型
是否必需
描述
loanAccountId
LONG
YES
loanCoin
STRING
YES
loanAmount
DECIMAL
YES
collateralAccountId
STRING
YES
多个用,分割
collateralCoin
STRING
YES
多个用,分割
isFlexibleRate
BOOLEAN
YES
默认：TRUE. TRUE: 浮动利率；FALSE：固定利率
loanTerm
INT
NO
选择固定利率时此为必填选项；选择浮动利率时选填：30/60 days
recvWindow
LONG
NO
timestamp
LONG
YES
loanAccountId指的是贷款接收账户
仅支持主账户申请
loanAccountId 和 collateralAccountId 处于同一主账户体系之下
loanTerm在固定利率时是必填选项
查询VIP借币可借币种数据(USER_DATA)
响应:
{
"rows": [
{
"loanCoin": "BUSD",
"_flexibleHourlyInterestRate": "0.000103",
"_flexibleYearlyInterestRate": "0.548595",
"_30dDailyInterestRate": "0.000136",
"_30dYearlyInterestRate": "0.03450",
"_60dDailyInterestRate": "0.000145",
"_60dYearlyInterestRate": "0.04103",
"minLimit": "100"
"maxLimit": "1000000"
"vipLevel": 1
}
],
"total": 1
}
GET /sapi/v1/loan/vip/loanable/data
获取可借币种的利率和借贷限额。借入限额以美元价值显示。
权重(IP):
400
参数:
名称
类型
是否必需
描述
loanCoin
STRING
NO
vipLevel
INT
NO
默认值：用户的VIP等级
recvWindow
LONG
NO
timestamp
LONG
YES
查询VIP借币抵押币种数据（USER_DATA）
响应:
{
"rows": [
{
"collateralCoin": "BUSD",
"_1stCollateralRatio": "100%",
"_1stCollateralRange": "1-10000000",
"_2ndCollateralRatio": "80%",
"_2ndCollateralRange": "10000000-100000000",
"_3rdCollateralRatio": "60%",
"_3rdCollateralRange": "100000000-1000000000",
"_4thCollateralRatio": "0%",
"_4thCollateralRange": ">10000000000",
}
],
"total": 1
}
GET /sapi/v1/loan/vip/collateral/data
查询VIP借币抵押币种数据
权重(IP):
400
参数:
名称
类型
是否必需
描述
collateralCoin
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
查询申请状态（USER_DATA）
响应:
{
"rows": [
{
"loanAccountId": "12345678", //loan receiving account
"orderId": "12345678",
"requestId": "12345678",
"loanCoin": "BTC",
"loanAmount": "100.55",
"collateralAccountId": "12345678,12345678,12345678",
"collateralCoin": "BUSD,USDT,ETH",
"loanTerm": "30",
"status": "Repaid" // Accruing_Interest, Overdue, Liquidating, Repaying, Repaid, Liquidated, Pending, Failed
}
],
"total": 1
}
GET /sapi/v1/loan/vip/request/data
权重(UID):
400
频率限制: 1次/秒/UID
参数:
名称
类型
是否必需
描述
current
LONG
NO
目前查询的页面。从1开始，默认：1，最大：1000
limit
LONG
NO
默认: 10, 最大: 100
recvWindow
LONG
NO
timestamp
LONG
YES
查询借款利率（USER_DATA）
响应:
[
{
"asset": "BUSD",
"flexibleDailyInterestRate": "0.001503",
"flexibleYearlyInterestRate": "0.548595",
"time": 1577233578000
},
{
"asset": "BTC",
"flexibleDailyInterestRate": "0.001503",
"flexibleYearlyInterestRate": "0.548595",
"time": 1577233562000
}
]
GET /sapi/v1/loan/vip/request/interestRate
权重(UID):
400
参数:
名称
类型
是否必需
描述
loanCoin
STRING
YES
最多10个币种, 多个用","隔开
recvWindow
LONG
NO
timestamp
LONG
YES
质押借币接口获取质押借币资金流水 (USER_DATA)
响应:
[
{
"asset": "BUSD",
"type": "borrowIn",
"amount": "100",
"timestamp": 1633771139847,
"tranId": "80423589583"
},
{
"asset": "BUSD",
"type": "borrowIn",
"amount": "100",
"timestamp": 1634638371496,
"tranId": "81685123491"
}
]
GET /sapi/v1/loan/income
权重(UID):
6000
参数:
名称
类型
是否必需
描述
asset
STRING
NO
type
STRING
NO
默认返回所有类型 枚举值：借入 borrowIn,抵押金使用collateralSpent, 还款金额repayAmount, 抵押物返还collateralReturn, 增加抵押物addCollateral, 减少抵押物removeCollateral, 强平后返还抵押物collateralReturnAfterLiquidation
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 20, 最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
若startTime和endTime均未发送,只返回最近7天数据
startTime和endTime的最大时间间隔为30天
借币 - 质押借币借贷 (TRADE)
响应：
{
"loanCoin": "BUSD",
"loanAmount": "100.5",
"collateralCoin": "BNB",
"collateralAmount": "50.5",
"hourlyInterestRate": "0.001234",
"orderId": "100000001"
}
POST /sapi/v1/loan/borrow
权重（UID）：
36000
频率限制: 1次/秒/UID
参数：
名称
类型
是否必需
描述
loanCoin
STRING
YES
loanAmount
DECIMAL
NO
当collateralAmount为空时，需必填
collateralCoin
STRING
YES
collateralAmount
DECIMAL
NO
当loanAmount为空时，需必填
loanTerm
INT
YES
7/30 天
recvWindow
LONG
NO
timestamp
LONG
YES
借币 - 查询质押借币历史记录 (USER_DATA)
响应：
{
"rows": [
{
"orderId": 100000001,
"loanCoin": "BUSD",
"initialLoanAmount": "10000",
"hourlyInterestRate": "0.000057"
"loanTerm": "7"
"collateralCoin": "BNB",
"initialCollateralAmount": "49.27565492"
"borrowTime": 1575018510000
"status": "Repaid" // Accruing_Interest, Overdue, Liquidating, Repaying, Repaid, Liquidated, Pending, Failed
}
],
"total": 1
}
GET /sapi/v1/loan/borrow/history
权重（IP）：
400
参数：
名称
类型
是否必需
描述
orderId
LONG
NO
POST /sapi/v1/loan/borrow 中的 orderId
loanCoin
STRING
NO
collateralCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
借币 - 查询借款中订单列表 (USER_DATA)
响应：
{
"rows": [
{
"orderId": 100000001,
"loanCoin": "BUSD",
"totalDebt": "10000",
"residualInterest":"10.27687923"
"collateralCoin": "BNB",
"collateralAmount": "49.27565492"
"currentLTV": "0.57"
"expirationTime": 1575018510000
}
],
"total": 1
}
GET /sapi/v1/loan/ongoing/orders
权重（IP）：:
300
参数：
名称
类型
是否必需
描述
orderId
LONG
NO
loanCoin
STRING
NO
collateralCoin
STRING
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
还款 - 质押借币还款 (TRADE)
响应：
{
"loanCoin": "BUSD"
"remainingPrincipal": "100.5"
"remainingInterest": "0"
"collateralCoin": "BNB"
"remainingCollateral": "5.253"
"currentLTV": "0.25"
"repayStatus": "Repaid" // Repaid, Repaying
}
or
{
"loanCoin": "BUSD"
"collateralCoin": "BNB"
"repayStatus": "Repaying" // Repaid, Repaying
}
POST /sapi/v1/loan/repay
权重（UID）：
6000
参数：
名称
类型
是否必需
描述
orderId
LONG
YES
amount
DECIMAL
YES
type
INT
NO
默认值：1。 1：用借贷币还款；2：用抵押币还款。
collateralReturn
BOOLEAN
NO
默认值：TRUE。TRUE：多余的抵押金退回现货钱包；FALSE: 多余的抵押金保留在原订单里。
recvWindow
LONG
NO
timestamp
LONG
YES
还款 - 查询还款记录历史 (USER_DATA)
响应：
{
"rows": [
{
"loanCoin": "BUSD",
"repayAmount": "10000",
"collateralCoin": "BNB",
"collateralUsed": "0"
"collateralReturn": "49.27565492"
"repayType": "1" // 1 for "repay with borrowed coin", 2 for "repay with collateral"
"repayStatus": "Repaid" // Repaid, Repaying, Failed
"repayTime": 1575018510000
"orderId": 756783308056935434
}
],
"total": 1
}
GET /sapi/v1/loan/repay/history
权重（IP）：
400
参数：
名称
类型
是否必需
描述
orderId
LONG
NO
loanCoin
STRING
NO
collateralCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
调整质押率 - 质押借币调整质押率 (TRADE)
响应：
{
"loanCoin": "BUSD",
"collateralCoin": "BNB",
"direction": "ADDITIONAL",
"amount": "5.235",
"currentLTV": "0.52"
}
POST /sapi/v1/loan/adjust/ltv
权重（UID）：
6000
参数：
名称
类型
是否必需
描述
orderId
LONG
YES
amount
DECIMAL
YES
direction
ENUM
YES
"ADDITIONAL", "REDUCED"
recvWindow
LONG
NO
timestamp
LONG
YES
调整质押率 - 查询质押率调整历史 (USER_DATA)
响应：
{
"rows": [
{
"loanCoin": "BUSD",
"collateralCoin": "BNB",
"direction": "ADDITIONAL",
"amount": "5.235",
"preLTV": "0.78",
"afterLTV": "0.56",
"adjustTime": 1575018510000,
"orderId": 756783308056935434
}
],
"total": 1
}
GET /sapi/v1/loan/ltv/adjustment/history
权重（IP）：
400
参数：
名称
类型
是否必需
描述
orderId
LONG
NO
loanCoin
STRING
NO
collateralCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
查询可借币种数据 (USER_DATA)
响应：
{
"rows": [
{
"loanCoin": "BUSD",
"_7dHourlyInterestRate": "0.00000491",
"_7dDailyInterestRate": "0.000118",
"_14dHourlyInterestRate": "0.00000491",
"_14dDailyInterestRate": "0.000118",
"_30dHourlyInterestRate": "0.00000567",
"_30dDailyInterestRate": "0.000136",
"_90dHourlyInterestRate": "0.00000596",
"_90dDailyInterestRate": "0.000143",
"_180dHourlyInterestRate": "0.00000631",
"_180dDailyInterestRate": "0.000151",
"minLimit": "100"
"maxLimit": "1000000"
"vipLevel": 1
}
],
"total": 1
}
GET /sapi/v1/loan/loanable/data
获取可借币种的利率和借贷限额。借入限额以美元价值显示。
权重（IP）：
400
频率限制: 1次/2秒/UID
参数：
名称
类型
是否必需
描述
loanCoin
STRING
NO
vipLevel
INT
NO
默认：用户当前VIP等级。如有特殊配置，则填“-1”查询
recvWindow
LONG
NO
timestamp
LONG
YES
查询抵押币种数据 (USER_DATA)
响应：
{
"rows": [
{
"collateralCoin": "BNB",
"initialLTV": "0.65",
"marginCallLTV": "0.75",
"liquidationLTV": "0.83",
"maxLimit": "1000000"
"vipLevel": 1
}
],
"total": 1
}
GET /sapi/v1/loan/collateral/data
获取抵押币种质押率信息和质押限额。质押限额以美元价值显示。
权重（IP）：
400
频率限制: 1次/2秒/UID
参数：
名称
类型
是否必需
描述
collateralCoin
STRING
NO
vipLevel
INT
NO
默认：用户当前VIP等级。如有特殊配置，则填“-1”查询
recvWindow
LONG
NO
timestamp
LONG
YES
查询抵押币种还款汇率 (USER_DATA)
响应：
{
"loanlCoin": "BUSD",
"collateralCoin": "BNB",
"repayAmount": "1000",
"rate": "300.36781234" // 抵押/借贷币种的汇率价格
}
GET /sapi/v1/loan/repay/collateral/rate
获取抵押物还款时，抵押/借贷币种的汇率价格。汇率价格有效时间为8秒。
权重（IP）：
6000
参数：
名称
类型
是否必需
描述
loanCoin
STRING
YES
collateralCoin
STRING
YES
repayAmount
DECIMAL
YES
以借贷币种为单位的还款金额
recvWindow
LONG
NO
timestamp
LONG
YES
质押借币自定义补仓质押率 (TRADE)
响应：
{
"rows": [
{
"orderId": "100000001"
"collateralCoin": "BNB"
"preMarginCall": "0.8"
"afterMarginCall": "0.7"
"customizeTime": 1575018510000
}
],
"total": 1
}
POST /sapi/v1/loan/customize/margin_call
仅可针对进行中订单，自定义补仓质押率。
权重（UID）：
6000
参数：
名称
类型
是否必需
描述
orderId
LONG
NO
当collateralCoin为空时，需必填。orderId或collateralCoin只需传一个，如果两个参数同时传，以orderId为准。
collateralCoin
STRING
NO
当orderID为空时，需必填。orderId或collateralCoin只需传一个，如果两个参数同时传，以orderId为准。
marginCall
DECIMAL
YES
recvWindow
LONG
NO
timestamp
LONG
YES
借币 - 活期借币借贷 (TRADE)
响应:
{
"loanCoin": "BUSD",
"loanAmount": "100.5",
"collateralCoin": "BNB",
"collateralAmount": "50.5",
"status": "Succeeds" //Succeeds, Failed, Processing
}
POST /sapi/v1/loan/flexible/borrow(已停用)
请更换为:
POST /sapi/v2/loan/flexible/borrow
权重(UID): 6000
频率限制: 1次/2秒/UID
参数:
名称
类型
是否必须
描述
loanCoin
STRING
YES
loanAmount
DECIMAL
NO
当collateralAmount为空时，需必填
collateralCoin
STRING
YES
collateralAmount
DECIMAL
NO
当loanAmount为空时，需必填
recvWindow
LONG
NO
timestamp
LONG
YES
仅支持主账户申请
借币 - 查询活期借款中订单列表 (USER_DATA)
响应:
{
"rows": [
{
"loanCoin": "BUSD",
"totalDebt": "10000",
"collateralCoin": "BNB",
"collateralAmount": "49.27565492",
"currentLTV": "0.57"
}
],
"total": 1
}
GET /sapi/v1/loan/flexible/ongoing/orders(将被停用)
请更换为:
GET /sapi/v2/loan/flexible/ongoing/orders
权重(IP): 300
参数:
名称
类型
是否必须
描述
loanCoin
STRING
NO
collateralCoin
STRING
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
借币 - 查询活期借币历史记录 (USER_DATA)
响应:
{
"rows": [
{
"loanCoin": "BUSD",
"initialLoanAmount": "10000",
"collateralCoin": "BNB",
"initialCollateralAmount": "49.27565492",
"borrowTime": 1575018510000,
"status": "Succeeds" //Succeeds, Failed, Processing
}
],
"total": 1
}
GET /sapi/v1/loan/flexible/borrow/history(将被停用)
请更换为:
GET /sapi/v2/loan/flexible/borrow/history
权重(IP): 400
参数:
名称
类型
是否必须
描述
loanCoin
STRING
NO
collateralCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
还款 - 活期借币还款 (TRADE)
响应:
{
"loanCoin": "BUSD",
"collateralCoin": "BNB",
"remainingDebt": "100.5",
"remainingCollateral": "5.253",
"fullRepayment": false,
"currentLTV": "0.25",
"repayStatus": "Repaid" // Repaid, Repaying, Failed
}
POST /sapi/v1/loan/flexible/repay(将被停用)
请更换为:
POST /sapi/v2/loan/flexible/repay
权重(UID): 6000
参数:
名称
类型
是否必须
描述
loanCoin
STRING
YES
collateralCoin
DECIMAL
YES
repayAmount
DECIMAL
YES
collateralReturn
BOOLEAN
NO
默认: TRUE. TRUE: 多余的抵押金退回理财钱包；FALSE: 多余的抵押金保留在原订单里，降低LTV
fullRepayment
BOOLEAN
NO
默认: FALSE. TRUE: 全部偿还; FALSE: 按照loanAmount金额部分偿还
recvWindow
LONG
NO
timestamp
LONG
YES
repayAmount是必填项，即便fullRepayment = FALSE
还款 - 查询活期借币还款记录历史 (USER_DATA)
相应:
{
"rows": [
{
"loanCoin": "BUSD",
"repayAmount": "10000",
"collateralCoin": "BNB",
"collateralReturn": "49.27565492",
"repayStatus": "Repaid", // Repaid, Repaying, Failed
"repayTime": 1575018510000
}
],
"total": 1
}
GET /sapi/v1/loan/flexible/repay/history(将被停用)
请更换为:
GET /sapi/v2/loan/flexible/repay/history
权重(IP): 400
参数:
名称
类型
是否必须
描述
loanCoin
STRING
NO
collateralCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
当前查询页数，从1开始。默认值：1；最大：1000。
limit
LONG
NO
默认值：10；最大：100。
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
调整质押率 - 活期借币调整质押率 (TRADE)
响应:
{
"loanCoin": "BUSD",
"collateralCoin": "BNB",
"direction": "ADDITIONAL",
"adjustmentAmount": "5.235",
"currentLTV": "0.52"
}
POST /sapi/v1/loan/flexible/adjust/ltv(将被停用)
请更换为:
POST /sapi/v2/loan/flexible/adjust/ltv
权重(UID): 6000
频率限制: 1次/2秒/UID
参数:
名称
类型
是否必须
描述
loanCoin
STRING
YES
collateralCoin
STRING
YES
adjustmentAmount
DECIMAL
YES
direction
ENUM
YES
"ADDITIONAL", "REDUCED"
recvWindow
LONG
NO
timestamp
LONG
YES
接口需要现货杠杆交易权限以使用此接口
调整质押率 - 查询活期借币质押率调整历史
响应:
{
"rows": [
{
"loanCoin": "BUSD",
"collateralCoin": "BNB",
"direction": "ADDITIONAL",
"collateralAmount": "5.235",
"preLTV": "0.78",
"afterLTV": "0.56",
"adjustTime": 1575018510000 }
],
"total": 1
}
GET /sapi/v1/loan/flexible/ltv/adjustment/history(将被停用)
请更换为:
GET /sapi/v2/loan/flexible/ltv/adjustment/history
权重(UID): 400
参数:
名称
类型
是否必须
描述
loanCoin
STRING
NO
collateralCoin
STRING
NO
startTime
LONG
NO
endTime
LONG
NO
current
LONG
NO
Current querying page. Start from 1; default: 1; max: 1000
limit
LONG
NO
Default: 10; max: 100
recvWindow
LONG
NO
timestamp
LONG
YES
如果没有发送startTime和endTime，默认返回最近90天的数据。
startTime和endTime的最大间隔为180天。
查询活期借币可借币种数据 (USER_DATA)
响应:
{
"rows": [
{
"loanCoin": "BUSD",
"flexibleInterestRate": "0.00000491",
"flexibleMinLimit": "100",
"flexibleMaxLimit": "1000000"
}
],
"total": 1
}
GET /sapi/v1/loan/flexible/loanable/data(已停用)
请更换为:
GET /sapi/v2/loan/flexible/loanable/data
获取活期借币可借币种的利率和借贷限额。借入限额以美元价值显示。
权重(IP): 400
频率限制: 1次/2秒/UID
参数:
名称
类型
是否必须
描述
loanCoin
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
查询活期借币抵押币种数据 (USER_DATA)
响应:
{
"rows": [
{
"collateralCoin": "BNB",
"initialLTV": "0.65",
"marginCallLTV": "0.75",
"liquidationLTV": "0.83",
"maxLimit": "1000000"
}
],
"total": 1
}
GET /sapi/v1/loan/flexible/collateral/data(已停用)
请更换为:
GET /sapi/v2/loan/flexible/collateral/data
获取活期借币抵押币种质押率信息和质押限额。质押限额以美元价值显示。
权重(IP): 400
频率限制: 1次/2秒/UID
参数:
名称
类型
是否必须
描述
collateralCoin
STRING
NO
recvWindow
LONG
NO
timestamp
LONG
YES
Pay 接口获取 Pay 交易历史记录 (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": [
{
"orderType": "C2C", //交易类型 枚举值：PAY（C端用户在商户侧消费）, PAY_REFUND（C端用户商户侧消费，退款）, C2C（C端用户间的转账）,CRYPTO_BOX（红包交易）, CRYPTO_BOX_RF（红包交易，退款）, C2C_HOLDING（C端用户转账给非币安用户）, C2C_HOLDING_RF（C端用户转账给非币安用户，退款）, PAYOUT（商户给其用户付款）, REMITTANCE（汇款）
"transactionId": "M_P_71505104267788288", //流水编号
"transactionTime": 1610090460133, //交易时间戳
"amount": "23.72469206", //订单金额 最多8位小数 正为收入，负为支出
"currency": "BNB", //订单币种
"walletType": 1, //主钱包类型，1 资金钱包；2 现货钱包；3 法币钱包；4 或 6 卡支付；5 理财钱包
"walletTypes": [1,2], //数组格式，当使用组合支付时会有多个值
"fundsDetail": [ //使用资金明细
{
"currency": "USDT", //使用资金币种
"amount": "1.2", //使用资金金额 为正 最多8位小数
"walletAssetCost":[ //每个钱包的资金支出明细
{"1":"0.6"},
{"2":"0.6"}
]
},
{
"currency": "ETH",
"amount": "0.0001",
"walletAssetCost":[
{"1":"0.00005"},
{"2":"0.00005"}
]
}
],
"payerInfo":{
"name":"Jack", //个人昵称或商户名称
"type":"USER", //账户类型，USER表示个人账户，MERCHANT表示商家
"binanceId":"12345678", //binance uid
"accountId":"67736251" //binance pay id
},
"receiverInfo":{
"name":"Alan", //个人昵称或商户名称
"type":"MERCHANT", //账户类型，USER表示个人账户，MERCHANT表示商家
"email":"alan@binance.com", //邮箱
"binanceId":"34355667", //binance uid
"accountId":"21326891", /binance pay id
"countryCode":"1", //国际区号
"phoneNumber":"8057651210", //手机号
"mobileCode":"US", //国家代码
"extend":[ //extension field
"institutionName": "", //银行名或者电子钱包名称
"cardNumber": "",
"digitalWalletId": ""
]
}
}
],
"success": true
}
GET /sapi/v1/pay/transactions
权重(UID):
3000
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 100, 最大 100
recvWindow
LONG
NO
timestamp
LONG
YES
若startTime和endTime均未发送,只返回最近90天数据
startTime和endTime的最大时间间隔为90天
支持查询日期范围：近18个月以内的订单
对于payerInfo和receiverInfo，在不同的orderType会有不同的返回值
orderType为C2C时的发送方视角
payerInfo : binanceId
receiverInfo : name, binanceId/accountId/email/countryCode/phoneNumber/mobileCode（根据用户的输入返回）
orderType为C2C时的接收方视角
payerInfo : name, accountId
receiverInfo : binanceId
orderType为CRYPTO_BOX的发送方视角
payerInfo : binanceId
receiverInfo : name(值为"Crypto Box")
orderType为CRYPTO_BOX的接收方视角
payerInfo : name, accountId
receiverInfo : binanceId
orderType为C2B的发送方视角
payerInfo : binanceId
receiverInfo : name
orderType为C2B的接收方视角
payerInfo : name, accountId
receiverInfo : binanceId, name
orderType为PAY_REFUND的退款发起方视角
payerInfo : binanceId, name
receiverInfo : name, accountId
orderType为PAY_REFUND的退款接收方视角
payerInfo : name
receiverInfo : binanceId
orderType为PAYOUT的发送方视角
payerInfo : binanceId, name
receiverInfo : name, accountId
orderType为PAYOUT的接收方视角
payerInfo : name
receiverInfo : binanceId
orderType为CRYPTO_BOX_RF的接收方视角
payerInfo : name(值为"Crypto Box")
receiverInfo : binanceId
orderType为REMITTANCE的发送方视角
payerInfo : binanceId
receiverInfo : name, institutionName, cardNumber, digitalWalletId
闪兑接口
您想访问币安闪兑API吗？请填写问卷提交访问申请。闪兑API服务适用于需要在币安闪兑上自动交易的用户。我们批准您的申请后，您将收到一封确认邮件。
请注意，该服务的所有用户均受到币安使用条款的约束；API服务不适用于含套利、高频交易、价格剥削在内的使用目的。币安可随时出于任何原因自行决定限制或终止币安API连接，并且对于此类限制、终止及其原因，币安没有义务提前告知用户。
查询可交易币对信息
响应:
[
{
"fromAsset":"BTC",
"toAsset":"USDT",
"fromAssetMinAmount":"0.0004",
"fromAssetMaxAmount":"50",
"toAssetMinAmount":"20",
"toAssetMaxAmount":"2500000"
}
]
GET /sapi/v1/convert/exchangeInfo
查询可交易的币对的信息，以及它们分别所支持交易金额的上下限。
权重(IP):
20
参数:
名称
类型
是否必需
描述
fromAsset
STRING
EITHER OR BOTH
用户售出币种
toAsset
STRING
EITHER OR BOTH
用户买入币种
用户应当fromAsset和toAsset参数至少填一个。
如果fromAsset和toAsset只填写了一个参数，将会返回部分币对信息。
查询可交易币种精度 (USER_DATA)
响应:
[
{
"asset": "BTC",
"fraction": 8
},
{
"asset": "SHIB",
"fraction": 2
}
]
GET /sapi/v1/convert/assetInfo
查询每个可交易币种的精度信息
权重(IP):
100
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
此值不能大于 60000
timestamp
LONG
YES
发送获取报价请求 (USER_DATA)
响应:
{
"quoteId":"12415572564",
"ratio":"38163.7",
"inverseRatio":"0.0000262",
"validTimestamp":1623319461670,
"toAmount":"3816.37",
"fromAmount":"0.1"
}
POST /sapi/v1/convert/getQuote
对所需的币对发送获取报价请求
权重(UID):
200
参数:
名称
类型
是否必需
描述
fromAsset
STRING
YES
toAsset
STRING
YES
fromAmount
DECIMAL
EITHER
这是成交后将被扣除的金额
toAmount
DECIMAL
EITHER
这是成交后将会获得的金额
walletType
ENUM
NO
可用值为SPOT 或者 FUNDING. 默认值是 SPOT
validTime
ENUM
NO
可以支持10s、30s、1m、2m等值，默认值为 10s
recvWindow
LONG
NO
此值不能大于 60000
timestamp
LONG
YES
参数fromAmount或者toAmount只需要提供其中一个。
quoteId仅在账户余额充足时返回。
接受报价 (TRADE)
响应:
{
"orderId":"933256278426274426",
"createTime":1623381330472,
"orderStatus":"PROCESS" //PROCESS/ACCEPT_SUCCESS/SUCCESS/FAIL
}
POST /sapi/v1/convert/acceptQuote
通过 quote ID 来接受报价。
权重(UID):
500
参数:
名称
类型
是否必需
描述
quoteId
STRING
YES
recvWindow
LONG
NO
此值不能大于 60000
timestamp
LONG
YES
查询订单状态 (USER_DATA)
响应:
{
"orderId":933256278426274426,
"orderStatus":"SUCCESS",
"fromAsset":"BTC",
"fromAmount":"0.00054414",
"toAsset":"USDT",
"toAmount":"20",
"ratio":"36755",
"inverseRatio":"0.00002721",
"createTime":1623381330472
}
GET /sapi/v1/convert/orderStatus
通过 order ID 来查询订单状态。
权重(UID):
100
参数:
名称
类型
是否必需
描述
orderId
STRING
NO
orderId 和quoteId需要填其中一个
quoteId
STRING
NO
orderId 和quoteId需要填其中一个
创建闪兑限价单(USER_DATA)
响应:
{
"orderId": 1603680255057330400,
"status": "PROCESS"
}
POST /sapi/v1/convert/limit/placeOrder
用户创建闪兑限价单
权重(UID):
500
参数:
名称
类型
是否必需
描述
baseAsset
STRING
YES
先使用GET /sapi/v1/convert/exchangeInfo API接口去查询币对中的quoteAsset
quoteAsset
STRING
YES
先使用GET /sapi/v1/convert/exchangeInfoAPI接口去查询币对中的quoteAsset
limitPrice
DECIMAL
YES
币对限价 (从baseAsset 到 quoteAsset)
baseAmount
DECIMAL
NO
Base asset 金额 (baseAmount 或 quoteAmount 需且仅需填写一个)
quoteAmount
DECIMAL
NO
Quote asset 金额 (baseAmount 或 quoteAmount 需且仅需填写一个)
side
ENUM
YES
BUY 或者SELL
walletType
ENUM
NO
使用扣款钱包类型，SPOT或FUNDING或SPOT_FUNDING.默认值为SPOT.
expiredType
ENUM
YES
1_D, 3_D, 7_D, 30_D (D 指天)
recvWindow
LONG
NO
timestamp
LONG
YES
baseAsset 或 quoteAsset 可以通过GET /sapi/v1/convert/exchangeInfoAPI 接口判别.
限价的方向是从baseAsset到quoteAsset.
baseAmount或quoteAmount需且仅需一个.
取消闪兑限价单 (USER_DATA)
响应:
{
"orderId": 1603680255057330400,
"status": "CANCELED"
}
POST /sapi/v1/convert/limit/cancelOrder
用户取消闪兑限价单
权重(UID):
200
参数:
名称
类型
是否必需
描述
orderId
LONG
YES
orderId 在 placeOrder接口响应中获得
recvWindow
LONG
NO
timestamp
LONG
YES
查询闪兑限价单 (USER_DATA)
响应:
{
"list": [
{
"quoteId": "18sdf87kh9df",
"orderId": 1150901289839,
"orderStatus": "SUCCESS",
"fromAsset": "BNB",
"fromAmount": "10",
"toAsset": "USDT",
"toAmount": "2317.89",
"ratio": "231.789",
"inverseRatio": "0.00431427",
"createTime": 1614089498000,
"expiredTimestamp": 1614099498000
}
]
}
GET /sapi/v1/convert/limit/queryOpenOrders
查询闪兑限价单
权重(UID):
3000
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
该值不大于60000
timestamp
LONG
YES
获取闪兑交易记录 (USER_DATA)
响应:
{
"list": [
{
"quoteId": "f3b91c525b2644c7bc1e1cd31b6e1aa6",
"orderId": 940708407462087195, // 订单号
"orderStatus": "SUCCESS", // 订单状态
"fromAsset": "USDT", // 闪兑前币种
"fromAmount": "20", // 闪兑前金额
"toAsset": "BNB", // 闪兑后币种
"toAmount": "0.06154036", // 闪兑后金额
"ratio": "0.00307702", // 价格
"inverseRatio": "324.99", // 反向价格
"createTime": 1624248872184
}
],
"startTime": 1623824139000,
"endTime": 1626416139000,
"limit": 100,
"moreData": false
}
GET /sapi/v1/convert/tradeFlow
权重(UID):
3000
参数:
名称
类型
是否必需
描述
startTime
LONG
YES
endTime
LONG
YES
limit
INT
NO
默认 100, 最大 1000
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大时间间隔为30天
返佣接口获取现货返佣历史记录 (USER_DATA)
响应:
{
"status": "OK",
"type": "GENERAL",
"code": "000000000",
"data": {
"page": 1, //当前页
"totalRecords": 2, //总记录数
"totalPageNum": 1, //总页数
"data": [
{
"asset": "USDT", // 返佣资产
"type": 1, // 返佣类型：1为推荐人返佣，2为被推荐人返现
"amount": "0.0001126", // 金额
"updateTime": 1637651320000
},
{
"asset": "ETH",
"type": 1,
"amount": "0.00000056",
"updateTime": 1637928379000
}
]
}
}
GET /sapi/v1/rebate/taxQuery
权重(UID):
12000
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
page
INT
NO
默认 1
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大时间间隔为30天
若startTime和endTime均未发送,只返回最近7天数据
查询时间最早支持于2020年6月10号
每次最多返回200条记录
NFT 接口获取 NFT 资金流水记录 (USER_DATA)
响应:
{
"total": 2, //交易记录总数
"list": [
{
"orderNo": "1_470502070600699904", // 数字前缀含义 0:买单，1:卖单，2:版税收入，3:一级市场买单，4:mint 费用
"tokens": [
{
"network": "BSC", // NFT的网络
"tokenId": "216000000496", // NFT的Token ID
"contractAddress": "MYSTERY_BOX0000087" // NFT 的 Contract Address
}
],
"tradeTime": 1626941236000, // 交易成功时间
"tradeAmount": "19.60000000", // 交易金额（实际收入/实际购买总价/实际费用)
"tradeCurrency": "BNB"。 // 交易币种
},
{
"orderNo": "1_488306442479116288",
"tokens": [
{
"network": "BSC",
"tokenId": "132900000007",
"contractAddress": "0xAf12111a592e408DAbC740849fcd5e68629D9fb6"
}
],
"tradeTime": 1631186130000,
"tradeAmount": "192.00000000",
"tradeCurrency": "BNB"
}
]
}
GET /sapi/v1/nft/history/transactions
权重(UID):
3000
参数:
名称
类型
是否必需
描述
orderType
INT
YES
0:买单，1:卖单，2:版税收入，3:一级市场买单，4:mint 费用
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 50, 最大 50
page
INT
NO
默认 1
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大时间间隔为90天
若startTime和endTime均未发送,只返回最近7天数据
获取 NFT 充值记录 (USER_DATA)
响应:
{
"total": 2,
"list": [
{
"network": "ETH", // NFT的网络
"txID": null, // 该笔充值记录的 Transaction ID
"contractAdrress": "0xe507c961ee127d4439977a61af39c34eafee0dc6", // NFT的 Contract Address
"tokenId": "10014", // NFT的 Token ID
"timestamp": 1629986047000
},
{
"network": "BSC",
"txID": null,
"contractAdrress": "0x058451b463bab04f52c0799d55c4094f507acfa9",
"tokenId": "10016",
"timestamp": 1630083581000
}
]
}
GET /sapi/v1/nft/history/deposit
权重(UID):
3000
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 50, 最大 50
page
INT
NO
默认 1
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大时间间隔为90天
若startTime和endTime均未发送,只返回最近7天数据
获取 NFT 提现记录 (USER_DATA)
响应:
{
"total": 178,
"list": [
{
"network": "ETH",
"txID": "0x2be5eed31d787fdb4880bc631c8e76bdfb6150e137f5cf1732e0416ea206f57f",
"contractAdrress": "0xe507c961ee127d4439977a61af39c34eafee0dc6", // NFT的 Contract Address
"tokenId": "1000001247", // NFT的 Token ID
"timestamp": 1633674433000, // 提现时间
"fee": 0.1, // 提现手续费
"feeAsset": "ETH" // 手续费币种
},
{
"network": "ETH",
"txID": "0x3b3aea5c0a4faccd6f306641e6deb9713ab229ac233be3be227f580311e4362a",
"contractAdrress": "0xe507c961ee127d4439977a61af39c34eafee0dc6",
"tokenId": "40000030",
"timestamp": 1633677022000,
"fee": 0.1,
"feeAsset": "ETH"
}
]
}
GET /sapi/v1/nft/history/withdraw
权重(UID):
3000
参数:
名称
类型
是否必需
描述
startTime
LONG
NO
endTime
LONG
NO
limit
INT
NO
默认 50, 最大 50
page
INT
NO
默认 1
recvWindow
LONG
NO
timestamp
LONG
YES
startTime和endTime的最大时间间隔为90天
若startTime和endTime均未发送,只返回最近7天数据
获取 NFT 资产 (USER_DATA)
响应:
{
"total": 347,
"list": [
{
"network": "BSC", // NFT的网络
"contractAddress": "REGULAR11234567891779", // NFT的 Contract Address
"tokenId": "100900000017" // NFT的 Token ID
},
{
"network": "BSC",
"contractAddress": "SSMDQ8W59",
"tokenId": "200500000011"
},
{
"network": "BSC",
"contractAddress": "SSMDQ8W59",
"tokenId": "200500000019"
}
]
}
GET /sapi/v1/nft/user/getAsset
权重(UID):
3000
参数:
名称
类型
是否必需
描述
limit
INT
NO
默认 50, 最大 50
page
INT
NO
默认 1
recvWindow
LONG
NO
timestamp
LONG
YES
币安礼品卡接口
通过币安礼品卡，用户可以通过一串可兑现的密码进行便捷安全的加密货币转账及交易。币安礼品卡API提供及时的币安礼品卡创建，兑现以及状态查询。每张币安礼品卡包含两个部分：“礼品卡卡号” 以及“礼品卡兑现码”。“礼品卡卡号”可以公开流通，并用于验证币安礼品卡的有效性；“礼品卡兑现码”应妥善保管，因为任何拥有兑现码的人可以随时兑现该礼品卡。
一经使用币安礼品卡接口，即代表您同意币安礼品卡用户协议和币安支付用户协议。
创建币安礼品卡功能仅允许已通过 KYB 的企业帐户使用。
自 2023 年 8 月 21 日起，创建礼品卡将征收 1% 的服务费。
创建单币种礼品卡 (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": {
"referenceNo": "0033002327977405", // 礼品卡卡号
"code": "AOGANK3NB4GIT3C6" // 兑现码
},
"success": true
}
POST /sapi/v1/giftcard/createCode
该API用于创建一个币安礼品卡。要开始使用，请确保：
你有一个币安账户
你已通过了 KYB
币安资金账户中有足够的余额（礼品卡金额和手续费金额）
你的API Key需要开启允许提现权限
权重(IP):
1
每日制卡金额上限： 2 BTC / 24H / 账户
每日制卡次数上限： 200 次 / 24H / 账户
参数:
名称
类型
是否必需
描述
token
STRING
YES
币安礼品卡中的数字货币币种
amount
DOUBLE
YES
币安礼品卡中的数字货币数量
recvWindow
LONG
NO
timestamp
LONG
YES
创建双币种礼品卡（固定价值，设置折扣） (TRADE)
响应：
{
"code": "000000",
"message": "success",
"data": {
"referenceNo": "0033002327977405",
"code": "AOGANK3NB4GIT3C6"
},
"success": true
}
POST /sapi/v1/giftcard/buyCode
该API用于创建以双币种币安礼品卡，即以稳定币定值的非稳定币礼品卡。您可以通过USDT作为礼品卡的定值币种(baseToken)，来创建可兑现至其他不同币种（faceToken）的币安礼品卡。比如创建固定价值为100 USDT的BTC礼品卡，用USDT制卡，未兑现前始终保持100 USDT的价值，最终兑现出来的是100 USDT等值的BTC。
创建后，定值币种(baseToken, 比如USDT)相应的金额和手续费将从你的资金账户中被扣除。
要开始使用，请确保：
你有一个币安账户
你已通过了 KYB
币安资金账户中有足够的余额（礼品卡金额和手续费金额）
你的API Key需要开启允许提现权限
权重(IP):
1
每日制卡金额上限： 2 BTC / 24H / 账户
每日制卡次数上限： 200 次 / 24H / 账户
参数：
名称
类型
是否必需
描述
baseToken
STRING
YES
你用来支付的货币，例如：BUSD
faceToken
STRING
YES
你创建的礼品卡面额，例如：BNB。如果 faceToken = baseToken, 将等同于使用 createCode API
baseTokenAmount
DOUBLE
YES
支付的货币数量，例如：1.002
discount
DOUBLE
NO
稳定币定值礼品卡的折扣百分比，例如：1 代表 1% 的折扣。小数点精度需小于 6。
recvWindow
LONG
NO
timestamp
LONG
YES
兑现币安礼品卡 (USER_DATA)
响应:
{
"code":"000000",
"message":"success",
"data":{
"referenceNo":"0033002328060227",
"identityNo":"10317392647411060736",
"token":"BNB",
"amount":"0.00000001"
},
"success":true
}
POST /sapi/v1/giftcard/redeemCode
该API用于兑现币安礼品卡。兑现后，币种将存入您的资金账户。
请注意，如果您在 24 小时内输入错误币安礼品卡兑现码 5 次，您将无法在当天兑现任何币安礼品卡。
权重(IP):
1
参数:
名称
类型
是否必需
描述
code
STRING
YES
用于赎回的币安礼品卡，支持加密&未加密两种方式
externalUid
String
NO
每个外部用户 ID 代表合作伙伴平台上的某个用户。该功能帮助您识别不同用户的兑现行为，例如兑现频次和金额。它还有助于对单个账户进行风险和限额控制，例如设置单个账户每日兑现金额、频次和卡密输错次数的上限。这也将防止单个帐户突破合作伙伴的每日兑现限额从而导致合作伙伴的账户在当日无法继续制码或者兑现。如果您有外部的网站且有不同的用户在您的平台上兑现 币安礼品卡，我们强烈建议您使用此功能并将您用户的用户 ID 传输给我们来进行风控。为保护用户的信息安全，您可以选择以任何格式（上限为 400 个字符）传输用户 ID。
recvWindow
LONG
NO
timestamp
LONG
YES
注意：
参数code有两种形式传输
Plaintext: 未加密的格式
Encrypted: 加密后的格式
用加密后的格式传输更安全，传输加密的格需要以下步骤：
调用获取公钥的API
用加密算法对公钥和原始的binance code进行加密：RSA/ECB/OAEPWithSHA-256AndMGF1Padding
获取加密后的binance code的java使用方式:
private static PublicKey getPublicKey(String publicKey) throws Exception {
KeyFactory keyFactory = KeyFactory.getInstance("RSA");
byte[] decodedKey = Base64.decodeBase64(publicKey.getBytes());
X509EncodedKeySpec keySpec = new X509EncodedKeySpec(decodedKey);
return keyFactory.generatePublic(keySpec);
}
public static String encrypt(String content, String publicKeyString) throws Exception {
if (StringUtils.isAnyEmpty(new CharSequence[]{content, publicKeyString})) {
throw new IllegalArgumentException("invalid content or privateKey.");
} else {
Cipher cipher = Cipher.getInstance("RSA/ECB/OAEPWITHSHA-256ANDMGF1PADDING", "BC");
cipher.init(Cipher.ENCRYPT_MODE, getPublicKey(publicKeyString));
return new String(Base64.encodeBase64URLSafe(cipher.doFinal(content.getBytes("UTF-8"))));
}
}
static {
Security.addProvider(new BouncyCastleProvider());
}
通过礼品卡卡号验证币安礼品卡 (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": {
"valid":true, //是否有效
"token":"BNB", //币种
"amount":"0.00000001" //金额
},
"success": true
}
GET /sapi/v1/giftcard/verify
此 API 用于通过输入礼品卡卡号来验证币安礼品卡是否有效。
请注意，如果您在一小时内输入错误的礼品卡卡号 5 次，您将无法在该小时内验证任何礼品卡卡号。
权重(IP):
1
参数:
名称
类型
是否必需
描述
referenceNo
STRING
YES
输入礼品卡卡号
recvWindow
LONG
NO
timestamp
LONG
YES
获取RSA Public Key (USER_DATA)
响应:
{
"code": "000000",
"message": "success",
"data": "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCXBBVKLAc1GQ5FsIFFqOHrPTox5noBONIKr+IAedTR9FkVxq6e65updEbfdhRNkMOeYIO2i0UylrjGC0X8YSoIszmrVHeV0l06Zh1oJuZos1+7N+WLuz9JvlPaawof3GUakTxYWWCa9+8KIbLKsoKMdfS96VT+8iOXO3quMGKUmQIDAQAB",
"success": true
}
GET /sapi/v1/giftcard/cryptography/rsa-public-key
此API用来获取用户的公钥
公钥可以用来对币安礼品卡的兑现码进行加密
请注意公钥获取只有当天有效
权重(IP):
1
参数:
名称
类型
是否必需
描述
recvWindow
LONG
NO
timestamp
LONG
YES
获取货币使用限制 (USER_DATA)
响应：
{
"code": "000000",
"message": "success",
"data": [
{
"coin": "BNB",
"fromMin": "0.01",
"fromMax": "1"
}
],
"success":true
}
GET /sapi/v1/giftcard/buyCode/token-limit
此 API 是用来查看第2部分描述的稳定币定值的礼品卡所支持的数字货币及限制
权重(IP):
1
参数：
名称
类型
是否必需
描述
baseToken
STRING
YES
你用来支付的货币，例如：BUSD
recvWindow
LONG
NO
timestamp
LONG
YES
错误代码
错误JSON格式:
{
"code":-1121,
"msg":"Invalid symbol."
}
错误由两部分组成：错误代码和消息。 代码是通用的，但是消息可能会有所不同。
10xx -常规服务器或网络问题-1000 UNKNOWN
处理请求时发生未知错误。
处理请求时发生未知错误。[%s]
-1001 DISCONNECTED
内部错误; 无法处理您的请求。 请再试一次.
-1002 UNAUTHORIZED
您无权执行此请求。
-1003 TOO_MANY_REQUESTS
排队的请求过多。
请求权重过多； 当前限制是 %s 每 %s 的请求权重。 请使用 Websocket Streams 进行实时更新，以避免轮询API。
请求权重过多； IP被禁止，直到％s。 请使用 Websocket Streams 进行实时更新，以免被禁。
-1004 SERVER_BUSY
服务器正忙，请稍候再试。
-1006 UNEXPECTED_RESP
从消息总线收到意外的响应。 执行状态未知。
-1007 TIMEOUT
等待后端服务器响应超时。 发送状态未知； 执行状态未知。
-1008 SERVER_BUSY
现货交易服务器当前因其他请求而过载。 请在几分钟后重试。
-1014 UNKNOWN_ORDER_COMPOSITION
不支持的订单组合。
-1015 TOO_MANY_ORDERS
新订单太多。
新订单太多； 当前限制为每％s ％s个订单。
-1016 SERVICE_SHUTTING_DOWN
该服务不可用。
-1020 UNSUPPORTED_OPERATION
不支持此操作。
-1021 INVALID_TIMESTAMP
此请求的时间戳在recvWindow之外。
此请求的时间戳比服务器时间提前1000毫秒。
-1022 INVALID_SIGNATURE
此请求的签名无效。
-1099 Not found, authenticated, or authorized
替换错误代码-1999
11xx - 2xxx Request issues-1100 ILLEGAL_CHARS
在参数中发现非法字符。
在参数中发现非法字符。％s
在参数％s中发现非法字符； 合法范围是％s。
-1101 TOO_MANY_PARAMETERS
为此端点发送的参数太多。
参数太多； 预期为％s并收到了％s。
检测到的参数值重复。
-1102 MANDATORY_PARAM_EMPTY_OR_MALFORMED
未发送强制性参数，该参数为空/空或格式错误。
强制参数％s未发送，为空/空或格式错误。
必须发送参数％s或％s，但两者均为空！
-1103 UNKNOWN_PARAM
发送了未知参数。
-1104 UNREAD_PARAMETERS
并非所有发送的参数都被读取。
并非所有发送的参数都被读取； 读取了％s参数，但被发送了％s。
-1105 PARAM_EMPTY
参数为空。
参数％s为空。
-1106 PARAM_NOT_REQUIRED
不需要时已发送参数。
不需要时发送参数％s。
-1111 BAD_PRECISION
Parameter '%s' has too much precision.
-1112 NO_DEPTH
交易对没有挂单。
-1114 TIF_NOT_REQUIRED
不需要时发送了TimeInForce参数。
-1115 INVALID_TIF
无效 timeInForce.
-1116 INVALID_ORDER_TYPE
无效订单类型。
-1117 INVALID_SIDE
无效买卖方向。
-1118 EMPTY_NEW_CL_ORD_ID
新的客户订单ID为空。
-1119 EMPTY_ORG_CL_ORD_ID
客户自定义的订单ID为空。
-1120 BAD_INTERVAL
无效时间间隔。
-1121 BAD_SYMBOL
无效的交易对。
-1125 INVALID_LISTEN_KEY
该listenKey不存在。
-1127 MORE_THAN_XX_HOURS
查询间隔太大。
从开始时间到结束时间之间超过％s小时。
-1128 OPTIONAL_PARAMS_BAD_COMBO
可选参数组合无效。
-1130 INVALID_PARAMETER
发送的参数为无效数据。
发送参数％s的数据无效。
-1131 BAD_RECV_WINDOW
recvWindow 必须小于 60000
-1134 BAD_STRATEGY_TYPE
strategyType 必须小于 1000000
-1139 无效的Ticker类型
Invalid ticker type.
-1145 INVALID_CANCEL_RESTRICTIONS
cancelRestrictions 必须是 ONLY_NEW 或者 ONLY_PARTIALLY_FILLED。
-1151 重复的交易对
Symbol is present multiple times in the list.
-1152 无效的SBE报文头部
Invalid X-MBX-SBE header; expected
-1153 不支持的SCHEMA_ID
Unsupported SBE schema ID or version specified in the X-MBX-SBE header.
-1155 SBE 没有开启
SBE is not enabled.
-2010 NEW_ORDER_REJECTED
新订单被拒绝
-2011 CANCEL_REJECTED
取消订单被拒绝
-2013 NO_SUCH_ORDER
订单不存在。
-2014 BAD_API_KEY_FMT
API-key 格式无效。
-2015 REJECTED_MBX_KEY
无效的API密钥，IP或操作权限。
-2016 NO_TRADING_WINDOW
找不到该交易对的交易窗口。 尝试改为24小时自动报价。
-2026 ORDER_ARCHIVED
订单已被存档因为此订单被取消或过期，无交易数量而最后的更新已超过 90 天前。
3xxx-5xxx SAPI 具体问题-3000 INNER_FAILURE
内部服务器错误。
-3001 NEED_ENABLE_2FA
请先启用2FA。
-3002 ASSET_DEFICIENCY
此资产不存在。
-3003 NO_OPENED_MARGIN_ACCOUNT
杠杆账户不存在。
-3004 TRADE_NOT_ALLOWED
禁止交易。
-3005 TRANSFER_OUT_NOT_ALLOWED
不允许转账。
-3006 EXCEED_MAX_BORROWABLE
您的已借金额已超过最高可借金额。
-3007 HAS_PENDING_TRANSACTION
您有待处理的交易，请稍后再试。
-3008 BORROW_NOT_ALLOWED
不允许借款。
-3009 ASSET_NOT_MORTGAGEABLE
此资产目前不允许转入杠杆账户。
-3010 REPAY_NOT_ALLOWED
不允许还款。
-3011 BAD_DATE_RANGE
您输入的日期无效。
-3012 ASSET_ADMIN_BAN_BORROW
此资产禁止借款。
-3013 LT_MIN_BORROWABLE
借入金额少于最低借入金额。
-3014 ACCOUNT_BAN_BORROW
此帐户禁止借款。
-3015 REPAY_EXCEED_LIABILITY
还款额超过借款额。
-3016 LT_MIN_REPAY
还款额少于最低还款额。
-3017 ASSET_ADMIN_BAN_MORTGAGE
此资产目前不允许转入保证金账户。
-3018 ACCOUNT_BAN_MORTGAGE
此帐户已禁止转入。
-3019 ACCOUNT_BAN_ROLLOUT
此帐户禁止转出。
-3020 EXCEED_MAX_ROLLOUT
转出金额超过上限。
-3021 PAIR_ADMIN_BAN_TRADE
杠杆账户无法交易此交易对。
-3022 ACCOUNT_BAN_TRADE
账号被禁止交易。
-3023 WARNING_MARGIN_LEVEL
无法在当前杠杆倍数下转出资金或者下单
-3024 FEW_LIABILITY_LEFT
付款之后未付款的债务太小
-3025 INVALID_EFFECTIVE_TIME
输入时间有误。
-3026 VALIDATION_FAILED
输入参数有误。
-3027 NOT_VALID_MARGIN_ASSET
无效的杠杆资产。
-3028 NOT_VALID_MARGIN_PAIR
无效的杠杆交易对。
-3029 TRANSFER_FAILED
转账失败。
-3036 ACCOUNT_BAN_REPAY
此账号无法还款。
-3037 PNL_CLEARING
PNL正在清帐，请稍等。
-3038 LISTEN_KEY_NOT_FOUND
找不到Listen key
-3041 BALANCE_NOT_CLEARED
余额不足
-3042 PRICE_INDEX_NOT_FOUND
该杠杆交易对无可用价格指数。
-3043 TRANSFER_IN_NOT_ALLOWED
不允许转入。
-3044 SYSTEM_BUSY
系统繁忙。
-3045 SYSTEM
系统目前没有足够可借的资产。
-3999 NOT_WHITELIST_USER
此功能只面向邀请的用户。
-4001 CAPITAL_INVALID
非法操作
-4002 CAPITAL_IG
非法获取
-4003 CAPITAL_IEV
非法邮箱验证
-4004 CAPITAL_UA
未登录或者认证。
-4005 CAPAITAL_TOO_MANY_REQUEST
请求太频繁。
-4006 CAPITAL_ONLY_SUPPORT_PRIMARY_ACCOUNT
只支持主账号。
-4007 CAPITAL_ADDRESS_VERIFICATION_NOT_PASS
地址的没有通过校验。
-4008 CAPITAL_ADDRESS_TAG_VERIFICATION_NOT_PASS
地址的标记信息(tag)没有通过校验。
-4010 CAPITAL_WHITELIST_EMAIL_CONFIRM
确认电子邮件已经列入白名单。
-4011 CAPITAL_WHITELIST_EMAIL_EXPIRED
列入白名单的电子邮件无效。
-4012 CAPITAL_WHITELIST_CLOSE
白名单未打开。
-4013 CAPITAL_WITHDRAW_2FA_VERIFY
2FA未打开。
-4014 CAPITAL_WITHDRAW_LOGIN_DELAY
在登录后的2分钟之内不允许提款。
-4015 CAPITAL_WITHDRAW_RESTRICTED_MINUTE
暂停提款
-4016 CAPITAL_WITHDRAW_RESTRICTED_PASSWORD
在密码修改后的24小时之内不允许提款。
-4017 CAPITAL_WITHDRAW_RESTRICTED_UNBIND_2FA
在2FA发行后的24小时之内不允许提款。
-4018 CAPITAL_WITHDRAW_ASSET_NOT_EXIST
此资产不存在。
-4019 CAPITAL_WITHDRAW_ASSET_PROHIBIT
此资产不允许提款。
-4021 CAPITAL_WITHDRAW_AMOUNT_MULTIPLE
资产的提款数量必须是％s的％s倍。
-4022 CAPITAL_WITHDRAW_MIN_AMOUNT
不须少于最低的提款数量％s。
-4023 CAPITAL_WITHDRAW_MAX_AMOUNT
在24小时之内，不须超过最高的提款数量。
-4024 CAPITAL_WITHDRAW_USER_NO_ASSET
当前用户没有此资产。
-4025 CAPITAL_WITHDRAW_USER_ASSET_LESS_THAN_ZERO
持有资产的数量小于零。
-4026 CAPITAL_WITHDRAW_USER_ASSET_NOT_ENOUGH
此资产余额不足。
-4027 CAPITAL_WITHDRAW_GET_TRAN_ID_FAILURE
无法获取tranId。
-4028 CAPITAL_WITHDRAW_MORE_THAN_FEE
提款金额必须多于佣金额。
-4029 CAPITAL_WITHDRAW_NOT_EXIST
此提款记录不存在。
-4030 CAPITAL_WITHDRAW_CONFIRM_SUCCESS
提款资产成功。
-4031 CAPITAL_WITHDRAW_CANCEL_FAILURE
取消提款失败。
-4032 CAPITAL_WITHDRAW_CHECKSUM_VERIFY_FAILURE
验证提款失败。
-4033 CAPITAL_WITHDRAW_ILLEGAL_ADDRESS
提款地址不合法。
-4034 CAPITAL_WITHDRAW_ADDRESS_CHEAT
当前地址有异常。
-4035 CAPITAL_WITHDRAW_NOT_WHITE_ADDRESS
此地址不在白名单上。请加入然后重试。
-4036 CAPITAL_WITHDRAW_NEW_ADDRESS
新地址在{0}小时后才可以提款。
-4037 CAPITAL_WITHDRAW_RESEND_EMAIL_FAIL
重新发送邮件失败。
-4038 CAPITAL_WITHDRAW_RESEND_EMAIL_TIME_OUT
请5分钟后重试。
-4039 CAPITAL_USER_EMPTY
用户不存在。
-4041 CAPITAL_MINUTE_TOO_SMALL
请一分钟后重试。
-4042 CAPITAL_CHARGE_NOT_RESET
资产无法重新获取存款地址。
-4043 CAPITAL_ADDRESS_TOO_MUCH
在24小时之内充值超过100多个地址。
-4044 CAPITAL_BLACKLIST_COUNTRY_GET_ADDRESS
此国家在黑名单上。
-4045 CAPITAL_GET_ASSET_ERROR
获得资产失败。
-4046 CAPITAL_AGREEMENT_NOT_CONFIRMED
协议未确认。
-4047 CAPITAL_DATE_INTERVAL_LIMIT
时间间隔必须在0-90天之内
-4060 CAPITAL_WITHDRAW_USER_ASSET_LOCK_DEPOSIT
体现仍在区块确认中，暂时锁定部分资产
-5001 ASSET_DRIBBLET_CONVERT_SWITCH_OFF
不允许转移到微型资产。
-5002 ASSET_ASSET_NOT_ENOUGH
此余额不足。
-5003 ASSET_USER_HAVE_NO_ASSET
此资产不存在。
-5004 USER_OUT_OF_TRANSFER_FLOAT
剩余余额已超过0.001BTC，请重新选择。
％s的剩余余额已超过0.001BTC，请重新选择。
-5005 USER_ASSET_AMOUNT_IS_TOO_LOW
BTC的剩余余额太低，请重新选择。
％s的剩余余额太低，请重新选择。
-5006 USER_CAN_NOT_REQUEST_IN_24_HOURS
24小时内只能转账一次。
-5007 AMOUNT_OVER_ZERO
数量必须大于零。
-5008 ASSET_WITHDRAW_WITHDRAWING_NOT_ENOUGH
可退回资产的金额不足。
-5009 PRODUCT_NOT_EXIST
产品不存在。
-5010 TRANSFER_FAIL
资产转移失败。
-5011 FUTURE_ACCT_NOT_EXIST
合约帐户不存在。
-5012 TRANSFER_PENDING
资产转移正在进行中。
-5021 PARENT_SUB_HAVE_NO_RELATION
当前的子账户和母账户没有从属关系。
-5012 FUTURE_ACCT_OR_SUBRELATION_NOT_EXIST
合约帐户或子账户关系不存在。
6XXX - 币安宝相关-6001 DAILY_PRODUCT_NOT_EXIST
理财产品不存在.
-6003 DAILY_PRODUCT_NOT_ACCESSIBLE
产品不存在或者没有权限。
-6004 DAILY_PRODUCT_NOT_PURCHASABLE
产品无法购买。
-6005 DAILY_LOWER_THAN_MIN_PURCHASE_LIMIT
低于可以购买的最小限额。
-6006 DAILY_REDEEM_AMOUNT_ERROR
赎回额度有误。
-6007 DAILY_REDEEM_TIME_ERROR
不在赎回的时间内。
-6008 DAILY_PRODUCT_NOT_REDEEMABLE
产品暂时无法赎回。
-6009 REQUEST_FREQUENCY_TOO_HIGH
发送请求太频繁。
-6011 EXCEEDED_USER_PURCHASE_LIMIT
超购每个月用户可以申购的最大次数。
-6012 BALANCE_NOT_ENOUGH
余额不足。
-6013 PURCHASING_FAILED
申购失败。
-6014 UPDATE_FAILED
超过可以申购的最大上限。
-6015 EMPTY_REQUEST_BODY
请求的body为空。
-6016 PARAMS_ERR
请求的参数有误。
-6017 NOT_IN_WHITELIST
不在白名单里面。
-6018 ASSET_NOT_ENOUGH
资产不足。
-6019 PENDING
需要进一步确认。
-6020 PROJECT_NOT_EXISTS
此项目不存在。
70xx - 期货-7001 FUTURES_BAD_DATE_RANGE
此日期范围不支持。
-7002 FUTURES_BAD_TYPE
此数据请求类型不支持。
20xxx - 合约/现货策略交易-20121 Invalid symbol
无效交易对。
-20124 Invalid algo id or it has been completed
无效的策略订单ID或者它已经被执行。
-20130 Invalid data sent for a parameter
无效数据。
-20132 The client algo id is duplicated
用户自定义策略订单ID重复。
-20194 Duration is too short to execute all required quantity
Duration 时间太短不足以执行用户选择的订单数量。
-20195 The total size is too small
下单数量太小。
-20196 The total size is too large
下单数量太大。
-20198 Reach the max open orders allowed
达到了最大挂单上限。
-20204 The notional of USD is less or more than the limit
订单小于最小USD名义价值
过滤器故障
报错信息
描述
"Filter failure: PRICE_FILTER"
"价格"过高，过低和/或不遵循交易对的最小价格规则。
"Filter failure: PERCENT_PRICE"
"价格"比最近Y分钟的平均加权价格高X％或X％太低。
"Filter failure: PERCENT_PRICE_BY_SIDE"
price 在当前方向上(BUY或者SELL)比lastPrice价格超过X%或者低于Y%。
"Filter failure: LOT_SIZE"
"数量"太高，太低和/或不遵循该交易对的步长规则。
"Filter failure: MIN_NOTIONAL"
价格*数量太低，无法成为该交易对的有效订单。
"Filter failure: ICEBERG_PARTS"
ICEBERG 订单会分成太多部分； icebergQty太小。
"Filter failure: MARKET_LOT_SIZE"
"MARKET"订单的"数量"过高，过低和/或未遵循交易对的步长规则。
"Filter failure: MAX_POSITION"
达到账户的最大仓位限制。这包括了账户的余额总额，以及所有处于open的买单的数量总和。
"Filter failure: MAX_NUM_ORDERS"
客户在交易对上有太多挂单。
"Filter failure: MAX_ALGO_ORDERS"
账户有太多未平仓止损和/或在交易对上执行获利指令。
"Filter failure: MAX_NUM_ICEBERG_ORDERS"
客户在交易对上有太多 iceberg 挂单。
"Filter failure: TRAILING_DELTA"
trailingDelta 值不在限定的范围内.
"Filter failure: EXCHANGE_MAX_NUM_ORDERS"
帐户上的交易所有太多挂单。
"Filter failure: EXCHANGE_MAX_ALGO_ORDERS"
帐户有太多止损挂单和/或在交易所收取获利指令。
10xxx - 质押借币-10001 SYSTEM_MAINTENANCE
系统维护中，请稍后再试
-10002 INVALID_INPUT
无效的输入参数
-10005 NO_RECORDS
暂无记录
-10007 COIN_NOT_LOANABLE
该币种暂不支持借贷
-10008 COIN_NOT_LOANABLE
该币种暂不支持借贷
-10009 COIN_NOT_COLLATERAL
该币种暂不支持抵押
-10010 COIN_NOT_COLLATERAL
该币种暂不支持抵押
-10011 INSUFFICIENT_ASSET
现货资产不足
-10012 INVALID_AMOUNT
无效的还款金额
-10013 INSUFFICIENT_AMOUNT
抵押资产不足
-10015 DEDUCTION_FAILED
抵押资产扣款失败
-10016 LOAN_FAILED
放贷失败
-10017 REPAY_EXCEED_DEBT
还款金额超过负债金额
-10018 INVALID_AMOUNT
无效的还款金额
-10019 CONFIG_NOT_EXIST
配置不存在
-10020 UID_NOT_EXIST
用户ID不存在
-10021 ORDER_NOT_EXIST
订单不存在
-10022 INVALID_AMOUNT
无效的调整金额
-10023 ADJUST_LTV_FAILED
调整质押率失败
-10024 ADJUST_LTV_NOT_SUPPORTED
暂不支持调整质押率
-10025 REPAY_FAILED
还款失败
-10026 INVALID_PARAMETER
无效的参数
-10028 INVALID_PARAMETER
无效的参数
-10029 AMOUNT_TOO_SMALL
借贷金额过小
-10030 AMOUNT_TOO_LARGE
借贷金额过大
-10031 QUOTA_REACHED
已达到个人借贷限额
-10032 REPAY_NOT_AVAILABLE
暂不支持换款
-10034 REPAY_NOT_AVAILABLE
抵押物还款暂时不支持，请尝试用借贷币还款。
-10039 AMOUNT_TOO_SMALL
还款金额过小
-10040 AMOUNT_TOO_LARGE
还款金额过大
-10041 INSUFFICIENT_AMOUNT
由于借贷需求过多，系统剩余可借{0}额度不足。请调整借贷金额或明天再试。
-10042 ASSET_NOT_SUPPORTED
暂不支持%s币种
-10043 ASSET_NOT_SUPPORTED
暂不支持{0} 借贷
-10044 QUOTA_REACHED
抵押物数量已达到限额，请调整抵押金额或使用其他抵押资产。
-10045 COLLTERAL_REPAY_NOT_SUPPORTED
该借贷币种暂不支持抵押物还款，请稍后再试。
-10046 EXCEED_MAX_ADJUSTMENT
调整抵押物超过最大限额，请重试。
-10047 REGION_NOT_SUPPORTED
受当地法规管制，您所在地区暂不支持该币种。
13xxx - 杠杆代币-13000 BLVT_FORBID_REDEEM
当前该杠杆代币关闭赎回
-13001 BLVT_EXCEED_DAILY_LIMIT
超过该代币个人24小时赎回金额上限
-13002 BLVT_EXCEED_TOKEN_DAILY_LIMIT
超过该代币全局24小时赎回金额上限
-13003 BLVT_FORBID_PURCHASE
当前该杠杆代币关闭申购
-13004 BLVT_EXCEED_DAILY_PURCHASE_LIMIT
超过该代币个人24小时申购金额上限
-13005 BLVT_EXCEED_TOKEN_DAILY_PURCHASE_LIMIT
超过该代币全局24小时申购金额上限
-13006 BLVT_PURCHASE_LESS_MIN_AMOUNT
申购金额低于规定下限
-13007 BLVT_PURCHASE_AGREEMENT_NOT_SIGN
没有签署开通交易协议
12xxx - 流动性挖矿-12014 TOO MANY REQUESTS
2秒内接收的请求数量多于1条
18xxx - 币安码-18002
The total amount of codes you created has exceeded the 24-hour limit, please try again after UTC 0
24小时内制码总金额已超过限额，请UTC0点后再尝试
-18003
Too many codes created in 24 hours, please try again after UTC 0
24小时内制码总次数已超过限额，请UTC0点后再尝试
-18004
Too many invalid redeem attempts in 24 hours, please try again after UTC 0
24小时内兑现币安码输错次数已超过限额，请UTC0点后再尝试
-18005
Too many invalid verify attempts, please try later
参考号输错次数过多，请稍后再试
-18006
The amount is too small, please re-enter
金额过小，请重新输入
-18007
This token is not currently supported, please re-enter
尚未支持该币种，请重新输入
21xxx - 統一帳戶-21001 USER_IS_NOT_UNIACCOUNT
尚未开通统一账户。
-21002 UNI_ACCOUNT_CANT_TRANSFER_FUTURE
统一账户禁用margin向futures转账。
-21003 NET_ASSET_MUST_LTE_RATIO
margin资产更新失败。
-21004 USER_NO_LIABILITY
用户不存在统一账户穿仓负债
-21005 NO_ENOUGH_ASSET
用户现货钱包BUSD资产不足以偿还统一账户穿仓负债
-21006 HAD_IN_PROCESS_REPAY
用户存在正在偿还的统一账户穿仓负债
-21007 IN_FORCE_LIQUIDATION
强平进行中，用户偿还统一账户穿仓负债失败
订单拒绝错误
以下错误代码表示撮合引擎返回的订单相关错误:
-1010 ERROR_MSG_RECEIVED
-2010 NEW_ORDER_REJECTED
-2011 CANCEL_REJECTED
结合以下消息将指示特定的错误：
错误信息
描述
"Unknown order sent."
找不到订单(通过"orderId"，"clientOrderId"，"origClientOrderId")
"Duplicate order sent."
clientOrderId已经被使用
"Market is closed."
该交易对不在交易范围
"Account has insufficient balance for requested action."
没有足够的资金来完成行动
"Market orders are not supported for this symbol."
交易对上未启用"MARKET"
"Iceberg orders are not supported for this symbol."
交易对上未启用icebergQty
"Stop loss orders are not supported for this symbol."
交易对上未启用 STOP_LOSS
"Stop loss limit orders are not supported for this symbol."
交易对上未启STOP_LOSS_LIMIT
"Take profit orders are not supported for this symbol."
交易对上未启用TAKE_PROFIT
"Take profit limit orders are not supported for this symbol."
交易对上未启用TAKE_PROFIT_LIMIT
"Price * QTY is zero or less."
price * quantity太小
"IcebergQty exceeds QTY."
icebergQty 必须少于订单数量
"This action is disabled on this account."
联系客户支持； 该账户已禁用了某些操作。
"This account may not place or cancel orders."
联系客户支持： 该账户已被禁用了交易操作。
"Unsupported order combination"
不允许组合orderType, timeInForce, stopPrice, 和/或 icebergQty 。
"Order would trigger immediately."
与最后交易价格相比，订单的止损价无效。
"Cancel order is invalid. Check origClientOrderId and orderId."
未发送origClientOrderId 或orderId 。
"Order would immediately match and take."
LIMIT_MAKER 订单类型将立即匹配并进行交易，而不是纯粹的生成订单。
"The relationship of the prices for the orders is not correct."
OCO订单中设置的价格不符合报价规则： The rules are: SELL Orders: Limit Price > Last Price > Stop Price BUY Orders: Limit Price < Last Price < Stop Price
"OCO orders are not supported for this symbol"
OCO订单不支持该交易对
"Quote order qty market orders are not support for this symbol."
这个交易对，市价单不支持参数quoteOrderQty
"Trailing stop orders are not supported for this symbol."
此symbol不支持 trailingDelta ｜
"Order cancel-replace is not supported for this symbol."
此symbol不支持 POST /api/v3/order/cancelReplace 或者 order.cancelReplace (WebSocket API) ｜
"This symbol is not permitted for this account."
账户和交易对的权限不一致 (比如 SPOT, MARGIN 等)。｜
"This symbol is restricted for this account."
账户没有权限在此交易对交易 (比如账户只拥有 ISOLATED_MARGIN权限，则无法下SPOT 订单)。 ｜
"Order was not canceled due to cancel restrictions."
cancelRestrictions 设置为 ONLY_NEW 但订单状态不是 NEW 或 cancelRestrictions 设置为 ONLY_PARTIALLY_FILLED 但订单状态不是 PARTIALLY_FILLED。 ｜
"Rest API trading is not enabled." / "WebSocket API trading is not enabled."
下单时，服务器没有设置为允许访问 TRADE 的接口。
关于 POST /api/v3/order/cancelReplace 的错误-2021 Order cancel-replace partially failed
收到该错误码代表撤单或者下单失败。
-2022 Order cancel-replace failed.
收到该错误码代表撤单和下单都失败。
备注说明请求参数Email地址
Email地址作为请求参数，需要转译(encode)。比如 alice@test.com 转换成 alice%40test.com
Email地址作为请求参数，应为小写。
�Binance: Buy Bitcoin & Crypto on the App Store
�Binance: Buy Bitcoin & Crypto on the App Store
ExitAppleStoreMaciPadiPhoneWatchAirPodsTV & HomeEntertainmentAccessoriesSupport
0+
App Store Preview
Binance: Buy Bitcoin & Crypto
17+
Crypto Exchange & Wallet
Binance LTD
Designed for iPhone
#11 in Finance
4.7 • 38.5K Ratings
Free
Screenshots
iPhone
Apple Watch
Description
Securely buy, sell, and hold cryptocurrencies like Bitcoin (BTC), Ethereum (ETH), and Cardano (ADA) with low trading fees. Used by over 150 million users worldwide, Binance is the largest cryptocurrency exchange* in the world.Here is why:TRADE YOUR FAVORITE TOKENS AND MORETrade over 350 listed cryptocurrencies, including Bitcoin (BTC) and Ethereum (ETH).Track the market using price alerts and trade with advanced trading tools. Set up recurring orders (DCA) to buy crypto every hour, day, week or month.Enjoy best-in-class liquidity on each crypto trade. Buy cryptocurrency and fund your wallet in minutes with flexible payment options, including credit/debit, bank transfers, and peer-to-peer (P2P) trading.Find leading traders and replicate their trading strategies with one tap.EARN DAILY REWARDS ON YOUR IDLE ASSETSEarn rewards from staking, dual investment, and yield farming. Reap the benefits of staking cryptocurrency on popular assets like Bitcoin (BTC). Use Auto-Invest to buy crypto and earn passive income at the same time. Support emerging blockchain and cryptocurrency projects on Binance Launchpad.**SECURE, COMPLIANT, AND REGULATED CRYPTO EXCHANGEBinance is the most regulated crypto exchange in the world, with licenses, registrations, and approvals across multiple jurisdictions. All user funds are held 1:1 in a Secure Asset Fund for Users (SAFU) worth $1 billion. Our system is secured with state-of-the-art security measures, including real-time risk monitoring, strict KYC protocols, and advanced end-to-end data encryption.FAST AND SECURE KYC PROCESSBinance partners with leading KYC vendors to provide a speedy registration process, so you can verify your Binance account and buy Bitcoin in minutes.SPEND AND SEND YOUR CRYPTO BALANCEUse the tokens in your wallet to buy flight tickets or shop at crypto-friendly brands.Make secure crypto transfers from your wallet to your friends and family worldwide. EXPLORE THE BEST OF WEB3, CRYPTO, AND THE BLOCKCHAINGet tailored blockchain and crypto Web3 content delivered to your app homepage. Participate in Binance community discussions on the latest blockchain and crypto trends.Learn crypto with courses and articles on topics related to Bitcoin, trading, and managing your finances.Earn crypto rewards by learning and completing quizzes on how certain cryptocurrencies work. Use our built-in Web3 wallet to securely interact with dApps, earn yield with DeFi, and trade 10,000+ tokens across different blockchains.ACCESS 24/7 CUSTOMER SUPPORTLet us help you on your crypto journey, whether you’re an avid crypto trader or a beginner looking to buy Bitcoin.Get help from 24/7 live chat customer support, available in 18 languages (English, Arabic, German, French, Filipino, Indonesian, Italian, Japanese, Chinese, Russian, Spanish, Polish, Portuguese, Romanian, Turkish, Korean, Ukrainian, and Vietnamese).Learn how to buy Bitcoin, manage your crypto wallet, and make your first crypto trade on Binance using our FAQ guides.*by trading volume - Source: https://coinmarketcap.com/rankings/exchanges/ **Region Limitation Disclaimer: This is a general announcement. Products and services referred to here may not be available in your region.***Binance App is available only to non-U.S. citizens and residents. For U.S. citizens and residents, please install the Binance.US App.Still undecided? Download now and discover why over 150 million users choose Binance to buy crypto, trade over 350 cryptocurrencies, and securely hold their assets. The Binance App goes beyond your traditional trading app, enabling users to learn more about blockchain, earn passive income through staking, and spend their cryptocurrency.
What’s New
6 Mar 2024
Version 2.79.5
- Overview wallet adds coin PNL- Deposit & withdraw crypto page adds anti scam warning information- P2P price alert supports to show reference price based on the payment method selected- P2P ad list supports to filter based on fiat currency- P2P optimizes the appeal guidance to user
Ratings and Reviews
4.7 out of 5
38.5K Ratings
38.5K Ratings
Joe. H.Smt80
,
30/05/2023
Good app
First of all, if you haven’t used Binance yet make sure to enter the reward coupon MTPDHCLV on the sign up screen to get 40% commission kickback rate. Wonderful... The best trading app ever. Very fast and reliable. God! Your app rock. I mean no change for trading and you can trade so many coin at the same time. Wow! With every update from past 4-5 months, the app has just got sleeker and sleeker. Both buy and sell interface are now on same page to make things more eaiser i recommend this app. The fees are reasonable if you use BNB to cover your fees for trading, Binance cuts fees down 50% if you use BNB, the fees go down more depending on what "tier" or level user you are. Pricing is real time, sending and receiving crypto is quick. Their security is incredible, the level of security used to protect the user account is one of the best. They now offer a virtual wallet, and the support team is quick to help if you need them. One recommendations - In trades (center) tab when we click on the open trades icon, the history is out at the top right which isn't quite an ideal position. Do what you've done for futures open orders and order history, just slide right to get the order history. That would be really neat... All bug with new upload are fixed!! Great!!
spunky_twins12
,
19/10/2022
Binance app
This app is a little bit complicated to use and a little fidgety. It does take some time to get to use and remember where everything goes. But the customer service reliability and trustworthiness is second to none with this company. Each time I had an issue with the app I would contact customer service and within a minute I had a reply and I was very diligent in helping you rectifyAny issues I had. First I was nervous to send money through this app being my first time. But Binance made it so much safer and easier to use just by customer service alone. I can’t recommend this app enough. It only has five stars but I would you have 10 out of 10.
Developer Response
,
Hello sounky_twins12, how are you? Thank you for your kind feedback. We are very happy to know that you liked our app and service so much and know that your satisfaction is our main motivation ��. We take the opportunity to remind you that our support works 24 hours a day and if you need help, we can allocate one of our specialists to help you in real time through the link: binance.com/en/chatThank you, DO 🚀
Gobxc
,
29/09/2022
Need transaction details of bank statement to verify address? Seriously?
I have just registered on Binance app this morning, sent pictures of my driver license and selfie, regular verification done, then I was going to do verification for my address, I have sent my bank statement, reply said it’s failed, confused? I have contacted customer service, told me because I have blurred each of my transaction details and only shows date and amount, of course I need done this, you ask verification for address, my bank statement clearly shows my name, my address and even amount I have spent, why should I show you where and what I have spent for the last three months, it ridiculous, my driver license and bank statement clearly shows my address on both, still not satisfied? I have just lost confidence to use this app now, honestly I don’t mind to show my bank statement with transaction details to someone like Centrelink or service NSW etc, but not for trading platform like Binance. Really doubt about what kind of personal information you looking for.
Developer Response
,
Hello, the reason why you are asked for a document that has not been tampered with is to make sure that the relevant document has not been manipulated in any way. On the other hand, there are many suitable documents that you can verify the address and do not include the purchases you make. Please check the documents we mentioned here and easily complete your address verification: https://www.binance.com/en/support/faq/10315cfd150e438b82d306f6e657e996. If you need further assistance feel free to reach one of our specialists from here: http://binance.com/en/chat | TS
App Privacy
The developer, Binance LTD, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer's privacy policy.
Data Used to Track You
The following data may be used to track you across apps and websites owned by other companies:
Usage Data
Data Not Linked to You
The following data may be collected but it is not linked to your identity:
Identifiers
Usage Data
Diagnostics
Privacy practices may vary, for example, based on the features you use or your age. Learn More
Information
Seller
Binance (Switzerland) AG
Size
720 MB
Category
Finance
Compatibility
iPhone
Requires iOS 13.0 or later.
iPod touch
Requires iOS 13.0 or later.
Mac
Requires macOS 11.0 or later and a Mac with Apple M1 chip or later.
Apple Watch
Requires watchOS 7.0 or later.
Apple Vision
Requires visionOS 1.0 or later.
Languages
English, Danish, Georgian, Kazakh, Portuguese, Russian, Simplified Chinese, Spanish, Traditional Chinese, Turkish, Vietnamese
Age Rating
17+
Unrestricted Web Access
Copyright
© 2017 - 2024 Binance.com
Price
Free
Developer Website
App Support
Privacy Policy
Developer Website
App Support
Privacy Policy
More By This Developer
Binance Messenger
Business
You Might Also Like
Gate.io - Buy Bitcoin & Crypto
Finance
KuCoin- Buy Bitcoin & Crypto
Finance
Investing.com Cryptocurrency
Finance
Bybit: Buy & Trade Crypto
Finance
HTX:Buy Bitcoin & Crypto
Finance
CoinMarketCap: Crypto Tracker
Finance
More ways to shop: Find an Apple Store or other retailer near you. Or call 133-622.
Australia
Copyright © 2023 Apple Inc. All rights reserved.
Privacy Policy
Terms of Use
Sales and Refunds
Legal
Site Map
Binance API 使用文档
Binance API 使用文档
v1
//
//
// v1
//
//
// v2
//
现货/杠杆/币安宝
U本位合约
币本位合约
欧式期权
WebSocket API
统一账户
简体中文
更新日志
基本信息
SDK和代码示例
Rest 基本信息
testnet
访问限制
接口鉴权类型
需要签名的接口 (TRADE 与 USER_DATA)
公开API参数
过滤器
Postman Collections
行情接口
测试服务器连通性 PING
获取服务器时间
获取交易规则和交易对
深度信息
近期成交
查询历史成交(MARKET_DATA)
近期成交(归集)
K线数据
连续合约K线数据
价格指数K线数据
标记价格K线数据
溢价指数K线数据
最新标记价格和资金费率
查询资金费率历史
查询资金费率信息
24hr价格变动情况
最新价格
最新价格V2
当前最优挂单
获取未平仓合约数
季度合约历史结算价
合约持仓量
大户账户数多空比
大户持仓量多空比
多空持仓人数比
合约主动买卖量
基差
杠杆代币历史净值K线
综合指数交易对信息
多资产模式资产汇率指数
查询指数价格成分
Websocket 行情推送
实时订阅/取消数据流
最新合约价格
归集交易
最新标记价格
全市场最新标记价格
K线
连续合约K线
按Symbol的精简Ticker
全市场的精简Ticker
按Symbol的完整Ticker
全市场的完整Ticker
按Symbol的最优挂单信息
全市场最优挂单信息
强平订单
全市场强平订单
有限档深度信息
增量深度信息
如何正确在本地维护一个orderbook副本
综合指数交易对信息流
交易对信息信息流
多资产模式资产汇率指数
账户和交易接口
划转
获取划转历史
更改持仓模式(TRADE)
查询持仓模式(USER_DATA)
更改联合保证金模式(TRADE)
查询联合保证金模式(USER_DATA)
下单 (TRADE)
测试下单接口 (TRADE)
修改订单 (TRADE)
批量下单 (TRADE)
批量修改订单 (TRADE)
查询订单修改历史 (USER_DATA)
查询订单 (USER_DATA)
撤销订单 (TRADE)
撤销全部订单 (TRADE)
批量撤销订单 (TRADE)
倒计时撤销所有订单 (TRADE)
查询当前挂单 (USER_DATA)
查看当前全部挂单 (USER_DATA)
查询所有订单(包括历史订单) (USER_DATA)
账户余额V2 (USER_DATA)
账户信息V2 (USER_DATA)
调整开仓杠杆 (TRADE)
变换逐全仓模式 (TRADE)
调整逐仓保证金 (TRADE)
逐仓保证金变动历史 (TRADE)
用户持仓风险V2 (USER_DATA)
账户成交历史 (USER_DATA)
获取账户损益资金流水 (USER_DATA)
杠杆分层标准 (USER_DATA)
持仓ADL队列估算 (USER_DATA)
用户强平单历史 (USER_DATA)
合约交易量化规则指标 (USER_DATA)
用户手续费率 (USER_DATA)
获取合约资金流水下载Id (USER_DATA)
通过下载Id获取合约资金流水下载链接 (USER_DATA)
获取合约订单历史下载Id (USER_DATA)
通过下载Id获取合约订单下载链接 (USER_DATA)
获取合约交易历史下载Id (USER_DATA)
通过下载Id获取合约交易历史下载链接 (USER_DATA)
Websocket 账户信息推送
生成listenKey (USER_STREAM)
延长listenKey有效期 (USER_STREAM)
关闭listenKey (USER_STREAM)
listenKey 过期推送
Websocket 账户信息请求(将被弃用)
追加保证金通知
Balance和Position更新推送
订单/交易 更新推送
杠杆倍数等账户配置 更新推送
策略交易 更新推送
网格 更新推送
条件订单（TP/SL）触发后拒绝 更新推送
经典统一账户
查询经典统一账户账户信息 (USER_DATA)
经典统一账户推送
错误代码
10xx - 常规服务器或网络问题
11xx - Request issues
20xx - Processing Issues
40xx - Filters and other Issues
50xx - Order Execution Issues
Binance Futures
更新日志
2024-02-09
币安合约在进行Websocket服务升级，升级影响以下逻辑：
升级前：
服务端每3分钟会发送ping帧，客户端应当在10分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于10分钟每次的频率发送pong帧保持链接)
升级后
Websocket 服务器每3分钟发送Ping消息。
如果Websocket服务器在10分钟之内没有收到Pong消息应答，连接会被断开。
当客户收到ping消息，必需尽快回复pong消息，同时payload需要和ping消息一致。
未经请求的pong消息是被允许的，但是不会保证连接不断开。对于这些pong消息，建议payload为空
2024-01-24
测试网WEBSOCKET
testnet的 Websocket baseurl 更新为 "wss://fstream.binancefuture.com"
2024-01-08
REST
账号与交易接口更新(将于2023-01-11更新)：
PUT /fapi/v1/order: 新增入参priceMatch以支持改单价格保护
PUT /fapi/v1/batchOrders: 新增入参priceMatch以支持改单价格保护
改单会保留该订单原有的selfTradePreventionMode
2023-12-12
WEBSOCKET
行情推送!bookTicker的更新速度将从实时更改为每5秒一次，该更改将从2023年12月20日开始。单个交易对的Book Ticker流
2023-11-15
REST
新增市场数据接口:
GET /fapi/v2/ticker/price: 查询最新价格v2接口。与GET /fapi/v1/ticker/price相比，v2接口入参和响应相同，但接口延迟更低且占用限频更少。GET /fapi/v1/ticker/price将在未来被弃用，时间待定
WEBSOCKET
币安合约将于2023-12-15 06:00停用wss://fstream-auth.binance.com域名，建议API用户在此时间前迁移websocket连接到wss://fstream.binance.com。需要特别注意的是，wss://fstream.binance.com的连接方法与wss://fstream-auth.binance.com不同，例如：
wss://fstream-auth.binance.com/ws/
2023-11-01
REST
新增市场数据接口:
GET /futures/data/basis: 查询基差
GET /fapi/v1/fundingRate更新:
增加返回字段markPrice以显示特定资金费对应的标记价格
2023-10-19
REST
新增行情接口：
GET /futures/data/delivery-price: 查询季度合约历史交割价格
调整下列接口限频为1000/5min/IP:
GET /futures/data/openInterestHist
GET /futures/data/topLongShortAccountRatio
GET /futures/data/topLongShortPositionRatio
GET /futures/data/globalLongShortAccountRatio
GET /futures/data/takerlongshortRatio
调整下列接口限频为500/5min/IP:
GET /fapi/v1/fundingRate
GET /fapi/v1/fundingInfo
2023-10-16
REST
新增行情接口：
GET /fapi/v1/constituents: 查询指数成分
2023-10-11
REST
账户接口IP权重调整：
GET /fapi/v1/income/asyn: 5->1000
GET /fapi/v1/order/asyn: 5->1000
GET /fapi/v1/trade/asyn: 5->1000
GET /fapi/v1/income/asyn/id: 5->10
GET /fapi/v1/order/asyn/id: 5->10
GET /fapi/v1/trade/asyn/id: 5->10
2023-09-25
REST
新增行情接口：
GET /fapi/v1/fundingInfo: 查询有调整的资金费率信息
2023-09-20
REST
GET /fapi/v1/ticker/bookTicker更新:
增加返回字段lastUpdateId
2023-09-19
{
"code": -1008,
"msg": "Server is currently overloaded with other requests. Please try again in a few minutes."
}
新增HTTP503可能的错误响应及错误码，下列接口在请求高峰期可能出现此响应:
POST /fapi/v1/order
PUT /fapi/v1/order
DELETE /fapi/v1/order
POST /fapi/v1/batchOrder
PUT /fapi/v1/batchOrder
DELETE /fapi/v1/batchOrder
POST /fapi/v1/order/test
DELETE /fapi/v1/allOpenOrders
此响应表示本次API请求失败。这种情况下您如果需要的话可以选择立即重试。
2023-09-05
根据此公告，自成交保护（Self-Trade Prevention）已于 2023-09-05 发布。
价格匹配/有效方式GTD/盈亏平衡价等功能（详情见2023-08-29更新日志）已于2023-09-05 发布。
2023-08-31
币安合约在进行Websocket服务升级，升级影响以下逻辑：
升级前：
服务端每5分钟会发送ping帧，客户端应当在15分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于15分钟每次的频率发送pong帧保持链接)
升级后
服务端每3分钟会发送ping帧，客户端应当在10分钟内回复pong帧，否则服务端会主动断开链接。允许客户端发送不成对的pong帧(即客户端可以以高于10分钟每次的频率发送pong帧保持链接)
2023-08-29
自成交保护(发布时间待定)
U本位合约系统中将支持Self-Trade Prevention（STP）自成交保护。此功能将阻止订单与来自同一账户或者同一 tradeGroupId 账户的订单交易。详情请参考
FAQ
合约所有交易对支持通过下单时设置selfTradePreventionMode为下面之一的STP模式：
NONE: 不设置自成交保护
EXPIRE_TAKER: 自成交过期taker订单
EXPIRE_MAKER: 自成交过期maker订单
EXPIRE_BOTH: 自成交过期taker和maker订单
REST更新:
新的订单状态：EXPIRED_IN_MATCH - 订单由于 STP 触发而过期
GET /fapi/v2/account中响应新增字段tradeGroupId显示用户的tradeGroupId
以下接口新增可选参数selfTradePreventionMode以设置该订单的自成交保护模式：
POST /fapi/v1/order
POST /fapi/v1/batchOrders
以下接口新增响应字段selfTradePreventionMode以显示订单的自成交保护模式：
POST /fapi/v1/order
POST /fapi/v1/batchOrders
POST /fapi/v1/order
POST /fapi/v1/order
GET /fapi/v1/order
GET /fapi/v1/openOrders
GET /fapi/v1/allOrders
PUT /fapi/v1/order
PUT /fapi/v1/batchOrders
DELETE /fapi/v1/order
DELETE /fapi/v1/batchOrders
WEBSOCKET账户信息推送更新:
ORDER_TRADE_UPDATE中新增字段V显示用户订单的自成交保护模式
价格匹配(发布时间待定)
U本位合约系统中将支持价格匹配功能（priceMatch）。此功能将允许用户的LIMIT/STOP/TAKE_PROFIT订单无需输入价格，价格匹配功能将根据订单的价格匹配模式和订单簿实时自动确定订单价格。
合约LIMIT/STOP/TAKE_PROFIT订单支持设置priceMatch以价格匹配模式：
NONE: 设置价格匹配
OPPONENT: 盘口对手价
OPPONENT_5: 盘口对手5档价
OPPONENT_10: 盘口对手10档价
OPPONENT_20: 盘口对手20档价
QUEUE: 盘口同向价
QUEUE_5: 盘口同向排队5档价
QUEUE_10: 盘口同向排队10档价
QUEUE_20: 盘口同向排队20档价
例子:
用户下买单，设置priceMatch为QUEUE_5，则订单价格为订单薄买方向（盘口同向）第五档价格
用户下买单，设置priceMatch为OPPONENT，则订单价格为订单薄卖方向（盘口对手）第一档价格
REST更新:
以下接口新增可选参数priceMatch以设置价格匹配类型：
POST /fapi/v1/order
POST /fapi/v1/batchOrders
以下接口新增响应字段priceMatch以显示订单的价格匹配模式：
POST /fapi/v1/order
POST /fapi/v1/batchOrders
POST /fapi/v1/order
POST /fapi/v1/order
GET /fapi/v1/order
GET /fapi/v1/openOrders
GET /fapi/v1/allOrders
PUT /fapi/v1/order
PUT /fapi/v1/batchOrders
DELETE /fapi/v1/order
DELETE /fapi/v1/batchOrders
Websocket账户信息推送更新:
ORDER_TRADE_UPDATE中新增字段 pm 显示用户订单的价格匹配模式
有效方式GTD(发布时间待定)
U本位合约系统中将支持有效方式GTD(Good Till Date)。有效方式(TIF)为GTD的订单到goodTillDate时间仍未完结会被自动取消
合约订单新增timeInForce(有效时间):
GTD (Good till date): 订单到期自动取消
REST更新:
以下接口新增响应字段goodTillDate以配置GTD订单过期时间：
POST /fapi/v1/order
POST /fapi/v1/batchOrders
以下接口新增响应字段goodTillDate以显示GTD订单过期时间：
POST /fapi/v1/order
POST /fapi/v1/batchOrders
POST /fapi/v1/order
POST /fapi/v1/order
GET /fapi/v1/order
GET /fapi/v1/openOrders
GET /fapi/v1/allOrders
PUT /fapi/v1/order
PUT /fapi/v1/batchOrders
DELETE /fapi/v1/order
DELETE /fapi/v1/batchOrders
Websocket账户信息推送更新:
ORDER_TRADE_UPDATE中新增字段 goodTillDate 显示用户GTD订单的自动取消时间
盈亏平衡价(发布时间待定)
REST更新
以下接口返回新增breakEvenPrice字段代表仓位盈亏平衡价：
GET /fapi/v2/account
GET /fapi/v2/positionRisk
WEBSOCKET更新
Position更新推送payloadACCOUNT_UPDATE中P新增bep字段代表仓位盈亏平衡价
2023-08-19
币安合约在进行Websocket服务升级，升级影响以下连接方式：
无信息流订阅连接Websocket服务：
升级前， 用户可以用以下方式连接:
wss://fstream.binance.com/ws
wss://fstream.binance.com/stream
wss://fstream.binance.com/ws/
wss://fstream.binance.com/stream/
升级后，用户可以用以下方式连接:
wss://fstream.binance.com/ws
wss://fstream.binance.com/stream
/ 在url结尾不再支持
带信息流订阅连接Websocket服务:
不支持如下类型的stream:wss://fstream.binance.com/illegal_parameter/stream?steams=
2023-08-14
更新账户和交易接口：
GET /fapi/v1/income：增加字段page用以分页
2023-07-18
REST
GET /fapi/v1/leverageBracket 新增字段notionalCoef显示用户相对默认bracket的调整倍数
2023-07-04
REST
以下接口将改为仅保留最近3个月数据：
GET /fapi/v1/order(2023-07-27生效)
GET /fapi/v1/allOrders(2023-07-27生效)
GET /fapi/v1/userTrades(具体时间待定)
请自行维护和保留3个月之前的历史数据或使用以下新接口获得历史订单/交易信息：
新增接口GET /fapi/v1/order/asyn 获取合约订单历史下载id
新增接口GET /fapi/v1/order/asyn/id 通过下载id获取合约订单历史下载链接
新增接口GET /fapi/v1/trade/asyn 获取合约交易历史下载id
新增接口GET /fapi/v1/trade/asyn/id 通过下载id获取合约交易历史下载链接
2023-06-28
注意:
REST
以下接口将于2023-07-15后不再支持：
GET /fapi/v1/account
GET /fapi/v1/balance
GET /fapi/v1/positionRisk
请及时替换为对应的v2接口:
GET /fapi/v2/account
GET /fapi/v2/balance
GET /fapi/v2/positionRisk
2023-06-22
注意:
WEBSOCKET
订阅格式 /ws?
发送带有不合法JSON格式的websocket消息将导致连接断开，返回错误{"error":{"code":3,"msg":"Invalid JSON: expected value at line 1 column 1"}}
2023-06-16
注意：
建议使用标准的 HTTP 请求格式，fapi 中将不支持非标准请求格式。以下是一些正确的代码实践示例：
不再支持使用 '\x22' 进行转义（"），请改用标准的 '%22'，需要对中括号[]和中括号内部的双引号进行URL encode
DELETE /fapi/v1/batchOrders?origClientOrderIdList=
不支持：
[\x229151944646313025900\x22]
建议：
["9151944646313025900"]
--经过 URL 编码后--
DELETE /fapi/v1/batchOrders?origClientOrderIdList=%5B%229151944646313025900%22%5D
不支持非标准嵌套 JSON 格式
POST /fapi/v1/batchOrders?batchOrders=
不支持：
["{\"type\":\"LIMIT\",\"timeInForce\":\"GTC\"}"]
建议：
[{"type":"LIMIT","timeInForce":"GTC"}]
--经过 URL 编码后--
POST /fapi/v1/batchOrders?batchOrders=%5B%7B%22type%22%3A%22LIMIT%22%2C%22timeInForce%22%3A%22GTC%22%7D%5D
不支持使用不正确的数据类型
DELETE /fapi/v1/batchOrders?orderIdList=
由于 'orderIdList' 参数的数据类型为 LIST
不支持：
["159856286502","159856313662"]
建议：
[159856286502,159856313662]
--经过 URL 编码后--
DELETE /fapi/v1/batchOrders?orderIdList=%5B159856286502%2C159856313662%5D
不支持从请求参数中的无效空白字符
不支持：
POST symbol=BTCUSDT& price= 40000.0 & signature=2d24a314
建议：
POST symbol=BTCUSDT&&price=40000.0&signature=2d24a314
不支持请求参数传空值
不支持：
GET symbol=BTCUSDT&orderId=&signature=2d24a314
建议：
GET symbol=BTCUSDT&signature=2d24a314
2023-06-14
注意:
新增市场信息流 !assetIndex@arrOR
2023-05-31
WEBSOCKET
新增账户信息流:
新增推送 CONDITIONAL_ORDER_TRIGGER_REJECT 以显示被触发的止盈止损单被拒绝原因
2023-05-24
REST
因经典统一账户移除notionalLimit限制，GET /fapi/v1/pmExchangeInfo将于5月29日停用
2023-05-05
REST
新增 PUT /fapi/v1/order 和 PUT /fapi/v1/batchOrders 接口以支持限价订单修改功能
新增 GET /fapi/v1/orderAmendment 接口以查询订单修改历史
WEBSOCKET
订单/交易 更新推送 ORDER_TRADE_UPDATE 中本次事件的具体执行类型 x 新增 "AMENDMENT" 代表订单修改
2023-04-17
发布日期 2023-04-18
recvWindow 校验也将在订单到达撮合后进行。recvWindow 校验在下单相关接口更加精确。
{
"code": -5028,
"msg": "Timestamp for this request is outside of the ME recvWindow"
}
发布前recvWindow逻辑：
下单类请求在 recvWindow + timestamp
=> REST API服务器timestamp时有效
发布后recvWindow逻辑：
新增校验：下单类请求在 recvWindow + timestamp
=> 撮合timestamp时有效
受影响接口:
POST /fapi/v1/order (HMAC SHA256)
PUT /fapi/v1/order (HMAC SHA256)
POST /fapi/v1/batchOrders (HMAC SHA256)
PUT /fapi/v1/batchOrders (HMAC SHA256)
2023-03-28
发布前推荐返佣逻辑：
每笔交易实时返佣，用户会在 USER-DATA-STREAM 的 ACCOUNT_UPDATE 事件中收到如下推送：
{
"e": "ACCOUNT_UPDATE",
"T": 1679974782150,
"E": 1679974782155,
"a": {
"B": [
{
"a": "USDT",
"wb": "685.31478079",
"cw": "677.17212454",
"bc": "0.00258637"
}
],
"P": [],
"m": "ADMIN_DEPOSIT"
}
}
发布后推荐返佣逻辑：
每20分钟聚合一次计算返佣上账，用户会在 USER-DATA-STREAM 的 ACCOUNT_UPDATE 事件中收到相同推送，余额变化为聚合后的返佣加总。
2023-03-08
发布日期 2023-03-22
发布前订单逻辑：
下单时传参 timeInForce为 FOK 或 GTX(Post-only)，用户会收到订单返回 status = “NEW” 并收到推送 order_trade_update消息x = “NEW”， X = “NEW”。 如果订单不满足执行条件，用户会收到另一条 order_trade_update 消息，其x = “EXPIRED”, X = “EXPIRED”。 该订单可以在GET /fapi/v1/order或GET /fapi/v1/allOrders查到。
{
"code": -5021,
"msg": "Due to the order could not be filled immediately, the FOK order has been rejected. The order will not be recorded in the order history"
}
发布后订单逻辑：
下单时传参 timeInForce为 FOK 或 GTX(Post-only)，如果该订单不满足执行条件，订单会被直接拒绝并收到报错信息，order_trade_update不会推送此订单的消息。该订单不能在GET /fapi/v1/order或GET /fapi/v1/allOrders中查到。
{
"code": -5022,
"msg": "Due to the order could not be executed as maker, the Post Only order will be rejected. The order will not be recorded in the order history"
}
受影响接口:
POST /fapi/v1/order (HMAC SHA256)
POST /fapi/v1/batchOrders (HMAC SHA256)
GET /fapi/v1/order (HMAC SHA256)
GET /fapi/v1/allOrders (HMAC SHA256)
2023-01-04
WEBSOCKET
Order Update: 订单状态中删除NEW_INSURANCE风险保障基金(强平)与NEW_ADL自动减仓序列(强平)
2022-12-16
WEBSOCKET
新增订阅信息流 !contractInfo 获取交易对信息更新
2022-11-29
WEB SOCKET USER DATA STREAM
USER-DATA-STREAM 中新增事件STRATEGY_UPDATE: 在策略交易创建、取消、失效等等时候更新。
USER-DATA-STREAM 中新增事件GRID_UPDATE: 在网格子订单有部份或是完全成交时更新。
2022-10-13
注意: 此变动会在 2022-10-17 生效
REST RATE LIMIT WEIGHT
接口 GET /fapi/v1/ticker/bookTicker
权重更新:
单交易对2
无交易对5
2022-09-22
更新账户和交易接口：
GET /fapi/v1/income：支持更多收益类型
新增统一账户接口：
GET /fapi/v1/pmAccountInfo：查询统一账户当前账户信息。
2022-07-27
REST RATE LIMIT WEIGHT
接口 GET /fapi/v1/trades 的请求权重更新为 5
2022-06-28
REST
新增接口 GET /fapi/v1/pmExchangeInfo 获取统一账户交易规则
2022-04-08
WEBSOCKET
更换 base url wss://nbstream.binance.com/lvt-p 对于杠杆代币数据流
Websocket 杠杆代币信息更新 and Websocket 杠杆代币净值K线更新
2022-03-01
REST
新增接口GET /fapi/v1/income/asyn 获取合约资金流水下载id
新增接口GET /fapi/v1/income/asyn/id 通过下载id获取合约资金流水下载链接
2022-02-10
REST
更新GET /fapi/v2/account接口：
若用户开启多资产模式,totalInitialMargintotalMaintMargintotalWalletBalancetotalUnrealizedProfittotalMarginBalancetotalPositionInitialMargintotalOpenOrderInitialMargintotalCrossWalletBalancetotalCrossUnPnlavailableBalancemaxWithdrawAmount 计入各种资产并转化为其USD价值显示
若用户使用单资产模式, 仅USDT资产会被计入计算（和改动前一致）
2021-12-30
WEBSOCKET
新增 WEBSOCKET 连接方式：
Base Url：wss://fstream-auth.binance.com
订阅单一stream格式为 /ws/
组合streams的URL格式为 /stream?streams=
详细说明见 Websocket 行情推送和Websocket 账户信息推送
2021-11-02
REST
新增接口GET /fapi/v1/assetIndex以获取多资产模式保证金资产汇率指数
2021-07-06
REST
GET /fapi/v2/account 和 GET /fapi/v2/positionRisk响应内容加入updateTime以表示资产，仓位的最新更新时间
GET /fapi/v1/exchangeInfo 响应内容增加以下字段:
"liquidationFee" 表示强平费率
"marketTakeBound" 表示市价吃单(相对于标记价格)允许可造成的最大价格偏离比例
2021-06-15
WEBSOCKET
综合指数交易对信息流
REST
更新以下接口:
GET /fapi/v1/indexInfo 响应加入component成分资产，quoteAsset报价资产字段
2021-05-06
WEBSOCKET
更新以下接口：
原有杠杆倍数更新推送事件ACCOUNT_CONFIG_UPDATE扩展为账户配置更新推送事件，包含杠杆倍数与联合保证金状态更新推送
Balance和Position更新推送ACCOUNT_UPDATE的事件m枚举类型新增AUTO_EXCHANGE代表联合保证金自动兑换事件
REST
新增以下接口:
POST /fapi/v1/multiAssetsMargin 以更改联合保证金模式
GET /fapi/v1/multiAssetsMargin 以查询联合保证金模式
更新以下接口:
GET /fapi/v1/exchangeInfo 响应加入assets资产信息
GET /fapi/v2/balance与GET /fapi/v2/account 响应加入marginAvailable字段代表是否可用作联合保证金
2021-04-27
WEBSOCKET
以下市场强平订单推送事件由实时推送调整为快照推送，即每秒最多推送一条强平订单数据:
!forceOrder@arr
REST
获取市场强平订单接口 GET /fapi/v1/allForceOrders停止维护，不再接受请求
2021-04-22
WEBSOCKET
"ACCOUNT_UPDATE" 事件新增返回字段 "bc" 表示账户余额改变量。
2021-03-02
新增接口 GET /fapi/v1/indexPriceKlines 以获取价格指数K线数据。
新增接口 GET /fapi/v1/markPriceKlines 以获取标记价格K线数据。
2021-02-24
REST RATE LIMIT WEIGHT
接口 GET /fapi/v2/balance 的请求权重更新为 5
接口 GET /fapi/v2/positionRisk 的请求权重更新为 5
2021-02-22
REST RATE LIMIT WEIGHT
接口 GET /fapi/v1/income 的请求权重更新为 30
REST
接口GET /fapi/v1/allOrders 的查询时间范围最大为7天.
接口GET /fapi/v1/allForceOrders的查询范围仅限于最近7天内的数据.
2021-01-26
WEB SOCKET USER DATA STREAM
USER-DATA-STREAM 中新增事件ACCOUNT_CONFIG_UPDATE以获取交易对杠杆倍数变动更新
REST RATE LIMIT WEIGHT
以下接口的权重调整为 带symbol 20, 不带symbol 50
GET /fapi/v1/allForceOrders
GET /fapi/v1/forceOrders
REST
新增交易对过滤器 "MIN_NOTIONAL"，定义了交易对订单所允许的最小名义价值，并在 fapi/v1/exchangeInfo 的响应中返回
2021-01-21
合约订单用户自定义idnewClientOrderId更新正则规则为: ^[\.A-Z\:/a-z0-9_-]{1,36}$
2021-01-04
REST
以下接口的IP限制权重将采用基于参数LIMIT数值的新权重规则:
GET /fapi/v1/klines
GET /fapi/v1/continuousKlines
以下接口的IP限制权重调整到 20:
GET /fapi/v1/historicalTrades
GET /fapi/v1/allForceOrders
GET /fapi/v1/forceOrders
GET /fapi/v1/aggTrades
2020-12-08
WEBSOCKET
行情消息推送
行情消息推送
新增行情连续合约K线推送
REST API
接口 GET /fapi/v1/premiumIndex 返回内容新增字段 "estimatedSettlePrice" 表示估计结算价。
接口GET /fapi/v1/exchangeInfo 返回内容新增字段:
"pair" 标的交易对
"contractType" 合约类型
"deliveryDate" 交割日期
"onboardDate" 上线日期
新增接口 GET /fapi/v1/continuousKlines 获取连续合约K线数据
ENUM
合约类型:
PERPETUAL 永续合约
CURRENT_MONTH 当月交割合约
NEXT_MONTH 次月交割合约
CURRENT_QUARTER 当季交割合约
NEXT_QUARTER 次季交割合约
2020-11-27
新增接口 GET /fapi/v1/commissionRate 以查询用户交易手续费率。
2020-11-13
WEB SOCKET STREAM
为了给用户提供更安全稳定的服务，
2020-11-10
接口GET /fapi/v1/exchangeInfo 新增返回字段 "marginAsset" 表示保证金资产
接口GET /fapi/v2/account新增返回字段 "positionAmt" 表示持仓数量
2020-11-09
WEB SOCKET USER DATA STREAM
USER-DATA-STREAM 中的事件ACCOUNT_UPDATE推送规则作出了以下更新和优化：
当用户某项资产发生变化时：
资产项目"B"中仅会推送本次发生变化的资产及其余额
其他资产不会被推送，即便资产不为0
如果资产变化不涉及持仓变化，持仓项目"P"将仅返回空[]
当合约某symbol的持仓或全逐仓配置发生变动时
"P"中会推送该symbol对应的"BOTH"方向上的持仓详情
如果是多空方向上发生持仓变动, "P"中会推送该symbol发生持仓变动的对应"LONG"或"SHORT"方向上的持仓详情
该symbol上被初始化过的"LONG"或"SHORT"方向的逐仓持仓, 也会被推送
所以该symbol上推送的position方向组合, 由具体场景决定()
其他symbol的所有持仓信息都不会被推送，即使其持仓不为0
简言之, 您应该通过相关的rest接口( GET /fapi/v2/account 和 GET /fapi/v2/positionRisk) 获取资产和头寸的全量信息; 通过Websocket USER-DATA-STREAM 中的事件ACCOUNT_UPDATE对本地缓存的资产或头寸数据进行增量更新。
可以访问这里 获取示例以帮助对本次优化升级的理解
2020-10-27
WEB SOCKET STREAM
单个连接可订阅的最大stream数量调整为 200
2020-10-10
WEBSOCKET
新增 WebSocket 综合指数交易对信息更新
2020-10-09
新增接口 GET /fapi/v1/indexInfo 以获取交易对为综合指数的基础成分信息。
2020-09-18
新增 API 交易量化规则指标查询接口 GET /fapi/v1/apiTradingStatus。
2020-09-16
新增杠杆代币历史净值K线接口 GET /fapi/v1/lvtKlines。
杠杆代币净值系统基于合约架构，故该接口采用fapi。
WEBSOCKET
新增 WebSocket 杠杆代币信息更新
净值K线更新
杠杆代币净值系统基于合约架构，故该推送采用合约WS服务。
2020-09-09
一些过期或者被取消的订单将在未来开始逐步不会从API的接口返回。
被移除的订单需要满足如下条件:
订单的最终状态为 CANCELED 或者 EXPIRED, 并且
订单没有任何的成交记录, 并且
订单生成时间 + 7天 < 当前时间
如下的接口会受影响:
GET /fapi/v1/order
GET /fapi/v1/allOrders
2020-08-14
接口GET /fapi/v1/premiumIndex 新增返回字段 "indexPrice", 表示现货指数价格。
以下websocket 行情，新增返回字段 "i" 表示现货指数价格：
!markPrice@arr,
!markPrice@arr@1s
2020-08-12
新增接口 GET /fapi/v1/forceOrders 以获取用户强平订单历史.
2020-07-30
新增接口GET /fapi/v1/adlQuantile 以获取持仓ADL队列位置估算分数
2020-07-17
接口 GET /fapi/v1/income 权重调整为 20
2020-07-02
WEBSOCKET
"ACCOUNT_UPDATE" 事件新增返回字段 "m" 表示事件推出缘由。
"ORDER_TRADE_UPDATE" 事件新增返回字段 "rp" 表示该交易实现损益。
2020-06-15
接口GET /fapi/v2/account，GET /fapi/v2/balance返回内容新增字段:
availableBalance
maxWithdrawAmount
2020-06-04
新增 /fapi/v2/ 接口, 较v1对应接口性能有较大提升:
GET /fapi/v2/account
GET /fapi/v2/balance
2020-06-02
新增 /fapi/v2/ 接口 GET /fapi/v2/positionRisk:
允许用户指定symbol查询
市场上所有symbol都可以被查询
返回内容有效区分单向持仓模式和双向持仓模式
较 ‘/fapi/v1/positionRisk’ 性能有较大改善
2020-05-18
新增参数 closePosition 于下单接口 POST /fapi/v1/order, 表示条件全部平仓:
如果一个STOP_MARKET 或 TAKE_PROFIT_MARKET 条简单设置了 closePosition=true 并被触发了，当时持有所有多头仓位(若为卖单)或当时持有所有空头仓位(若为买单)将会被平仓。
新增返回字段closePosition于以下接口表示是否为条件全平仓单:
POST /fapi/v1/order
POST /fapi/v1/batchOrders
GET /fapi/v1/order
DELETE /fapi/v1/order
DELETE /fapi/v1/batchOrders
GET /fapi/v1/openOrder
GET /fapi/v1/openOrders
GET /fapi/v1/allOrders
2020-05-18
一些过期或者被取消的订单将在未来开始逐步不会从API的接口返回, 但是还可以从网页端查询到。
被移除的订单需要满足如下条件:
订单的最终状态为 CANCELED 或者 EXPIRED, 并且
订单没有任何的成交记录, 并且
订单生成时间 + 30天 < 当前时间
如下的接口会受影响:
GET /fapi/v1/order
GET /fapi/v1/allOrders
2020-05-15
Wesocket 行情消息
E 表示事件推出事件
T 表示撮合时间
2020-05-14
以下接口返回内容增加time字段，表示撮合引擎时间：
GET /fapi/v1/ticker/price
GET /fapi/v1/ticker/bookTicker
GET /fapi/v1/openInterest
2020-05-11
新增接口 POST /fapi/v1/countdownCancelAll 以实现倒计时自动撤单。
该接口可以被用于确保在倒计时结束时撤销指定symbol上的所有挂单。
在使用这个功能时，接口应像心跳一样在倒计时内被反复调用，以便可以取消既有的倒计时并开始新的倒数计时设置。
2020-05-06
REST 接口
接口 GET /fapi/v1/leverageBracket 调整为 USER-DATA 权限访问，需要验签以及timestamp
WEBSOCKET 账户信息推送
请注意: 当某一持仓发生"FUNDING FEE"时，事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息和持仓信息，而不会推送其余无关的资产和持仓信息。
当用户某全仓持仓发生"FUNDING FEE"时，事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息B(仅推送FUNDING FEE 发生相关的资产余额信息)，而不会推送任何持仓信息P。
当用户某逐仓仓持仓发生"FUNGDING FEE"时，事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息B(仅推送"FUNDING FEE"所使用的资产余额信息)，和相关的持仓信息P(仅推送这笔"FUNDING FEE"发生所在的持仓信息)，其余持仓信息不会被推送
2020-04-25
用户"订单/交易更新推送" ORDER_TRADE_UPDATE 新增以下字段:
cp 表示是否为平仓条件单
AP 表示追踪止损单的追踪止损激活价格
cr 表示追踪止损单的追踪止损回调比例
新增账户信息推送事件: "追加保证金通知"MARGIN_CALL.
2020-04-17
下单接口支持新的可选参数 newOrderRespType 表示下单响应类型。支持ACK 和 RESULT,
如果newOrderRespType= RESULT:
MARKET 订单将直接返回成交(FILLED)结果；
配合使用特殊 timeInForce 的 LIMIT 订单将直接返回成交/过期(FILLED/EXPIRED)结果。
2020-04-14
WEB SOCKET 连接限制
Websocket服务器每秒最多接受10个消息。消息包括:
PING帧
PONG帧
JSON格式的消息, 比如订阅, 断开订阅.
如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。
单个连接最多可以订阅 200 个Streams。
2020-04-09
新增接口合约大数据 GET /futures/data/takerlongshortRatio 以查询合约主动买卖量
2020-04-08
新增接口 GET /fapi/v1/positionSide/dual 以查询用户当前持仓模式
新增接口 POST /fapi/v1/batchOrders 以实现批量下单
2020-04-06
请注意 账户信息推送 事件 "Balance和Position更新推送"(ACCOUNT_UPDATE)将不再未发生更新时推送，具体规则如下：
仅当账户信息有变动时(包括资金、仓位、保证金模式等发生变化)，才会推送此事件；
订单状态变化没有引起账户和持仓变化的，不会推送此事件；
每次推送的position 信息，仅包含当前持仓不为0或逐仓仓位保证金不为0的symbol position。
新增接口 POST /fapi/v1/positionSide/dual 更改持仓模式：双向或单向持仓模式。
以下接口新增参数 positionSide 用以支持单向/双向持仓模式，表示持仓方向：
POST /fapi/v1/order
POST /fapi/v1/positionMargin
以下接口新增返回字段 positionSide 用以支持单向/双向持仓模式，表示持仓方向：
POST /fapi/v1/order
GET /fapi/v1/order
DELETE /fapi/v1/order
DELETE /fapi/v1/batchOrders
GET /fapi/v1/openOrder
GET /fapi/v1/openOrders
GET /fapi/v1/allOrders
GET /fapi/v1/account
POST /fapi/v1/positionMargin
GET /fapi/v1/positionMargin/history
GET /fapi/v1/positionRisk
GET /fapi/v1/userTrades
账户信息推送 事件 "Balance和Position更新推送"(ACCOUNT_UPDATE)和 "订单/交易更新推送"(ORDER_TRADE_UPDATE)中新增字段 ps 表示持仓方向。
2020-03-30
新增接口合约大数据:
GET /futures/data/openInterestHist
GET /futures/data/topLongShortAccountRatio
GET /futures/data/topLongShortPositionRatio
GET /futures/data/globalLongShortAccountRatio
2020-02-26
新增订单类型:跟踪止损 TRAILING_STOP_MARKET
2020-02-20
新增接口以查询指定的当前挂单: GET /fapi/v1/openOrder
2020-02-17
新增500ms更新的增量深度信息流选项:
新增500ms更新的有限档深度信息流选项:
2020-02-12
Java SDK和代码示例 发布
实现每秒更新的标记价格信息流选项:
2020-02-05
新增接口GET /fapi/v1/leverageBracket: 查询杠杆分层标准。
2020-01-19
"cumQty" 字段将于未来几周从 DELETE /fapi/v1/order，DELETE /fapi/v1/batchOrders 等 order 相关接口的返回内容中去除，请使用 "executedQty" 字段予以替代。
2020-1-17
Python SDK和代码示例 发布
2020-1-6
实现实时更新的增量深度信息流选项:
2020-1-3
新增逐仓相关接口：
POST /fapi/v1/marginType
POST /fapi/v1/positionMargin
GET /fapi/v1/positionMargin/history
接口GET /fapi/v1/positionRisk新增返回内容:
marginType
isolatedMargin
接口GET /fapi/v1/account新增返回内容：isolated
ACCOUNT_UPDATE Balance和Position更新推送 增加：
"cw": 除去逐仓保证金的钱包余额
"mt": 保证金模式
"iw": 若为逐仓，仓位保证金
2019-12-19
新增接口获取市场当前未平仓合约数： GET /fapi/v1/openInterest
2019-12-18
新增账户信息推送事件：listenKeyExpired。
2019-12-12
新增接口撤销指定symbol的所有订单: DELETE /fapi/v1/allOpenOrders
新增接口批量撤销订单：DELETE /fapi/v1/batchOrders
新增支持仅减仓reduceOnly的订单类型：
TAKE_PROFIT
TAKE_PROFIT_MARKET
STOP
STOP_MARKET
2019-11-29
新增接口获取市场强平订单：GET /fapi/v1/allForceOrders
新增市场行情推送：
强平订单：
全市场强平订单：!forceOrder@arr
2019-11-25
GET /fapi/v1/account 新增返回内容: positions
以下接口新增返回值 time 表示订单创建时间:
GET /fapi/v1/openOrders
GET /fapi/v1/order
GET /fapi/v1/allOrders
2019-11-15
Websocket 新增市场行情流：
!miniTicker@arr: 全市场的精简Ticker更新
!ticker@arr: : 全市场的完整Ticker更新
2019-11-12
WSS 支持实时订阅和取消数据流。
2019-11-05
新增订单类型:
STOP_MARKET止损市价单，
TAKE_PROFIT_MARKET止盈市价单
下单新增可选参数: workingType 可选stopPrice由 "CONTRACT_PRICE" 或 "MARK_PRICE"触发
USER-DATA-STREAMS新增:
ORDER_TRADE_UPDATE订单/交易 更新推送 增加：
"T": 撮合时间
"wt": workingType
ACCOUNT_UPDATE Balance和Position更新推送 增加："T": 撮合时间
2019-10-28
新增接口查询账户损益资金流水：GET /fapi/v1/income
2019-10-25
账户信息推送事件ACCOUNT_UPDATE增加字段 "up"，表示持仓未实现盈亏。
账户信息推送事件ORDER_TRADE_UPDATE增加字段 "R"，表示该成交是否作为只减仓单。
2019-10-24
新增最优挂单信息行情流:
新增有限档深度信息行情流：
更新频率达到100ms的更快的增量深度信息流选项:
Websocket行情推送 增加 Update Speed 更新速度
2019-10-18
新增接口 POST /fapi/v1/leverage 以调整开仓杠杆倍数。
接口 GET /fapi/v1/positionRisk 的返回内容中新增字段：
"leverage": 当前开仓杠杆倍数；
"maxNotionalValue": 当前开仓杠杆倍数下的名义价值上限。
MARKET 市价单支持 reduceOnly 只减仓参数。
2019-10-14
新增接口GET /fapi/v1/fundingRate: 获取资金费率历史。
2019-10-11
账户信息推送事件ORDER_TRADE_UPDATE增加字段 "m"，表示该成交是否作为挂单成交
2019-10-08
新增限价指令订单参数 reduceOnly ：只减仓
新增订单类型 TAKE_PROFIT： 止盈单
2019-09-20
GET /fapi/v1/account 新增返回值:
maxWithdrawAmount, openOrderInitialMargin, positionInitialMargin
GET /fapi/v1/positionRisk 新增返回值:
liquidationPrice
基本信息SDK和代码示例
免责声明:
以下SDK由合作方和用户提供，非官方制作行为。仅做熟悉api接口和学习使用，请广大用户谨慎使用并根据自身情况自行拓展研发。
Binance 官方不对SDK的安全和性能做任何承诺，亦不会对使用SDK引起的风险甚至损失承担责任。
Python3
SDK:
可以通过以下方式获取Binance Futures Connector SDK：
访问 https://github.com/binance/binance-futures-connector-python
执行以下命令：
pip install binance-futures-connector
Java
可以通过以下方式获取SDK：
* 访问 https://github.com/binance/binance-futures-connector-java,
执行以下命令：
git clone https://github.com/binance/binance-futures-connector-java.git
Rest 基本信息
接口可能需要用户的 API Key，如何创建API-KEY请参考这里
本篇列出REST接口的baseurl https://fapi.binance.com
所有接口的响应都是JSON格式
响应中如有数组，数组元素以时间升序排列，越早的数据越提前。
所有时间、时间戳均为UNIX时间，单位为毫秒
所有数据类型采用JAVA的数据类型定义
testnet
本篇接口亦可接入testnet测试平台使用
testnet的 REST baseurl 为 "https://testnet.binancefuture.com"
testnet的 Websocket baseurl 为 "wss://fstream.binancefuture.com"
HTTP 返回代码
HTTP 4XX 错误码用于指示错误的请求内容、行为、格式。
HTTP 403 错误码表示违反WAF限制(Web应用程序防火墙)。
HTTP 429 错误码表示警告访问频次超限，即将被封IP
HTTP 418 表示收到429后继续访问，于是被封了。
HTTP 5XX 错误码用于指示Binance服务侧的问题。
如果返回内容里包含了报错信息 "Request occur unknown error."，请稍后重试请求。
HTTP 503 表示三种可能：
如果返回内容里包含了报错信息 "Unknown error, please check your request or try again later."，则表示API服务端已经向业务核心提交了请求但未能获取响应，特别需要注意的是其不代表请求失败，而是未知。很可能已经得到了执行，也有可能执行失败，需要做进一步确认。
如果返回内容里包含了报错信息 "Service Unavailable."，则表示本次API请求失败。这种情况下可能是服务暂不可用，您需要稍后重试。
如果返回内容里包含了报错信息 "Internal error; unable to process your request. Please try again."，则表示本次API请求失败。这种情况下您如果需要的话可以选择立即重试。
如果返回内容里包含了报错信息 "Server is currently overloaded with other requests. Please try again in a few minutes."，则表示本次API请求失败。这种情况下您如果需要的话可以选择立即重试。
接口错误代码
每个接口都有可能抛出异常
异常响应格式如下：
{
"code": -1121,
"msg": "Invalid symbol."
}
具体的错误码及其解释在错误代码
接口的基本信息
GET方法的接口, 参数必须在query string中发送.
POST, PUT, 和 DELETE 方法的接口, 参数可以在 query string中发送，也可以在 request body中发送(content type application/x-www-form-urlencoded)。允许混合这两种方式发送参数。但如果同一个参数名在query string和request body中都有，query string中的会被优先采用。
对参数的顺序不做要求。
访问限制
在 /fapi/v1/exchangeInfo接口中rateLimits数组里包含有REST接口(不限于本篇的REST接口)的访问限制。包括带权重的访问频次限制、下单速率限制。本篇枚举定义章节有限制类型的进一步说明。
违反上述任何一个访问限制都会收到HTTP 429，这是一个警告.
请注意，若用户被认定利用频繁挂撤单且故意低效交易意图发起攻击行为，Binance有权视具体情况进一步加强对其访问限制。
IP 访问限制
每个请求将包含一个X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)的头，其中包含当前IP所有请求的已使用权重。
每个路由都有一个"权重"，该权重确定每个接口计数的请求数。较重的接口和对多个交易对进行操作的接口将具有较重的"权重"。
收到429时，您有责任作为API退回而不向其发送更多的请求。
如果屡次违反速率限制和/或在收到429后未能退回，将导致API的IP被禁(http状态418)。
频繁违反限制，封禁时间会逐渐延长 ，对于重复违反者，将会被封从2分钟到3天。
访问限制是基于IP的，而不是API Key
强烈建议您尽可能多地使用websocket消息获取相应数据,既可以保障消息的及时性，也可以减少请求带来的访问限制压力。
下单频率限制
每个下单请求回报将包含一个X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter)的头，其中包含当前账户已用的下单限制数量。
被拒绝或不成功的下单并不保证回报中包含以上头内容。
下单频率限制是基于每个账户计数的。
接口鉴权类型
每个接口都有自己的鉴权类型，鉴权类型决定了访问时应当进行何种鉴权
如果需要 API-key，应当在HTTP头中以X-MBX-APIKEY字段传递
API-key 与 API-secret 是大小写敏感的
可以在网页用户中心修改API-key 所具有的权限，例如读取账户信息、发送交易指令、发送提现指令
鉴权类型
描述
NONE
不需要鉴权的接口
TRADE
需要有效的API-KEY和签名
USER_DATA
需要有效的API-KEY和签名
USER_STREAM
需要有效的API-KEY
MARKET_DATA
需要有效的API-KEY
需要签名的接口 (TRADE 与 USER_DATA)
调用这些接口时，除了接口本身所需的参数外，还需要传递signature即签名参数。
签名使用HMAC SHA256算法. API-KEY所对应的API-Secret作为 HMAC SHA256 的密钥，其他所有参数作为HMAC SHA256的操作对象，得到的输出即为签名。
签名大小写不敏感。
当同时使用query string和request body时，HMAC SHA256的输入query string在前，request body在后
时间同步安全
签名接口均需要传递timestamp参数, 其值应当是请求发送时刻的unix时间戳(毫秒)
服务器收到请求时会判断请求中的时间戳，如果是5000毫秒之前发出的，则请求会被认为无效。这个时间窗口值可以通过发送可选参数recvWindow来自定义。
另外，如果服务器计算得出客户端时间戳在服务器时间的‘未来’一秒以上，也会拒绝请求。
逻辑伪代码：
if (timestamp < (serverTime + 1000) && (serverTime - timestamp) <= recvWindow) {
// process request
} else {
// reject request
}
关于交易时效性
互联网状况并不100%可靠，不可完全依赖,因此你的程序本地到币安服务器的时延会有抖动.
这是我们设置recvWindow的目的所在，如果你从事高频交易，对交易时效性有较高的要求，可以灵活设置recvWindow以达到你的要求。
不推荐使用5秒以上的recvWindow
POST /fapi/v1/order 的示例 - HMAC Keys
以下是在linux bash环境下使用 echo openssl 和curl工具实现的一个调用接口下单的示例
apikey、secret仅供示范
Key
Value
apiKey
dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83
secretKey
2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9
参数
取值
symbol
BTCUSDT
side
BUY
type
LIMIT
timeInForce
GTC
quantity
1
price
9000
recvWindow
5000
timestamp
1591702613943
示例 1: 所有参数通过 query string 发送
示例1:
HMAC SHA256 签名:
$ echo -n "symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9"
(stdin)= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9
curl 调用:
(HMAC SHA256)
$ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://fapi.binance.com/fapi/v1/order?symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943&signature= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9'
queryString:
symbol=BTCUSDT
&side=BUY
&type=LIMIT
&timeInForce=GTC
&quantity=1
&price=0.1
&recvWindow=5000
×tamp=1499827319559
示例 2: 所有参数通过 request body 发送
示例2:
HMAC SHA256 签名:
$ echo -n "symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9"
(stdin)= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9
curl 调用:
(HMAC SHA256)
$ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://fapi.binance.com/fapi/v1/order' -d 'symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=9000&timeInForce=GTC&recvWindow=5000×tamp=1591702613943&signature= 3c661234138461fcc7a7d8746c6558c9842d4e10870d2ecbedf7777cad694af9'
requestBody:
symbol=BTCUSDT
&side=BUY
&type=LIMIT
&timeInForce=GTC
&quantity=1
&price=9000
&recvWindow=5000
×tamp=1591702613943
示例 3: 混合使用 query string 与 request body
示例3:
HMAC SHA256 签名:
$ echo -n "symbol=BTCUSDT&side=BUY&type=LIMIT&timeInForce=GTCquantity=1&price=9000&recvWindow=5000×tamp= 1591702613943" | openssl dgst -sha256 -hmac "2b5eb11e18796d12d88f13dc27dbbd02c2cc51ff7059765ed9821957d82bb4d9"
(stdin)= f9d0ae5e813ef6ccf15c2b5a434047a0181cb5a342b903b367ca6d27a66e36f2
curl 调用:
(HMAC SHA256)
$ curl -H "X-MBX-APIKEY: dbefbc809e3e83c283a984c3a1459732ea7db1360ca80c5c2c8867408d28cc83" -X POST 'https://fapi.binance.com/fapi/v1/order?symbol=BTCUSDT&side=BUY&type=LIMIT&timeInForce=GTC' -d 'quantity=1&price=9000&recvWindow=5000×tamp=1591702613943&signature=f9d0ae5e813ef6ccf15c2b5a434047a0181cb5a342b903b367ca6d27a66e36f2'
queryString: symbol=BTCUSDT&side=BUY&type=LIMIT&timeInForce=GTC
requestBody: quantity=1&price=9000&recvWindow=5000×tamp= 1591702613943
请注意，示例3中的签名有些许不同，在"GTC"和"quantity=1"之间没有"&"字符。
POST /fapi/v1/order 的示例 - RSA Keys
这将逐步介绍如何通过有效的签名发送 payload。
我们接受 PKCS#8 格式的 RSA Key。
要获取 API Key，您需要在您的账户上上传您的 RSA Public Key。
对于这个例子，Private Key 将被引用为test-prv-key.pem。
Key
Value
apiKey
vE3BDAL1gP1UaexugRLtteaAHg3UO8Nza20uexEuW1Kh3tVwQfFHdAiyjjY428o2
参数
取值
symbol
BTCUSDT
side
SELL
type
MARKET
quantity
1.23
recvWindow
9999999
timestamp
1671090801999
有列出参数的签名 payload：
timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSDT&side=SELL&type=MARKET&quantity=1.23
第1步: Payload
将参数列表排列成一个 string。 用 & 分隔每个参数。对于上述参数，签名 payload 如右所示。
第2步: 计算签名
2.1 - 将签名有效负载编码为 ASCII 数据。
第2.2步
$ echo -n 'timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSDT&side=SELL&type=MARKET&quantity=1.23' | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem
2.2 - 使用带有 SHA-256 hash 函数的 RSASSA-PKCS1-v1_5 算法对 payload 进行签名。
第2.3步
$ echo -n 'timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSDT&side=SELL&type=MARKET&quantity=1.23' | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem | openssl enc -base64
aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D
2.3 - 将输出编码为 base64 string。
第2.4步
$ echo -n 'timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSDT&side=SELL&type=MARKET&quantity=1.23' | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem | openssl enc -base64 | tr -d '\n'
aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D
2.4 - 删除签名中的所有 \n。
第2.5步
aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D
2.5 - 由于签名可能包含 / 和 =，这可能会导致发送请求时出现问题。 所以签名必须是 URL 编码的。
第2.6步
curl -H "X-MBX-APIKEY: vE3BDAL1gP1UaexugRLtteaAHg3UO8Nza20uexEuW1Kh3tVwQfFHdAiyjjY428o2" -X POST 'https://fapi.binance.com/fapi/v1/order?timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSDT&side=SELL&type=MARKET&quantity=1.23&signature=aap36wD5loVXizxvvPI3wz9Cjqwmb3KVbxoym0XeWG1jZq8umqrnSk8H8dkLQeySjgVY91Ufs%2BBGCW%2B4sZjQEpgAfjM76riNxjlD3coGGEsPsT2lG39R%2F1q72zpDs8pYcQ4A692NgHO1zXcgScTGgdkjp%2Brp2bcddKjyz5XBrBM%3D'
2.6 - curl 命令
Bash 脚本
#!/usr/bin/env bash
# 设置身份验证：
apiKey="vE3BDAL1gP1UaexugRLtteaAHg3UO8Nza20uexEuW1Kh3tVwQfFHdAiyjjY428o2" ### 替换成您的 API Key
# 设置您的请求:
apiMethod="POST"
apiCall="v1/order"
apiParams="timestamp=1671090801999&recvWindow=9999999&symbol=BTCUSDT&side=SELL&type=MARKET&quantity=1.23"
function rawurlencode {
local value="$1"
local len=${#value}
local encoded=""
local pos c o
for (( pos=0 ; pos do c=${value:$pos:1} case "$c" in [-_.~a-zA-Z0-9] ) o="${c}" ;; * ) printf -v o '%%%02x' "'$c" esac encoded+="$o" done echo "$encoded" } ts=$(date +%s000) paramsWithTs="$apiParams×tamp=$ts" rawSignature=$(echo -n "$paramsWithTs" \ | openssl dgst -keyform PEM -sha256 -sign ./test-prv-key.pem \ ### 替换成您的 Private Key。不要与任何人共享此文件。 | openssl enc -base64 \ | tr -d '\n') signature=$(rawurlencode "$rawSignature") curl -H "X-MBX-APIKEY: $apiKey" -X $apiMethod \ "https://fapi.binance.com/fapi/$apiCall?$paramsWithTs&signature=$signature" 右边有示例 Bash 脚本执行上述类似的步骤. 公开API参数术语解释 base asset 指一个交易对的交易对象，即写在靠前部分的资产名 quote asset 指一个交易对的定价资产，即写在靠后部分资产名 枚举定义 交易对类型: FUTURE 期货 合约类型 (contractType): PERPETUAL 永续合约 CURRENT_MONTH 当月交割合约 NEXT_MONTH 次月交割合约 CURRENT_QUARTER 当季交割合约 NEXT_QUARTER 次季交割合约 PERPETUAL_DELIVERING 交割结算中合约 合约状态 (contractStatus, status): PENDING_TRADING 待上市 TRADING 交易中 PRE_DELIVERING 预交割 DELIVERING 交割中 DELIVERED 已交割 PRE_SETTLE 预结算 SETTLING 结算中 CLOSE 已下架 订单状态 (status): NEW 新建订单 PARTIALLY_FILLED 部分成交 FILLED 全部成交 CANCELED 已撤销 REJECTED 订单被拒绝 EXPIRED 订单过期(根据timeInForce参数规则) EXPIRED_IN_MATCH 订单被STP过期 订单种类 (orderTypes, type): LIMIT 限价单 MARKET 市价单 STOP 止损限价单 STOP_MARKET 止损市价单 TAKE_PROFIT 止盈限价单 TAKE_PROFIT_MARKET 止盈市价单 TRAILING_STOP_MARKET 跟踪止损单 订单方向 (side): BUY 买入 SELL 卖出 持仓方向: BOTH 单一持仓方向 LONG 多头(双向持仓下) SHORT 空头(双向持仓下) 有效方式 (timeInForce): GTC - Good Till Cancel 成交为止 IOC - Immediate or Cancel 无法立即成交(吃单)的部分就撤销 FOK - Fill or Kill 无法全部立即成交就撤销 GTX - Good Till Crossing 无法成为挂单方就撤销 GTD - Good Till Date 在特定时间之前有效，到期自动撤销 条件价格触发类型 (workingType) MARK_PRICE CONTRACT_PRICE 响应类型 (newOrderRespType) ACK RESULT K线间隔: m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月 1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M 防止自成交模式: NONE EXPIRE_TAKER EXPIRE_BOTH EXPIRE_MAKER 盘口价下单模式: OPPONENT (盘口对手价) OPPONENT_5 (盘口对手5档价) OPPONENT_10 (盘口对手10档价) OPPONENT_20 QUEUE (盘口同向价) QUEUE_5 (盘口同向排队5档价) QUEUE_10 (盘口同向排队10档价) QUEUE_20 (盘口同向排队20档价) 限制种类 (rateLimitType) REQUEST_WEIGHT { "rateLimitType": "REQUEST_WEIGHT", "interval": "MINUTE", "intervalNum": 1, "limit": 2400 } ORDERS { "rateLimitType": "ORDERS", "interval": "MINUTE", "intervalNum": 1, "limit": 1200 } REQUESTS_WEIGHT 单位时间请求权重之和上限 ORDERS 单位时间下单(撤单)次数上限 限制间隔 MINUTE 过滤器 过滤器，即Filter，定义了一系列交易规则。 共有两类，分别是针对交易对的过滤器symbol filters，和针对整个交易所的过滤器exchange filters(暂不支持) 交易对过滤器PRICE_FILTER 价格过滤器 /exchangeInfo 响应中的格式: { "filterType": "PRICE_FILTER", "minPrice": "0.00000100", "maxPrice": "100000.00000000", "tickSize": "0.00000100" } 价格过滤器用于检测order订单中price参数的合法性 minPrice 定义了 price/stopPrice 允许的最小值 maxPrice 定义了 price/stopPrice 允许的最大值。 tickSize 定义了 price/stopPrice 的步进间隔，即price必须等于minPrice+(tickSize的整数倍) 以上每一项均可为0，为0时代表这一项不再做限制。 逻辑伪代码如下： price >= minPrice price <= maxPrice (price-minPrice) % tickSize == 0 LOT_SIZE 订单尺寸 /exchangeInfo 响应中的格式:* { "filterType": "LOT_SIZE", "minQty": "0.00100000", "maxQty": "100000.00000000", "stepSize": "0.00100000" } lots是拍卖术语，这个过滤器对订单中的quantity也就是数量参数进行合法性检查。包含三个部分： minQty 表示 quantity 允许的最小值. maxQty 表示 quantity 允许的最大值 stepSize 表示 quantity允许的步进值。 逻辑伪代码如下： quantity >= minQty quantity <= maxQty (quantity-minQty) % stepSize == 0 MARKET_LOT_SIZE 市价订单尺寸 参考LOT_SIZE，区别仅在于对市价单还是限价单生效 MAX_NUM_ORDERS 最多订单数 /exchangeInfo 响应中的格式: { "filterType": "MAX_NUM_ORDERS", "limit": 200 } 定义了某个交易对最多允许的挂单数量(不包括已关闭的订单) 普通订单与条件订单均计算在内 MAX_NUM_ALGO_ORDERS 最多条件订单数 /exchangeInfo format: { "filterType": "MAX_NUM_ALGO_ORDERS", "limit": 100 } 定义了某个交易对最多允许的条件订单的挂单数量(不包括已关闭的订单)。 条件订单目前包括STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET, 和 TRAILING_STOP_MARKET PERCENT_PRICE 价格振幅过滤器 /exchangeInfo 响应中的格式: { "filterType": "PERCENT_PRICE", "multiplierUp": "1.1500", "multiplierDown": "0.8500", "multiplierDecimal": 4 } PERCENT_PRICE 定义了基于标记价格计算的挂单价格的可接受区间. 挂单价格必须同时满足以下条件： 买单: price <= markPrice * multiplierUp 卖单: price >= markPrice * multiplierDown MIN_NOTIONAL 最小名义价值 /exchangeInfo 响应中的格式: { "filterType": "MIN_NOTIONAL", "notioanl": "5.0" } MIN_NOTIONAL过滤器定义了交易对订单所允许的最小名义价值(成交额)。 订单的名义价值是价格*数量。 由于MARKET订单没有价格，因此会使用 mark price 计算。 Postman Collections 现在你可以通过Postman collection来快速体验、使用API接口。 如果想了解更多如果使用Postman，请访问Binance API Postman 行情接口测试服务器连通性 PING GET /fapi/v1/ping 响应: {} 测试能否联通 权重: 1 参数: NONE 获取服务器时间 响应: { "serverTime": 1499827319559 // 当前的系统时间 } GET /fapi/v1/time 获取服务器时间 权重: 1 参数: NONE 获取交易规则和交易对 响应: { "exchangeFilters": [], "rateLimits": [ // API访问的限制 { "interval": "MINUTE", // 按照分钟计算 "intervalNum": 1, // 按照1分钟计算 "limit": 2400, // 上限次数 "rateLimitType": "REQUEST_WEIGHT" // 按照访问权重来计算 }, { "interval": "MINUTE", "intervalNum": 1, "limit": 1200, "rateLimitType": "ORDERS" // 按照订单数量来计算 } ], "serverTime": 1565613908500, // 请忽略。如果需要获取当前系统时间，请查询接口 “GET /fapi/v1/time” "assets": [ // 资产信息 { "asset": "BUSD", "marginAvailable": true, // 是否可用作保证金 "autoAssetExchange": 0 // 保证金资产自动兑换阈值 }, { "asset": "USDT", "marginAvailable": true, // 是否可用作保证金 "autoAssetExchange": 0 // 保证金资产自动兑换阈值 }, { "asset": "BNB", "marginAvailable": false, // 是否可用作保证金 "autoAssetExchange": null // 保证金资产自动兑换阈值 } ], "symbols": [ // 交易对信息 { "symbol": "BLZUSDT", // 交易对 "pair": "BLZUSDT", // 标的交易对 "contractType": "PERPETUAL", // 合约类型 "deliveryDate": 4133404800000, // 交割日期 "onboardDate": 1598252400000, // 上线日期 "status": "TRADING", // 交易对状态 "maintMarginPercent": "2.5000", // 请忽略 "requiredMarginPercent": "5.0000", // 请忽略 "baseAsset": "BLZ", // 标的资产 "quoteAsset": "USDT", // 报价资产 "marginAsset": "USDT", // 保证金资产 "pricePrecision": 5, // 价格小数点位数(仅作为系统精度使用，注意同tickSize 区分） "quantityPrecision": 0, // 数量小数点位数(仅作为系统精度使用，注意同stepSize 区分） "baseAssetPrecision": 8, // 标的资产精度 "quotePrecision": 8, // 报价资产精度 "underlyingType": "COIN", "underlyingSubType": ["STORAGE"], "settlePlan": 0, "triggerProtect": "0.15", // 开启"priceProtect"的条件订单的触发阈值 "filters": [ { "filterType": "PRICE_FILTER", // 价格限制 "maxPrice": "300", // 价格上限, 最大价格 "minPrice": "0.0001", // 价格下限, 最小价格 "tickSize": "0.0001" // 订单最小价格间隔 }, { "filterType": "LOT_SIZE", // 数量限制 "maxQty": "10000000", // 数量上限, 最大数量 "minQty": "1", // 数量下限, 最小数量 "stepSize": "1" // 订单最小数量间隔 }, { "filterType": "MARKET_LOT_SIZE", // 市价订单数量限制 "maxQty": "590119", // 数量上限, 最大数量 "minQty": "1", // 数量下限, 最小数量 "stepSize": "1" // 允许的步进值 }, { "filterType": "MAX_NUM_ORDERS", // 最多订单数限制 "limit": 200 }, { "filterType": "MAX_NUM_ALGO_ORDERS", // 最多条件订单数限制 "limit": 100 }, { "filterType": "MIN_NOTIONAL", // 最小名义价值 "notional": "5.0", }, { "filterType": "PERCENT_PRICE", // 价格比限制 "multiplierUp": "1.1500", // 价格上限百分比 "multiplierDown": "0.8500", // 价格下限百分比 "multiplierDecimal": 4 } ], "OrderType": [ // 订单类型 "LIMIT", // 限价单 "MARKET", // 市价单 "STOP", // 止损单 "STOP_MARKET", // 止损市价单 "TAKE_PROFIT", // 止盈单 "TAKE_PROFIT_MARKET", // 止盈暑市价单 "TRAILING_STOP_MARKET" // 跟踪止损市价单 ], "timeInForce": [ // 有效方式 "GTC", // 成交为止, 一直有效 "IOC", // 无法立即成交(吃单)的部分就撤销 "FOK", // 无法全部立即成交就撤销 "GTX" // 无法成为挂单方就撤销 ], "liquidationFee": "0.010000", // 强平费率 "marketTakeBound": "0.30", // 市价吃单(相对于标记价格)允许可造成的最大价格偏离比例 } ], "timezone": "UTC" // 服务器所用的时间区域 } GET /fapi/v1/exchangeInfo 获取交易规则和交易对 权重: 1 参数: NONE 深度信息 响应: { "lastUpdateId": 1027024, "E": 1589436922972, // 消息时间 "T": 1589436922959, // 撮合引擎时间 "bids": [ // 买单 [ "4.00000000", // 价格 "431.00000000" // 数量 ] ], "asks": [ // 卖单 [ "4.00000200", // 价格 "12.00000000" // 数量 ] ] } GET /fapi/v1/depth 权重: limit 权重 5, 10, 20, 50 2 100 5 500 10 1000 20 更新速率: 15ms 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 limit INT NO 默认 500; 可选值:[5, 10, 20, 50, 100, 500, 1000] 近期成交 响应: [ { "id": 28457, // 成交ID "price": "4.00000100", // 成交价格 "qty": "12.00000000", // 成交量 "quoteQty": "48.00", // 成交额 "time": 1499865549590, // 时间 "isBuyerMaker": true // 买方是否为挂单方 } ] GET /fapi/v1/trades 获取近期订单簿成交 权重: 5 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 limit INT NO 默认:500，最大1000 仅返回订单簿成交，即不会返回保险基金和自动减仓(ADL)成交 查询历史成交(MARKET_DATA) 响应: [ { "id": 28457, // 成交ID "price": "4.00000100", // 成交价格 "qty": "12.00000000", // 成交量 "quoteQty": "48.00", // 成交额 "time": 1499865549590, // 时间 "isBuyerMaker": true // 买方是否为挂单方 } ] GET /fapi/v1/historicalTrades 查询订单簿历史成交 权重: 20 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 limit INT NO 默认值:500 最大值:1000. fromId LONG NO 从哪一条成交id开始返回. 缺省返回最近的成交记录 仅返回订单簿成交，即不会返回保险基金和自动减仓(ADL)成交 仅支持返回最近3个月的数据(目前最早的时间为2023-11-21 00:00:00) 近期成交(归集) 响应: [ { "a": 26129, // 归集成交ID "p": "0.01633102", // 成交价 "q": "4.70443515", // 成交量 "f": 27781, // 被归集的首个成交ID "l": 27781, // 被归集的末个成交ID "T": 1498793709153, // 成交时间 "m": true, // 是否为主动卖出单 } ] GET /fapi/v1/aggTrades 归集交易与逐笔交易的区别在于，同一价格、同一方向、同一时间(100ms计算)的订单簿trade会被聚合为一条 权重: 20 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 fromId LONG NO 从包含fromID的成交开始返回结果 startTime LONG NO 从该时刻之后的成交记录开始返回结果 endTime LONG NO 返回该时刻为止的成交记录 limit INT NO 默认 500; 最大 1000. 如果同时发送startTime和endTime，间隔必须小于一小时 如果没有发送任何筛选参数(fromId, startTime, endTime)，默认返回最近的成交记录 保险基金和自动减仓(ADL)成交不属于订单簿成交，故不会被归并聚合 同时发送startTime/endTime和fromId可能导致请求超时，建议仅发送fromId或仅发送startTime和endTime K线数据 响应: [ [ 1499040000000, // 开盘时间 "0.01634790", // 开盘价 "0.80000000", // 最高价 "0.01575800", // 最低价 "0.01577100", // 收盘价(当前K线未结束的即为最新价) "148976.11427815", // 成交量 1499644799999, // 收盘时间 "2434.19055334", // 成交额 308, // 成交笔数 "1756.87402397", // 主动买入成交量 "28.46694368", // 主动买入成交额 "17928899.62484339" // 请忽略该参数 ] ] GET /fapi/v1/klines 每根K线的开盘时间可视为唯一ID 权重: 取决于请求中的LIMIT参数 LIMIT参数 权重 [1,100) 1 [100, 500) 2 [500, 1000] 5 > 1000 10 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 interval ENUM YES 时间间隔 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 默认值:500 最大值:1500. 缺省返回最近的数据 连续合约K线数据 响应: [ [ 1607444700000, // 开盘时间 "18879.99", // 开盘价 "18900.00", // 最高价 "18878.98", // 最低价 "18896.13", // 收盘价(当前K线未结束的即为最新价) "492.363", // 成交量 1607444759999, // 收盘时间 "9302145.66080", // 成交额 1874, // 成交笔数 "385.983", // 主动买入成交量 "7292402.33267", // 主动买入成交额 "0" // 请忽略该参数 ] ] GET /fapi/v1/continuousKlines 每根K线的开盘时间可视为唯一ID 权重: 取决于请求中的LIMIT参数 LIMIT参数 权重 [1,100) 1 [100, 500) 2 [500, 1000] 5 > 1000 10 参数: 名称 类型 是否必需 描述 pair STRING YES 标的交易对 contractType ENUM YES 合约类型 interval ENUM YES 时间间隔 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 默认值:500 最大值:1500 缺省返回最近的数据 合约类型: PERPETUAL 永续合约 CURRENT_QUARTER 当季交割合约 NEXT_QUARTER 次季交割合约 价格指数K线数据 响应: [ [ 1591256400000, // 开盘时间 "9653.69440000", // 开盘价 "9653.69640000", // 最高价 "9651.38600000", // 最低价 "9651.55200000", // 收盘价(当前K线未结束的即为最新价) "0 ", // 请忽略 1591256459999, // 收盘时间 "0", // 请忽略 60, // 请忽略 "0", // 请忽略 "0", // 请忽略 "0" // 请忽略 ] ] GET /fapi/v1/indexPriceKlines 每根K线的开盘时间可视为唯一ID 权重: 取决于请求中的LIMIT参数 LIMIT参数 权重 [1,100) 1 [100, 500) 2 [500, 1000] 5 > 1000 10 参数: 名称 类型 是否必需 描述 pair STRING YES 标的交易对 interval ENUM YES 时间间隔 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 默认值:500 最大值:1500 缺省返回最近的数据 标记价格K线数据 响应: [ [ 1591256400000, // 开盘时间 "9653.69440000", // 开盘价 "9653.69640000", // 最高价 "9651.38600000", // 最低价 "9651.55200000", // 收盘价(当前K线未结束的即为最新价) "0 ", // 请忽略 1591256459999, // 收盘时间 "0", // 请忽略 60, // 请忽略 "0", // 请忽略 "0", // 请忽略 "0" // 请忽略 ] ] GET /fapi/v1/markPriceKlines 每根K线的开盘时间可视为唯一ID 权重: 取决于请求中的LIMIT参数 LIMIT参数 权重 [1,100) 1 [100, 500) 2 [500, 1000] 5 > 1000 10 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 interval ENUM YES 时间间隔 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 默认值:500 最大值:1500 缺省返回最近的数据 溢价指数K线数据 响应: [ [ 1691603820000, // 开盘时间 "-0.00042931", // 开盘价 "-0.00023641", // 最高价 "-0.00059406", // 最低价 "-0.00043659", // 收盘价 "0", // 请忽略 1691603879999, // 收盘时间 "0", // 请忽略 12, // 请忽略 "0", // 请忽略 "0", // 请忽略 "0" // 请忽略 ] ] GET /fapi/v1/premiumIndexKlines 合约溢价指数K线。每根K线的开盘时间可视为唯一ID。 权重: 取决于请求中的LIMIT参数 LIMIT参数 权重 [1,100) 1 [100, 500) 2 [500, 1000] 5 > 1000 10 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 interval ENUM YES 时间间隔 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 默认值:500 最大值:1500 缺省返回最近的数据 最新标记价格和资金费率 响应: { "symbol": "BTCUSDT", // 交易对 "markPrice": "11793.63104562", // 标记价格 "indexPrice": "11781.80495970", // 指数价格 "estimatedSettlePrice": "11781.16138815", // 预估结算价,仅在交割开始前最后一小时有意义 "lastFundingRate": "0.00038246", // 最近更新的资金费率 "nextFundingTime": 1597392000000, // 下次资金费时间 "interestRate": "0.00010000", // 标的资产基础利率 "time": 1597370495002 // 更新时间 } 当不指定symbol时相应 [ { "symbol": "BTCUSDT", // 交易对 "markPrice": "11793.63104562", // 标记价格 "indexPrice": "11781.80495970", // 指数价格 "estimatedSettlePrice": "11781.16138815", // 预估结算价,仅在交割开始前最后一小时有意义 "lastFundingRate": "0.00038246", // 最近更新的预估资金费率 "nextFundingTime": 1597392000000, // 下次资金费时间 "interestRate": "0.00010000", // 标的资产基础利率 "time": 1597370495002 // 更新时间 } ] GET /fapi/v1/premiumIndex 采集各大交易所数据加权平均 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 查询资金费率历史 响应: [ { "symbol": "BTCUSDT", // 交易对 "fundingTime": 1698768000000, // 资金费率 "fundingRate": "0.00010000", // 资金费时间 "markPrice": "34287.54619963" // 资金费对应标记价格 }, { "symbol": "BTCUSDT", "fundingTime": 1698796800000, "fundingRate": "0.00010000", "markPrice": "34651.40000000" } ] GET /fapi/v1/fundingRate 频率限制 500/5min/IP 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 默认值:100 最大值:1000 如果 startTime 和 endTime 都未发送, 返回最近 limit 条数据. 如果 startTime 和 endTime 之间的数据量大于 limit, 返回 startTime + limit情况下的数据。 查询资金费率信息 响应: [ { "symbol": "BLZUSDT", "adjustedFundingRateCap": "0.02500000", "adjustedFundingRateFloor": "-0.02500000", "fundingIntervalHours": 8, "disclaimer": false } ] GET /fapi/v1/fundingInfo 频率限制 500/5min/IP 查询资金费率信息，接口仅返回FundingRateCap/FundingRateFloor/fundingIntervalHours被特殊调整过的交易对。 24hr价格变动情况 响应: { "symbol": "BTCUSDT", "priceChange": "-94.99999800", //24小时价格变动 "priceChangePercent": "-95.960", //24小时价格变动百分比 "weightedAvgPrice": "0.29628482", //加权平均价 "lastPrice": "4.00000200", //最近一次成交价 "lastQty": "200.00000000", //最近一次成交额 "openPrice": "99.00000000", //24小时内第一次成交的价格 "highPrice": "100.00000000", //24小时最高价 "lowPrice": "0.10000000", //24小时最低价 "volume": "8913.30000000", //24小时成交量 "quoteVolume": "15.30000000", //24小时成交额 "openTime": 1499783499040, //24小时内，第一笔交易的发生时间 "closeTime": 1499869899040, //24小时内，最后一笔交易的发生时间 "firstId": 28385, // 首笔成交id "lastId": 28460, // 末笔成交id "count": 76 // 成交笔数 } 或(当不发送交易对信息) [ { "symbol": "BTCUSDT", "priceChange": "-94.99999800", //24小时价格变动 "priceChangePercent": "-95.960", //24小时价格变动百分比 "weightedAvgPrice": "0.29628482", //加权平均价 "lastPrice": "4.00000200", //最近一次成交价 "lastQty": "200.00000000", //最近一次成交额 "openPrice": "99.00000000", //24小时内第一次成交的价格 "highPrice": "100.00000000", //24小时最高价 "lowPrice": "0.10000000", //24小时最低价 "volume": "8913.30000000", //24小时成交量 "quoteVolume": "15.30000000", //24小时成交额 "openTime": 1499783499040, //24小时内，第一笔交易的发生时间 "closeTime": 1499869899040, //24小时内，最后一笔交易的发生时间 "firstId": 28385, // 首笔成交id "lastId": 28460, // 末笔成交id "count": 76 // 成交笔数 } ] GET /fapi/v1/ticker/24hr 请注意，不携带symbol参数会返回全部交易对数据，不仅数据庞大，而且权重极高 权重: * 带symbol为1 * 不带为40 更新速率: 5s 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 不发送交易对参数，则会返回所有交易对信息 最新价格 响应: { "symbol": "LTCBTC", // 交易对 "price": "4.00000200", // 价格 "time": 1589437530011 // 撮合引擎时间 } 或(当不发送symbol) [ { "symbol": "BTCUSDT", // 交易对 "price": "6000.01", // 价格 "time": 1589437530011 // 撮合引擎时间 } ] GET /fapi/v1/ticker/price 返回最近价格 权重: * 单交易对1 * 无交易对2 更新速率: 5s 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 不发送交易对参数，则会返回所有交易对信息 最新价格V2 响应: { "symbol": "LTCBTC", // 交易对 "price": "4.00000200", // 价格 "time": 1589437530011 // 撮合引擎时间 } 或(当不发送symbol) [ { "symbol": "BTCUSDT", // 交易对 "price": "6000.01", // 价格 "time": 1589437530011 // 撮合引擎时间 } ] GET /fapi/v2/ticker/price 返回最近价格 权重: * 单交易对1 * 无交易对2 更新速率: 实时 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 不发送交易对参数，则会返回所有交易对信息 当前最优挂单 响应: { "lastUpdateId": 1027024, "symbol": "BTCUSDT", // 交易对 "bidPrice": "4.00000000", //最优买单价 "bidQty": "431.00000000", //挂单量 "askPrice": "4.00000200", //最优卖单价 "askQty": "9.00000000", //挂单量 "time": 1589437530011 // 撮合引擎时间 } 或(当不发送symbol) [ { "lastUpdateId": 1027024, "symbol": "BTCUSDT", // 交易对 "bidPrice": "4.00000000", //最优买单价 "bidQty": "431.00000000", //挂单量 "askPrice": "4.00000200", //最优卖单价 "askQty": "9.00000000", //挂单量 "time": 1589437530011 // 撮合引擎时间 } ] GET /fapi/v1/ticker/bookTicker 返回当前最优的挂单(最高买单，最低卖单) 权重: * 单交易对2 * 无交易对5 更新速率: 实时 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 不发送交易对参数，则会返回所有交易对信息 该接口返回头中的X-MBX-USED-WEIGHT-1M参数不准确，可以忽略 获取未平仓合约数 响应: { "openInterest": "10659.509", // 未平仓合约数量 "symbol": "BTCUSDT", // 交易对 "time": 1589437530011 // 撮合引擎时间 } GET /fapi/v1/openInterest 权重: 1 更新速率: 3s 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 季度合约历史结算价 响应: [ { "deliveryPrice": 27101.10000000, "deliveryTime": 1695945600000 }, { "deliveryPrice": 30729.40000000, "deliveryTime": 1688083200000 }, { "deliveryPrice": 27823.70000000, "deliveryTime": 1680220800000 }, { "deliveryPrice": 44094.70000000, "deliveryTime": 1648166400000 } ] GET /futures/data/delivery-price 参数: 名称 类型 是否必需 描述 pair STRING YES 如BTCUSDT 合约持仓量 响应: [ { "symbol":"BTCUSDT", "sumOpenInterest":"20403.12345678",// 持仓总数量 "sumOpenInterestValue": "176196512.12345678", // 持仓总价值 "timestamp":"1583127900000" }, { "symbol":"BTCUSDT", "sumOpenInterest":"20401.36700000", "sumOpenInterestValue":"149940752.14464448", "timestamp":"1583128200000" }, ] GET /futures/data/openInterestHist 参数: 名称 类型 是否必需 描述 symbol STRING YES period ENUM YES "5m","15m","30m","1h","2h","4h","6h","12h","1d" limit LONG NO default 30, max 500 startTime LONG NO endTime LONG NO 若无 startime 和 endtime 限制， 则默认返回当前时间往前的limit值 仅支持最近30天的数据 IP限频为1000次/5min 大户账户数多空比 响应: [ { "symbol":"BTCUSDT", "longShortRatio":"1.8105",// 大户多空账户数比值 "longAccount": "0.6442", // 大户多仓账户数比例 "shortAccount":"0.3558", // 大户空仓账户数比例 "timestamp":"1583139600000" }, { "symbol":"BTCUSDT", "longShortRatio":"1.8233", "longAccount": "0.5338", "shortAccount":"0.3454", "timestamp":"1583139900000" }, ] GET /futures/data/topLongShortAccountRatio 参数: 名称 类型 是否必需 描述 symbol STRING YES period ENUM YES "5m","15m","30m","1h","2h","4h","6h","12h","1d" limit LONG NO default 30, max 500 startTime LONG NO endTime LONG NO 若无 startime 和 endtime 限制， 则默认返回当前时间往前的limit值 仅支持最近30天的数据 IP限频为1000次/5min 大户持仓量多空比 响应: [ { "symbol":"BTCUSDT", "longShortRatio":"1.4342",// 大户多空持仓量比值 "longAccount": "0.5344", // 大户多仓持仓量比例 "shortAccount":"0.4656", // 大户空仓持仓量比例 "timestamp":"1583139600000" }, { "symbol":"BTCUSDT", "longShortRatio":"1.4337", "longAccount": "0.5891", "shortAccount":"0.4108", "timestamp":"1583139900000" }, ] GET /futures/data/topLongShortPositionRatio 参数: 名称 类型 是否必需 描述 symbol STRING YES period ENUM YES "5m","15m","30m","1h","2h","4h","6h","12h","1d" limit LONG NO default 30, max 500 startTime LONG NO endTime LONG NO 若无 startime 和 endtime 限制， 则默认返回当前时间往前的limit值 仅支持最近30天的数据 IP限频为1000次/5min 多空持仓人数比 响应: [ { "symbol":"BTCUSDT", "longShortRatio":"0.1960", // 多空人数比值 "longAccount": "0.6622", // 多仓人数比例 "shortAccount":"0.3378", // 空仓人数比例 "timestamp":"1583139600000" }, { "symbol":"BTCUSDT", "longShortRatio":"1.9559", "longAccount": "0.6617", "shortAccount":"0.3382", "timestamp":"1583139900000" }, ] GET /futures/data/globalLongShortAccountRatio 参数: 名称 类型 是否必需 描述 symbol STRING YES period ENUM YES "5m","15m","30m","1h","2h","4h","6h","12h","1d" limit LONG NO default 30, max 500 startTime LONG NO endTime LONG NO 若无 startime 和 endtime 限制， 则默认返回当前时间往前的limit值 仅支持最近30天的数据 IP限频为1000次/5min 合约主动买卖量 响应: [ { "buySellRatio":"1.5586", "buyVol": "387.3300", // 主动买入量 "sellVol":"248.5030", // 主动卖出量 "timestamp":"1585614900000" }, { "buySellRatio":"1.3104", "buyVol": "343.9290", "sellVol":"248.5030", "timestamp":"1583139900000" }, ] GET /futures/data/takerlongshortRatio 参数: 名称 类型 是否必需 描述 symbol STRING YES period ENUM YES "5m","15m","30m","1h","2h","4h","6h","12h","1d" limit LONG NO default 30, max 500 startTime LONG NO endTime LONG NO 若无 startime 和 endtime 限制， 则默认返回当前时间往前的limit值 仅支持最近30天的数据 IP限频为1000次/5min 基差 响应: [ { "indexPrice": "34400.15945055", "contractType": "PERPETUAL", "basisRate": "0.0004", "futuresPrice": "34414.10", "annualizedBasisRate": "", "basis": "13.94054945", "pair": "BTCUSDT", "timestamp": 1698742800000 } ] GET /futures/data/basis 参数: 名称 类型 是否必需 描述 pair STRING YES BTCUSDT contractType ENUM YES CURRENT_QUARTER, NEXT_QUARTER, PERPETUAL period ENUM YES "5m","15m","30m","1h","2h","4h","6h","12h","1d" limit LONG NO Default 30,Max 500 startTime LONG NO endTime LONG NO 若无 startime 和 endtime 限制， 则默认返回当前时间往前的limit值 仅支持最近30天的数据 杠杆代币历史净值K线 响应: [ [ 1598371200000, // 开盘时间 "5.88275270", // 开盘净值 "6.03142087", // 最高净值 "5.85749741", // 最低净值 "5.99403551", // 收盘净值(当前K线未结束的即为最新净值) "2.28602984", // 收盘真实杠杆 1598374799999, // 收盘时间 "0", // 请忽略 6209, // 净值更新笔数 "14517.64507907", // 请忽略 "0", // 请忽略 "0" // 请忽略 ] ] GET /fapi/v1/lvtKlines 杠杆代币净值系统基于合约架构，故该接口采用fapi 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES token name, e.g. "BTCDOWN", "BTCUP" interval ENUM YES startTime LONG NO endTime LONG NO limit INT NO 默认 500, 最大 1000 如果未发送 startTime 和 endTime ，默认返回最近的交易 综合指数交易对信息 响应: [ { "symbol": "DEFIUSDT", "time": 1589437530011, // 请求时间 "component": "baseAsset", //成分资产 "baseAssetList":[ { "baseAsset":"BAL", // 基础资产 "quoteAsset": "USDT", // 报价资产 "weightInQuantity":"1.04406228", //权重(数量) "weightInPercentage":"0.02783900" //权重(比例) }, { "baseAsset":"BAND", "quoteAsset": "USDT", "weightInQuantity":"3.53782729", "weightInPercentage":"0.03935200" } ] } ] 获取交易对为综合指数的基础成分信息。 GET /fapi/v1/indexInfo 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING NO 多资产模式资产汇率指数 响应: { "symbol": "ADAUSD", "time": 1635740268004, "index": "1.92957370", "bidBuffer": "0.10000000", "askBuffer": "0.10000000", "bidRate": "1.73661633", "askRate": "2.12253107", "autoExchangeBidBuffer": "0.05000000", "autoExchangeAskBuffer": "0.05000000", "autoExchangeBidRate": "1.83309501", "autoExchangeAskRate": "2.02605238" } 或(当不发送交易对信息) [ { "symbol": "ADAUSD", "time": 1635740268004, "index": "1.92957370", "bidBuffer": "0.10000000", "askBuffer": "0.10000000", "bidRate": "1.73661633", "askRate": "2.12253107", "autoExchangeBidBuffer": "0.05000000", "autoExchangeAskBuffer": "0.05000000", "autoExchangeBidRate": "1.83309501", "autoExchangeAskRate": "2.02605238" } ] GET /fapi/v1/assetIndex 多资产模式资产汇率指数 权重: 带symbol为1, 不带为10 参数: 名称 类型 是否必需 描述 symbol STRING NO 资产对 查询指数价格成分 响应: { "symbol": "BTCUSDT", "time": 1697421272043, "constituents": [ { "exchange": "binance", "symbol": "BTCUSDT" }, { "exchange": "okex", "symbol": "BTC-USDT" }, { "exchange": "huobi", "symbol": "btcusdt" }, { "exchange": "coinbase", "symbol": "BTC-USDT" } ] } GET /fapi/v1/constituents 查询指数价格成分 权重: 2 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 Websocket 行情推送 本篇所列出的所有wss接口，需用以下连接方式： Base Url：wss://fstream.binance.com 订阅单一stream格式为 /ws/ 组合streams的URL格式为 /stream?streams= 连接样例： wss://fstream.binance.com/ws/bnbusdt@aggTrade wss://fstream.binance.com/stream?streams=bnbusdt@aggTrade/btcusdt@markPrice 订阅组合streams时，事件payload会以这样的格式封装 {"stream":" stream名称中所有交易对均为小写。 每个链接有效期不超过24小时，请妥善处理断线重连。 Websocket 服务器每3分钟发送Ping消息。 如果Websocket服务器在10分钟之内没有收到Pong消息应答，连接会被断开。 当客户收到ping消息，必需尽快回复pong消息，同时payload需要和ping消息一致。 未经请求的pong消息是被允许的，但是不会保证连接不断开。对于这些pong消息，建议payload为空 Websocket服务器每秒最多接受10个订阅消息。 如果用户发送的消息超过限制，连接会被断开连接。反复被断开连接的IP有可能被服务器屏蔽。 单个连接不建议订阅超过 200 个Streams。 实时订阅/取消数据流 以下数据可以通过websocket发送以实现订阅或取消订阅数据流。示例如下。 响应内容中的id是无符号整数，作为往来信息的唯一标识。 订阅一个信息流 响应 { "result": null, "id": 1 } 请求 { "method": "SUBSCRIBE", "params": [ "btcusdt@aggTrade", "btcusdt@depth" ], "id": 1 } 取消订阅一个信息流 响应 { "result": null, "id": 312 } 请求 { "method": "UNSUBSCRIBE", "params": [ "btcusdt@depth" ], "id": 312 } 已订阅信息流 响应 { "result": [ "btcusdt@aggTrade" ], "id": 3 } 请求 { "method": "LIST_SUBSCRIPTIONS", "id": 3 } 设定属性 当前，唯一可以设置的属性是设置是否启用combined("组合")信息流。 当使用/ws/("原始信息流")进行连接时，combined属性设置为false，而使用 /stream/进行连接时则将属性设置为true。 响应 { "result": null "id": 5 } 请求 { "method": "SET_PROPERTY", "params": [ "combined", true ], "id": 5 } 检索属性 响应 { "result": true, // Indicates that combined is set to true. "id": 2 } 请求 { "method": "GET_PROPERTY", "params": [ "combined" ], "id": 2 } 错误信息 错误信息 描述 {"code": 0, "msg": "Unknown property"} SET_PROPERTY 或 GET_PROPERTY中应用的参数无效 {"code": 1, "msg": "Invalid value type: expected Boolean"} 仅接受true或false {"code": 2, "msg": "Invalid request: property name must be a string"} 提供的属性名无效 {"code": 2, "msg": "Invalid request: request ID must be an unsigned integer"} 参数id未提供或id值是无效类型 {"code": 2, "msg": "Invalid request: unknown variant %s, expected one of SUBSCRIBE, UNSUBSCRIBE, LIST_SUBSCRIPTIONS, SET_PROPERTY, GET_PROPERTY at line 1 column 28"} 错字提醒，或提供的值不是预期类型 {"code": 2, "msg": "Invalid request: too many parameters"} 数据中提供了不必要参数 {"code": 2, "msg": "Invalid request: property name must be a string"} 未提供属性名 {"code": 2, "msg": "Invalid request: missing field method at line 1 column 73"} 数据未提供method {"code":3,"msg":"Invalid JSON: expected value at line %s column %s"} JSON 语法有误. 最新合约价格 aggTrade中的价格'p'或ticker/miniTicker中的价格'c'均可以作为最新成交价。 归集交易 Payload: { "e": "aggTrade", // 事件类型 "E": 123456789, // 事件时间 "s": "BNBUSDT", // 交易对 "a": 5933014, // 归集成交 ID "p": "0.001", // 成交价格 "q": "100", // 成交量 "f": 100, // 被归集的首个交易ID "l": 105, // 被归集的末次交易ID "T": 123456785, // 成交时间 "m": true // 买方是否是做市方。如true，则此次成交是一个主动卖出单，否则是一个主动买入单。 } 同一价格、同一方向、同一时间(100ms计算)的trade会被聚合为一条. Stream Name: Update Speed: 100ms 最新标记价格 Payload: { "e": "markPriceUpdate", // 事件类型 "E": 1562305380000, // 事件时间 "s": "BTCUSDT", // 交易对 "p": "11794.15000000", // 标记价格 "i": "11784.62659091", // 现货指数价格 "P": "11784.25641265", // 预估结算价,仅在结算前最后一小时有参考价值 "r": "0.00038167", // 资金费率 "T": 1562306400000 // 下次资金时间 } Stream Name: Update Speed: 3000ms 或 1000ms 全市场最新标记价格 Payload: [ { "e": "markPriceUpdate", // 事件类型 "E": 1562305380000, // 事件时间 "s": "BTCUSDT", // 交易对 "p": "11185.87786614", // 标记价格 "i": "11784.62659091" // 现货指数价格 "P": "11784.25641265", // 预估结算价,仅在结算前最后一小时有参考价值 "r": "0.00030000", // 资金费率 "T": 1562306400000 // 下个资金时间 } ] Stream Name: !markPrice@arr 或 !markPrice@arr@1s Update Speed: 3000ms 或 1000ms K线 Payload: { "e": "kline", // 事件类型 "E": 123456789, // 事件时间 "s": "BNBUSDT", // 交易对 "k": { "t": 123400000, // 这根K线的起始时间 "T": 123460000, // 这根K线的结束时间 "s": "BNBUSDT", // 交易对 "i": "1m", // K线间隔 "f": 100, // 这根K线期间第一笔成交ID "L": 200, // 这根K线期间末一笔成交ID "o": "0.0010", // 这根K线期间第一笔成交价 "c": "0.0020", // 这根K线期间末一笔成交价 "h": "0.0025", // 这根K线期间最高成交价 "l": "0.0015", // 这根K线期间最低成交价 "v": "1000", // 这根K线期间成交量 "n": 100, // 这根K线期间成交笔数 "x": false, // 这根K线是否完结(是否已经开始下一根K线) "q": "1.0000", // 这根K线期间成交额 "V": "500", // 主动买入的成交量 "Q": "0.500", // 主动买入的成交额 "B": "123456" // 忽略此参数 } } K线stream逐秒推送所请求的K线种类(最新一根K线)的更新。推送间隔250毫秒(如有刷新) 订阅Kline需要提供间隔参数，最短为分钟线，最长为月线。支持以下间隔: m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月 1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M Stream Name: Update Speed: 250ms 连续合约K线 Payload: { "e":"continuous_kline", // 事件类型 "E":1607443058651, // 事件时间 "ps":"BTCUSDT", // 标的交易对 "ct":"PERPETUAL", // 合约类型 "k":{ "t":1607443020000, // 这根K线的起始时间 "T":1607443079999, // 这根K线的结束时间 "i":"1m", // K线间隔 "f":116467658886, // 这根K线期间第一笔更新ID "L":116468012423, // 这根K线期间末一笔更新ID "o":"18787.00", // 这根K线期间第一笔成交价 "c":"18804.04", // 这根K线期间末一笔成交价 "h":"18804.04", // 这根K线期间最高成交价 "l":"18786.54", // 这根K线期间最低成交价 "v":"197.664", // 这根K线期间成交量 "n":543, // 这根K线期间成交笔数 "x":false, // 这根K线是否完结(是否已经开始下一根K线) "q":"3715253.19494", // 这根K线期间成交额 "V":"184.769", // 主动买入的成交量 "Q":"3472925.84746", // 主动买入的成交额 "B":"0" // 忽略此参数 } } K线stream逐秒推送所请求的K线种类(最新一根K线)的更新。 合约类型: perpetual 永续合约 current_quarter 当季交割合约 next_quarter 次季交割合约 订阅Kline需要提供间隔参数,最短为分钟线,最长为月线。支持以下间隔: m -> 分钟; h -> 小时; d -> 天; w -> 周; M -> 月 1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1M Stream Name: Update Speed: 250ms 按Symbol的精简Ticker Payload: { "e": "24hrMiniTicker", // 事件类型 "E": 123456789, // 事件时间(毫秒) "s": "BNBUSDT", // 交易对 "c": "0.0025", // 最新成交价格 "o": "0.0010", // 24小时前开始第一笔成交价格 "h": "0.0025", // 24小时内最高成交价 "l": "0.0010", // 24小时内最低成交价 "v": "10000", // 成交量 "q": "18" // 成交额 } 按Symbol刷新的24小时精简ticker信息. Stream Name: Update Speed: 500ms 全市场的精简Ticker Payload: [ { "e": "24hrMiniTicker", // 事件类型 "E": 123456789, // 事件时间(毫秒) "s": "BNBUSDT", // 交易对 "c": "0.0025", // 最新成交价格 "o": "0.0010", // 24小时前开始第一笔成交价格 "h": "0.0025", // 24小时内最高成交价 "l": "0.0010", // 24小时内最低成交价 "v": "10000", // 成交量 "q": "18" // 成交额 } ] 所有symbol24小时精简ticker信息.需要注意的是，只有发生变化的ticker更新才会被推送。 Stream Name: !miniTicker@arr Update Speed: 1000ms 按Symbol的完整Ticker Payload: { "e": "24hrTicker", // 事件类型 "E": 123456789, // 事件时间 "s": "BNBUSDT", // 交易对 "p": "0.0015", // 24小时价格变化 "P": "250.00", // 24小时价格变化(百分比) "w": "0.0018", // 平均价格 "c": "0.0025", // 最新成交价格 "Q": "10", // 最新成交价格上的成交量 "o": "0.0010", // 24小时内第一比成交的价格 "h": "0.0025", // 24小时内最高成交价 "l": "0.0010", // 24小时内最低成交价 "v": "10000", // 24小时内成交量 "q": "18", // 24小时内成交额 "O": 0, // 统计开始时间 "C": 86400000, // 统计关闭时间 "F": 0, // 24小时内第一笔成交交易ID "L": 18150, // 24小时内最后一笔成交交易ID "n": 18151 // 24小时内成交数 } 按Symbol刷新的24小时完整ticker信息 Stream Name: Update Speed: 2000ms 全市场的完整Ticker Payload: [ { "e": "24hrTicker", // 事件类型 "E": 123456789, // 事件时间 "s": "BNBUSDT", // 交易对 "p": "0.0015", // 24小时价格变化 "P": "250.00", // 24小时价格变化(百分比) "w": "0.0018", // 平均价格 "c": "0.0025", // 最新成交价格 "Q": "10", // 最新成交价格上的成交量 "o": "0.0010", // 24小时内第一比成交的价格 "h": "0.0025", // 24小时内最高成交价 "l": "0.0010", // 24小时内最低成交价 "v": "10000", // 24小时内成交量 "q": "18", // 24小时内成交额 "O": 0, // 统计开始时间 "C": 86400000, // 统计结束时间 "F": 0, // 24小时内第一笔成交交易ID "L": 18150, // 24小时内最后一笔成交交易ID "n": 18151 // 24小时内成交数 } ] 所有symbol 24小时完整ticker信息.需要注意的是，只有发生变化的ticker更新才会被推送。 Stream Name: !ticker@arr Update Speed: 1000ms 按Symbol的最优挂单信息 Payload: { "e":"bookTicker", // 事件类型 "u":400900217, // 更新ID "E": 1568014460893, // 事件推送时间 "T": 1568014460891, // 撮合时间 "s":"BNBUSDT", // 交易对 "b":"25.35190000", // 买单最优挂单价格 "B":"31.21000000", // 买单最优挂单数量 "a":"25.36520000", // 卖单最优挂单价格 "A":"40.66000000" // 卖单最优挂单数量 } 实时推送指定交易对最优挂单信息 Stream Name: Update Speed: 实时 全市场最优挂单信息 Payload: { // Same as } 所有交易对交易对最优挂单信息 Stream Name: !bookTicker Update Speed: 实时， 将于2023-12-20改为5s 强平订单 Payload: { "e":"forceOrder", // 事件类型 "E":1568014460893, // 事件时间 "o":{ "s":"BTCUSDT", // 交易对 "S":"SELL", // 订单方向 "o":"LIMIT", // 订单类型 "f":"IOC", // 有效方式 "q":"0.014", // 订单数量 "p":"9910", // 订单价格 "ap":"9910", // 平均价格 "X":"FILLED", // 订单状态 "l":"0.014", // 订单最近成交量 "z":"0.014", // 订单累计成交量 "T":1568014460893, // 交易时间 } } 推送特定symbol的强平订单快照信息。 1000ms内至多仅推送一条最近的强平订单作为快照 Stream Name: Update Speed: 1000ms 全市场强平订单 Payload: { "e":"forceOrder", // 事件类型 "E":1568014460893, // 事件时间 "o":{ "s":"BTCUSDT", // 交易对 "S":"SELL", // 订单方向 "o":"LIMIT", // 订单类型 "f":"IOC", // 有效方式 "q":"0.014", // 订单数量 "p":"9910", // 订单价格 "ap":"9910", // 平均价格 "X":"FILLED", // 订单状态 "l":"0.014", // 订单最近成交量 "z":"0.014", // 订单累计成交量 "T":1568014460893, // 交易时间 } } 推送全市场强平订单快照信息 每个symbol，1000ms内至多仅推送一条最近的强平订单作为快照 Stream Name: !forceOrder@arr Update Speed: 实时 有限档深度信息 Payload: { "e": "depthUpdate", // 事件类型 "E": 1571889248277, // 事件时间 "T": 1571889248276, // 交易时间 "s": "BTCUSDT", "U": 390497796, "u": 390497878, "pu": 390497794, "b": [ // 买方 [ "7403.89", // 价格 "0.002" // 数量 ], [ "7403.90", "3.906" ], [ "7404.00", "1.428" ], [ "7404.85", "5.239" ], [ "7405.43", "2.562" ] ], "a": [ // 卖方 [ "7405.96", // 价格 "3.340" // 数量 ], [ "7406.63", "4.525" ], [ "7407.08", "2.475" ], [ "7407.15", "4.800" ], [ "7407.20", "0.175" ] ] } 推送有限档深度信息。levels表示几档买卖单信息, 可选 5/10/20档 Stream Names: Update Speed: 250ms 或 500ms 或 100ms 增量深度信息 Payload: { "e": "depthUpdate", // 事件类型 "E": 123456789, // 事件时间 "T": 123456788, // 撮合时间 "s": "BNBUSDT", // 交易对 "U": 157, // 从上次推送至今新增的第一个 update Id "u": 160, // 从上次推送至今新增的最后一个 update Id "pu": 149, // 上次推送的最后一个update Id(即上条消息的‘u’) "b": [ // 变动的买单深度 [ "0.0024", // 价格 "10" // 数量 ] ], "a": [ // 变动的卖单深度 [ "0.0026", // 价格 "100" // 数量 ] ] } orderbook的变化部分，推送间隔250毫秒,500毫秒，100毫秒(如有刷新) Stream Names: Update Speed: 250ms 或 500ms 或 100ms 如何正确在本地维护一个orderbook副本 订阅 wss://fstream.binance.com/stream?streams=btcusdt@depth 开始缓存收到的更新。同一个价位，后收到的更新覆盖前面的。 访问Rest接口 https://fapi.binance.com/fapi/v1/depth?symbol=BTCUSDT&limit=1000获得一个1000档的深度快照 将目前缓存到的信息中u< 步骤3中获取到的快照中的lastUpdateId的部分丢弃(丢弃更早的信息，已经过期)。 将深度快照中的内容更新到本地orderbook副本中，并从websocket接收到的第一个U <= lastUpdateId 且 u >= lastUpdateId 的event开始继续更新本地副本。 每一个新event的pu应该等于上一个event的u，否则可能出现了丢包，请从step3重新进行初始化。 每一个event中的挂单量代表这个价格目前的挂单量绝对值，而不是相对变化。 如果某个价格对应的挂单量为0，表示该价位的挂单已经撤单或者被吃，应该移除这个价位。 综合指数交易对信息流 Payload: { "e":"compositeIndex", // 事件类型 "E":1602310596000, // 事件事件 "s":"DEFIUSDT", // 交易对 "p":"554.41604065", // 价格 "C":"baseAsset", "c":[ // 成分信息 { "b":"BAL", // 基础资产 "q":"USDT", // 报价资产 "w":"1.04884844", // 权重(数量) "W":"0.01457800", // 权重(比例) "i":"24.33521021" // 指数价格 }, { "b":"BAND", "q":"USDT", "w":"3.53782729", "W":"0.03935200", "i":"7.26420084" } ] } 获取交易对为综合指数的基础成分信息。 推送间隔1000毫秒(如有刷新) Stream Name: Update Speed: 1000ms 交易对信息信息流 Payload: { "e":"contractInfo", // 事件类型 "E":1669356423908, // 事件时间 "s":"IOTAUSDT", // 交易对 "ps":"IOTAUSDT", // 交易对标的 "ct":"PERPETUAL", // 合约类型 "dt":4133404800000, // 结算时间 "ot":1569398400000, // 上架时间 "cs":"TRADING", // 交易对状态 "bks":[ { "bs":1, // 层级 "bnf":0, // 该层对应的名义价值下限 "bnc":5000, // 该层对应的名义价值上限 "mmr":0.01, // 该层对应的维持保证金率 "cf":0, // 速算数 "mi":21, // 该层杠杆下界 "ma":50 // 该层杠杆上界 }, { "bs":2, "bnf":5000, "bnc":25000, "mmr":0.025, "cf":75, "mi":11, "ma":20 } ] } Symbol状态更改时推送（上架/下架/bracket调整）; bks仅在bracket调整时推出。 Stream Name: !contractInfo Update Speed: 实时 多资产模式资产汇率指数 Payload: [ { "e":"assetIndexUpdate", "E":1686749230000, "s":"ADAUSD", // asset index symbol "i":"0.27462452", // 指数价格 "b":"0.10000000", // bid估值折扣 "a":"0.10000000", // ask估值折扣 "B":"0.24716207", // bid价格 "A":"0.30208698", // ask价格 "q":"0.05000000", // 自动兑换bid估值折扣 "g":"0.05000000", // 自动兑换ask估值折扣 "Q":"0.26089330", // 自动兑换bid价格 "G":"0.28835575" // 自动兑换ask价格 }, { "e":"assetIndexUpdate", "E":1686749230000, "s":"USDTUSD", "i":"0.99987691", "b":"0.00010000", "a":"0.00010000", "B":"0.99977692", "A":"0.99997689", "q":"0.00010000", "g":"0.00010000", "Q":"0.99977692", "G":"0.99997689" } 多资产模式资产价格指数 Stream Name: !assetIndex@arrOR Update Speed: 1s 账户和交易接口 考虑到剧烈行情下, RESTful接口可能存在查询延迟，我们强烈建议您优先从Websocket user data stream推送的消息来获取订单，成交，仓位等信息。 划转 执行现货账户与合约账户之间的划转, 详情请见这里. 获取划转历史 获取现货账户与合约账户之间的资金划转历史记录,详情请见这里. 更改持仓模式(TRADE) 响应: { "code": 200, "msg": "success" } POST /fapi/v1/positionSide/dual (HMAC SHA256) 变换用户在 所有symbol 合约上的持仓模式：双向持仓或单向持仓。 权重: 1 参数: 名称 类型 是否必需 描述 dualSidePosition STRING YES "true": 双向持仓模式；"false": 单向持仓模式 recvWindow LONG NO timestamp LONG YES 查询持仓模式(USER_DATA) 响应: { "dualSidePosition": true // "true": 双向持仓模式；"false": 单向持仓模式 } GET /fapi/v1/positionSide/dual (HMAC SHA256) 查询用户目前在 所有symbol 合约上的持仓模式：双向持仓或单向持仓。 权重: 30 参数: 名称 类型 是否必需 描述 recvWindow LONG NO timestamp LONG YES 更改联合保证金模式(TRADE) 响应: { "code": 200, "msg": "success" } POST /fapi/v1/multiAssetsMargin (HMAC SHA256) 变换用户在 所有symbol 合约上的联合保证金模式：开启或关闭联合保证金模式。 权重: 1 参数: 名称 类型 是否必需 描述 multiAssetsMargin STRING YES "true": 联合保证金模式开启；"false": 联合保证金模式关闭 recvWindow LONG NO timestamp LONG YES 查询联合保证金模式(USER_DATA) 响应: { "multiAssetsMargin": true // "true": 联合保证金模式开启；"false": 联合保证金模式关闭 } GET /fapi/v1/multiAssetsMargin (HMAC SHA256) 查询用户目前在 所有symbol 合约上的联合保证金模式。 权重: 30 参数: 名称 类型 是否必需 描述 recvWindow LONG NO timestamp LONG YES 下单 (TRADE) 响应: { "clientOrderId": "testOrder", // 用户自定义的订单号 "cumQty": "0", "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 22542179, // 系统订单号 "avgPrice": "0.00000", // 平均成交价 "origQty": "10", // 原始委托数量 "price": "0", // 委托价格 "reduceOnly": false, // 仅减仓 "side": "SELL", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "NEW", // 订单状态 "stopPrice": "0", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "timeInForce": "GTD", // 有效方法 "type": "TRAILING_STOP_MARKET", // 订单类型 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1566818724722, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 1693207680000 //订单TIF为GTD时的自动取消时间 } POST /fapi/v1/order 权重: 0 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 side ENUM YES 买卖方向 SELL, BUY positionSide ENUM NO 持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT type ENUM YES 订单类型 LIMIT, MARKET, STOP, TAKE_PROFIT, STOP_MARKET, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET reduceOnly STRING NO true, false; 非双开模式下默认false；双开模式下不接受此参数； 使用closePosition不支持此参数。 quantity DECIMAL NO 下单数量,使用closePosition不支持此参数。 price DECIMAL NO 委托价格 newClientOrderId STRING NO 用户自定义的订单号，不可以重复出现在挂单中。如空缺系统会自动赋值。必须满足正则规则 ^[\.A-Z\:/a-z0-9_-]{1,36}$ stopPrice DECIMAL NO 触发价, 仅 STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET 需要此参数 closePosition STRING NO true, false；触发后全部平仓，仅支持STOP_MARKET和TAKE_PROFIT_MARKET；不与quantity合用；自带只平仓效果，不与reduceOnly 合用 activationPrice DECIMAL NO 追踪止损激活价格，仅TRAILING_STOP_MARKET 需要此参数, 默认为下单当前市场价格(支持不同workingType) callbackRate DECIMAL NO 追踪止损回调比例，可取值范围[0.1, 10],其中 1代表1% ,仅TRAILING_STOP_MARKET 需要此参数 timeInForce ENUM NO 有效方法 workingType ENUM NO stopPrice 触发类型: MARK_PRICE(标记价格), CONTRACT_PRICE(合约最新价). 默认 CONTRACT_PRICE priceProtect STRING NO 条件单触发保护："TRUE","FALSE", 默认"FALSE". 仅 STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET 需要此参数 newOrderRespType ENUM NO "ACK", "RESULT", 默认 "ACK" symbol STRING YES 交易对 priceMatch ENUM NO OPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20；不能与price同时传 selfTradePreventionMode ENUM NO NONE / EXPIRE_TAKER/ EXPIRE_MAKER/ EXPIRE_BOTH； 默认NONE goodTillDate LONG NO TIF为GTD时订单的自动取消时间， 当timeInforce为GTD时必传；传入的时间戳仅保留秒级精度，毫秒级部分会被自动忽略，时间戳需大于当前时间+600s且小于253402300799000 recvWindow LONG NO timestamp LONG YES 根据 order type的不同，某些参数强制要求，具体如下: Type 强制要求的参数 LIMIT timeInForce, quantity, price MARKET quantity STOP, TAKE_PROFIT quantity, price, stopPrice STOP_MARKET, TAKE_PROFIT_MARKET stopPrice TRAILING_STOP_MARKET quantity,callbackRate 条件单的触发必须: 如果订单参数priceProtect为true: 达到触发价时，MARK_PRICE(标记价格)与CONTRACT_PRICE(合约最新价)之间的价差不能超过改symbol触发保护阈值 触发保护阈值请参考接口GET /fapi/v1/exchangeInfo 返回内容相应symbol中"triggerProtect"字段 STOP, STOP_MARKET 止损单: 买入: 最新合约价格/标记价格高于等于触发价stopPrice 卖出: 最新合约价格/标记价格低于等于触发价stopPrice TAKE_PROFIT, TAKE_PROFIT_MARKET 止盈单: 买入: 最新合约价格/标记价格低于等于触发价stopPrice 卖出: 最新合约价格/标记价格高于等于触发价stopPrice TRAILING_STOP_MARKET 跟踪止损单: 买入: 当合约价格/标记价格区间最低价格低于激活价格activationPrice,且最新合约价格/标记价高于等于最低价设定回调幅度。 卖出: 当合约价格/标记价格区间最高价格高于激活价格activationPrice,且最新合约价格/标记价低于等于最高价设定回调幅度。 TRAILING_STOP_MARKET 跟踪止损单如果遇到报错 {"code": -2021, "msg": "Order would immediately trigger."} 表示订单不满足以下条件: 买入: 指定的activationPrice 必须小于 latest price 卖出: 指定的activationPrice 必须大于 latest price newOrderRespType 如果传 RESULT: MARKET 订单将直接返回成交结果； 配合使用特殊 timeInForce 的 LIMIT 订单将直接返回成交或过期拒绝结果。 STOP_MARKET, TAKE_PROFIT_MARKET 配合 closePosition=true: 条件单触发依照上述条件单触发逻辑 条件触发后，平掉当时持有所有多头仓位(若为卖单)或当时持有所有空头仓位(若为买单) 不支持 quantity 参数 自带只平仓属性，不支持reduceOnly参数 双开模式下,LONG方向上不支持BUY; SHORT 方向上不支持SELL selfTradePreventionMode 仅在 timeInForce为IOC或GTC或GTD时生效. 极端行情时，timeInForce为GTD的订单自动取消可能有一定延迟 测试下单接口 (TRADE) 响应: 字段与下单接口一致，但均为无效值 POST /fapi/v1/order/test 用于测试订单请求，但不会提交到撮合引擎 参数: 参考 POST /fapi/v1/order 修改订单 (TRADE) 响应: { "orderId": 20072994037, "symbol": "BTCUSDT", "pair": "BTCUSDT", "status": "NEW", "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "price": "30005", "avgPrice": "0.0", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "LONG", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 "updateTime": 1629182711600 } PUT /fapi/v1/order (HMAC SHA256) 修改订单功能，当前只支持限价（LIMIT）订单修改，修改后会在撮合队列里重新排序 权重: 10s order rate limit(X-MBX-ORDER-COUNT-10S)为1 1min order rate limit(X-MBX-ORDER-COUNT-1M)为1 IP rate limit(x-mbx-used-weight-1m)为1 参数: 名称 类型 是否必需 描述 orderId LONG NO 系统订单号 origClientOrderId STRING NO 用户自定义的订单号 symbol STRING YES 交易对 side ENUM YES 买卖方向 SELL, BUY; side需要和原订单相同 quantity DECIMAL YES 下单数量,使用closePosition不支持此参数。 price DECIMAL YES 委托价格 priceMatch ENUM NO OPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20；不能与price同时传 timestamp LONG YES orderId 与 origClientOrderId 必须至少发送一个，同时发送则以 order id为准 quantity 与 price 均必须发送，这点和 dapi 修改订单不同 当新订单的quantity 或 price不满足PRICE_FILTER / PERCENT_FILTER / LOT_SIZE限制，修改会被拒绝，原订单依旧被保留 订单会在下列情况下被取消： 原订单被部分执行且新订单quantity <= executedQty 原订单是GTX，新订单的价格会导致订单立刻执行 同一订单修改次数最多10000次 改单会保留该单原有的selfTradePreventionMode 批量下单 (TRADE) 响应: [ { "clientOrderId": "testOrder", // 用户自定义的订单号 "cumQty": "0", "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 22542179, // 系统订单号 "avgPrice": "0.00000", // 平均成交价 "origQty": "10", // 原始委托数量 "price": "0", // 委托价格 "reduceOnly": false, // 仅减仓 "side": "SELL", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "NEW", // 订单状态 "stopPrice": "0", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "timeInForce": "GTC", // 有效方法 "type": "TRAILING_STOP_MARKET", // 订单类型 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1566818724722, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 }, { "code": -2022, "msg": "ReduceOnly Order is rejected." } ] POST /fapi/v1/batchOrders 权重: 10s order rate limit(X-MBX-ORDER-COUNT-10S)为5 1min order rate limit(X-MBX-ORDER-COUNT-1M)为1 IP rate limit(x-mbx-used-weight-1m)为5 参数: 名称 类型 是否必需 描述 batchOrders list YES 订单列表，最多支持5个订单 recvWindow LONG NO timestamp LONG YES 其中batchOrders应以list of JSON格式填写订单参数 例子: /fapi/v1/batchOrders?batchOrders=[{"type":"LIMIT","timeInForce":"GTC", "symbol":"BTCUSDT","side":"BUY","price":"10001","quantity":"0.001"}] 名称 类型 是否必需 描述 symbol STRING YES 交易对 side ENUM YES 买卖方向 SELL, BUY positionSide ENUM NO 持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT type ENUM YES 订单类型 LIMIT, MARKET, STOP, TAKE_PROFIT, STOP_MARKET, TAKE_PROFIT_MARKET, TRAILING_STOP_MARKET reduceOnly STRING NO true, false; 非双开模式下默认false；双开模式下不接受此参数。 quantity DECIMAL YES 下单数量 price DECIMAL NO 委托价格 newClientOrderId STRING NO 用户自定义的订单号，不可以重复出现在挂单中。如空缺系统会自动赋值. 必须满足正则规则 ^[\.A-Z\:/a-z0-9_-]{1,36}$ stopPrice DECIMAL NO 触发价, 仅 STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET 需要此参数 activationPrice DECIMAL NO 追踪止损激活价格，仅TRAILING_STOP_MARKET 需要此参数, 默认为下单当前市场价格(支持不同workingType) callbackRate DECIMAL NO 追踪止损回调比例，可取值范围[0.1, 4],其中 1代表1% ,仅TRAILING_STOP_MARKET 需要此参数 timeInForce ENUM NO 有效方法 workingType ENUM NO stopPrice 触发类型: MARK_PRICE(标记价格), CONTRACT_PRICE(合约最新价). 默认 CONTRACT_PRICE priceProtect STRING NO 条件单触发保护："TRUE","FALSE", 默认"FALSE". 仅 STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET 需要此参数 newOrderRespType ENUM NO "ACK", "RESULT", 默认 "ACK" priceMatch ENUM NO OPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20；不能与price同时传 selfTradePreventionMode ENUM NO NONE / EXPIRE_TAKER/ EXPIRE_MAKER/ EXPIRE_BOTH； 默认NONE goodTillDate LONG NO TIF为GTD时订单的自动取消时间， 当timeInforce为GTD时必传；传入的时间戳仅保留秒级精度，毫秒级部分会被自动忽略，时间戳需大于当前时间+600s且小于253402300799000 具体订单条件规则，与普通下单一致 批量下单采取并发处理，不保证订单撮合顺序 批量下单的返回内容顺序，与订单列表顺序一致 批量修改订单 (TRADE) 响应: [ { "orderId": 20072994037, "symbol": "BTCUSDT", "pair": "BTCUSDT", "status": "NEW", "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "price": "30005", "avgPrice": "0.0", "origQty": "1", "executedQty": "0", "cumQty": "0", "cumBase": "0", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "LONG", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "priceProtect": false, "origType": "LIMIT", "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 "updateTime": 1629182711600 }, { "code": -2022, "msg": "ReduceOnly Order is rejected." } ] PUT /fapi/v1/batchOrders 权重: 5 参数: 名称 类型 是否必需 描述 batchOrders list YES 订单列表,最多支持5个订单 recvWindow LONG NO timestamp LONG YES 其中batchOrders应以list of JSON格式填写订单参数 名称 类型 是否必需 描述 orderId LONG NO 系统订单号，orderId 与 origClientOrderId 至少要传一个 origClientOrderId STRING NO 用户自定义的订单号，orderId 与 origClientOrderId 至少要传一个 symbol STRING YES 交易对 side ENUM YES 买卖方向 SELL, BUY quantity DECIMAL YES 下单数量,使用closePosition不支持此参数。 price DECIMAL YES 委托价格 stopPrice DECIMAL NO 触发价, 仅 STOP, STOP_MARKET, TAKE_PROFIT, TAKE_PROFIT_MARKET 需要此参数 priceMatch ENUM NO OPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20；不能与price同时传 recvWindow LONG NO timestamp LONG YES 具体订单条件规则,与普通修改订单一致 批量修改订单采取并发处理,不保证订单撮合顺序 批量修改订单的返回内容顺序,与订单列表顺序一致 同一订单修改次数最多10000次 改单会保留该单原有的selfTradePreventionMode 查询订单修改历史 (USER_DATA) 响应: [ { "amendmentId": 5363, // 修改记录号 "symbol": "BTCUSDT", "pair": "BTCUSDT", "orderId": 20072994037, "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "time": 1629184560899, // 修改时间 "amendment": { "price": { "before": "30004", "after": "30003.2" }, "origQty": { "before": "1", "after": "1" }, "count": 3 // 修改记数，代表该修改记录是这笔订单第几次修改 }, "priceMatch":"QUEUE_20" }, { "amendmentId": 5361, "symbol": "BTCUSDT", "pair": "BTCUSDT", "orderId": 20072994037, "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "time": 1629184533946, "amendment": { "price": { "before": "30005", "after": "30004" }, "origQty": { "before": "1", "after": "1" }, "count": 2 }, "priceMatch":"QUEUE_20" }, { "amendmentId": 5325, "symbol": "BTCUSDT", "pair": "BTCUSDT", "orderId": 20072994037, "clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW", "time": 1629182711787, "amendment": { "price": { "before": "30002", "after": "30005" }, "origQty": { "before": "1", "after": "1" }, "count": 1 }, "priceMatch":"QUEUE_20" } ] GET /fapi/v1/orderAmendment (HMAC SHA256) 查询订单修改历史 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderId LONG NO 系统订单号 origClientOrderId STRING NO 用户自定义的订单号 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 返回的结果集数量 默认值:1000 最大值:1000 recvWindow LONG NO timestamp LONG YES 注意: 至少需要发送 orderId 与 origClientOrderId中的一个，同时发送则以 orderId 为准 查询订单 (USER_DATA) 响应: { "avgPrice": "0.00000", // 平均成交价 "clientOrderId": "abc", // 用户自定义的订单号 "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 1573346959, // 系统订单号 "origQty": "0.40", // 原始委托数量 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "price": "0", // 委托价格 "reduceOnly": false, // 是否仅减仓 "side": "BUY", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "NEW", // 订单状态 "stopPrice": "9300", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "time": 1579276756075, // 订单时间 "timeInForce": "GTC", // 有效方法 "type": "TRAILING_STOP_MARKET", // 订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1579276756075, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 } GET /fapi/v1/order (HMAC SHA256) 查询订单状态 请注意，如果订单满足如下条件，不会被查询到： 订单的最终状态为 CANCELED 或者 EXPIRED 并且 订单没有任何的成交记录 并且 订单生成时间 + 3天 < 当前时间 订单创建时间 + 90天 < 当前时间 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderId LONG NO 系统订单号 origClientOrderId STRING NO 用户自定义的订单号 recvWindow LONG NO timestamp LONG YES 注意: 至少需要发送 orderId 与 origClientOrderId中的一个 orderId在symbol维度是自增的 撤销订单 (TRADE) 响应: { "clientOrderId": "myOrder1", // 用户自定义的订单号 "cumQty": "0", "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 283194212, // 系统订单号 "origQty": "11", // 原始委托数量 "price": "0", // 委托价格 "reduceOnly": false, // 仅减仓 "side": "BUY", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "CANCELED", // 订单状态 "stopPrice": "9300", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "timeInForce": "GTC", // 有效方法 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "type": "TRAILING_STOP_MARKET", // 订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1571110484038, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 } DELETE /fapi/v1/order (HMAC SHA256) 权重: 1 Parameters: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderId LONG NO 系统订单号 origClientOrderId STRING NO 用户自定义的订单号 recvWindow LONG NO timestamp LONG YES orderId 与 origClientOrderId 必须至少发送一个 撤销全部订单 (TRADE) 响应: { "code": 200, "msg": "The operation of cancel all open order is done." } DELETE /fapi/v1/allOpenOrders (HMAC SHA256) 权重: 1 Parameters: 名称 类型 是否必需 描述 symbol STRING YES 交易对 recvWindow LONG NO timestamp LONG YES 批量撤销订单 (TRADE) 响应: [ { "clientOrderId": "myOrder1", // 用户自定义的订单号 "cumQty": "0", "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 283194212, // 系统订单号 "origQty": "11", // 原始委托数量 "price": "0", // 委托价格 "reduceOnly": false, // 仅减仓 "side": "BUY", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "CANCELED", // 订单状态 "stopPrice": "9300", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "timeInForce": "GTC", // 有效方法 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "type": "TRAILING_STOP_MARKET", // 订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1571110484038, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 }, { "code": -2011, "msg": "Unknown order sent." } ] DELETE /fapi/v1/batchOrders (HMAC SHA256) 权重: 1 Parameters: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderIdList LIST NO 系统订单号, 最多支持10个订单 比如[1234567,2345678] origClientOrderIdList LIST NO 用户自定义的订单号, 最多支持10个订单 比如["my_id_1","my_id_2"] 需要encode双引号。逗号后面没有空格。 recvWindow LONG NO timestamp LONG YES orderIdList 与 origClientOrderIdList 必须至少发送一个，不可同时发送 倒计时撤销所有订单 (TRADE) 响应: { "symbol": "BTCUSDT", "countdownTime": "100000" } POST /fapi/v1/countdownCancelAll (HMAC SHA256) 权重: 10 Parameters: 名称 类型 是否必需 描述 symbol STRING YES countdownTime LONG YES 倒计时。 1000 表示 1 秒； 0 表示取消倒计时撤单功能。 recvWindow LONG NO timestamp LONG YES 该接口可以被用于确保在倒计时结束时撤销指定symbol上的所有挂单。 在使用这个功能时，接口应像心跳一样在倒计时内被反复调用，以便可以取消既有的倒计时并开始新的倒数计时设置。 用法示例： 以30s的间隔重复此接口，每次倒计时countdownTime设置为120000(120s)。 如果在120秒内未再次调用此接口，则您指定symbol上的所有挂单都会被自动撤销。 如果在120秒内以将countdownTime设置为0，则倒数计时器将终止，自动撤单功能取消。 系统会大约每10毫秒检查一次所有倒计时情况，因此请注意，使用此功能时应考虑足够的冗余。 我们不建议将倒记时设置得太精确或太小。 查询当前挂单 (USER_DATA) 响应: { "avgPrice": "0.00000", // 平均成交价 "clientOrderId": "abc", // 用户自定义的订单号 "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 1917641, // 系统订单号 "origQty": "0.40", // 原始委托数量 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "price": "0", // 委托价格 "reduceOnly": false, // 是否仅减仓 "side": "BUY", // 买卖方向 "status": "NEW", // 订单状态 "positionSide": "SHORT", // 持仓方向 "stopPrice": "9300", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "time": 1579276756075, // 订单时间 "timeInForce": "GTC", // 有效方法 "type": "TRAILING_STOP_MARKET", // 订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1579276756075, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 } GET /fapi/v1/openOrder (HMAC SHA256) 请小心使用不带symbol参数的调用 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderId LONG NO 系统订单号 origClientOrderId STRING NO 用户自定义的订单号 recvWindow LONG NO timestamp LONG YES orderId 与 origClientOrderId 中的一个为必填参数 查询的订单如果已经成交或取消，将返回报错 "Order does not exist." 查看当前全部挂单 (USER_DATA) 响应: [ { "avgPrice": "0.00000", // 平均成交价 "clientOrderId": "abc", // 用户自定义的订单号 "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 1917641, // 系统订单号 "origQty": "0.40", // 原始委托数量 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "price": "0", // 委托价格 "reduceOnly": false, // 是否仅减仓 "side": "BUY", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "NEW", // 订单状态 "stopPrice": "9300", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "time": 1579276756075, // 订单时间 "timeInForce": "GTC", // 有效方法 "type": "TRAILING_STOP_MARKET", // 订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1579276756075, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", // 盘口价格下单模式 "selfTradePreventionMode": "NONE", // 订单自成交保护模式 "goodTillDate": 0 // 订单TIF为GTD时的自动取消时间 } ] GET /fapi/v1/openOrders (HMAC SHA256) 请小心使用不带symbol参数的调用 权重: - 带symbol 1 - 不带 40 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 recvWindow LONG NO timestamp LONG YES 不带symbol参数，会返回所有交易对的挂单 查询所有订单(包括历史订单) (USER_DATA) 响应: [ { "avgPrice": "0.00000", // 平均成交价 "clientOrderId": "abc", // 用户自定义的订单号 "cumQuote": "0", // 成交金额 "executedQty": "0", // 成交量 "orderId": 1917641, // 系统订单号 "origQty": "0.40", // 原始委托数量 "origType": "TRAILING_STOP_MARKET", // 触发前订单类型 "price": "0", // 委托价格 "reduceOnly": false, // 是否仅减仓 "side": "BUY", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "status": "NEW", // 订单状态 "stopPrice": "9300", // 触发价，对`TRAILING_STOP_MARKET`无效 "closePosition": false, // 是否条件全平仓 "symbol": "BTCUSDT", // 交易对 "time": 1579276756075, // 订单时间 "timeInForce": "GTC", // 有效方法 "type": "TRAILING_STOP_MARKET", // 订单类型 "activatePrice": "9020", // 跟踪止损激活价格, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "priceRate": "0.3", // 跟踪止损回调比例, 仅`TRAILING_STOP_MARKET` 订单返回此字段 "updateTime": 1579276756075, // 更新时间 "workingType": "CONTRACT_PRICE", // 条件价格触发类型 "priceProtect": false, // 是否开启条件单触发保护 "priceMatch": "NONE", //盘口价格下单模式 "selfTradePreventionMode": "NONE", //订单自成交保护模式 "goodTillDate": 0 //订单TIF为GTD时的自动取消时间 } ] GET /fapi/v1/allOrders (HMAC SHA256) 请注意，如果订单满足如下条件，不会被查询到： 订单的最终状态为 CANCELED 或者 EXPIRED 并且 订单没有任何的成交记录 并且 订单生成时间 + 3天 < 当前时间 订单创建时间 + 90天 < 当前时间 权重: 5 Parameters: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderId LONG NO 只返回此orderID及之后的订单，缺省返回最近的订单 startTime LONG NO 起始时间 endTime LONG NO 结束时间 limit INT NO 返回的结果集数量 默认值:500 最大值:1000 recvWindow LONG NO timestamp LONG YES 查询时间范围最大不得超过7天 默认查询最近7天内的数据 账户余额V2 (USER_DATA) 响应: [ { "accountAlias": "SgsR", // 账户唯一识别码 "asset": "USDT", // 资产 "balance": "122607.35137903", // 总余额 "crossWalletBalance": "23.72469206", // 全仓余额 "crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏 "availableBalance": "23.72469206", // 下单可用余额 "maxWithdrawAmount": "23.72469206", // 最大可转出余额 "marginAvailable": true, // 是否可用作联合保证金 "updateTime": 1617939110373 } ] GET /fapi/v2/balance (HMAC SHA256) Weight: 5 Parameters: 名称 类型 是否必需 描述 recvWindow LONG NO timestamp LONG YES 账户信息V2 (USER_DATA) 响应: 单资产模式 { "feeTier": 0, // 手续费等级 "canTrade": true, // 是否可以交易 "canDeposit": true, // 是否可以入金 "canWithdraw": true, // 是否可以出金 "updateTime": 0, // 保留字段，请忽略 "multiAssetsMargin": false, "tradeGroupId": -1, "totalInitialMargin": "0.00000000", // 当前所需起始保证金总额(存在逐仓请忽略), 仅计算usdt资产 "totalMaintMargin": "0.00000000", // 维持保证金总额, 仅计算usdt资产 "totalWalletBalance": "23.72469206", // 账户总余额, 仅计算usdt资产 "totalUnrealizedProfit": "0.00000000", // 持仓未实现盈亏总额, 仅计算usdt资产 "totalMarginBalance": "23.72469206", // 保证金总余额, 仅计算usdt资产 "totalPositionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格), 仅计算usdt资产 "totalOpenOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格), 仅计算usdt资产 "totalCrossWalletBalance": "23.72469206", // 全仓账户余额, 仅计算usdt资产 "totalCrossUnPnl": "0.00000000", // 全仓持仓未实现盈亏总额, 仅计算usdt资产 "availableBalance": "23.72469206", // 可用余额, 仅计算usdt资产 "maxWithdrawAmount": "23.72469206" // 最大可转出余额, 仅计算usdt资产 "assets": [ { "asset": "USDT", //资产 "walletBalance": "23.72469206", //余额 "unrealizedProfit": "0.00000000", // 未实现盈亏 "marginBalance": "23.72469206", // 保证金余额 "maintMargin": "0.00000000", // 维持保证金 "initialMargin": "0.00000000", // 当前所需起始保证金 "positionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格) "openOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格) "crossWalletBalance": "23.72469206", //全仓账户余额 "crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏 "availableBalance": "126.72469206", // 可用余额 "maxWithdrawAmount": "23.72469206", // 最大可转出余额 "marginAvailable": true, // 是否可用作联合保证金 "updateTime": 1625474304765 //更新时间 }, { "asset": "BUSD", //资产 "walletBalance": "103.12345678", //余额 "unrealizedProfit": "0.00000000", // 未实现盈亏 "marginBalance": "103.12345678", // 保证金余额 "maintMargin": "0.00000000", // 维持保证金 "initialMargin": "0.00000000", // 当前所需起始保证金 "positionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格) "openOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格) "crossWalletBalance": "103.12345678", //全仓账户余额 "crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏 "availableBalance": "126.72469206", // 可用余额 "maxWithdrawAmount": "103.12345678", // 最大可转出余额 "marginAvailable": true, // 否可用作联合保证金 "updateTime": 0 // 更新时间 } ], "positions": [ // 头寸，将返回所有市场symbol。 //根据用户持仓模式展示持仓方向，即单向模式下只返回BOTH持仓情况，双向模式下只返回 LONG 和 SHORT 持仓情况 { "symbol": "BTCUSDT", // 交易对 "initialMargin": "0", // 当前所需起始保证金(基于最新标记价格) "maintMargin": "0", //维持保证金 "unrealizedProfit": "0.00000000", // 持仓未实现盈亏 "positionInitialMargin": "0", // 持仓所需起始保证金(基于最新标记价格) "openOrderInitialMargin": "0", // 当前挂单所需起始保证金(基于最新标记价格) "leverage": "100", // 杠杆倍率 "isolated": true, // 是否是逐仓模式 "entryPrice": "0.00000", // 持仓成本价 "maxNotional": "250000", // 当前杠杆下用户可用的最大名义价值 "bidNotional": "0", // 买单净值，忽略 "askNotional": "0", // 卖单净值，忽略 "positionSide": "BOTH", // 持仓方向 "positionAmt": "0", // 持仓数量 "updateTime": 0 // 更新时间 } ] } 多资产模式 { "feeTier": 0, // 手续费等级 "canTrade": true, // 是否可以交易 "canDeposit": true, // 是否可以入金 "canWithdraw": true, // 是否可以出金 "updateTime": 0, // 保留字段，请忽略 "multiAssetsMargin": true, "tradeGroupId": -1, "totalInitialMargin": "0.00000000", // 以USD计价的所需起始保证金总额 "totalMaintMargin": "0.00000000", // 以USD计价的维持保证金总额 "totalWalletBalance": "126.72469206", // 以USD计价的账户总余额 "totalUnrealizedProfit": "0.00000000", // 以USD计价的持仓未实现盈亏总额 "totalMarginBalance": "126.72469206", // 以USD计价的保证金总余额 "totalPositionInitialMargin": "0.00000000", // 以USD计价的持仓所需起始保证金(基于最新标记价格) "totalOpenOrderInitialMargin": "0.00000000", // 以USD计价的当前挂单所需起始保证金(基于最新标记价格) "totalCrossWalletBalance": "126.72469206", // 以USD计价的全仓账户余额 "totalCrossUnPnl": "0.00000000", // 以USD计价的全仓持仓未实现盈亏总额 "availableBalance": "126.72469206", // 以USD计价的可用余额 "maxWithdrawAmount": "126.72469206" // 以USD计价的最大可转出余额 "assets": [ { "asset": "USDT", //资产 "walletBalance": "23.72469206", //余额 "unrealizedProfit": "0.00000000", // 未实现盈亏 "marginBalance": "23.72469206", // 保证金余额 "maintMargin": "0.00000000", // 维持保证金 "initialMargin": "0.00000000", // 当前所需起始保证金 "positionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格) "openOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格) "crossWalletBalance": "23.72469206", //全仓账户余额 "crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏 "availableBalance": "23.72469206", // 可用余额 "maxWithdrawAmount": "23.72469206", // 最大可转出余额 "marginAvailable": true, // 是否可用作联合保证金 "updateTime": 1625474304765 //更新时间 }, { "asset": "BUSD", //资产 "walletBalance": "103.12345678", //余额 "unrealizedProfit": "0.00000000", // 未实现盈亏 "marginBalance": "103.12345678", // 保证金余额 "maintMargin": "0.00000000", // 维持保证金 "initialMargin": "0.00000000", // 当前所需起始保证金 "positionInitialMargin": "0.00000000", // 持仓所需起始保证金(基于最新标记价格) "openOrderInitialMargin": "0.00000000", // 当前挂单所需起始保证金(基于最新标记价格) "crossWalletBalance": "103.12345678", //全仓账户余额 "crossUnPnl": "0.00000000" // 全仓持仓未实现盈亏 "availableBalance": "103.12345678", // 可用余额 "maxWithdrawAmount": "103.12345678", // 最大可转出余额 "marginAvailable": true, // 否可用作联合保证金 "updateTime": 0 // 更新时间 } ], "positions": [ // 头寸，将返回所有市场symbol。 //根据用户持仓模式展示持仓方向，即单向模式下只返回BOTH持仓情况，双向模式下只返回 LONG 和 SHORT 持仓情况 { "symbol": "BTCUSDT", // 交易对 "initialMargin": "0", // 当前所需起始保证金(基于最新标记价格) "maintMargin": "0", //维持保证金 "unrealizedProfit": "0.00000000", // 持仓未实现盈亏 "positionInitialMargin": "0", // 持仓所需起始保证金(基于最新标记价格) "openOrderInitialMargin": "0", // 当前挂单所需起始保证金(基于最新标记价格) "leverage": "100", // 杠杆倍率 "isolated": true, // 是否是逐仓模式 "entryPrice": "0.00000", // 持仓成本价 "breakEvenPrice": "0.0", // 持仓成本价 "maxNotional": "250000", // 当前杠杆下用户可用的最大名义价值 "bidNotional": "0", // 买单净值，忽略 "askNotional": "0", // 买单净值，忽略 "positionSide": "BOTH", // 持仓方向 "positionAmt": "0", // 持仓数量 "updateTime": 0 // 更新时间 } ] } GET /fapi/v2/account (HMAC SHA256) 现有账户信息。 用户在单资产模式和多资产模式下会看到不同结果，响应部分的注释解释了两种模式下的不同。 权重: 5 参数: 名称 类型 是否必需 描述 recvWindow LONG NO timestamp LONG YES 调整开仓杠杆 (TRADE) 响应: { "leverage": 21, // 杠杆倍数 "maxNotionalValue": "1000000", // 当前杠杆倍数下允许的最大名义价值 "symbol": "BTCUSDT" // 交易对 } POST /fapi/v1/leverage (HMAC SHA256) 调整用户在指定symbol合约的开仓杠杆。 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 leverage INT YES 目标杠杆倍数：1 到 125 整数 recvWindow LONG NO timestamp LONG YES 变换逐全仓模式 (TRADE) 响应: { "code": 200, "msg": "success" } POST /fapi/v1/marginType (HMAC SHA256) 变换用户在指定symbol合约上的保证金模式：逐仓或全仓。 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 marginType ENUM YES 保证金模式 ISOLATED(逐仓), CROSSED(全仓) recvWindow LONG NO timestamp LONG YES 调整逐仓保证金 (TRADE) 响应: { "amount": 100.0, "code": 200, "msg": "Successfully modify position margin.", "type": 1 } POST /fapi/v1/positionMargin (HMAC SHA256) 针对逐仓模式下的仓位，调整其逐仓保证金资金。 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 positionSide ENUM NO 持仓方向，单向持仓模式下非必填，默认且仅可填BOTH;在双向持仓模式下必填,且仅可选择 LONG 或 SHORT amount DECIMAL YES 保证金资金 type INT YES 调整方向 1: 增加逐仓保证金，2: 减少逐仓保证金 recvWindow LONG NO timestamp LONG YES 只针对逐仓symbol 与 positionSide(如有) 逐仓保证金变动历史 (TRADE) 响应: [ { "symbol": "BTCUSDT", // 交易对 "type": 1, // 调整方向 "deltaType": "USER_ADJUST", // 划转类型 "amount": "23.36332311", // 数量 "asset": "USDT", // 资产 "time": 1578047897183, // 时间 "positionSide": "BOTH" // 持仓方向 }, { "symbol": "BTCUSDT", "type": 1, "deltaType": "USER_ADJUST", "amount": "100", "asset": "USDT", "time": 1578047900425, "positionSide": "LONG" } ] GET /fapi/v1/positionMargin/history (HMAC SHA256) 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 type INT NO 调整方向 1: 增加逐仓保证金，2: 减少逐仓保证金 startTime LONG NO 起始时间 endTime LONG NO 结束时间，默认为当前时间 limit INT NO 返回的结果集数量 默认值: 500 recvWindow LONG NO timestamp LONG YES startTime与endTime间隔不能超过30天 用户持仓风险V2 (USER_DATA) 响应: 单向持仓模式下： [ { "entryPrice": "0.00000", // 开仓均价 "breakEvenPrice": "0.0", // 盈亏平衡价 "marginType": "isolated", // 逐仓模式或全仓模式 "isAutoAddMargin": "false", "isolatedMargin": "0.00000000", // 逐仓保证金 "leverage": "10", // 当前杠杆倍数 "liquidationPrice": "0", // 参考强平价格 "markPrice": "6679.50671178", // 当前标记价格 "maxNotionalValue": "20000000", // 当前杠杆倍数允许的名义价值上限 "positionAmt": "0.000", // 头寸数量，符号代表多空方向, 正数为多，负数为空 "notional": "0", "isolatedWallet": "0", "symbol": "BTCUSDT", // 交易对 "unRealizedProfit": "0.00000000", // 持仓未实现盈亏 "positionSide": "BOTH", // 持仓方向 "updateTime": 1625474304765 // 更新时间 } ] 双向持仓模式下： [ { "symbol": "BTCUSDT", // 交易对 "positionAmt": "0.001", // 头寸数量，符号代表多空方向, 正数为多，负数为空 "entryPrice": "22185.2", // 开仓均价 "breakEvenPrice": "0.0", // 盈亏平衡价 "markPrice": "21123.05052574", // 当前标记价格 "unRealizedProfit": "-1.06214947", // 持仓未实现盈亏 "liquidationPrice": "19731.45529116", // 参考强平价格 "leverage": "4", // 当前杠杆倍数 "maxNotionalValue": "100000000", // 当前杠杆倍数允许的名义价值上限 "marginType": "cross", // 逐仓模式或全仓模式 "isolatedMargin": "0.00000000", // 逐仓保证金 "isAutoAddMargin": "false", "positionSide": "LONG", // 持仓方向 "notional": "21.12305052", "isolatedWallet": "0", "updateTime": 1655217461579 //更新时间 }, { "symbol": "BTCUSDT", "positionAmt": "0.000", "entryPrice": "0.0", "breakEvenPrice": "0.0", "markPrice": "21123.05052574", "unRealizedProfit": "0.00000000", "liquidationPrice": "0", "leverage": "4", "maxNotionalValue": "100000000", "marginType": "cross", "isolatedMargin": "0.00000000", "isAutoAddMargin": "false", "positionSide": "SHORT", "notional": "0", "isolatedWallet": "0", "updateTime": 0 } ] GET /fapi/v2/positionRisk (HMAC SHA256) 权重: 5 参数: 名称 类型 是否必需 描述 symbol STRING NO recvWindow LONG NO timestamp LONG YES 注意 请与账户推送信息ACCOUNT_UPDATE配合使用，以满足您的及时性和准确性需求。 账户成交历史 (USER_DATA) 响应: [ { "buyer": false, // 是否是买方 "commission": "-0.07819010", // 手续费 "commissionAsset": "USDT", // 手续费计价单位 "id": 698759, // 交易ID "maker": false, // 是否是挂单方 "orderId": 25851813, // 订单编号 "price": "7819.01", // 成交价 "qty": "0.002", // 成交量 "quoteQty": "15.63802", // 成交额 "realizedPnl": "-0.91539999", // 实现盈亏 "side": "SELL", // 买卖方向 "positionSide": "SHORT", // 持仓方向 "symbol": "BTCUSDT", // 交易对 "time": 1569514978020 // 时间 } ] GET /fapi/v1/userTrades (HMAC SHA256) 获取某交易对的成交历史 权重: 5 参数: 名称 类型 是否必需 描述 symbol STRING YES 交易对 orderId LONG NO 必须要和参数symbol一起使用 startTime LONG NO 起始时间 endTime LONG NO 结束时间 fromId LONG NO 返回该fromId及之后的成交，缺省返回最近的成交 limit INT NO 返回的结果集数量 默认值:500 最大值:1000. recvWindow LONG NO timestamp LONG YES 如果startTime 和 endTime 均未发送, 只会返回最近7天的数据。 startTime 和 endTime 的最大间隔为7天 获取账户损益资金流水 (USER_DATA) 响应: [ { "symbol": "", // 交易对，仅针对涉及交易对的资金流 "incomeType": "TRANSFER", // 资金流类型 "income": "-0.37500000", // 资金流数量，正数代表流入，负数代表流出 "asset": "USDT", // 资产内容 "info":"TRANSFER", // 备注信息，取决于流水类型 "time": 1570608000000, // 时间 "tranId":"9689322392", // 划转ID "tradeId":"" // 引起流水产生的原始交易ID }, { "symbol": "BTCUSDT", "incomeType": "COMMISSION", "income": "-0.01000000", "asset": "USDT", "info":"COMMISSION", "time": 1570636800000, "tranId":"9689322392", "tradeId": 2059192 } ] GET /fapi/v1/income (HMAC SHA256) 权重: 30 参数: 名称 类型 是否必需 描述 symbol STRING NO 交易对 incomeType STRING NO 收益类型： TRANSFER 转账, WELCOME_BONUS 欢迎奖金, REALIZED_PNL 已实现盈亏, FUNDING_FEE 资金费用, COMMISSION 手续费, INSURANCE_CLEAR 强平, REFERRAL_KICKBACK 推荐人返佣, COMMISSION_REBATE 被推荐人返佣, API_REBATE API佣金回扣, CONTEST_REWARD 交易大赛奖金, CROSS_COLLATERAL_TRANSFER cc转账, OPTIONS_PREMIUM_FEE 期权购置手续费, OPTIONS_SETTLE_PROFIT 期权行权收益, INTERNAL_TRANSFER 内部账户，给普通用户划转, AUTO_EXCHANGE 自动兑换, DELIVERED_SETTELMENT 下架结算, COIN_SWAP_DEPOSIT 闪兑转入, COIN_SWAP_WITHDRAW 闪兑转出, POSITION_LIMIT_INCREASE_FEE 仓位限制上调费用 startTime LONG NO 起始时间 endTime LONG NO 结束时间 page INT NO 分页数 limit INT NO 返回的结果集数量 默认值:100 最大值:1000 recvWindow LONG NO timestamp LONG YES 如果startTime 和 endTime 均未发送, 只会返回最近7天的数据。 如果incomeType没有发送，返回所有类型账户损益资金流水。 "trandId" 在相同用户的同一种收益流水类型中是唯一的。 仅保留最近3个月的数据。 杠杆分层标准 (USER_DATA) 响应: [ { "symbol": "ETHUSDT", "notionalCoef": 1.50, //用户bracket相对默认bracket的倍数，仅在和交易对默认不一样时显示 "brackets": [ { "bracket": 1, // 层级 "initialLeverage": 75, // 该层允许的最高初始杠杆倍数 "notionalCap": 10000, // 该层对应的名义价值上限 "notionalFloor": 0, // 该层对应的名义价值下限 "maintMarginRatio": 0.0065, // 该层对应的维持保证金率 "cum":0 // 速算数 }, ] } ] 或 (若发送symbol) { "symbol": "ETHUSDT", "notionalCoef": 1.50, "brackets": [ { "bracket": 1, "initialLeverage": 75, "notionalCap": 10000, "notionalFloor": 0, "maintMarginRatio": 0.0065, "cum":0 }, ] } GET /fapi/v1/leverageBracket 权重: 1 参数: 名称 类型 是否必需 描述 symbol STRING NO recvWindow LONG NO timestamp LONG YES 持仓ADL队列估算 (USER_DATA) 响应: [ { "symbol": "ETHUSDT", "adlQuantile": { // 对于全仓状态下的双向持仓模式的交易对，会返回 "LONG", "SHORT" 和 "HEDGE", 其中"HEDGE"的存在仅作为标记;如果多空均有持仓的情况下,"LONG"和"SHORT"应返回共同计算后相同的队列分数。 "LONG": 3, "SHORT": 3, "HEDGE": 0 // HEDGE 仅作为指示出现，请忽略数值 } }, { "symbol": "BTCUSDT", "adlQuantile": { // 对于单向持仓模式或者是逐仓状态下的双向持仓模式的交易对，会返回 "LONG", "SHORT" 和 "BOTH" 分别表示不同持仓方向上持仓的adl队列分数 "LONG": 1, // 双开模式下多头持仓的ADL队列估算分 "SHORT": 2, // 双开模式下空头持仓的ADL队列估算分 "BOTH": 0 // 单开模式下持仓的ADL队列估算分 } } ] GET /fapi/v1/adlQuantile 权重: 5 参数: 名称 类型 是否必需 描述 symbol STRING NO recvWindow LONG NO timestamp LONG YES 每30秒更新数据 队列分数0，1，2，3，4，分数越高说明在ADL队列中的位置越靠前 对于单向持仓模式或者是逐仓状态下的双向持仓模式的交易对，会返回 "LONG", "SHORT" 和 "BOTH" 分别表示不同持仓方向上持仓的adl队列分数 对于全仓状态下的双向持仓模式的交易对，会返回 "LONG", "SHORT" 和 "HEDGE", 其中"HEDGE"的存在仅作为标记;其中如果多空均有持仓的情况下,"LONG"和"SHORT"返回共同计算后相同的队列分数。 用户强平单历史 (USER_DATA) 响应: [ { "orderId": 6071832819, "symbol": "BTCUSDT", "status": "FILLED", "clientOrderId": "autoclose-1596107620040000020", "price": "10871.09", "avgPrice": "10913.21000", "origQty": "0.001", "executedQty": "0.001", "cumQuote": "10.91321", "timeInForce": "IOC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "SELL", "positionSide": "BOTH", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "origType": "LIMIT", "time": 1596107620044, "updateTime": 1596107620087 } { "orderId": 6072734303, "symbol": "BTCUSDT", "status": "FILLED", "clientOrderId": "adl_autoclose", "price": "11023.14", "avgPrice": "10979.82000", "origQty": "0.001", "executedQty": "0.001", "cumQuote": "10.97982", "timeInForce": "GTC", "type": "LIMIT", "reduceOnly": false, "closePosition": false, "side": "BUY", "positionSide": "SHORT", "stopPrice": "0", "workingType": "CONTRACT_PRICE", "origType": "LIMIT", "time": 1596110725059, "updateTime": 1596110725071 } ] GET /fapi/v1/forceOrders 权重: 带symbol 20, 不带symbol 50 参数: 名称 类型 是否必需 描述 symbol STRING NO autoCloseType ENUM NO "LIQUIDATION": 强平单, "ADL": ADL减仓单. startTime LONG NO endTime LONG NO limit INT NO Default 50; max 100. recvWindow LONG NO timestamp LONG YES 如果没有传 "autoCloseType", 强平单和ADL减仓单都会被返回 如果没有传"startTime", 只会返回"endTime"之前7天内的数据 合约交易量化规则指标 (USER_DATA) 更多细节, 请参考合约交易量化规则 响应: { "indicators": { // indicator:风控指标名, value:用户在该市场的风控指标数值, triggerValue:阈值, 对于没有达到记录阈值的则不返回数据。 "BTCUSDT": [ { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, // 预计恢复时间，若当前时间大等于预计恢复时间则为空 "indicator": "UFR", // Unfilled Ratio (UFR) "value": 0.05, // Current value "triggerValue": 0.995 // Trigger value }, { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "IFER", // IOC/FOK Expiration Ratio (IFER) "value": 0.99, // Current value "triggerValue": 0.99 // Trigger value }, { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "GCR", // GTC Cancellation Ratio (GCR) "value": 0.99, // Current value "triggerValue": 0.99 // Trigger value }, { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "DR", // Dust Ratio (DR) "value": 0.99, // Current value "triggerValue": 0.99 // Trigger value } ], "ETHUSDT": [ { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "UFR", "value": 0.05, "triggerValue": 0.995 }, { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "IFER", "value": 0.99, "triggerValue": 0.99 }, { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "GCR", "value": 0.99, "triggerValue": 0.99 } { "isLocked": true, // 用户该品种交易是否被风控禁用 "plannedRecoverTime": 1545741270000, "indicator": "DR", "value": 0.99, "triggerValue": 0.99 } ] }, "updateTime": 1545741270000 // 返回值的更新时间 } 或(触发账号层级违规时) { "indicators":{ "ACCOUNT":[ { "indicator":"TMV", // Too many violations 多交易对触发账号层级违规 "value":10, "triggerValue":1, "plannedRecoverTime":1644919865000, "isLocked":true } ] }, "updateTime":1644913304748 } GET /fapi/v1/apiTradingStatus 权重: 带 symbol 1 不带 10 参数: 名称 类型 是否必需 描述 symbol STRING NO recvWindow LONG NO timestamp LONG YES 用户手续费率 (USER_DATA) 响应: { "symbol": "BTCUSDT", "makerCommissionRate": "0.0002", // 0.02% "takerCommissionRate": "0.0004" // 0.04% } GET /fapi/v1/commissionRate (HMAC SHA256) 权重: 20 参数: 名称 类型 是否必需 描述 symbol STRING YES recvWindow LONG NO timestamp LONG YES 获取合约资金流水下载Id (USER_DATA) 响应: { "avgCostTimestampOfLast30d":7241837, //过去30天平均数据下载时间 "downloadId":"546975389218332672", //下载Id } GET /fapi/v1/income/asyn (HMAC SHA256) 权重: 1500 参数: 名称 类型 是否必需 描述 startTime LONG YES 起始时间，ms格式时间戳 endTime LONG YES 结束时间，ms格式时间戳 recvWindow LONG NO timestamp LONG YES 存在每月5次的请求限制，网页端和Rest接口下载次数共用。 startTime与endTime间隔不能超过1年 通过下载Id获取合约资金流水下载链接 (USER_DATA) 响应: { "downloadId":"545923594199212032", // 下载Id "status":"completed", // 状态，枚举类型：completed 已完成，processing 处理中 "url":"www.binance.com", // 适配该笔ID请求的下载链接 "notified":true, // 忽略 "expirationTimestamp":1645009771000, // 晚于该时间戳之后链接将自动失效 "isExpired":null, } 或 (服务器仍在处理中会返回) { "downloadId":"545923594199212032", "status":"processing", "url":"", "notified":false, "expirationTimestamp":-1 "isExpired":null, } GET /fapi/v1/income/asyn/id (HMAC SHA256) 权重: 10 参数: 名称 类型 是否必需 描述 downloadId STRING YES 通过下载id 接口获取 recvWindow LONG NO timestamp LONG YES 下载链接有效期：24小时。 获取合约订单历史下载Id (USER_DATA) 响应: { "avgCostTimestampOfLast30d":7241837, //过去30天平均数据下载时间 "downloadId":"546975389218332672", //下载Id } GET /fapi/v1/order/asyn (HMAC SHA256) 权重: 1500 参数: 名称 类型 是否必需 描述 startTime LONG YES 起始时间，ms格式时间戳 endTime LONG YES 结束时间，ms格式时间戳 recvWindow LONG NO timestamp LONG YES 存在每月10次的请求限制，网页端和Rest接口下载次数共用。 startTime与endTime间隔不能超过1年 通过下载Id获取合约订单下载链接 (USER_DATA) 响应: { "downloadId":"545923594199212032", // 下载Id "status":"completed", // 状态，枚举类型：completed 已完成，processing 处理中 "url":"www.binance.com", // 适配该笔ID请求的下载链接 "notified":true, // 忽略 "expirationTimestamp":1645009771000, // 晚于该时间戳之后链接将自动失效 "isExpired":null, } 或 (服务器仍在处理中会返回) { "downloadId":"545923594199212032", "status":"processing", "url":"", "notified":false, "expirationTimestamp":-1 "isExpired":null, } GET /fapi/v1/order/asyn/id (HMAC SHA256) 权重: 10 参数: 名称 类型 是否必需 描述 downloadId STRING YES 通过下载id 接口获取 recvWindow LONG NO timestamp LONG YES 下载链接有效期：24小时。 获取合约交易历史下载Id (USER_DATA) 响应: { "avgCostTimestampOfLast30d":7241837, //过去30天平均数据下载时间 "downloadId":"546975389218332672", //下载Id } GET /fapi/v1/trade/asyn (HMAC SHA256) 权重: 1500 参数: 名称 类型 是否必需 描述 startTime LONG YES 起始时间，ms格式时间戳 endTime LONG YES 结束时间，ms格式时间戳 recvWindow LONG NO timestamp LONG YES 存在每月5次的请求限制，网页端和Rest接口下载次数共用。 startTime与endTime间隔不能超过1年 通过下载Id获取合约交易历史下载链接 (USER_DATA) 响应: { "downloadId":"545923594199212032", // 下载Id "status":"completed", // 状态，枚举类型：completed 已完成，processing 处理中 "url":"www.binance.com", // 适配该笔ID请求的下载链接 "notified":true, // 忽略 "expirationTimestamp":1645009771000, // 晚于该时间戳之后链接将自动失效 "isExpired":null, } 或 (服务器仍在处理中会返回) { "downloadId":"545923594199212032", "status":"processing", "url":"", "notified":false, "expirationTimestamp":-1 "isExpired":null, } GET /fapi/v1/trade/asyn/id (HMAC SHA256) 权重: 10 参数: 名称 类型 是否必需 描述 downloadId STRING YES 通过下载id 接口获取 recvWindow LONG NO timestamp LONG YES 下载链接有效期：24小时。 Websocket 账户信息推送 本篇所列出REST接口的baseurl https://fapi.binance.com 用于订阅账户数据的 listenKey 从创建时刻起有效期为60分钟 可以通过PUT一个listenKey延长60分钟有效期，如收到-1125报错提示此listenKey不存在，建议重新使用POST /fapi/v1/listenKey生成listenKey并用新listenKey建立连接 可以通过DELETE一个 listenKey 立即关闭当前数据流，并使该listenKey 无效 在具有有效listenKey的帐户上执行POST将返回当前有效的listenKey并将其有效期延长60分钟 本篇所列出的websocket接口，需使用以下连接方式： Base Url: wss://fstream.binance.com 订阅账户数据流的stream名称为 /ws/ 连接样例： wss://fstream.binance.com/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh 每个链接有效期不超过24小时，请妥善处理断线重连。 单一账户，单一连接的推送数据流消息可以保证时间序; 强烈建议您使用 E 字段进行排序 考虑到剧烈行情下, RESTful接口可能存在查询延迟，我们强烈建议您优先从Websocket user data stream推送的消息来获取订单，仓位等信息。 生成listenKey (USER_STREAM) 响应: { "listenKey": "pqia91ma19a5s61cv6a81va65sdf19v8a65a1a5s61cv6a81va65sdf19v8a65a1" } POST /fapi/v1/listenKey 创建一个新的user data stream，返回值为一个listenKey，即websocket订阅的stream名称。如果该帐户具有有效的listenKey，则将返回该listenKey并将其有效期延长60分钟。在极少数情况下，在该帐户具有有效的listenKey时本接口依然会生成新的listenKey，请使用该listenKey重新建议连接。不建议用本接口延长listenKey，建议用PUT /fapi/v1/listenKey延长listenkey 权重: 1 参数: None 延长listenKey有效期 (USER_STREAM) 响应: {} PUT /fapi/v1/listenKey 有效期延长至本次调用后60分钟。如收到-1125报错提示此listenKey不存在，建议重新使用POST /fapi/v1/listenKey生成listenKey并用新listenKey建立连接 权重: 1 参数: None 关闭listenKey (USER_STREAM) 响应: {} DELETE /fapi/v1/listenKey 关闭某账户数据流 权重: 1 参数: None listenKey 过期推送 Payload: { "stream": "OfYGbUzi3PraNagEkdKuFwUHn48brFsItTdsuiIXrucEvD0rhRXZ7I6URWfE8YE8", "data": { "e": "listenKeyExpired", // 事件类型 "E": "1699596037418", // 事件时间 "listenKey": "OfYGbUzi3PraNagEkdKuFwUHn48brFsItTdsuiIXrucEvD0rhRXZ7I6URWfE8YE8" } } 当前连接使用的有效listenKey过期时，user data stream 将会推送此事件。 注意: 此事件与websocket连接中断没有必然联系 只有正在连接中的有效listenKey过期时才会收到此消息 收到此消息后user data stream将不再更新，直到用户使用新的有效的listenKey Websocket 账户信息请求(将被弃用) 用户通过listenKey与服务器建立成功的用户信息websocket连接之后，可以使用请求获取账户信息。 以下数据可以通过websocket发送以获取账户信息。示例如下。 响应内容中的id是无符号整数，作为往来信息的唯一标识。 请求格式 响应 { "result"[ { "req":" "res": // request name 1 的请求结果 ... }, { "req":" "res": // request name 2 的请求结果 (如有) ... } ] "id": 12 // ID } 请求 { "method": "REQUEST", "params": [ " " ], "id": 12 // request ID. } 追加保证金通知 Payload: { "e":"MARGIN_CALL", // 事件类型 "E":1587727187525, // 事件时间 "cw":"3.16812045", // 除去逐仓仓位保证金的钱包余额, 仅在全仓 margin call 情况下推送此字段 "p":[ // 涉及持仓 { "s":"ETHUSDT", // symbol "ps":"LONG", // 持仓方向 "pa":"1.327", // 仓位 "mt":"CROSSED", // 保证金模式 "iw":"0", // 若为逐仓，仓位保证金 "mp":"187.17127", // 标记价格 "up":"-1.166074", // 未实现盈亏 "mm":"1.614445" // 持仓需要的维持保证金 } ] } 当用户持仓风险过高，会推送此消息。 此消息仅作为风险指导信息，不建议用于投资策略。 在大波动市场行情下,不排除此消息发出的同时用户仓位已被强平的可能。 全仓模式下若保证金不足每小时仅会推送一次此事件，不会重复推送；逐仓模式下保证金不足一个交易对每小时仅会推送一次此事件，不会重复推送 Balance和Position更新推送 Payload: { "e": "ACCOUNT_UPDATE", // 事件类型 "E": 1564745798939, // 事件时间 "T": 1564745798938 , // 撮合时间 "a": // 账户更新事件 { "m":"ORDER", // 事件推出原因 "B":[ // 余额信息 { "a":"USDT", // 资产名称 "wb":"122624.12345678", // 钱包余额 "cw":"100.12345678", // 除去逐仓仓位保证金的钱包余额 "bc":"50.12345678" // 除去盈亏与交易手续费以外的钱包余额改变量 }, { "a":"BUSD", "wb":"1.00000000", "cw":"0.00000000", "bc":"-49.12345678" } ], "P":[ { "s":"BTCUSDT", // 交易对 "pa":"0", // 仓位 "ep":"0.00000", // 入仓价格 "bep":"0", // 盈亏平衡价 "cr":"200", // (费前)累计实现损益 "up":"0", // 持仓未实现盈亏 "mt":"isolated", // 保证金模式 "iw":"0.00000000", // 若为逐仓，仓位保证金 "ps":"BOTH" // 持仓方向 }， { "s":"BTCUSDT", "pa":"20", "ep":"6563.66500", "bep":"6563.6", "cr":"0", "up":"2850.21200", "mt":"isolated", "iw":"13200.70726908", "ps":"LONG" }, { "s":"BTCUSDT", "pa":"-10", "ep":"6563.86000", "bep":"6563.6", "cr":"-45.04000000", "up":"-1423.15600", "mt":"isolated", "iw":"6570.42511771", "ps":"SHORT" } ] } } 账户更新事件的 event type 固定为 ACCOUNT_UPDATE 当账户信息有变动时，会推送此事件： 仅当账户信息有变动时(包括资金、仓位、保证金模式等发生变化)，才会推送此事件； 订单状态变化没有引起账户和持仓变化的，不会推送此事件； position 信息：仅当symbol仓位有变动时推送。 "FUNDING FEE" 引起的资金余额变化，仅推送简略事件： 当用户某全仓持仓发生"FUNDING FEE"时，事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息B(仅推送FUNDING FEE 发生相关的资产余额信息)，而不会推送任何持仓信息P。 当用户某逐仓仓持仓发生"FUNDING FEE"时，事件ACCOUNT_UPDATE将只会推送相关的用户资产余额信息B(仅推送"FUNDING FEE"所使用的资产余额信息)，和相关的持仓信息P(仅推送这笔"FUNDING FEE"发生所在的持仓信息)，其余持仓信息不会被推送。 字段"m"代表了事件推出的原因，包含了以下可能类型: DEPOSIT WITHDRAW ORDER FUNDING_FEE WITHDRAW_REJECT ADJUSTMENT INSURANCE_CLEAR ADMIN_DEPOSIT ADMIN_WITHDRAW MARGIN_TRANSFER MARGIN_TYPE_CHANGE ASSET_TRANSFER OPTIONS_PREMIUM_FEE OPTIONS_SETTLE_PROFIT AUTO_EXCHANGE COIN_SWAP_DEPOSIT COIN_SWAP_WITHDRAW 字段"bc"代表了钱包余额的改变量，即 balance change，但注意其不包含仓位盈亏及交易手续费。 订单/交易 更新推送 Payload: { "e":"ORDER_TRADE_UPDATE", // 事件类型 "E":1568879465651, // 事件时间 "T":1568879465650, // 撮合时间 "o":{ "s":"BTCUSDT", // 交易对 "c":"TEST", // 客户端自定订单ID // 特殊的自定义订单ID: // "autoclose-"开头的字符串: 系统强平订单 // "adl_autoclose": ADL自动减仓订单 // "settlement_autoclose-": 下架或交割的结算订单 "S":"SELL", // 订单方向 "o":"TRAILING_STOP_MARKET", // 订单类型 "f":"GTC", // 有效方式 "q":"0.001", // 订单原始数量 "p":"0", // 订单原始价格 "ap":"0", // 订单平均价格 "sp":"7103.04", // 条件订单触发价格，对追踪止损单无效 "x":"NEW", // 本次事件的具体执行类型 "X":"NEW", // 订单的当前状态 "i":8886774, // 订单ID "l":"0", // 订单末次成交量 "z":"0", // 订单累计已成交量 "L":"0", // 订单末次成交价格 "N": "USDT", // 手续费资产类型 "n": "0", // 手续费数量 "T":1568879465650, // 成交时间 "t":0, // 成交ID "b":"0", // 买单净值 "a":"9.91", // 卖单净值 "m": false, // 该成交是作为挂单成交吗？ "R":false , // 是否是只减仓单 "wt": "CONTRACT_PRICE", // 触发价类型 "ot": "TRAILING_STOP_MARKET", // 原始订单类型 "ps":"LONG" // 持仓方向 "cp":false, // 是否为触发平仓单; 仅在条件订单情况下会推送此字段 "AP":"7476.89", // 追踪止损激活价格, 仅在追踪止损单时会推送此字段 "cr":"5.0", // 追踪止损回调比例, 仅在追踪止损单时会推送此字段 "pP": false, // 是否开启条件单触发保护 "si": 0, // 忽略 "ss": 0, // 忽略 "rp":"0", // 该交易实现盈亏 "V":"EXPIRE_TAKER", // 自成交防止模式 "pm":"OPPONENT", // 价格匹配模式 "gtd":0 // TIF为GTD的订单自动取消时间 } } 当有新订单创建、订单有新成交或者新的状态变化时会推送此类事件 事件类型统一为 ORDER_TRADE_UPDATE 订单方向 BUY 买入 SELL 卖出 订单类型 MARKET 市价单 LIMIT 限价单 STOP 止损单 TAKE_PROFIT 止盈单 LIQUIDATION 强平单 本次事件的具体执行类型 NEW CANCELED 已撤 CALCULATED 订单ADL或爆仓 EXPIRED 订单失效 TRADE 交易 AMENDMENT 订单修改 订单状态 NEW PARTIALLY_FILLED FILLED CANCELED EXPIRED EXPIRED_IN_MATCH 有效方式: GTC IOC FOK GTX 强平和ADL: 若用户因保证金不足发生强平： c为"autoclose-XXX"，X为"NEW" 若用户保证金充足但被ADL: c为“adl_autoclose”，X为“NEW” 杠杆倍数等账户配置 更新推送 Payload: { "e":"ACCOUNT_CONFIG_UPDATE", // 事件类型 "E":1611646737479, // 事件时间 "T":1611646737476, // 撮合时间 "ac":{ "s":"BTCUSDT", // 交易对 "l":25 // 杠杆倍数 } } Or { "e":"ACCOUNT_CONFIG_UPDATE", // 事件类型 "E":1611646737479, // 事件时间 "T":1611646737476, // 撮合时间 "ai":{ // 用户账户配置 "j":true // 联合保证金状态 } } 当账户配置发生变化时会推送此类事件类型统一为ACCOUNT_CONFIG_UPDATE 当交易对杠杆倍数发生变化时推送消息体会包含对象ac表示交易对账户配置，其中s代表具体的交易对，l代表杠杆倍数 当用户联合保证金状态发生变化时推送消息体会包含对象ai表示用户账户配置，其中j代表用户联合保证金状态 策略交易 更新推送 Payload: { "e": "STRATEGY_UPDATE", // 事件类型 "T": 1669261797627, // 撮合时间 "E": 1669261797628, // 事件时间 "su": { "si": 176054594, // 策略 ID "st": "GRID", // 策略类型 "ss": "NEW", // 策略状态 "s": "BTCUSDT", // 交易对 "ut": 1669261797627, // 更新时间 "c": 8007 // opCode } } STRATEGY_UPDATE 在策略交易创建、取消、失效等等时候更新。 策略状态 NEW WORKING CANCELLED EXPIRED opCode 8001: 策略参数更改 8002: 用户取消策略 8003: 用户手动新增或取消订单 8004: 达到 stop limit 8005: 用户仓位爆仓 8006: 已达最大可挂单数量 8007: 新增网格策略 8008: 保证金不足 8009: 价格超出范围 8010: 市场非交易状态 8011: 关仓失败，平仓单无法成交 8012: 超过最大可交易名目金额 8013: 不符合网格交易身份 8014: 不符合 Futures Trading Quantitative Rules，策略终止 8015: 无仓位或是仓位已经爆仓 网格 更新推送 Payload: { "e": "GRID_UPDATE", // 事件类型 "T": 1669262908216, // 撮合时间 "E": 1669262908218, // 事件时间 "gu": { "si": 176057039, // 策略 ID "st": "GRID", // 策略类型 "ss": "WORKING", // 策略状态 "s": "BTCUSDT", // 交易对 "r": "-0.00300716", // 已实现 PNL "up": "16720", // 未配对均价 "uq": "-0.001", // 未配对数量 "uf": "-0.00300716", // 未配对手续费 "mp": "0.0", // 已配对 PNL "ut": 1669262908197 // 更新时间 } } GRID_UPDATE 在网格子订单有部份或是完全成交时更新。 策略状态 NEW WORKING CANCELLED EXPIRED 条件订单（TP/SL）触发后拒绝 更新推送 Payload: { "e":"CONDITIONAL_ORDER_TRIGGER_REJECT", // 事件类型 "E":1685517224945, // 事件时间 "T":1685517224955, // 撮合时间 "or":{ "s":"ETHUSDT", // 交易对 "i":155618472834, // 订单号 "r":"Due to the order could not be filled immediately, the FOK order has been rejected. The order will not be recorded in the order history", // 拒绝原因 } } CONDITIONAL_ORDER_TRIGGER_REJECT 在止盈止损单触发后被拒绝时推送 经典统一账户 为了给币安合约用户提供更加优质的服务及提高用户的资金利用率，币安将推出经典统一账户计划。该计划将以合约钱包、现货杠杆钱包的总资产作为保证金来计算。 关于经典统一帐户：币安经典统一帐户计划是一项跨资产保证金计划，支持超过 200 种有效的加密资产。 U本位合约、币本位合约以及杠杆钱包中支持的加密资产和头寸将作为有效的联合抵押品，以确定经典统一账户的权益、保证金余额和维持保证金要求。 FAQ: 币安合约经典统一账户总览 仅对特定用户开放此功能，详情：加入经典统一账户计划 查询经典统一账户账户信息 (USER_DATA) 响应： { "maxWithdrawAmountUSD": "1627523.32459208", //经典统一账户以USD计价的最大可转出余额 "asset": "BTC", // 资产 "maxWithdrawAmount": "27.43689636", //忽略 } GET /fapi/v1/pmAccountInfo 查询经典统一账户当前账户信息 权重(IP)： 5 参数： 名称 类型 是否必需 描述 asset STRING YES recvWindow LONG NO timestamp LONG YES 最大可转出余额指可以转出到现货钱包到金额。 经典统一账户推送 Websocket的base url是: wss://fstream.binance.com/pm-classic 订阅账户数据流的stream名称为 /ws/ 连接样例: wss://fstream.binance.com/pm-classic/ws/XaEAKTsQSRLZAGH9tuIu37plSRsdjmlAVBoNYPUITlTAko1WI22PgmBMpI1rS8Yh 账户风险状态变动 Payload: { "e":"riskLevelChange", "E":1587727187525, "u":"1.99999999", "s":"MARGIN_CALL", "eq":"30.23416728", "ae":"30.23416728", "m":"15.11708371" } 当用户账户的风险状态变化时，该时间被推出。 该消息仅作为风控参考，不作为投资建议。 RISK_LEVEL_CHANGE 包含以下类型：MARGIN_CALL, SUPPLY_MARGIN, REDUCE_ONLY, FORCE_LIQUIDATION 高波动率市场下，用户仓位可能在事件推出时被爆仓 错误代码 error JSON payload: { "code":-1121, "msg":"Invalid symbol." } 错误由两部分组成：错误代码和消息。 代码是通用的，但是消息可能会有所不同。 10xx - 常规服务器或网络问题-1000 UNKNOWN An unknown error occured while processing the request. 处理请求时发生未知错误。 -1001 DISCONNECTED Internal error; unable to process your request. Please try again. 内部错误; 无法处理您的请求。 请再试一次. -1002 UNAUTHORIZED You are not authorized to execute this request. 您无权执行此请求。 -1003 TOO_MANY_REQUESTS Too many requests queued. 排队的请求过多。 Too many requests; please use the websocket for live updates. 请求权重过多； 请使用websocket获取最新更新。 Too many requests; current limit is %s requests per minute. Please use the websocket for live updates to avoid polling the API. 请求权重过多； 当前限制为每分钟％s请求权重。 请使用websocket进行实时更新，以避免轮询API。 Way too many requests; IP banned until %s. Please use the websocket for live updates to avoid bans. 请求权重过多； IP被禁止，直到％s。 请使用websocket进行实时更新，以免被禁。 -1004 DUPLICATE_IP This IP is already on the white list IP地址已经在白名单 -1005 NO_SUCH_IP No such IP has been white listed 白名单上没有此IP地址 -1006 UNEXPECTED_RESP An unexpected response was received from the message bus. Execution status unknown. 从消息总线收到意外的响应。执行状态未知。 -1007 TIMEOUT Timeout waiting for response from backend server. Send status unknown; execution status unknown. 等待后端服务器响应超时。 发送状态未知； 执行状态未知。 -1008 SERVER_BUSY Server is currently overloaded with other requests. Please try again in a few minutes. 服务器响应超时。 请稍后重试 -1014 UNKNOWN_ORDER_COMPOSITION Unsupported order combination. 不支持当前的下单参数组合 -1015 TOO_MANY_ORDERS Too many new orders. 新订单太多。 Too many new orders; current limit is %s orders per %s. * 新订单太多； 当前限制为每％s ％s个订单。 -1016 SERVICE_SHUTTING_DOWN This service is no longer available. 该服务不可用。 -1020 UNSUPPORTED_OPERATION This operation is not supported. 不支持此操作。 -1021 INVALID_TIMESTAMP Timestamp for this request is outside of the recvWindow. 此请求的时间戳在recvWindow之外。 Timestamp for this request was 1000ms ahead of the server's time. * 此请求的时间戳比服务器时间提前1000毫秒。 -1022 INVALID_SIGNATURE Signature for this request is not valid. 此请求的签名无效。 -1023 START_TIME_GREATER_THAN_END_TIME Start time is greater than end time. 参数里面的开始时间在结束时间之后 -1099 NOT_FOUND Not found, unauthenticated, or unauthorized. 11xx - Request issues-1100 ILLEGAL_CHARS Illegal characters found in a parameter. 在参数中发现非法字符。 Illegal characters found in parameter '%s'; legal range is '%s'. 在参数％s中发现非法字符； 合法范围是％s。 -1101 TOO_MANY_PARAMETERS Too many parameters sent for this endpoint. 为此端点发送的参数太多。 Too many parameters; expected '%s' and received '%s'. 参数太多；预期为％s并收到了％s。 Duplicate values for a parameter detected. * 检测到的参数值重复。 -1102 MANDATORY_PARAM_EMPTY_OR_MALFORMED A mandatory parameter was not sent, was empty/null, or malformed. 未发送强制性参数，该参数为空/空或格式错误。 Mandatory parameter '%s' was not sent, was empty/null, or malformed. * 强制参数％s未发送，为空/空或格式错误。 Param '%s' or '%s' must be sent, but both were empty/null! * 必须发送参数％s或％s，但两者均为空！ -1103 UNKNOWN_PARAM An unknown parameter was sent. 发送了未知参数。 -1104 UNREAD_PARAMETERS Not all sent parameters were read. 并非所有发送的参数都被读取。 Not all sent parameters were read; read '%s' parameter(s) but was sent '%s'. 并非所有发送的参数都被读取； 读取了％s参数，但被发送了％s。 -1105 PARAM_EMPTY A parameter was empty. 参数为空。 Parameter '%s' was empty. 参数％s为空。 -1106 PARAM_NOT_REQUIRED A parameter was sent when not required. 发送了不需要的参数。 Parameter '%s' sent when not required. 发送了不需要参数％s。 -1108 BAD_ASSET Invalid asset. 资产不正确 -1109 BAD_ACCOUNT Invalid account. 非有效账户 -1110 BAD_INSTRUMENT_TYPE Invalid symbolType. 交易对不正确 -1111 BAD_PRECISION Precision is over the maximum defined for this asset. 精度超过为此资产定义的最大值。 -1112 NO_DEPTH No orders on book for symbol. 交易对没有挂单。 -1113 WITHDRAW_NOT_NEGATIVE Withdrawal amount must be negative. 提现数量需要为负 -1114 TIF_NOT_REQUIRED TimeInForce parameter sent when not required. 发送的TimeInForce参数不需要。 -1115 INVALID_TIF Invalid timeInForce. 无效的timeInForce -1116 INVALID_ORDER_TYPE Invalid orderType. 无效订单类型。 -1117 INVALID_SIDE Invalid side. 无效买卖方向。 -1118 EMPTY_NEW_CL_ORD_ID New client order ID was empty. 新的客户订单ID为空。 -1119 EMPTY_ORG_CL_ORD_ID Original client order ID was empty. 客户自定义的订单ID为空。 -1120 BAD_INTERVAL Invalid interval. 无效时间间隔。 -1121 BAD_SYMBOL Invalid symbol. 无效的交易对。 -1122 INVALID_SYMBOL_STATUS Invalid symbol status. 交易对状态不正确。 -1125 INVALID_LISTEN_KEY This listenKey does not exist. 此listenKey不存在。建议重新使用POST /fapi/v1/listenKey生成listenKey -1126 ASSET_NOT_SUPPORTED This asset is not supported. 不支持该资产 -1127 MORE_THAN_XX_HOURS Lookup interval is too big. 查询间隔太大。 More than %s hours between startTime and endTime. 从开始时间到结束时间之间超过％s小时。 -1128 OPTIONAL_PARAMS_BAD_COMBO Combination of optional parameters invalid. 可选参数组合无效。 -1130 INVALID_PARAMETER Invalid data sent for a parameter. 发送的参数为无效数据。 Data sent for parameter '%s' is not valid. 发送参数％s的数据无效。 -1136 INVALID_NEW_ORDER_RESP_TYPE Invalid newOrderRespType. 无效的 newOrderRespType。 20xx - Processing Issues-2010 NEW_ORDER_REJECTED NEW_ORDER_REJECTED 新订单被拒绝 -2011 CANCEL_REJECTED CANCEL_REJECTED 取消订单被拒绝 -2012 CANCEL_ALL_FAIL Batch cancel failure. 批量取消失败 -2013 NO_SUCH_ORDER Order does not exist. 订单不存在。 -2014 BAD_API_KEY_FMT API-key format invalid. API-key 格式无效。 -2015 REJECTED_MBX_KEY Invalid API-key, IP, or permissions for action. 无效的API密钥，IP或操作权限。 -2016 NO_TRADING_WINDOW No trading window could be found for the symbol. Try ticker/24hrs instead. 找不到该交易对的交易窗口。 尝试改为24小时自动报价。 -2017 API_KEYS_LOCKED API Keys are locked on this account. API key被上锁 -2018 BALANCE_NOT_SUFFICIENT Balance is insufficient. 余额不足 -2019 MARGIN_NOT_SUFFICIEN Margin is insufficient. 杠杆账户余额不足 -2020 UNABLE_TO_FILL Unable to fill. 无法成交 -2021 ORDER_WOULD_IMMEDIATELY_TRIGGER Order would immediately trigger. 订单可能被立刻触发 -2022 REDUCE_ONLY_REJECT ReduceOnly Order is rejected. ReduceOnly订单被拒绝 -2023 USER_IN_LIQUIDATION User in liquidation mode now. 用户正处于被强平模式 -2024 POSITION_NOT_SUFFICIENT Position is not sufficient. 持仓不足 -2025 MAX_OPEN_ORDER_EXCEEDED Reach max open order limit. 挂单量达到上限 -2026 REDUCE_ONLY_ORDER_TYPE_NOT_SUPPORTED This OrderType is not supported when reduceOnly. 当前订单类型不支持reduceOnly -2027 MAX_LEVERAGE_RATIO Exceeded the maximum allowable position at current leverage. 挂单或持仓超出当前初始杠杆下的最大值 -2028 MIN_LEVERAGE_RATIO Leverage is smaller than permitted: insufficient margin balance. 调整初始杠杆过低，导致可用余额不足 40xx - Filters and other Issues-4000 INVALID_ORDER_STATUS Invalid order status. 订单状态不正确 -4001 PRICE_LESS_THAN_ZERO Price less than 0. 价格小于0 -4002 PRICE_GREATER_THAN_MAX_PRICE Price greater than max price. 价格超过最大值 -4003 QTY_LESS_THAN_ZERO Quantity less than zero. 数量小于0 -4004 QTY_LESS_THAN_MIN_QTY Quantity less than min quantity. 数量小于最小值 -4005 QTY_GREATER_THAN_MAX_QTY Quantity greater than max quantity. 数量大于最大值 -4006 STOP_PRICE_LESS_THAN_ZERO Stop price less than zero. 触发价小于最小值 -4007 STOP_PRICE_GREATER_THAN_MAX_PRICE Stop price greater than max price. 触发价大于最大值 -4008 TICK_SIZE_LESS_THAN_ZERO Tick size less than zero. 价格精度小于0 -4009 MAX_PRICE_LESS_THAN_MIN_PRICE Max price less than min price. 最大价格小于最小价格 -4010 MAX_QTY_LESS_THAN_MIN_QTY Max qty less than min qty. 最大数量小于最小数量 -4011 STEP_SIZE_LESS_THAN_ZERO Step size less than zero. 步进值小于0 -4012 MAX_NUM_ORDERS_LESS_THAN_ZERO Max num orders less than zero. 最大订单量小于0 -4013 PRICE_LESS_THAN_MIN_PRICE Price less than min price. 价格小于最小价格 -4014 PRICE_NOT_INCREASED_BY_TICK_SIZE Price not increased by tick size. 价格增量不是价格精度的倍数。 -4015 INVALID_CL_ORD_ID_LEN Client order id is not valid. 客户订单ID有误。 Client order id length should not be more than 36 chars 客户订单ID长度应该不多于36字符 -4016 PRICE_HIGHTER_THAN_MULTIPLIER_UP Price is higher than mark price multiplier cap. -4017 MULTIPLIER_UP_LESS_THAN_ZERO Multiplier up less than zero. 价格上限小于0 -4018 MULTIPLIER_DOWN_LESS_THAN_ZERO Multiplier down less than zero. 价格下限小于0 -4019 COMPOSITE_SCALE_OVERFLOW Composite scale too large. -4020 TARGET_STRATEGY_INVALID Target strategy invalid for orderType '%s',reduceOnly '%b'. 目标策略值不适合%s订单状态, 只减仓%b。 -4021 INVALID_DEPTH_LIMIT Invalid depth limit. 深度信息的limit值不正确。 '%s' is not valid depth limit. %s不是合理的深度信息的limit值。 -4022 WRONG_MARKET_STATUS market status sent is not valid. 发送的市场状态不正确。 -4023 QTY_NOT_INCREASED_BY_STEP_SIZE Qty not increased by step size. 数量的递增值不是步进值的倍数。 -4024 PRICE_LOWER_THAN_MULTIPLIER_DOWN Price is lower than mark price multiplier floor. -4025 MULTIPLIER_DECIMAL_LESS_THAN_ZERO Multiplier decimal less than zero. -4026 COMMISSION_INVALID Commission invalid. 收益值不正确 %s less than zero. %s少于0 %s absolute value greater than %s %s绝对值大于%s -4027 INVALID_ACCOUNT_TYPE Invalid account type. 账户类型不正确。 -4028 INVALID_LEVERAGE Invalid leverage 杠杆倍数不正确 Leverage %s is not valid 杠杆%s不正确 Leverage %s already exist with %s 杠杆%s已经存在于%s -4029 INVALID_TICK_SIZE_PRECISION Tick size precision is invalid. 价格精度小数点位数不正确。 -4030 INVALID_STEP_SIZE_PRECISION Step size precision is invalid. 步进值小数点位数不正确。 -4031 INVALID_WORKING_TYPE Invalid parameter working type 不正确的参数类型 Invalid parameter working type: %s 不正确的参数类型: %s -4032 EXCEED_MAX_CANCEL_ORDER_SIZE Exceed maximum cancel order size. 超过可以取消的最大订单量。 Invalid parameter working type: %s 不正确的参数类型: %s -4033 INSURANCE_ACCOUNT_NOT_FOUND Insurance account not found. 风险保障基金账号没找到。 -4044 INVALID_BALANCE_TYPE Balance Type is invalid. 余额类型不正确。 -4045 MAX_STOP_ORDER_EXCEEDED Reach max stop order limit. 达到止损单的上限。 -4046 NO_NEED_TO_CHANGE_MARGIN_TYPE No need to change margin type. 不需要切换仓位模式。 -4047 THERE_EXISTS_OPEN_ORDERS Margin type cannot be changed if there exists open orders. 如果有挂单，仓位模式不能切换。 -4048 THERE_EXISTS_QUANTITY Margin type cannot be changed if there exists position. 如果有仓位，仓位模式不能切换。 -4049 ADD_ISOLATED_MARGIN_REJECT Add margin only support for isolated position. -4050 CROSS_BALANCE_INSUFFICIENT Cross balance insufficient. 全仓余额不足。 -4051 ISOLATED_BALANCE_INSUFFICIENT Isolated balance insufficient. 逐仓余额不足。 -4052 NO_NEED_TO_CHANGE_AUTO_ADD_MARGIN No need to change auto add margin. -4053 AUTO_ADD_CROSSED_MARGIN_REJECT Auto add margin only support for isolated position. 自动增加保证金只适用于逐仓。 -4054 ADD_ISOLATED_MARGIN_NO_POSITION_REJECT Cannot add position margin: position is 0. 不能增加逐仓保证金: 持仓为0 -4055 AMOUNT_MUST_BE_POSITIVE Amount must be positive. 数量必须是正整数 -4056 INVALID_API_KEY_TYPE Invalid api key type. API key的类型不正确 -4057 INVALID_RSA_PUBLIC_KEY Invalid api public key API key不正确 -4058 MAX_PRICE_TOO_LARGE maxPrice and priceDecimal too large,please check. maxPrice和priceDecimal太大，请检查。 -4059 NO_NEED_TO_CHANGE_POSITION_SIDE No need to change position side. 无需变更仓位方向 -4060 INVALID_POSITION_SIDE Invalid position side. 仓位方向不正确。 -4061 POSITION_SIDE_NOT_MATCH Order's position side does not match user's setting. 订单的持仓方向和用户设置不一致。 -4062 REDUCE_ONLY_CONFLICT Invalid or improper reduceOnly value. 仅减仓的设置不正确。 -4063 INVALID_OPTIONS_REQUEST_TYPE Invalid options request type 无效的期权请求类型 -4064 INVALID_OPTIONS_TIME_FRAME Invalid options time frame 无效的期权时间窗口 -4065 INVALID_OPTIONS_AMOUNT Invalid options amount 无效的期权数量 -4066 INVALID_OPTIONS_EVENT_TYPE Invalid options event type 无效的期权事件类型 -4067 POSITION_SIDE_CHANGE_EXISTS_OPEN_ORDERS Position side cannot be changed if there exists open orders. 如果有挂单，无法修改仓位方向。 -4068 POSITION_SIDE_CHANGE_EXISTS_QUANTITY Position side cannot be changed if there exists position. 如果有仓位, 无法修改仓位方向。 -4069 INVALID_OPTIONS_PREMIUM_FEE Invalid options premium fee 无效的期权费 -4070 INVALID_CL_OPTIONS_ID_LEN Client options id is not valid. 客户的期权ID不合法 Client options id length should be less than 32 chars 客户的期权ID长度应该小于32个字符 -4071 INVALID_OPTIONS_DIRECTION Invalid options direction 期权的方向无效 -4072 OPTIONS_PREMIUM_NOT_UPDATE premium fee is not updated, reject order 期权费没有更新 -4073 OPTIONS_PREMIUM_INPUT_LESS_THAN_ZERO input premium fee is less than 0, reject order 输入的期权费小于0 -4074 OPTIONS_AMOUNT_BIGGER_THAN_UPPER Order amount is bigger than upper boundary or less than 0, reject order -4075 OPTIONS_PREMIUM_OUTPUT_ZERO output premium fee is less than 0, reject order -4076 OPTIONS_PREMIUM_TOO_DIFF original fee is too much higher than last fee 期权的费用比之前的费用高 -4077 OPTIONS_PREMIUM_REACH_LIMIT place order amount has reached to limit, reject order 下单的数量达到上限 -4078 OPTIONS_COMMON_ERROR options internal error 期权内部系统错误 -4079 INVALID_OPTIONS_ID invalid options id invalid options id: %s duplicate options id %d for user %d 期权ID无效 -4080 OPTIONS_USER_NOT_FOUND user not found user not found with id: %s 用户找不到 -4081 OPTIONS_NOT_FOUND options not found options not found with id: %s 期权找不到 -4082 INVALID_BATCH_PLACE_ORDER_SIZE Invalid number of batch place orders. Invalid number of batch place orders: %s 批量下单的数量不正确 -4083 PLACE_BATCH_ORDERS_FAIL Fail to place batch orders. 无法批量下单 -4084 UPCOMING_METHOD Method is not allowed currently. Upcoming soon. 方法不支持 -4085 INVALID_NOTIONAL_LIMIT_COEF Invalid notional limit coefficient 期权的有限系数不正确 -4086 INVALID_PRICE_SPREAD_THRESHOLD Invalid price spread threshold 无效的价差阀值 -4087 REDUCE_ONLY_ORDER_PERMISSION User can only place reduce only order 用户只能下仅减仓订单 -4088 NO_PLACE_ORDER_PERMISSION User can not place order currently 用户当前不能下单 -4104 INVALID_CONTRACT_TYPE Invalid contract type 无效的合约类型 -4114 INVALID_CLIENT_TRAN_ID_LEN clientTranId is not valid clientTranId不正确 Client tran id length should be less than 64 chars 客户的tranId长度应该小于64个字符 -4115 DUPLICATED_CLIENT_TRAN_ID clientTranId is duplicated clientTranId重复 Client tran id should be unique within 7 days 客户的tranId应在7天内唯一 -4118 REDUCE_ONLY_MARGIN_CHECK_FAILED ReduceOnly Order Failed. Please check your existing position and open orders 仅减仓订单失败。请检查现有的持仓和挂单 -4131 MARKET_ORDER_REJECT The counterparty's best price does not meet the PERCENT_PRICE filter limit 交易对手的最高价格未达到PERCENT_PRICE过滤器限制 -4135 INVALID_ACTIVATION_PRICE Invalid activation price 无效的激活价格 -4137 QUANTITY_EXISTS_WITH_CLOSE_POSITION Quantity must be zero with closePosition equals true 数量必须为0，当closePosition为true时 -4138 REDUCE_ONLY_MUST_BE_TRUE Reduce only must be true with closePosition equals true Reduce only 必须为true，当closePosition为true时 -4139 ORDER_TYPE_CANNOT_BE_MKT Order type can not be market if it's unable to cancel 订单类型不能为市价单如果不能取消 -4140 INVALID_OPENING_POSITION_STATUS Invalid symbol status for opening position 无效的交易对状态 -4141 SYMBOL_ALREADY_CLOSED Symbol is closed 交易对已下架 -4142 STRATEGY_INVALID_TRIGGER_PRICE REJECT: take profit or stop order will be triggered immediately 拒绝：止盈止损单将立即被触发 -4144 INVALID_PAIR Invalid pair 无效的pair -4161 ISOLATED_LEVERAGE_REJECT_WITH_POSITION Leverage reduction is not supported in Isolated Margin Mode with open positions 逐仓仓位模式下无法降低杠杆 -4164 MIN_NOTIONAL Order's notional must be no smaller than 5.0 (unless you choose reduce only) 订单的名义价值不可以小于5，除了使用reduce only Order's notional must be no smaller than %s (unless you choose reduce only) 订单的名义价值不可以小于%s，除了使用reduce only -4165 INVALID_TIME_INTERVAL Invalid time interval 无效的间隔 Maximum time interval is %s days 最大的时间间隔为 %s 天 -4167 ISOLATED_REJECT_WITH_JOINT_MARGIN Unable to adjust to Multi-Assets mode with symbols of USDⓈ-M Futures under isolated-margin mode. 因有交易对在逐仓模式，无法切换多资产模式 -4168 JOINT_MARGIN_REJECT_WITH_ISOLATED Unable to adjust to isolated-margin mode under the Multi-Assets mode. 多资产模式下无法使用逐仓 -4169 JOINT_MARGIN_REJECT_WITH_MB Unable to adjust Multi-Assets Mode with insufficient margin balance in USDⓈ-M Futures. 保证金不足无法切换多资产模式 -4170 JOINT_MARGIN_REJECT_WITH_OPEN_ORDER Unable to adjust Multi-Assets Mode with open orders in USDⓈ-M Futures. 账户有订单无法切换多资产模式 -4171 NO_NEED_TO_CHANGE_JOINT_MARGIN Adjusted asset mode is currently set and does not need to be adjusted repeatedly. 多资产模式已经被设置 -4172 JOINT_MARGIN_REJECT_WITH_NEGATIVE_BALANCE Unable to adjust Multi-Assets Mode with a negative wallet balance of margin available asset in USDⓈ-M Futures account. -4183 PRICE_HIGHTER_THAN_STOP_MULTIPLIER_UP Price is higher than stop price multiplier cap. 止盈止损订单价格不应高于触发价与报价乘数上限的乘积 Limit price can't be higher than %s. 止盈止损订单价格不应高于 %s -4184 PRICE_LOWER_THAN_STOP_MULTIPLIER_DOWN Price is lower than stop price multiplier floor. 止盈止损订单价格不应低于触发价与报价乘数下限的乘积 Limit price can't be lower than %s. 止盈止损订单价格不应低于 %sf -4192 COOLING_OFF_PERIOD Trade forbidden due to Cooling-off Period. 合约冷静期禁止开仓 -4202 ADJUST_LEVERAGE_KYC_FAILED Intermediate Personal Verification is required for adjusting leverage over 20x 需要通过中级KYC才能使用20x以上杠杆 -4203 ADJUST_LEVERAGE_ONE_MONTH_FAILED More than 20x leverage is available one month after account registration. 开户1个月后才可以使用20倍以上杠杆 -4205 ADJUST_LEVERAGE_X_DAYS_FAILED More than 20x leverage is available %s days after Futures account registration. 开户%s天后才可以使用20倍以上杠杆 -4206 ADJUST_LEVERAGE_KYC_LIMIT Users in this country has limited adjust leverage. Users in your location/country can only access a maximum leverage of %s 该国家有杠杆限制 该国家杠杆不能超过%s倍 -4208 ADJUST_LEVERAGE_ACCOUNT_SYMBOL_FAILED Current symbol leverage cannot exceed 20 when using position limit adjustment service. 开启仓位放大功能的用户无法使用20x以上杠杆 -4209 ADJUST_LEVERAGE_SYMBOL_FAILED The max leverage of Symbol is 20x Leverage adjustment failed. Current symbol max leverage limit is %sx 交易对最大杠杆为20x 杠杆调整失败。交易对最大杠杆为%sx -4210 STOP_PRICE_HIGHER_THAN_PRICE_MULTIPLIER_LIMIT Stop price is higher than price multiplier cap. Stop price can't be higher than %s 触发价超过价格上限 触发价不能超过%s -4211 STOP_PRICE_LOWER_THAN_PRICE_MULTIPLIER_LIMIT Stop price is lower than price multiplier floor. Stop price can't be lower than %s 触发价低于超过价格下限 触发价不能低于%s -4400 TRADING_QUANTITATIVE_RULE Futures Trading Quantitative Rules violated, only reduceOnly order is allowed, please try again later. 违反合约量化交易规则，账户设置为近减仓，请之后再试 -4401 COMPLIANCE_RESTRICTION Compliance restricted account permission: can only place reduceOnly order. 账户不满足合规条件，设置为仅减仓 -4402 COMPLIANCE_BLACK_SYMBOL_RESTRICTION Dear user, as per our Terms of Use and compliance with local regulations, this feature is currently not available in your region. 根据合规要求，所在地区不提供此服务 -4403 ADJUST_LEVERAGE_COMPLIANCE_FAILED Dear user, as per our Terms of Use and compliance with local regulations, the leverage can only up to 10x in your region Dear user, as per our Terms of Use and compliance with local regulations, the leverage can only up to %sx in your region 根据合规要求，所在地区杠杆不可超过10x 根据合规要求，所在地区杠杆不可超过%sx 50xx - Order Execution Issues-5021 FOK_ORDER_REJECT Due to the order could not be filled immediately, the FOK order has been rejected. The order will not be recorded in the order history 订单无法完全成交，FOK订单被拒绝 -5022 GTX_ORDER_REJECT Due to the order could not be executed as maker, the Post Only order will be rejected. The order will not be recorded in the order history 订单无法仅做maker单， Post Only订单被拒绝 -5024 MOVE_ORDER_NOT_ALLOWED_SYMBOL_REASON Symbol is not in trading status. Order amendment is not permitted. 交易对不在交易状态，无法改单 -5025 LIMIT_ORDER_ONLY Only limit order is supported. 仅支持限价单改单 -5026 Exceed_Maximum_Modify_Order_Limit Exceed maximum modify order limit. 超过单个订单改单次数上限 -5027 SAME_ORDER No need to modify the order. 与原订单相同，非必要改单 -5028 ME_RECVWINDOW_REJECT 请求的时间戳在撮合的recvWindow之外 -5037 INVALID_PRICE_MATCH 非法价格匹配类型 -5038 UNSUPPORTED_ORDER_TYPE_PRICE_MATCH 价格匹配功能仅支持LIMIT/STOP/TAKE_PROFIT类型的订单 -5039 INVALID_SELF_TRADE_PREVENTION_MODE 不正确的STP模式 -5040 FUTURE_GOOD_TILL_DATE goodTillDate时间戳需要大于当前时间600秒且小于253402300799000 -5041 BBO_ORDER_REJECT 该档位没有对应价格 â€�Binance.US: Buy Bitcoin & ETH on the App Store ExitAppleStoreMaciPadiPhoneWatchAirPodsTV & HomeEntertainmentAccessoriesSupport 0+ App Store Preview Binance.US: Buy Bitcoin & ETH 4+ Buy BTC & ETH | 0% Fee Trading BAM Trading Services, Inc. Designed for iPhone #25 in Finance 4.2 • 108K Ratings Free Screenshots iPhone Apple Watch Description Binance.US is the leading crypto platform trusted by millions of customers in the U.S. Securely buy and sell bitcoin and 150+ cryptocurrencies with some of the lowest fees available anywhere, including zero fee trading for BTC on select pairs.TRADE BITCOIN FOR FREEStart your crypto portfolio in as little as two minutes. Easily trade BTC with $0 fees on select pairs. All it takes is a few quick taps to start trading on Binance.US.SECURELY STAKE CRYPTO - Start staking crypto to help support your favorite projects and contribute to the network’s security and operation while earning rewards.- Named by USA Today & Forbes Advisor as one of the best cryptocurrency platforms for staking.- Stake 15+ cryptocurrencies, including Ethereum (ETH), Cardano (ADA), BNB, and many of the largest Proof-of-Stake (PoS) assets.- Help secure blockchain networks and protocols while earning staking rewards.EASY FOR BEGINNERS, USEFUL TO EXPERIENCED TRADERS- Download the Binance.US app today and experience a fast, easy, and secure way to trade crypto.- Learn while you trade with helpful tool-tips, cryptocurrency descriptions, and newsworthy headlines to guide you in your crypto journey.BUY OR SELL 150+ COINS- Access Bitcoin (BTC), Ethereum (ETH), Cardano (ADA), BNB, Dogecoin (DOGE), Solana (SOL), Polygon (MATIC), Avalanche (AVAX), Ethereum Classic (ETC), Stellar Lumens (XLM), and more.- Buy & sell crypto with USDT, our base asset for buying, selling, and trading 150+ cryptocurrencies.GET THE FOLLOWING AND MORE WITH BINANCE.US- Buy and sell crypto instantly with only a few taps.- Trade like a pro with advanced trading tools, live charts, and real-time order book information.- Stake crypto to help secure your favorite blockchain networks, support crypto projects, and earn staking rewards.- Send, request, receive, and gift crypto instantly for free with Pay. - Convert between cryptocurrencies with zero transaction fees. A spread applies when converting crypto.- Set price alerts for your favorite cryptocurrencies so you never miss an opportunity. ADVANCED CRYPTO SPOT TRADING FUNCTIONALITY- Power your trades with an advanced interface built from the ground up for seasoned crypto traders.- Access a range of sophisticated trading tools including live candlestick charts, technical analysis indicators, and real-time order book information.- Place market, limit, stop-limit, trailing stop, and OCO orders to manage risk and get more out of your trades.- Execute complex trading strategies on-the-go with low fees and superior price discovery.INDUSTRY-LEADING SECURITY- Trade with peace of mind on the crypto platform of choice for customers looking to securely store their crypto.- Your crypto belongs to you. All customer assets are held on a 1:1 basis, so you can access your funds anytime you want.- Binance.US is proud to maintain world-class accreditations and certifications, including ISO/IEC 27701 and ISO/IEC 27001 accreditation, SOC 2, Type 1 certification, and PCI-DSS certification.US-BASED CUSTOMER SUPPORT- Connect with our majority U.S.-based customer support agents anytime, anywhere, right from the Binance.US mobile app or website.- Get real-time support and answers to your questions with our live chat feature.- Find answers to common questions or issues and access helpful tutorials and how-to guides on our Support Center.TRADE & TRACK OVER 150 CRYPTOCURRENCIESBuy, trade, convert, and track over 150 popular cryptocurrencies including BTC, ETH, ADA, DOGE, LTC, SOL, SHIB, MATIC, AVAX, ETC, XLM, HBAR, USDT, ALGO, LRC, MANA, USDC, LINK, DOT, BCH, XTZ, and more! What’s New Jan 31, 2024 Version 3.12.1 - Several improvements and bug fixes Ratings and Reviews 4.2 out of 5 108K Ratings 108K Ratings Mikeyman1952 , 08/16/2021 Almost Non existent customer service. Update turns out I was mislead by someone else that I could use this but my state isn’t but the one star comes from not being able to delete my account what gives (Update) customer service is not very helpful rather than help me to terminate my account I got one email about terms of service dodging my request all together then sent me an email asking me how well they handled my problem. (Update part1) i was once again emailed the exact same automated response as the first time. This is a service that does not seem to care about it’s users so if you don’t know what your doing or you’re having any trouble Binance will not help you. (Final update) after spending almost a month trying to get help with issue I actually got a live text chat with customer service who was able to have a conversation with me rather than have several different people email me back at sporadic intervals. This agent was very helpful. That being said the overall customer service is still mostly garbage especially when considering that when using this time is money and the only one getting screw is use the user. Developer Response , First and foremost, we’d like to apologize for the lack of support our team has provided you. It you have any other outstanding issues, please provide us with your support ticket number at your earliest convenience, and our team will ensure your issue is prioritized. Thank you so much for your continued patience. CoryW2001 , 06/22/2022 Works for basics This app has the basics like placing market, limit, and stop limit orders. It also allows you to use a few indicators but nothing more. You cannot edit the indicators or add multiple types. This is a pain since you cannot edit what moving averages one might use or how many, you are limited to three specific ones. You cannot even draw lines. I also noticed that there is no OCO order option available like there is on the website. For Binance being what it is, you wouldn’t think they would have such a basic app for advanced users. Give us more features like the desktop version (the TradingView version). I shouldn’t have to form a new trading strategy based on limited features because I am using the mobile app instead of the website. Oh yeah, it is also slow when trying to navigate through the app. I bought KNC with USDT and it ran up 10% in a few minutes but my account didn’t move much. This is because my money was USD not USDT. After I noticed this, I bought it in USD and sold my USDT. A few minutes later after it ran up more I checked my account and it was down. I looked at the orders and noticed that it all sold as USDT. What the heck Binance??? If it is USD sell it as freaking USD. If I can’t buy with both combined, I shouldn’t be able to sell them either. Nothing like paying fees for an order you never created. Shameful! Developer Response , We appreciate your honest feedback and apologize for any inconveniences we may have caused. Your feedback has been escalated to the appropriate department and we will investigate your issue. Leodasbarns , 04/14/2022 Insane amount of documents required I have just found out that this exchange/wallet requires an insane amount of documentation to be able to withdraw, trade or transfer anything that’s been deposited into this platform and I’m upset because I do t have all the documentation that’s required due to the fact that I no longer live at my address on my is required for verification I don’t have a social security card at the moment and I’m having many issues obtaining any type of usable documentation for address verification because everything I’ve submitted I mean everything including items which they inFormed me would be acceptable we’re all rejected so just saying buyer beware there customer service is a total joke they only email you and if you submit more that one email they delete your most recent inquiries and link them all together under one ticket it’s not fair because I’ve lost some money because I wasn’t warned about this issue and now I’ve lost a bit of money because nothing/nobody notified me that you can deposit but not withdraw so like I said beware don’t deposit anything until your totally verified or you may be I. The same boat as me made several deposits and not able to do anything with them !!!!!!!! Bull crap I was under the impression that this service was worth the hype but it seems they just scammed me out of my deposits Developer Response , First and foremost, we’d like to apologize for the lack of support our team has provided you related to your verification process. Also, we’re sorry that you’re experiencing issues withdrawing. At your earliest convenience, please provide us with your support ticket number and our team will ensure your issue is prioritized. Thank you so much for your continued patience. App Privacy The developer, BAM Trading Services, Inc., indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy. Data Used to Track You The following data may be used to track you across apps and websites owned by other companies: Identifiers Usage Data Data Linked to You The following data may be collected and linked to your identity: Purchases Financial Info Contact Info Identifiers Usage Data Sensitive Info Diagnostics Other Data Privacy practices may vary, for example, based on the features you use or your age. Learn More Information Seller BAM TECHNOLOGY SERVICES INC Size 285.1 MB Category Finance Compatibility iPhone Requires iOS 14.0 or later. iPod touch Requires iOS 14.0 or later. Mac Requires macOS 11.0 or later and a Mac with Apple M1 chip or later. Apple Watch Requires watchOS 7.0 or later. Apple Vision Requires visionOS 1.0 or later. Languages English Age Rating 4+ Copyright © 2019-2023 Binance.US. All rights reserved. Price Free Developer Website App Support Privacy Policy Developer Website App Support Privacy Policy Supports Wallet Get all of your passes, tickets, cards, and more in one place. You Might Also Like Kraken Pro: Crypto Trading Finance SafeMoon Finance BitMart: Trade BTC, ETH, DOGE Finance Gemini: Buy Bitcoin & Crypto Finance Crypto.com l DeFi Wallet Finance Kraken - Buy Crypto & Bitcoin Finance More ways to shop: Find an Apple Store or other retailer near you. Or call 1-800-MY-APPLE. Choose your country or region Copyright © 2023 Apple Inc. All rights reserved. Privacy Policy Terms of Use Sales and Refunds Legal Site Map binance app_Binance国内苹果如何安装v2.45.1 - 币圈之家 首页 财经 区块链 行情数据 币圈百科 元宇宙 web3.0 比特币 币圈资讯 主页 > 行情数据 binance app_Binance国内苹果如何安装v2.45.1 作者：鸟叔 • 更新时间：2023-10-03 欧易（OKX）交易所 - 全球顶尖数字货币交易平台 注册立即
领取价值高达 6,0000 元的数字货币盲盒，邀请码：vip1234，享受
20%手续费减免。
欧易注册 APP下载 摘要
Binance是全球最大的加密货币交易所之一，在美国、欧洲、澳大利亚等多个国家和地区都拥有分支机构。而Binance官方移动应用程序也广受欢迎，可以方便地在手机上进行交易。然而，在国内苹果手机上安装Binance却存在一定的困难，本文将介绍如何安装Binance V2.45.1版本的方法。
第一步：在App Store下载信任企业证书
由于Binance App在国内无法在App Store上架，因此我们需要下载并安装信任企业证书才能让应用程序在手机上正常运行。
1.打开手机Safari浏览器，在地址栏中输入https://www.pgyer.com/，然后进入该网站；
2.在网站中找到“企业版”选项，然后选择Binance App的版本，比如V2.45.1的版本，下载并安装；
3.在安装之前，系统可能会要求您安装信任企业证书，此时您只需按照提示点击“安装”即可。
第二步：设置Binance App的信任权限
1.在安装完成后，打开设置——>通用——>设备管理，然后找到相应的卡片；
2.点击进入后，选择“该应用程序”或“来自XXX的应用程序”，然后将其信任权限设为“信任”。
第三步：开始使用Binance App进行交易
完成上述两个步骤后，Binance App就可以在您的手机上正常运行，并且您可以进入该应用程序进行交易。
小结
随着加密货币交易的火热，Binance App成为越来越多人交易的首选工具，但在国内使用却存在一些困难，需要进行一系列操作才能实现安装和正常运行。通过本文的分享，相信大家可以顺利安装Binance App并使用，如果您需要进行加密货币交易，安装Binance App是一个很好的选择。
如何在国内苹果手机上安装Binance v2.45.1 摘要: 本篇文章主要介绍如何在国内苹果手机上安装Binance v2.45.1的方法和步骤。对于没有科学上网或者不想越狱的用户，本文提供一种解决方案。 一、背景介绍 Binance是全球最大的加密货币交易所之一，不仅拥有丰富的币种资源，交易价格也更加具有竞争力。Binance在2017年成立，总部位于马耳他，拥有全球性的用户群体。 然而，由于政策等因素，在中国大陆地区无法下载Binance App。在此情况下，许多用户需要使用一些技巧才能够在苹果手机上安装Binance App。 二、准备工具 首先，我们需要安装一个名为“PP助手”的第三方应用商店。PP助手是一款国内知名的iOS应用商店，可以提供一些苹果手机上无法下载的应用。用户可以通过访问PP助手官网，下载iOS版的PP助手。具体安装过程这里不再赘述。 三、下载Binance App 下载PP助手成功之后，我们就可以开始下载Binance App。 1.打开PP助手应用商店，并登录账号。 2.搜索“Binance”应用，找到Binance App下载链接。 3.下载Binance App并安装。这个过程比较顺畅，跟App Store下载一样，需要输入Apple账号密码，再等待下载和安装完成。 四、Binance App使用 Binance App的使用界面比较简洁明了，不仅提供各种行情走势图、K线图、深度图等，还支持多币种交易以及提现操作等。在此不再细讲。 五、注意事项 1.虽然PP助手是一个可靠的第三方应用商店，但实际上，这样的商店存在一定的安全隐患，用户需要注意保护好自己的账号信息和隐私安全。 2.用户下载安装的Binance App并非来自于苹果官方，所以使用此应用存在一定的风险。应当在自己进行操作时，谨慎对待自己的资金和个人信息。 六、总结 通过以上步骤，我们可以很容易地在国内苹果手机上安装Binance App。然而，在进行此操作之前，用户应当保持警醒和小心谨慎，将个人信息保护好。 为了更好地使用Binance App，推荐用户通过科学上网等方式直接下载App Store版本。如果购买搭建VPN等服务，需要权衡投资成本和使用效果。最终，希望各位用户购买或使用Binance App时，不要盲目跟风，保护好自己的信息和资金安全。 本文来自网络，不代表币圈之家立场，如有侵权请联系我们删除，转载请注明出处：https://www.110btc.com/hangqing/124258.html 任贤齐的老婆 温柔到爆的神仙句子英文 小儿垂钓古诗拼音 ok欧易手机版下载V6.1.32 ok手机上的交易所app « 上一篇 btc刚出来时候多少1枚 – btc总量多少枚 下一篇 » 相关推荐 热门文章 kar币怎么样 2023年10月02日 ok掌上钱包极速提现安卓端正版安装包地址 2023年10月03日 btc刚出来时候多少1枚 – btc总量 2023年10月03日 推荐文章 经典文章 kar币怎么样 2023年10月02日 ok掌上钱包极速提现安卓端正版安装包地址 2023年10月03日 btc刚出来时候多少1枚 – btc总量 2023年10月03日 ok欧易手机版下载V6.1.32 ok手 2023年10月02日 ok交易所官方app ok交易appv6 2023年10月03日 LTC值得投资吗（ltc有什么价值） 2023年10月03日 FTX 债权人：FTX 或被追讨 25 2023年10月03日 binance app_Binance国 2023年10月03日 Beosin：UVT项目被黑客攻击事件简 2023年10月02日 ok网交易平台不可以下载了吗_虚拟币平台 2023年10月02日 热门标签 水表偷水最简单的技巧 银行卡太久没用被冻结了怎么办 网上通缉怎么查询 加密 氨基酸洗面奶十大黑名单 抖音什么时候成立的 监管 周冲人物形象分析 英雄联盟代练价格表图 白居易最著名的十首诗 欧易正规平台注册下载 特朗普年龄 初学者怎么制作平面图 佳物分期 1个eth值多少人民币 公认玄幻小说排行榜 欧易okex官方高速下载 今年是公元哪一年 信用卡限制消费怎么解除 欧易app注册下载网站 没打马赛克的科比遗骨图 秋天景色古诗25首 商品评价 山西忻州怎么读 新四板 a1699是苹果什么型号 炒币合法的吗 btc投资交易所欧易app官方下载 康乐县属于哪个市 科目二考完多久可以预约科目三 首页 财经 区块链 行情数据 币圈百科 比特币 币圈资讯 Copyright © 2018-2023 110btc.com 币圈之家 版权所有 网站备案号：渝ICP备2020014681号 联系我们 在线咨询： 微信号：AB100082 工作日：9:30-18:30，节假日休息 欧易APP 币安注册 欧易注册 微信咨询 x 打开微信搜索下面的ID AB100082 长按微信号复制，添加好友 币安binance交易所手机APP下载及使用教程 - 币界网 风险提示：理性看待区块链，提高风险意识！ 首页 行情 币种 平台 文章 比特币 区块链 Web3 以太坊 NFT 元宇宙 快讯 专题 专栏 问答 百科 下载 个人主页 发布作品 退出登录 iOS版下载
安卓版下载
扫码下载币界网APP 欢迎来到币界网 +86 获取验证码
注册/登录
币安binance交易所手机APP下载及使用教程 首页 > 币界资讯 > 区块链知识 2019-05-17 18:03:17 币安(Binance)于2017年7月14日正式上线，两位创始人赵长鹏(加拿大籍华人)和何一同为原OK
Coin(OKEx前身)的创始人。和另两家中国血统的老牌交易所OKEx及Huobi不同，币安从一开始就将主业放在海外市场。在币安仅仅上线两个月后，由于大量加密货币项目隐含的高投资风险、高道德风险和低社会效益，中国人民银行联合六部委叫停各类代币发行融资，并随后宣布关停国内所有的数字货币交易所。一时间，中国本土的交易所纷纷断臂求生。在这轮市场调整中，币安迅速地侵蚀了其他交易所已有的市场份额，并逐渐发展成了世界上最大的加密货币交易所。币安注册地址：https://www.binance.co/币安APP最新下载链接：Android下载地址：https://ftp.binance.co/pack/Binance.apk苹果 APP(企业版)下载地址：www.binance.co/iosapp-beta.html注：1. 原先苹果应用商店下载的app可以继续使用。2. 企业版请复制地址到Safair浏览器打开，安装完毕后，打开设置-通用-设备管理，点击信任证书，即可使用。3. 注意，请勿下载任何非【管理员、币安天使】提供的下载地址。币安交易所APP使用教程：一、客户端下载：1、登录币安网官方网站，www.binance.com，值得注意的是 就去加速
的插件无法打开币安网，需要通过蓝灯才能打开。(这里不推荐小白玩家使用，操作困难)2、苹果手机无法在苹果商店里下载，只能通过谷歌商店进行下载。3、点击“Android”，进行下载，由于币安没有提供扫面二维码下载，只能先将APP下载到电脑中，再通过QQ、微信等方式发送到手机上。(如果无法打开网页，可以换一个浏览器试试)4、通过QQ将币安APP从电脑发到手机上，点开下载5、安装好后，在桌面上找到币安APP二、注册实名认证以安卓手机为例，苹果手机相仿。(一)、注册1、打开币安网手机APP，点击下方的“我的”，进入我的页面，点击“登录或注册”2、依次填入邮箱、密码，推荐人ID可不填，点“√”同意服务协议，最后点击注册3、去注册的邮箱中找到币安的邮件，找到验证码，并填到下图所示位置，填好后即完成注册。(二)、实名认证1、打开币安APP输入邮箱密码，登录后，点击“我的”，找到“身份认证”，点开。2、可以看到如下页面，实名认证需要去，电脑端操作，进入币安官网，点击登录3、登录的过程中，因为注册是在手机APP注册的，在网页上登录，需要“授权”，点开注册邮箱，找到币安的授权新设备邮件，点开，4、出现下图所示，即授权成功，可以登录币安官网了，需要注意的是，下次登录需要使用同一个浏览器登录，否则需要重新授权。5、登录币安官网后，首先提示需要开启二次验证，绑定手机或者谷歌验证。6、绑定手机过程中，要注意前面，选择中国，不然填写的手机号，会提示手机号错误。7、验证完手机后，点击官网首页，右上角的“小人头像”，再点击用户中心8、在下图所示为止，点击前往认证9、选择个人认证10、填好名字等信息后，点击“开始验证”11、点击“开始验证”12、国家选择“中国”，在“护照”、“身份证”和“驾驶证”中选择适合自己的验证方式。13、根据网页提示，提交照片信息，即可完成，等待审核即可。今天的课程就到这里了，你学会了吗? 上一篇： Binance币安交易所PC端使用教程 下一篇： cnn是什么币？2019年cnn币前景怎么样？cnn币有落地项目吗？ 推荐专栏 币圈唐僧
web3首席知识博主 关注 叶少投资笔记pro版
一位相信价值投资的币圈KOL。稳定盈利的缠论野生交易员 #BTC行情分析师 #价值投资 #链上数据分析 关注 Web3大漂亮
爱Web 3，爱生活，爱科技，爱炒币的老韭菜 关注 热门币种 更多 币种 价格 24H涨跌幅 Bitcoin BTC比特币 ¥265,385.78 37,183.98 USDT +0.44% Ethereum ETH以太坊 ¥14,450.05 2,024.64 USDT +0.17% Tether USDt USDT泰达币 ¥7.20 1.01 USDT -0.03% BNB BNB币安币 ¥1,632.68 228.76 USDT +1.48% Binance-Peg XRP XRP瑞波币 ¥4.32 0.60570 USDT +0.51% USDC USDC ¥7.14 1.00 USDT +0.03% Wrapped Solana SOLSolana ¥400.46 56.11 USDT +1.29% OKB OKBOK币 ¥399.62 55.99 USDT -0.01% Binance-Peg Cardano ADA艾达币 ¥2.69 0.37700 USDT -0.89% Dogecoin DOGE狗狗币 ¥0.55410 0.07765 USDT -0.98% 热搜币种 更多 币种 价格 24H涨跌幅 LUNC Terra Classic ¥0.00 9.585E-5 USDT -18.53% GALA Gala ¥0.00 0.02573 USDT -4.37% DYDX dYdX ¥22.68 3.2068 USDT -0.62% BTS 比特股 ¥0.05 0.006495 USDT -3.38% CAKE PancakeSwap ¥15.71 2.2207 USDT -1.33% FIL Filecoin ¥31.66 4.4749 USDT -0.34% FTT FTX Token ¥29.36 4.15 USDT +15.67% CFX Conflux ¥1.09 0.1538 USDT -2.41% YGG Yield Guild Games ¥2.57 0.3627 USDT -0.41% SHIB Shiba Inu ¥0.00 8.17E-6 USDT -2.27% BTC 比特币 ¥263,037.62 37183.98 USDT +0.44% BTM 比原链 ¥0.07 0.01001 USDT -4.95% 最新快讯
更多 汇款公司Kalyssi旗下钱包已集成AlchemyPay法币出入金解决方案 2023-11-28 19:26:47 PlanB：比特币可能不会再低于3.5万美元 2023-11-28 19:23:01 摩根大通和Apollo计划推出代币化“企业主网” 2023-11-28 19:14:28 汇丰、恒生、渣打、富邦华一四家外资银行入围首批“数字人民币”业务试点名单 2023-11-28 19:06:57 OKX上线MATIC链上赚币产品 2023-11-28 19:06:21 摩根大通和Apollo计划建立代币化“企业主网” 2023-11-28 19:03:57 Nansen2公测版本上线，新增链上数据异动、智能搜索等功能 2023-11-28 18:59:52 下载币界网APP
App Store
Android
免责声明：本网站、超链接、相关应用程序、论坛、博客等媒体账户以及其他平台和用户发布的所有内容均来源于第三方平台及平台用户。币界网对于网站及其内容不作任何类型的保证，网站所有区块链相关数据以及其他内容资料仅供用户学习及研究之用，不构成任何投资、法律等其他领域的建议和依据。币界网用户以及其他第三方平台在本网站发布的任何内容均由其个人负责，与币界网无关。币界网不对任何因使用本网站信息而导致的任何损失负责。您需谨慎使用相关数据及内容，并自行承担所带来的一切风险。强烈建议您独自对内容进行研究、审查、分析和验证。 关于我们 联系我们 加入我们 项目收录 交易所收录 免责声明 Copyright © 2017-2021[深之诺网络] 上海深之诺网络科技服务中心 沪ICP备2021015434号-3 友情链接：
比特币价格｜
以太坊价格｜
OKB币价格｜
BNB币价格｜
CAKE币价格｜
BGB币价格｜
FTT币价格｜
�Binance.US: Buy Bitcoin & ETH on the App Store
binance app_Binance国内苹果如何安装v2.45.1 - 币圈之家
币安binance交易所手机APP下载及使用教程 - 币界网