Get Deposit Records (on chain)

Query Deposit Records

Rules

The maximum difference between the start time and the end time is 30 days.

Support to get deposit records by Master or Sub Member Api Key

HTTP Request

GET /asset/v3/private/deposit/record/query

Request Parameters

Parameter	Required	Type	Comments
startTime	false	integer	Start time (ms). Default value: 30 days before the current time
endTime	false	integer	End time (ms). Default value: current time
coin	false	string	Coin name: for example, BTC. Default value: all
cursor	false	string	Cursor, used for pagination
limit	false	integer	Number of items per page, [1, 50]. Default value: 50

Response Parameters

Parameter	Type	Comments
rows	array	Object
> coin	string	deposit coin
> chain	string	chain name
> amount	string	deposit amount
> txID	string	transaction ID. It is "" when deposit failed or deposit cancelled
> status	integer	0=unknown 1=ToBeConfirmed 2=processing 3=success 4=deposit failed
> toAddress	string	deposit target address
> tag	string	tag of deposit target address
> depositFee	string	deposit fee
> successAt	string	last updated time
> confirmations	string	number of confirmation blocks
> txIndex	string	transaction sequence number
> blockHash	string	hash number on the chain
> batchReleaseLimit	string	The deposit limit for this coin in this chain. "-1" means no limit
> depositType	integer	The deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
nextPageCursor	string	cursor information: used for pagination. Default value: ""

Request Example

GET /asset/v3/private/deposit/record/query?coin=USDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671166430580
X-BAPI-RECV-WINDOW: 50000

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [
            {
                "coin": "USDT",
                "chain": "ETH",
                "amount": "10000",
                "txID": "1234567890",
                "status": 3,
                "toAddress": "xxxxxxxxxxx",
                "tag": "",
                "depositFee": "",
                "successAt": "1671018256000",
                "confirmations": "10000",
                "txIndex": "",
                "blockHash": "",
                "batchReleaseLimit": "-1",
                "depositType": 0
            },
            {
                "coin": "USDT",
                "chain": "ETH",
                "amount": "10000",
                "txID": "01234567890",
                "status": 3,
                "toAddress": "xxxxxxxxxxx",
                "tag": "",
                "depositFee": "",
                "successAt": "1669197900000",
                "confirmations": "10000",
                "txIndex": "",
                "blockHash": "",
                "batchReleaseLimit": "-1",
                "depositType": 0
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
    },
    "retExtInfo": {},
    "time": 1671166430718
}