# 账户接口

# 查询资产

GET /v1/account/balance

所属模块	所属类型	资源隔离类型	速率限制
账户(ACCOUNT)	查询(QUERY)	币种(COIN)	1

# 参数

名称	类型	必填	描述
coins	Array	是	币种列表

# 响应参数

名称	类型	描述
coin	String	币种
balance	Decimal	可用余额
freeze	Decimal	冻结金额

# 请求示例

GET /v1/account/balance?coins=USDT,BTC

# 响应示例

{
	"code":"200",
	"message":"",
	"data":[{
		"coin":"USDT",
		"balance":"55.8",
		"freeze":"44.2"
	},{
		"coin":"BTC",
		"balance":"0.012",
		"freeze":"0.008"
	}]
}

# 查询划转记录

GET /v1/account/transfer/page

所属模块	所属类型	资源隔离类型	速率限制
账户(ACCOUNT)	查询(QUERY)	币种(COIN)	5

# 参数

名称	类型	必填	描述
pageIndex	Int	否	(公共)分页下标不填默认为1
pageSize	Int	否	(公共)分页大小不填默认100
coins	Array	是	币种列表
from	TransactionType	否	划出交易类型
to	TransactionType	否	划入交易类型

# 响应参数

名称	类型	描述
transactionNo	String	交易单号
coin	String	币种
amount	Decimal	划转金额
from	TransactionType	划出交易类型
to	TransactionType	划入交易类型
timestamp	Long	划转时间

# 请求示例

GET /v1/account/transfer/page?coins=USDT,BTC&pageIndex=1&pageSize=2

# 响应示例

{
	"code":"200",
	"message":"OK",
	"timestamp":"1684909359187",
	"data":{
		"total":5,
		"list":[{
			"transactionNo:"TO00000001",
			"coin":"USDT",
			"amount":"1.5",
			"from":"EXCHANGE",
			"to":"OTC",
            "timestamp":1972196932
		},{
			"transactionNo:"TO00000002",
			"coin":"BTC",
			"amount":"0.002",
			"from":"EXCHANGE",
			"to":"OTC",
            "timestamp":1972197631
		}]
	}
}

# 提交划转

POST /v1/account/transfer/submit

所属模块	所属类型	资源隔离类型	速率限制
账户(ACCOUNT)	查询(SUBMIT)	币种(COIN)	5

# 参数

名称	类型	必填	描述
coin	String	是	币种
amount	Decimal	是	划转金额
from	TransactionType	是	划出交易类型
to	TransactionType	是	划入交易类型

# 响应参数

名称	类型	描述
transactionNo	String	交易单号
coin	String	币种
amount	Decimal	划转金额
from	TransactionType	划出交易类型
to	TransactionType	划入交易类型
timestamp	Long	划转时间

# 请求示例

POST /v1/account/transfer/submit
{
	"coin":"USDT",
	"amount":"1",
	"from":"EXCHANGE",
	"to":"OTC"
}

# 响应示例

{
	"code":"200",
	"message":"OK",
	"timestamp":"1684909359187",
	"data":{
		"transactionNo:"TO00000002",
		"coin":"BTC",
		"amount":"0.002",
		"from":"EXCHANGE",
		"to":"OTC",
        "timestamp":198654344
	}
}

# 流水分页

GET /v1/account/waterbill/page

所属模块	所属类型	资源隔离类型	速率限制
账户(ACCOUNT)	查询(SUBMIT)	币种(COIN)	5

# 参数

名称	类型	必填	描述
pageIndex	Int	否	(公共)分页下标不填默认为1
pageSize	Int	否	(公共)分页大小不填默认100
coin	String	是	币种

# 响应参数

名称	类型	描述
transactionNo	String	交易单号
coin	String	币种
amount	Decimal	金额
before	BalanceSnapshot	资产快照交易前
after	BalanceSnapshot	资产快照交易后
\| balance	Decimal	资产快照可用余额
\| freeze	Decimal	资产快照冻结金额
version	Long	流水版本号
timestamp	Long	交易时间戳

# 请求示例

GET /v1/account/waterbill/page?coin=USDT&pageSize=1&pageIndex=1

# 响应示例

{
    "code":"200",
    "message":"OK",
    "timestamp":"1684909359187",
    "data":{
        "total":5,
        "list":[
            {
                "transactionNo":"TO00000001",
                "coin":"USDT",
                "amount":"1.5",
                "before":{
                    "balance":"1.5",
                    "freeze":"0"
                },
                "after":{
                    "balance":"0",
                    "freeze":"1.5"
                },
                "version":2,
                "timestamp":1987123692
            }
        ]
    }
}

← 公共接口现货行情 →