# Trades History

## Get user trades history

<mark style="color:green;">`GET`</mark> `/trades`

Get a list of user trades with pagination

**Headers**

| Name       | Value                 |
| ---------- | --------------------- |
| X-API-Key  | `API Key`             |
| X-API-Sign | `Generated Signature` |

**Query Params**

<table><thead><tr><th>Name</th><th>Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>pairs[]</code></td><td>array</td><td>false</td><td>Multiple pairs to filter</td></tr><tr><td><code>page-size</code></td><td>number</td><td>false</td><td>Items per page, if not set no pagination is applied</td></tr><tr><td><code>page</code></td><td>number</td><td>false</td><td>The page number to get</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "success": true,
    "message": "Request processed successfully",
    "data": [
        {
            "id": 653,
            "timestamp": "2024-03-23 21:42:16",
            "type": "buy",
            "order_id": 414,
            "order_type": "limit",
            "pair_id": 679,
            "pair": "NIZA/EUR",
            "volume": {
                "amount": "54.10027025",
                "currency": "NIZA"
            },
            "price": {
                "amount": "0.01450000",
                "currency": "NIZA/EUR"
            },
            "cost": {
                "amount": "0.78445392",
                "currency": "EUR"
            },
            "fee": {
                "amount": "0.78445392",
                "currency": "NIZA"
            },
            "transaction_id": "TTXR7L-IC8HD-BFND2K",
            "leverage": null
        },
        {
            "id": 651,
            "timestamp": "2024-03-23 21:40:15",
            "type": "buy",
            "order_id": 414,
            "order_type": "limit",
            "pair_id": 679,
            "pair": "NIZA/EUR",
            "volume": {
                "amount": "50.00000000",
                "currency": "NIZA"
            },
            "price": {
                "amount": "0.01450000",
                "currency": "NIZA/EUR"
            },
            "cost": {
                "amount": "0.72500000",
                "currency": "EUR"
            },
            "fee": {
                "amount": "0.72500000",
                "currency": "NIZA"
            },
            "transaction_id": "TMWHLR-WNUTL-NZIL3B",
            "leverage": null
        }
    ],
    "code": 200,
    "meta": {
        "current_page": 2,
        "from": 3,
        "to": 4,
        "path": "https://app.niza.io/trade/v1/trades",
        "per_page": 2,
        "total": 253,
        "last_page": 127
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}