# Create a buy order to auto purchase items. Currently independent of the p2p status of the user

`POST /v1/create-buy-order`

Rate limit of create/edit actions for orders is 60 requests per 60 seconds

You can have one order per item name

Prices are integers. `1000` = `1 USD`.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |
| `name` | query | string | required | Name of item |
| `amount` | query | number | required | Amount of items |
| `price` | query | number | required | Max price that you want to buy item for (1000 = 1$) |
| `game` | query | enum | required | Target item game |

## Example (curl)

```bash
curl -X POST 'https://api.waxpeer.com/v1/create-buy-order?api=%7B%7BAPI_KEY%7D%7D&name=AK-47+%7C+Redline+%28Field-Tested%29&amount=1&price=15000&game=csgo'
```

## Example response

```json
{
  "success": true,
  "msg": "Placed order",
  "filled": 2,
  "id": 2007
}
```

## Responses

- `200` successful operation
- `429` Too many requests

## Notes for agents

- Auth is the query parameter `api`, not an Authorization header.
- See [/statuses.md](/statuses.md) for numeric trade status plus `escrow_status` / `release_date`.
- Prefer GET /v2/search-items-by-name over v1.
- Do not use GET /v1/ready-to-transfer-p2p; use the [trade websocket](/websocket.md).