Skip to main content

Get Deposit Records (on-chain)

Query deposit records.

tip
  • endTime - startTime should be less than 30 days. Query last 30 days records by default.
  • Support using main or sub UID api key to query deposit records respectively.

HTTP Request

GET /v5/asset/deposit/query-record

Request Parameters

ParameterRequiredTypeComments
coinfalsestringCoin, uppercase only
startTimefalseintegerThe start timestamp (ms)
endTimefalseintegerThe end timestamp (ms)
limitfalseintegerLimit for data size per page. [1, 50]. Default: 50
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
rowsarrayObject
> coinstringCoin
> chainstringChain
> amountstringAmount
> txIDstringTransaction ID
> statusintegerDeposit status
> toAddressstringDeposit target address
> tagstringTag of deposit target address
> depositFeestringDeposit fee
> successAtstringLast updated time
> confirmationsstringNumber of confirmation blocks
> txIndexstringTransaction sequence number
> blockHashstringHash number on the chain
> batchReleaseLimitstringThe deposit limit for this coin in this chain. "-1" means no limit
> depositTypestringThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
nextPageCursorstringRefer to the cursor request parameter

Request Example

GET /v5/asset/deposit/query-record?coin=USDT&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672191991544
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"rows": [
{
"coin": "USDT",
"chain": "ETH",
"amount": "10000",
"txID": "skip-notification-scene-test-amount-202212270944-533285-USDT",
"status": 3,
"toAddress": "test-amount-address",
"tag": "",
"depositFee": "",
"successAt": "1672134274000",
"confirmations": "10000",
"txIndex": "",
"blockHash": "",
"batchReleaseLimit": "-1",
"depositType": "0"
}
],
"nextPageCursor": "eyJtaW5JRCI6MTA0NjA0MywibWF4SUQiOjEwNDYwNDN9"
},
"retExtInfo": {},
"time": 1672191992512
}