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
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 DOMText 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