CS2
API
BitSkins REST API V2
Welcome to the documentation for the BitSkins, a RESTful API that provides access to managing your account, trades and items. This document will guide you through the various endpoints, request formats, authentication, and other important details to help you successfully integrate and utilize our API.
Base URL
The base URL for all API requests is: https://api.bitskins.com
API Authentication
To access the API, you need to authenticate your requests, by providing one of headers:
-
x-auth-token - you will get token after successful login
-
x-apikey - you will get it from settings
after enabling API access
DO NOT SHARE THIS CREDENTIALS TO ANYONE
Keep in mind that both token and API key can be used to authorize all your actions.
If you are using version control like git, make sure to not include access keys in commits.
Two-factor authentication
Two-Factor Authentication (2FA) is an additional layer of security designed to protect your
account and assets.
In order to use make some requests (i.e. wallet withdraw), you will need
to provide two-factor authentication code.
Remember to store backup codes in a safe place in
case you lose access to your primary authentication method.
You can manage your Two-Factor
Authentication in the settings or via API.
Generating 2FA Codes
You may need to synchronize your device's clock for the above code(s) to work:
copy
# Ubuntu Example:
$ sudo apt-get install ntp -yRequest Formats
The API accepts requests in JSON format. You can use GET and POST requests. For POST requests, the request body should include the required data in a valid JSON structure. Refer to the individual endpoint descriptions for specific details on request formats and data requirements.
Rate limits
Global - 50 requests per 10 seconds
/market/search/* - 1 request per second
Important: The above limits are dynamic and may be automatically reduced depending on the current load on our servers.
Account
Profile
Get current session
GET
/account/profile/meGet current session information.
Sample request (APIKEY)
Sample response
Get account balance
POST
/account/profile/balanceGet account balance.
Sample request (APIKEY)
Sample response
Update account
POST
/account/profile/updateUpdate account information app settings, notifications, store, currency, language, etc.
Request schema
copy
{
"set": {
"strict": "remove",
"minProps": 1,
"type": "object",
"props": {
"o_settings": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308,
"optional": true
},
"o_notify": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308,
"optional": true
},
"store_alias": {
"type": "string",
"min": 3,
"max": 20,
"optional": true
},
"currency": {
"type": "enum",
"values": [
"USD",
"PLN",
"BTC",
"LTC",
"ETH",
"EUR"
],
"optional": true
},
"language": {
"type": "enum",
"values": [
"en",
"pl",
"ru",
"zh",
"fr",
"pt",
"de",
"es",
"id",
"hi",
"ja",
"ar"
],
"optional": true
}
}
}
}Sample request (APIKEY)
Sample response
ENUMS: LANGUAGE, CURRENCY, USER_SETTINGS, USER_NOTIFY
copy
{
"en": "en",
"pl": "pl",
"ru": "ru",
"zh": "zh",
"fr": "fr",
"pt": "pt",
"de": "de",
"es": "es",
"id": "id",
"hi": "hi",
"ja": "ja",
"ar": "ar"
}Update trade link
POST
/account/profile/update_tradelinkUpdate steam trade link. You can get it here: https://steamcommunity.com/my/tradeoffers/privacy#trade_offer_access_url
Request schema
copy
{
"tradelink": {
"type": "url",
"min": 100
}
}Sample request (APIKEY)
Sample response
Block my account
POST
/account/profile/blockIf you believe that your account has been compromised you can temporarily block it. We will unblock your account after contacting our support.
Sample request (APIKEY)
Affiliate
Get affiliate info
POST
/account/affiliate/meet affiliate info.
Sample request (APIKEY)
Claim money
POST
/account/affiliate/transfer_moneyClaim available money.
Sample request (APIKEY)
List historical rewards
POST
/account/affiliate/historyList historical rewards.
Request schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
}
}Sample request (APIKEY)
Set or change affiliate code
POST
/account/affiliate/set_codeSet or change affiliate code.
Request schema
copy
{
"code": {
"type": "string",
"min": 5,
"max": 24,
"pattern": {}
}
}Sample request (APIKEY)
Two-factor authentication
ENUMS: SESSION_STATUS
copy
{
"banned": -1,
"blocked": 0,
"active": 1,
"required": 2,
"timeout": 3,
"fully_active": 4
}Create 2FA
POST
/account/twofa/createIn response you will get twofa_secret, you can use to generate 2FA codes.
Sample request (TOKEN)
Verify creating 2FA
POST
/account/twofa/verifyRequest schema
copy
{
"email_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
},
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}Sample request (TOKEN)
Disable 2FA
POST
/account/twofa/disableRequest schema
copy
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}Sample request (TOKEN)
Verify disabling 2FA
POST
/account/twofa/verify_disableRequest schema
copy
{
"email_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}Sample request (TOKEN)
Lock 2FA
POST
/account/twofa/lockLock account, so it will need to enter 2FA code to make requests.
Sample request (TOKEN)
Unlock 2FA
POST
/account/twofa/unlockUnlock account with 2FA code.
Request schema
copy
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}Sample request (TOKEN)
API access
Create API key
POST
/account/apikey/createCreate API key, so you will be able to use it in next requests instead of token. Keep it safe!
Sample request (TOKEN)
Disable API key
POST
/account/apikey/disableRevoke current API key.
Sample request (APIKEY)
Config
Currency rates
Get currency rates
GET
/config/currency/listGet fiat and crypto rates on the platform. Fiat rates are used for provisional preview only. All in-platform transactions are calculated in USD. Crypto currencies are used as based rates for depositing and withdrawing.
Sample request (APIKEY)
Fee plans
Get fee plans
GET
/config/fee_plan/listGet available sale fee plans.
Sample request (APIKEY)
Platform status
Get platform status
GET
/config/status/getSample request (APIKEY)
ENUMS: GLOBAL_PLATFORM_STATUS
copy
{
"loading": -2,
"offline": -1,
"steam_down": 0,
"active": 1
}Market
ENUMS: APP_ID, INVENTORY_STATUS, INVENTORY_STATUS_GROUP
copy
{
"cs2": 730,
"csgo": 730,
"dota2": 570,
"tf2": 440,
"rust": 252490
}Pricing
Get sales
POST
/market/pricing/listGet latest sales for item.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"skin_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
}
}Sample request (APIKEY)
Get pricing summary
POST
/market/pricing/summaryGet sales stats for item, can be filtered by date.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"skin_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"date_from": {
"type": "string",
"pattern": {},
"optional": true
},
"date_to": {
"type": "string",
"pattern": {},
"optional": true
}
}Sample request (APIKEY)
Market items
Dota 2 Market
POST
/market/search/570Search for items on the Dota 2 market.
Request schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 2000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"price",
"id",
"discount",
"bumped_at"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"where_mine": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"status": {
"type": "array",
"min": 1,
"items": {
"type": "enum",
"values": [
2,
3,
4,
0,
5,
1,
-1,
-4
]
},
"optional": true
}
}
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "string",
"pattern": {}
},
"optional": true
},
"name": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true,
"optional": true
},
"skin_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"price_from": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"price_to": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"discount_from": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"discount_to": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"skin_name": {
"type": "string",
"min": 1,
"max": 128,
"clear_empty": true,
"optional": true
},
"store_alias": {
"type": "string",
"min": 3,
"max": 20,
"optional": true
},
"store_hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
},
"is_favorite": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"tradehold_from": {
"type": "number",
"min": 0,
"max": 169,
"integer": true,
"optional": true
},
"tradehold_to": {
"type": "number",
"min": 0,
"max": 169,
"integer": true,
"optional": true
},
"color_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"hero_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"quality_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"rarity_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"slot_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"type_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
}
}
}
}Sample request (APIKEY)
CS2 Market
POST
/market/search/730Search for items on the CS2 market.
Request schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 2000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"price",
"id",
"discount",
"bumped_at",
"float_value",
"paint_index",
"paint_seed",
"extras_1"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"order_by_list": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"exterior_id"
]
},
"order": {
"type": "array",
"unique": true,
"min": 1,
"max": 10,
"items": {
"type": "number",
"integer": true,
"min": 1,
"max": 10
}
}
}
},
"where_mine": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"status": {
"type": "array",
"min": 1,
"items": {
"type": "enum",
"values": [
2,
3,
4,
0,
5,
1,
-1,
-4
]
},
"optional": true
}
}
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "string",
"pattern": {}
},
"optional": true
},
"name": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true,
"optional": true
},
"skin_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"price_from": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"price_to": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"discount_from": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"discount_to": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"skin_name": {
"type": "string",
"min": 1,
"max": 128,
"clear_empty": true,
"optional": true
},
"store_alias": {
"type": "string",
"min": 3,
"max": 20,
"optional": true
},
"store_hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
},
"is_favorite": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"has_nametag": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"has_hightier": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"stickers": {
"min": 1,
"max": 5,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"skin_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"slot": {
"type": "number",
"min": 0,
"max": 5,
"integer": true,
"optional": true
},
"wear": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
}
}
},
"optional": true
},
"sticker_wear": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"sticker_counter_from": {
"type": "number",
"min": 0,
"max": 5,
"integer": true,
"optional": true
},
"sticker_counter_to": {
"type": "number",
"min": 0,
"max": 5,
"integer": true,
"optional": true
},
"tradehold_from": {
"type": "number",
"min": 0,
"max": 8,
"integer": true,
"optional": true
},
"tradehold_to": {
"type": "number",
"min": 0,
"max": 8,
"integer": true,
"optional": true
},
"float_value_from": {
"type": "number",
"min": 0,
"max": 1,
"optional": true
},
"float_value_to": {
"type": "number",
"min": 0,
"max": 1,
"optional": true
},
"extras_1_from": {
"type": "number",
"min": 0,
"max": 100000000,
"optional": true
},
"extras_1_to": {
"type": "number",
"min": 0,
"max": 100000000,
"optional": true
},
"category_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"collection_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"container_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"color_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"exterior_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_seed": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_index": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"phase_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"quality_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"typesub_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"type_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
}
}
}
}Sample request (APIKEY)
Mine CS2 Items
POST
/market/search/mine/730Search for CS2 items you own.
Request schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"price",
"id",
"discount",
"bumped_at",
"float_value",
"paint_index",
"paint_seed",
"extras_1"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"order_by_list": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"exterior_id"
]
},
"order": {
"type": "array",
"unique": true,
"min": 1,
"max": 10,
"items": {
"type": "number",
"integer": true,
"min": 1,
"max": 10
}
}
}
},
"where_mine": {
"strict": "remove",
"type": "object",
"props": {
"status": {
"type": "array",
"min": 1,
"items": {
"type": "enum",
"values": [
2,
3,
4,
0,
5,
1,
-1,
-4
]
}
}
},
"optional": false
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "string",
"pattern": {}
},
"optional": true
},
"name": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true,
"optional": true
},
"skin_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"price_from": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"price_to": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"discount_from": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"discount_to": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"skin_name": {
"type": "string",
"min": 1,
"max": 128,
"clear_empty": true,
"optional": true
},
"store_alias": {
"type": "string",
"min": 3,
"max": 20,
"optional": true
},
"store_hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
},
"is_favorite": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"has_nametag": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"has_hightier": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"stickers": {
"min": 1,
"max": 5,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"skin_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"slot": {
"type": "number",
"min": 0,
"max": 5,
"integer": true,
"optional": true
},
"wear": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
}
}
},
"optional": true
},
"sticker_wear": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"sticker_counter_from": {
"type": "number",
"min": 0,
"max": 5,
"integer": true,
"optional": true
},
"sticker_counter_to": {
"type": "number",
"min": 0,
"max": 5,
"integer": true,
"optional": true
},
"tradehold_from": {
"type": "number",
"min": 0,
"max": 8,
"integer": true,
"optional": true
},
"tradehold_to": {
"type": "number",
"min": 0,
"max": 8,
"integer": true,
"optional": true
},
"float_value_from": {
"type": "number",
"min": 0,
"max": 1,
"optional": true
},
"float_value_to": {
"type": "number",
"min": 0,
"max": 1,
"optional": true
},
"extras_1_from": {
"type": "number",
"min": 0,
"max": 100000000,
"optional": true
},
"extras_1_to": {
"type": "number",
"min": 0,
"max": 100000000,
"optional": true
},
"category_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"collection_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"container_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"color_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"exterior_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_seed": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_index": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"phase_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"quality_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"typesub_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"type_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
}
}
}
}Sample request (APIKEY)
Mine Dota 2 Items
POST
/market/search/mine/570Search for Dota 2 items you own.
Request schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"price",
"id",
"discount",
"bumped_at"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"where_mine": {
"strict": "remove",
"type": "object",
"props": {
"status": {
"type": "array",
"min": 1,
"items": {
"type": "enum",
"values": [
2,
3,
4,
0,
5,
1,
-1,
-4
]
}
}
},
"optional": false
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "string",
"pattern": {}
},
"optional": true
},
"name": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true,
"optional": true
},
"skin_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"price_from": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"price_to": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true,
"optional": true
},
"discount_from": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"discount_to": {
"type": "number",
"min": 0,
"max": 100,
"integer": true,
"optional": true
},
"skin_name": {
"type": "string",
"min": 1,
"max": 128,
"clear_empty": true,
"optional": true
},
"store_alias": {
"type": "string",
"min": 3,
"max": 20,
"optional": true
},
"store_hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
},
"is_favorite": {
"type": "number",
"min": 0,
"max": 1,
"integer": true,
"optional": true
},
"tradehold_from": {
"type": "number",
"min": 0,
"max": 169,
"integer": true,
"optional": true
},
"tradehold_to": {
"type": "number",
"min": 0,
"max": 169,
"integer": true,
"optional": true
},
"color_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"hero_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"quality_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"rarity_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"slot_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"type_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
}
}
}
}Sample request (APIKEY)
User store
POST
/market/search/storeGet amount of items in the user store.
Request schema
copy
{
"store_alias": {
"type": "string",
"min": 3,
"max": 20
},
"store_hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
}
}Sample request (APIKEY)
Get item details
POST
/market/search/getGet item details of single item.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {},
"optional": true
},
"asset_id": {
"type": "string",
"pattern": {},
"optional": true
},
"hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
}
}Sample request (APIKEY)
Search skin
POST
/market/search/skin_nameSearch for item skins in game
Request schema
copy
{
"where": {
"strict": "remove",
"type": "object",
"props": {
"skin_name": {
"type": "string",
"min": 1,
"max": 128,
"clear_empty": true,
"optional": true
},
"id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"paint_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"category_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"collection_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"type_id": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "number",
"integer": true,
"min": 0,
"max": 1.7976931348623157e+308
},
"optional": true
},
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"optional": true
}
}
},
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
}
}Sample request (APIKEY)
Filters
POST
/market/search/filtersGet available items filters for game.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
}
}Buy item
Buy single item
POST
/market/buy/singleRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"max_price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
},
"hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
}
}Sample request (APIKEY)
Buy multiple items
POST
/market/buy/manyRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"items": {
"min": 1,
"max": 100,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"id": {
"type": "string",
"pattern": {}
},
"max_price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
},
"hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
}
}
}
}
}Sample request (APIKEY)
Buy bulk items
POST
/market/buy/bulkBuy multiple items at once. You will buy items based on specified quantity and max price.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"skin_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"max_price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
},
"quantity": {
"type": "number",
"min": 1,
"max": 50,
"integer": true
}
}Sample request (APIKEY)
Withdraw
Withdraw single item
POST
/market/withdraw/singleWithdraw item from BitSkins inventory to your Steam account. Steam trade will be created.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"external": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"steam_id": {
"type": "string",
"pattern": {},
"min": 17,
"max": 17
},
"steam_token": {
"type": "string",
"min": 8,
"max": 8
}
}
}
}Sample request (APIKEY)
Withdraw multiple items
POST
/market/withdraw/manyWithdraw multiple items from BitSkins inventory to your Steam account. Steam trades will be created.
Request schema
copy
{
"items": {
"min": 1,
"max": 20,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"external": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"steam_id": {
"type": "string",
"pattern": {},
"min": 17,
"max": 17
},
"steam_token": {
"type": "string",
"min": 8,
"max": 8
}
}
}
}
}
}
}Sample request (APIKEY)
Delist
Delist single item
POST
/market/delist/singleDelist item from market. Item will be moved to BitSkins inventory.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}Sample request (APIKEY)
Delist multiple items
POST
/market/delist/manyDelist multiple items from market. Items will be moved to BitSkins inventory.
Request schema
copy
{
"items": {
"min": 1,
"max": 100,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}
}
}
}Sample request (APIKEY)
Relist
ENUMS: DEPOSIT_TYPE
copy
{
"public": 1,
"private": 2,
"instant_sell": 3
}Relist single item
POST
/market/relist/singleRelist single item from BitSkins inventory to market.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
},
"type": {
"type": "enum",
"values": [
1,
2,
3
],
"default": 1
}
}Sample request (APIKEY)
Relist multiple items
POST
/market/relist/manyRelist multiple items from BitSkins inventory to market.
Request schema
copy
{
"items": {
"min": 1,
"max": 100,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
},
"type": {
"type": "enum",
"values": [
1,
2,
3
],
"default": 1
}
}
}
}
}Sample request (APIKEY)
Update price
Update single item price
POST
/market/update_price/singleUpdate single item price on market.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
}
}Sample request (APIKEY)
Update multiple items prices
POST
/market/update_price/manyUpdate multiple items on market.
Request schema
copy
{
"items": {
"min": 1,
"max": 100,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
}
}
}
}
}Sample request (APIKEY)
Items history
ENUMS: MARKET_HISTORY_TYPE
copy
{
"seller": "seller",
"buyer": "buyer"
}Get items history
POST
/market/history/listGet history of bought and sold items.
Request schema
copy
{
"type": {
"type": "enum",
"values": [
"seller",
"buyer"
]
},
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"id",
"price"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"optional": true
},
"skin_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308,
"optional": true
},
"price_from": {
"type": "number",
"min": -200000000,
"max": 200000000,
"amount": true,
"integer": true,
"optional": true
},
"price_to": {
"type": "number",
"min": -200000000,
"max": 200000000,
"amount": true,
"integer": true,
"optional": true
}
}
}
}Sample request (APIKEY)
Get item history
POST
/market/history/getRequest schema
copy
{
"type": {
"type": "enum",
"values": [
"seller",
"buyer"
]
},
"id": {
"type": "string",
"pattern": {}
}
}Sample request (APIKEY)
Receipt
Get receipt for bought items.
Get receipt
POST
/market/receipt/getRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}Sample request (APIKEY)
Bump UP
Bump up items to make them visible on first place to all users.
ENUMS: BUMPING, AUTOBUMP_STATUS, AUTOBUMP_PERIOD, BUMP_PACKAGE
copy
{
"price": 750,
"minimum_price": 10000
}Bump single item
POST
/market/bump/singleRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}Sample request (APIKEY)
Get bumped items
POST
/market/bump/listRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"status": {
"type": "enum",
"values": [
-3,
-2,
-1,
0,
1
],
"optional": true
}
}
}
}Sample request (APIKEY)
Enable bumping
POST
/market/bump/enableRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
},
"period": {
"type": "enum",
"values": [
60,
180,
360,
720,
1440,
2880
]
},
"quantity": {
"type": "number",
"min": 1,
"max": 100,
"integer": true
},
"delayed": {
"type": "number",
"min": 0,
"max": 1,
"integer": true
}
}Sample request (APIKEY)
Disable bumping
POST
/market/bump/disableRequest schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}Sample request (APIKEY)
Buy bumps package
POST
/market/bump/buy_packageRequest schema
copy
{
"id": {
"type": "enum",
"values": [
1,
2,
3,
4,
5,
6,
7,
8
]
}
}Sample request (APIKEY)
All available skins
Data may be cached.
Get list of all skins for Dota 2
GET
/market/skin/570Sample request (EMPTY)
Get list of all skins for CS2
GET
/market/skin/730Sample request (EMPTY)
All insell items
Data may be cached.
Get list of all items in sell for Dota 2
GET
/market/insell/570Sample request (EMPTY)
Get list of all items in sell for CS2
GET
/market/insell/730Sample request (EMPTY)
Steam
ENUMS: APP_ID, DEPOSIT_TYPE
copy
{
"cs2": 730,
"csgo": 730,
"dota2": 570,
"tf2": 440,
"rust": 252490
}Steam inventory
Get Steam inventory
POST
/steam/inventory/listGet list of items in your Steam inventory.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
}
}Sample request (APIKEY)
Steam deposit
Deposit Steam items
POST
/steam/deposit/manyDeposit Steam item and list it on BitSkins market. Steam trade will be created.
Request schema
copy
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"items": {
"min": 1,
"max": 100,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"asset_id": {
"type": "string",
"pattern": {}
},
"price": {
"type": "number",
"min": 10,
"max": 200000000,
"positive": true,
"amount": true,
"integer": true
}
}
}
},
"type": {
"type": "enum",
"values": [
1,
2,
3
],
"default": 1
}
}Sample request (APIKEY)
Steam trades
Get Steam trades
POST
/steam/trade/listRequest schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"tradeofferid": {
"type": "string",
"pattern": {},
"optional": true
},
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"optional": true
},
"type": {
"type": "enum",
"values": [
1,
2
],
"optional": true
},
"hash": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "string",
"min": 1,
"max": 64
},
"optional": true
}
}
}
}Sample request (APIKEY)
Get active Steam trades
POST
/steam/trade/activeRequest schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"tradeofferid": {
"type": "string",
"pattern": {},
"optional": true
},
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"optional": true
},
"type": {
"type": "enum",
"values": [
1,
2
],
"optional": true
},
"hash": {
"type": "array",
"min": 1,
"max": 100,
"items": {
"type": "string",
"min": 1,
"max": 64
},
"optional": true
}
}
}
}Sample request (APIKEY)
Get hashes of active Steam trades
POST
/steam/trade/active_hashSample request (APIKEY)
Wallet
Wallet stats
Get wallet stats
POST
/wallet/stats/getSample request (APIKEY)
Get KYC limits
POST
/wallet/stats/get_kyc_limitSample request (APIKEY)
Wallet transactions
ENUMS: SERVICE_ID
copy
{
"market.buy": 1,
"market.sell": 2,
"market.fee": 3,
"market.buy_order": 4,
"market.bargain": 5,
"market.instant_sell": 6,
"market.bump": 7,
"market.bump_package": 8,
"deposit.bitcoin": 30,
"deposit.litecoin": 31,
"deposit.ethereum": 32,
"deposit.unlimint": 33,
"deposit.zen": 34,
"deposit.gift_code": 35,
"deposit.binancepay": 36,
"withdraw.bitcoin": 50,
"withdraw.litecoin": 51,
"withdraw.ethereum": 52,
"withdraw.unlimint": 53,
"withdraw.tipalti": 54,
"withdraw.payoneer": 55,
"withdraw.binancepay": 56,
"withdraw.p2p": 57,
"wallet.transfer": 80,
"wallet.refund": 81,
"marketing.coupon": 100,
"marketing.referral": 101,
"marketing.affiliate": 102
}Get wallet transactions
POST
/wallet/transaction/listRequest schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"id",
"amount"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"amount_from": {
"type": "number",
"min": -200000000,
"max": 200000000,
"amount": true,
"integer": true,
"optional": true
},
"amount_to": {
"type": "number",
"min": -200000000,
"max": 200000000,
"amount": true,
"integer": true,
"optional": true
},
"created_at_from": {
"type": "string",
"pattern": {},
"optional": true
},
"created_at_to": {
"type": "string",
"pattern": {},
"optional": true
},
"service_id": {
"items": "number",
"min": 1,
"max": 10,
"unique": true,
"type": "array",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
30,
31,
32,
33,
34,
35,
36,
50,
51,
52,
53,
54,
55,
56,
57,
80,
81,
100,
101,
102
],
"optional": true
}
}
}
}Sample request (APIKEY)
Get wallet pending transactions
POST
/wallet/transaction/list_pendingRequest schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"id",
"amount"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"where": {
"strict": "remove",
"optional": true,
"type": "object",
"props": {
"amount_from": {
"type": "number",
"min": -200000000,
"max": 200000000,
"amount": true,
"integer": true,
"optional": true
},
"amount_to": {
"type": "number",
"min": -200000000,
"max": 200000000,
"amount": true,
"integer": true,
"optional": true
},
"created_at_from": {
"type": "string",
"pattern": {},
"optional": true
},
"created_at_to": {
"type": "string",
"pattern": {},
"optional": true
},
"service_id": {
"items": "number",
"min": 1,
"max": 10,
"unique": true,
"type": "array",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
30,
31,
32,
33,
34,
35,
36,
50,
51,
52,
53,
54,
55,
56,
57,
80,
81,
100,
101,
102
],
"optional": true
}
}
}
}Sample request (APIKEY)
Wallet reports
ENUMS: REPORT_TYPE, REPORT_STATUS
copy
{
"balance": 1,
"sell": 2,
"buy": 3
}Get wallet reports
POST
/wallet/report/listRequest schema
copy
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
},
"order": {
"optional": true,
"type": "array",
"items": {
"strict": "remove",
"type": "object",
"props": {
"field": {
"type": "enum",
"values": [
"id"
]
},
"order": {
"type": "enum",
"values": [
"ASC",
"DESC"
]
}
}
}
},
"where": {
"strict": "remove",
"type": "object",
"props": {
"type": {
"type": "enum",
"values": [
1,
2,
3
],
"optional": true
},
"status": {
"type": "enum",
"values": [
-1,
0,
1
],
"optional": true
}
}
}
}Sample request (APIKEY)
Generate wallet report
POST
/wallet/report/generateRequest schema
copy
{
"type": {
"type": "enum",
"values": [
1,
2,
3
]
},
"date": {
"type": "string",
"pattern": {}
}
}Sample request (APIKEY)
Download wallet report
POST
/wallet/report/downloadRequest schema
copy
{
"id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
}
}Sample request (APIKEY)
Wallet deposit
Binance
Deposit Binance
POST
/wallet/deposit/binancepay/createRequest schema
copy
{
"amount": {
"type": "number",
"min": 1000,
"max": 1000000,
"positive": true,
"integer": true,
"amount": true
}
}Sample request (APIKEY)
Cryptocurrency
ENUMS: CRYPTO_WALLET_TYPE
copy
{
"legacy": "legacy",
"segwit": "p2sh-segwit",
"native": "bech32"
}Get cryptocurrency addresses
POST
/wallet/deposit/crypto/list_addressesSample request (APIKEY)
Get Litecoin (LTC) address
POST
/wallet/deposit/crypto/get_litecoin_addressRequest schema
copy
{
"type": {
"type": "enum",
"values": [
"legacy",
"p2sh-segwit",
"bech32"
]
}
}Sample request (APIKEY)
Get Bitcoin (BTC) address
POST
/wallet/deposit/crypto/get_bitcoin_addressRequest schema
copy
{
"type": {
"type": "enum",
"values": [
"legacy",
"p2sh-segwit",
"bech32"
]
}
}Sample request (APIKEY)
Get Ethereum (ETH) address
POST
/wallet/deposit/crypto/get_ethereum_addressSample request (APIKEY)
Gift code
Use gift code
POST
/wallet/deposit/gift_code/useRequest schema
copy
{
"code": {
"type": "uuid"
}
}Sample request (APIKEY)
Get used gift codes
POST
/wallet/deposit/gift_code/list_usedSample request (APIKEY)
Zen
Deposit Zen
POST
/wallet/deposit/zen/createRequest schema
copy
{
"amount": {
"type": "number",
"min": 5000,
"max": 2500000,
"positive": true,
"integer": true,
"amount": true
}
}Sample request (APIKEY)
Card
Add card
POST
/wallet/deposit/unlimint/add_cardDeposit money on BitSkins via card.
Request schema
copy
{
"amount": {
"type": "number",
"min": 1000,
"max": 2500000,
"positive": true,
"integer": true,
"amount": true
},
"card": {
"strict": "remove",
"type": "object",
"props": {
"pan": {
"type": "string",
"min": 15,
"max": 19,
"pattern": {}
},
"holder": {
"type": "string",
"min": 1,
"max": 50
},
"security_code": {
"type": "string",
"min": 3,
"max": 4,
"pattern": {}
},
"expiration": {
"type": "string",
"pattern": {}
}
}
},
"billing_address": {
"strict": "remove",
"type": "object",
"props": {
"country": {
"type": "string",
"min": 2,
"max": 2,
"pattern": {}
},
"city": {
"type": "string",
"min": 1,
"max": 50
},
"addr_line_1": {
"type": "string",
"min": 1,
"max": 50
},
"addr_line_2": {
"type": "string",
"min": 1,
"max": 50,
"optional": true
},
"zip": {
"type": "string",
"min": 1,
"max": 50
}
}
}
}Sample request (APIKEY)
Get cards
POST
/wallet/deposit/unlimint/list_cardsSample request (APIKEY)
Deposit card
POST
/wallet/deposit/unlimint/card_depositDeposit money on BitSkins via card saved on BitSkins.
Request schema
copy
{
"card_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"amount": {
"type": "number",
"min": 1000,
"max": 2500000,
"positive": true,
"integer": true,
"amount": true
},
"security_code": {
"type": "string",
"min": 3,
"max": 4,
"pattern": {}
}
}Sample request (APIKEY)
Wallet withdraw
Cryptocurrency
Withdraw Bitcoin (BTC)
POST
/wallet/withdraw/crypto/litecoinRequest schema
copy
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
},
"amount": {
"type": "number",
"min": 5000,
"max": 25000000,
"positive": true,
"integer": true,
"amount": true
},
"address": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true
}
}Sample request (APIKEY)
Withdraw Litecoin (LTC)
POST
/wallet/withdraw/crypto/bitcoinRequest schema
copy
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
},
"amount": {
"type": "number",
"min": 100000,
"max": 25000000,
"positive": true,
"integer": true,
"amount": true
},
"address": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true
}
}Sample request (APIKEY)
Withdraw Ethereum (ETH)
POST
/wallet/withdraw/crypto/ethereumRequest schema
copy
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
},
"amount": {
"type": "number",
"min": 100,
"max": 5000000,
"positive": true,
"integer": true,
"amount": true
},
"address": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true
}
}Sample request (APIKEY)
Binance
Withdraw Binance
POST
/wallet/withdraw/binancepay/createWithdraw funds to your Binance account, using BinanceID.
Request schema
copy
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
},
"amount": {
"type": "number",
"min": 1000,
"max": 5000000,
"positive": true,
"integer": true,
"amount": true
},
"receiver": {
"type": "string",
"min": 1,
"max": 64,
"clear_empty": true
},
"receiver_type": {
"type": "enum",
"values": [
"BINANCE_ID",
"EMAIL"
],
"default": "BINANCE_ID"
}
}Sample request (APIKEY)
Visa
Withdraw Visa
POST
/wallet/withdraw/unlimint/card_withdrawWithdraw funds to your Visa card.
Request schema
copy
{
"card_id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
},
"amount": {
"type": "number",
"min": 5000,
"max": 1000000,
"positive": true,
"integer": true,
"amount": true
},
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}Sample request (APIKEY)
WebSocket
WebSocket can be used to receive updates about updates on website: balance changes, trades updates, ticket responses, new notifications.
The WebSocket endpoint URL is: wss://ws.bitskins.com
WebSocket authorization actions (WS_AUTH, WS_AUTH_APIKEY, WS_DEAUTH) reset the list of subscribed channels. If you subscribed to any channel before following these steps, be sure to subscribe again.
WS Actions
The following actions are available:
- WS_AUTH - authorize
a user using session token
- WS_AUTH_APIKEY - authorize a
user using apikey
- WS_DEAUTH - deauthorize session
-
WS_SUB - subscribe to a channel
- WS_UNSUB - unsubscribe from a channel
- WS_UNSUB_ALL - unsubscribe all channels
WS Channels
The following channels are available:
- listed
- delisted_or_sold
- price_changed
- extra_info
WebSocket example
Errors
The provided structure represents an error response for a REST API:
copy
{
"code": "GLO_015",
"error_type": "public",
"error_path": "global.missing_login_token"
}ENUMS: APP_ERROR
copy
{
"global": {
"internal": "GLO_000",
"not_allowed": "GLO_001",
"access_denied": "GLO_002",
"validator_error": "GLO_003",
"wrong_body": "GLO_004",
"wrong_token": "GLO_005",
"missing_token": "GLO_006",
"access_denied_acl": "GLO_007",
"connection_timeout": "GLO_008",
"login_required": "GLO_009",
"not_found": "GLO_010",
"wrong_value": "GLO_011",
"token_expired": "GLO_012",
"service_not_available": "GLO_013",
"twofa_required": "GLO_014",
"missing_login_token": "GLO_015"
},
"mutex": {
"long_lock": "MUT_001",
"exclusive_lock": "MUT_002"
},
"account": {
"banned": "ACC_001",
"blocked": "ACC_002",
"wrong_login_or_password": "ACC_003",
"wrong_login": "ACC_004",
"wrong_password": "ACC_005",
"missing_email": "ACC_006",
"same_password_used": "ACC_007",
"wrong_twofa": "ACC_008",
"twofa_not_created": "ACC_009",
"twofa_already_created": "ACC_010",
"twofa_limit": "ACC_011",
"not_exists": "ACC_012",
"migration": "ACC_013",
"wrong_password_pattern": "ACC_014",
"deleted": "ACC_015",
"same_email_used": "ACC_016",
"apikey_not_created": "BSA_001",
"apikey_already_created": "BSA_002",
"deletion_already_started": "BSA_003",
"external_withdraw_not_available": "BSA_004",
"kyc_wrong_step": "BSA_005",
"kyc_required": "BSA_006",
"action_not_allowed": "BSA_007"
},
"api": {
"missing_apikey": "API_001",
"missing_secret": "API_002",
"wrong_ip_address": "API_003",
"private_ip_address": "API_004",
"wrong_apikey": "API_005"
},
"record": {
"item_not_found": "REC_001",
"item_not_owned": "REC_002",
"own_item": "REC_003",
"already_exists": "REC_004",
"not_exists": "REC_005",
"not_updated": "REC_006",
"forbidden": "REC_007",
"wrong_status": "REC_008"
},
"payment": {
"card_scoring": "PAY_001",
"payment_issue": "PAY_002"
},
"auth": {
"failed_to_authenticate": "AUTH_001",
"not_valid_identity": "AUTH_002",
"authentication_failed": "AUTH_003"
},
"ipn": {
"verification_issue": "IPN_001"
},
"market": {
"wrong_item_status": "BSM_001",
"item_already_queued": "BSM_002",
"max_price_limit": "BSM_003",
"item_not_available": "BSM_004",
"plan_not_found": "BSM_005",
"no_items_found": "BSM_006",
"items_limit": "BSM_007",
"instant_sell_disabled": "BSM_008",
"price_too_low": "BSM_009",
"queue_full": "BSM_010"
},
"steam": {
"wrong_tradelink": "BSS_001",
"private_inventory": "BSS_002",
"cannot_check_tradeban": "BSS_003",
"cannot_check_escrow": "BSS_004",
"vac_ban": "BSS_005",
"community_ban": "BSS_006",
"economy_ban": "BSS_007",
"private_profile": "BSS_008",
"escrow": "BSS_009",
"wrong_token": "BSS_010",
"missing_token": "BSS_011",
"missing_steam_id": "BSS_012",
"platform_offline": "BSS_013",
"fresh_account": "BSS_014",
"not_available_to_trade": "BSS_015"
},
"bot": {
"not_found": "BSB_001",
"not_available": "BSB_002"
},
"wallet": {
"cannot_transfer_money": "BSW_001",
"amount_negative": "BSW_002",
"amount_positive": "BSW_003",
"card_scoring_too_low": "BSW_004",
"not_enough_balance": "BSW_005",
"kyc_window_limit": "BSW_006",
"service_window_limit": "BSW_007",
"amount_limit": "BSW_008",
"wrong_wallet_address": "BSW_009",
"card_not_found": "BSW_010",
"cannot_process_transaction": "BSW_011",
"only_past_months_accepted": "BSW_012",
"only_visa_allowed": "BSW_013",
"invalid_card_number": "BSW_014"
},
"gift_code": {
"not_found": "BSGC_001",
"already_used": "BSGC_002",
"own_code": "BSGC_003"
},
"affiliate": {
"same_code": "BAFF_001",
"code_taken": "BAFF_002",
"not_activated": "BAFF_003",
"not_enough_balance": "BAFF_004"
},
"social": {
"cannot_create_chat": "BSSOC_001"
},
"support": {
"wrong_status": "BSSUP_001",
"ticket_limit": "BSSUP_002"
},
"bam": {
"bam_steam_015": "BAM_STEAM_015"
}
}Global
GLO_000 - global.internal - Internal error
GLO_001 - global.not_allowed - Action not
allowed
GLO_002 - global.access_denied - Access denied
GLO_003 -
global.validator_error - Validator error
GLO_004 - global.wrong_body - Wrong
body
GLO_005 - global.wrong_token - Wrong token
GLO_006 - global.missing_token -
Missing token
GLO_007 - global.access_denied_acl - Access denied (ACL)
GLO_008 -
global.connection_timeout - Connection timeout
GLO_009 - global.login_required -
Login required
GLO_010 - global.not_found - Not found
GLO_011 - global.wrong_value
- Wrong value
GLO_012 - global.token_expired - Token expired
GLO_013 -
global.service_not_available - Service not available
GLO_014 - global.twofa_required
- 2FA authentication required
GLO_015 - global.missing_login_token - Login
required
Mutex
MUT_001 - mutex.long_lock - Long lock, try again in seconds
MUT_002 -
mutex.exclusive_lock - Exclusive lock
Account
ACC_001 - account.banned - Account banned
ACC_002 - account.blocked - Account
blocked
ACC_003 - account.wrong_login_or_password - Wrong login or password
ACC_004
- account.wrong_login - Wrong login
ACC_005 - account.wrong_password - Wrong password
ACC_006
- account.missing_email - Email address not assigned
ACC_007 -
account.same_password_used - The same password was used
ACC_008 - account.wrong_twofa
- Wrong 2FA code
ACC_009 - account.twofa_not_created - 2FA not created
ACC_010 -
account.twofa_already_created - 2FA already created
ACC_011 - account.twofa_limit -
2FA limit
ACC_012 - account.not_exists - Not exists
ACC_013 - account.migration -
Migration
ACC_014 - account.wrong_password_pattern - Password need to have 8 to 64
characters and at least one: uppercase, lowercase, number, special
ACC_015 -
account.deleted - This BitSkins account has been permanently deleted
ACC_016 -
account.same_email_used - Entered email is the same as the one already set up. Please
use a different one if you want to change it.
BSA_001 - account.apikey_not_created -
API Key not created
BSA_002 - account.apikey_already_created - API Key already
created
BSA_003 - account.deletion_already_started - Account deletion already started
BSA_004
- account.external_withdraw_not_available - External withdraw is not available
BSA_005
- account.kyc_wrong_step - KYC wrong step
BSA_006 - account.kyc_required - KYC
required
BSA_007 - account.action_not_allowed - Action not allowed
Api
API_001 - api.missing_apikey - Missing API Key
API_002 - api.missing_secret - Missing
API Secret
API_003 - api.wrong_ip_address - Wrong IP address
API_004 -
api.private_ip_address - Private IP address
API_005 - api.wrong_apikey - Wrong apikey
Record
REC_001 - record.item_not_found - Item not found
REC_002 - record.item_not_owned -
Item not owned
REC_003 - record.own_item - Own item
REC_004 -
record.already_exists - Already exists
REC_005 - record.not_exists - Not exists
REC_006
- record.not_updated - Not updated
REC_007 - record.forbidden - Forbidden
REC_008
- record.wrong_status - errors.record.wrong_status
Payment
PAY_001 - payment.card_scoring - Card scoring is too low
PAY_002 -
payment.payment_issue - Payment issue
Auth
AUTH_001 - auth.failed_to_authenticate - Failed to authenticate
AUTH_002 -
auth.not_valid_identity - Not valid identity
AUTH_003 - auth.authentication_failed -
Authentication failed
Ipn
IPN_001 - ipn.verification_issue - Verification issue
Market
BSM_001 - market.wrong_item_status - Wrong item status
BSM_002 -
market.item_already_queued - Item already queued
BSM_003 - market.max_price_limit -
Max price limit
BSM_004 - market.item_not_available - Item not available
BSM_005 -
market.plan_not_found - Plan not found
BSM_006 - market.no_items_found - No items
found
BSM_007 - market.items_limit - Items limit
BSM_008 -
market.instant_sell_disabled - Instant sell disabled
BSM_009 - market.price_too_low -
Item price too low
BSM_010 - market.queue_full - Our withdrawal queue is currently
full. Please try again in few minutes.
Steam
BSS_001 - steam.wrong_tradelink - Wrong trade link
BSS_002 - steam.private_inventory -
Private Steam inventory
BSS_003 - steam.cannot_check_tradeban - We cannot check trade
ban
BSS_004 - steam.cannot_check_escrow - Cannot check escrow
BSS_005 -
steam.vac_ban - VAC ban
BSS_006 - steam.community_ban - Community ban
BSS_007 -
steam.economy_ban - Economy ban
BSS_008 - steam.private_profile - Private Steam
profile
BSS_009 - steam.escrow - You are using email Steam Guard which is not enough
to trade with our bots. You have to active mobile Steam Guard to be able to trade with
our bots.
BSS_010 - steam.wrong_token - Wrong token
BSS_011 - steam.missing_token
- Missing Steam trade url
BSS_012 - steam.missing_steam_id - Missing Steam ID
BSS_013
- steam.platform_offline - No connection with Steam, servers may be down. Please try
again later.
BSS_014 - steam.fresh_account - You need to setup steam profile
first
BSS_015 - steam.not_available_to_trade - You have changed Steam nickname
recently, please try again later. If not then, you must enable Steam Guard to
participate in a trade.
Bot
BSB_001 - bot.not_found - Bot not found
BSB_002 - bot.not_available - Bot not
available
Wallet
BSW_001 - wallet.cannot_transfer_money - Cannot transfer money
BSW_002 -
wallet.amount_negative - Amount negative
BSW_003 - wallet.amount_positive - Amount
positive
BSW_004 - wallet.card_scoring_too_low - Card scoring too low
BSW_005 -
wallet.not_enough_balance - Not enough balance
BSW_006 - wallet.kyc_window_limit -
KYC window limit
BSW_007 - wallet.service_window_limit - Service window limit
BSW_008
- wallet.amount_limit - Amount limit
BSW_009 - wallet.wrong_wallet_address - Wrong
wallet address
BSW_010 - wallet.card_not_found - Card not found
BSW_011 -
wallet.cannot_process_transaction - We cannot process your transaction
BSW_012 -
wallet.only_past_months_accepted - Only past months accepted
BSW_013 -
wallet.only_visa_allowed - Only VISA cards are allowed
BSW_014 -
wallet.invalid_card_number - Invalid card number
Gift code
BSGC_001 - gift_code.not_found - Code not found
BSGC_002 - gift_code.already_used -
Code already used
BSGC_003 - gift_code.own_code - This is your own code
Affiliate
BAFF_001 - affiliate.same_code - The new code must be different
BAFF_002 -
affiliate.code_taken - This code is already taken
BAFF_003 - affiliate.not_activated
- Affiliate code is not activated
BAFF_004 - affiliate.not_enough_balance - Not
enough balance
Social
BSSOC_001 - social.cannot_create_chat - Cannot create chat
Support
BSSUP_001 - support.wrong_status - Wrong status
BSSUP_002 - support.ticket_limit -
Limit of tickets has been reached
Bam
BAM_STEAM_015 - bam.bam_steam_015 - Our bots have lost Steam sessions. Please try again
in a few minutes.