API для автоматической торговли
Интерфейсы для автоматизации доступа к аккаунту.
На данной странице Вы найдете описание наших интерфейсов API. Данные интерфейсы позволяют автоматизировать Ваши торговые операции. Для доступа к API Вы должны получить ключ доступа. Данный ключ можно сгенерировать для Вашего аккаунта на странице "Настройки аккаунта".
Наше API возвращяет результат в формате JSON кодировка UTF-8.
Информация
https://en.steambroker.com/API_V1/accinfo.php?key=[API KEY]Получение информации об аккаунте. Параметры GET: "key": Ваш ключ API. Ответ JSON: { "steamID": Ваш Steam64 ID, "balance": баланс вашего аккаунта с точностью 4 знака, "cash": баланс, который можно вывести (продажи, партнерка) "deposit": не снимаемый баланс (бонусы, конкурсы, пополнения), "currency": USD или RUB - валюта в которой работает Ваш аккаунт, "sellUSD": Сумма успешных продаж с Вашего аккаунта в USD, "sellcount": Количество успешных продаж с Вашего аккаунта, "buyUSD": Сумма успешных покупок с Вашего аккаунта в USD, "buycount": Количество успешных покупок с Вашего аккаунта, "failcount": Количество продаж, которые были отменены }
https://en.steambroker.com/API_V1/tradehistory.php?key=[API KEY]Получение истории вашей торговли. Покупки и продажи. Сортировка по убыванию времени получения вещи ботом. Вывод по 1000 сделок на страницу. Параметры GET: "key": Ваш ключ API. "page": Номер страницы по 1000 операций начиная с нуля. Ответ JSON: { "success":1, "trades": [{ "type": тип операции "buy" или "sell", "id": ID сделки в нашей базе, "steamid": Steam AssetID веши в вашем инвентаре до продажи (только при продаже), "appid": ID игры в Steam, "contextid": ContextID в Steam, "classid": ClassID в Steam, "instanceid": InstanceID в Steam, "marketname": market_hash_name или name в Steam, "price": Цена лота, "priceget": При продаже - сумма зачисленная на счет, "pricepaid": При покупке - цена после скидки, "currency": Валюта сделки "RUB" или "USD", "tradetime": timestamp времени создания лота, "buytime": timestamp времени покупки лота, "bottime": timestamp времени получения ботом, "status":"Finished" или "OnBot" если Вы еще не забрали купленный предмет с бота. },[...] ] }
https://en.steambroker.com/API_V1/ping.php?key=[API KEY]Установка статуса "Online-BOT" на нашем сайте. При использовании данной функции около Вашего аккаунта на странице описания вещи будет показываться зеленый треугольник, а не круг. Данная функция устанавливает время "последней активности" на 5 минут вперед. Для того, чтобы всегда оставаться OnLine вы должны опрашивать этот адрес чаще, чем раз в 5 минут. Например, раз в 3 минуты. Параметры GET: "key": Ваш ключ API. Ответ JSON: { "success":true }
Продажа предметов
https://en.steambroker.com/API_V1/trades.php?key=[API KEY]Данная функция является универсальной для отслеживания статуса предметов в нашем сервисе, которые имеют отношение к Вашему аккаунту. То есть, предметы, для которых Вы выставили цену, проданные предметы, предметы ожидающие передачи, купленные предметы и предметы которые можно забрать в Steam. Параметры GET: "key": Ваш ключ API. Ответ JSON: { "sell":[ Массив вещей которые выставлены на продажу { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в вашем инвентаре Steam, "marketname": торговое название предмета (market_hash_name или name в Steam), "price": цена в формате float (99.99), "currency": USD или RUB - валюта в которой указана цена (равна валюте счета), "tradetime": Unix time stamp времени когда была добавлена вещь, "status": 1 - предмет показывается, 0 - пауза в торговле }], "sold":[ Массив вещей для которых необходимо запросить передачу от нашего бота (проданы или передача на ботов для продажи) { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в вашем инвентаре Steam, "marketname": торговое название предмета (market_hash_name или name в Steam), "price": цена в формате float (99.99), "currency": USD или RUB - валюта в которой указана цена (равна валюте счета), "tradetime": Unix time stamp времени когда была добавлена вещь, "soldtime": Unix time stamp времени совершения покупки }], "soldwait":[ Массив вещей на которые был отправлен запрос передачи боту и необходимо подтвердить обмен. Внимание! Статус обновляется не сразу после передачи вещи. Возможна задержка в зависимости от работы Steam { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в вашем инвентаре Steam, "marketname": торговое название предмета (market_hash_name или name в Steam), "price": цена в формате float (99.99), "currency": USD или RUB - валюта в которой указана цена (равна валюте счета), "bottime": Unix time stamp времени отправки предложения обмена "offerid": номер отправленного предложения обмена в Steam, "inventoryid": ID вещи в вашем инвентаре Steam на которую отправлено предложение обмена }], "buy":[ Массив вещей которые были куплены и ожидается передача от продавца { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "marketname": торговое название предмета (market_hash_name или name в Steam), "paid": заплаченная сумма в формате float, "currency": USD или RUB - валюта в которой предмет оплачен, "time": Unix time stamp времени покупки вещи, "status": 2 - вещь куплена, 3 - идет передача, 4 - ошибка при отправке }], "buyget":[ Массив вещей, которые готовы к получению в Steam { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в инвентаре нашего бота, "marketname": торговое название предмета (market_hash_name или name в Steam), "paid": заплаченная сумма в формате float, "currency": USD или RUB - валюта в которой в которой предмет оплачен, "time": Unix time stamp времени покупки вещи, "offerid": номер предложения обмена в системе Steam, }] }
https://en.steambroker.com/API_V1/bottrades.php?key=[API KEY]Данная функция возращает тоже, что и предыдущая, за исключением выставленных вещей. То есть только операции, которые требуют передачи вещей в Steam. Параметры GET: "key": Ваш ключ API. Ответ JSON: { "sold":[ Массив вещей для которых необходимо запросить передачу от нашего бота (проданы или передача на ботов для продажи) { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в вашем инвентаре Steam, "marketname": торговое название предмета (market_hash_name или name в Steam), "price": цена в формате float (99.99), "currency": USD или RUB - валюта в которой указана цена (равна валюте счета), "tradetime": Unix time stamp времени когда была добавлена вещь, "soldtime": Unix time stamp времени совершения покупки }], "soldwait":[ Массив вещей на которые был отправлен запрос передачи боту и необходимо подтвердить обмен. Внимание! Статус обновляется не сразу после передачи вещи. Возможна задержка в зависимости от работы Steam. { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в вашем инвентаре Steam, "marketname": торговое название предмета (market_hash_name или name в Steam), "price": цена в формате float (99.99), "currency": USD или RUB - валюта в которой указана цена (равна валюте счета), "bottime": Unix time stamp времени отправки предложения обмена "offerid": номер предложения обмена которое необходима принять в Steam, "botsteamid": SteamID64 бота с которого отправлено предложение, "inventoryid": ID вещи в вашем инвентаре Steam на которую отправлено предложение обмена }], "buyget":[ Массив вещей, которые готовы к получению в Steam { "id": ID вещи в нашей базе данных, "appid": параметр appid в Steam, "contextid": параметр contextid в Steam, "classid": параметр classid в Steam, "instanceid": параметр instanceid в Steam, "assetid": ID предмета в инвентаре нашего бота, "marketname": торговое название предмета (market_hash_name или name в Steam), "paid": заплаченная сумма в формате float, "currency": USD или RUB - валюта в которой в которой предмет оплачен, "time": Unix time stamp времени покупки вещи, "offerid": номер предложения обмена в системе Steam, "botsteamid": Seamid64 бота который отправил предложение, "botitemid": ID вещи в инвентаре бота которая будет Вам передана, "bottime": Unix time stamp времени отправки предложения ботом }] }
https://en.steambroker.com/API_V1/sentoffer.php?key=[API KEY]Получение необходимой информацию для отправки предложений обмена на аккаунты покупателей.
ВНИМАНИЕ! После успешной отправки предложения обмена ОБЯЗАТЕЛЬНО нужно передать на setoffers.php номер отправленного обмена в Steam!
Параметры GET:
"key": Ваш ключ API.
Ответ JSON:
{
"success":true,
"trades":
{
"76561198347618344": { - SteamID64 покупателя Ваших вещей.
"tradeURL":"partner=387352616&token=-cFr80sl", - TradeURL покупателя на который необходимо отправить обмен
"assets": [{ - Массив с вещами которые нужно отправить этому покупателю.
"sbid":"10168005", - ID сделки с базе SteamBroker.com. Необходим чтобы дополнить номер отправленного обмена.
"appid":753,
"contextid":"6",
"amount":1,
"assetid":"3999467185"
}, ...
]},
...
}
}
Передача номера успешно отправленного обмена в Steam. Информацию нужно передать ОБЯЗАТЕЛЬНО после отправки обмена! Внимательно проверяйте передаваемын данные. Иначе обмен не будет обработан системой и Вы не получите деньги. Параметры GET: "key": Ваш ключ API. Дополнительно параметры POST: tradeid[]=10232123& tradeid[]=10232124& tradeid[]=10232125& - ID предметов в нашей базе которые отправлены покупателю. Параметр "sbid" из "sentoffer.php". tradeoffer=384829374 - Номер отправленного обмена в Steam который возвращается при отправке обмена. Ответ JSON: { "success":true, }
https://ru.steambroker.com/API_V1/removeitem.php?key=[API KEY]&id=id или assetid=idСнятие указанного предмета с продажи. Параметры GET: "key": Ваш ключ API. "id" : ID вещи в нашей базе данных (снятие с бота производится только по этому параметру) или "assetid" : ID вещи в вашем инвентаре Steam Ответ JSON: { "success": 1 - снятие вещи удачно завершено. } При ошибке JSON: { "error": "Error description" (в параметре передается причина ошибки) }
https://en.steambroker.com/API_V1/updateinventory.php?key=[API KEY]&appid=[INT]&contextid=[INT]&lang=[en/ru]Обновление информации о Вашем инвентаре плюс получение информации о ценах. При запросе данного интерфейса происходит обновление кеша Вашего инвентаря при этом добавляется дополнительное поле в массиве rgInventory->ItemID->steampriceRUB. Параметры GET: "key": Ваш ключ API. "appid": параметр appid в Steam. "contextid": параметр contextid в Steam. "lang": язык запроса инвентаря "ru" или "en" ("en" если не указывать параметр). Ответ JSON: Возвращяется результат запроса инвентаря Steam с добавлением цены в рублях в массиве rgInventory->[ID]->steampriceRUB.
https://ru.steambroker.com/API_V1/pausesell.php?pause=[0/1]&key=[API KEY]Остановка или возобновление продажи выставленных вещей на Вашем аккаунте. Остановленные вещи остаются а базе, но не показываются при поиске покупателям (полезно если Вы какое-то время не сможете передавать вещи). Торговля останавливается по всем играм. Данная функция не останавливает продажи с ботов и покупку по заявкам на покупку вещей. Параметры GET: "key": Ваш ключ API. "pause": 1 - остановить продажу, 0 - снять паузу и возобновить продажу. Ответ JSON: { "paused": 1 - остановлено, 0 - возобновлено. "affected_items": количество остановленных вещей из всех игр. }
Заявки на покупку
https://en.steambroker.com/API_V1/buyorders.php?key=[API KEY]Получение списка активных заявок на покупку для Вашего аккаунта. Параметры GET: "key": Ваш ключ API. Ответ JSON: [ { "id": ID заявки в нашей системе, "itemname": торговое название предмета (market_hash_name или name в Steam) , "appid": параметр appid в Steam, "count": количество требуемых предметов в заявке, "price": цена в формате float (99.99) }, ... ]
https://en.steambroker.com/API_V1/buyorders.php?key=[API KEY]&delorder=[OrderID]Удаление активной заявки на покупку по её номеру в нашей системе. Параметры GET: "key": Ваш ключ API. "delorder": id заявки на покупку из предыдущего ответа. Ответ JSON: [ {"id":"1895","itemname":"Exalted Demon Eater","appid":"570","count":"2","price":"1400.00"}, {"id":"1538","itemname":"Exalted Manifold Paradox","appid":"570","count":"2","price":"1300.00"} ] Возвращается список активных заявок после удаления требуемой.
https://en.steambroker.com/API_V1/buyorders.php?key=[API KEY]&delall=1Удаление всех заявок на покупку. Параметры GET: "key": Ваш ключ API. "delall": 1. Ответ JSON: [ ]
https://en.steambroker.com/API_V1/allbuyorders.php?key=[API KEY]Вывод всех активных заявок на покупку в нашей системе. Параметры GET: "key": Ваш ключ API. Ответ JSON: [ { "id": ID заявки в нашей системе, "itemname": торговое название предмета (market_hash_name или name в Steam) , "appid": параметр appid в Steam, "count": количество требуемых предметов в заявке, "price": цена в рублях в формате float (99.99) }, ... ]
Обновления:
06.12.2016:
Добавлен параметр "assetid" в методы "trades.php" и "bottrades.php".
Добавлено разделение массивов "sell" и "sellfrombot" в методе "trades.php"
Добавлен метод "removeitem.php" для снятия с продажи предметов по их ID.