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: sra1aavfacurl -H "X-API-KEY:sra1aavfa" https://api3.loopring.io/api/v3/user/balances\?accountId\=1\&tokens\=0,1Response 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" |