---
title: "Retrieve Trade"
method: GET
path: "/trades/{id}"
tags: ["Trades"]
---

# Retrieve Trade

`GET /trades/{id}`

Retrieves a trade. Order acknowledgements don't update as orders fill; read live orders and positions from the account's `trading` field. Never resubmit a `submission_unknown` trade with a new idempotency key.

## Response `200`

trade retrieved

- Trade
  - `account_id` string, nullable, required — The account that owns the trading wallet, prefixed `biz_`. `null` when a user owns it.
  - `cancellations` TradeCancellationResult[], nullable, required
    - `error` string, nullable, required — The provider's rejection reason, or `null` when the order was canceled.
    - `id` string, required — Client order ID of the order the cancellation targeted, prefixed `trdcloid_`.
    - `status` 'canceled' | 'rejected', required — `canceled` when the provider canceled the order; `rejected` when it refused, for example because the order had already filled.
  - `completed_at` string, nullable, required — When the submission finished, as an ISO 8601 timestamp, or `null` while it is pending or its outcome is unknown.
  - `created_at` string, required — When the trade was submitted, as an ISO 8601 timestamp.
  - `failure_code` 'pre_submission_error' | 'provider_rejected' | 'provider_outcome_unknown' | 'null', nullable, required — Why the trade failed or has an unknown outcome, or `null` otherwise.
  - `hyperliquid` TradeHyperliquid, required
    - `builder_fee_bps` string, nullable, required — Builder fee Whop charged on the submitted orders, in basis points as a decimal string, or `null` for trades that place no orders.
  - `id` string, required — Trade ID, prefixed `trop_`.
  - `instrument_type` 'perpetual', required — The kind of instrument traded.
  - `leverage` TradeLeverage, required
    - `leverage` integer, nullable, required — Requested leverage multiplier, such as `10` for 10x, or `null` if the request didn't contain a whole number.
    - `margin_mode` 'cross' | 'isolated' | 'null', nullable, required — `cross` shares margin across positions; `isolated` limits margin to this market's position. `null` if the request didn't contain a supported mode.
    - `market` string, required — Market symbol, such as `ETH`.
  - `metadata` object, required — String-to-string annotations you provided when submitting the trade.
  - `object` 'trade', required
  - `operation_type` 'create_orders' | 'cancel_orders' | 'update_leverage', required — `create_orders` places orders, `cancel_orders` cancels a submitted batch, and `update_leverage` sets a market's leverage.
  - `orders` TradeOrderResult[], nullable, required
    - `average_price` Money, required
      - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
      - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
      - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
      - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
    - `client_order_id` string, required — Client order ID Whop assigned to the order, prefixed `trdcloid_`.
    - `error` string, nullable, required — The provider's rejection reason, or `null` when the order was accepted.
    - `filled_size` string, nullable, required — Size filled immediately at submission, as a decimal string, or `null` when nothing filled.
    - `hyperliquid` TradingHyperliquidOrder, required
      - `reduce_only` boolean, nullable, required — Whether the order can only reduce an existing position, or `null` when Hyperliquid omits it.
      - `trigger_price` Money, required
        - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
        - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
        - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
        - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
    - `id` string, required — Trading order ID, prefixed `trdord_` once the provider assigns one, otherwise the client order ID prefixed `trdcloid_`.
    - `market` string, required — Market symbol on the provider, such as `ETH`.
    - `object` 'trading_order', required
    - `order_type` 'limit' | 'market' | 'take_profit' | 'stop_loss', required
    - `parent_client_order_id` string, nullable, required — For an attached take-profit or stop-loss, the client order ID of its entry order, prefixed `trdcloid_`. `null` for other orders.
    - `price` Money, required
      - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
      - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
      - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
      - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
    - `provider_order_id` string, nullable, required — The provider's own order ID, or `null` until the provider assigns one, such as for a rejected order or a take-profit or stop-loss that hasn't triggered yet.
    - `side` 'buy' | 'sell', required
    - `size` string, required — Submitted size as a decimal string.
    - `status` 'open' | 'filled' | 'rejected', required — The provider's acknowledgement at submission time, not the current fill status.
  - `provider` 'hyperliquid', required — Trading venue the trade was submitted to.
  - `requested_orders` TradeRequestedOrder[], nullable, required
    - `client_order_id` string, required — Client order ID Whop assigned to the order, prefixed `trdcloid_`. Matches the order in `orders` and on the provider.
    - `market` string, required — Market symbol as submitted, such as `ETH`.
    - `order_type` 'limit' | 'market' | 'take_profit' | 'stop_loss' | 'null', nullable, required — Submitted order type, or `null` if the request didn't contain a supported type.
    - `parent_client_order_id` string, nullable, required — For an attached take-profit or stop-loss, the client order ID of its entry order, prefixed `trdcloid_`. `null` for other orders.
    - `price` Money, required
      - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
      - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
      - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
      - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
    - `side` 'buy' | 'sell' | 'null', nullable, required — Submitted side, or `null` if the request didn't contain a supported side.
    - `size` string, required — Submitted size as a decimal string.
    - `trigger_price` Money, required
      - `amount` string, required — The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
      - `currency` string, required — Three-letter ISO 4217 currency code, lowercase.
      - `decimals` integer, required — How many decimal places the amount CARRIES — the precision the charge itself runs at.
      - `display_decimals` integer, required — How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
  - `status` 'pending' | 'submitted' | 'completed' | 'failed' | 'submission_unknown', required — Submission status, not fill status. `completed` means the provider response was recorded, even if individual orders were rejected. Never resubmit a `submission_unknown` trade with a new idempotency key.
  - `trade_id` string, nullable, required — For a cancellation, the ID of the canceled trade, prefixed `trop_`. `null` otherwise.
  - `updated_at` string, required — When the trade last changed, as an ISO 8601 timestamp.
  - `user_id` string, nullable, required — The user who owns the trading wallet, prefixed `user_`. `null` when an account owns it.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

## Changes

> 74 revisions in range; 1 not diffed.

- **2026-09-27** `78e1ed7366cd` — 2 info
  - the security scope `crypto_wallet:trade:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-26** `73dd0533cd81` — 2 info
  - the security scope `crypto_wallet:trade:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-25** `86b97292852d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/trades/:id/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/78e1ed7366cd?raw)