Get user exchange balances
Rate limit: 5 every second
API Overview
HTTP method
GET
Path
/api/v3/user/balances
Summary
Returns user's Ether and token balances on exchange.
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 | AccountID | 1 |
tokens | string | N | Query tokens | "0,1" |
Request example
HTTP
CURL
GET https://api3.loopring.io/api/v3/user/balances?accountId=1&tokens=0,1 HTTP/1.1
Host: api3.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://api3.loopring.io/api/v3/user/balances\?accountId\=1\&tokens\=0,1
Response fields
Field | Type | Required | Description | Example |
---|---|---|---|---|
tokenId | integer | Y | Token ID | 10 |
total | string | Y | Amount of the asset | "100" |
locked | string | Y | The part of the total balance which is currently not liquid and not at the users disposal (because of pending withdrawals or orders for example) | "100" |
pending | Pending Balance |
Y | Users pending balances | "100" |
Response example
{
"tokenId" : 10,
"total" : "100",
"locked" : "100",
"pending" : {
"withdraw" : "10000000000000",
"deposit" : "10000000000000"
}
}
Status code
Value | Description |
---|---|
100000 | Unknown error |
104001 | Empty ApiKey |
104002 | Invalid ApiKey |
104003 | Invalid Account ID |
Model
PendingBalance
Users pending balances
Field | Type | Required | Description | Example |
---|---|---|---|---|
withdraw | string | Y | Withdrawal pending balance which means the token is in withdrawal state but not arrived L1 | "100000000000 00" |
deposit | string | Y | Deposit pending balance which means the token is in deposit state but not arrived L2 | "100000000000 00" |