Get user deposit history

Rate limit: 3 every second

API Overview


HTTP method

GET

Path

/api/v2/user/deposits

Summary

Returns a list of deposit records for the given user.

API description


HTTP Header

Field Type Required Description Example
X-API-KEY string Y ApiKey "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ
6B6DQ6THZWbvrAGxzEdulXQvOKLrRW
ZLnN"

Request parameters

Field Type Required Description Example
accountId integer Y Account ID 1
start integer N Start time in milliseconds
Default : 0L
1578558098000
end integer N End time in milliseconds
Default : 0L
1578558098000
allType boolean N True to include user account registration and password reset records "false"
status string N Comma separated status values
Allowable : ['processing', 'processed', 'received', 'failed']
"processing,processed"
limit integer N Number of records to return 50
fromHash string N Pagination of data to return records earlier than the requested hash "0x9d114267e8b261457d
567093c13cf3deea5f14
c9235be26c6fa833dba1
2a9632"
tokenSymbol string N Token to filter. If you want to return deposit records for all tokens, omit this parameter "ETH"
offset integer N Number of records to skip
Default : 0L
1

Request example

HTTP
CURL
GET https://api.loopring.io/api/v2/user/deposits?accountId=1&start=1578558098000&end=1578558098000&allType=false&status=processing,processed&limit=50&fromHash=0x9d114267e8b261457d567093c13cf3deea5f14c9235be26c6fa833dba12a9632&tokenSymbol=ETH&offset=1 HTTP/1.1
Host: api.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-KEY: sra1aavfa
curl -H "X-API-KEY:sra1aavfa" https://api.loopring.io/api/v2/user/deposits\?accountId\=1\&start\=1578558098000\&end\=1578558098000\&allType\=false\&status\=processing,processed\&limit\=50\&fromHash\=0x9d114267e8b261457d567093c13cf3deea5f14c9235be26c6fa833dba12a9632\&tokenSymbol\=ETH\&offset\=1

Response fields

Field Type Required Description Example
resultInfo ResultInfo Y Information returned by the API /
data DepositDataList N TxDataList /

Response example

{
    "resultInfo" : {
        "code" : 0,
        "message" : "SUCCESS"
    },
    "data" : {
        "totalNum" : 1,
        "transactions" : [
            {
                "id" : 1,
                "symbol" : "LRC",
                "amount" : "1000000000000000000",
                "txHash" : "0x9d114267e8b261457d567093c13cf3deea5f14c9235be26c6fa833dba12a9632",
                "feeAmount" : "1000000000000000",
                "status" : "processing",
                "progress" : "100%",
                "timestamp" : 1578572292000,
                "depositType" : "DEPOSIT",
                "blockNum" : 100,
                "updatedAt" : 1578572292000
            }
        ]
    }
}

Status code

Value Description
100000 Unknown error
107001 User ID cannot be empty
104001 Empty ApiKey
104002 Invalid ApiKey
104003 Invalid Account ID

Model


DepositDataList

DepositDataList

Field Type Required Description Example
totalNum integer Y Total number of records found 1
transactions List[DepositData] Y List of DepositRecord /

DepositData

Response data

Field Type Required Description Example
id integer Y Unique id 1
symbol string Y Token symbol "LRC"
amount string Y Amount requested by the user "1000000000000000000"
txHash string Y Transaction hash "0x9d114267e8b261457d
567093c13cf3deea5f14
c9235be26c6fa833dba1
2a9632"
feeAmount string Y User transaction type "1000000000000000"
status string Y Current status
Allowable : ['processing', 'processed', 'received', 'failed']
"processing"
progress string Y Progress "100%"
timestamp integer Y Create time 1578572292000
depositType string Y Deposit type
Allowable : ['DEPOSIT', 'CREATE_ACCOUNT', 'UPDATE_ACCOUNT']
"DEPOSIT"
blockNum integer Y Block height 100
updatedAt integer Y Update time 1578572292000

results matching ""

    No results matching ""