Skip to main content
GET
/
rarity
Get token rarity by open transaction hash
curl --request GET \
  --url https://build.wield.xyz/vibe/boosterbox/rarity \
  --header 'API-KEY: <api-key>'
{
  "success": true,
  "rarity": 123,
  "rarityName": "Common",
  "tokenId": 123,
  "randomValue": "<string>",
  "tokenSpecificRandomness": "<string>"
}

Headers

​
API-KEY
string
default:DEMO_REPLACE_WITH_FREE_API_KEY
required

Free API key needed to authorize requests. Get one at: https://docs.wield.xyz/api-reference/vibemarket-intro

Query Parameters

​
transactionHash
string
required

The transaction hash

​
contractAddress
string
required

The contract address

Response

200 - application/json

Token rarity information

​
success
boolean
​
rarity
integer

Rarity level (0=Common, 1=Uncommon, 2=Rare, 3=Super Rare, 4=Legendary)

​
rarityName
enum<string>
Available options:
Common,
Uncommon,
Rare,
Super Rare,
Legendary
​
tokenId
integer

The token ID

​
randomValue
string

Random value used for determination

​
tokenSpecificRandomness
string

Token-specific randomness