Trades History

GET

/ver1/trades/history

Permission: SMART_TRADES_READ

Security: 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 /ver1/trades.

---

Query Parameters

account_idinteger

Optional filter for trades on a specific account. You can get IDs via GET /ver1/accounts.

pairstring

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

order_bystring

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

default: created_at

order_directionstring

Sort direction: asc or desc.

default: asc

limitinteger

Number of records to return.

default: 10

offsetinteger

Number of records to skip for pagination.

default: 0

Example Request

GET

/ver1/trades/history?account_id=1&limit=5

Response Parameters

Returns an array of historical trade entities. See Trade Entity for a full list of attributes.

Example Responses

200 OK

{
  "response": {
    "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
          }
        }
      ]
  }
}

403 Forbidden

{
  "error": "Forbidden",
  "error_description": "Api key not authorized for this action"
}