Get Internal Deposit Records (off-chain)

Query deposit records within the Bybit platform. These transactions are not on the blockchain.

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 /v5/asset/deposit/query-internal-record

Request Parameters

Parameter	Required	Type	Comments
txID	false	string	Internal transfer transaction ID
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
> id	string	ID
> type	integer	1: Internal deposit
> coin	string	Deposit coin
> amount	string	Deposit amount
> status	integer	1=Processing 2=Success 3=deposit failed
> address	string	Email address or phone number
> createdTime	string	Deposit created timestamp
> txID	string	Internal transfer transaction ID
nextPageCursor	string	cursor information: used for pagination. Default value: ""

---

Request Example

HTTP

GET /v5/asset/deposit/query-internal-record HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1682099024473
X-BAPI-RECV-WINDOW: 50000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_internal_deposit_records(
    startTime=1667260800000,
    endTime=1667347200000,
))

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [
            {
                "id": "1103",
                "amount": "0.1",
                "type": 1,
                "coin": "ETH",
                "address": "xxxx***@gmail.com",
                "status": 2,
                "createdTime": "1705393280",
                "txID": "77c37e5c-d9fa-41e5-bd13-c9b59d95"
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MTEwMywibWF4SUQiOjExMDN9"
    },
    "retExtInfo": {},
    "time": 1705395632689
}