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

流量控制: 每秒

摘要

HTTP 方法

GET

访问路径

/api/v3/nft/info/orderUserRateAmount

功能

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 描述

HTTP头

字段	类型	必须	说明	举例
X-API-KEY	string	是	ApiKey	"HlkcGxbqBeaF76j4rvPaOasyfPwnkQ 6B6DQ6THZWbvrAGxzEdulXQvOKLrRW ZLnN"

请求参数

字段	类型	必须	说明	举例
accountId	integer	是	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	是	NFT token address of order	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
feeTokenSymbol	string	否	Fee token symbol	"ETH"

请求示例

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

响应字段

字段	类型	必须	说明	举例
nftTokenAddress	string	是	field.NftFeeRate.nftTokenAddress	"0xbbbbca6a90 1c926f240b89 eacb641d8aec 7aeafd"
feeRate	integer	是	field.NftFeeRate.rate	20
amounts	List[FeeToken Amount]	是	Amounts	/
gasPrice	string	是	field.GetUserNftFeeRatesResponse.gasPrice	"10000000000"
cacheOverdueAt	integer	是	Cached price data overdue time	1632365568

响应示例

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

状态码

状态码	描述
100000	Unknown error

模型

FeeTokenAmount

The result of query NFT market minimum fee tokens amount

字段	类型	必须	说明	举例
feeTokenSymbol	string	是	Fee token symbol	"ETH"
minAmount	string	是	The minimum quote token amount to place a NFT order	/
tradeCost	string	是	The base cost of trade settlement	/
marketOrderInfo	Order Amounts V3	是	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.

字段	类型	必须	说明	举例
minimum	string	是	The minimum amount enforced when submitting orders for the token.	"100000000000 00000"
maximum	string	是	The maximum amount enforced when submitting orders for the token.	"100000000000 0000000"
dust	string	是	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