MapleStory Universe

Read MapleStory Universe, Nexon's blockchain MapleStory ecosystem, through its Open API: a wallet's NESO, currencies, NFT collections, items and characters; a character's stats, inventory, skills, V-Matrix, quests and history; an NFT item's details and history; the game's item, quest, skill and V-Matrix metadata and the going price of Star Force and Potential enhancement; the marketplace's items, characters and nicknames for sale, with keyword suggestions and valuations; and MapleStory N's reward and raffle data. Read-only, with a builder's API key.

Actions

Action	What it does
Explore characters for sale	The NFT characters listed for sale on the marketplace, a page at a time, filtered by name, class, job, attack power, price and level, and sorted.
Explore items for sale	The NFT items listed for sale on the marketplace, a page at a time, filtered by name, item, category, class, colour, price, level, Star Force and Potential, and sorted.
Explore nicknames for sale	The nickname NFTs listed for sale on the marketplace, a page at a time, filtered by text, length, make-up and price, and sorted.
Get asset valuation	What one asset, or copies of one item, traded for over the last 30, 90 or 180 days: the average price and how many trades.
Get character	One character in full: its stats, equipped gear, abilities and the rest of what MSU records, by asset key or token ID.
Get character raffle history	How a character fared in a MapleStory N reward draw, up to 30 days after it, for the wallet that holds it.
Get character raffles	The MapleStory N reward raffles a character is entered in, before the draw, for the wallet that holds it.
Get character V-Matrix	A character's V-Matrix: its matrix points, V-Core shards, and the slots and nodes set in it, by asset key or token ID.
Get enhancement prices	What enhancing an item costs right now, by level: Star Force and Potential, from the item's id.
Get item category	Where an item id sits in MSU's category tree: its category number and label, and the labels of each tier above it.
Get item metadata	The game's own data for an item id: its name, stats, requirements and the rest, the same for every copy of the item.
Get item set	The set an item id belongs to and the effects the set gives.
Get item valuation	What copies of an item traded for over the last 30, 90 or 180 days: the lower and upper average prices and how many trades.
Get layer static data	The fixed facts about MapleStory N's reward layers: each field, boss or content's name and level range.
Get NESO balance	How much NESO a wallet holds, on chain and off, and the two added together.
Get NFT item	One NFT item in full: its stats, Star Force, Potential and the rest of what MSU records, by asset key or token ID.
Get quest metadata	The game's own data for a quest id: its name, requirements and rewards.
Get reward history	What a MapleStory N reward draw gave out in a world, by layer, up to 30 days after the draw.
Get reward information	MapleStory N's NFT drop rates and what is left to drop in a world, by field, boss or content layer.
Get server info	MapleStory N's reward servers: each world's id, name and state, for the worlds asked about or all of them.
Get skill metadata	The game's own data for a skill id, at a given level if wanted.
Get V-Matrix node	A V-Matrix node's name, description, picture and the skills it holds, at a given level if wanted.
List character history missions	A character's history missions, the record of what it has done (levels, job advancements, bosses, minting and more), twenty a page, filtered by category if wanted.
List character items	The items in a character's inventory, twenty a page, by asset key or token ID, filtered by category if wanted.
List character quests	A character's quests and how far it has got with each, by asset key or token ID.
List character skills	A character's skills, or its hyper skills, with each one's level, by asset key or token ID.
List exclusive items	The items that cannot be equipped at the same time as a given item id.
List NFT item history missions	An NFT item's history missions, the record of what has been done with it, twenty a page: all of them, or only the representative ones MSU picks out.
List wallet characters	The characters linked to a wallet, a page at a time, filtered by name or whether they can be traded.
List wallet collections	The NFT collections a wallet holds, a page at a time.
List wallet currencies	The in-game currencies linked to a wallet and the balance of each, as MSU defines them.
List wallet items	The items a wallet holds, a page at a time, filtered by category, whether they are up for sale, name or token ID.
Suggest keywords	Autocomplete suggestions for a marketplace search: the item, character or user names that start like a keyword of two characters or more.

Explore characters for sale

The NFT characters listed for sale on the marketplace, a page at a time, filtered by name, class, job, attack power, price and level, and sorted.

Inputs

Namenametext: Optional: only characters whose name contains this (matching case).
Classcharacter_classtext: Optional: only characters of one class.One of: warrior, magician, bowman, thief, pirate, all_classes (All classes).
Jobjobtext: Optional: only characters of one job, in MSU's spelling, such as bishop, dark_knight or night_walker; every advancement of the job is included.
Lowest attack powermin_attack_powernumber: Optional: only characters with at least this attack power.At least 1.
Lowest priceprice_minnumber: Optional: only listings at this many NESO or more.At least 0.
Highest priceprice_maxnumber: Optional: only listings at this many NESO or less.At least 0.
Lowest levellevel_minnumber: Optional: only listings at this level or above.At least 0.
Highest levellevel_maxnumber: Optional: only listings at this level or below.At least 0.
Sort bysortingtext: Optional: the order the listings come back in.One of: highest_price (Highest price), lowest_price (Lowest price), ending_soon (Ending soon), recently_listed (Recently listed), highest_attack_power (Highest attack power).
Pagepagenumber: Which page of results, counting from 1.At least 1. Default: 1.
Page sizepage_sizenumber: How many listings a page holds. MSU's default is 30, and a page may not start past listing 10,000.From 1 to 10000. Default: 30.
Seller's walletwallet_addresstext: Optional: only listings from this wallet address, 0x followed by forty hex digits.

Outputs

characterslist: The listings on this page.
countnumber: How many listings came back.
is_last_pagetrue/false: True when there is no page after this one.
pagenumber: The page this is.
page_sizenumber: How many a page holds.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many listings match in all, across every page.

Example output

{
  "characters": [
    {
      "assetKey": "c_9f1e2d3c4b5a6978",
      "class": "magician",
      "isTradable": true,
      "job": "bishop",
      "level": 215,
      "name": "Mapler",
      "price": "250000",
      "sellerAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234",
      "tokenId": "128934",
      "worldId": 1
    }
  ],
  "count": 1,
  "is_last_page": true,
  "page": 1,
  "page_size": 30,
  "status": "success",
  "total_count": 1
}

Explore items for sale

The NFT items listed for sale on the marketplace, a page at a time, filtered by name, item, category, class, colour, price, level, Star Force and Potential, and sorted.

Inputs

Namenametext: Optional: only items whose name contains this (matching case).
Item IDitem_idnumber: Optional: only copies of one item, by the game's item id.At least 0.
Category numbercategory_nonumber: Optional: only items in one of MSU's item categories, by its number (Get item category gives an item's). Leave empty for every category.At least 0.
Minting numberminting_nonumber: Optional: only the copy with this minting number.At least 0.
Classesclassestext: Optional: only items a chosen class can use.One or more of: warrior, magician, bowman, thief, pirate, all_classes (All classes).
Achieved by characterachieved_character_nametext: Optional: only items whose history was made by this character, by its exact name.
Colourscolorstext: Optional: for beauty and hair items, only these colours.One or more of: black, red, orange, yellow, green, blue, violet, hazel, sapphire, amethyst, all_colors (All colours).
Pet skillspet_skillslist: Optional: for pets, only ones with any of these skill codes.
Lowest priceprice_minnumber: Optional: only listings at this many NESO or more.At least 0.
Highest priceprice_maxnumber: Optional: only listings at this many NESO or less.At least 0.
Lowest levellevel_minnumber: Optional: only listings at this level or above.At least 0.
Highest levellevel_maxnumber: Optional: only listings at this level or below.At least 0.
Lowest Star Forcestarforce_minnumber: Optional: only items with at least this many stars, 0 to 25.From 0 to 25.
Highest Star Forcestarforce_maxnumber: Optional: only items with at most this many stars, 0 to 25.From 0 to 25.
Lowest Potentialpotential_minnumber: Optional: only items with at least this Potential grade: 0 Normal, 1 Rare, 2 Epic, 3 Unique, 4 Legendary.From 0 to 4.
Highest Potentialpotential_maxnumber: Optional: only items with at most this Potential grade, 0 to 4.From 0 to 4.
Lowest Bonus Potentialbonus_potential_minnumber: Optional: only items with at least this Bonus Potential grade, 0 to 4.From 0 to 4.
Highest Bonus Potentialbonus_potential_maxnumber: Optional: only items with at most this Bonus Potential grade, 0 to 4.From 0 to 4.
Sort bysortingtext: Optional: the order the listings come back in.One of: highest_price (Highest price), lowest_price (Lowest price), ending_soon (Ending soon), recently_listed (Recently listed).
Pagepagenumber: Which page of results, counting from 1.At least 1. Default: 1.
Page sizepage_sizenumber: How many listings a page holds. MSU's default is 30, and a page may not start past listing 10,000.From 1 to 10000. Default: 30.
Seller's walletwallet_addresstext: Optional: only listings from this wallet address, 0x followed by forty hex digits.

Outputs

countnumber: How many listings came back.
is_last_pagetrue/false: True when there is no page after this one.
itemslist: The listings on this page.
pagenumber: The page this is.
page_sizenumber: How many a page holds.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many listings match in all, across every page.

Example output

{
  "count": 2,
  "is_last_page": false,
  "items": [
    {
      "assetKey": "i_a1b2c3d4e5f60718",
      "categoryNo": 100,
      "itemId": 1003797,
      "mintingNo": 17,
      "name": "Zakum Helmet",
      "potentialGrade": 2,
      "price": "15000",
      "sellerAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234",
      "starforce": 12,
      "tokenId": "558201"
    },
    {
      "assetKey": "i_0f9e8d7c6b5a4932",
      "categoryNo": 107,
      "itemId": 1072344,
      "mintingNo": 3,
      "name": "Facestompers",
      "potentialGrade": 1,
      "price": "9800",
      "sellerAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234",
      "starforce": 8,
      "tokenId": "558244"
    }
  ],
  "page": 1,
  "page_size": 30,
  "status": "success",
  "total_count": 412
}

Explore nicknames for sale

The nickname NFTs listed for sale on the marketplace, a page at a time, filtered by text, length, make-up and price, and sorted.

Inputs

Namenametext: Optional: only nicknames containing this (any case).
Lengthsname_lengthslist: Optional: only nicknames of these lengths, one number per entry.
Lowest priceprice_minnumber: Optional: only listings at this many NESO or more.At least 0.
Highest priceprice_maxnumber: Optional: only listings at this many NESO or less.At least 0.
Made ofcharacter_setstext: Optional: only nicknames made of letters, of digits, or of both.One or more of: alphabet_only (Letters only), numeric_only (Digits only), mixed (Letters and digits).
Sort bysortingtext: Optional: the order the listings come back in.One of: highest_price (Highest price), lowest_price (Lowest price), ending_soon (Ending soon), recently_listed (Recently listed).
Pagepagenumber: Which page of results, counting from 1.At least 1. Default: 1.
Page sizepage_sizenumber: How many listings a page holds. MSU's default is 30, and a page may not start past listing 10,000.From 1 to 10000. Default: 30.
Seller's walletwallet_addresstext: Optional: only listings from this wallet address, 0x followed by forty hex digits.

Outputs

countnumber: How many listings came back.
is_last_pagetrue/false: True when there is no page after this one.
nicknameslist: The listings on this page.
pagenumber: The page this is.
page_sizenumber: How many a page holds.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many listings match in all, across every page.

Example output

{
  "count": 2,
  "is_last_page": false,
  "nicknames": [
    {
      "nickname": "Maple",
      "price": "80000",
      "sellerAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234",
      "tokenId": "9001"
    },
    {
      "nickname": "Orbis7",
      "price": "12000",
      "sellerAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234",
      "tokenId": "9002"
    }
  ],
  "page": 1,
  "page_size": 30,
  "status": "success",
  "total_count": 412
}

Get asset valuation

What one asset, or copies of one item, traded for over the last 30, 90 or 180 days: the average price and how many trades.

Inputs

Asset keyasset_keytext: The asset's key. Give this or an item ID.
Item IDitem_idnumber: The game's item id. Give this or an asset key.At least 0.
Periodperiodtext: How far back the trades go: 30, 90 (the default) or 180 days.One of: 30 (30 days), 90 (90 days), 180 (180 days). Default: 90.

Outputs

asset_keytext: The asset key asked about, or ''.
average_pricenumber: The average price traded at, in NESO.
datetext: The date the figures were worked out for.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
item_idnumber: The item id asked about, or null.
notetext: Why nothing was found, or '' when something was.
period_daysnumber: How many days back the trades go.
statustext: Status of the action execution ("success" on success).
trade_countnumber: How many trades there were in the period.

Example output

{
  "asset_key": "",
  "average_price": 14250.5,
  "date": "2026-10-09",
  "found": true,
  "item_id": 1003797,
  "note": "",
  "period_days": 90,
  "status": "success",
  "trade_count": 37
}

Get character

One character in full: its stats, equipped gear, abilities and the rest of what MSU records, by asset key or token ID.

Inputs

CharactercharactertextRequired: The character's asset key, or its token ID when Look up by says so, or a character record from an earlier step such as List wallet characters or Explore characters for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.

Outputs

characterobject: The character as MSU records it: stats, equipped gear, abilities and more. Empty when not found.
character_keytext: The character's key as given.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
lookuptext: How the key was read: asset_key or token_id.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).

Example output

{
  "character": {
    "assetKey": "c_9f1e2d3c4b5a6978",
    "attackPower": 1250000,
    "class": "magician",
    "exp": "1284930012",
    "isTradable": true,
    "job": "bishop",
    "level": 215,
    "name": "Mapler",
    "tokenId": "128934",
    "walletAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234",
    "worldId": 1
  },
  "character_key": "c_9f1e2d3c4b5a6978",
  "found": true,
  "lookup": "asset_key",
  "note": "",
  "status": "success"
}

Get character raffle history

How a character fared in a MapleStory N reward draw, up to 30 days after it, for the wallet that holds it.

Inputs

Character asset keycharacter_asset_keytextRequired: The character's asset key, or a character record from an earlier step.
Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.
Draw timeraffled_atdate and timeRequired: When the reward draw was held. MSU keeps a draw's history for 30 days after it.

Outputs

character_asset_keytext: The character's asset key.
countnumber: How many raffle results came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
historieslist: One record per raffle result.
notetext: Why nothing was found, or '' when something was.
raffled_attext: The draw time asked about, as an ISO 8601 UTC instant.
statustext: Status of the action execution ("success" on success).
updated_attext: When MSU last updated the figures.
wallet_addresstext: The wallet address asked about.

Example output

{
  "character_asset_key": "c_9f1e2d3c4b5a6978",
  "count": 1,
  "found": true,
  "histories": [
    {
      "itemId": 1003797,
      "layerId": 501,
      "layerName": "Zakum",
      "won": true
    }
  ],
  "note": "",
  "raffled_at": "2026-10-08T00:00:00Z",
  "status": "success",
  "updated_at": "2026-10-09T06:00:00Z",
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

Get character raffles

The MapleStory N reward raffles a character is entered in, before the draw, for the wallet that holds it.

Inputs

Character asset keycharacter_asset_keytextRequired: The character's asset key, or a character record from an earlier step.
Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.

Outputs

character_asset_keytext: The character's asset key.
countnumber: How many raffles came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
notetext: Why nothing was found, or '' when something was.
raffleslist: One record per raffle.
statustext: Status of the action execution ("success" on success).
updated_attext: When MSU last updated the figures.
wallet_addresstext: The wallet address asked about.

Example output

{
  "character_asset_key": "c_9f1e2d3c4b5a6978",
  "count": 1,
  "found": true,
  "note": "",
  "raffles": [
    {
      "layerId": 501,
      "layerName": "Zakum",
      "raffledAt": "2026-10-10T00:00:00Z",
      "tickets": 4
    }
  ],
  "status": "success",
  "updated_at": "2026-10-09T06:00:00Z",
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

Get character V-Matrix

A character's V-Matrix: its matrix points, V-Core shards, and the slots and nodes set in it, by asset key or token ID.

Inputs

CharactercharactertextRequired: The character's asset key, or its token ID when Look up by says so, or a character record from an earlier step such as List wallet characters or Explore characters for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.

Outputs

character_keytext: The character's key as given.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
lookuptext: How the key was read: asset_key or token_id.
matrix_pointsnumber: The matrix points the character has to spend.
node_countnumber: How many nodes came back.
nodeslist: The V-Matrix nodes.
notetext: Why nothing was found, or '' when something was.
slot_countnumber: How many slots came back.
slotslist: The V-Matrix slots.
statustext: Status of the action execution ("success" on success).
vcore_shardsnumber: How many V-Core shards the character holds.

Example output

{
  "character_key": "c_9f1e2d3c4b5a6978",
  "found": true,
  "lookup": "asset_key",
  "matrix_points": 12,
  "node_count": 2,
  "nodes": [
    {
      "level": 25,
      "name": "Angel Ray Boost",
      "nodeId": 50001
    },
    {
      "level": 20,
      "name": "Genesis Boost",
      "nodeId": 50004
    }
  ],
  "note": "",
  "slot_count": 2,
  "slots": [
    {
      "level": 25,
      "nodeId": 50001,
      "slotId": 1
    },
    {
      "level": 20,
      "nodeId": 50004,
      "slotId": 2
    }
  ],
  "status": "success",
  "vcore_shards": 340
}

Get enhancement prices

What enhancing an item costs right now, by level: Star Force and Potential, from the item's id. The prices move with the market.

Inputs

Item IDitem_idnumberRequired: The game's numeric id for the item, such as 1003797, which an NFT item carries as itemId. Every copy of an item shares it.At least 0.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
item_idnumber: The item id asked about.
notetext: Why nothing was found, or '' when something was.
potentialobject: The Potential prices by level, as MSU records them. Empty when not found.
starforceobject: The Star Force prices by level, as MSU records them. Empty when not found.
statustext: Status of the action execution ("success" on success).

Example output

{
  "found": true,
  "item_id": 1003797,
  "note": "",
  "potential": {
    "1": {
      "currentPrice": {
        "price": "5000",
        "step": "1"
      }
    }
  },
  "starforce": {
    "1": {
      "currentPrice": {
        "price": "1200",
        "step": "1"
      }
    },
    "2": {
      "currentPrice": {
        "price": "1800",
        "step": "2"
      }
    }
  },
  "status": "success"
}

Get item category

Where an item id sits in MSU's category tree: its category number and label, and the labels of each tier above it.

Inputs

Item IDitem_idnumberRequired: The game's numeric id for the item, such as 1003797, which an NFT item carries as itemId. Every copy of an item shares it.At least 0.

Outputs

categoryobject: The whole category record as MSU sends it, with each tier's label and code. Empty when not found.
category_nonumber: The category's number, as the item filters take it.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
item_idnumber: The item id asked about.
labeltext: The category's label.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).
tier_labelslist: The labels of the category's tiers, broadest first: NFT, FT or Character, then the major, mid and minor classifications.

Example output

{
  "category": {
    "categoryNo": 100,
    "label": "Hat",
    "tier0": {
      "code": "nft",
      "label": "NFT"
    },
    "tier1": {
      "code": "equip",
      "label": "Equip"
    },
    "tier2": {
      "code": "armor",
      "label": "Armor"
    },
    "tier3": {
      "code": "hat",
      "label": "Hat"
    }
  },
  "category_no": 100,
  "found": true,
  "item_id": 1003797,
  "label": "Hat",
  "note": "",
  "status": "success",
  "tier_labels": [
    "NFT",
    "Equip",
    "Armor",
    "Hat"
  ]
}

Get item metadata

The game's own data for an item id: its name, stats, requirements and the rest, the same for every copy of the item.

Inputs

Item IDitem_idnumberRequired: The game's numeric id for the item, such as 1003797, which an NFT item carries as itemId. Every copy of an item shares it.At least 0.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
itemobject: The item's metadata as MSU records it. Empty when not found.
item_idnumber: The item id asked about.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).

Example output

{
  "found": true,
  "item": {
    "categoryNo": 100,
    "description": "A helmet dropped by Zakum.",
    "itemId": 1003797,
    "name": "Zakum Helmet",
    "requiredLevel": 50
  },
  "item_id": 1003797,
  "note": "",
  "status": "success"
}

Get item set

The set an item id belongs to and the effects the set gives.

Inputs

Item IDitem_idnumberRequired: The game's numeric id for the item, such as 1003797, which an NFT item carries as itemId. Every copy of an item shares it.At least 0.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
item_idnumber: The item id asked about.
item_setobject: The set as MSU records it: its name, its items and its effects. Empty when not found.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).

Example output

{
  "found": true,
  "item_id": 1003797,
  "item_set": {
    "effects": [
      {
        "count": 2,
        "description": "STR +10"
      }
    ],
    "itemIds": [
      1003797,
      1052013
    ],
    "name": "Zakum Set",
    "setId": 12
  },
  "note": "",
  "status": "success"
}

Get item valuation

What copies of an item traded for over the last 30, 90 or 180 days: the lower and upper average prices and how many trades.

Inputs

Item IDitem_idnumberRequired: The game's numeric id for the item, such as 1003797, which an NFT item carries as itemId. Every copy of an item shares it.At least 0.
Periodperiodtext: How far back the trades go: 30, 90 (the default) or 180 days.One of: 30 (30 days), 90 (90 days), 180 (180 days). Default: 90.

Outputs

average_bottom_pricenumber: The lower average price, in NESO.
average_top_pricenumber: The upper average price, in NESO.
datetext: The date the figures were worked out for.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
item_idnumber: The item id asked about.
notetext: Why nothing was found, or '' when something was.
period_daysnumber: How many days back the trades go.
statustext: Status of the action execution ("success" on success).
trade_countnumber: How many trades there were in the period.

Example output

{
  "average_bottom_price": 9800,
  "average_top_price": 21000,
  "date": "2026-10-09",
  "found": true,
  "item_id": 1003797,
  "note": "",
  "period_days": 90,
  "status": "success",
  "trade_count": 37
}

Get layer static data

The fixed facts about MapleStory N's reward layers: each field, boss or content's name and level range.

Inputs

Layer IDslayer_idslist: Optional: the reward layers (fields, bosses or contents) to ask about, by numeric id, one per entry. Get layer static data names them.
Layer typeslayer_typestext: Optional: whole kinds of reward layer to ask about, instead of or as well as layer IDs.One or more of: field (Fields), boss (Bosses), contents.

Outputs

countnumber: How many layers came back.
expires_attext: When MSU says these facts should be fetched again.
layerslist: One record per layer.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 2,
  "expires_at": "2026-10-10T00:00:00Z",
  "layers": [
    {
      "layerId": 101,
      "layerName": "Henesys Hunting Ground",
      "layerType": "LAYER_TYPE_FIELD",
      "maxLevel": 30,
      "minLevel": 10
    },
    {
      "layerId": 501,
      "layerName": "Zakum",
      "layerType": "LAYER_TYPE_BOSS",
      "maxLevel": 200,
      "minLevel": 50
    }
  ],
  "status": "success"
}

Get NESO balance

How much NESO a wallet holds, on chain and off, and the two added together. NESO is the currency MSU's marketplace trades in.

Inputs

Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
notetext: Why nothing was found, or '' when something was.
offchain_nesonumber: The NESO held off chain, in MSU's own ledger.
onchain_nesonumber: The NESO held on chain, in the wallet itself.
statustext: Status of the action execution ("success" on success).
total_nesonumber: The two balances added together.
wallet_addresstext: The wallet address asked about.

Example output

{
  "found": true,
  "note": "",
  "offchain_neso": 15200,
  "onchain_neso": 4300.5,
  "status": "success",
  "total_neso": 19500.5,
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

Get NFT item

One NFT item in full: its stats, Star Force, Potential and the rest of what MSU records, by asset key or token ID.

Inputs

NFT itemitemtextRequired: The NFT item's asset key, or its token ID when Look up by says so, or an item record from an earlier step such as List wallet items or Explore items for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
itemobject: The item as MSU records it: stats, enhancement, potential and more. Empty when not found.
item_keytext: The item's key as given.
lookuptext: How the key was read: asset_key or token_id.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).

Example output

{
  "found": true,
  "item": {
    "assetKey": "i_a1b2c3d4e5f60718",
    "categoryNo": 100,
    "itemId": 1003797,
    "mintingNo": 17,
    "name": "Zakum Helmet",
    "potentialGrade": 2,
    "starforce": 12,
    "tokenId": "558201",
    "walletAddress": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
  },
  "item_key": "i_a1b2c3d4e5f60718",
  "lookup": "asset_key",
  "note": "",
  "status": "success"
}

Get quest metadata

The game's own data for a quest id: its name, requirements and rewards.

Inputs

Quest IDquest_idnumberRequired: The game's numeric id for the quest, as a character's quests carry it.At least 0.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
notetext: Why nothing was found, or '' when something was.
questobject: The quest's metadata as MSU records it. Empty when not found.
quest_idnumber: The quest id asked about.
statustext: Status of the action execution ("success" on success).

Example output

{
  "found": true,
  "note": "",
  "quest": {
    "name": "The Zakum Expedition",
    "questId": 2350,
    "requiredLevel": 50,
    "rewardExp": 120000
  },
  "quest_id": 2350,
  "status": "success"
}

Get reward history

What a MapleStory N reward draw gave out in a world, by layer, up to 30 days after the draw.

Inputs

World IDworld_idnumberRequired: The MapleStory N world, by its numeric id (Get server info lists them).At least 0.
Draw timeraffled_atdate and timeRequired: When the reward draw was held. MSU keeps a draw's history for 30 days after it.
Layer IDslayer_idslist: Optional: the reward layers (fields, bosses or contents) to ask about, by numeric id, one per entry. Get layer static data names them.
Layer typeslayer_typestext: Optional: whole kinds of reward layer to ask about, instead of or as well as layer IDs.One or more of: field (Fields), boss (Bosses), contents.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
historiesobject: The draw's results by layer, as MSU records them. Empty when not found.
notetext: Why nothing was found, or '' when something was.
raffled_attext: The draw time asked about, as an ISO 8601 UTC instant.
statustext: Status of the action execution ("success" on success).
updated_attext: When MSU last updated the figures.
world_idnumber: The world asked about.

Example output

{
  "found": true,
  "histories": {
    "101": {
      "itemId": 1003797,
      "layerName": "Henesys Hunting Ground",
      "winners": 3
    }
  },
  "note": "",
  "raffled_at": "2026-10-08T00:00:00Z",
  "status": "success",
  "updated_at": "2026-10-09T06:00:00Z",
  "world_id": 1
}

Get reward information

MapleStory N's NFT drop rates and what is left to drop in a world, by field, boss or content layer.

Inputs

World IDworld_idnumberRequired: The MapleStory N world, by its numeric id (Get server info lists them).At least 0.
Layer IDslayer_idslist: Optional: the reward layers (fields, bosses or contents) to ask about, by numeric id, one per entry. Get layer static data names them.
Layer typeslayer_typestext: Optional: whole kinds of reward layer to ask about, instead of or as well as layer IDs.One or more of: field (Fields), boss (Bosses), contents.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
notetext: Why nothing was found, or '' when something was.
rewardsobject: The reward information by layer, as MSU records it: drop rates and stock. Empty when not found.
statustext: Status of the action execution ("success" on success).
updated_attext: When MSU last updated the figures.
world_idnumber: The world asked about.

Example output

{
  "found": true,
  "note": "",
  "rewards": {
    "101": {
      "dropRate": 0.015,
      "layerName": "Henesys Hunting Ground",
      "remaining": 42
    }
  },
  "status": "success",
  "updated_at": "2026-10-09T06:00:00Z",
  "world_id": 1
}

Get server info

MapleStory N's reward servers: each world's id, name and state, for the worlds asked about or all of them.

Inputs

World IDsworld_idslist: Optional: only these worlds, by numeric id, one per entry.

Outputs

countnumber: How many worlds came back.
serverslist: One record per world.
statustext: Status of the action execution ("success" on success).
world_idslist: The world ids asked about; empty for all.

Example output

{
  "count": 2,
  "servers": [
    {
      "serverState": "SERVER_STATE_OPEN",
      "worldId": 1,
      "worldName": "Henesys"
    },
    {
      "serverState": "SERVER_STATE_OPEN",
      "worldId": 2,
      "worldName": "Orbis"
    }
  ],
  "status": "success",
  "world_ids": []
}

Get skill metadata

The game's own data for a skill id, at a given level if wanted.

Inputs

Skill IDskill_idnumberRequired: The game's numeric id for the skill, as a character's skills carry it.At least 0.
Levellevelnumber: Optional: the skill level to describe.At least 0.

Outputs

foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
levelnumber: The level asked about, or null for none.
notetext: Why nothing was found, or '' when something was.
skillobject: The skill's metadata as MSU records it. Empty when not found.
skill_idnumber: The skill id asked about.
statustext: Status of the action execution ("success" on success).

Example output

{
  "found": true,
  "level": 30,
  "note": "",
  "skill": {
    "description": "Fires a ray of holy light.",
    "maxLevel": 30,
    "name": "Angel Ray",
    "skillId": 2321007
  },
  "skill_id": 2321007,
  "status": "success"
}

Get V-Matrix node

A V-Matrix node's name, description, picture and the skills it holds, at a given level if wanted.

Inputs

Node IDnode_idnumberRequired: The V-Matrix node's numeric id, as a character's V-Matrix carries it.At least 0.
Levellevelnumber: Optional: the node level to describe.At least 0.
Skill IDsskill_idslist: Optional: only these skills of the node, by id, one per entry.

Outputs

countnumber: How many skills came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
node_descriptiontext: What the node does.
node_idnumber: The node's id.
node_image_urltext: A link to the node's picture.
node_levelnumber: The level described, or null when MSU gave none.
node_nametext: The node's name.
notetext: Why nothing was found, or '' when something was.
skillslist: The skills the node holds.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 1,
  "found": true,
  "node_description": "Boosts Angel Ray.",
  "node_id": 50001,
  "node_image_url": "https://cdn.msu.io/vmatrix/50001.png",
  "node_level": 25,
  "node_name": "Angel Ray Boost",
  "note": "",
  "skills": [
    {
      "level": 25,
      "name": "Angel Ray",
      "skillId": 2321007
    }
  ],
  "status": "success"
}

List character history missions

A character's history missions, the record of what it has done (levels, job advancements, bosses, minting and more), twenty a page, filtered by category if wanted.

Inputs

CharactercharactertextRequired: The character's asset key, or its token ID when Look up by says so, or a character record from an earlier step such as List wallet characters or Explore characters for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.
Categorymain_categorytext: Optional: only missions of one kind.One of: character, item, adventure, battle, blockchain, social.
Sub-categorysub_categorytext: Optional: only missions of one narrower kind.One of: character_level (Character: level), character_job_advancement (Character: job advancement), character_ability (Character: ability), item_reward (Item: reward), item_star_force (Item: Star Force), item_potential (Item: Potential), item_bonus_stat (Item: bonus stat), adventure_regional_quest (Adventure: regional quest), adventure_party_quest (Adventure: party quest), battle_field (Battle: field), and 4 more.
Cursorcursortext: Optional: the next_cursor from the previous page of this step, to get the page after it. Leave empty for the first page.

Outputs

character_keytext: The character's key as given.
countnumber: How many history missions came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
has_moretrue/false: True when there is another page of history missions.
history_missionslist: The history missions, as MSU records them.
lookuptext: How the key was read: asset_key or token_id.
main_categorytext: The category filtered by, as MSU spells it, or ''.
next_cursortext: The cursor for the next page of history missions, to give this step as Cursor; '' on the last page.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).
sub_categorytext: The sub-category filtered by, as MSU spells it, or ''.

Example output

{
  "character_key": "c_9f1e2d3c4b5a6978",
  "count": 2,
  "found": true,
  "has_more": false,
  "history_missions": [
    {
      "achievedAt": "2026-09-30T12:00:00Z",
      "missionId": 7001,
      "name": "Defeated Zakum"
    },
    {
      "achievedAt": "2026-10-02T18:30:00Z",
      "missionId": 7002,
      "name": "Defeated Horntail"
    }
  ],
  "lookup": "asset_key",
  "main_category": "HISTORY_MISSION_MAIN_CATEGORY_BATTLE",
  "next_cursor": "",
  "note": "",
  "status": "success",
  "sub_category": ""
}

List character items

The items in a character's inventory, twenty a page, by asset key or token ID, filtered by category if wanted.

Inputs

CharactercharactertextRequired: The character's asset key, or its token ID when Look up by says so, or a character record from an earlier step such as List wallet characters or Explore characters for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.
Category numbercategory_nonumber: Optional: only items in one of MSU's item categories, by its number (Get item category gives an item's). Leave empty for every category.At least 0.
Cursorcursortext: Optional: the next_cursor from the previous page of this step, to get the page after it. Leave empty for the first page.

Outputs

character_keytext: The character's key as given.
countnumber: How many items came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
has_moretrue/false: True when there is another page of items.
itemslist: The items on this page.
lookuptext: How the key was read: asset_key or token_id.
next_cursortext: The cursor for the next page of items, to give this step as Cursor; '' on the last page.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).

Example output

{
  "character_key": "c_9f1e2d3c4b5a6978",
  "count": 2,
  "found": true,
  "has_more": true,
  "items": [
    {
      "assetKey": "i_a1b2c3d4e5f60718",
      "categoryNo": 100,
      "itemId": 1003797,
      "mintingNo": 17,
      "name": "Zakum Helmet",
      "potentialGrade": 2,
      "starforce": 12,
      "tokenId": "558201"
    },
    {
      "assetKey": "i_0f9e8d7c6b5a4932",
      "categoryNo": 107,
      "itemId": 1072344,
      "mintingNo": 3,
      "name": "Facestompers",
      "potentialGrade": 1,
      "starforce": 8,
      "tokenId": "558244"
    }
  ],
  "lookup": "asset_key",
  "next_cursor": "eyJvZmZzZXQiOjIwfQ",
  "note": "",
  "status": "success"
}

List character quests

A character's quests and how far it has got with each, by asset key or token ID.

Inputs

CharactercharactertextRequired: The character's asset key, or its token ID when Look up by says so, or a character record from an earlier step such as List wallet characters or Explore characters for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.

Outputs

character_keytext: The character's key as given.
countnumber: How many quests came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
lookuptext: How the key was read: asset_key or token_id.
notetext: Why nothing was found, or '' when something was.
questslist: The quests, one record each.
statustext: Status of the action execution ("success" on success).

Example output

{
  "character_key": "c_9f1e2d3c4b5a6978",
  "count": 2,
  "found": true,
  "lookup": "asset_key",
  "note": "",
  "quests": [
    {
      "name": "Welcome to Maple World",
      "questId": 1000,
      "status": "COMPLETED"
    },
    {
      "name": "The Zakum Expedition",
      "questId": 2350,
      "status": "IN_PROGRESS"
    }
  ],
  "status": "success"
}

List character skills

A character's skills, or its hyper skills, with each one's level, by asset key or token ID.

Inputs

CharactercharactertextRequired: The character's asset key, or its token ID when Look up by says so, or a character record from an earlier step such as List wallet characters or Explore characters for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.
Skillsskill_typetext: The ordinary skills (the default) or the hyper skills.One of: skills, hyper (Hyper skills). Default: skills.

Outputs

character_keytext: The character's key as given.
countnumber: How many skills came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
lookuptext: How the key was read: asset_key or token_id.
notetext: Why nothing was found, or '' when something was.
skill_typetext: What was listed: skills or hyper.
skillslist: The skills, one record each.
statustext: Status of the action execution ("success" on success).

Example output

{
  "character_key": "c_9f1e2d3c4b5a6978",
  "count": 2,
  "found": true,
  "lookup": "asset_key",
  "note": "",
  "skill_type": "skills",
  "skills": [
    {
      "level": 30,
      "name": "Angel Ray",
      "skillId": 2321007
    },
    {
      "level": 30,
      "name": "Genesis",
      "skillId": 2321003
    }
  ],
  "status": "success"
}

List exclusive items

The items that cannot be equipped at the same time as a given item id.

Inputs

Item IDitem_idnumberRequired: The game's numeric id for the item, such as 1003797, which an NFT item carries as itemId. Every copy of an item shares it.At least 0.

Outputs

countnumber: How many items came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
item_idnumber: The item id asked about.
itemslist: The items that cannot be worn with it.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 2,
  "found": true,
  "item_id": 1003797,
  "items": [
    {
      "itemId": 1004422,
      "name": "Royal Von Leon Helmet"
    },
    {
      "itemId": 1003976,
      "name": "Chaos Zakum Helmet"
    }
  ],
  "note": "",
  "status": "success"
}

List NFT item history missions

An NFT item's history missions, the record of what has been done with it, twenty a page: all of them, or only the representative ones MSU picks out.

Inputs

NFT itemitemtextRequired: The NFT item's asset key, or its token ID when Look up by says so, or an item record from an earlier step such as List wallet items or Explore items for sale.
Look up bylookuptext: Whether the key given is MSU's asset key (the default, which every character and item has) or the NFT's token ID, issued once it is minted. An unminted character or item is not found by token ID.One of: asset_key (Asset key), token_id (Token ID). Default: asset_key.
Representative onlyrepresentative_onlytrue/false: Only the representative missions, the few MSU shows on the item's page, instead of all of them.Default: false.
Cursorcursortext: Optional: the next_cursor from the previous page of this step, to get the page after it. Leave empty for the first page.

Outputs

countnumber: How many history missions came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
has_moretrue/false: True when there is another page of history missions.
history_missionslist: The history missions, as MSU records them.
item_keytext: The item's key as given.
lookuptext: How the key was read: asset_key or token_id.
next_cursortext: The cursor for the next page of history missions, to give this step as Cursor; '' on the last page.
notetext: Why nothing was found, or '' when something was.
representative_onlytrue/false: True when only the representative missions were listed.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 1,
  "found": true,
  "has_more": false,
  "history_missions": [
    {
      "achievedAt": "2026-09-12T09:00:00Z",
      "missionId": 8101,
      "name": "Enhanced to 12 stars"
    }
  ],
  "item_key": "i_a1b2c3d4e5f60718",
  "lookup": "asset_key",
  "next_cursor": "",
  "note": "",
  "representative_only": false,
  "status": "success"
}

List wallet characters

The characters linked to a wallet, a page at a time, filtered by name or whether they can be traded.

Inputs

Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.
Tradabletradabletrue/false: Optional: only characters that can be traded (true), only ones that cannot (false), or both when left empty.
Namenametext: Optional: only characters whose name matches.
Cursorcursortext: Optional: the next_cursor from the previous page of this step, to get the page after it. Leave empty for the first page.
Page sizesizenumber: How many characters a page holds, 1 to 100. MSU's default is 10.From 1 to 100.

Outputs

characterslist: The characters on this page.
countnumber: How many characters came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
has_moretrue/false: True when there is another page of characters.
next_cursortext: The cursor for the next page of characters, to give this step as Cursor; '' on the last page.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).
wallet_addresstext: The wallet address asked about.

Example output

{
  "characters": [
    {
      "assetKey": "c_9f1e2d3c4b5a6978",
      "class": "magician",
      "isTradable": true,
      "job": "bishop",
      "level": 215,
      "name": "Mapler",
      "tokenId": "128934",
      "worldId": 1
    },
    {
      "assetKey": "c_1a2b3c4d5e6f7081",
      "class": "thief",
      "isTradable": false,
      "job": "night_walker",
      "level": 180,
      "name": "Orbis",
      "tokenId": "128951",
      "worldId": 1
    }
  ],
  "count": 2,
  "found": true,
  "has_more": false,
  "next_cursor": "",
  "note": "",
  "status": "success",
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

List wallet collections

The NFT collections a wallet holds, a page at a time. Give the last_key of one page to get the next.

Inputs

Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.
Page sizepage_sizenumber: How many collections a page holds, 1 to 200. MSU's default is 10.From 1 to 200.
Last keylast_keytext: Optional: the last_key from the previous page of this step, to get the page after it. Leave empty for the first.

Outputs

collectionlist: The collections on this page.
countnumber: How many collections came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
is_last_pagetrue/false: True when there is no page after this one.
last_keytext: The key for the next page, to give this step as Last key; '' on the last page.
notetext: Why nothing was found, or '' when something was.
page_sizenumber: How many a page holds.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many collections the wallet holds in all.
wallet_addresstext: The wallet address asked about.

Example output

{
  "collection": [
    {
      "contractAddress": "0xabc1",
      "itemCount": 3,
      "name": "MapleStory N Characters"
    },
    {
      "contractAddress": "0xabc2",
      "itemCount": 41,
      "name": "MapleStory N Items"
    }
  ],
  "count": 2,
  "found": true,
  "is_last_page": true,
  "last_key": "",
  "note": "",
  "page_size": 10,
  "status": "success",
  "total_count": 2,
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

List wallet currencies

The in-game currencies linked to a wallet and the balance of each, as MSU defines them.

Inputs

Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.

Outputs

countnumber: How many currencies came back.
currencieslist: The currencies, one record each.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).
wallet_addresstext: The wallet address asked about.

Example output

{
  "count": 2,
  "currencies": [
    {
      "balance": "2500000",
      "currencyType": "MESO"
    },
    {
      "balance": "1200",
      "currencyType": "MAPLE_POINT"
    }
  ],
  "found": true,
  "note": "",
  "status": "success",
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

List wallet items

The items a wallet holds, a page at a time, filtered by category, whether they are up for sale, name or token ID.

Inputs

Wallet addresswallet_addresstextRequired: The player's wallet address: 0x followed by forty hex digits, as shown on their MSU profile, or a record from an earlier step that carries one.
Category numbercategory_nonumber: Optional: only items in one of MSU's item categories, by its number (Get item category gives an item's). Leave empty for every category.At least 0.
For saleon_saletrue/false: Optional: only items listed for sale (true), only ones that are not (false), or both when left empty.
Token nametoken_nametext: Optional: only items whose token name matches.
Token IDtoken_idtext: Optional: only the item with this token ID.
Cursorcursortext: Optional: the next_cursor from the previous page of this step, to get the page after it. Leave empty for the first page.
Page sizesizenumber: How many items a page holds, 1 to 200. MSU's default is 10.From 1 to 200.

Outputs

countnumber: How many items came back.
foundtrue/false: True when MapleStory Universe knows what was asked for; false when it does not, in which case the rest of the answer is empty.
has_moretrue/false: True when there is another page of items.
itemslist: The items on this page.
next_cursortext: The cursor for the next page of items, to give this step as Cursor; '' on the last page.
notetext: Why nothing was found, or '' when something was.
statustext: Status of the action execution ("success" on success).
wallet_addresstext: The wallet address asked about.

Example output

{
  "count": 2,
  "found": true,
  "has_more": true,
  "items": [
    {
      "assetKey": "i_a1b2c3d4e5f60718",
      "categoryNo": 100,
      "itemId": 1003797,
      "mintingNo": 17,
      "name": "Zakum Helmet",
      "potentialGrade": 2,
      "starforce": 12,
      "tokenId": "558201"
    },
    {
      "assetKey": "i_0f9e8d7c6b5a4932",
      "categoryNo": 107,
      "itemId": 1072344,
      "mintingNo": 3,
      "name": "Facestompers",
      "potentialGrade": 1,
      "starforce": 8,
      "tokenId": "558244"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjIwfQ",
  "note": "",
  "status": "success",
  "wallet_address": "0x7f3c1b2a9d8e4f5061728394a5b6c7d8e9f01234"
}

Suggest keywords

Autocomplete suggestions for a marketplace search: the item, character or user names that start like a keyword of two characters or more.

Inputs

KeywordkeywordtextRequired: The start of a name, at least two characters; case does not matter.
Suggestsuggestion_typetext: What kind of name to suggest.One of: item (Items), character (Characters), user (Users). Default: item.
Token typetoken_typetext: Only NFTs, only fungible tokens, or all (the default).One of: all, nft, ft. Default: all.
How manysizenumber: Optional: at most this many suggestions.At least 1.

Outputs

countnumber: How many suggestions came back.
keywordtext: The keyword asked about.
statustext: Status of the action execution ("success" on success).
suggestion_typetext: What was suggested: item, character or user.
suggestionslist: The suggestions, best first.
token_typetext: The token type filtered by: all, nft or ft.

Example output

{
  "count": 2,
  "keyword": "zak",
  "status": "success",
  "suggestion_type": "item",
  "suggestions": [
    {
      "itemId": 1003797,
      "keyword": "Zakum Helmet"
    },
    {
      "itemId": 4001017,
      "keyword": "Zakum Tree Branch"
    }
  ],
  "token_type": "all"
}

ActionsCopy Anchor Link

Explore characters for saleCopy Anchor Link

Inputs

Outputs

Explore items for saleCopy Anchor Link

Inputs

Outputs

Explore nicknames for saleCopy Anchor Link

Inputs

Outputs

Get asset valuationCopy Anchor Link

Inputs

Outputs

Get characterCopy Anchor Link

Inputs

Outputs

Get character raffle historyCopy Anchor Link

Inputs

Outputs

Get character rafflesCopy Anchor Link

Inputs

Outputs

Get character V-MatrixCopy Anchor Link

Inputs

Outputs

Get enhancement pricesCopy Anchor Link

Inputs

Outputs

Get item categoryCopy Anchor Link

Inputs

Outputs

Get item metadataCopy Anchor Link

Inputs

Outputs

Get item setCopy Anchor Link

Inputs

Outputs

Get item valuationCopy Anchor Link

Inputs

Outputs

Get layer static dataCopy Anchor Link

Inputs

Outputs

Get NESO balanceCopy Anchor Link

Inputs

Outputs

Get NFT itemCopy Anchor Link

Inputs

Outputs

Get quest metadataCopy Anchor Link

Inputs

Outputs

Get reward historyCopy Anchor Link

Inputs

Outputs

Get reward informationCopy Anchor Link

Inputs

Outputs

Get server infoCopy Anchor Link

Inputs

Outputs

Get skill metadataCopy Anchor Link

Inputs

Outputs

Get V-Matrix nodeCopy Anchor Link

Inputs

Outputs

List character history missionsCopy Anchor Link

Inputs

Outputs

List character itemsCopy Anchor Link

Inputs

Outputs

List character questsCopy Anchor Link

Inputs

Outputs

List character skillsCopy Anchor Link

Inputs

Outputs

Actions

Explore characters for sale

Explore items for sale

Explore nicknames for sale

Get asset valuation

Get character

Get character raffle history

Get character raffles

Get character V-Matrix

Get enhancement prices

Get item category

Get item metadata

Get item set

Get item valuation

Get layer static data

Get NESO balance

Get NFT item

Get quest metadata

Get reward history

Get reward information

Get server info

Get skill metadata

Get V-Matrix node

List character history missions

List character items

List character quests

List character skills

List exclusive items

List NFT item history missions

List wallet characters

List wallet collections

List wallet currencies

List wallet items

Suggest keywords