The "Unofficial" MapleStory Free Market

A glimpse of each market alongside detailed statistics.

Important Changes

We wanted to let you know about some important changes that will be taking place throughout the next few months as well as an apology for our performance as a service in 2015.

As an effort to improve the overall experience of Maple.fm, in June and July, we will be transitioning the service to new developers.

We appreciate the MapleStory community's continued support despite these challenges we've faced and we wish to make it up to you all in the following months.

APIs

Before proceeding, we recommend becoming familiar with JavaScript Object Notation (JSON) and object-oriented programming concepts.

Description

Provides a way of displaying and monitoring items currently sold in the Free Market in MapleStory (Global). View the current uptime and statistics here.

Variables

Required server – Selecting which world to collect information from.

Optional stats – Provides statistics for all items currently sold. Boolean. Default is 1 (enabled).

Optional desc – Provides a description for all items currently sold. Boolean. Default is 1 (enabled).

Response

Element Description
fm_items.id / fm_items.U The item ID of the item, searchable through our Item Database.
fm_items.quantity / fm_items.a A quantity of the item being sold.
fm_items.bundle / fm_items.b The number of items in the item's bundle. This will be '1' if there is an individual item.
fm_items.price / fm_items.c The item's price.
fm_items.channel / fm_items.d The channel the item is currently being sold in.
fm_items.room / fm_items.e The room the item is currently being sold in. (use in combination with channel)
fm_items.shop_name / fm_items.f The room the item is currently being sold in. (use in combination with channel)
fm_items.character_name / fm_items.g The character / shop owner's name.
Element Description
fm_items.upgrades_available / fm_items.h The amount of upgrades currently available on the item.
fm_items.times_scrolled / fm_items.i The amount of scrolls applied to the item.
fm_items.str / fm_items.j The amount of STR on the item.
fm_items.dex / fm_items.k The amount of DEX on the item.
fm_items.intelligence / fm_items.l The amount of INT on the item.
fm_items.luk / fm_items.m The amount of LUK on the item.
fm_items.mhp / fm_items.n The amount of +max HP on the item.
fm_items.mmp / fm_items.o The amount of +max MP on the item.
fm_items.watk / fm_items.p The amount of weapon attack on the item.
fm_items.matk / fm_items.q The amount of magic attack on the item.
fm_items.wdef / fm_items.r The amount of weapon defense on the item.
fm_items.mdef / fm_items.s The amount of magic defense on the item.
fm_items.acc / fm_items.t The amount of accuracy on the item.
fm_items.avoid / fm_items.u The amount of avoidability on the item.
fm_items.diligence / fm_items.v The amount of diligence on the item.
fm_items.speed / fm_items.w The amount of speed on the item.
fm_items.jump / fm_items.x The amount of jump on the item.
fm_items.growth / fm_items.y The amount of item growth on the item.
fm_items.hammer_applied / fm_items.A The amount of hammers applied to the item.
fm_items.battle_mode_att / fm_items.B The amount of Battle Mode attack on the item.
fm_items.boss_dmg / fm_items.C The amount of boss damage increased on the item.
fm_items.ignore_def / fm_items.D The amount of the enemy's defense ignored on the item.
fm_items.creator / fm_items.E The name of the character that crafted the item. Null if not crafted.
fm_items.is_identified / fm_items.F If the item's potential has been identified.
fm_items.rarity / fm_items.G The potential's current rank / rarity (Ex: Rare, Epic, Unique)
fm_items.number_of_enhancements / fm_items.H The number of enhancements applied to the item.
fm_items.potential1_id / fm_items.I The id of the first line of potential on the item.
fm_items.potential2_id / fm_items.J The id of the second line of potential on the item.
fm_items.potential3_id / fm_items.K The id of the third line of potential on the item.
fm_items.bonus_potential1_id / fm_items.L The id of the first line of bonus potential on the item.
fm_items.bonus_potential2_id / fm_items.M The id of the second line of bonus potential on the item.
fm_items.bonus_potential3_id / fm_items.N The id of the third line of bonus potential on the item.
fm_items.nebulite_id / fm_items.V The id of the nebulite on the item.
fm_items.mean / fm_items.X The mean price for this item as a percent
Element Description
items.name / items.O The name of the item.
items.desc / items.P The description of the item. If none, will return null.
items.category / items.Q The category of the item.
items.subcategory / items.R The sub-category of the item.
items.detailcategory / items.S The detailed category of the item.
items.icon / items.T The item's icon id (required to either host these yourself or request access to our cdn).
items.reqLevel / items.W The level required to equip or use the item.

Description

Provides a way of displaying item metadata from our Item Database.

Variables

Required id – The item's item ID.

Optional server – Specifies whether the average price should be calculated from a single server. If left out, the price will be calculated globally. This is a numerical id of the server where Scania = 0, Windia = 1, Bera = 2, Broa = 3, Khaini = 4, YMCK = 5, GAZED = 6, BelloNova = 7, and Renegades = 8.

Response

Element Description
item.id The item's ID in our Item Database. This is not the item's actual ID.
item.name The item's name as displayed in-game.
item.desc The item's description. If the item has no description this will return as null.
item.category The item's main category. Example: Equip
item.subcategory The item's sub-category. Example: Accessory
item.detailcategory The item's detailed (or lowest) category. Example: Belt
item.attackSpeed The item's attack speed. If the item is not a weapon, this will return as null.
item.cash Determines if the item is a Cash Item. If anything besides 0 is returned, it is a cash item.
item.reqSTR The amount of STR required to equip the item (typically equipment).
item.reqDEX The amount of DEX required to equip the item (typically equipment).
item.reqINT The amount of INT required to equip the item (typically equipment).
item.reqLUK The amount of LUK required to equip the item (typically equipment).
item.reqPOP The amount of popularity (fame) required to equip the item (typically equipment).
item.median The mean price of this item, either globally or on a specific server. Again, this is the mean price. It is not the median. This will be corrected in a future revision of the API.

Description

Provides a way of collecting character information from the MapleStory Rankings (Official Site).

Variables

Required name – The character's name.

Response

Element Description
name The character's in-game name.
level The character's current level.
exp The character's experience count.
job The character's current job. Note: Classes with multiple sub-classes (Explorers, Resistance, etc) will show as their main class (ex: Pirate).
images.Character The character's image (avatar) from the rankings.
images.Pet The character's pet image from the rankings. If none, this will be null.
rankings.overall.move_rank The change in the character's Overall rankings.
rankings.overall.move_change The direction of change in the character's Overall rankings.
rankings.overall.rank The character's Overall ranking.
rankings.world.move_rank The change in the character's World rankings.
rankings.world.move_change The direction of change in the character's World rankings.
rankings.world.rank The character's World ranking.
rankings.job.move_rank The change in the character's Job rankings.
rankings.job.move_change The direction of change in the character's Job rankings.
rankings.job.rank The character's Job ranking.
rankings.fame.rank The character's Fame ranking.
rankings.fame.fame The character's current fame.

Description

Provides a way of listing all items in our item database.

Variables

Optional sold – If non-zero, this will display only those items which have been successfully sold in the Free Market. Default is 0.

Response

Element Description
a The item's actual ID.
b The item's name as displayed in-game.
Announcement

As of May 18, 2015, Maple.fm's social service has been discontinued and incorporated into the service, Mapling Club.

Maple.fm will now be solely focused on the many APIs it offers to developers alongside its market service, and will continue to function as intended for free, indefinitely. If you would like to support the service, you may become a Patreon.

Donations

Our development group, 488AC7, appreciates every single individual that has helped support our services through Patreon.

As thanks, you can find them listed below.

whitewolf

Licenses and Copyright

All item names, icons, and descriptions thereof are the sole property of NEXON and therefor applies to their Terms of Use.

Character ranking information is owned by Nexon America and can be accessed through the official MapleStory main site.

All in-game information is owned and provided by a private source.