签名算法说明

1、设所有发送参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串A。

2、在A最后拼接上key得到B字符串,并对B进行HMAC-SHA256运算,再将得到的字符串所有字符转换为大写,得到sign值。

接口定义

1. 用户账户

1.1 获取账户信息

请求URL:https://api.otc.bi/user/readAccounts

请求方式:get body

请求报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
key 官网申请api时获取 String
timeStamp 时间戳 String

从1970年1月1日

00:00:00至今的秒数

nonceStr 随机字符串 String
sign 签名字符串 String

响应报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
resultCode 结果编码 String 6

success为成功

其余查看附录

resultDesc 结果描述 String
resultData 结果附带数据 Json对象数组 返回的账户信息

resultData 格式说明:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
coinCode 币种编码 String 56

BTC:比特币 ETH:以太坊

EOS:EOS OTC:OTCoin

address 钱包地址 String 256
balance 账户余额 Decimal (50,20)
freezeBlance 冻结余额 Decimal (50,20)

2. 订单

2.1 查询广告列表

获取目前广告信息,分页查询,每页显示10条记录

请求URL:https://api.otc.bi/advertise/list

请求方式:get body

请求报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
key 官网申请api时获取 String
timeStamp 时间戳 String

从1970年1月1日

00:00:00至今的秒数

nonceStr 随机字符串 String
type 区分买入/卖出广告 String

buy:买入

sell:卖出

coinCode 币种编码 String

BTC:比特币

ETH:以太坊

EOS:EOS

pageNum 页码 int 从1开始
sign 签名字符串 String 见签名算法说明

响应报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
resultCode 结果编码 String 6

success为成功

其余查看附录

resultDesc 结果描述 String
resultData 结果附带数据 Json对象数组 返回用户发布的广告列表

resultData 格式说明:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
id 广告标识 long
coinCode 币种编码 String
coinPrice 出售币价 Decimal (50,20) CNY计算
minLimit 最小限额 Decimal (50,20)
maxLimit 最大限额 Decimal (50,20)
payType 支付方式 String
createTime 创建时间 datetime

2.2 发布广告

请求URL:https://api.otc.bi/advertise/list

请求方式:post body

请求报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
key 官网申请api时获取 String
timeStamp 时间戳 String

从1970年1月1日

00:00:00至今的秒数

nonceStr 随机字符串 String
type 发布买入/卖出广告 String

buy:买入

sell:卖出

coinCode 币种编码 String

BTC:比特币

ETH:以太坊

EOS:EOS

payType 支付方式 String
minLimit 最小数量限额 String
maxLimit 最大数量限额 String
acceptPrice 可接受最高或最低价 String
exchange 价格对标的交易所 Sring
priceRate 交易所浮动价格比例 String
sign 签名字符串 String 见签名算法说明

响应报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
resultCode 结果编码 String 6

success为成功

其余查看附录

resultDesc 结果描述 String
resultData 结果附带数据 Json对象 返回创建的广告信息

resultData 格式说明:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
id 广告标识 long
coinCode 币种编码 String
coinPrice 出售币价 Decimal (50,20) CNY计算
minLimit 最小限额 Decimal (50,20)
maxLimit 最大限额 Decimal (50,20)
payType 支付方式 String
createTime 创建时间 datetime

2.3 创建订单

前置条件:无

请求URL:https://api.otc.bi/order/generate

请求方式:post body

请求报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
key 官网申请api时获取 String
timeStamp 时间戳 String

从1970年1月1日

00:00:00至今的秒数

nonceStr 随机字符串 String
adId 广告id long
coinCount 买入/卖出数量 String
payType 支付方式 String

买入订单必填

卖出订单可为空

sign 签名字符串 String 见签名算法说明

响应报文:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
resultCode 结果编码 String 6

success为成功

其余查看附录

resultDesc 结果描述 String
resultData 结果附带数据

resultData 格式说明:

参数代码 参数名称 参数类型 参数(最大)长度 可空 说明
code 订单编码 String 128
adId 广告id long
coinCode 币种编码 String
coinPriceCurrency 兑换法币价格 decimal (15,4) CNY计价
coinCount 购买/卖出的货币数量 decimal (50,20)
amount 法币计算订单金额 decimal (15,4)
type 订单类型 String

buy:买单

sell:卖单

serviceFeeCount 服务费 decimal (50,20)
status 状态 String

10:待支付

20:已付款

30:已确认收款

100:已取消

附录

1、结果返回对应表 resultCode

1.1公共板块

编码 说明
success 成功
000000 失败
客服服务热线

852-3962-2431‬

客服服务时间

9:00 ~ 22:30 (UTC+08:00)

关于我们
相关资源