Skip to main content

Get Sub Deposit Records (on chain)

Query Sub Deposit Records By Master Key

Rules

Rules: Query sub account deposit records by master account api key. If you want to use sub account api key to query, please use Query Deposit Records endpoint

HTTP Request

GET /asset/v3/private/deposit/sub-member-record/query

Request Parameters

ParameterRequiredTypeComments
subMemberIdtrueintegerSub user Id
startTimefalseintegerThe start time (ms). Default value: 30 days before the current time
endTimefalseintegerTbe end time (ms). Default value: current time
coinfalsestringCoin name: for example, BTC. Default value: all
cursorfalsestringCursor, used for pagination
limitfalseintegerNumber of items per page, [1, 50]. Default value: 50

Response Parameters

ParameterTypeComments
rowsarrayObject
> coinstringdeposit coin
> chainstringchain name
> amountstringdeposit amount
> txIDstringtransaction ID. It is "" when deposit failed or deposit cancelled
> statusinteger
  • 0=unknown
  • 1=ToBeConfirmed
  • 2=processing
  • 3=success
  • 4=deposit failed
> 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
> depositTypeintegerThe deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
nextPageCursorstringcursor information: used for pagination. Default value: ""

Request Example

GET /asset/v3/private/deposit/sub-member-record/query?subMemberId=xxxxxxxxxxx HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxx
X-BAPI-SIGN: xxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671169682466
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": "11234567890",
"depositFee": "",
"successAt": "1671018256000",
"confirmations": "10000",
"txIndex": "",
"blockHash": "",
"batchReleaseLimit": "-1",
"depositType": 0
}
],
"nextPageCursor": "eyJtaW5JRCI6MTAwNTYwNiwibWF4SUQiOjEwMzE1MjN9"
},
"retExtInfo": {},
"time": 1671166430718
}