查看充提记录

/sapi/v1/sunperp/dw/query/deposit-withdraw

是否验签: 是

请求类型: GET

接口权限: 提币

接口描述: 每个UID 3秒最多 144 次请求(交易接口3秒最多 72 次请求，查询接口3秒最多 72 次请求) (该UID的所有币种和不同到期日的合约的所有私有接口共享该限制) 。

接口描述: 确认提币请求

请求参数

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
currency	string	false	币种	btc, ltc, bch, eth, etc ...(取值参考GET /v1/common/currencys)
type	string	true	充值或提币	deposit 或 withdraw,子用户仅可用deposit
from	string	false	查询起始 ID		缺省时，默认值direct相关。当direct为‘prev’时，from 为1 ，从旧到新升序返回；当direct为’next‘时，from为最新的一条记录的ID，从新到旧降序返回
size	string	false	查询记录大小	[1-50]	50
direct	string	false	返回记录排序方向	“prev” （升序）or “next” （降序）	direcet 缺省时，缺省时，默认为"next" （降序）

响应参数

status	string	true	请求返回状态	"ok" or "error"
error-code	string	false	提币失败错误码，仅type为”withdraw“，且state为”reject“、”wallet-reject“和”failed“时有。
error-msg	string	false	提币失败错误描述，仅type为”withdraw“，且state为”reject“、”wallet-reject“和”failed“时有。
<data>	object	true
id	long	true	充币或者提币订单id，翻页查询时from参数取自此值
type	string	true	类型	'deposit', 'withdraw', 子用户仅有deposit
currency	string	true	币种
tx-hash	string	true	交易哈希。如果是“快速提币”，则提币不通过区块链，该值为空。
chain	string	true	链名称
amount	float	true	个数
address	string	true	目的地址
address-tag	string	true	地址标签
fee	float	true	手续费
state	string	true	状态	虚拟币充值状态 unknown：状态未知，confirming：区块确认中，confirmed：区块已完成，已经上账，可以划转和交易]；虚拟币提币状态[verifying：待验证，failed：验证失败，submitted：已提交，reexamine：审核中，canceled，已撤销，pass：审批通过，reject：审批拒绝，pre-transfer：处理中，wallet-transfer：已汇出，wallet-reject：钱包拒绝，confirmed：区块已确认，confirm-error：区块确认错误，repealed：已撤销]safe：区块已确认，可以提币orphan：区块已被孤立，risk-action-fail：风控验证失败，risk-action-timeout：风控动作超时
created-at	long	true	发起时间
updated-at	long	true	最后更新时间
sub-type	string	true	无效字段
request-id	string	true	无效字段
chain-full-name	string	true	无效字段
from-addr-tag	string	true	无效字段
address-id	string	true	无效字段
wallet-confirm	string	true	无效字段
</data>		false

注意：

• 需要在请求头中添加 'CLOUD-EXCHANGE: 6X2K9L4V1C'

• API签名的字符串不包含"/sapi/v1"的部分，只有 "/sunperp/dw/xxx" 部分被考虑

请求示例

GET /sapi/v1/sunperp/dw/query/deposit-withdraw?SignatureVersion=2&AccessKeyId=<your key>&Signature=<your signature>&SignatureMethod=HmacSHA256&Timestamp=2025-12-23T07%3A08%3A24&type=deposit

返回示例

{
    "status": "ok",
    "data": [
        {
            "id": 161234626,
            "type": "deposit",
            "sub-type": "SUN_PERP_USER_DEPOSIT",
            "request-id": "trc20usdt-500e802ba8ece8f0022c876109132d601fb7211e0ca406da87f08440b6f19d07-201",
            "currency": "usdt",
            "chain": "trc20usdt",
            "chain-full-name": "TRON",
            "tx-hash": "500e802ba8ece8f0022c876109132d601fb7211e0ca406da87f08440b6f19d07",
            "amount": 18.8,
            "from-addr-tag": "",
            "address-id": 0,
            "address": "TEubMt2TNag5NN1JXVaeysUk8GNTTYmtVX",
            "address-tag": "",
            "fee": 0,
            "state": "safe",
            "wallet-confirm": 20,
            "created-at": 1757935674710,
            "updated-at": 1757935745174
        }
    ]
}