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