{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"0539c251-5838-4d15-94cd-565aa8293137","name":"BDO Market API v2","description":"**If you spot an error in these docs, need help or want to make a feature request,** [<b>fork</b>](https://app.getpostman.com/run-collection/4028519-0539c251-5838-4d15-94cd-565aa8293137?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D4028519-0539c251-5838-4d15-94cd-565aa8293137%26entityType%3Dcollection%26workspaceId%3D69d535c0-8852-452e-81a7-f8c8584e19f0#?env%5BNA%5D=W3sia2V5IjoicmVnaW9uIiwidmFsdWUiOiJuYSIsImVuYWJsZWQiOnRydWUsInNlc3Npb25WYWx1ZSI6Im5hIiwic2Vzc2lvbkluZGV4IjowfV0=) **this collection and make a pull request or join the** [<b>Discord</b>](https://discord.gg/8965jUwg3A) or DM @schober1\n\nSource code is available here: [<b>GitHub</b>](https://github.com/guy0090/api.arsha.io)\n\n---\n\n- Thank you to [<b>Veliainn</b>](https://developers.veliainn.com/) for documenting the API endpoints.\n    \n- Thank you to [<b>BDOCodex</b>](https://bdocodex.com/) for all item data.\n    \n- This API is a cached wrapper around the Black Desert Online market.\n    \n- All values are cached for **30 minutes** and deleted depending on usage frequency.\n    \n- **V1** Response structure mimics source structure while **V2** parses the information into a more clear JSON representation.\n    \n\n---\n\n# Context\n\nThe 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.\n\nThus 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.\n\n---\n\n# Usage As Omegapepega Replacement\n\nYou can use this API as a replacement to Omegapepega using [ImportJSON](https://github.com/bradjasper/ImportJSON)\n\nFor example, to get the price and name of an item, use the following and replace `:region`, `id`, `sid` and `lang` with your query:\n\n`=ImportJSON(\"https://api.arsha.io/v1/:region/price?id=10610&sid=20&lang=en\", \"/name,/basePrice\", \"noHeaders\")`\n\nThe same process applies to all other available endpoints, however the parameters used to query must be adjusted accordingly.\n\n---\n\n# Available Regions\n\nReplace `:region` with one of the following:\n\n- `na`\n    \n- `eu`\n    \n- `sea`\n    \n- `mena`\n    \n- `kr`\n    \n- `ru`\n    \n- `jp`\n    \n- `th`\n    \n- `tw`\n    \n- `sa`\n    \n- `console_eu`\n    \n- `console_na`\n    \n- `console_asia`\n    \n\n## Supported Languages\n\nThe `lang` parameter can be any of the following:\n\n`en` = English  \n`de` = German  \n`fr` = French  \n`ru` = Russian  \n`es` = Spanish (EU)  \n`sp` = Portuguese (RedFox)  \n`pt` = Portuguese  \n`jp` = Japanese  \n`kr` = Korean  \n`th` = Thai  \n`tr` = Turkish  \n`tw` = Chinese (Taiwan)  \n`cn` = Chinese (Mainland)\n\n## WebSocket Events\n\nAs of `v1.0.4`, an additional WebSocket endpoint is available under `wss://api.arsha.io/events`. Whenever an entry expires in the cache an event is published containing the ID, region and endpoint.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"4028519","team":1526223,"collectionId":"0539c251-5838-4d15-94cd-565aa8293137","publishedId":"2s9Y5YRhp4","public":true,"publicUrl":"https://documenter-api.postman.tech/view/4028519/2s9Y5YRhp4","privateUrl":"https://go.postman.co/documentation/4028519-0539c251-5838-4d15-94cd-565aa8293137","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"BDO, Black Desert, Market, API, Wrapper, Cache"},{"name":"title","value":"Black Desert Online Market API"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2023-08-26T20:39:05.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Black Desert Online Market API","description":"BDO, Black Desert, Market, API, Wrapper, Cache"},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"NA","id":"bed8cfa0-a787-4278-add0-681c2a0fea4b","owner":"4028519","values":[{"key":"region","value":"na","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/1ae4cf02233673d9739c6b531357a80e129954167042e1a922805a73ffc897ee","favicon":"https://res.cloudinary.com/postman/image/upload/v1611316519/team/mcn8t6afh4jxiku1xg06.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"NA","value":"4028519-bed8cfa0-a787-4278-add0-681c2a0fea4b"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2s9Y5YRhp4"}