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.9
curl https://api3.loopring.io/api/v3/exchange/tokens

Response 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 "0x97241525fe425C90eB
e5A41127816dcFA5954b
06"
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 OrderAmountsV3 Y The amount requirements for submitting orders. "{min:100000, max:900000, dust:10}"
fastWithdrawLimit string Y The maximum amount for single fast withdrawal "1000000000000000"
gasAmounts GasAmountLimitV3 Y The gas amount requirements for user requests "{distributionGas:100
000, depositGas:150000}"
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"
    },
    "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. "10000000000000000"
maximum string Y The maximum amount enforced when submitting orders for the token. "1000000000000000000"
dust string Y The dust amount enforced when submitting orders for the token. "1000000000000000"

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 "1000000000000000"
deposit string Y The gas amount for deposit "1000000000000000"

results matching ""

    No results matching ""