Get Trade

GET

/ver1/trades/{uuid}

Permission: SMART_TRADES_READ

Security: SIGNED

Returns a single trade by its UUID.

Use this endpoint to retrieve all details of a specific trade, including order type, amount, status, and execution conditions.

---

Path Parameters

uuidstringrequired

The unique identifier of the trade to retrieve. Example: f89e3f34-1db1-47f2-81cc-9b4e5c50d7e1

Example Request

GET

/ver1/trades/f89e3f34-1db1-47f2-81cc-9b4e5c50d7e1

Response Parameters

If successful, returns the full trade object. See Trade Entity for a full list of attributes.

Example Responses

200 OK

{
  "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
  }
}

404 Not Found

{
  "error": "not_found",
  "error_description": "Not Found"
}

403 Forbidden

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