Датаклассы
Данные классы (кроме фильтров) не должны создаваться пользователем.
Продажа
SellResult
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о выставленном на продажу предмете.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
id |
int
|
(int): ID продажи. |
position |
int
|
Позиция предмета в очереди. |
fast_execute |
bool
|
Был ли предмет продан моментально. |
nc |
str
|
Идентификатор для бескомиссионной продажи предмета. |
price |
float
|
Цена, за которую был продан предмет с учетом комиссии. Указывается, если 'fast_execute' = True |
commission |
float
|
Размер комиссии в процентах, за которую был продан предмет. Указывается, если 'fast_execute' = True |
Покупка
BuyOrderResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат запроса на покупку.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
executed |
int
|
Количество исполненных заявок. |
placed |
int
|
Количество размещённых на маркет заявок. |
BuyResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат покупки.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
id |
int
|
Уникальный ID покупки. |
gid |
int
|
ID группы предметов. |
itemid |
int
|
ID купленного предмета. |
price |
float
|
Цена, за которую был куплен предмет с учётом скидки. |
new_price |
float
|
Новая цена лучшего предложения о продаже для варианта покупки Commodity, если у группы предметов ещё имеются предложения о продаже. Для остальных вариантов покупки будет 0 |
discount |
float
|
Размер скидки в процентах, за которую был куплен предмет. |
MultiBuyResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат мульти-покупки.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
balance |
float
|
Баланс после покупки предметов. Указывается если success = True |
spent |
float
|
Сумма потраченных средств на покупку предметов. Указывается если success = True |
orders |
Sequence[MultiBuyOrder]
|
Последовательность купленных предметов. Указывается если success = True |
left |
int
|
Сколько предметов по этой цене осталось. Если операция прошла успешно, всегда равен 0. |
Changes
0.2.3: Теперь, если во время операции закончиться баланс, вместо ошибки, в датаклассе будет указано кол-во оставшихся предметов по данной цене.
Редактирование
DeleteItemResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат запроса снятия предмета с продажи/заявки на покупку.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
has_ex |
bool
|
Есть ли доступный обмен на сайте. |
has_bot_ex |
bool
|
Есть ли доступный обмен с ботом. |
has_p2p_ex |
bool
|
Есть ли доступный P2P обмен. |
total_fines |
int
|
Общее количество штрафных баллов. |
fine_date |
int
|
Дата снятия штрафных баллов. Если None - штрафных баллов нет. |
EditPriceResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат запроса на изменение цены.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
type |
int
|
Тип заявки. 0 - продажа, 1 - покупка. |
position |
int
|
Позиция предмета в очереди. |
fast_execute |
bool
|
Был ли предмет продан/куплен моментально. |
new_id |
int
|
Новый ID заявки. Указывается, если 'fast_execute' = true. Новый ID присваивается только заявкам на ПОКУПКУ и только в случае редактирования уже имеющейся заявки. |
price |
float
|
Цена, за которую был продан/куплен предмет с учётом комиссии/скидки. Указывается, если 'fast_execute' = true. |
percent |
float
|
Размер комиссии/скидки в процентах, за которую был продан/куплен предмет. Указывается, если 'fast_execute' = true. |
GetDownOrdersResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат снятия всех заявок на продажу/покупку.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
count |
int
|
Количество удалённых предложений. |
ids |
Sequence[int]
|
Список из ID удалённых предложений. |
Обмен
ExchangeP2PResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат инициализации p2p обмена.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
send |
Sequence[P2PSendObject]
|
Массив с данными для создания нового обмена в Steam. |
receive |
Sequence[RecieveObject]
|
Массив с данными для принятия обмена. |
confirm |
Sequence[ConfirmObject]
|
Массив с данными для подтверждения обмена в мобильном аутентификаторе. |
cancel |
Sequence[str]
|
Массив из ID обменов, которые нужно отменить. |
client |
Union[Client, ClientAsync, None]
|
Клиент Steam Trader. |
ExchangeResult
dataclass
Bases: TraderClientObject
Класс, представляющий результат инициализации обмена с ботом.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
(bool): Результат запроса. |
offer_id |
int
|
ID обмена в Steam. |
code |
str
|
Код проверки обмена. |
bot_steamid |
int
|
SteamID бота, который отправил обмен. |
bot_nick |
str
|
Ник бота. |
items |
Sequence[ExchangeItem]
|
Cписок предметов для обмена с ботом. |
ItemsForExchange
dataclass
Bases: TraderClientObject
Класс, представляющий предметы для обмена с ботом.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
items |
Sequence[ItemForExchange]
|
Последовательность предметов для обмена с ботом. |
descriptions |
dict[int, TradeDescription]
|
Описания предметов для обмена с ботом. Ключ - itemid предмета. |
Информация
ItemInfo
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о группе предметов на сайте.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
name |
str
|
Локализованное (переведённое) название предмета. |
hash_name |
str
|
Параметр 'market_hash_name' в Steam. |
type |
str
|
Тип предмета (из Steam). |
gameid |
int
|
AppID приложения в Steam. |
contextid |
int
|
ContextID приложения в Steam. |
color |
str
|
Hex код цвета предмета (из Steam). |
small_image |
str
|
Абсолютная ссылка на маленькое изображение предмета. |
large_image |
str
|
Абсолютная ссылка на большое изображение предмета. |
marketable |
bool
|
Параметр 'marketable' в Steam. |
tradable |
bool
|
Параметр 'tradable' в Steam. |
description |
str
|
Локализованное (переведённое) описание предмета. |
market_price |
float
|
Минимальная цена продажи. Может быть пустым. |
buy_price |
float
|
Максимальная цена покупки. Может быть пустым. |
steam_price |
float
|
Минимальная цена в Steam. Может быть пустым. |
filters |
Filters
|
Фильтры, используемые для поиска на сайте. |
sell_offers |
Sequnce[SellOffer]
|
Последовательность с предложениями о продаже. От большего к меньшему. |
buy_offers |
Sequnce[BuyOffer]
|
Последовательность с предложениями о покупке. От большего к меньшему. |
sell_history |
Sequence[SellHistoryItem]
|
Последовательность истории продаж. |
MinPrices
dataclass
Bases: TraderClientObject
Класс, представляющий минимальную/максимальную цену на предмет.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
market_price |
float
|
Минимальная цена продажи. Может быть пустым. |
buy_price |
float
|
Максимальная цена покупки. Может быть пустым. |
steam_price |
float
|
Минимальная цена в Steam. Может быть пустым. |
count_sell_offers |
int
|
Количество предложений о продаже. |
count_buy_offers |
int
|
Количество предложений о покупке. |
OrderBook
dataclass
Bases: TraderClientObject
Класс, представляющий заявоки о покупке/продаже предмета.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
sell |
Sequence[Sequence[int]]
|
Сгруппированный по цене список заявок на продажу. Каждый элемент в списке является массивом, где первый элемент - это цена, а второй - количество заявок. |
buy |
Sequence[Sequence[int]]
|
Сгруппированный по цене список заявок на покупку. Каждый элемент в списке является массивом, где первый элемент - это цена, а второй - количество заявок. |
total_sell |
int
|
Количество всех заявок на продажу. |
total_buy |
int
|
Количество всех заявок на покупку. |
Аккаунт
AltWebSocket
dataclass
Bases: TraderClientObject
Класс, представляющий запрос альтернативным WebSocket.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. Если false, сообщений в поле messages не будет, при этом соединение будет поддержано. |
messages |
Sequence[AltWebSocketMessage]
|
Последовательность с WebSocket сообщениями. |
BuyOrders
dataclass
Bases: TraderClientObject
Класс, представляющий ваши запросы на покупку.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
data |
Sequence[BuyOrder]
|
Последовательность запросов на покупку. |
Discounts
dataclass
Bases: TraderClientObject
Класс, представляющий комиссии/скидки на игры, доступные на сайте.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
data |
dict[int, Discount]
|
Словарь, содержащий комисии/скидки. |
Inventory
dataclass
Bases: TraderClientObject
Класс, представляющий инвентарь клиента.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
count |
int
|
Количество всех предметов в инвентаре Steam. |
gameid |
int
|
AppID игры к которой принадлежит инвентарь. |
last_update |
int
|
Timestamp последнего обновления инвентаря. |
items |
Sequence[InventoryItem]
|
Последовательность с предметами в инвентаре. |
InventoryState
dataclass
Bases: TraderClientObject
Класс, представляющий текущий статус инвентаря.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
updating_now |
bool
|
Инвентарь обновляется в данный момент. |
last_update |
int
|
Timestamp, когда последний раз был обновлён инвентарь. |
items_in_cache |
int
|
Количество предметов в инвентаре. |
OperationsHistory
dataclass
Bases: TraderClientObject
Класс, представляющий истории операций, произведённых на сайте.
Attributes:
| Name | Type | Description |
|---|---|---|
success |
bool
|
Результат запроса. |
data |
Sequence[OperationsHistoryItem]
|
Последовательность историй операций. |
WebSocketToken
dataclass
Bases: TraderClientObject
Класс, представляющий WebSocket токен.
Attributes:
| Name | Type | Description |
|---|---|---|
steam_id |
str
|
(str): SteamID клиента. |
time |
int
|
(int): Время создание токена. |
hash |
str
|
(str): Хеш токена. |
Подклассы
AltWebSocketMessage
dataclass
Bases: TraderClientObject
Класс, представляющий AltWebSocket сообщение.
Attributes:
| Name | Type | Description |
|---|---|---|
type |
int
|
Код WebSocket сообщения. |
data |
str
|
WebSocket сообщение. |
BuyOrder
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о запросе на покупку.
Attributes:
| Name | Type | Description |
|---|---|---|
id |
int
|
ID заявки на покупку. |
gid |
int
|
ID группы предметов. |
gameid |
int
|
AppID приложения в Steam. |
hash_name |
str
|
Параметр market_hash_name в Steam. |
date |
int
|
Timestamp подачи заявки. |
price |
float
|
Предлагаемая цена покупки без учёта скидки. |
currency |
int
|
Валюта, значение 1 - рубль. |
position |
int
|
Позиция заявки в очереди. |
Discount
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о комиссии/скидке в определённой игре.
Attributes:
| Name | Type | Description |
|---|---|---|
total_buy |
float
|
Cколько денег потрачено на покупки. |
total_sell |
float
|
Cколько денег получено с продажи предметов. |
discount |
float
|
Cкидка на покупку. Величина в %. |
commission |
float
|
Комиссия на продажу. Величина в %. |
ExchangeItem
dataclass
Bases: TraderClientObject
Класс, представляющий предмет, на который был отправлен обмен.
Attributes:
| Name | Type | Description |
|---|---|---|
id |
int
|
Уникальный ID заявки. |
assetid |
int
|
AssetID предмета в Steam. |
gameid |
int
|
AppID приложения в Steam. |
contextid |
int
|
ContextID приложения в Steam. |
classid |
int
|
ClassID предмета в Steam. |
instanceid |
int
|
InstanceID предмета в Steam. |
type |
int
|
Значение 0 - предмет для передачи боту, значение 1 - предмет для приема от бота. |
itemid |
int
|
ID предмета. |
gid |
int
|
Идентификатор группы предметов в нашей базе. |
price |
int
|
Цена, за которую предмет был куплен/продан с учётом скидки/комиссии. |
currency |
int
|
Валюта покупки/продажи. |
percent |
float
|
Размер скидки/комиссии в процентах, с которой был куплен/продан предмет. |
Filter
dataclass
Bases: TraderClientObject
Класс, представляющий фильтр.
Attributes:
| Name | Type | Description |
|---|---|---|
id |
int
|
ID фильтра, может быть пустым. Если вы создаёте класс вручную, то обязательно укажите этот параметр. |
title |
str
|
Тайтл фильтра, может быть пустым. |
color |
str
|
Hex цвет фильтра, может быть пустым. |
Filters
dataclass
Bases: TraderClientObject
Класс, представляющий фильтры, используемые для поиска на сайте.
Attributes:
| Name | Type | Description |
|---|---|---|
quality |
Sequence[Filter]
|
Качество предмета (TF2, DOTA2). |
type |
Sequence[Filter]
|
Тип предмета (TF2, DOTA2). |
used_by |
Sequence[Filter]
|
Класс, который использует предмет (TF2). |
craft |
Sequence[Filter]
|
Информация о карфте (TF2). |
region |
Sequence[Filter]
|
Регион игры (SteamGift). |
genre |
Sequence[Filter]
|
Жанр игры (SteamGift). |
mode |
Sequence[Filter]
|
Тип игры, взаимодействие с Steam (SteamGift). |
trade |
Sequence[Filter]
|
Информация об обмене (SteamGift). |
rarity |
Sequence[Filter]
|
Редкость предмета (DOTA2). |
hero |
Sequence[Filter]
|
Герой, который использует предмет (DOTA2). |
InventoryItem
dataclass
Bases: TraderClientObject
Класс, представляющий предмет в инвентаре.
Attributes:
| Name | Type | Description |
|---|---|---|
id |
int
|
ID заявки на покупку/продажу. Может быть пустым. |
assetid |
int
|
AssetID предмета в Steam. Может быть пустым. |
gid |
int
|
ID группы предметов. |
itemid |
int
|
Уникальный ID предмета. |
price |
float
|
Цена, за которую предмет был выставлен/куплен/продан предмет без учёта скидки/комиссии. Может быть пустым. |
currency |
int
|
Валюта, за которую предмет был выставлен/куплен/продан. Значение 1 - рубль. Может быть пустым. |
timer |
int
|
Время, которое доступно для приема/передачи этого предмета. Может быть пустым. |
type |
int
|
Тип предмета. 0 - продажа, 1 - покупка. Может быть пустым. |
status |
int
|
Статус предмета. -2 - Предмет в инвентаре Steam не выставлен на продажу. 0 - Предмет выставлен на продажу или выставлена заявка на покупку. Для различия используется поле type. 1 - Предмет был куплен/продан и ожидает передачи боту или P2P способом. Для различия используется поле type. 2 - Предмет был передан боту или P2P способом и ожидает приёма покупателем. 6 - Предмет находится в режиме резервного времени. На сайте отображается как "Проверяется" после истечения времени на передачу боту или P2P способом. |
position |
int
|
Позиция предмета в списке заявок на покупку/продажу. Может быть пустым. |
nc |
int
|
ID заявки на продажу для бескомиссионной ссылки. Может быть пустым. |
percent |
float
|
Размер скидки/комиссии в процентах, с которой был куплен/продан предмет. Может быть пустым. |
steam_item |
bool
|
Флаг, определяющий, имеется ли этот предмет в инвентаре в Steam (для продавца). |
nm |
bool
|
Незадокументированно. |
ItemForExchange
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о предмете для передачи/получения боту.
Attributes:
| Name | Type | Description |
|---|---|---|
id |
int
|
ID покупки/продажи. |
assetid |
int
|
AssetID предмета в Steam. |
gameid |
int
|
AppID приложения в Steam. |
contextid |
int
|
ContextID приложения в Steam. |
classid |
int
|
Параметр ClassID в Steam. |
instanceid |
int
|
Параметр InstanceID в Steam. |
gid |
int
|
ID группы предметов. |
itemid |
int
|
Уникальный ID предмета. |
price |
float
|
Цена предмета, за которую купили/продали, без учета комиссии/скидки. |
currency |
int
|
Валюта покупки/продажи. |
timer |
int
|
Cколько времени осталось до передачи боту/окончания гарантии. |
asset_type |
int
|
Значение 0 - этот предмет для передачи боту. Значение 1 - для приёма предмета от бота. |
percent |
float
|
Размер комиссии/скидки в процентах, за которую был продан/куплен предмет. |
steam_item |
bool
|
Присутствует ли предмет в вашем инвентаре Steam. |
MultiBuyOrder
dataclass
Bases: TraderClientObject
Класс, представляющий предмет из запроса на мульти-покупку.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
id
|
int
|
Уникальный ID заявки. |
required |
itemid
|
int
|
ID предмета. |
required |
price
|
float
|
Цена, за которую был куплен предмет с учётом скидки. |
required |
OperationsHistoryItem
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о предмете в истории операций.
Attributes:
| Name | Type | Description |
|---|---|---|
id |
int
|
ID Операции. |
name |
str
|
Название операции. |
type |
int
|
Тип операции. 0 - продажа, 1 - покупка. |
amount |
float
|
Сумма операции. |
currency |
int
|
Валюта, значение 1 - рубль. |
date |
int
|
Timestamp операции. |
SellHistoryItem
dataclass
Bases: TraderClientObject
Класс, представляющий информацию о предмете в истории продаж.
Attributes:
| Name | Type | Description |
|---|---|---|
date |
int
|
Timestamp времени продажи. |
price |
float
|
Цена предложения о покупке/продаже. |
TradeDescription
dataclass
Bases: TraderClientObject
Класс, предстваляющий описание предмета для передачи/получения боту.
Attributes:
| Name | Type | Description |
|---|---|---|
type |
str
|
Тип предмета. |
description |
str
|
Описание предмета. |
hash_name |
str
|
Параметр market_hash_name в Steam. |
name |
str
|
Локализованное (переведённое) название предмета. |
image_small |
str
|
Маленькое изображение предмета. |
color |
str
|
Цвет предмета (из Steam). |
outline |
str
|
Цвет фильтра предмета (из Steam). |
gameid |
int
|
AppID приложения в Steam |