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
idfalsestringInternal ID: Can be used to uniquely identify and filter the deposit. When combined with other parameters, this field takes the highest priority
txIDfalsestringTransaction ID: Please note that data generated before Jan 1, 2024 cannot be queried using txID
coinfalsestringCoin, uppercase only
startTimefalseintegerThe start timestamp (ms) Note: the query logic is actually effective based on second level
endTimefalseintegerThe end timestamp (ms) Note: the query logic is actually effective based on second level
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
> fromAddressstringFrom address of deposit, only shown when the deposit comes from on-chain and from address is unique, otherwise gives ""
> taxDepositRecordsIdstringThis field is used for tax purposes by Bybit EU (Austria) users, declare tax id
> taxStatusintegerThis field is used for tax purposes by Bybit EU (Austria) users
  • 0: No reporting required
  • 1: Reporting pending
  • 2: Reporting completed
  • > idstringUnique ID
    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: xxxxxxxxxxxxxxxxxx
    X-BAPI-TIMESTAMP: 1672191991544
    X-BAPI-RECV-WINDOW: 5000

    Response Example

    {
    "retCode": 0,
    "retMsg": "success",
    "result": {
    "rows": [
    {
    "coin": "USDT",
    "chain": "TRX",
    "amount": "999.0496",
    "txID": "04bf3fbad2fc85b107a42cfdc5ff83110092b606ca754efa0f032f8b94b3262e",
    "status": 3,
    "toAddress": "TDGYpm5zPacnEqKV34TJPuhJhHom9hcXAy",
    "tag": "",
    "depositFee": "",
    "successAt": "1742728163000",
    "confirmations": "50",
    "txIndex": "0",
    "blockHash": "000000000436ab4dabc8a4a87beb2262d2d87f6761a825494c4f1d5ae11b27e8",
    "batchReleaseLimit": "-1",
    "depositType": "0",
    "fromAddress": "TJ7hhYhVhaxNx6BPyq7yFpqZrQULL3JSdb",
    "taxDepositRecordsId": "0",
    "taxStatus": 0,
    "id": "160237231"
    }
    ],
    "nextPageCursor": "eyJtaW5JRCI6MTYwMjM3MjMxLCJtYXhJRCI6MTYwMjM3MjMxfQ=="
    },
    "retExtInfo": {},
    "time": 1750798211884
    }