English 简体中文 English 한국어 日本語 Pусский Español Français Deutsch Português Login Register
API Document (API文档)

NOTICE(注意事项)

  • 1. URL (API链接): https://api.btex.com/
  • 2. Websocket URL: wss.btex.com
  • 3. Dwonload SDK (Java、Node.js、PHP、Python): Download URL(点击下载SDK)
  • 4. Request Limited (限速): 交易API每小时10000次,每秒最多10次.
  • 5. Min Trade Amount (最小委托量): 查看
  • 6. Apply API Keys (申请公私钥): Address(地址)

Public API(公开数据API)

  • 1. Get All Pairs Tickers(获取所有市场)     /openapi1/pairs
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    return_format 返回数据类型,值: 1,对象类型数据;2,数组类型数据;默认为1,可选参数
  • 2. Get Single Pair Tickers(获取单个市场)    /openapi1/pair?pair=ETH_USDT
    Demo
    # Request
    GET https://api.btex.com/openapi1/pair?pair=ETH_USDT
    # Response
    	            					
    返回值说明
    pair : 交易市场
    	            					
    请求参数说明
    参数名 描述
    pair 交易市场。    格式:ETH_USDT
    return_format 返回数据类型,值: 1,对象类型数据;2,数组类型数据;默认为1,可选参数
  • 3. KLine data (K线)    /openapi1/k_data/?pair=ETH_USDT&k_type=5m&rand_key=32320339
    返回值说明
    {
    	"code": 1,
    	"info": "ok",
    	"data": [
    		[1534220100000, 269.75, 269.75, 268.89, 268.89, 0.0336, 9.034704]
    	]
    }
    #从左至右,依次为时间戳(毫秒),开盘价,最高价,最低价,收盘价,成交量,成交额。
    	            					
    请求参数说明
    参数名 描述
    pair 交易市场。    格式:ETH_USDT
    k_type 5m,15m,30m,1h,2h,4h,8h,1d; m:分钟,h:小时,d:天数
    k_amount 可选,获取数据的条数,默认最新80条
    rand_key 10000000 - 100000000之间的随机数
  • 4. Invite Dig Reward (邀请挖矿奖励比例等信息)【New】    /openapi1/get_dig_configs
    Demo
    # Request
    GET https://api.btex.com/openapi1/get_dig_configs
    # Response
    	            					
    返回值说明
    {
    	"code": 1,
    		"info": "ok",
    		"data": {
    		"invite_dig_reward": "0.1", //当前邀请挖矿奖励比例
    		"expect_dig_total": "10000.00000000",	//期望本小时挖矿的数量,单位USDT
    		"current_dig_total": "1000.00000000", //当前实际挖矿数量,单位USDT
    		"current_dig_percent": "0.10000" //已挖矿比例,0.1表示10%,1表示100%份额已经挖完
    	}
    }	 
    	            					
    请求参数说明
    参数名 描述

Trade API(交易相关API)

  • 1. Get OrderBook(获取委托列表)    /openapi1/orderbook?pair=ETH_USDT&depth=15
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    pair 交易市场。    格式:ETH_USDT
    depth 委托档数,默认10条。    值:5,10,15,20,30
  • 2. Get Trade History(获取市场成交历史)    /openapi1/trades?pair=ETH_USDT
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    pair 交易市场。    格式:BTC_USDT
    depth 委托档数,默认10条。    值:5,10,15,20,30
  • 3. Get My Info(获取我的余额信息)    /openapi1/auth_api [需要签名]
    DEMO
    # Request
    POST https://api.btex.com/openapi1/auth_api
    # Response
    	            					
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    method 请求类型,值:getinfo
    access_key 公钥,用户申请即可
    sign 签名,把参数(排除sign)按照ksort()进行排序签名;
    如:$sign = md5('access_key=xxx&method=xxx&secret_key=你的私钥')
  • 4. Buy & Sell (限价委托买入、卖出)    /openapi1/auth_api [需要签名]
    DEMO
    # Request
    POST https://api.btex.com/openapi1/auth_api
    # Response
                					
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    method 请求类型,值:buy_coin (买币) / sell_coin (卖币)
    price 下单价格
    num 下单数量
    pair 市场,格式:BTC_USDT
    access_key 公钥,用户申请即可
    sign 签名,把参数(排除sign)按照ksort()进行排序签名;
    如:$sign = md5('access_key=xxx&method=xxx&num=xxx&pair=xxx&price=xxx&secret_key=你的私钥')
  • 5. Get My Order(获取我的委托列表)    /openapi1/auth_api [需要签名]
    DEMO
    # Request
    POST https://api.btex.com/openapi1/auth_api
    # Response
                					
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    method 请求类型,值:myorders
    pair 市场,格式:BTC_USDT
    amount 获取数据量,如:50
    access_key 公钥,用户申请即可
    sign 签名,把参数(排除sign)按照ksort()进行排序签名;
    如:$sign = md5('access_key=xxx&amount=xxx&method=xxx&pair=xxx&secret_key=你的私钥')
  • 6. Cancel My Order(取消委托)    /openapi1/auth_api [需要签名]
    DEMO
    # Request
    POST https://api.btex.com/openapi1/auth_api
    # Response
                					
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    method 请求类型,值:cancel_order
    order_id 订单id
    access_key 公钥,用户申请即可
    sign 签名,把参数(排除sign)按照ksort()进行排序签名;
    如:$sign = md5('access_key=xxx&method=xxx&order_id=xxx&secret_key=你的私钥')
  • 7. My Trade History(我的成交历史)    /openapi1/auth_api [需要签名]
    DEMO
    # Request
    POST https://api.btex.com/openapi1/auth_api
    # Response
                					
    返回值说明
    	            					
    请求参数说明
    参数名 描述
    method 请求类型,值:mytrades
    pair 市场代码,比如ETH_USDT
    page 页码,默认1
    page_size 单页多少,默认20
    access_key 公钥,用户申请即可
    sign 签名,把参数(排除sign)按照ksort()进行排序签名;
    如:$sign = md5('access_key=xxx&method=xxx&order_id=xxx&secret_key=你的私钥')

Signature Method(签名算法)  

	//1.签名算法,对所有的参数按a-z的顺序排序后,排列成access_key=xxx&method=cancel_order&order_id=12345&secret_key=xxxx的方式进行MD5签名,
	//2.签名后的值为32位小写字母,然后把签名带到POST参数中传递。

	//以下是PHP的demo

	//get my balance and other basic info (获取我的账户余额)
	function getinfo(){
			$tParams = array();
			$tParams['method'] = 'getinfo'; //这个很重要,就是调用的函数
			$tParams['access_key'] = $this->access_key;
			$tParams['created'] = time();
																				            
			$tParams['sign'] = $this->createSign($tParams); //计算签名,签名函数在下面
			$tResult = $this->httpRequest(AUTH_API_URL, $tParams); //AUTH_API_URL 是https://api.btex.com/openapi1/auth_api
			return json_decode($tResult,1);
	}
	function createSign($pParams = array()){
		$pParams['secret_key'] = $this->secret_key; 
		ksort($pParams); //把所有的参数按a-z排序
		$tPreSign = http_build_query($pParams); //生成access_key=xxx&method=cancel_order&order_id=12345&secret_key=xxxx字符串
		$tSign = md5($tPreSign); //md5签名
		return strtolower($tSign);
	}	
						

Erro Code(交易API错误码)  

codeDescription
1success(正数是成功,负数是失败)
0fail
-1fail
-2can not find user info
-3sign error
-4user_id error
-5market not exists
-6total must larger than 0.0001
-7price must larger than 0.00000001
-8trade amount too small
-9operation too fast
-10balance not enough
-11account have been locked
-12order_id error
-13invalide access_key
-14market has been closed
-20require email confirm
-21account locked
-22request too fast, Trade API or trade API are limited to 5 requests per second
-23Destination Tags error
-100method not exists
-101IP limited
-102the public key and private key is out of date
-103Trade API and Wallet API temporarily closed
  • 简体中文
  • English
  • 한국어
  • 日本語
  • Pусский
  • Español
  • Français
  • Deutsch
  • Português
OK
Mobile