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"

results matching ""

    No results matching ""