Query current token minimum amount to place order based on users VIP level and max fee bips

Rate limit: every seconds

API Overview

HTTP method

GET

Path

/api/v3/user/orderUserRateAmount

Summary

This API returns 2 minimum amounts, one is based on users fee rate, the other is based on the maximum fee bips which is 0.6%. In other words, if user wants to keep fee rate, the minimum order is higher, otherwise he needs to pay more but can place less amount orders.

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, some hash query APIs doesnt need it if in hash query mode, check require flag of each API to see if its a must.	10086
market	string	Y	Trading pair	"LRC-ETH"

Request example

HTTP

CURL

GET https://api3.loopring.io/api/v3/user/orderUserRateAmount?accountId=10086&market=LRC-ETH 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/orderUserRateAmount\?accountId\=10086\&market\=LRC-ETH

Response fields

Field	Type	Required	Description	Example
gasPrice	string	N	The gas price use to calculate amount	"10000000000"
amounts	List[Token Amount]	N	Amounts	/
cacheOverdueAt	integer	N	Cached price data overdue time	1614683483382

Response example

{
  "gasPrice" : "10000000000",
  "amounts" : [
    {
      "tokenSymbol" : "LRC",
      "discount" : 1.0,
      "baseOrderInfo" : {
        "minAmount" : "10000000000",
        "makerRate" : 0,
        "takerRate" : 0
      },
      "userOrderInfo" : {
        "minAmount" : "10000000000",
        "makerRate" : 0,
        "takerRate" : 0
      },
      "marketOrderInfo" : {
        "minimum" : "10000000000000000",
        "maximum" : "1000000000000000000",
        "dust" : "1000000000000000"
      }
    }
  ],
  "cacheOverdueAt" : 1614683483382
}

Status code

Value	Description
100000	Unknown error

Model

TokenAmount

The result of token amount

Field	Type	Required	Description	Example
tokenSymbol	string	N	Token	"LRC"
discount	number	N	Fee rate discount	1.0
baseOrderInfo	Order Info	N	The minimum amount accord with minimum fee rate	/
userOrderInfo	Order Info	N	The minimum amount accord with user fee rate	/
marketOrderInfo	Order Amounts V3	Y	The amount requirements for submitting orders.	"{min:100000, max:900000, dust:10}"

OrderInfo

The result of token amount

Field	Type	Required	Description	Example
minAmount	string	N	The minimum amount	"10000000000"
makerRate	integer	N	Maker rate	0
takerRate	integer	N	Taker rate	0

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"

Query current token minimum amount to place order based on users VIP level and max fee bips