Pbinance已停止维护，功能已整合在Binance_interface中：

GITHUB：https://github.com/pyted/binance_interface

pbinance 说明文档 v1.0.11

1 pbinance设计目的

pbinance是完全基于Python语言对Binance交易所REST API接口的封装，包括：现货、U本位合约、币本位合约、欧式期权等功能。

本来想起名叫binance_api，但是这个名字被其他人已经申请了，就随手起名叫pbiance了

之所以花了花几天的时间去写一个Binance交易所的底层Python SDK，有这么几点原因：

• 官方推荐的Python SDK目前主要支持SPOT现货交易
• GITHUB很多的开源框架是对官方API的高级封装，而非底层
• 量化交易有太多的框架，但是各个框架的函数名称调用方式等各不相同，这对于立足多平台的量化交易者有较大的学习成本，而且我个人对于非官方开源的SDK的安全性总抱有一个怀疑的态度（虽然他们写的也很好），也见过很多的的优秀项目停更，所以开发了一套量化交易的生态架构，由于各个交易所底层支持的接口类型和内容大多不相同，如果一个框架一个函数可以支持多个平台难免不能做到交易功能的精细化，但是我尽量让各个交易框架的结构相似、调用相似，这样可以极大的降低学习成本，例如如果你学会了binance_candle，仅需要几分钟的时间就可以上手okx_candle。

2 下载pbinance

pip install pbinance

3 pbinance的例子

获取现货交易的挂单信息

from pbinance import Binance
from pprint import pprint

if __name__ == '__main__':
    # 实例化Binance
    # 如果仅获取行情信息不需要key和secret，与账户交易相关的功能需要填写key和secret
    binance = Binance(
        key='****',
        secret='****',
    )
    # spot表示现货 get_ticker_bookTicker获取最优挂单价格
    result = binance.spot.market.get_ticker_bookTicker(
        symbol='BTCUSDT'
    )
    pprint(result)

输出：

>> {'code': 200,
>>  'data': {'askPrice': '22886.87000000',
>>           'askQty': '0.05096000',
>>           'bidPrice': '22886.61000000',
>>           'bidQty': '0.00045000',
>>           'symbol': 'BTCUSDT'},
>>  'msg': ''}

限价单：以2美元的价格购买5个DOTUSDT

from pbinance import Binance
from pprint import pprint

if __name__ == '__main__':
    # 账户与交易功能必须填写key和secret
    binance = Binance(
        key='****',
        secret='****'

    )
    result = binance.spot.accountTrade.set_order(
        symbol='DOTUSDT',  # 产品名称
        side='BUY',  # 订单方向
        type='LIMIT',  # 订单类型
        price='2',  # 价格
        quantity='5',  # 数量
        timeInForce='GTC',  # 订单的有效方式
    )
    pprint(result)

>> {'code': 200,
>>  'data': {'clientOrderId': 'L8lQeRd15657si2u2zg1v6',
>>           'cummulativeQuoteQty': '0.00000000',
>>           'executedQty': '0.00000000',
>>           'fills': [],
>>           'orderId': 3258603953,
>>           'orderListId': -1,
>>           'origQty': '5.00000000',
>>           'price': '2.00000000',
>>           'selfTradePreventionMode': 'NONE',
>>           'side': 'BUY',
>>           'status': 'NEW',
>>           'symbol': 'DOTUSDT',
>>           'timeInForce': 'GTC',
>>           'transactTime': 1675654749477,
>>           'type': 'LIMIT',
>>           'workingTime': 1675654749477},
>>  'msg': ''}

关于请求的说明请参考Binance官方文档，或者使用PyTed开源的高级交易架构，可以省去繁琐的官方参数查阅。

4 pbinane的说明

请求参数名与官方一致，返回结果均采用字典类型：

• {'code':<状态码:int>,'data':<主体数据:object>,'msg':<提示信息:str>}

状态码200表示成功，官方原始的返回结果类型有差异，有的时候仅仅是主体数据内容，有的时候是包括状态码的字典，pbinance对官方的不规整结果做了优化，统一格式字典类型。

pbinance在遇到这些状态码时，会自动延时重试多次，避免由于单次网络问题丢失请求：

• -1001 DISCONNECTED
• -1003 TOO_MANY_REQUESTS
• -1004 SERVER_BUSY
• -1007 TIMEOUT
• -1008 SERVER_BUSY
• -1016 SERVICE_SHUTTING_DOWN

5 现货模块 SPOT

5.1 接口总览

5.1.1 账户与交易 AccountTrade

5.1.2 行情信息 Market

5.1.3 统一账户 PortfolioMargin

5.1.4 钱包接口 Wallet

5.2 例子

获取BTCUSDT的最新成交价

from pbinance import Binance, SPOT
from pprint import pprint

if __name__ == '__main__':
    # 实例化现货模块
    spot = SPOT(key='****', secret='****')  # 等同于：spot = Binance( key='****', secret='****').spot
    # 获取BTCUSDT的最新成交价
    result = spot.market.get_ticker_price(
        symbol='BTCUSDT'
    )
    pprint(result)

输出：

>> {'code': 200,
>>  'data': {'price': '22902.27000000', 'symbol': 'BTCUSDT'},
>>  'msg': ''}

6 U本位合约模块 UM

6.1 接口总览

6.1.1 账户与交易 AccountTrade

6.1.2 行情信息 Market

6.1.3 统一账户 PortfolioMargin

6.2 例子

查询U本位合约持仓模式

from pbinance import Binance, UM
from pprint import pprint

if __name__ == '__main__':
    # 实例化UM模块
    um = UM(key='****', secret='****')  # 等同于：um = Binance( key='****', secret='****').um
    # 查询持仓模式
    result = um.accountTrade.get_positionSide_dual()
    pprint(result)

输出：

>> {'code': 200, 'data': {'dualSidePosition': True}, 'msg': ''}

7 币本位合约模块 CM

7.1 接口总览

7.1.1 账户与交易 AccountTrade

7.1.2 行情信息 Market

7.1.3 统一账户 PortfolioMargin

7.2 例子

查询全部当前挂单

from pbinance import Binance, CM
from pprint import pprint

if __name__ == '__main__':
    # 实例化CM模块
    cm = CM(key='****', secret='****')  # 等同于：cm = Binance( key='****', secret='****').cm
    # 查询全部当前挂单
    result = cm.accountTrade.get_openOrders()
    pprint(result)

输出：

>> {'code': 200, 'data': [], 'msg': ''}

8 欧式期权 EO

8.1 接口总览

8.1.1 账户与交易 AccountTrade

8.1.2 行情信息 Market

8.1.3 市商 MarketMaker

8.2 例子

获取交易规则和交易对

from pbinance import Binance, EO
from pprint import pprint

if __name__ == '__main__':
    # 实例化EO模块
    eo = EO(key='****', secret='****')  # 等同于：eo = Binance( key='****', secret='****').eo
    # 获取交易规则和交易对
    result = eo.market.get_exchangeInfo()
    pprint(result)

输出：

>> {'code': 200,
>>  'data': {'optionAssets': [{'id': 1, 'name': 'USDT'}],
>>           'optionContracts': [{'baseAsset': 'SOL',
>>                                'id': 1,
>>                                'quoteAsset': 'USDT',
>>                                'settleAsset': 'USDT',
>>                                'underlying': 'SOLUSDT'},
>>                               {'baseAsset': 'BTC',
>>                                'id': 2,
>>                                'quoteAsset': 'USDT',
>>                                'settleAsset': 'USDT',
>>                                'underlying': 'BTCUSDT'},
>>                               {'baseAsset': 'ETH',
>>                                'id': 3,
>>                                'quoteAsset': 'USDT',
>>                                'settleAsset': 'USDT',
>>                                'underlying': 'ETHUSDT'},
>>                               {'baseAsset': 'BNB',
>>                                'id': 4,
>>                                'quoteAsset': 'USDT',
>>                                'settleAsset': 'USDT',
>>                                'underlying': 'BNBUSDT'}],
>>           'optionSymbols': [{'contractId': 3,
>>                              'expiryDate': 1677225600000,
>>                              'filters': [{'filterType': 'PRICE_FILTER',
>>                                           'maxPrice': '923.9',
>>                                           'minPrice': '728.9',
>>                                           'tickSize': '0.1'},
>>                                          {'filterType': 'LOT_SIZE',
>>                                           'maxQty': '1000',
>>                                           'minQty': '0.01',
>>                                           'stepSize': '0.01'}],
>>                              'id': 2474,
>>                              'initialMargin': '0.15000000',
>>                              'maintenanceMargin': '0.07500000',
>>                              'makerFeeRate': '0.00020000',
>>                              'maxQty': '1000',
>>                              'minInitialMargin': '0.10000000',
>>                              'minMaintenanceMargin': '0.05000000',
>>                              'minQty': '0.01',
>>                              'priceScale': 1,
>>                              'quantityScale': 2,
>>                              'quoteAsset': 'USDT',
>>                              'side': 'CALL',
>>                              'strikePrice': '800.00000000',
>>                              'symbol': 'ETH-230224-800-C',
>>                              'takerFeeRate': '0.00020000',
>>                              'underlying': 'ETHUSDT',
>>                              'unit': 1},
>>                              ... ... 
>>                             ],
>>           'rateLimits': [{'interval': 'MINUTE',
>>                           'intervalNum': 1,
>>                           'limit': 400,
>>                           'rateLimitType': 'REQUEST_WEIGHT'},
>>                          {'interval': 'MINUTE',
>>                           'intervalNum': 1,
>>                           'limit': 100,
>>                           'rateLimitType': 'ORDERS'},
>>                          {'interval': 'SECOND',
>>                           'intervalNum': 10,
>>                           'limit': 30,
>>                           'rateLimitType': 'ORDERS'}],
>>           'serverTime': 1675657383732,
>>           'timezone': 'UTC'},
>>  'msg': ''}

9 其他 Other

9.1 接口总览

9.1.1 子母账户 SubAccount

9.1.2 币安宝 Savings

9.1.3 Staking产品 Staking

9.1.4 矿池 Mining

9.1.5 合约 Future

9.1.6 合约策略交易 FuturesAlgo

9.1.7 杠杆代币 Blvt

9.1.8 币安挖矿 Bswap

9.1.9 法币 Fiat

9.1.10 C2C接口 C2c

9.1.11 VIP借币 VIPLoans

9.1.12 质押借币 CryptoLoans

9.1.13 Pay接口 Pay

9.1.14 闪兑 Convert

9.1.15 返佣 Rebate

9.1.16 NFT接口 Nft

9.1.17 币安码 GiftCard

9.2 例子

获取混合保证金调整质押率历史

from pbinance import Binance, Other
from pprint import pprint

if __name__ == '__main__':
    # 实例化other模块
    other = Other(key='****', secret='****')  # 等同于：other = Binance( key='****', secret='****').other
    # 获取混合保证金调整质押率历史

    result = other.future.get_loan_adjustCollateral_history()
    pprint(result)

输出：

>> {'code': 200, 'data': {'rows': [], 'total': 0}, 'msg': ''}