# Buy order trigger history

`GET /v1/buy-order-history`

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |
| `skip` | query | number | optional | By default it will return 50 trades, use skip to fetch more (Max: 2000) |
| `game` | query | enum | optional | Which game would you like to get items from (without game param will return for all) |
| `sort` | query | enum | optional | Sort by date (ASC/DESC) |

## Example (curl)

```bash
curl -X GET 'https://api.waxpeer.com/v1/buy-order-history?api=%7B%7BAPI_KEY%7D%7D&skip=0&game=csgo&sort=ASC'
```

## Example response

```json
{
  "success": false,
  "history": [
    {
      "id": 0,
      "item_name": "string",
      "game": "string",
      "price": 0,
      "created": "2020-03-25T07:10:03.674Z",
      "last_updated": "2020-03-25T07:10:03.674Z",
      "msg": "string"
    }
  ],
  "count": 2
}
```

## Responses

- `200` successful operation

## 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).