GET

/api/v1/terminal/history

Permission: SMART_TRADES_READSecurity: SIGNED

Returns a list of trades from history (completed, cancelled, or otherwise closed). This endpoint returns trades that have been completed, cancelled, or otherwise closed. For active trades, use GET /quentrade/trades.

See Trade Entity for full attribute definitions

Trade Entity

Query Parameters

account_idinteger

Optional filter for trades on a specific exchange account. Retrieve available account IDs via GET /api/v1/accounts.

pairstring

Optional filter for trades on a specific trading pair (e.g., USDT_BTC, BTC_ETH).

order_bystring

default: created_at

Field to sort results by. Allowed values: pair, created_at, closed_at.

order_directionstring

default: asc

Sort direction: asc or desc.

limitinteger

default: 10

Number of records to return per page.

offsetinteger

default: 0

Number of records to skip for pagination.

Example Request

GETGET /api/v1/terminal/history?account_id=1&limit=5

Example Responses

Returns an array of historical trade entities. See Trade Entity for full attribute definitions.

trades_history_200.json

200 OK

{
  "trades": [
    {
      "uuid": "be523b7b-05a0-49b9-89f9-41ae19fff415",
      "account_id": 32576869,
      "pair": "BTC_ETH",
      "created_at": 1727871936,
      "closed_at": 1727871937,
      "order": {
        "type": "market",
        "side": "buy",
        "strategy": null,
        "position_side": "both",
        "reduce_only": false
      },
      "units": {
        "value": "2.4869"
      },
      "price": {
        "value": null
      },
      "total": {
        "value": "0.099898773"
      },
      "conditional": {
        "enabled": false,
        "value": null,
        "price": {
          "value": null,
          "type": null
        }
      },
      "trailing": {
        "enabled": false,
        "value": null,
        "percent": null
      },
      "timeout": {
        "enabled": false,
        "value": null
      },
      "leverage": {
        "type": null
      },
      "status": {
        "value": "finished",
        "error": null
      },
      "filled": {
        "units": "2.4869",
        "total": "0.099998671773",
        "price": "0.04021",
        "value": "100.0"
      },
      "data": {
        "cancelable": false
      }
    }
  ]
}

PREVIOUS Get Active Trades NEXTCancel Trade