---
title: "Get Unconfirmed OTC Trade"
method: GET
path: "/v2/otc-trades/unconfirmed-trade"
tags: ["otc"]
---

# Get Unconfirmed OTC Trade

`GET /v2/otc-trades/unconfirmed-trade`

## Request

- Base URL: `https://api.exchange.bullish.com/trading-api`
- URL: `https://api.exchange.bullish.com/trading-api/v2/otc-trades/unconfirmed-trade`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bullish/apis/bullish-trading-api/docs/v2/otc-trades/unconfirmed-trade/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the unconfirmed trade details using shared match key.

## Query parameters

- `tradingAccountId` string, required: unique trading account ID
- `sharedMatchKey` string, required: Unique shared key that is agreed between the two customers to represent their OTC trade to be matched on Bullish's OTC Clearing Facility. Must be a 12 to 64 characters alphanumeric value

## Response `200`

OK

- UnconfirmedOtcTradeView: An unconfirmed OTC trade for booking.
  - `sharedMatchKey` string, required: Unique shared key that is agreed between the two customers to represent their OTC trade to be matched on Bullish's OTC Clearing Facility. Must be a 12 to 64 characters alphanumeric value
  - `isTaker` boolean, required
  - `createdAtDatetime` string, date-time, required: ISO 8601 with millisecond as string
  - `createdAtTimestamp` string, string, required: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
  - `expireDatetime` string, date-time, required: ISO 8601 with millisecond as string
  - `expireTimestamp` string, string, required: unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string
  - `trades` TradeInOtcRequest[], required: all trades for the OTC trade
    - `symbol` string, required: market symbol. E.g. `BTC-USDC-PERP` for PERPETUAL market `BTC-USDC-20250613` for DATEDFUTURE market and `BTC-USDC-20250613-100000-C` for OPTION market
    - `price` string, required: see [asset value](/rest/general/price-quantity-precision) format
    - `quantity` string, required: see [asset value](/rest/general/price-quantity-precision) format
    - `side` string, required: trade side can have the following string values `BUY`, `SELL`

## Other responses

- `400`: For example, querying a closed OTC trade
- `401`: Not Authenticated
- `403`: Access Forbidden
- `404`: The unconfirmed OTC trade does not exist
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bullish/apis/bullish-trading-api.md) - [All operations](https://skmtc.dev/bullish/apis/bullish-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bullish/apis/bullish-trading-api/revisions/df5d69ccedcf?raw)