---
title: "Get Trades"
method: GET
path: "/v1/trades"
tags: ["trades"]
---

# Get Trades

`GET /v1/trades`

## Request

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

Get a list of trades based on specified filters.
- requires [bearer token](/rest/authentication#add-authenticated-request-header) in authorization header
- Only the last 24 hours of data is available for querying
- [supports pagination](/rest/general/pagination)
- filtering on `createdAtDatetime`, `createdAtTimestamp` requires additional keywords, [see filtering support](/rest/general/filtering)

**Ratelimited:** `True`

## Query parameters

- `symbol` string: market symbol. E.g. `BTCUSDC`
- `orderId` string
- `clientOrderId` string: Unique numeric (i64) identifier generated on the client side expressed as a string value
- `tradingAccountId` string, required: unique trading account ID
- `otcTradeId` string: unique numeric (i64) identifier generated on Bullish side expressed as a string value
- `clientOtcTradeId` string: unique numeric (i64) identifier generated on the client side expressed as a string value

## Response `200`

OK

- Trade[]
  - `tradeId` string, required
  - `orderId` string, required
  - `clientOrderId` string, required: Unique numeric (i64) identifier generated on the client side expressed as a string value
  - `symbol` string, required: market symbol. E.g. `BTCUSDC`
  - `price` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quantity` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quoteAmount` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `baseFee` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `quoteFee` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `side` string, required: order side can have the following string values `"BUY"`, `"SELL"`
  - `isTaker` boolean, required
  - `tradeRebateAmount` string, required: see [asset value](/rest/general/price-quantity-precision) format
  - `tradeRebateAssetSymbol` string, required: asset symbol as denoted in the world
  - `otcMatchId` string, required: unique numeric (i64) identifier generated on Bullish side expressed as a string value
  - `otcTradeId` string, required: unique numeric (i64) identifier generated on Bullish side expressed as a string value
  - `clientOtcTradeId` string, required: unique numeric (i64) identifier generated on the client side expressed as a string value
  - `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

## Other responses

- `401`: Not Authenticated
- `403`: Access Forbidden
- `429`: Too Many Requests
- `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)