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

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