Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.msu.io/llms.txt

Use this file to discover all available pages before exploring further.

The MSU Open API provides read access to MapleStory Universe data — including accounts, characters, items, game metadata, and marketplace listings. Builders can use it to create tools, dashboards, and Synergy Apps that connect with the MSU ecosystem.  

​
1. Authentication

All requests require an API key passed as a request header.
HeaderTypeRequiredValue
x-nxopen-api-keystringYesYour MSU Open API key
  • Example: x-nxopen-api-key: gw_xxxxxxxxxxxxxxxxxx
For instructions on how to obtain an API key, refer to the Getting Started with MSU Builder guide.
Keep the API key secure. Do not expose it in public repositories or client-side code.
 　

​
2. Rate Limits

Rate limits are applied per API key. Higher limits are available upon request.
LevelRate Limit (RPS)Quota (RPD)
Default2 RPS3,000 RPD
Level 110 RPS50,000 RPD
Level 230 RPS200,000 RPD
To request a limit increase, contact the MSU Builder Team at contact_builder@nexpace.io.
RPS = Requests Per Second, RPD = Requests Per Day. Quota resets daily at 00:00 UTC.
 　

​
3. Response Format

All responses use a common structure:
  • Success:
{

  "success": true,

  "data": { ... },

  "trace_id": "string"

}
  • Error (4xx / 5xx):
{

  "success": false,

  "error": { "code": 0, "message": "string" },

  "trace_id": "string"

}