Get VRF gacha pack by slug
curl --request GET \
--url https://api.renaiss.xyz/v2/gacha/packs/{slug}const options = {method: 'GET'};
fetch('https://api.renaiss.xyz/v2/gacha/packs/{slug}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.renaiss.xyz/v2/gacha/packs/{slug}"
response = requests.get(url)
print(response.text){
"cardPack": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>",
"packType": "limited",
"stage": "countdown",
"description": "<string>",
"priceInUsdt": "<string>",
"expectedValueInUsd": "<string>",
"packBannerVideoUrl": "<string>",
"gachaMachineVideoUrl": "<string>",
"gachaRippingPackAnimationVideoUrl": "<string>",
"onChainPackId": "<string>",
"vendingMachineAddress": "<string>",
"tiers": [
{
"tier": 123,
"name": "TOP",
"chance": 123,
"priceRangeInUsd": {
"min": "<string>",
"max": "<string>"
}
}
],
"activeSetExpectedValueInUsd": "<string>",
"buybackConfig": [
{
"buybackPercentage": 123,
"buybackExpiredInSeconds": 1
}
]
}
}{
"code": "WRONG_REQUEST_PARAMS",
"message": "<string>"
}{
"error": "Invalid authentication credential",
"code": "API_AUTH_INVALID_CREDENTIAL"
}{
"error": "Credential is not allowed by this policy",
"code": "API_AUTH_CREDENTIAL_NOT_ALLOWED"
}{
"code": "CARD_PACK_NOT_FOUND",
"message": "<string>"
}{
"code": "SUBGRAPH_ABORTED",
"message": "Unable to load pack details"
}{
"code": "SUBGRAPH_RATE_LIMITED",
"message": "<string>"
}{
"code": "FUNCTION_ERROR",
"message": "Unable to load pack details"
}{
"message": "Unable to load pack details",
"code": "SUBGRAPH_NETWORK_ERROR"
}Pack catalog
Get a pack
Look up a pack by slug to see its price, tier odds and buyback terms.
GET
/
v2
/
gacha
/
packs
/
{slug}
Get VRF gacha pack by slug
curl --request GET \
--url https://api.renaiss.xyz/v2/gacha/packs/{slug}const options = {method: 'GET'};
fetch('https://api.renaiss.xyz/v2/gacha/packs/{slug}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.renaiss.xyz/v2/gacha/packs/{slug}"
response = requests.get(url)
print(response.text){
"cardPack": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>",
"packType": "limited",
"stage": "countdown",
"description": "<string>",
"priceInUsdt": "<string>",
"expectedValueInUsd": "<string>",
"packBannerVideoUrl": "<string>",
"gachaMachineVideoUrl": "<string>",
"gachaRippingPackAnimationVideoUrl": "<string>",
"onChainPackId": "<string>",
"vendingMachineAddress": "<string>",
"tiers": [
{
"tier": 123,
"name": "TOP",
"chance": 123,
"priceRangeInUsd": {
"min": "<string>",
"max": "<string>"
}
}
],
"activeSetExpectedValueInUsd": "<string>",
"buybackConfig": [
{
"buybackPercentage": 123,
"buybackExpiredInSeconds": 1
}
]
}
}{
"code": "WRONG_REQUEST_PARAMS",
"message": "<string>"
}{
"error": "Invalid authentication credential",
"code": "API_AUTH_INVALID_CREDENTIAL"
}{
"error": "Credential is not allowed by this policy",
"code": "API_AUTH_CREDENTIAL_NOT_ALLOWED"
}{
"code": "CARD_PACK_NOT_FOUND",
"message": "<string>"
}{
"code": "SUBGRAPH_ABORTED",
"message": "Unable to load pack details"
}{
"code": "SUBGRAPH_RATE_LIMITED",
"message": "<string>"
}{
"code": "FUNCTION_ERROR",
"message": "Unable to load pack details"
}{
"message": "Unable to load pack details",
"code": "SUBGRAPH_NETWORK_ERROR"
}| Value | What it describes |
|---|---|
| Tier percentages | Rounded odds across the whole set. |
expectedValueInUsd | The expected value stored with the pack. |
activeSetExpectedValueInUsd | The average value across the entire active set used by the v3 machine. The remaining undrawn cards can have a different average. |
Request
Optional builder key
Response
Error codes
Match the HTTP status and response text to a row below. For guidance on codes shared across endpoints, see Error meanings and recovery.
| HTTP | Error code | Text field | Response text and recovery |
|---|---|---|---|
400 | INVALID_SCHEMA | message | Unable to load pack details |
400 | WRONG_REQUEST_PARAMS | message | Bad request - invalid parameters |
401 | API_AUTH_INVALID_CREDENTIAL | error | Invalid authentication credentialThe builder key is malformed, unknown, expired or revoked. Check the key. Do not retry with the same key. |
403 | API_AUTH_CREDENTIAL_NOT_ALLOWED | error | Credential is not allowed by this policyOmit credentials, or send only an optional builder key in x-builder-api-key. |
403 | GACHA_V3_BUILDER_NOT_ACCEPTED_ON_PUBLIC_API | error | This builder checks out on its own surface, not on the public APIThis builder key cannot be used on this API. Do not retry; contact Renaiss. |
404 | CARD_PACK_NOT_FOUND | message | Pack not found |
408 | SUBGRAPH_ABORTED | message | Unable to load pack detailsMainnet can return this for a timed-out pack read. Testnet returns HTTP 502 with SUBGRAPH_NETWORK_ERROR for that timeout. |
429 | API_AUTH_RATE_LIMITED | error | Authentication rate limit exceededThe builder key hit its rate limit. Wait a little, then retry at a lower rate. |
429 | SUBGRAPH_RATE_LIMITED | message | Unable to load pack details |
500 | API_AUTH_ERROR | error | Internal server error |
500 | FUNCTION_ERROR | error | Internal server error |
500 | FUNCTION_ERROR | message | Unable to load pack details |
500 | CARD_PACKS_QUERY_FAILEDSUBGRAPH_QUERY_FAILED | message | Unable to load pack detailsRead again after a short wait. |
500 | Other code | message | Unable to load pack details |
502 | SUBGRAPH_NETWORK_ERRORSUBGRAPH_REQUEST_FAILEDSUBGRAPH_QUERY_ERROR | message | Unable to load pack detailsRead again after a short wait. |
502 | Other code | message | Unable to load pack details |