Skip to main content
For authentication, error codes, pagination, and common types, refer to the MSU OpenAPI Builder Guide.

​
GetNftItem — Get NFT Item Details

GET /v1rc1/items/{assetKey}
GET /v1rc1/items/by-token-id/{tokenId}
Returns the full details of an NFT item. Path Parameters
ParameterTypeDescription
assetKeystringInternal item identifier
tokenIdstringNFT token ID (by-token-id endpoint)
Response data
FieldTypeDescription
itemNftItemFull NFT item information
NftItem Object
FieldTypeDescription
assetKeystringAsset key
namestringItem name
categoryCategoryItem classification
tokenInfoTokenInfoMinting information (null if not minted)
statusV2ItemStatusItem status
owner.walletAddressstringOwner’s wallet address
imageItemImageImage information
commonItemCommonCommon item attributes
requiredItemRequiredEquip requirements
statsItemStatsStat information
enhanceItemEnhanceEnhancement information
beautyBeautyAttributesBeauty item attributes (null if not a beauty item)
petPetAttributesPet item attributes (null if not a pet item)
updatedAtstring (ISO8601)Last updated time
createdAtstring (ISO8601)Creation time
hashstringHash for detecting data changes
ItemStatus Object
FieldTypeDescription
usageStatusItemUsageStatusItem usage status
isMintedbooleanWhether minted
locationItemLocationItem location
ItemLocation Values
ValueDescription
ItemLocation_Unknown (0)Unknown
ItemLocation_WalletInventory (1)Wallet inventory
ItemLocation_CharacterInventory (2)Character inventory
ItemLocation_Etc (3)Other (exchange shop, collection, basket, etc.)
ItemLocation_NoWhere (999)Burned or abandoned
ItemEnhance Object
FieldTypeDescription
starforceStarForceStarforce information
potentialPotentialPotential
bonusPotentialPotentialAdditional potential
extraOptionExtraOptionExtra option
StarForce Object
FieldTypeDescription
enhancedintegerCurrent Starforce level
maxStarforceintegerMaximum Starforce level
serialFailCountintegerConsecutive failure count
Potential Object
FieldTypeDescription
option1PotentialOptionFirst potential option
option2PotentialOptionSecond potential option
option3PotentialOptionThird potential option
PotentialOption Object
FieldTypeDescription
labelstringOption description (e.g., "STR : +10%")
codeintegerOption code
gradeintegerPotential grade (1: Rare, 2: Epic, 3: Unique, 4: Legendary)
ExtraOption Object
FieldTypeDescription
codestringExtra option code
Interpretation details (values and descriptions) for extra options will be provided in a future update.
ItemStats Object Each stat field is of type ItemStat. ItemStat Object
FieldTypeDescription
totalintegerTotal value (base + enhance + extra)
baseintegerBase value
enhanceintegerStarforce enhancement value
extraintegerExtra option value
FieldTypeDescription
strItemStatSTR
dexItemStatDEX
intItemStatINT
lukItemStatLUK
maxHpItemStatMax HP bonus
maxMpItemStatMax MP bonus
maxHprItemStatMax HP % bonus
maxMprItemStatMax MP % bonus
padItemStatAttack power
pddItemStatPhysical defense
madItemStatMagic attack
bdrItemStatBoss damage (%)
imdrItemStatDefense ignore (%)
damrItemStatDamage % increase
statrItemStatStat % increase
speedItemStatSpeed
jumpItemStatJump
levelReducedintegerEquip level reduction
attackSpeedintegerAttack speed
knockbackintegerKnockback attribute
recoveryHpintegerHP recovery per n seconds when equipped
recoveryMpintegerMP recovery per n seconds when equipped
BeautyAttributes Object (beauty items only)
FieldTypeDescription
baseColorColorCodeBase color code
baseColorPropintegerBase color ratio
mixedColorColorCodeMixed color code
mixedColorPropintegerMixed color ratio
ColorCode Values
ValueDescription
COLOR_CODE_BLACK (0)Black
COLOR_CODE_RED (1)Red
COLOR_CODE_ORANGE (2)Orange
COLOR_CODE_YELLOW (3)Yellow
COLOR_CODE_GREEN (4)Green
COLOR_CODE_BLUE (5)Blue
COLOR_CODE_VIOLET (6)Violet
COLOR_CODE_HAZEL (7)Hazel
COLOR_CODE_SAPPHIRE (8)Sapphire
COLOR_CODE_AMETHYST (9)Amethyst
PetAttributes Object (pet items only)
FieldTypeDescription
petNamestringPet name
petLevelintegerPet level
closenessintegerCloseness
isMultiPetbooleanWhether multi-pet
petSkillintegerEquipped pet skill item ID
petOwnedSkillsPetSkill[]List of owned pet skills
PetSkill Object
FieldTypeDescription
petSkillItemIdintegerPet skill item ID
petSkillNamestringPet skill name
imageUrlstringPet skill image URL
Common Errors
codeDescription
3assetKey or tokenId does not exist

​
ListNftItemHistoryMissions — List Item History Missions

GET /v1rc1/items/{assetKey}/history-missions
GET /v1rc1/items/by-token-id/{tokenId}/history-missions
Returns the list of history missions for an item. Fixed page size of 20. Path Parameters
ParameterTypeDescription
assetKeystringInternal item identifier (assetKey endpoint)
tokenIdstringNFT token ID (by-token-id endpoint)
Query Parameters
ParameterTypeDescription
cursorstringCursor (omit on first request)
Response data
FieldTypeDescription
historyMissionsItemHistoryMission[]List of history missions
nextCursorstringNext page cursor
hasMorebooleanWhether there is a next page

​
ListNftItemHistoryMissionsRepresentative — List Representative Item History Missions

GET /v1rc1/items/{assetKey}/history-missions/representative
GET /v1rc1/items/by-token-id/{tokenId}/history-missions/representative
Returns the list of representative history missions for an item. Fixed page size of 20. Path Parameters
ParameterTypeDescription
assetKeystringInternal item identifier (assetKey endpoint)
tokenIdstringNFT token ID (by-token-id endpoint)
Query Parameters
ParameterTypeDescription
cursorstringCursor (omit on first request)
Response data
FieldTypeDescription
historyMissionsItemHistoryMission[]List of representative history missions
nextCursorstringNext page cursor
hasMorebooleanWhether there is a next page
ItemHistoryMission Object
FieldTypeDescription
itemAssetKeystringAsset key of the item that received the history
historyMissionIdstringAchievement history ID (same as quest ID)
historyMissionTitlestringAchievement history name
characterNamestringNickname of the character that achieved the history
isFirstbooleanWhether it was the first achievement
achievedAtstring (ISO8601)Achievement time