v26.02.12: Weapon Skins, Infinibag and Trading

What's Changed

✨ Features

• View the contents of a player's Infinibag and/or Infinivault.
  • The infinibag and infinivault fields have been added to the Player type.
  • A new type, AssetQuantity has been added to hold an asset and an associated amount.
  • You will only be able to view the Infinibag and Infinivault of players who have toggled the new "Infinibag" API setting.
    The "Collections" API setting has been updated to note that the Infinibag is not part of this setting.
• View all tradable items, and the amount of them that exists in the economy.
  • A new query parameter tradableAssets has been added to view all assets that can be traded, and the amount of these that are owned.
  • This is stored in a new type, TradingData, that holds the asset and the global number owned, using the same display parameters as cosmetics and fish.
    This means that the exact amount is not shown if there are more than 100 of the item owned globally.
  • The global number owned includes items stored in players' Infinivaults.

🔧 Changes

• The uniqueIdentifier for Cosmetic Tokens has been altered so that Weapon Skin holding Cosmetic Tokens will return a different unique identifier for each tier of Weapon Skin. Tier Zero Weapon Skins use the existing unique identifier.
  This change was made to better reflect the internal structures for Weapon Skins, as well as allowing easier differentiation between tiers.
• CosmeticOwnershipState and CosmeticToken now include a new weaponSkinData field.

🐛 Fixes

• Fixed server status for online players returning an error (#56).
  Note that the values returned from the subType field in Server may differ from what they were before. This is due to backend changes relating to how we manage and handle servers. You may notice that the values previously returned by this field are different than before. In the future, we'd like to introduce a more descriptive system that includes more information, such as what fishing island a player is on or what Dojo course a player is running.

Full Changelog: v25.12.11...v26.02.12

v25.12.11: Weapon skin cosmetic categories

What's Changed

This is a small patch release to get the API working after the Battle Box Arena update. If you do encounter other issues, please let us know!

✨ Features

• Added new cosmetic category entries for new weapon skin cosmetics.

Full Changelog: v25.10.08...v25.12.11

v25.10.08: Factions, Quests and Badges

What's Changed

✨ Features

• Badges!
  • A list of all badges can be obtained with the badges query, and player-specific badge progress can be obtained using the badges field on a Player instance.
  • Badge information includes the name, stages, and the goal of the badge.
  • The goal is a union type that is either a specific statistic, or a general goal with a name.
  • The availability of player-specific badges information is tied to the "Statistics" API setting.
• Quests!
  • A list of the players currently active quests can be obtained using the quests field on a Player instance.
  • Quests have a type, rarity, boost type, completion state and tasks.
  • The progress of tasks is stored in the standard ProgressionData type.
  • The availability of quest information is tied to the new "Progression" API setting.
• Factions!
  • Players now have a factions field that returns a list of all factions, their associated progress and if the faction is the currently selected one for a player.
  • The new factionLeaderboard query returns a list of all factions ranked by the global amount of Faction XP earnt for that faction. This information is stored in the new GlobalLeaderboardEntry type.

Full Changelog: v25.09.23...v25.10.08

v25.09.23: Island Exchange and auction listings

What's Changed

✨ Features

• Added queries to fetch active Island Exchange listings and active auctions.
• Added query to fetch the last 24h of sold Island Exchange listings.
  Note that this will only start displaying data from now onwards, and won't show listings sold before this update.
• To represent items that can be sold in the Island Exchange and auctions, a new Asset interface has been added.
  • This represents any item that exists on MCC Island, from Cosmetics to MCC+ Tokens and beyond.
  • Every asset has a name, rarity and a unique identifier that will be consistent for the lifetime of that asset (for example, if we change the name of a cosmetic, it will return the same unique identifier after the change).
  • Some assets are already represented in the API, such as fish and cosmetics. These types implement the new asset interface will be returned in place of the asset where appropriate.
    This means you can use standard GraphQL inline fragments for advanced querying.
  • Two new types of asset have been added:
    • CosmeticToken which provides the cosmetic held in the token using the cosmetic property.
    • SimpleAsset for all other assets that do not have a more concrete type in the API yet.

🔧 Changes

• Fetching the player from a leaderboard entry will now never return null if the rank is <= 10.
  This means the Top 10 of any leaderboard will have no "anonymous" entries.

Full Changelog: v25.08.07...v25.09.23

v25.08.13: Leaderboard and hair bug fixes

What's Changed

🐛 Fixes

• All hair cosmetics now correctly return 0 Trophies.
• Fixed an issue that was causing all leaderboards to be offset by 1.
• Fixed an issue that was causing leaderboards with offsets specified to be cut off past rank 50.

Full Changelog: v25.07.17...v25.08.13

v25.08.07: Leaderboard pagination, Style Level and cosmetic additions

What's Changed

✨ Features

• Added offset parameter to the leaderboard method for statistics (#10).
  This allows you to offset the returned entries by a given number of places. For example, calling the method with an offset of 5 will return values from 6th place onwards. The maximum values of the offset field is currently set to 50.
• Added obtainmentHint to cosmetics (#27).
  This returns same text displayed in the wardrobe when a player has not obtained a cosmetic yet.
• Added styleLevelData on the CrownLevel type to view information about a player's Crown Level (#43).
• Added the CosmeticType enum to display the different types (or tags) for cosmetics (#34). This can be obtained using the type field on cosmetics.
  This also allows you to determine what cosmetics are tradable by checking their type.

🔧 Changes

• The leaderboard method for statistics has been adjusted slightly.
  • The maximum value for amount has been raised to 50.
  • The returned list of leaderboard entries will no longer be capped at amount if there are players who are tied for placement values
    For example, if two players are tied for 10th place and you call the method with an amount of 10, there will be 11 entries returned.
  • A note has been added that the maximum values for both the amount and offset fields may be changed based on performance and user feedback.
• The previously deprecated silver and materialDust fields on Currency have been removed.

🐛 Fixes

• Fixes an issue that was causing Royal Reputation to return the less than it should for some users.

Full Changelog: v25.07.17...v25.08.07

v25.07.17: Post Season 5 bug fixes

This release is a bug fix release that contains the following changes and fixes:

• Removed currencies are now deprecated for removal and will return 0 until removed (#36)
• Fixed an error on fetching server categories (#37)
• Fixed fetching equipped cosmetics returning blank (#39)
• Fixed royal reputation data returning blank (#38)
• Fixed GraphiQL being offline

v25.07.09: Cosmetic Royal Reputation information

What's Changed

✨ Features

• Added RoyalReputation type, accessible from royalReputation on Cosmetic.
  • Will return null if the cosmetic cannot be donated, mirroring canBeDonated.
  • Provides two fields, donationLimit and reputationAmount for accessing data about how many of the cosmetic can be donated and how much reputation is granted for each donation respectively.

Full Changelog: v25.03.13...v25.07.09

v25.03.13: Cosmetic description

What's Changed

✨ Features

• Added description to Cosmetic.

Full Changelog: v25.02.10...v25.03.13

v25.02.10: Global fish/cosmetic data and fish selling price

What's Changed

✨ Features

• Added sellingPrice method to Fish to allow querying the number of A.N.G.L.R. Tokens a fish with a given weight sells for.
• Added methods/fields to query the global state of fish and cosmetics.
  Both of these methods return a String containing the number of players who own this cosmetic. If this number is over 10000 or 1000 then the value returned will be 10000+ and 1000+ respectively.
  • Added globalNumberCaught method to Fish to allow querying the total number of players who have caught this fish with a given weight.
  • Added globalNumberOwned field to Cosmetic to allow querying the total number of players who own this cosmetic.
    • Some cosmetics are excluded from ownership reporting.

🔧 Changes

• The previously deprecated level, evolution, nextEvolutionLevel and nextLevelProgress fields in CrownLevel have been removed.
• The previously deprecated gems field in Currency has been removed.

Full Changelog: v24.12.04...v24.12.17