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.
You may need to synchronize your device's clock for the above code(s) to work:
# Ubuntu Example:
$ sudo apt-get install ntp -y
Request 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 current session information.
Get account balance
Get account balance.
Update account
Update account information app settings, notifications, store, currency, language, etc.
{
"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
}
}
}
}
{
"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
Update steam trade link. You can get it here: https://steamcommunity.com/my/tradeoffers/privacy#trade_offer_access_url
{
"tradelink": {
"type": "url",
"min": 100
}
}
Block my account
If you believe that your account has been compromised you can temporarily block it. We will unblock your account after contacting our support.
Affiliate
Get affiliate info
et affiliate info.
Claim money
Claim available money.
List historical rewards
List historical rewards.
{
"limit": {
"type": "number",
"min": 1,
"max": 500,
"integer": true,
"optional": true
},
"offset": {
"type": "number",
"integer": true,
"optional": true,
"min": 0,
"max": 100000
}
}
Set or change affiliate code
Set or change affiliate code.
{
"code": {
"type": "string",
"min": 5,
"max": 24,
"pattern": {}
}
}
Two-factor authentication
{
"banned": -1,
"blocked": 0,
"active": 1,
"required": 2,
"timeout": 3,
"fully_active": 4
}
Create 2FA
In response you will get twofa_secret, you can use to generate 2FA codes.
Verify creating 2FA
{
"email_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
},
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}
Disable 2FA
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}
Verify disabling 2FA
{
"email_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}
Lock 2FA
Lock account, so it will need to enter 2FA code to make requests.
Unlock 2FA
Unlock account with 2FA code.
{
"twofa_code": {
"type": "string",
"pattern": {},
"min": 6,
"max": 6
}
}
API access
Create API key
Create API key, so you will be able to use it in next requests instead of token. Keep it safe!
Disable API key
Revoke current API key.
Config
Currency rates
Get currency rates
Get 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.
Fee plans
Get fee plans
Get available sale fee plans.
Platform status
Get platform status
{
"loading": -2,
"offline": -1,
"steam_down": 0,
"active": 1
}
Market
{
"cs2": 730,
"csgo": 730,
"dota2": 570,
"tf2": 440,
"rust": 252490
}
Pricing
Get sales
Get latest sales for item.
{
"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
}
}
Get pricing summary
Get sales stats for item, can be filtered by date.
{
"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
}
}
Market items
Dota 2 Market
Search for items on the Dota 2 market.
{
"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
}
}
}
}
CS2 Market
Search for items on the CS2 market.
{
"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
}
}
}
}
Mine CS2 Items
Search for CS2 items you own.
{
"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
}
}
}
}
Mine Dota 2 Items
Search for Dota 2 items you own.
{
"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
}
}
}
}
User store
Get amount of items in the user store.
{
"store_alias": {
"type": "string",
"min": 3,
"max": 20
},
"store_hash": {
"type": "string",
"min": 64,
"max": 64,
"optional": true
}
}
Get item details
Get item details of single item.
{
"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
}
}
Search skin
Search for item skins in game
{
"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
}
}
Filters
Get available items filters for game.
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
}
}
Buy item
Buy single item
{
"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
}
}
Buy multiple items
{
"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
}
}
}
}
}
Buy bulk items
Buy multiple items at once. You will buy items based on specified quantity and max price.
{
"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
}
}
Withdraw
Withdraw single item
Withdraw item from BitSkins inventory to your Steam account. Steam trade will be created.
{
"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
}
}
}
}
Withdraw multiple items
Withdraw multiple items from BitSkins inventory to your Steam account. Steam trades will be created.
{
"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
}
}
}
}
}
}
}
Delist
Delist single item
Delist item from market. Item will be moved to BitSkins inventory.
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}
Delist multiple items
Delist multiple items from market. Items will be moved to BitSkins inventory.
{
"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": {}
}
}
}
}
}
Relist
{
"public": 1,
"private": 2,
"instant_sell": 3
}
Relist single item
Relist single item from BitSkins inventory to market.
{
"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
}
}
Relist multiple items
Relist multiple items from BitSkins inventory to market.
{
"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
}
}
}
}
}
Update price
Update single item price
Update single item price on market.
{
"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
}
}
Update multiple items prices
Update multiple items on market.
{
"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
}
}
}
}
}
Items history
{
"seller": "seller",
"buyer": "buyer"
}
Get items history
Get history of bought and sold items.
{
"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
}
}
}
}
Get item history
{
"type": {
"type": "enum",
"values": [
"seller",
"buyer"
]
},
"id": {
"type": "string",
"pattern": {}
}
}
Receipt
Get receipt for bought items.
Get receipt
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}
Bump UP
Bump up items to make them visible on first place to all users.
{
"price": 750,
"minimum_price": 10000
}
Bump single item
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}
Get bumped items
{
"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
}
}
}
}
Enable bumping
{
"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
}
}
Disable bumping
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
},
"id": {
"type": "string",
"pattern": {}
}
}
Buy bumps package
{
"id": {
"type": "enum",
"values": [
1,
2,
3,
4,
5,
6,
7,
8
]
}
}
All available skins
Data may be cached.
Get list of all skins for Dota 2
Get list of all skins for CS2
All insell items
Data may be cached.
Get list of all items in sell for Dota 2
Get list of all items in sell for CS2
Steam
{
"cs2": 730,
"csgo": 730,
"dota2": 570,
"tf2": 440,
"rust": 252490
}
Steam inventory
Get Steam inventory
Get list of items in your Steam inventory.
{
"app_id": {
"type": "enum",
"values": [
730,
730,
570,
440,
252490
],
"default": 730
}
}
Steam deposit
Deposit Steam items
Deposit Steam item and list it on BitSkins market. Steam trade will be created.
{
"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
}
}
Steam trades
Get Steam trades
{
"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
}
}
}
}
Get active Steam trades
{
"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
}
}
}
}
Get hashes of active Steam trades
Wallet
Wallet stats
Get wallet stats
Get KYC limits
Wallet transactions
{
"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
{
"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
}
}
}
}
Get wallet pending transactions
{
"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
}
}
}
}
Wallet reports
{
"balance": 1,
"sell": 2,
"buy": 3
}
Get wallet reports
{
"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
}
}
}
}
Generate wallet report
{
"type": {
"type": "enum",
"values": [
1,
2,
3
]
},
"date": {
"type": "string",
"pattern": {}
}
}
Download wallet report
{
"id": {
"type": "number",
"integer": true,
"min": 1,
"max": 1.7976931348623157e+308
}
}
Wallet deposit
Binance
Deposit Binance
{
"amount": {
"type": "number",
"min": 1000,
"max": 1000000,
"positive": true,
"integer": true,
"amount": true
}
}
Cryptocurrency
{
"legacy": "legacy",
"segwit": "p2sh-segwit",
"native": "bech32"
}
Get cryptocurrency addresses
Get Litecoin (LTC) address
{
"type": {
"type": "enum",
"values": [
"legacy",
"p2sh-segwit",
"bech32"
]
}
}
Get Bitcoin (BTC) address
{
"type": {
"type": "enum",
"values": [
"legacy",
"p2sh-segwit",
"bech32"
]
}
}
Get Ethereum (ETH) address
Gift code
Use gift code
{
"code": {
"type": "uuid"
}
}
Get used gift codes
Zen
Deposit Zen
{
"amount": {
"type": "number",
"min": 5000,
"max": 2500000,
"positive": true,
"integer": true,
"amount": true
}
}
Card
Add card
Deposit money on BitSkins via card.
{
"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
}
}
}
}
Get cards
Deposit card
Deposit money on BitSkins via card saved on BitSkins.
{
"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": {}
}
}
Wallet withdraw
Cryptocurrency
Withdraw Bitcoin (BTC)
{
"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
}
}
Withdraw Litecoin (LTC)
{
"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
}
}
Withdraw Ethereum (ETH)
{
"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
}
}
Binance
Withdraw Binance
Withdraw funds to your Binance account, using BinanceID.
{
"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"
}
}
Visa
Withdraw Visa
Withdraw funds to your Visa card.
{
"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
}
}
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
Errors
The provided structure represents an error response for a REST API:
{
"code": "GLO_015",
"error_type": "public",
"error_path": "global.missing_login_token"
}
{
"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 - Внутренняя ошибка
GLO_001 - global.not_allowed - Действие не
разрешено
GLO_002 - global.access_denied - Доступ запрещен
GLO_003 -
global.validator_error - Ошибка проверки
GLO_004 - global.wrong_body - Wrong body
GLO_005
- global.wrong_token - Неправильный токен
GLO_006 - global.missing_token - Токен
отсутствует
GLO_007 - global.access_denied_acl - Доступ запрещён (ACL)
GLO_008 -
global.connection_timeout - Время соединения вышло
GLO_009 - global.login_required -
Требуется вход в систему
GLO_010 - global.not_found - Не найдено
GLO_011 -
global.wrong_value - Неправильное значение
GLO_012 - global.token_expired - Срок действия
токена истек
GLO_013 - global.service_not_available - Сервис недоступен
GLO_014 -
global.twofa_required - Требуется 2FA аутентификация
GLO_015 -
global.missing_login_token - Требуется вход в систему
Mutex
MUT_001 - mutex.long_lock - Длительная блокировка, повторите попытку через секунд
MUT_002
- mutex.exclusive_lock - Исключительная блокировка
Account
ACC_001 - account.banned - Аккаунт заблокирован
ACC_002 - account.blocked - Аккаунт
заблокирован
ACC_003 - account.wrong_login_or_password - Неправильный логин или
пароль
ACC_004 - account.wrong_login - Неправильный логин
ACC_005 -
account.wrong_password - Неправильный пароль
ACC_006 - account.missing_email - Адрес
электронной почты не присвоен
ACC_007 - account.same_password_used - Этот пароль уже был
использован
ACC_008 - account.wrong_twofa - Неправильный код 2FA
ACC_009 -
account.twofa_not_created - 2FA не создан
ACC_010 - account.twofa_already_created - 2FA
уже создан
ACC_011 - account.twofa_limit - Ограничение 2FA
ACC_012 -
account.not_exists - Не существует
ACC_013 - account.migration - Migration
ACC_014 -
account.wrong_password_pattern - Пароль должен содержать от 8 до 64 символов, включая как
минимум одну прописную букву, строчную букву, одну цифру и специальный символ
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 ключ
не создан
BSA_002 - account.apikey_already_created - API ключ уже создан
BSA_003 -
account.deletion_already_started - Удаление аккаунта уже началось
BSA_004 -
account.external_withdraw_not_available - Внешний вывод не доступен
BSA_005 -
account.kyc_wrong_step - KYC неверный шаг
BSA_006 - account.kyc_required - Требуется
KYC
BSA_007 - account.action_not_allowed - Действие не разрешено
Api
API_001 - api.missing_apikey - API ключ отсутствует
API_002 - api.missing_secret - API
ключ отсутствует
API_003 - api.wrong_ip_address - Неправильный IP-адрес
API_004 -
api.private_ip_address - Скрытый IP-адрес
API_005 - api.wrong_apikey - Неправильный API
ключ
Record
REC_001 - record.item_not_found - Предмет не найден
REC_002 - record.item_not_owned - Item
not owned
REC_003 - record.own_item - Собственный предмет
REC_004 -
record.already_exists - Уже существует
REC_005 - record.not_exists - Не существует
REC_006
- record.not_updated - Не обновлено
REC_007 - record.forbidden - Запрещено
REC_008 -
record.wrong_status - errors.record.wrong_status
Payment
PAY_001 - payment.card_scoring - Слишком низкий рейтинг карты
PAY_002 -
payment.payment_issue - Проблема с оплатой
Auth
AUTH_001 - auth.failed_to_authenticate - Не удалось пройти аутентификацию
AUTH_002 -
auth.not_valid_identity - Неверное удостоверение личности
AUTH_003 -
auth.authentication_failed - Аутентификация не удалась
Ipn
IPN_001 - ipn.verification_issue - Проблема верификации
Market
BSM_001 - market.wrong_item_status - Неправильный статус предмета
BSM_002 -
market.item_already_queued - Предмет уже поставлен в очередь
BSM_003 -
market.max_price_limit - Максимальный ценовой лимит
BSM_004 - market.item_not_available -
Предмет недоступен
BSM_005 - market.plan_not_found - Plan not found
BSM_006 -
market.no_items_found - Предметы не найдены
BSM_007 - market.items_limit - Ограничение по
количеству предметов
BSM_008 - market.instant_sell_disabled - Мгновенная продажа
отключена
BSM_009 - market.price_too_low - Слишком низкая цена
BSM_010 -
market.queue_full - Очередь на вывод предметов заполнена. Повторите попытку позже.
Steam
BSS_001 - steam.wrong_tradelink - Неправильная ссылка на обмен
BSS_002 -
steam.private_inventory - Скрытый инвентарь в Steam
BSS_003 - steam.cannot_check_tradeban
- Мы не можем проверить запрет на обмен
BSS_004 - steam.cannot_check_escrow - Невозможно
проверить депонирование
BSS_005 - steam.vac_ban - Блокировка системой VAC
BSS_006 -
steam.community_ban - Блокировка в сообществе Steam
BSS_007 - steam.economy_ban -
Блокировка на торговой площадке
BSS_008 - steam.private_profile - Скрытый профиль в Steam
BSS_009
- steam.escrow - Вы используете Steam Guard через электронную почту, но этого недостаточно
для обмена с нашими ботами. Чтобы иметь возможность обмениваться с нашими ботами, Вам
необходимо активировать Steam Guard на мобильном устройстве.
BSS_010 - steam.wrong_token
- Неправильный токен
BSS_011 - steam.missing_token - Ссылка на обмен в Steam
отсутствует
BSS_012 - steam.missing_steam_id - Отсутствует Steam ID
BSS_013 -
steam.platform_offline - Платформа оффлайн
BSS_014 - steam.fresh_account - Сначала Вам
необходимо настроить профиль в Steam
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 - Бот не найден
BSB_002 - bot.not_available - Бот недоступен
Wallet
BSW_001 - wallet.cannot_transfer_money - Невозможно перевести деньги
BSW_002 -
wallet.amount_negative - Сумма отрицательная
BSW_003 - wallet.amount_positive - Сумма
положительная
BSW_004 - wallet.card_scoring_too_low - Слишком низкий рейтинг карты
BSW_005
- wallet.not_enough_balance - Недостаточно баланса
BSW_006 - wallet.kyc_window_limit -
Ограничение окна KYC
BSW_007 - wallet.service_window_limit - Service window limit
BSW_008
- wallet.amount_limit - Ограничение суммы
BSW_009 - wallet.wrong_wallet_address -
Неправильный адрес кошелька
BSW_010 - wallet.card_not_found - Карта не найдена
BSW_011
- wallet.cannot_process_transaction - Мы не можем обработать Вашу транзакцию
BSW_012 -
wallet.only_past_months_accepted - Принимаются только последние месяцы
BSW_013 -
wallet.only_visa_allowed - Разрешаются только карты VISA
BSW_014 -
wallet.invalid_card_number - Invalid card number
Gift code
BSGC_001 - gift_code.not_found - Код не найден
BSGC_002 - gift_code.already_used - Код уже
использован
BSGC_003 - gift_code.own_code - Это Ваш собственный код
Affiliate
BAFF_001 - affiliate.same_code - Одинаковый код
BAFF_002 - affiliate.code_taken - Данный
код уже занят
BAFF_003 - affiliate.not_activated - Не активирован
BAFF_004 -
affiliate.not_enough_balance - Недостаточо баланса
Social
BSSOC_001 - social.cannot_create_chat - Невозможно создать чат
Support
BSSUP_001 - support.wrong_status - Неправильный статус
BSSUP_002 - support.ticket_limit -
Ограничения по количеству и частоте подачи заявок
Bam
BAM_STEAM_015 - bam.bam_steam_015 - Наши боты потеряли сеансы Steam. Пожалуйста, повторите
попытку через несколько минут.