whitemarket Documentation For Partners

Buying a skin

If you buy with your own Steam account, you must install Chrome extension or WhiteMarket mobile app.

Buy concrete skin

  1. Use export file or GraphQL API to search product ID.

  2. Call mutation market_buy with product ID. image

    We strongly recommend passing your own customId (the deal identifier in your system) to market_buy. If the server responds with a 5xx error, do not retry the purchase — the deal may already have been created. Instead, wait 10–20 seconds and re-check the result via deal_item or deal_history_item using your customId.

  3. Use deal_buyer_statuses to get short info about deal.

  4. Wait OFFERED status. image

  5. Confirm offer in Steam. If you used link option in market_buy - ask receiver to confirm offer in Steam.

  6. Wait EXCHANGED or COMPLETED status. image

EXCHANGED status and field isTradeProtected = true mean Steam Trade Protection. You need to wait until settlementTimeAt to COMPLETED status

Buy skin by name hash with the lowest price

  1. Use export file.

  2. OR call mutation market_buy with name hash and, optionally, max price. image image

    We strongly recommend passing your own customId (the deal identifier in your system) to market_buy. If the server responds with a 5xx error, do not retry the purchase — the deal may already have been created. Instead, wait 10–20 seconds and re-check the result via deal_item or deal_history_item using your customId.

  3. Use deal_buyer_statuses to get short info about deal.

  4. Wait OFFERED status. image

  5. Confirm offer in Steam. If you used link option in market_buy - ask receiver to confirm offer in Steam.

  6. Wait EXCHANGED or COMPLETED status. image

EXCHANGED status and field isTradeProtected = true mean Steam Trade Protection. You need to wait until settlementTimeAt to COMPLETED status

Full info about the deal