# Your trades and transactions history

`POST /v1/my-history`

Fetch trades and transactions by one request, maximum 100 in response.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `api` | query | string | required | Your [WAXPEER API](https://waxpeer.com/profile/user) |

## Request body

```json
{
  "skip": 0,
  "start": "09-20-2022",
  "end": "10-25-2022",
  "sort": "DESC",
  "float": 0,
  "hold_only": false,
  "spendings": false,
  "incomings": false
}
```

## Example (curl)

```bash
curl -X POST 'https://api.waxpeer.com/v1/my-history?api=%7B%7BAPI_KEY%7D%7D' \
  -H 'Content-Type: application/json' \
  -d '{
  "skip": 0,
  "start": "09-20-2022",
  "end": "10-25-2022",
  "sort": "DESC",
  "float": 0,
  "hold_only": false,
  "spendings": false,
  "incomings": false
}'
```

## Example response

```json
{
  "success": true,
  "data": {
    "trades": [
      {
        "date": "2022-10-29T23:58:17.318Z",
        "created": "2022-10-29T23:52:17.318Z",
        "id": 4258120,
        "item_id": "27341302961",
        "give_amount": 1898572,
        "image": "https://steamcommunity-a.akamaihd.net/economy/image/class/730/4839650857/200fx125f",
        "price": 2019758,
        "trade_id": 123456789,
        "game": "csgo",
        "name": "★ Karambit | Gamma Doppler (Factory New)",
        "market_name": "Gamma Doppler Phase 3",
        "float": 0.0460052728652954,
        "status": 5,
        "average": 2419222,
        "action": "buy",
        "is_released": false,
        "release_date": "2025-07-28T10:30:00.000Z"
      }
    ],
    "transactions": [
      {
        "wallet": "string",
        "type": "BTC",
        "status": "completed",
        "amount": 10256672,
        "give_amount": 10256672,
        "direction": "in",
        "date": "2022-01-22T01:22:43.021Z"
      }
    ]
  }
}
```

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