Содержание
Список цен
Список ордеров
Статусы предметов
Сообщества
Changelog
Steam Online!
Здесь вы можете создать/пересоздать личный ключ для автоматической торговли, который будет привязан к вашему аккаунту.
Если вы не понимаете зачем нужен ключ, то, пожалуйста, в целях собственной безопасности не говорите его никому.
В тестовом режиме запущена продажа приложения, которое позволяет автоматизировать торговлю на нашем сайте - CounterBot.
Используя API, вы соглашаетесь с условиями договора, в частности, с ограниченной гарантией в 4 часа.
Ключ вы можете передавать в GET параметре key, либо, для бОльшей безопасности, в заголовках с ключом X-API-KEY.
Список цен в формате json.
https://gifts.tm/api/v2/prices/RUB.json
https://gifts.tm/api/v2/prices/USD.json
https://gifts.tm/api/v2/prices/EUR.json
Список цен в формате json, где buy_order - максимальный buy-ордер на данный предмет.
https://gifts.tm/api/v2/prices/class_instance/RUB.json
https://gifts.tm/api/v2/prices/class_instance/USD.json
https://gifts.tm/api/v2/prices/class_instance/EUR.json
{
"success": true,
"time": 1565103435,
"currency": "RUB",
"items": {
"1434515088_0": {
"price": "0.50",
"buy_order": "0.10",
"avg_price": "0.74",
"popularity_7d": "47",
"market_hash_name": "Arcane Defiance Loading Screen",
"ru_name": "Загрузочный экран «Arcane Defiance»",
"ru_rarity": "Common",
"ru_quality": "Standard",
"text_color": "D2D2D2",
"bg_color": ""
},
"1479313949_0": {
"price": "0.60",
"buy_order": "0.10",
"avg_price": "0.94",
"popularity_7d": "13",
"market_hash_name": "Armor of Utter Eradication",
"ru_name": "Armor of Utter Eradication",
"ru_rarity": "Uncommon",
"ru_quality": "Standard",
"text_color": "D2D2D2",
"bg_color": ""
}
}
}
Список в формате json.
https://gifts.tm/api/v2/prices/orders/RUB.json
https://gifts.tm/api/v2/prices/orders/USD.json
https://gifts.tm/api/v2/prices/orders/EUR.json
https://gifts.tm/api/v2/get-ws-auth?key=[your_secret_key]
На нашей площадке присутствует возможность получать уведомления, изменения баланса, новые предметы на продаже и прочее.
С помощью них можно только получать информацию, они работают по модели подписки. Для получения персональных оповещений достаточно отправить ключ-токен полученный методом get-ws-auth
wss://wsn.dota2.net/wsn/
https://gifts.tm/api/v2/get-ws-token?key=[your_secret_key]
С помощью этого запроса, можно получить токен, требуемый для подключения к серверу.
wss://wsprice.csgo.com/connection/websocket
Для экономии трафика мы не передаем хэшнейм предмета, а вместо этого отдаем name_id.
Сопоставить name_id и хэшнейм вы сможете из файла, который можно найти по адресу:
Создать запрос на передачу купленных предметов, находящихся на наших ботах.
https://gifts.tm/api/v2/trade-request-take?key=[your_secret_key][&bot=botid]
{ "success": true,
"trade": "1704976549",
"nick": "NIPFribergEZIO",
"botid": "354589802",
"profile": "https://steamcommunity.com/profiles/76561198314855530/",
"secret": "1J10",
"items": [ "1812819920_188530170",
"2082539396_188530139",
"2048839018_902658099"
]
}
Создать запрос на передачу купленных предметов нашему боту
https://gifts.tm/api/v2/trade-request-give?key=[your_secret_key]
{
"success": true,
"trade": "1704976549",
"nick": "NIPFribergEZIO",
"botid": "354589802",
"profile": "https://steamcommunity.com/profiles/76561198314855530/",
"secret": "1J10",
"items": [
15060788266
]
}
Запросить данные для передачи предмета покупателю
https://gifts.tm/api/v2/trade-request-give-p2p?key=[your_secret_key]
{
"success": true,
"hash" : "234234234/wefsdgsd",
"offer" : {
"partner" : 12345,
"token" : "fffffff",
"tradeoffermessage" : "sdfsdf . . . 234234234/wefsdgsd",
"items" : [
{
"appid" : 730,
"contextid" : 2,
"assetid" : 23452345,
"amount" : 1}
]
}
}
Возвращает данные для создания всех трейдов
https://gifts.tm/api/v2/trade-request-give-p2p-all?key=[your_secret_key]
{
"success": true,
"offers" : [
{
"partner" : 12345,
"token" : "fffffff",
"tradeoffermessage" : "sdfsdf . . . 234234234/wefsdgsd",
"hash" : "234234234/wefsdgsd",
"items" : [
{
"appid" : 730,
"contextid" : 2,
"assetid" : 23452345,
"amount" : 1}
]
},
{
"partner" : 123456,
"token" : "fffffff",
"hash" : "234234234/wefsdas",
"tradeoffermessage" : "sdfsdf . . . 234234234/wefsdas",
"items" : [
{
"appid" : 730,
"contextid" : 2,
"assetid" : 23452346,
"amount" : 1}
]
}
]}
Регистрация у нас трейд оффера, который вы создали в Стиме
https://gifts.tm/api/v2/trade-ready?key=[your_secret_key]&tradeoffer=[steam_trade_offer_id]
{
"success": false,
"tradeofferid": 1133557799,
"error": "not active offers"
}
Включить продажи, необходимо отправлять раз в 3 минуты.
https://gifts.tm/api/v2/ping?key=[your_secret_key]&v=2
{
"success": true,
"ping": "pong"
}Включить продажи, необходимо отправлять раз в 3 минуты.
[POST] https://gifts.tm/api/v2/ping-new?key=[your_secret_key]
{
"access_token": "eyAidHlwIjogIkpXVCIsICJhb.....",
"proxy": "http://proxy_login:proxy_pass@proxy_ip:proxy_port"
}
Параметр «proxy» опционален. Если он передан, то запросы с вашим «access_token» будут выполнены через прокси.
Значение параметра access_token можно получить несколькими способами:
Для запросов https://*/pointssummary/ajaxgetasyncconfig используется следующий формат:
{
"success": 1,
"data": {
"webapi_token": "ACCESS_TOKEN"
}
}
Данный запрос обязательно требует использование в заголовках запроса cookie "steamLoginSecure", далее пример заголовка:
Cookie: steamLoginSecure=COOKIE_PAYLOAD;
{
"success": true,
"ping": "pong",
"online": true,
"p2p": true,
"steamApiKey": true
}
{
"success": false,
"message": "invalid_access_token"
}
Остановить продажу предметов.
https://gifts.tm/api/v2/go-offline?key=[your_secret_key]
Получение инвентаря Steam, только те предметы, которые Вы еще не выставили на продажу.
https://gifts.tm/api/v2/my-inventory/?key=[your_secret_key]
{
"success": true,
"items": [
{
"id": "14933635912",
"classid": "310776767",
"instanceid": "0",
"market_hash_name": "SCAR-20 | Carbon Fiber (Factory New)",
"market_price": 10.34,
"tradable": 1
}
]}
Выставить предмет на продажу. Что-бы получить список предметов для выставления, воспользуйтесь методом my-inventory.
https://gifts.tm/api/v2/add-to-sale?key=[your_secret_key]&id=[id]&price=[price]&cur=[currency]
{"success":true,"item_id":136285662}
{"success":false,"error":"bad_request"}
Установить новую цену на предмет, или снять с продажи.
https://gifts.tm/api/v2/set-price?key=[your_secret_key]&item_id=[item_id]&price=[price]&cur=[currency]
{"success":true}
{"success":false,"error":"bad_item"}
Снятие сразу всех предметов с продажи.
https://gifts.tm/api/v2/remove-all-from-sale?key=[your_secret_key]
{"count":4, "success":true}
Список предметов:
https://gifts.tm/api/v2/items?key=[your_secret_key]
{
"success": true,
"items": [
{
"item_id": "286316844",
"assetid": "15092687536",
"classid": "637317999",
"instanceid": "630912635",
"real_instance": "1629337655",
"market_hash_name": "Horns of Monstrous Reprisal",
"position": 0,
"price": 4,
"currency": "RUB",
"status": "1",
"live_time": 920,
"left": null,
"botid": "0"
}]}
Получить список трейд офферов, которые в данный момент были высланы Маркетом на Ваш аккаунт и ожидают подтверждения в Steam.
https://gifts.tm/api/v2/trades/?key=[your_secret_key]
https://gifts.tm/api/v2/trades/?key=[your_secret_key]&extended=1
{
"success": true,
"trades": [
{
"dir": "in",
"trade_id": "1705069832",
"bot_id": "354486743",
"timestamp": 23423423423
}
]
}
{"success":true,"trades":[{"dir":"out","trade_id":"3759667687","bot_id":"1022850783","timestamp":1572021797,"secret":"3R5U","nik":"teresiacais","list_item_id":{"361847026":{"id":"361847026","assetid":"17737368051","classid":"284952881","instanceid":"1625510296"},"361851594":{"id":"361851594","assetid":"17737368059","classid":"284952881","instanceid":"1625510296"}}},{"dir":"in","trade_id":"3759668212","bot_id":"1022850783","timestamp":1572021825,"secret":"EC58","nik":"teresiacais","list_item_id":{"381304045":{"id":"381304045","assetid":"8028182393","classid":"996701649","instanceid":"0"}}}]}
Покупка предмета. В нашей системе возможно покупка только по одному предмету за запрос.
https://gifts.tm/api/v2/buy?key=[your_secret_key]&hash_name=[market_hash_name]&price=[price]
https://gifts.tm/api/v2/buy?key=[your_secret_key]&id=[id]&price=[price]
{
"success": true,
"id": "136256960"
}
{
"success": false,
"error": "this custom_id exist"
}
Покупка предмета и передача его другому пользователю.
https://gifts.tm/api/v2/buy-for?key=[your_secret_key]&hash_name=[market_hash_name]&price=[price]&partner=[partner]&token=[token]&chance_to_transfer=[chance]
https://gifts.tm/api/v2/buy-for?key=[your_secret_key]&id=[id]&price=[price]&partner=[partner]&token=[token]
{
"success": true,
"id": "136256960"
}
{
"success": false,
"error": "this custom_id exist"
}
Возвравщает информацию о статусе покупки
https://gifts.tm/api/v2/get-buy-info-by-custom-id?key=[your_secret_key]&custom_id=[custom_id]
{
"success": true,
"data": {
"item_id": "534415936",
"market_hash_name": "Spectrum 2 Case",
"classid": "2521767801",
"instance": "0",
"time": "1548081954",
"send_until" : null,
"stage": "2",
"paid": 0.5,
"causer": null,
"currency": "RUB",
"for": "1234567",
"trade_id": null
}
}
Возвравщает информацию о статусе покупки
https://gifts.tm/api/v2/get-list-buy-info-by-custom-id?key=[your_secret_key]&custom_id[]=[custom_id1]&custom_id[]=[custom_id2]
{
"success": true,
"data": {
"custom_id": {
"item_id": "534415936",
"market_hash_name": "Spectrum 2 Case",
"classid": "2521767801",
"instance": "0",
"time": "1548081954",
"send_until" : null,
"stage": "2",
"paid": 0.5,
"currency": "RUB",
"for": "1234567",
"trade_id": null
}
}
}
История покупок и продаж на всех площадках
https://gifts.tm/api/v2/history?key=[your_secret_key]&date=12312314&date_end=12312714
https://gifts.tm/api/v2/history?key=[your_secret_key]&date=[DD-MM-YYYY]
{
"success": true,
"data": [
{
"item_id": "286316842",
"market_hash_name": "Maraxiform's Ire",
"class": "2274724615",
"instance": "57949762",
"time": "1546229560",
"event": "buy",
"app": "570",
"stage": "2",
"for": null,
"custom_id": null,
"paid": "72",
"currency": "RUB"
}
]
}
История покупок, продаж, операций пополнений, выводов на всех площадках
https://gifts.tm/api/v2/operation-history?key=[your_secret_key]&date=1585042890&date_end=1592646090
{
"success": true,
"data": [
{
"time": "1592564265",
"event": "sell",
"item_id": "520336165",
"market_hash_name": "Glock-18 | Ironwork (Factory New)",
"class": "3706631132",
"instance": "188530139",
"price": "500",
"received": "468",
"currency": "RUB",
"stage": "5",
"for": null,
"custom_id": null,
"app": 730
},
{
"time": "1591817364",
"event": "buy",
"item_id": "286316972",
"market_hash_name": null,
"class": null,
"instance": null,
"paid": "193",
"currency": "RUB",
"stage": "5",
"for": null,
"custom_id": null,
"app": 570
},
{
"time": "1588586061",
"event": "checkout",
"id": "542713332",
"amount": "1001",
"currency": "RUB",
"status": "105"
}
]
}
Получение списка ваших ордеров
https://gifts.tm/api/v2/get-orders?key=[your_secret_key]&page=0
{
"success": true,
"orders": [
{
"hash_name": "Spectrum 2 Case",
"phase": "",
"count": 5,
"date": "2021-09-08 18:06:58",
"price": 10,
"currency": "RUB",
"partner": null,
"token": null
}
]
}
Добавление, изменение и удаление ордера
https://gifts.tm/api/v2/set-order?key=[your_secret_key]&market_hash_name=AWP | Dragon Lore (Field-Tested)&count=5&price=50000000[&partner=partnerID&token=tradeToken]
{
"success": true,
"order": {
"hash_name": "AWP | Dragon Lore (Field-Tested)",
"phase": "",
"currency": "RUB",
"price": 20,
"count": 5,
"date": "2021-09-08 18:30:44",
"partner": null,
"token": null
}
}
История исполненных ордеров
https://gifts.tm/api/v2/get-orders-log?key=[your_secret_key]&page=0
{
"success": true,
"orders": [
{
"hash_name": "Desert Eagle | Oxide Blaze (Field-Tested)",
"item_id": 520336218,
"created": "2021-09-06 18:00:27",
"executed": "2021-09-06 18:03:16",
"price": 1000,
"currency": "RUB"
},
{
"hash_name": "Gamma 2 Case",
"item_id": 520336215,
"created": "2021-09-06 17:59:54",
"executed": "2021-09-06 17:59:54",
"price": 5000,
"currency": "RUB"
}
]
}
Получить сумму на балансе и текущую валюту.
https://gifts.tm/api/v2/get-money?key=[your_secret_key]
{"money": 123.45, "currency": "RUB", "success": true}
{"money": 123.45, "currency": "USD", "success": true}
{"money": 123.45, "currency": "EUR", "success": true}
Моментально приостановить торги, рекомендуем также отключиться от вебсокетов.
https://gifts.tm/api/v2/go-offline?key=[your_secret_key]
{"success":true}
Запросить обновление кэша инвентаря (рекомендуется делать после каждого принятого трейд оффера).
https://gifts.tm/api/v2/update-inventory/?key=[your_secret_key]
{"success":true}
Перенос скидок на другой аккаунт
https://gifts.tm/api/v2/transfer-discounts?key=[your_secret_key]&to=[his_secret_key]
{"success":true}
Узнать свой steamID
https://gifts.tm/api/v2/get-my-steam-id?key=[your_secret_key]
{
"success": true,
"steamid32": 123456,
"steamid64": "1234123513245234"
}
Установка/смена платежного пароля.
Возможна либо в первые 24 часа после регистрации, либо в любое время, но с указанным и подтвержденным почтовым адресом.
https://gifts.tm/api/v2/set-pay-password?old_password=[old_password]&new_password=[new_password]&key=[your_secret_key]
{
"success": true
}
Перенос баланса с текущего аккаунта на указанный
Возможен только при условии установленного платежного пароля
Перенос с аккаунта на аккаунт с разными валютами производится по курсу на текущий день
https://gifts.tm/api/v2/money-send/[amount]/[user_api_key]?pay_pass=[pay_pass]&key=[your_secret_key]
{
"success": true,
"from": 1234567,
"to": 13579123,
"amount": 1000
}
История переносов баланса с текущего аккаунта
https://gifts.tm/api/v2/money-send-history/[page = 0]?key=[your_secret_key]
{
"success": true,
"data": [
{
"id": "6308681",
"from": "12345678",
"to": "11223344",
"amount_from": "10000",
"currency_from": "RUB",
"amount_to": "10000",
"currency_to": "RUB"
}
}
Привязка Steam API ключа к аккаунту
https://gifts.tm/api/v2/set-steam-api-key?key=[your_secret_key]&steam-api-key=[steam-api-key]
{
"success": true
}Привязка трейд-ссылки к аккаунту
https://gifts.tm/api/v2/set-trade-token?key=[your_secret_key]&token=[token]
{
"success": true,
"token": "kf47d09"
}
Смена валюты аккаунта
https://gifts.tm/api/v2/change-currency/[new-currency]?key=[your_secret_key]
{
"success": true
}
{
"success": false,
"error": 1001
}
Регистрация аккаунта на маркете и получение API ключа
Вы можете автоматизировать регистрацию своих Стим аккаунтов на нашем маркете. Для этого вам необходимо в запросе передать access_token (см. метод ping-new) и прокси. В ответ мы зарегистрируем аккаунт, если он еще не был зарегистрирован, сохраним трейд ссылку и сгенерируем API ключ площадки.
[POST] https://gifts.tm/api/v2/get-api-key-via-access-token?key=[your_secret_key]
{
"access_token": "eyAidHlwIjogIkpXVCIsICJhb.....",
"proxy": "http://proxy_login:proxy_pass@proxy_ip:proxy_port",
"currency": "USD"
}
Параметр «currency» опционален. Если он передан, то при создании аккаунта будет использоваться выбранная валюта. По-умолчанию: RUB.
{
"success": true,
"apikey": "abcdefghijklmnopqrstubvwxyz",
"is_new": true
}
{
"success": false,
"message": "invalid_proxy"
}
Вариант для запроса по одному предмету
https://gifts.tm/api/v2/search-item-by-hash-name?key=[your_secret_key]&hash_name=[market_hash_name]
{
"success" : true,
"currency" : "RUB",
"data": [
{
"market_hash_name" : "ABC",
"price" : 400,
"class" : 93975063,
"instance" : 57944754,
"count" : 10
}
]
}
Вариант для запроса по одному предмету
https://gifts.tm/api/v2/search-item-by-hash-name-specific?key=[your_secret_key]&hash_name=[market_hash_name]&phase=[phase]
{
"success": true,
"currency": "RUB",
"data": [
{
"id": 521320033,
"market_hash_name": "AWP | Worm God (Factory New)",
"price": 3573,
"class": 3088304936,
"instance": 480085569,
"seller_steam_level": 2,
"extra": {
"float": "0.061443410813808",
"phase": "aq_awp_twine"
}
},
{
"id": 523494595,
"market_hash_name": "AWP | Worm God (Factory New)",
"price": 3604,
"class": 1848971742,
"instance": 480085569,
"seller_steam_level": null,
"extra": {
"float": "0.051711451262236",
"phase": "aq_awp_twine"
}
},
{
"id": 522446815,
"market_hash_name": "AWP | Worm God (Factory New)",
"price": 4386,
"class": 3033846573,
"instance": 188530139,
"seller_steam_level": 12,
"extra": {
"float": "0.038657382130623",
"phase": "aq_awp_twine"
}
},
{
"id": 521834932,
"market_hash_name": "AWP | Worm God (Factory New)",
"price": 4386,
"class": 3099667914,
"instance": 188530139,
"seller_steam_level": 32,
"extra": {
"float": "0.0054426062852144",
"phase": "aq_awp_twine"
}
}
]
}
Вариант для запроса по списку предметов. Отдаёт ограниченное число предложений по списку market_hash_name.
Если в url указан параметр extended=1, то максимальный лимит количества market_hash_name равен 5. По каждому предмету Вы получите 500 первых позиций на продажу.
Если параментр extended=1 НЕ указан, то максимальный лимит количества market_hash_name равен 50, при этом по каждому предмету Вы получите 50 первых позиций на продажу.
https://market.csgo.com/api/v2/search-list-items-by-hash-name-all?key=[your_secret_key]&list_hash_name[]=[market_hash_name]&list_hash_name[]=[market_hash_name]&...
https://market.csgo.com/api/v2/search-list-items-by-hash-name-all?key=[your_secret_key]&extended=1&list_hash_name[]=[market_hash_name]&list_hash_name[]=[market_hash_name]&...
{
"success": true,
"currency": "RUB",
"data": {
"USP-S | Lead Conduit (Well-Worn)": [
{
"id": 535992148,
"price": "5100",
"class": 3017010398,
"instance": 188530139,
"seller_steam_level": 4,
"extra": {
"asset": "35081291",
"float": "0.39269635081291",
"phase": "gs_usp_voltage",
"percent_success": "100.00",
"average_time": "195"
}
}
],
"USP-S | Lead Conduit (Factory New)": [
{
"id": 545992413,
"price": "10100",
"class": 3017020387,
"instance": 188530171,
"seller_steam_level": 7,
"extra": {
"asset": "320811187",
"float": "0.04768768698012",
"phase": "gs_usp_voltage",
"percent_success": "88.00",
"average_time": "163"
}
}
]
}
}
Вариант для запроса по списку предметов
https://gifts.tm/api/v2/get-list-items-info?key=[your_secret_key]&list_hash_name[]=[market_hash_name]&list_hash_name[]=[market_hash_name]
{
"success": true,
"currency": "RUB",
"data": {
"USP-S | Lead Conduit (Well-Worn)": {
"max": "100",
"min": 1,
"average": 50,
"history": [
[12312312312, 1.234], [12312312313, 1.234]
]
}
}
}
Запрос стакана по хэшнейму предмета
https://gifts.tm/api/v2/bid-ask?key=[your_secret_key]&hash_name=[market_hash_name]&phase=[phase]
{
"bid": [
{
"price": "414.0600",
"total": "1"
},
{
"price": "406.4600",
"total": "3"
}
],
"ask": [
{
"price": "441.5900",
"total": "1"
},
{
"price": "441.7800",
"total": "1"
}
],
"currency": "RUB"
}
Получение истории операций выводов (100 на странице)
https://gifts.tm/api/v2/checkout-history?key=[your_secret_key][&page=0]
{"success":true,
"data":[
{
"id":"9503323",
"uid":"1234567890",
"summ":"10000",
"paid":"9500",
"method":"card",
"wm":"7-9683912365",
"status":"30",
"comment":"",
"created":"2021-05-26 19:10:45",
"currency":"RUB",
"can_cancel":false
}
]
}
= 0 - Заявка создана
= 10 - Заявка одобрена
= 20 - Заявка отправлена на исполнение
= 30 - Заявка исполнена
= 100 - Заявка отклонена
= 105 - Заявка отменена
= 110 - Ошибка
Получение истории операций пополнений (100 на странице)
https://gifts.tm/api/v2/checkin-history?key=[your_secret_key][&page=0]
{"success":true,
"data":[
{
"id":"34754143",
"uid":"1234567890",
"system":"paygate",
"amount":"15000",
"created":"2021-09-13 07:15:36",
"currency":"RUB"
},
{
"id":"34754142",
"uid":"1234567890",
"system":"paygate",
"amount":"10000",
"created":"2021-09-04 15:12:29",
"currency":"RUB"
}
]
}
Проверить все возможные препятствия к успешной продаже вещей.
https://gifts.tm/api/v2/test?key=[your_secret_key]
{
"success": true,
"status": {
"user_token": true,
"trade_check": true,
"site_online": false,
"site_notmpban": false,
"steam_web_api_key" : false
}
}
Приглашаем присоедениться к сообществу разработчиков использующих API. В группе Вы сможете задать интересующий Вас вопрос сообществу, пообщаться напрямую с разработчиками маркета и узнать подробнее про новые функции,
Добавлен метод change-currency.
Добавлен метод set-trade-token.
Добавлен метод operation-history.
Обновлен метод search-list-items-by-hash-name-all.
Добавлен метод trade-ready.
Добавлен метод get-api-key-via-access-token.
Добавлен метод stickers.
Добавлен метод bid-ask.