documenter.getpostman.com Open in urlscan Pro
54.157.239.60  Public Scan

Submitted URL: https://auth.nexus.arsha.io/
Effective URL: https://documenter.getpostman.com/view/4028519/TzK2bEVg
Submission: On March 04 via automatic, source certstream-suspicious — Scanned from DE

Form analysis 0 forms found in the DOM

Text Content

Public


Documentation Settings
Environment
NA
Layout
Double Column
Language
cURL



BDO MARKET API

 * Introduction
 * Context
 * Usage As Omegapepega Replacement
 * Available Regions


V1

V2

Utility
BDO Market API

If you spot an error in these docs, need help or want to make a feature request,
fork this collection and make a pull request or join the Discord or DM Luke#1909

Stats are available here: Kibana
Source code is available here: Gitlab

--------------------------------------------------------------------------------

   
 * Thank you to Veliainn for documenting the API endpoints.
   
 * This API is a cached wrapper around the Black Desert Online market.
   
 * All values are cached for 30 minutes and deleted depending on usage
   frequency.
   
 * V1 Response structure mimics source structure while V2 parses the information
   into a more clear JSON representation.
   

--------------------------------------------------------------------------------


CONTEXT

The intention behind this project is to avoid spamming PA's servers with
unwanted requests, as the endpoints documented are not done so by PA officially,
but by members of the community.

Thus to avoid putting an unnecessary load on PA's infrastructure, you can use
this API to grab values that are cached at a set interval instead.

--------------------------------------------------------------------------------


USAGE AS OMEGAPEPEGA REPLACEMENT

You can use this API as a replacement to Omegapepega using ImportJSON

For example, to get the price and name of an item, use the following and replace
:region, id, sid and lang with your query:

=ImportJSON("https://api.arsha.io/v1/:region/price?id=10610&sid=20&lang=en",
"/name,/basePrice", "noHeaders")

The same process applies to all other available endpoints, however the
parameters used to query must be adjusted accordingly.

--------------------------------------------------------------------------------


AVAILABLE REGIONS

Replace :region with one of the following:

   
 * na
   
 * eu
   
 * sea
   
 * mena
   
 * kr
   
 * ru
   
 * jp
   
 * th
   
 * tw
   
 * sa
   
 * console_eu
   
 * console_na
   
 * console_asia
   


SUPPORTED LANGUAGES

The lang parameter can be any of the following:

en = English
de = German
fr = French
ru = Russian
es = Spanish (EU)
sp = Portuguese (RedFox)
pt = Portuguese
jp = Japanese
kr = Korean
th = Thai
tr = Turkish
tw = Chinese (Taiwan)
cn = Chinese (Mainland)



V1

NON-PARSED ENDPOINTS. THESE VALUES ARE IDENTICAL TO VALUES THAT WOULD BE
RETURNED IF ONE WAS TO USE PEARL ABYSS' OWN SERVERS.



Aliases

THESE ENDPOINTS ARE ALIASES FOR CERTAIN OTHERS FOR BACKWARDS COMPATIBILITY.


GET

/item

https://api.arsha.io/v1/:region/item?id=10007

ALIAS FOR /GETWORLDMARKETSUBLIST

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

To get useful results, split resultMsg by | for individual items and then - for
item attributes.
0: id
1: minEnhance
2: maxEnhance
3: basePrice
4: amountListed
5: totalTrades
6: priceMin
7: priceMax
8: lastSoldPrice
9: lastSoldTime

See request examples for details

PARAMS
id
10007

The item ID. Always required.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/item?id=10007'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10007-0-7-134000-0-297209-23100-231000-130000-1611947447|10007-8-10-1310000-0-379-500000-5000000-1510000-1611205482|10007-11-12-2430000-0-118-1160000-11600000-2610000-1611486529|10007-13-15-2570000-0-2408-2420000-24200000-2870000-1611667646|10007-16-16-11000000-0-1291-7950000-79500000-8500000-1610105118|10007-17-17-135000000-18-2728-13600000-136000000-136000000-1611947158|10007-18-18-151000000-0-24-29500000-295000000-174000000-1596613155|10007-19-19-357000000-0-12-72500000-725000000-378000000-1602265784|10007-20-20-895000000-0-1-152000000-3810000000-775000000-1586532748|"
}

POST

/item

https://api.arsha.io/v1/:region/item

ALIAS FOR /GETWORLDMARKETSUBLIST

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

To get useful results, split resultMsg by | for individual items and then - for
item attributes.
0: id
1: minEnhance
2: maxEnhance
3: basePrice
4: amountListed
5: totalTrades
6: priceMin
7: priceMax
8: lastSoldPrice
9: lastSoldTime

See request examples for details

HEADERS
id
10007

The item ID. Always required.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/item' \
--header 'id: 10007'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10007-0-7-134000-0-297209-23100-231000-130000-1611947447|10007-8-10-1310000-0-379-500000-5000000-1510000-1611205482|10007-11-12-2430000-0-118-1160000-11600000-2610000-1611486529|10007-13-15-2570000-0-2408-2420000-24200000-2870000-1611667646|10007-16-16-11000000-0-1291-7950000-79500000-8500000-1610105118|10007-17-17-135000000-18-2728-13600000-136000000-136000000-1611947158|10007-18-18-151000000-0-24-29500000-295000000-174000000-1596613155|10007-19-19-357000000-0-12-72500000-725000000-378000000-1602265784|10007-20-20-895000000-0-1-152000000-3810000000-775000000-1586532748|"
}

GET

/history

https://api.arsha.io/v1/:region/history?id=10007&sid=0

ALIAS FOR /GETMARKETPRICEINFO

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with - seperating prices in ascending order - this
means that the price at 0 is the price of the item 90 days ago.

To get useful results, split resultMsg by - for item attributes.

See request examples for details

PARAMS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/history?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "142000-142000-153000-150000-150000-164000-150000-150000-164000-165000-172000-176000-178000-180000-177000-165000-171000-166000-178000-178000-159000-163000-184000-203000-203000-206000-206000-188000-189000-199000-213000-213000-209000-217000-231000-231000-224000-223000-222000-220000-227000-220000-213000-225000-215000-231000-228000-204000-196000-194000-206000-215000-215000-186000-183000-169000-167000-162000-162000-179000-179000-151000-150000-150000-142000-136000-136000-137000-137000-135000-141000-141000-122000-120000-129000-129000-143000-147000-141000-144000-144000-129000-130000-131000-130000-130000-138000-142000-138000-134000"
}

POST

/history

https://api.arsha.io/v1/:region/history

ALIAS FOR /GETMARKETPRICEINFO

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with - seperating prices in ascending order - this
means that the price at 0 is the price of the item 90 days ago.

To get useful results, split resultMsg by - for item attributes.

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Used to get enhancement level. Only required on
enhanceable items and defaults to 0 if absent.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/history' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "142000-142000-153000-150000-150000-164000-150000-150000-164000-165000-172000-176000-178000-180000-177000-165000-171000-166000-178000-178000-159000-163000-184000-203000-203000-206000-206000-188000-189000-199000-213000-213000-209000-217000-231000-231000-224000-223000-222000-220000-227000-220000-213000-225000-215000-231000-228000-204000-196000-194000-206000-215000-215000-186000-183000-169000-167000-162000-162000-179000-179000-151000-150000-150000-142000-136000-136000-137000-137000-135000-141000-141000-122000-120000-129000-129000-143000-147000-141000-144000-144000-129000-130000-131000-130000-130000-138000-142000-138000-134000"
}

GET

/orders

https://api.arsha.io/v1/:region/orders?id=10007&sid=0

ALIAS FOR /GETBIDDINGINFOLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating orders and - seperating the
attributes of the orders:

0: price
1: amount of sell orders
2: amount of buy orders

To get useful results, split resultMsg by | for orders and then by - for order
attributes.

See request examples for details

PARAMS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/orders?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "185000-0-18|176000-0-6|179000-0-0|"
}

POST

/orders

https://api.arsha.io/v1/:region/orders

ALIAS FOR /GETBIDDINGINFOLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating orders and - seperating the
attributes of the orders:

0: price
1: amount of sell orders
2: amount of buy orders

To get useful results, split resultMsg by | for orders and then by - for order
attributes.

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/orders' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "185000-0-18|176000-0-6|179000-0-0|"
}

Convenience


GET

/price

https://api.arsha.io/v1/:region/price?id=10007&sid=0&lang=en

CONVENIENCE METHOD FOR GETTING THE BASE PRICE OF AN ITEM

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys:
name: String
id: Integer
sid: Integer
basePrice: long

See request examples for details

PARAMS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Used to get enhancement level. Only required on
enhanceable items and defaults to 0 if absent.

lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Item Baseprice

curl --location --request GET 'https://api.arsha.io/v1/na/price?id=10007&sid=0&lang=en'

Example Response
200 OK
Body
Header(1)

{
  "icon": "cdn.arsha.io/icons/10007.png",
  "name": "Seleth Longsword",
  "id": 10007,
  "sid": 0,
  "basePrice": 231000
}

POST

/price

https://api.arsha.io/v1/:region/price

CONVENIENCE METHOD FOR GETTING THE BASE PRICE OF AN ITEM

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys:
name: String
id: Integer
sid: Integer
basePrice: long

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Used to get enhancement level. Only required on
enhanceable items and defaults to 0 if absent.

lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Item Baseprice

curl --location --request POST 'https://api.arsha.io/v1/na/price' \
--header 'id: 10007' \
--header 'sid: 0' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)

{
  "icon": "cdn.arsha.io/icons/10007.png",
  "name": "Seleth Longsword",
  "id": 10007,
  "sid": 0,
  "basePrice": 231000
}

GET

/GetWorldMarketWaitList

https://api.arsha.io/v1/:region/GetWorldMarketWaitList

Returns (if available) the items currently waiting to be listed on the central
market.

resultMsg structure: ID-SID-PRICE-AVAILABLE_EPOCH|...

AVAILABLE_EPOCH in this case is the epoch timestamp when the item will be
available to be bought (15 minutes after the initial listing).

PATH VARIABLES
region
na


Example Request
Market Waitlist

curl --location --request GET 'https://api.arsha.io/v1/na/GetWorldMarketWaitList'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "11017-20-14700000000-1631869705|11856-4-7800000000-1631870086|11102-20-13400000000-1631870356|719898-2-51000000000-1631870379|11663-4-14100000000-1631870446|"
}

POST

/GetWorldMarketWaitList

https://api.arsha.io/v1/:region/GetWorldMarketWaitList

Returns (if available) the items currently waiting to be listed on the central
market.

resultMsg structure: ID-SID-PRICE-AVAILABLE_EPOCH|...

AVAILABLE_EPOCH in this case is the epoch timestamp when the item will be
available to be bought (15 minutes after the initial listing).

PATH VARIABLES
region
na


Example Request
Market Waitlist

curl --location --request POST 'https://api.arsha.io/v1/na/GetWorldMarketWaitList'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "11017-20-14700000000-1631869705|11856-4-7800000000-1631870086|11102-20-13400000000-1631870356|719898-2-51000000000-1631870379|11663-4-14100000000-1631870446|"
}

GET

/GetWorldMarketHotList

https://api.arsha.io/v1/:region/GetWorldMarketHotList

GET CURRENT MARKET HOTLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

To get useful results, split resultMsg by | for individual items and then - for
item attributes.
0: id
1: min enhance
2: max enhance
3: base price
4: amount listed
5: total trades
6: price change (1=down,2=up)
7: price change amount
8: priceMin
9: priceMax
10: last sold price
11: last sold time

See request examples for details

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Hotlist

curl --location --request GET 'https://api.arsha.io/v1/na/GetWorldMarketHotList'

Example Response
200 OK
Body
Header(1)
View More

{
  "resultCode": 0,
  "resultMsg": "4065-0-0-59500-0-1000627-1-15000-52500-525000-63500-1619721998|11611-2-2-118000000-13-2810-1-30000000-10000000-300000000-118000000-1619571425|11611-3-3-280000000-17-2730-1-150000000-31800000-955000000-274000000-1619712384|11728-3-3-630000000-0-24-1-160000000-380000000-875000000-585000000-1597393173|11827-3-3-408000000-3-735-1-102000000-102000000-3060000000-420000000-1619623987|12042-5-5-9050000000-0-67-1-2250000000-820000000-24600000000-9000000000-1618599314|16165-0-5-925000-209-182677-1-225000-317000-4440000-915000-1619719886|692812-18-18-565000000-1-8-1-130000000-33300000-1000000000-645000000-1616216795|702501-18-18-565000000-0-31-1-130000000-33300000-1000000000-745000000-1615853265|702502-18-18-565000000-0-48-1-130000000-33300000-1000000000-675000000-1614342006|702503-18-18-565000000-0-30-1-130000000-33300000-1000000000-605000000-1619628153|702504-18-18-565000000-0-40-1-130000000-33300000-1000000000-745000000-1616511398|702505-18-18-565000000-0-24-1-130000000-33300000-1000000000-600000000-1618762697|702506-18-18-565000000-0-58-1-130000000-33300000-1000000000-700000000-1617043863|702507-18-18-565000000-1-67-1-130000000-33300000-1000000000-605000000-1619655923|702508-18-18-565000000-1-63-1-130000000-33300000-1000000000-655000000-1618964705|702509-18-18-565000000-0-58-1-130000000-33300000-1000000000-605000000-1619502710|702510-18-18-565000000-0-45-1-130000000-33300000-1000000000-670000000-1616892821|702511-18-18-565000000-0-81-1-130000000-33300000-1000000000-565000000-1619657619|702512-18-18-565000000-0-36-1-130000000-33300000-1000000000-565000000-1619409208|702513-18-18-565000000-1-50-1-130000000-33300000-1000000000-740000000-1616330612|702514-18-18-565000000-0-55-1-130000000-33300000-1000000000-565000000-1619243929|702515-18-18-565000000-0-88-1-130000000-33300000-1000000000-565000000-1619399273|702516-18-18-565000000-0-96-1-130000000-33300000-1000000000-700000000-1617577089|702533-18-18-565000000-2-63-1-130000000-33300000-1000000000-565000000-1619041328|702535-18-18-565000000-0-64-1-130000000-33300000-1000000000-615000000-1619153959|730913-18-18-565000000-0-6-1-130000000-33300000-1000000000-610000000-1616891122|1154-0-0-97500-0-2507-2-45000-15200-488000-104000-1619584720|3510-0-0-655000-0-91-2-373000-141000-845000-660000-1619285419|3552-0-0-48000000-0-127-2-27500000-6500000-65000000-51500000-1619575237|6945-0-0-115000-0-753-2-39000-26700-144000-123000-1619471438|6948-0-0-79000-0-1001-2-13500-21400-116000-84500-1619622581|6949-0-0-42400-0-1343-2-7500-17100-92500-45500-1619682090|8637-0-0-5350-0-19632-2-1710-995-5950-5750-1619472931|8642-0-0-18200-0-152871-2-3200-4050-24300-19500-1619720094|9606-0-0-120000-0-1545185-2-21000-57000-570000-129000-1619722025|10003-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10138-14-14-261000000-0-204-2-44000000-16600000-498000000-280000000-1619243494|10203-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10338-14-14-261000000-0-306-2-44000000-16600000-498000000-280000000-1618453868|10403-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10538-14-14-261000000-0-108-2-44000000-16600000-498000000-242000000-1619581712|10603-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10738-14-14-261000000-0-212-2-44000000-16600000-498000000-242000000-1618874821|10814-20-20-685000000-0-5-2-165000000-116000000-2890000000-635000000-1616629519|10822-20-20-1090000000-0-12-2-200000000-116000000-2890000000-1170000000-1615058076|11013-15-15-422000000-0-301-2-79000000-27700000-830000000-453000000-1619644735|11017-15-15-483000000-0-341-2-93000000-27700000-830000000-485000000-1619481492|11070-20-20-2040000000-0-34-2-390000000-113000000-8450000000-2190000000-1619371875|11203-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|11205-20-20-810000000-0-0-2-185000000-152000000-3810000000-0-0|11338-14-14-261000000-0-268-2-44000000-16600000-498000000-280000000-1619657561|11353-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|12002-4-4-7650000-0-314-2-1300000-2240000-11200000-8200000-1619086195|12758-0-0-775000-0-8-2-145000-250000-1500000-775000-1616305159|12765-0-0-1560000-0-13-2-290000-945000-2900000-1670000-1618798869|12848-0-0-382000-0-10-2-73000-154000-925000-410000-1619669194|12851-0-0-496000-0-50-2-96000-200000-1200000-530000-1619718050|13038-14-14-261000000-0-47-2-44000000-16600000-498000000-261000000-1616262987|13138-14-14-261000000-0-143-2-44000000-16600000-498000000-280000000-1619442065|13203-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|13303-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|13403-20-20-835000000-0-1-2-155000000-152000000-3810000000-895000000-1617450466|13538-14-14-261000000-0-133-2-44000000-16600000-498000000-264000000-1619686630|13703-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|13838-14-14-261000000-0-95-2-44000000-16600000-498000000-268000000-1619307300|13901-0-7-95000-0-16246-2-17000-28900-115000-102000-1619287837|14102-10-12-7900000-0-997-2-2600000-995000-9950000

POST

/GetWorldMarketHotList

https://api.arsha.io/v1/:region/GetWorldMarketHotList

GET CURRENT MARKET HOTLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

To get useful results, split resultMsg by | for individual items and then - for
item attributes.
0: id
1: min enhance
2: max enhance
3: base price
4: amount listed
5: total trades
6: price change (1=down,2=up)
7: price change amount
8: priceMin
9: priceMax
10: last sold price
11: last sold time

See request examples for details

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Hotlist

curl --location --request POST 'https://api.arsha.io/v1/na/GetWorldMarketHotList'

Example Response
200 OK
Body
Header(1)
View More

{
  "resultCode": 0,
  "resultMsg": "4065-0-0-59500-0-1000627-1-15000-52500-525000-63500-1619721998|11611-2-2-118000000-13-2810-1-30000000-10000000-300000000-118000000-1619571425|11611-3-3-280000000-17-2730-1-150000000-31800000-955000000-274000000-1619712384|11728-3-3-630000000-0-24-1-160000000-380000000-875000000-585000000-1597393173|11827-3-3-408000000-3-735-1-102000000-102000000-3060000000-420000000-1619623987|12042-5-5-9050000000-0-67-1-2250000000-820000000-24600000000-9000000000-1618599314|16165-0-5-925000-209-182677-1-225000-317000-4440000-915000-1619719886|692812-18-18-565000000-1-8-1-130000000-33300000-1000000000-645000000-1616216795|702501-18-18-565000000-0-31-1-130000000-33300000-1000000000-745000000-1615853265|702502-18-18-565000000-0-48-1-130000000-33300000-1000000000-675000000-1614342006|702503-18-18-565000000-0-30-1-130000000-33300000-1000000000-605000000-1619628153|702504-18-18-565000000-0-40-1-130000000-33300000-1000000000-745000000-1616511398|702505-18-18-565000000-0-24-1-130000000-33300000-1000000000-600000000-1618762697|702506-18-18-565000000-0-58-1-130000000-33300000-1000000000-700000000-1617043863|702507-18-18-565000000-1-67-1-130000000-33300000-1000000000-605000000-1619655923|702508-18-18-565000000-1-63-1-130000000-33300000-1000000000-655000000-1618964705|702509-18-18-565000000-0-58-1-130000000-33300000-1000000000-605000000-1619502710|702510-18-18-565000000-0-45-1-130000000-33300000-1000000000-670000000-1616892821|702511-18-18-565000000-0-81-1-130000000-33300000-1000000000-565000000-1619657619|702512-18-18-565000000-0-36-1-130000000-33300000-1000000000-565000000-1619409208|702513-18-18-565000000-1-50-1-130000000-33300000-1000000000-740000000-1616330612|702514-18-18-565000000-0-55-1-130000000-33300000-1000000000-565000000-1619243929|702515-18-18-565000000-0-88-1-130000000-33300000-1000000000-565000000-1619399273|702516-18-18-565000000-0-96-1-130000000-33300000-1000000000-700000000-1617577089|702533-18-18-565000000-2-63-1-130000000-33300000-1000000000-565000000-1619041328|702535-18-18-565000000-0-64-1-130000000-33300000-1000000000-615000000-1619153959|730913-18-18-565000000-0-6-1-130000000-33300000-1000000000-610000000-1616891122|1154-0-0-97500-0-2507-2-45000-15200-488000-104000-1619584720|3510-0-0-655000-0-91-2-373000-141000-845000-660000-1619285419|3552-0-0-48000000-0-127-2-27500000-6500000-65000000-51500000-1619575237|6945-0-0-115000-0-753-2-39000-26700-144000-123000-1619471438|6948-0-0-79000-0-1001-2-13500-21400-116000-84500-1619622581|6949-0-0-42400-0-1343-2-7500-17100-92500-45500-1619682090|8637-0-0-5350-0-19632-2-1710-995-5950-5750-1619472931|8642-0-0-18200-0-152871-2-3200-4050-24300-19500-1619720094|9606-0-0-120000-0-1545185-2-21000-57000-570000-129000-1619722025|10003-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10138-14-14-261000000-0-204-2-44000000-16600000-498000000-280000000-1619243494|10203-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10338-14-14-261000000-0-306-2-44000000-16600000-498000000-280000000-1618453868|10403-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10538-14-14-261000000-0-108-2-44000000-16600000-498000000-242000000-1619581712|10603-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|10738-14-14-261000000-0-212-2-44000000-16600000-498000000-242000000-1618874821|10814-20-20-685000000-0-5-2-165000000-116000000-2890000000-635000000-1616629519|10822-20-20-1090000000-0-12-2-200000000-116000000-2890000000-1170000000-1615058076|11013-15-15-422000000-0-301-2-79000000-27700000-830000000-453000000-1619644735|11017-15-15-483000000-0-341-2-93000000-27700000-830000000-485000000-1619481492|11070-20-20-2040000000-0-34-2-390000000-113000000-8450000000-2190000000-1619371875|11203-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|11205-20-20-810000000-0-0-2-185000000-152000000-3810000000-0-0|11338-14-14-261000000-0-268-2-44000000-16600000-498000000-280000000-1619657561|11353-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|12002-4-4-7650000-0-314-2-1300000-2240000-11200000-8200000-1619086195|12758-0-0-775000-0-8-2-145000-250000-1500000-775000-1616305159|12765-0-0-1560000-0-13-2-290000-945000-2900000-1670000-1618798869|12848-0-0-382000-0-10-2-73000-154000-925000-410000-1619669194|12851-0-0-496000-0-50-2-96000-200000-1200000-530000-1619718050|13038-14-14-261000000-0-47-2-44000000-16600000-498000000-261000000-1616262987|13138-14-14-261000000-0-143-2-44000000-16600000-498000000-280000000-1619442065|13203-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|13303-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|13403-20-20-835000000-0-1-2-155000000-152000000-3810000000-895000000-1617450466|13538-14-14-261000000-0-133-2-44000000-16600000-498000000-264000000-1619686630|13703-20-20-835000000-0-0-2-155000000-152000000-3810000000-0-0|13838-14-14-261000000-0-95-2-44000000-16600000-498000000-268000000-1619307300|13901-0-7-95000-0-16246-2-17000-28900-115000-102000-1619287837|14102-10-12-7900000-0-997-2-2600000-995000-9950000

GET

/GetWorldMarketList

https://api.arsha.io/v1/:region/GetWorldMarketList?mainCategory=1&subCategory=1

GET ITEMS FROM A SPECIFIC CATEGORY OR SUBCATEGORY

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating items and - seperating the
attributes of the items:

0: item id
1: current stock
2: total trades
3: base price

To get useful results, split resultMsg by | for items and then by - for item
attributes.

See request examples for details

PARAMS
mainCategory
1

Always required.

subCategory
1

Always required.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Category List

curl --location --request GET 'https://api.arsha.io/v1/na/GetWorldMarketList?mainCategory=1&subCategory=1'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10003-4-57734-10400|10005-2-608764-26900|10006-0-114002-292000|10007-1-317685-179000|10009-28-104392-2400000|10010-40-41070-155000000|10012-3-584261-58500|10013-24-703966-46100|10014-7-1090189-161000|10056-6-734460-36900|10057-36-2660447-98500|10071-6-46445-15600|10072-0-54319-20600|10086-6-3709-131000000|715001-8-3572-630000000|"
}

POST

/GetWorldMarketList

https://api.arsha.io/v1/:region/GetWorldMarketList

GET ITEMS FROM A SPECIFIC CATEGORY OR SUBCATEGORY

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating items and - seperating the
attributes of the items:

0: item id
1: current stock
2: total trades
3: base price

To get useful results, split resultMsg by | for items and then by - for item
attributes.

See request examples for details

HEADERS
mainCategory
1

Always required.

subCategory
1

Always required.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Category List

curl --location --request POST 'https://api.arsha.io/v1/na/GetWorldMarketList' \
--header 'mainCategory: 1' \
--header 'subCategory: 1'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10003-4-57734-10400|10005-2-608764-26900|10006-0-114002-292000|10007-1-317685-179000|10009-28-104392-2400000|10010-40-41070-155000000|10012-3-584261-58500|10013-24-703966-46100|10014-7-1090189-161000|10056-6-734460-36900|10057-36-2660447-98500|10071-6-46445-15600|10072-0-54319-20600|10086-6-3709-131000000|715001-8-3572-630000000|"
}

GET

/GetWorldMarketSubList

https://api.arsha.io/v1/:region/GetWorldMarketSubList?id=10007

GET DETAILS FOR AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

To get useful results, split resultMsg by | for individual items and then - for
item attributes.
0: id
1: minEnhance
2: maxEnhance
3: basePrice
4: amountListed
5: totalTrades
6: priceMin
7: priceMax
8: lastSoldPrice
9: lastSoldTime

See request examples for details

PARAMS
id
10007

The item ID. Always required.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/GetWorldMarketSubList?id=10007'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10007-0-7-134000-0-297209-23100-231000-130000-1611947447|10007-8-10-1310000-0-379-500000-5000000-1510000-1611205482|10007-11-12-2430000-0-118-1160000-11600000-2610000-1611486529|10007-13-15-2570000-0-2408-2420000-24200000-2870000-1611667646|10007-16-16-11000000-0-1291-7950000-79500000-8500000-1610105118|10007-17-17-135000000-18-2728-13600000-136000000-136000000-1611947158|10007-18-18-151000000-0-24-29500000-295000000-174000000-1596613155|10007-19-19-357000000-0-12-72500000-725000000-378000000-1602265784|10007-20-20-895000000-0-1-152000000-3810000000-775000000-1586532748|"
}

POST

/GetWorldMarketSubList

https://api.arsha.io/v1/:region/GetWorldMarketSubList

GET DETAILS FOR AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

To get useful results, split resultMsg by | for individual items and then - for
item attributes.
0: id
1: minEnhance
2: maxEnhance
3: basePrice
4: amountListed
5: totalTrades
6: priceMin
7: priceMax
8: lastSoldPrice
9: lastSoldTime

See request examples for details

HEADERS
id
10007

The item ID. Always required.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/GetWorldMarketSubList' \
--header 'id: 10007'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10007-0-7-134000-0-297209-23100-231000-130000-1611947447|10007-8-10-1310000-0-379-500000-5000000-1510000-1611205482|10007-11-12-2430000-0-118-1160000-11600000-2610000-1611486529|10007-13-15-2570000-0-2408-2420000-24200000-2870000-1611667646|10007-16-16-11000000-0-1291-7950000-79500000-8500000-1610105118|10007-17-17-135000000-18-2728-13600000-136000000-136000000-1611947158|10007-18-18-151000000-0-24-29500000-295000000-174000000-1596613155|10007-19-19-357000000-0-12-72500000-725000000-378000000-1602265784|10007-20-20-895000000-0-1-152000000-3810000000-775000000-1586532748|"
}

GET

/GetWorldMarketSearchList

https://api.arsha.io/v1/:region/GetWorldMarketSearchList?ids=10007

SEARCH FOR ITEMS BY THEIR ID(S)

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating items and - seperating the
attributes of the items:

0: item id
1: current stock
2: base price
3: total trades

To get useful results, split resultMsg by | for items and then by - for item
attributes.

See request examples for details

PARAMS
ids
10007

Always required. Optionally a comma seperated list can also be supplied for
multiple results.

PATH VARIABLES
region
na

(Required) The game region



Market Search Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/GetWorldMarketSearchList?ids=10007'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10007-1-179000-317685"
}

POST

/GetWorldMarketSearchList

https://api.arsha.io/v1/:region/GetWorldMarketSearchList

SEARCH FOR ITEMS BY THEIR ID(S)

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating items and - seperating the
attributes of the items:

0: item id
1: current stock
2: base price
3: total trades

To get useful results, split resultMsg by | for items and then by - for item
attributes.

See request examples for details

HEADERS
ids
10007

Always required. Optionally a comma seperated list can also be supplied for
multiple results.

PATH VARIABLES
region
na

(Required) The game region



Market Search Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/GetWorldMarketSearchList' \
--header 'ids: 10007'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "10007-1-179000-317685"
}

GET

/GetBiddingInfoList

https://api.arsha.io/v1/:region/GetBiddingInfoList?id=10007&sid=0

GET ORDERS OF AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating orders and - seperating the
attributes of the orders:

0: price
1: amount of sell orders
2: amount of buy orders

To get useful results, split resultMsg by | for orders and then by - for order
attributes.

See request examples for details

PARAMS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/GetBiddingInfoList?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "142000-142000-153000-150000-150000-164000-150000-150000-164000-165000-172000-176000-178000-180000-177000-165000-171000-166000-178000-178000-159000-163000-184000-203000-203000-206000-206000-188000-189000-199000-213000-213000-209000-217000-231000-231000-224000-223000-222000-220000-227000-220000-213000-225000-215000-231000-228000-204000-196000-194000-206000-215000-215000-186000-183000-169000-167000-162000-162000-179000-179000-151000-150000-150000-142000-136000-136000-137000-137000-135000-141000-141000-122000-120000-129000-129000-143000-147000-141000-144000-144000-129000-130000-131000-130000-130000-138000-142000-138000-134000"
}

POST

/GetBiddingInfoList

https://api.arsha.io/v1/:region/GetBiddingInfoList

GET ORDERS OF AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with | seperating orders and - seperating the
attributes of the orders:

0: price
1: amount of sell orders
2: amount of buy orders

To get useful results, split resultMsg by | for orders and then by - for order
attributes.

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/GetBiddingInfoList' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "142000-142000-153000-150000-150000-164000-150000-150000-164000-165000-172000-176000-178000-180000-177000-165000-171000-166000-178000-178000-159000-163000-184000-203000-203000-206000-206000-188000-189000-199000-213000-213000-209000-217000-231000-231000-224000-223000-222000-220000-227000-220000-213000-225000-215000-231000-228000-204000-196000-194000-206000-215000-215000-186000-183000-169000-167000-162000-162000-179000-179000-151000-150000-150000-142000-136000-136000-137000-137000-135000-141000-141000-122000-120000-129000-129000-143000-147000-141000-144000-144000-129000-130000-131000-130000-130000-138000-142000-138000-134000"
}

GET

/GetMarketPriceInfo

https://api.arsha.io/v1/:region/GetMarketPriceInfo?id=10007&sid=0

GET PRICE HISTORY FOR AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with - seperating prices in ascending order - this
means that the price at 0 is the price of the item 90 days ago.

To get useful results, split resultMsg by - for item attributes.

See request examples for details

PARAMS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v1/na/GetMarketPriceInfo?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "185000-0-18|176000-0-6|179000-0-0|"
}

POST

/GetMarketPriceInfo

https://api.arsha.io/v1/:region/GetMarketPriceInfo

GET PRICE HISTORY FOR AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JSON with keys resultCode with value of type Integer and resultMsg with value of
type String.

The resultMsg is a string with - seperating prices in ascending order - this
means that the price at 0 is the price of the item 90 days ago.

To get useful results, split resultMsg by - for item attributes.

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Used to get enhancement level. Only required on
enhanceable items and defaults to 0 if absent.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v1/na/GetMarketPriceInfo' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)

{
  "resultCode": 0,
  "resultMsg": "185000-0-18|176000-0-6|179000-0-0|"
}

V2

RESPONSES FROM THESE ENDPOINTS ARE PARSED FOR EASE OF USE. CHECK EXAMPLES FOR
DETAILS.



Aliases

THESE ENDPOINTS ARE ALIASES FOR CERTAIN OTHERS FOR BACKWARDS COMPATIBILITY.


GET

/item

https://api.arsha.io/v2/:region/item?id=10007&lang=en

ALIAS FOR /GETWORLDMARKETSUBLIST

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JsonArray with parsed item from base enhance to max enhance level if available.
If multiple id are specified an Array of Arrays with the items is returned.

See request examples for details

PARAMS
id
10007

The item ID. Always required. Optionally multiple id may be supplied for
multiple results.

lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na


Item Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/item?id=10007&lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "name": "Seleth Longsword",
    "icon": "cdn.arsha.io/icons/10007.png",
    "id": 10007,
    "sid": 0,
    "minEnhance": "0",
    "maxEnhance": "7",
    "basePrice": 200000,
    "currentStock": 1,
    "totalTrades": 311774,

POST

/item

https://api.arsha.io/v2/:region/item

ALIAS FOR /GETWORLDMARKETSUBLIST

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

JsonArray with parsed item from base enhance to max enhance level if available.
If multiple id are specified an Array of Arrays with the items is returned.

See request examples for details

HEADERS
id
10007

The item ID. Always required. Optionally a comma seperated list of id may be
supplied for multiple results.

lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/item' \
--header 'id: 10007' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "name": "Seleth Longsword",
    "icon": "cdn.arsha.io/icons/10007.png",
    "id": 10007,
    "sid": 0,
    "minEnhance": "0",
    "maxEnhance": "7",
    "basePrice": 200000,
    "currentStock": 1,
    "totalTrades": 311774,

GET

/history

https://api.arsha.io/v2/:region/history?id=10007&sid=0

ALIAS FOR /GETMARKETPRICEINFO

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

If multiple id are specified, a JsonArray with mutliple of the following
JsonObject is returned:

JsonObject with keys:

id: id
sid: sub id
history: JsonObject with key:value pairs of timestamp:price.

See request examples for details

PARAMS
id
10007

The item ID. Always required. Optionally multiple id may be supplied for
multiple results.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/history?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "history": {
    "1612034008": "170000",
    "1612120408": "170000",
    "1612206808": "170000",
    "1612293208": "188000",
    "1612379608": "188000",
    "1612466008": "225000",
    "1612552408": "231000",

POST

/history

https://api.arsha.io/v2/:region/history

ALIAS FOR /GETMARKETPRICEINFO

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

If multiple id are specified, a JsonArray with mutliple of the following
JsonObject is returned:

JsonObject with keys:

id: id
sid: sub id
history: JsonObject with key:value pairs of timestamp:price.

See request examples for details

HEADERS
id
10007

The item ID. Always required. Optionally multiple id may be supplied for
multiple results.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/history' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "history": {
    "1612034008": "170000",
    "1612120408": "170000",
    "1612206808": "170000",
    "1612293208": "188000",
    "1612379608": "188000",
    "1612466008": "225000",
    "1612552408": "231000",

GET

/orders

https://api.arsha.io/v2/:region/orders?id=10007&sid=0

ALIAS FOR /GETBIDDINGINFOLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

If multiple id are specified, a JsonArray with mutliple of the following
JsonObject is returned:

JsonObject with keys:

id: id
sid: sub id
orders: JsonArray of JsonObjects with order details

See request examples for details

PARAMS
id
10007

The item ID. Always required. Optionally multiple id may be supplied for
multiple results.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/orders?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "orders": [
    {
      "price": 185000,
      "buyers": 0,
      "sellers": 18
    },
    {
      "price": 176000,

POST

/orders

https://api.arsha.io/v2/:region/orders

ALIAS FOR /GETBIDDINGINFOLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

If multiple id are specified, a JsonArray with mutliple of the following
JsonObject is returned:

JsonObject with keys:

id: id
sid: sub id
orders: JsonArray of JsonObjects with order details

See request examples for details

HEADERS
id
10007

The item ID. Always required. Optionally multiple id may be supplied for
multiple results.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/orders' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "orders": [
    {
      "price": 185000,
      "buyers": 0,
      "sellers": 18
    },
    {
      "price": 176000,

GET

/GetWorldMarketWaitList

https://api.arsha.io/v2/:region/GetWorldMarketWaitList

Returns a parsed variant of the current items waiting to be listed on the
central market.

Response Structure:

   
 * name: Name of item
   
 * id: ID of item
   
 * sid: Sub ID of item (also enhancement level)
   
 * price: Price the item was listed at
   
 * liveAt: Timestamp at which the item will be available on the central market.
   

PATH VARIABLES
region
na


Example Request
Market Waitlist

curl --location --request GET 'https://api.arsha.io/v2/na/GetWorldMarketWaitList'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "name": "PEN: Dim Tree Spirit's Armor",
    "id": 11017,
    "subId": 20,
    "price": 14700000000,
    "liveAt": 1631869705
  },
  {
    "name": "TET: Ethereal Earring",
    "id": 11856,

POST

/GetWorldMarketWaitList

https://api.arsha.io/v2/:region/GetWorldMarketWaitList

Returns a parsed variant of the current items waiting to be listed on the
central market.

Response Structure:

   
 * name: Name of item
   
 * id: ID of item
   
 * sid: Sub ID of item (also enhancement level)
   
 * price: Price the item was listed at
   
 * liveAt: Timestamp at which the item will be available on the central market.
   

PATH VARIABLES
region
na


Example Request
Market Waitlist

curl --location --request POST 'https://api.arsha.io/v2/na/GetWorldMarketWaitList'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "name": "PEN: Dim Tree Spirit's Armor",
    "id": 11017,
    "subId": 20,
    "price": 14700000000,
    "liveAt": 1631869705
  },
  {
    "name": "TET: Ethereal Earring",
    "id": 11856,

GET

/GetWorldMarketHotList

https://api.arsha.io/v2/:region/GetWorldMarketHotList?lang=en

GET CURRENT MARKET HOTLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

Returns JsonArray of JsonObjects of items currently on market hotlist.

See request examples for details

PARAMS
lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Hotlist

curl --location --request GET 'https://api.arsha.io/v2/na/GetWorldMarketHotList?lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
    {
        "name": "Pure Zinc Crystal",
        "id": 4065,
        "subId": 0,
        "minEnhance": "0",
        "maxEnhance": "0",
        "basePrice": 59500,
        "currentStock": 18,
        "totalTrades": 1000661,
        "priceChangeDirection": 1,

POST

/GetWorldMarketHotList

https://api.arsha.io/v2/:region/GetWorldMarketHotList

GET CURRENT MARKET HOTLIST

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

Returns JsonArray of JsonObjects of items currently on market hotlist.

See request examples for details

HEADERS
lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Hotlist

curl --location --request POST 'https://api.arsha.io/v2/na/GetWorldMarketHotList' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

[
    {
        "name": "Pure Zinc Crystal",
        "id": 4065,
        "subId": 0,
        "minEnhance": "0",
        "maxEnhance": "0",
        "basePrice": 59500,
        "currentStock": 18,
        "totalTrades": 1000661,
        "priceChangeDirection": 1,

GET

/GetWorldMarketList

https://api.arsha.io/v2/:region/GetWorldMarketList?mainCategory=1&subCategory=1

GET ITEMS FROM A SPECIFIC CATEGORY OR SUBCATEGORY

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

Returns JsonArray of JsonObjects of items in category or subcategory.

See request examples for details

PARAMS
mainCategory
1

Always required.

subCategory
1

Always required.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Category List

curl --location --request GET 'https://api.arsha.io/v2/na/GetWorldMarketList?mainCategory=1&subCategory=1'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "id": 10003,
    "currentStock": 4,
    "totalTrades": 57734,
    "basePrice": 10400
  },
  {
    "id": 10005,
    "currentStock": 4,
    "totalTrades": 608764,

POST

/GetWorldMarketList

https://api.arsha.io/v2/:region/GetWorldMarketList

GET ITEMS FROM A SPECIFIC CATEGORY OR SUBCATEGORY

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

Returns JsonArray of JsonObjects of items in category or subcategory.

See request examples for details

HEADERS
mainCategory
1

Always required.

subCategory
1

Always required.

PATH VARIABLES
region
na

(Required) The game region



Example Request
Market Category List

curl --location --request POST 'https://api.arsha.io/v2/na/GetWorldMarketList' \
--header 'mainCategory: 1' \
--header 'subCategory: 1'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "id": 10003,
    "currentStock": 4,
    "totalTrades": 57734,
    "basePrice": 10400
  },
  {
    "id": 10005,
    "currentStock": 4,
    "totalTrades": 608764,

GET

/GetWorldMarketSubList

https://api.arsha.io/v2/:region/GetWorldMarketSubList?id=10007&lang=en

GET PARSED ITEM OR ITEMS FROM MIN TO MAX ENHANCE (IF AVAILABLE)

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

Returns JsonArray with parsed item from base enhance to max enhance level if
available. If multiple id are specified an Array of Arrays with the items is
returned.

See request examples for details

--------------------------------------------------------------------------------

NOTE

Some items have "combined" listings, i.e: +0 ~ +7 are one listing under sid: 0
for the example request used. This is how PA sends their data and not a personal
choice on my end. However, supplying these "combined" sid does work on
/GetMarketPriceInfo and /GetBiddingInfoList.

PARAMS
id
10007

The item ID. Always required.

lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/GetWorldMarketSubList?id=10007&lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "name": "Seleth Longsword",
    "icon": "cdn.arsha.io/icons/10007.png",
    "id": 10007,
    "sid": 0,
    "minEnhance": "0",
    "maxEnhance": "7",
    "basePrice": 200000,
    "currentStock": 1,
    "totalTrades": 311774,

POST

/GetWorldMarketSubList

https://api.arsha.io/v2/:region/GetWorldMarketSubList

GET PARSED ITEM OR ITEMS FROM MIN TO MAX ENHANCE (IF AVAILABLE)

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

Returns JsonArray with parsed item from base enhance to max enhance level if
available. If multiple id are specified an Array of Arrays with the items is
returned.

See request examples for details

--------------------------------------------------------------------------------

NOTE

Some items have "combined" listings, i.e: +0 ~ +7 are one listing under sid: 0
for the example request used. This is how PA sends their data and not a personal
choice on my end. However, supplying these "combined" sid does work on
/GetMarketPriceInfo and /GetBiddingInfoList.

HEADERS
id
10007

The item ID. Always required.

lang
en

Optional. Defaults to en.

PATH VARIABLES
region
na

(Required) The game region



Item Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/GetWorldMarketSubList' \
--header 'id: 10007' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "name": "Seleth Longsword",
    "icon": "cdn.arsha.io/icons/10007.png",
    "id": 10007,
    "sid": 0,
    "minEnhance": "0",
    "maxEnhance": "7",
    "basePrice": 200000,
    "currentStock": 1,
    "totalTrades": 311774,

GET

/GetWorldMarketSearchList

https://api.arsha.io/v2/:region/GetWorldMarketSearchList?ids=10007

SEARCH FOR ITEMS BY THEIR ID(S)

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

If multiple ids are given, returns a JsonArray of JsonObject of results of
search.
If only one id is given, returns a JsonObject of the searched item if it exists.

See request examples for details

PARAMS
ids
10007

Always required. Optionally a comma seperated list can also be supplied for
multiple results.

PATH VARIABLES
region
na

(Required) The game region



Market Search Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/GetWorldMarketSearchList?ids=10007'

Example Response
200 OK
Body
Header(1)

{
  "id": 10007,
  "currentStock": 1,
  "totalTrades": 317685,
  "basePrice": 179000
}

POST

/GetWorldMarketSearchList

https://api.arsha.io/v2/:region/GetWorldMarketSearchList

SEARCH FOR ITEMS BY THEIR ID(S)

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

If multiple ids are given, returns a JsonArray of JsonObject of results of
search.
If only one id is given, returns a JsonObject of the searched item if it exists.

See request examples for details

HEADERS
ids
10007

Always required. Optionally a comma seperated list can also be supplied for
multiple results.

PATH VARIABLES
region
na

(Required) The game region



Market Search Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/GetWorldMarketSearchList' \
--header 'ids: 10007'

Example Response
200 OK
Body
Header(1)

{
  "id": 10007,
  "currentStock": 1,
  "totalTrades": 317685,
  "basePrice": 179000
}

GET

/GetBiddingInfoList

https://api.arsha.io/v2/:region/GetBiddingInfoList?id=10007&sid=0

GET ORDERS OF AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

If multiple ids are given, returns a JsonArray of JsonObject orders.
If only one id is given, returns a JsonObject of the orders.

See request examples for details

PARAMS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Always required when more than one ID is supplied.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/GetBiddingInfoList?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "orders": [
    {
      "price": 185000,
      "buyers": 0,
      "sellers": 18
    },
    {
      "price": 176000,

POST

/GetBiddingInfoList

https://api.arsha.io/v2/:region/GetBiddingInfoList

GET ORDERS OF AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------


CURRENTLY DISABLED DUE TO PEARL ABYSS' API CHANGES

RESPONSE STRUCTURE

If multiple ids are given, returns a JsonArray of JsonObject orders.
If only one id is given, returns a JsonObject of the orders.

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Used to get enhancement level. Only required on
enhanceable items and defaults to 0 if absent.

PATH VARIABLES
region
na

(Required) The game region



Item Price History Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/GetBiddingInfoList' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "orders": [
    {
      "price": 185000,
      "buyers": 0,
      "sellers": 18
    },
    {
      "price": 176000,

GET

/GetMarketPriceInfo

https://api.arsha.io/v2/:region/GetMarketPriceInfo?id=10007&sid=0

GET PRICE HISTORY FOR AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

If multiple ids are given, returns a JsonArray of JsonObject of the items' price
history.
If only one id is given, returns a JsonObject of the item's price history.

See request examples for details

PARAMS
id
10007
sid
0
PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request GET 'https://api.arsha.io/v2/na/GetMarketPriceInfo?id=10007&sid=0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "history": {
    "1612035654": "170000",
    "1612122054": "170000",
    "1612208454": "170000",
    "1612294854": "188000",
    "1612381254": "188000",
    "1612467654": "225000",
    "1612554054": "231000",

POST

/GetMarketPriceInfo

https://api.arsha.io/v2/:region/GetMarketPriceInfo

GET PRICE HISTORY FOR AN ITEM OR LIST OF ITEMS

--------------------------------------------------------------------------------

RESPONSE STRUCTURE

If multiple ids are given, returns a JsonArray of JsonObject of the items' price
history.
If only one id is given, returns a JsonObject of the item's price history.

See request examples for details

HEADERS
id
10007

The item ID. Always required.

sid
0

The sub ID of the item. Used to get enhancement level. Only required on
enhanceable items and defaults to 0 if absent.

PATH VARIABLES
region
na

(Required) The game region



Item Order Details Singular
Example Request

curl --location --request POST 'https://api.arsha.io/v2/na/GetMarketPriceInfo' \
--header 'id: 10007' \
--header 'sid: 0'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": "10007",
  "sid": "0",
  "history": {
    "1612035654": "170000",
    "1612122054": "170000",
    "1612208454": "170000",
    "1612294854": "188000",
    "1612381254": "188000",
    "1612467654": "225000",
    "1612554054": "231000",

Utility


UTILITY ENDPOINTS FOR SCRAPED ITEMS/RECIPES

All results from these endpoints are scraped results from BDOCodex.

These databases are updated weekly after maintenance of the respective regions'
game servers.



Items


GET

Item Database

https://api.arsha.io/util/db?id=5409&lang=en

Returns name and grade of item from ID.


RESPONSE STRUCTURE

See request/response for details.

   
 * JSON Object with keys grade, name, id, icon
   

PARAMS
id
5409

The ID of the item to check for. Can be supplied multiple times for mutliple
results.

lang
en

Optional. If omitted defaults to en.



Example Request
Item

curl --location --request GET 'https://api.arsha.io/util/db?id=5409&lang=en'

Example Response
200 OK
Body
Header(1)

{
  "id": 5409,
  "name": "Dwarf Mushroom",
  "grade": "0",
  "icon": "cdn.arsha.io/icons/5409.png"
}

POST

Item Database

https://api.arsha.io/util/db

Returns name and grade of item from ID.


RESPONSE STRUCTURE

See request/response for details.

   
 * JSON Object with keys grade, name, id, icon
   

HEADERS
id
748,781,734,771

The ID of the item to check for. Can be supplied multiple times for mutliple
results.

lang
en

Optional. If omitted defaults to en.



Example Request
Item

curl --location --request POST 'https://api.arsha.io/util/db' \
--header 'id: 10007' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)

{
  "id": 5409,
  "name": "Dwarf Mushroom",
  "grade": "0",
  "icon": "cdn.arsha.io/icons/5409.png"
}

GET

Item Database Dump

https://api.arsha.io/util/db/dump?lang=en


ALL ITEMS IN DATABASE

Returns all items in the database for the specified lang

PARAMS
lang
en

Optional. If omitted returns all items from all supported locales.



Example Request
Item Database

curl --location --request GET 'https://api.arsha.io/util/db/dump?lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
    {
        "id": 800109,
        "name": "Jewel Covered in Sticky Goo",
        "grade": "1",
        "icon": "cdn.arsha.io/icons/800109.png"
    },
    {
        "id": 800108,
        "name": "Object Tangled in an Abandoned Net",
        "grade": "1",

Recipes



Material Groups


GET

Recipe Material Groups Database

https://api.arsha.io/util/db/recipes/matgroups?id=1&lang=en


MATERIAL GROUPS FOR COOKING AND ALCHEMY

Returns a material group from ID.

{
  "id": <MAT GROUP ID>,
  "mg": [
    "ID OF COMPONENT": {
      "name": "NAME OF ITEM",
      "id": "ID OF COMPONENT"
    }
  ]
}  


PARAMS
id
1

The recipe ID. Can be supplied multiple times for mutliple results.

lang
en

Optional. If omitted defaults to en.



Example Request
Material Group

curl --location --request GET 'https://api.arsha.io/util/db/recipes/materialgroups?id=1&lang=en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 1,
  "mg": {
    "7001": {
      "name": "Wheat",
      "id": "7001"
    },
    "7002": {
      "name": "Barley",
      "id": "7002"
    },

POST

Recipe Material Groups Database

https://api.arsha.io/util/db/recipes/matgroups


MATERIAL GROUPS FOR COOKING AND ALCHEMY

Returns a material group from ID.

{
  "id": <MAT GROUP ID>,
  "mg": [
    "ID OF COMPONENT": {
      "name": "NAME OF ITEM",
      "id": "ID OF COMPONENT"
    }
  ]
}  


HEADERS
id
1

The ID of the material group to check for. Can be supplied multiple times for
mutliple results.

lang
en

Optional. If omitted defaults to en.



Example Request
Material Group

curl --location --request POST 'https://api.arsha.io/util/db/recipes/materialgroups' \
--header 'id: 1' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 1,
  "mg": {
    "7001": {
      "name": "Wheat",
      "id": "7001"
    },
    "7002": {
      "name": "Barley",
      "id": "7002"
    },

GET

Recipe Material Groups Database Dump

https://api.arsha.io/util/db/recipes/matgroups/dump?lang=en


ALL MATERIAL GROUPS IN DATABASE

Returns all material groups in the database for the specified lang

PARAMS
lang
en

Optional. If omitted returns all items from all supported locales.



Example Request
Material Group Database

curl --location --request GET 'https://api.arsha.io/util/db/recipes/matgroups/dump?lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
    {
        "id": 1,
        "mg": {
            "7001": {
                "name": "Wheat",
                "id": "7001"
            },
            "7002": {
                "name": "Barley",
                "id": "7002"

GET

Recipe Database

https://api.arsha.io/util/db/recipes?id=1&lang=en


COOKING AND ALCHEMY RECIPES

Returns a recipe for an item from ID.


RESPONSE STRUCTURE

The following JSON Object is returned if found.

--------------------------------------------------------------------------------

Make sure to check if a recipe allows a material group to be used as a
component. A material group is a group of items that all can be used for that
component.

View More

{
  "id": <RECIPE ID>,
  "name": "NAME OF RECIPE"
  "lifeskill": "LIFESKILL",
  "level": "REQUIRED LIFESKILL LEVEL",
  "exp": "EXPERIENCE GAINED",
  "components": [
    {
      "id": <ID OF COMPONENT>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    },
    {
      "materialGroup": <ID OF MAT GROUP>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    }
  ],
  "products": [
    {
      "id": <ID OF PRODUCT>,
      "quantity": <QUANTITY OF PRODUCT>
    }
  ]
}  


PARAMS
id
1

The recipe ID. Can be supplied multiple times for mutliple results.

lang
en

Optional. If omitted defaults to en.



Example Request
Recipe

curl --location --request GET 'https://api.arsha.io/util/db/recipes?id=1&lang=en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 1,
  "name": "Elixir of Amity",
  "lifeskill": "Alchemy",
  "level": "Apprentice 1",
  "exp": "920",
  "components": [
    {
      "id": 6351,
      "quantity": 1
    },

POST

Recipe Database

https://api.arsha.io/util/db/recipes


COOKING AND ALCHEMY RECIPES

Returns a recipe for an item from ID.


RESPONSE STRUCTURE

The following JSON Object is returned if found.

--------------------------------------------------------------------------------

Make sure to check if a recipe allows a material group to be used as a
component. A material group is a group of items that all can be used for that
component.

View More

{
  "id": <RECIPE ID>,
  "name": "NAME OF RECIPE"
  "lifeskill": "LIFESKILL",
  "level": "REQUIRED LIFESKILL LEVEL",
  "exp": "EXPERIENCE GAINED",
  "components": [
    {
      "id": <ID OF COMPONENT>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    },
    {
      "materialGroup": <ID OF MAT GROUP>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    }
  ],
  "products": [
    {
      "id": <ID OF PRODUCT>,
      "quantity": <QUANTITY OF PRODUCT>
    }
  ]
}  


HEADERS
id
1

The ID of the recipe to check for. Can be supplied multiple times for mutliple
results.

lang
en

Optional. If omitted defaults to en.



Example Request
Recipe

curl --location --request POST 'https://api.arsha.io/util/db/recipes' \
--header 'id: 1' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 1,
  "name": "Elixir of Amity",
  "lifeskill": "Alchemy",
  "level": "Apprentice 1",
  "exp": "920",
  "components": [
    {
      "id": 6351,
      "quantity": 1
    },

GET

Recipe Database Dump

https://api.arsha.io/util/db/recipes/dump?lang=en


ALL RECIPES IN DATABASE

Returns all recipes in the database for the specified lang

PARAMS
lang
en

Optional. If omitted returns all items from all supported locales.



Example Request
Recipe Database

curl --location --request GET 'https://api.arsha.io/util/db/recipes/dump?lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
    {
        "id": 1,
        "name": "Elixir of Amity",
        "lifeskill": "Alchemy",
        "level": "Apprentice 1",
        "exp": "920",
        "components": [
            {
                "id": 6351,
                "quantity": 1

M-Recipes



Material Groups


GET

M-Recipe Material Groups Database

https://api.arsha.io/util/db/mrecipes/matgroups?id=7&lang=en


MATERIAL GROUPS FOR ALL LIFESKILLS EXCEPT COOKING AND ALCHEMY

Returns a material group from ID.

{
  "id": <MAT GROUP ID>,
  "mg": [
    "ID OF COMPONENT": {
      "name": "NAME OF ITEM",
      "id": "ID OF COMPONENT"
    }
  ]
}  


PARAMS
id
7

The recipe ID. Can be supplied multiple times for mutliple results.

lang
en

Optional. If omitted defaults to en.



Example Request
Material Group

curl --location --request GET 'https://api.arsha.io/util/db/mrecipes/materialgroups?id=7&lang=en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 7,
  "mg": {
    "7916": {
      "name": "Kuku Bird Meat",
      "id": "7916"
    },
    "7917": {
      "name": "Flamingo Meat",
      "id": "7917"
    },

POST

M-Recipe Material Groups Database

https://api.arsha.io/util/db/mrecipes/matgroups


MATERIAL GROUPS FOR ALL LIFESKILLS EXCEPT COOKING AND ALCHEMY

Returns a material group from ID.

{
  "id": <MAT GROUP ID>,
  "mg": [
    "ID OF COMPONENT": {
      "name": "NAME OF ITEM",
      "id": "ID OF COMPONENT"
    }
  ]
}  


HEADERS
id
7

The recipe ID. Can be supplied multiple times for mutliple results.

lang
en

Optional. If omitted defaults to en.



Example Request
Material Group

curl --location --request POST 'https://api.arsha.io/util/db/mrecipes/materialgroups' \
--header 'id: 7' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 7,
  "mg": {
    "7916": {
      "name": "Kuku Bird Meat",
      "id": "7916"
    },
    "7917": {
      "name": "Flamingo Meat",
      "id": "7917"
    },

GET

M-Recipe Material Groups Database Dump

https://api.arsha.io/util/db/mrecipes/matgroups/dump?lang=en


ALL M-MATERIAL GROUPS IN DATABASE

Returns all m-material groups in the database for the specified lang

PARAMS
lang
en

Optional. If omitted returns all items from all supported locales.



Example Request
Material Group Database

curl --location --request GET 'https://api.arsha.io/util/db/mrecipes/matgroups/dump?lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
  {
    "id": 7,
    "mg": {
      "7916": {
        "name": "Kuku Bird Meat",
        "id": "7916"
      },
      "7917": {
        "name": "Flamingo Meat",
        "id": "7917"

GET

M-Recipe Database

https://api.arsha.io/util/db/mrecipes?id=1&lang=en


RECIPES EXCEPT COOKING AND ALCHEMY

Returns a recipe for an item from ID.


RESPONSE STRUCTURE

The following JSON Object is returned if found.

--------------------------------------------------------------------------------

Make sure to check if a recipe allows a material group to be used as a
component. A material group is a group of items that all can be used for that
component.

View More

{
  "id": <RECIPE ID>,
  "name": "NAME OF RECIPE"
  "lifeskill": "LIFESKILL",
  "level": "REQUIRED LIFESKILL LEVEL",
  "exp": "EXPERIENCE GAINED",
  "components": [
    {
      "id": <ID OF COMPONENT>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    },
    {
      "materialGroup": <ID OF MAT GROUP>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    }
  ]
  "products": [
    {
      "id": <ID OF PRODUCT>,
      "quantity": <QUANTITY OF PRODUCT>
    }
  ]
}  


PARAMS
id
1

The recipe ID. Can be supplied multiple times for mutliple results.

lang
en

Optional. If omitted defaults to en.



Example Request
M-Recipe Database

curl --location --request GET 'https://api.arsha.io/util/db/mrecipes?id=1&lang=en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 1,
  "name": "Melted Iron Shard",
  "lifeskill": "Heating",
  "level": "Beginner 0",
  "exp": "",
  "components": [
    {
      "id": 4001,
      "quantity": 5
    }

POST

M-Recipe Database

https://api.arsha.io/util/db/mrecipes


RECIPES EXCEPT COOKING AND ALCHEMY

Returns a recipe for an item from ID.


RESPONSE STRUCTURE

The following JSON Object is returned if found.

--------------------------------------------------------------------------------

Make sure to check if a recipe allows a material group to be used as a
component. A material group is a group of items that all can be used for that
component.

View More

{
  "id": <RECIPE ID>,
  "name": "NAME OF RECIPE"
  "lifeskill": "LIFESKILL",
  "level": "REQUIRED LIFESKILL LEVEL",
  "exp": "EXPERIENCE GAINED",
  "components": [
    {
      "id": <ID OF COMPONENT>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    },
    {
      "materialGroup": <ID OF MAT GROUP>,
      "quantity": <QUANTITY NEEDED OF COMPONENT>
    }
  ]
  "products": [
    {
      "id": <ID OF PRODUCT>,
      "quantity": <QUANTITY OF PRODUCT>
    }
  ]
}  


HEADERS
id
1

The ID of the recipe to check for. Can be supplied multiple times for mutliple
results.

lang
en

Optional. If omitted defaults to en.



Example Request
M-Recipe Database

curl --location --request POST 'https://api.arsha.io/util/db/mrecipes' \
--header 'id: 1' \
--header 'lang: en'

Example Response
200 OK
Body
Header(1)
View More

{
  "id": 1,
  "name": "Melted Iron Shard",
  "lifeskill": "Heating",
  "level": "Beginner 0",
  "exp": "",
  "components": [
    {
      "id": 4001,
      "quantity": 5
    }

GET

M-Recipe Database Dump

https://api.arsha.io/util/db/mrecipes/dump?lang=en


ALL M-RECIPES IN DATABASE

Returns all m-recipes in the database for the specified lang

PARAMS
lang
en

Optional. If omitted returns all items from all supported locales.



Example Request
M-Recipe Database

curl --location --request GET 'https://api.arsha.io/util/db/mrecipes/dump?lang=en'

Example Response
200 OK
Body
Header(1)
View More

[
    {
        "id": 1,
        "name": "Melted Iron Shard",
        "lifeskill": "Heating",
        "level": "Beginner 0",
        "exp": "",
        "components": [
            {
                "id": 4001,
                "quantity": 5