# Waxpeer API

> REST API to buy/sell/trade CS2, Rust, TF2, Dota 2 skins via P2P.

Version 2.2.9. Base URL: https://api.waxpeer.com

## Docs

- [Overview](/index.md)
- [Authentication](/authentication.md)
- [Changelog](/changelog.md)
- [Trade statuses](/statuses.md)
- [WebSocket](/websocket.md)
- [Socket.IO](/socketio.md)

## API methods

- [GET /v1/user — Provides user data](/api/user/user.md)
- [POST /v1/user — Create a new user and obtain a unique API key or get an API key from an already created account without Steam OAuth](/api/user/user-post.md)
- [POST /v1/user/steam-token — Temporary set Steam access token for user (Required for online)](/api/user/steam-token.md)
- [POST /v1/my-history — Your trades and transactions history](/api/user/my-history.md)
- [GET /v1/prices — Fetch all unique items and their min price and count](/api/buy-items/prices.md)
- [GET /v1/prices/dopplers — Fetch all dopplers phases by filters](/api/buy-items/prices-dopplers.md)
- [GET /v1/prices/snapshot — Fetch all items listed on WAXPEER (large response size)](/api/buy-items/prices-snapshot.md)
- [GET /v1/check-many-project-id — Checking the status of many steam trades by project_id identifier](/api/buy-items/check-many-project-id.md)
- [GET /v1/check-many-steam — Checking the status of many steam trades by Waxpeer ids](/api/buy-items/check-many-steam.md)
- [GET /v1/check-availability — Fetches available item(s) based on the item_id(s) passed in query](/api/buy-items/check-availability.md)
- [POST /v1/steam-trade — Notification about created tradofer](/api/sell-items/steam-trade.md)
- [GET /v1/ready-to-transfer-p2p — Fetch trades that need to be sent (Deprecated)](/api/sell-items/ready-to-transfer-p2p.md)
- [GET /v1/check-wss-user — Force p2p status check. Recommended for usage with poor network connections](/api/sell-items/check-wss-user.md)
- [POST /v1/buy — Buy items in bulk and send to one tradelink](/api/buy-items/buy.md)
- [GET /v1/buy-one-p2p — Buy items using item_id and send to specific tradelink](/api/buy-items/buy-one-p2p.md)
- [GET /v1/buy-one-p2p-name — Buy item by name and send to specific tradelink](/api/buy-items/buy-one-p2p-name.md)
- [GET /v1/buy-order-history — Buy order trigger history](/api/buy-order/buy-order-history.md)
- [GET /v1/buy-orders — Active buy orders. Sorted by price DESC, if a filter by name is specified](/api/buy-order/buy-orders.md)
- [GET /v1/buy-orders/snapshot — Fetch all maximum orders for items](/api/buy-order/buy-orders-snapshot.md)
- [POST /v1/create-buy-order — Create a buy order to auto purchase items. Currently independent of the p2p status of the user](/api/buy-order/create-buy-order.md)
- [POST /v1/edit-buy-order — Edit buy order](/api/buy-order/edit-buy-order.md)
- [GET /v1/remove-buy-order — Remove buy order(s)](/api/buy-order/remove-buy-order.md)
- [POST /v1/check-tradelink — Check tradelink validity](/api/buy-items/check-tradelink.md)
- [GET /v1/history — Get recent purchases by filters](/api/buy-items/history.md)
- [POST /v1/change-tradelink — Change your tradelink](/api/user/change-tradelink.md)
- [POST /v1/transfer-money — Transfer funds to another user](/api/user/transfer-money.md)
- [GET /v1/set-my-steamapi — Save new Steam API key](/api/user/set-my-steamapi.md)
- [POST /v1/update-account — Update account settings (tradelink, access token, proxy, steam API, and webhook)](/api/user/update-account.md)
- [POST /v1/force-check-trade — Force check the status of a specific trade](/api/buy-items/force-check-trade.md)
- [GET /v1/get-items-list — Fetches items based on the game you pass as a query](/api/steam/get-items-list.md)
- [GET /v1/fetch-my-inventory — Fetch my inventory](/api/sell-items/fetch-my-inventory.md)
- [GET /v1/get-my-inventory — Get items that you can list for sale](/api/sell-items/get-my-inventory.md)
- [GET /v1/remove-items — Remove item(s) by item id(s)](/api/sell-items/remove-items.md)
- [GET /v1/remove-all-orders — Remove all buy orders by filters](/api/buy-order/remove-all-orders.md)
- [GET /v1/remove-all — Remove all listings](/api/sell-items/remove-all.md)
- [POST /v2/merchant/create-deposit — Create merchant deposit](/api/merchant-deposit/create-deposit.md)
- [POST /v2/merchant/steam-inventory — Fetch user's Steam inventory](/api/merchant-deposit/steam-inventory.md)
- [POST /v2/merchant/create-steam-offer — Create Steam offer](/api/merchant-deposit/create-steam-offer.md)
- [GET /v2/merchant/deposit — Fetch merchant deposit status](/api/merchant-deposit/deposit.md)
- [GET /v2/merchant/deposits — Fetch a list of merchant deposits](/api/merchant-deposit/deposits.md)
- [GET /v2/merchant/webhook — Fetch merchant webhook data](/api/merchant-deposit/webhook.md)
- [POST /v2/merchant/webhook/resend — Resend merchant webhook](/api/merchant-deposit/webhook-resend.md)
- [GET /v2/merchant/webhooks — Fetch a list of merchant webhooks](/api/merchant-deposit/webhooks.md)
- [GET /v1/get-steam-items — Fetches recommended item price and other info](/api/steam/get-steam-items.md)
- [GET /v1/payment/currencies/trx — Get current TRX price](/api/payment/currencies-trx.md)
- [GET /v1/payment/tron-energy/cost — Get Tron energy cost estimate for an address](/api/payment/tron-energy-cost.md)
- [POST /v1/payment/tron-energy/rent — Rent Tron energy for an address](/api/payment/tron-energy-rent.md)
- [GET /v1/steam-topup — Check the status of a Steam top-up by id or custom_id](/api/payment/steam-topup.md)
- [POST /v1/steam-topup — Top up a Steam account wallet, paid from your Waxpeer balance](/api/payment/steam-topup-post.md)
- [GET /v1/steam-topup/validate — Check whether a Steam login can be topped up](/api/payment/steam-topup-validate.md)
- [POST /v1/mass-info — Fetch all listings by names](/api/buy-items/mass-info.md)
- [GET /v1/list-items-steam — Get listed steam items](/api/sell-items/list-items-steam.md)
- [POST /v1/list-items-steam — List steam items from inventory](/api/sell-items/list-items-steam-post.md)
- [POST /v1/edit-items — Edit price for listed items](/api/sell-items/edit-items.md)
- [GET /v1/search-items-by-name — Search available items by name(s)](/api/buy-items/search-items-by-name.md)
- [GET /v2/search-items-by-name — Search available items by name(s)](/api/buy-items/search-items-by-name-v2.md)

## Instructions for LLM agents

- Prices are integers; 1000 = 1 USD
- Auth is query param api, not Authorization header
- To go online/sell: POST /v1/user/steam-token hourly with base64 Steam access token
- Prefer GET /v2/search-items-by-name over v1
- Do not use GET /v1/ready-to-transfer-p2p (deprecated); use the trade websocket
- Track purchases with project_id + GET /v1/check-many-project-id
- Trade status is TWO axes: numeric status AND escrow_status / release_date (see /statuses.md)
- Official Node SDK: npm package waxpeer