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

Parameter	Required	Type	Comments
coin	false	string	Coin, uppercase only
startTime	false	integer	The start timestamp (ms)
endTime	false	integer	The end timestamp (ms)
limit	false	integer	Limit for data size per page. [1, 50]. Default: 50
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
rows	array	Object
> coin	string	Coin
> chain	string	Chain
> amount	string	Amount
> txID	string	Transaction ID
> status	integer	Deposit status
> 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	string	The deposit type. 0: normal deposit, 10: the deposit reaches daily deposit limit, 20: abnormal deposit
nextPageCursor	string	Refer to the cursor request parameter

---

Request Example

HTTP

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

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_deposit_records(
    coin="USDT",
))

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'apikey',
  secret: 'apisecret',
});

client
  .getDepositRecords({
    coin: 'USDT'
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

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
}