[Purchase] Buy Items Using Market Hashname
By passing marketHashName and maxPrice to buy the lowest-priced item within your range.
Rate limit is 10 requests per second.
The seller has 12 hours to ship the item, while the buyer can cancel orders that remain in [Waiting for Seller to Confirm Shipment] status after 1 hour.
The buyer has 24 hours to receive items.
Curl request
$ curl 'https://www.skindeer.com/market/open_api/request/?action=merchant.buy.normal.buy' -i -X POST \
-H 'Content-Type: application/json' \
-d '{
"apiKey":"955a2f4e8f121cdda99ae97ae9728d2d",
"marketHashName" : "★ StatTrak™ M9 Bayonet | Doppler (Factory New)",
"maxPrice" : "3.00",
"externalTradeNo" : "Skindeer423456789",
"phase":"p1",
"steamTradeUrl" : "https://steamcommunity.com/tradeoffer/new/?partner=1507345320&token=_giajW08",
"delivery": "Bot"
}'
HTTP request
POST /market/open_api/request/?action=merchant.buy.normal.buy HTTP/1.1
Content-Type: application/json
Content-Length: 262
Host: localhost:8080
{
"apiKey":"955a2f4e8f121cdda99ae97ae9728d2d",
"marketHashName" : "★ StatTrak™ M9 Bayonet | Doppler (Factory New)",
"maxPrice" : "3.00",
"externalTradeNo" : "Skindeer423456789",
"phase":"p1",
"steamTradeUrl" : "https://steamcommunity.com/tradeoffer/new/?partner=1507345320&token=_giajW08",
"delivery": "Bot"
}
Request body
{
"apiKey":"955a2f4e8f121cdda99ae97ae9728d2d",
"marketHashName" : "M4A4 | Evil Daimyo (Minimal Wear)",
"maxPrice" : "3.00",
"externalTradeNo" : "Skindeer423456789",
"phase":"p1",
"steamTradeUrl" : "https://steamcommunity.com/tradeoffer/new/?partner=1507345320&token=_giajW08",
"delivery": "Bot"
}
Table 4. Request fields
marketHashName
String
Steam market item hash name. One must be filled in with itemId.
maxPrice
String
Maximum purchase Price (US $).
steamTradeUrl
String
The recipient’s steam trade link.
externalTradeNo
String
Third party merchant order number,Maximum length 64
apiKey
String
api key
phase
String
[optional], Doppler: p1, p2, p3, p4, ruby, sapphire, blackpearl, emerald. Please use lowercase letters for the phase type in your request.
delivery
string
[optional], valid values are "P2P"(manual delivery) or "Bot"(automatic delivery). Please use exactly the same input as provided, for unrecognized values will be ignored.
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 181
{
"code": 0,
"message": "SUCCESS",
"data": {
"orderId": "2020241009113451521796",
"externalTradeNo": "31"
}
}
Table 5. Response fields
code
Number
Response code.
message
String
Response message
data
Object
Actual data.
data.orderId
String
Order id.
data.externalTradeNo
String
Third party merchant order number.
Last updated