Get token configurations
Rate limit: 5 every second
API Overview
HTTP method
GET
Path
/api/v3/exchange/tokens
Summary
Returns the configurations of all supported tokens, including Ether.
API description
HTTP Header
None
Request parameters
None
Request example
HTTP
CURL
GET https://api3.loopring.io/api/v3/exchange/tokens HTTP/1.1
Host: api3.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9curl https://api3.loopring.io/api/v3/exchange/tokensResponse fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| type | string | Y | Token Type Allowable : ['ERC20', 'ETH'] |
"ERC20" |
| tokenId | integer | Y | Token's numeric ID | 2 |
| symbol | string | Y | Token symbol | "LRC" |
| name | string | Y | Token name | "Loopring" |
| address | string | Y | Token ERC20 contract address | "0x97241525fe 425C90eBe5A4 1127816dcFA5 954b06" |
| decimals | integer | Y | Token decimals | 18 |
| precision | integer | Y | Max decimals that relayer uses for the token, smaller amount will be treated as zero. | 6 |
| precisionForOrder | integer | Y | Max decimals that relayer uses for the token, smaller amount will be treated as zero. | 6 |
| orderAmounts | Order Amounts V3 |
Y | The amount requirements for submitting orders. | "{min:100000, max:900000, dust:10}" |
| luckyTokenAmounts | Order Amounts V3 |
Y | field.TokenInfoV3.luckyTokenAmounts | "{min:100000, max:900000, dust:10}" |
| fastWithdrawLimit | string | Y | The maximum amount for single fast withdrawal | "100000000000 0000" |
| gasAmounts | Gas Amount LimitV3 |
Y | The gas amount requirements for user requests | "{distributio nGas:100000, depositGas:1 50000}" |
| enabled | boolean | Y | Whether the token is currently enabled for deposits and withdrawals. | "true" |
Response example
{
"type" : "ERC20",
"tokenId" : 2,
"symbol" : "LRC",
"name" : "Loopring",
"address" : "0x97241525fe425C90eBe5A41127816dcFA5954b06",
"decimals" : 18,
"precision" : 6,
"precisionForOrder" : 6,
"orderAmounts" : {
"minimum" : "10000000000000000",
"maximum" : "1000000000000000000",
"dust" : "1000000000000000"
},
"luckyTokenAmounts" : {
"minimum" : "10000000000000000",
"maximum" : "1000000000000000000",
"dust" : "1000000000000000"
},
"fastWithdrawLimit" : "1000000000000000",
"gasAmounts" : {
"distribution" : "1000000000000000",
"deposit" : "1000000000000000"
},
"enabled" : true
}Status code
| Value | Description |
|---|---|
| 100000 | Unknown error |
Model
OrderAmountsV3
Contains information about the order amounts that are valid for usage with the token in order-related APIs.
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| minimum | string | Y | The minimum amount enforced when submitting orders for the token. | "100000000000 00000" |
| maximum | string | Y | The maximum amount enforced when submitting orders for the token. | "100000000000 0000000" |
| dust | string | Y | The dust amount enforced when submitting orders for the token. | "100000000000 0000" |
GasAmountLimitV3
Contains information about the gas amounts required by ETH L1 requests.
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| distribution | string | Y | The gas amount for withdrawal | "100000000000 0000" |
| deposit | string | Y | The gas amount for deposit | "100000000000 0000" |