We are not affiliated with Gaijin or Targem games in any way. We are just two guys with a passion for markets and games 😄
This is the Open Source Project for Crossout Market found here: http://crossoutdb.com/ it provides out of game prices, buy and sell offers as well as price and volume graphs. Also new are item stats, item descriptions, filters and improved usage of datatables.
Screenshot of the main page:
Example of the Clarinet Tow item page:
Example of recipe view:
Example of stats view:
This readme currently only covers some basics, please join our IRC channel if you need any help, with setting everything up properly.
You will need a few things to setup first:
- MySQL Server 5.x
- Visual Studio with .Net 4.6 installed.
- Some experience with Web Development.
Start with Forking the repo and import the MySQL from /Schema/crossout_structure_and_data_no_market.sql on your machine.
Then create the settings file in %appdata%/CrossoutWeb/WebSettings.json or start the project once since the file is created then and edit the file.
{
"CurrentVersion": "0.7.0",
"DatabaseName": "crossout",
"DatabaseHost": "localhost",
"DatabasePassword": "your db password",
"DatabaseUsername": "your db username",
"DatabasePort": 3306,
"SignalrHost": "localhost",
"WebserverPort": 80,
"DataHost": "localhost",
"GoogleConsumerKey": "",
"GoogleConsumerSecret": "",
"FileCarEditorWeaponsExLua": "Resources\\Data\\0.7.0\\gamedata\\def\\ex\\car_editor_weapons_ex.lua",
"FileCarEditorCabinsLua": "Resources\\Data\\0.7.0\\gamedata\\def\\ex\\car_editor_cabins.lua",
"FileCarEditorDecorumLua": "Resources\\Data\\0.7.0\\gamedata\\def\\ex\\car_editor_decorum.lua",
"FileCarEditorWheelsLua": "Resources\\Data\\0.7.0\\gamedata\\def\\ex\\car_editor_wheels.lua",
"FileCarEditorCoreLua": "Resources\\Data\\0.7.0\\gamedata\\def\\ex\\car_editor_core.lua",
"FileStringsEnglish": "Resources\\Data\\0.7.0\\strings\\english\\string.txt"
}You may need to start Visual Studio as Administrator for Nancy or Owins Selfhost to work.
Our api provides all data we have gathered so far, in an easy to use form.
The API provides Json formatted data models and are as self-explanatory as possible, if you have any questions you can join our IRC channel and we try to help.
All API endpoints currently use GET.
Even though the API is versioned, it can still change at any time without further notice. Hopefully there will be only fixes, but you have been warned :)
Do you have Ideas for more endpoints? Join our IRC or make an issue on our Github repository to tell us :)
/api/v1/
Results a list of all rarities
/api/v1/rarities
Results a list of all factions
/api/v1/factions
Results a list of all types
/api/v1/types
Results a list of all categories
/api/v1/categories
Results a list of items, optionally filtered by parameters.
/api/v1/items
/api/v1/items?rarity=&category=&faction=&removedItems=&metaItems=&query=
Optional Parameters
rarity : filters by rarity
category : filters by category
faction : filters by factions
removedItems : shows removed items (default false)
metaItems : shows meta items (default false)
query : search string
Examples
/api/v1/items?query=shotgun
/api/v1/items?rarity=rare&category=weapon
Results one item.
/api/v1/item/{item}
Mandatory Parameter
{item:int} : item id
Examples
/api/v1/item/1
Results the recipe of the given item. Includes the item and item stats for the item itself.
The recipe data structure is kind of complex and consists of all fields, we need on our site.
/api/v1/recipe/{item:int}
Mandatory Parameter
{item:int} : item id
Examples
/api/v1/recipe/1
Results the recipe of the given item. Includes the item and item stats for the item itself.
Recursively results all the ingredients for the items ingredients too.
/api/v1/recipe-deep/{item:int}
Mandatory Parameter
{item:int} : item id
Examples
/api/v1/recipe-deep/1
Results the market data in the form of an array. The First column is the timestamp and the second is the raw data value.
/api/v1/market/{name}/{id:int}
Mandatory Parameters
{name} : market column (sellprice, buyprice, selloffers, buyorders)
{item:int} : item id
Optional Parameters
unixTimestamp : use unix timestamps instead of the datetime type
/api/v1/market/buyprice/1
/api/v1/market/selloffers/1?unixTimestamp
Please note that prices are not formatted and are represented by full decimal values.
So to format, just divide by 100. For Example: 5125 / 100 = 51.25
Results all columns of market data in the form of an array.
0 = id
1 = sellprice
2 = buyprice
3 = selloffers
4 = buyorders
5 = datetime
6 = UNIX_TIMESTAMP(datetime)
/api/v1/market-all/{id:int}
Mandatory Parameters
{item:int} : item id
http://localhost/api/v1/market-all/1
- Items
- Recipes
- Categories
- Types
- Rarities
- Factions
Manual Work, we go ingame and enter it manually in our database 😄
We are currently reading the clients memory every ~5 minutes to get the most up to date market data.
We basically unpack the game files and read them.
Q: I don't find the part that reads the data from the market in your repo.
A: It's not part of the repository and not open source (yet), since we don't want that anyone plays with the games memory, also you could get banned for doing so.
Q: Can you implement feature XYZ.
A: Sure, we are allways open for suggestions, but we also have our own ideas and todo lists and we are working on this project in our free time.
Q: Where do I find the game files.
A: They are in the Crossout installation folder, you just need to unpack them. Contact us for more information.