---
title: "List all active buy trades"
method: POST
path: "/v3/trade/buy"
tags: ["Order Book"]
---

# List all active buy trades

`POST /v3/trade/buy`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/trade/buy`
- Auth: API key in header `x-api-key`

/v3/trade/buy

#### 1 credit per API call.

  

List all active buy trades.

## Request body

- ListOderBookActiveBuyBody
  - `id` string: Account ID. If present, list current active sell trades for that account.
  - `customerId` string: Customer ID. If present, list current active buy trades for that customer.
  - `pageSize` number, required: Max number of items per page is 50.
  - `offset` number: Offset to obtain next page of the data.
  - `pair` string: Trade pair. If present, list current active sell trades for that pair.
  - `count` boolean: Get the total trade pair count based on the filter. Either count or pageSize is accepted.
  - `tradeType` 'FUTURE_BUY' | 'BUY': Trade type.
  - `amount` object[]: Amount of the trade. AND is used between filter options.
    - `op` 'gte' | 'lte' | 'gt' | 'lt' | 'eq' | 'neq', required: Filtering operation.
    - `value` string, required: Value of the operation.
  - `fill` object[]: Fill of the trade. AND is used between filter options.
    - `op` 'gte' | 'lte' | 'gt' | 'lt' | 'eq' | 'neq', required: Filtering operation.
    - `value` string, required: Value of the operation.
  - `price` object[]: Price of the trade. AND is used between filter options.
    - `op` 'gte' | 'lte' | 'gt' | 'lt' | 'eq' | 'neq', required: Filtering operation.
    - `value` string, required: Value of the operation.
  - `created` object[]: Created date of the trade. AND is used between filter options.
    - `op` 'gte' | 'lte' | 'gt' | 'lt' | 'eq' | 'neq', required: Filtering operation.
    - `value` string, required: Value of the operation.
  - `sort` string[]: Sorts the result by selected property. The priority of the items is determined by order of the sort properties in array.

## Response `200`

OK

- Trade[]
  - `id` string: ID of the trade
  - `type` 'BUY' | 'SELL': Type of the trade, BUY or SELL
  - `price` string: Price to buy / sell
  - `amount` string: Amount of the trade to be bought / sold
  - `pair` string: Trading pair
  - `isMaker` boolean: If closed trade was Maker or Taker trade
  - `fill` string: How much of the trade was already filled.
  - `feeAccountId` string: ID of the account where fee will be paid, if any. If trade is a BUY or FUTURE_BUY type, feeAccountId must have same currency as a currency of currency2AccountId, and vice versa if trade is a SELL or FUTURE_SELL type, feeAccountId must have same currency as a currency of currency1AccountId.
  - `fee` number: Percentage of the trade amount to be paid as a fee.
  - `currency1AccountId` string: ID of the account of the currenc 1 trade currency
  - `currency2AccountId` string: ID of the account of the currenc 2 trade currency
  - `created` number: Creation date, UTC millis
  - `attr` object: Additional attributes for the future type.
    - `sealDate` number, required: Time in UTC when the future will be filled.
    - `percentBlock` number: Percentage of the future amount which the selling or buying account must have available for the future’s creation. This amount will be blocked until the future is filled or expires.
    - `percentPenalty` number: If one of the parties doesn’t have the full amount of the future at the time of expiration filled, the party will be penalized.

## Other responses

- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)