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/nft/info/orderUserRateAmount

Summary

minAmount is the minFee under the basic feeRate of the user, tradeCosts is the cost of L2 trade settlement, also it returns the market order requirements: the min/max order amount. So an valid order should meet these 3 requirements:.1. order.maxFeeBips >= feeRate.rate and order.amount >= minAmounts.2. order.amount * order.maxFeeBips > tradeCosts if order.amount < minAmounts.3. marketOrderInfo.min <= order.amount <= marketOrderInfo.max.These amounts change according to ETH gas price and get refreshed every 15 mins.

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
nftTokenAddress	string	Y	NFT token address of order	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
feeTokenSymbol	string	N	Fee token symbol	"ETH"

Request example

HTTP

CURL

GET https://api3.loopring.io/api/v3/nft/info/orderUserRateAmount?accountId=10086&nftTokenAddress=0xbbbbca6a901c926f240b89eacb641d8aec7aeafd&feeTokenSymbol=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/nft/info/orderUserRateAmount\?accountId\=10086\&nftTokenAddress\=0xbbbbca6a901c926f240b89eacb641d8aec7aeafd\&feeTokenSymbol\=ETH

Response fields

Field	Type	Required	Description	Example
nftTokenAddress	string	Y	field.NftFeeRate.nftTokenAddress	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
feeRate	integer	Y	field.NftFeeRate.rate	20
amounts	List[FeeToken Amount]	Y	Amounts	/
gasPrice	string	Y	field.GetUserNftFeeRatesResponse.gasPrice	"10000000000"
cacheOverdueAt	integer	Y	Cached price data overdue time	1632365568

Response example

{
  "nftTokenAddress" : "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
  "feeRate" : 20,
  "amounts" : [
    {
      "feeTokenSymbol" : "ETH",
      "minAmount" : "",
      "tradeCost" : "",
      "marketOrderInfo" : {
        "minimum" : "10000000000000000",
        "maximum" : "1000000000000000000",
        "dust" : "1000000000000000"
      }
    }
  ],
  "gasPrice" : "10000000000",
  "cacheOverdueAt" : 1632365568
}

Status code

Value	Description
100000	Unknown error

Model

FeeTokenAmount

The result of query NFT market minimum fee tokens amount

Field	Type	Required	Description	Example
feeTokenSymbol	string	Y	Fee token symbol	"ETH"
minAmount	string	Y	The minimum quote token amount to place a NFT order	/
tradeCost	string	Y	The base cost of trade settlement	/
marketOrderInfo	Order Amounts V3	Y	the market info of the NFT market include min/max/dust order amount limitations.	/

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