获取公开藏品详情和价格历史
curl --request GET \
--url https://api.renaiss.xyz/v2/marketplace/collectibles/{tokenId}const options = {method: 'GET'};
fetch('https://api.renaiss.xyz/v2/marketplace/collectibles/{tokenId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.renaiss.xyz/v2/marketplace/collectibles/{tokenId}"
response = requests.get(url)
print(response.text){
"collectible": {
"tokenId": "<string>",
"name": "<string>",
"ownerAddress": "<string>",
"askPriceInUSDT": "<string>",
"frontImageUrl": "<string>",
"type": "POKEMON",
"attributes": [
{
"key": "<string>",
"value": "<string>"
}
],
"rixPriceInUsd": "<string>",
"owner": {
"username": "<string>",
"image": "<string>"
},
"askExpiresAt": "<string>",
"rixPriceUpdatedAt": "<string>",
"backImageUrl": "<string>"
},
"pricing": {
"top_offer": {
"value": "<string>",
"token": "USDT"
},
"last_sale": {
"value": "<string>",
"token": "USDT"
},
"price_history": [
{
"timestamp": "<string>",
"amount": {
"value": "<string>",
"token": "USDT"
}
}
]
}
}{
"error": "Invalid marketplace request",
"code": "WRONG_REQUEST_PARAMS"
}{
"error": "Invalid authentication credential",
"code": "API_AUTH_INVALID_CREDENTIAL"
}{
"error": "Credential is not allowed by this policy",
"code": "API_AUTH_CREDENTIAL_NOT_ALLOWED"
}{
"error": "Collectible not found",
"code": "COLLECTIBLE_NOT_FOUND"
}Internal Server Error卡牌目录
获取卡牌详情
按代币 ID 查询公开可见的藏品,查看其详情、持有人地址和历史价格。
GET
/
v2
/
marketplace
/
collectibles
/
{tokenId}
获取公开藏品详情和价格历史
curl --request GET \
--url https://api.renaiss.xyz/v2/marketplace/collectibles/{tokenId}const options = {method: 'GET'};
fetch('https://api.renaiss.xyz/v2/marketplace/collectibles/{tokenId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.renaiss.xyz/v2/marketplace/collectibles/{tokenId}"
response = requests.get(url)
print(response.text){
"collectible": {
"tokenId": "<string>",
"name": "<string>",
"ownerAddress": "<string>",
"askPriceInUSDT": "<string>",
"frontImageUrl": "<string>",
"type": "POKEMON",
"attributes": [
{
"key": "<string>",
"value": "<string>"
}
],
"rixPriceInUsd": "<string>",
"owner": {
"username": "<string>",
"image": "<string>"
},
"askExpiresAt": "<string>",
"rixPriceUpdatedAt": "<string>",
"backImageUrl": "<string>"
},
"pricing": {
"top_offer": {
"value": "<string>",
"token": "USDT"
},
"last_sale": {
"value": "<string>",
"token": "USDT"
},
"price_history": [
{
"timestamp": "<string>",
"amount": {
"value": "<string>",
"token": "USDT"
}
}
]
}
}{
"error": "Invalid marketplace request",
"code": "WRONG_REQUEST_PARAMS"
}{
"error": "Invalid authentication credential",
"code": "API_AUTH_INVALID_CREDENTIAL"
}{
"error": "Credential is not allowed by this policy",
"code": "API_AUTH_CREDENTIAL_NOT_ALLOWED"
}{
"error": "Collectible not found",
"code": "COLLECTIBLE_NOT_FOUND"
}Internal Server ErrorownerAddress 为抽卡库存合约地址。响应不包含私有预留信息和回购授权。rixPriceInUsd 中的 RIX 估值就是这张卡的预估公允市价(FMV),单位为美分。当前卖价和买单请查订单簿。请求
公开查询
响应
错误码
在下表中查找接口返回的 HTTP 状态码和响应原文。有关各接口通用的处理建议,请参阅错误码含义与处理方式。
| HTTP | 错误码 | 文本字段 | 响应文本与处理方式 |
|---|---|---|---|
400 | WRONG_REQUEST_PARAMS | error | Invalid marketplace request请核对查询参数或十进制代币 ID。 |
401 | API_AUTH_INVALID_CREDENTIAL | error | Invalid authentication credential某个凭据请求头格式错误。请移除凭据后重试。 |
403 | API_AUTH_CREDENTIAL_NOT_ALLOWED | error | Credential is not allowed by this policy请移除凭据请求头后重试。 |
404 | COLLECTIBLE_NOT_FOUND | error | Collectible not found代币 ID 未知或藏品在该 API 中不可用。请核对 ID,不要用同一 ID 重试。 |
500 | API_AUTH_ERROR | error | Internal server error |
500 | FUNCTION_ERROR | error | Internal server error |
500 | COLLECTIBLE_GET_FAILEDTOKEN_PRICING_QUERY_FAILED | error | Internal server error请稍后重新查询。 |
500 | 其他错误码 | error | Internal server error |
500 | 无错误码 | text/plain | Internal Server Error |