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" |