---
title: "Get existing trade"
method: GET
path: "/v3/trade/{id}"
tags: ["Order Book"]
---

# Get existing trade

`GET /v3/trade/{id}`

## Request

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

/v3/trade/{id}

#### 1 credit for API call

  

Get existing opened trade.

## Path parameters

- `id` string, required

## 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

- `400`: Bad Request
- `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)