auciel 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4a4db1df8b90eb61efa04eb689e247d0ba58d7e2469e0b06b4ccd3dce458511e
+  data.tar.gz: e4ae843ec6cc04501c3c517ae8c25bcf2f715dde4b54d74ea370dfed45a73b11
+SHA512:
+  metadata.gz: 45e2c98006106e4f76778456567dc8a68f7b000042e9afa6d1a5d3e79af7ddff46c5c4736c30dcb6a947c1e0091fb5c69eb6cae878766a23f45c7937342727ff
+  data.tar.gz: 0ac7d1a7ddf033ffa46cfb16d94a3b6ea4c979a074d0004ff32d564032bfd8ddcd244b8cd8360215e3183fc37ff972afcc41fecd2fd07b939b43d2da1323e661

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 jpegzilla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/lib/auciel.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'tsurezure'
+require_relative './endpoints/item'
+require_relative './endpoints/search'
+require_relative './endpoints/prices'
+require_relative './endpoints/hot'
+require_relative './endpoints/waitlist'
+
+# main class for auciel
+class Auciel
+  include ItemEndpoints
+  include SearchEndpoints
+  include PriceEndpoints
+  include HotEndpoints
+  include WaitlistEndpoints
+
+  def initialize(port = 8888)
+    @server = Tsurezure.new port
+    register_endpoints
+  end
+
+  def register_endpoints
+    # /item/:id
+    @server.register(*ItemEndpoints::GET_ITEM_BY_ID)
+
+    # /item/:cat/:sub
+    @server.register(*ItemEndpoints::GET_ITEM_BY_CATEGORY)
+
+    # /search
+    # requires a urlencoded string
+    @server.register(*SearchEndpoints::SEARCH_ITEM_BY_TEXT)
+
+    # /prices/:id
+    @server.register(*PriceEndpoints::GET_PRICE_LIST_BY_ID_AND_NAME)
+
+    # /hot
+    @server.register(*HotEndpoints::GET_HOT_ITEMS_LIST)
+
+    # /waitlist
+    @server.register(*WaitlistEndpoints::GET_WAITLIST_ITEMS)
+  end
+
+  def listen
+    @server.listen lambda { |opts|
+      puts "listening on port #{opts[:port]}!"
+    }
+  rescue Interrupt
+    puts '[auciel] shutting down.'
+  end
+end

data/lib/constants/constants.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Constants
+  COOKIE =
+    '__RequestVerificationToken=0q_pyZ8OMkALLxxv_pj6ty10hXKTDq3Sl_1NAbV5WYhUAbNvcurT6GwSUDmBRnaZVyEmd0lcTlR3I6X7_cXkAwH-nGQG_G2E6MQZPNcfNd41'
+  RVT = 'MGf54RSTVQkYrPo4Dvaf9IOuSilYwQIzWfdBI4PhFrV1l1o_e0BRmf78J6I7pVn_gcqj5DAv-G3MfFiWoUqFE3R62-Kxdcm4CgkRGd7oq7Y1'
+  ROOT_URL = 'https://na-trade.naeu.playblackdesert.com/Home'
+  WORLD_MARKET_LIST = '/GetWorldMarketList'
+  MARKET_SUB_LIST = '/GetWorldMarketSubList'
+  MARKET_SEARCH_LIST = '/GetWorldMarketSearchList'
+  MARKET_SELL_BUY_INFO = '/GetItemSellBuyInfo'
+  MARKET_HOT_LIST = '/GetWorldMarketHotList'
+  MARKET_WAIT_LIST = '/GetWorldMarketWaitList'
+  REQUEST_OPTS = {
+    method: 'post',
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded',
+      'User-Agent':
+      'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36',
+      Cookie: COOKIE
+    }
+  }.freeze
+end

data/lib/endpoints/hot.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require_relative './../constants/constants'
+require_relative './../utils/response_formatter'
+
+# get a list of currently popular items
+module HotEndpoints
+  include Constants
+  include FormData
+  include ResponseFormatter
+
+  def self.send_post_request(uri)
+    HTTParty.post(
+      uri,
+      headers: Constants::REQUEST_OPTS[:headers]
+    )
+  end
+
+  def self.respond_if_available(res)
+    return res.body if res.body
+
+    {
+      error: 'invalid response from the black desert api.',
+      response: res
+    }.to_json
+  end
+
+  def self.hot_items
+    lambda do |_req|
+      uri = URI "#{Constants::ROOT_URL}#{Constants::MARKET_HOT_LIST}"
+      res = send_post_request uri
+
+      ResponseFormatter.format_hot_response(respond_if_available(res))
+    end
+  end
+
+  GET_HOT_ITEMS_LIST = {
+    method: 'get',
+    path: '/hot',
+    responder: hot_items,
+    opts: { content_type: 'application/json' }
+  }.values.freeze
+end

data/lib/endpoints/item.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require_relative './../constants/constants'
+require_relative './../utils/response_formatter'
+
+# form data for various requests
+module FormData
+  def self.item_by_id_data(id)
+    {
+      __requestVerificationToken: Constants::RVT,
+      mainKey: id,
+      usingCleint: 0
+    }
+  end
+
+  def self.item_by_cat_data(cat, sub)
+    {
+      __requestVerificationToken: Constants::RVT,
+      mainCategory: cat,
+      subCategory: sub
+    }
+  end
+end
+
+# get item by id and other item-related methods
+module ItemEndpoints
+  include Constants
+  include FormData
+  include ResponseFormatter
+
+  def self.send_post_request(uri, data)
+    uri_params = URI.encode_www_form data
+
+    HTTParty.post(
+      uri,
+      body: uri_params,
+      headers: Constants::REQUEST_OPTS[:headers]
+    )
+  end
+
+  def self.respond_if_available(res)
+    return res.body if res.body
+
+    {
+      error: 'invalid response from the black desert api.',
+      response: res
+    }.to_json
+  end
+
+  def self.item_by_id
+    lambda do |req|
+      item_id = req[:vars]['id']
+      uri = URI "#{Constants::ROOT_URL}#{Constants::MARKET_SUB_LIST}"
+      form = FormData.item_by_id_data item_id
+      res = send_post_request uri, form
+
+      ResponseFormatter.format_item_response(respond_if_available(res))
+    end
+  end
+
+  def self.items_by_category
+    lambda do |req|
+      item_cat = req[:vars]['cat']
+      item_sub = req[:vars]['sub']
+      uri = URI "#{Constants::ROOT_URL}#{Constants::WORLD_MARKET_LIST}"
+      form = FormData.item_by_cat_data item_cat, item_sub
+      res = send_post_request uri, form
+
+      ResponseFormatter.format_cat_response(respond_if_available(res))
+    end
+  end
+
+  GET_ITEM_BY_ID = {
+    method: 'get',
+    path: '/item/:id',
+    responder: item_by_id,
+    opts: { content_type: 'application/json' }
+  }.values.freeze
+
+  GET_ITEM_BY_CATEGORY = {
+    method: 'get',
+    path: '/item/:cat/:sub',
+    responder: items_by_category,
+    opts: { content_type: 'application/json' }
+  }.values.freeze
+end

data/lib/endpoints/prices.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require_relative './../constants/constants'
+require_relative './../utils/response_formatter'
+
+# form data for various requests
+module FormData
+  def self.price_list_data(id)
+    {
+      __requestVerificationToken: Constants::RVT,
+      mainKey: id,
+      subKey: 0,
+      keyType: 0,
+      isUp: true
+    }
+  end
+end
+
+# get price list by id and name, and other price-related endpoints
+module PriceEndpoints
+  include Constants
+  include FormData
+  include ResponseFormatter
+
+  def self.send_post_request(uri, data)
+    uri_params = URI.encode_www_form data
+
+    HTTParty.post(
+      uri,
+      body: uri_params,
+      headers: Constants::REQUEST_OPTS[:headers]
+    )
+  end
+
+  def self.respond_if_available(res)
+    return res.body if res.body
+
+    {
+      error: 'invalid response from the black desert api.',
+      response: res
+    }.to_json
+  end
+
+  def self.price_list_by_id_and_name
+    lambda do |req|
+      item_id = req[:vars]['id']
+      uri = URI "#{Constants::ROOT_URL}#{Constants::MARKET_SELL_BUY_INFO}"
+      form = FormData.price_list_data item_id
+      res = send_post_request uri, form
+
+      ResponseFormatter.format_price_list_response(respond_if_available(res))
+    end
+  end
+
+  GET_PRICE_LIST_BY_ID_AND_NAME = {
+    method: 'get',
+    path: '/prices/:id',
+    responder: price_list_by_id_and_name,
+    opts: { content_type: 'application/json' }
+  }.values.freeze
+end

data/lib/endpoints/search.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require_relative './../constants/constants'
+require_relative './../utils/response_formatter'
+
+# form data for various requests
+module FormData
+  def self.search_item_by_text_data(search_text)
+    "__requestVerificationToken=#{Constants::RVT}&searchText=#{search_text}"
+  end
+end
+
+# search for item and other search-related methods
+module SearchEndpoints
+  include Constants
+  include FormData
+  include ResponseFormatter
+
+  def self.send_post_request(uri, data)
+    uri_params = data
+    uri_params = URI.encode_www_form(data) if data.is_a? Hash
+
+    HTTParty.post(
+      uri,
+      body: uri_params,
+      headers: Constants::REQUEST_OPTS[:headers]
+    )
+  end
+
+  def self.respond_if_available(res)
+    return res.body if res.body
+
+    {
+      error: 'invalid response from the black desert api.',
+      response: res
+    }.to_json
+  end
+
+  def self.search_item_by_text
+    lambda do |req|
+      search_text = req[:params]['q']
+      uri = URI "#{Constants::ROOT_URL}#{Constants::MARKET_SEARCH_LIST}"
+      form = FormData.search_item_by_text_data search_text
+      res = send_post_request uri, form
+
+      ResponseFormatter.format_search_response(respond_if_available(res))
+    end
+  end
+
+  SEARCH_ITEM_BY_TEXT = {
+    method: 'get',
+    path: '/search',
+    responder: search_item_by_text,
+    opts: { content_type: 'application/json' }
+  }.values.freeze
+end

data/lib/endpoints/waitlist.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require_relative './../constants/constants'
+require_relative './../utils/response_formatter'
+
+# get a list of items in the registration queue
+module WaitlistEndpoints
+  include Constants
+  include FormData
+  include ResponseFormatter
+
+  def self.send_post_request(uri)
+    HTTParty.post(
+      uri,
+      headers: Constants::REQUEST_OPTS[:headers]
+    )
+  end
+
+  def self.respond_if_available(res)
+    return res.body if res.body
+
+    {
+      error: 'invalid response from the black desert api.',
+      response: res
+    }.to_json
+  end
+
+  def self.waitlist_items
+    lambda do |_req|
+      uri = URI "#{Constants::ROOT_URL}#{Constants::MARKET_WAIT_LIST}"
+      res = send_post_request uri
+
+      ResponseFormatter.format_waitlist_response(respond_if_available(res))
+    end
+  end
+
+  GET_WAITLIST_ITEMS = {
+    method: 'get',
+    path: '/waitlist',
+    responder: waitlist_items,
+    opts: { content_type: 'application/json' }
+  }.values.freeze
+end

data/lib/utils/api_errors.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# contains all the errors the api can return.
+module ApiErrors
+  UNEXPECTED_BLACK_DESERT_RESPONSE = {
+    error: 'the black desert api returned an unexpected value. please report this to jpegzilla.'
+  }.freeze.to_json
+end

data/lib/utils/response_formatter.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require 'date'
+require_relative './api_errors'
+
+# rubocop:disable Lint/MissingCopEnableDirective, Metrics/MethodLength
+
+# used to format responses from the black desert api
+module ResponseFormatter
+  include ApiErrors
+
+  # returns an error message if the black desert api returns an error
+  def self.try_error(json)
+    return false if json['resultCode'].zero?
+
+    {
+      resultCode: json['resultCode'],
+      resultMsg: json['resultMsg']
+    }.to_json
+  end
+
+  # for /item/:id endpoint
+  def self.format_item_response(data)
+    json = JSON.parse(data)
+
+    return try_error json if try_error json
+
+    {
+      data: json['detailList'].map do |e|
+        {
+          **e,
+          id: e['mainKey']
+        }.except('mainKey')
+      end
+    }.to_json
+  rescue NoMethodError, JSON::ParserError
+    ApiErrors::UNEXPECTED_BLACK_DESERT_RESPONSE
+  end
+
+  # for /item/:cat/:sub endpoint
+  def self.format_cat_response(data)
+    json = JSON.parse(data)
+
+    return try_error json if try_error json
+
+    {
+      data: json['marketList'].map { |e| { **e, id: e['mainKey'] } }
+    }.to_json
+  rescue NoMethodError, JSON::ParserError
+    ApiErrors::UNEXPECTED_BLACK_DESERT_RESPONSE
+  end
+
+  # for /search endpoint
+  def self.format_search_response(data)
+    json = JSON.parse(data)
+
+    return try_error json if try_error json
+
+    {
+      data: json['list'].map { |e| { **e, id: e['mainKey'] } }
+    }.to_json
+  rescue NoMethodError, JSON::ParserError
+    ApiErrors::UNEXPECTED_BLACK_DESERT_RESPONSE
+  end
+
+  # for /prices endpoint
+  def self.format_price_list_response(data)
+    json = JSON.parse(data)
+
+    return try_error json if try_error json
+
+    {
+      data: {
+        pricePoints: json['priceList'],
+        buySellCounts: json['marketConditionList'],
+        **json
+      }.except('marketConditionList', 'priceList', 'resultCode')
+    }.to_json
+  rescue NoMethodError, JSON::ParserError
+    ApiErrors::UNEXPECTED_BLACK_DESERT_RESPONSE
+  end
+
+  # for /hot endpoint
+  def self.format_hot_response(data)
+    json = JSON.parse(data)
+
+    return try_error json if try_error json
+
+    {
+      data: json['hotList'].map do |e|
+        {
+          **e,
+          id: e['mainKey'],
+          fluctuationDirection: e['fluctuationType'] == 2 ? 'up' : 'down'
+        }
+      end
+    }.to_json
+  rescue NoMethodError, JSON::ParserError
+    ApiErrors::UNEXPECTED_BLACK_DESERT_RESPONSE
+  end
+
+  # for /waitlist endpoint
+  def self.format_waitlist_response(data)
+    json = JSON.parse(data)
+
+    return try_error json if try_error json
+
+    {
+      data: json['_waitList'].map do |e|
+        {
+          **e,
+          id: e['mainKey'],
+          waitEndTime: DateTime.strptime(e['_waitEndTime'].to_s, '%Q'),
+          waitEndTimestampMs: e['_waitEndTime'],
+          pricePerOne: e['_pricePerOne']
+        }.except('_pricePerOne', '_waitEndTime')
+      end
+    }.to_json
+  rescue NoMethodError, JSON::ParserError
+    ApiErrors::UNEXPECTED_BLACK_DESERT_RESPONSE
+  end
+end

data/readme.md

@@ -0,0 +1,319 @@
+# auciel
+
+auciel is a wrapper for the black desert central market api. its purpose is to enable developers to get data from the market more easily, without having to figure out the strict (and odd) request structures required for the raw central market api.
+
+built with the [tsurezure](https://github.com/jpegzilla/tsurezure) [![gem version](https://badge.fury.io/rb/tsurezure.svg)](https://badge.fury.io/rb/tsurezure) framework.
+
+## usage
+
+### installing from rubygems
+
+_no gem yet_
+
+### executable
+
+_coming soon_
+
+### using source code
+
+download this repo. then, in your ruby script:
+
+```ruby
+require_relative 'path/to/lib/auciel'
+
+# default port is 8888
+server = Auciel.new 8888
+
+# server will be ready for requests at localhost:8888
+server.listen
+```
+
+you can also just run `ruby main.rb` in the root directory and a server will start at `localhost:8888`.
+
+## endpoints
+
+### `/item/:id`
+
+retrieves information about an item based on its id. equivalent to `GetWorldMarketSubList` in the raw api. example:
+
+`GET https://localhost:8888/item/702`
+
+```js
+{
+  "data": [
+    {
+      "pricePerOne": 10700,
+      "totalTradeCount": 14269193,
+      "keyType": 0,
+      "mainKey": 702,
+      "subKey": 0,
+      "count": 0,
+      "name": "Elixir of Will",
+      "grade": 1,
+      "mainCategory": 35,
+      "subCategory": 2,
+      "chooseKey": 0,
+      "isGodrAyed": false
+    }
+  ]
+}
+
+```
+
+### `/item/:cat/:sub`
+
+retrieves a list of items in a [category and subcategory](#item-categories). equivalent to `GetWorldMarketList` in the raw api. example:
+
+`GET https://localhost:8888/item/35/1`
+```js
+{
+  "data": [
+    {
+      "mainKey": 504,
+      "sumCount": 0,
+      "name": "Melee AP Enhancer",
+      "grade": 0,
+      "isGodrAyed": false,
+      "minPrice": 93500,
+      "id": 504
+    },
+    {
+      "mainKey": 505,
+      "sumCount": 0,
+      "name": "Ranged AP Enhancer",
+      "grade": 0,
+      "isGodrAyed": false,
+      "minPrice": 93500,
+      "id": 505
+    },
+
+    ...
+
+```
+
+### `/search?q=<search text>`
+
+retrieves a list of items whose names match the provided **url encoded** search string. equivalent to `GetWorldMarketSearchList` in the raw api. example:
+
+`GET http://localhost:8888/search?q=blood`
+```js
+{
+  "data": [
+    {
+      "mainKey": 3040,
+      "sumCount": 1,
+      "totalSumCount": 77500000,
+      "name": "Muskan's Bloody Steel Helmet",
+      "grade": 2,
+      "isGodrAyed": false,
+      "id": 3040
+    },
+    {
+      "mainKey": 4453,
+      "sumCount": 2674,
+      "totalSumCount": 236000,
+      "name": "Blood Ruby",
+      "grade": 0,
+      "isGodrAyed": false,
+      "id": 4453
+    },
+    {
+      "mainKey": 5005,
+      "sumCount": 30309,
+      "totalSumCount": 19000,
+      "name": "Bloody Tree Knot",
+      "grade": 0,
+      "isGodrAyed": false,
+      "id": 5005
+    },
+
+    ...
+
+```
+
+### `/prices/:id`
+
+retrieves a detailed price list for a specified item id. equivalent to `GetItemSellBuyInfo` in the raw api, and similar to `GetBiddingInfoList`. example:
+
+`GET http://localhost:8888/prices/702`
+```js
+{
+  "data": {
+    "pricePoints": [
+      13500,
+      13600,
+      13700,
+      13800,
+      13900,
+      14000,
+      14100,
+      14200,
+      14300,
+      14400,
+      14500,
+      14600
+    ],
+    "buySellCounts": [
+      {
+        "sellCount": 0,
+        "buyCount": 0,
+        "pricePerOne": 12500
+      },
+      {
+        "sellCount": 0,
+        "buyCount": 0,
+        "pricePerOne": 12600
+      },
+      {
+        "sellCount": 0,
+        "buyCount": 0,
+        "pricePerOne": 12700
+      },
+
+    ...
+
+```
+
+### `/hot`
+
+retrieves a list of currently popular items. equivalent to `GetWorldMarketHotList` in the raw api. example:
+
+`GET http://localhost:8888/hot`
+```js
+{
+  "data": [
+    {
+      "subtype": 0,
+      "pricePerOne": 66000,
+      "totalTradeCount": 340891,
+      "fluctuationType": 2,
+      "fluctuationPrice": 12500,
+      "keyType": 0,
+      "mainKey": 641,
+      "subKey": 0,
+      "count": 0,
+      "name": "[Party] Elixir of Fury",
+      "grade": 1,
+      "mainCategory": 35,
+      "subCategory": 0,
+      "chooseKey": 0,
+      "isGodrAyed": false,
+      "id": 641,
+      "fluctuationDirection": "up"
+    },
+    {
+      "subtype": 0,
+      "pricePerOne": 47800,
+      "totalTradeCount": 1780501,
+      "fluctuationType": 1,
+      "fluctuationPrice": 12200,
+      "keyType": 0,
+      "mainKey": 683,
+      "subKey": 0,
+      "count": 8446,
+      "name": "Surging Energy Elixir",
+      "grade": 2,
+      "mainCategory": 35,
+      "subCategory": 0,
+      "chooseKey": 0,
+      "isGodrAyed": false,
+      "id": 683,
+      "fluctuationDirection": "down"
+    },
+
+    ...
+
+```
+
+### `/waitlist`
+
+retrieves a list of currently waitlisted items. equivalent to `GetWorldMarketWaitList` in the raw api. example:
+
+`GET http://localhost:8888/waitlist`
+```js
+{
+  "data": [
+    {
+      "keyType": 0,
+      "mainKey": 11103,
+      "subKey": 0,
+      "count": 0,
+      "name": "Urugon's Shoes",
+      "grade": 3,
+      "mainCategory": 15,
+      "subCategory": 0,
+      "chooseKey": 20,
+      "isGodrAyed": false,
+      "id": 11103,
+      "waitEndTime": "2023-03-04T20:03:55+00:00",
+      "waitEndTimestampMs": 1677960235417,
+      "pricePerOne": 12400000000
+    },
+    {
+      "keyType": 0,
+      "mainKey": 12230,
+      "subKey": 0,
+      "count": 0,
+      "name": "Basilisk's Belt",
+      "grade": 3,
+      "mainCategory": 20,
+      "subCategory": 0,
+      "chooseKey": 5,
+      "isGodrAyed": false,
+      "id": 12230,
+      "waitEndTime": "2023-03-04T20:11:04+00:00",
+      "waitEndTimestampMs": 1677960664373,
+      "pricePerOne": 53000000000
+    },
+
+    ...
+
+```
+
+## item categories
+
+here's a list of item types with their categories / subcategories for the `item/:cat/:sub` endpoint. for example, you could retrieve a list of foods at `item/35/4`.
+
+item type             | category | subcategories
+----------------------|----------|--------------
+main weapon           | 1        | 1-20
+sub-weapon            | 5        | 1-18
+awakening             | 10       | 1-24
+armor                 | 15       | 1-6
+accessories           | 20       | 1-4
+lightstone            | 85       | 1-5
+material              | 25       | 1-8
+enhancement / upgrade | 30       | 1-2
+consumables           | 35       | 1-8
+life tools            | 40       | 1-10
+alchemy stone         | 45       | 1-4
+magic crystal         | 50       | 1-4
+pearl item            | 55       | 1-8
+dye                   | 60       | 1-8
+mount                 | 65       | 1-13
+ship                  | 70       | 1-9
+wagon                 | 75       | 1-6
+furniture             | 80       | 1-9
+
+## item grades
+
+here's a list of item grades with their corresponding `grade` numbers as returned from the api.
+
+grade (border color) | number (`grade`)
+---------------------|-----------------
+white                | 0
+green                | 1
+blue                 | 2
+yellow               | 3
+orange               | 4
+
+## other info
+
+auciel is the name of the central market director at old wisdom tree.
+
+## stuff I don't know yet
+
+- [ ] what is `chooseKey` on certain items?
+- [ ] does `keyType` do anything?
+- [ ] why does every item have an `isGodrAyed` property, even non-godr-ayeable items?
+- [ ] can you get a list of every single item?

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: auciel
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- jpegzilla
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-03-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tsurezure
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.36
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.36
+description: an api used to get data from the black desert online central market.
+email: eris@jpegzilla.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- lib/auciel.rb
+- lib/constants/constants.rb
+- lib/endpoints/hot.rb
+- lib/endpoints/item.rb
+- lib/endpoints/prices.rb
+- lib/endpoints/search.rb
+- lib/endpoints/waitlist.rb
+- lib/utils/api_errors.rb
+- lib/utils/response_formatter.rb
+- readme.md
+homepage: https://github.com/jpegzilla/auciel
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.7
+signing_key:
+specification_version: 4
+summary: this is a wrapper for black desert's marketplace api.
+test_files: []