TAtatum
Order Book

Get existing trade

/v3/trade/{id}

1 credit for API call

Get existing opened 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

Path parameters

idstring required
Example:5e68c66581f2ee32bc354087

Trade ID

Response

OK

idstring

ID of the trade

type'BUY' | 'SELL'

Type of the trade, BUY or SELL

pricestring

Price to buy / sell

amountstring

Amount of the trade to be bought / sold

pairstring

Trading pair

isMakerboolean

If closed trade was Maker or Taker trade

fillstring

How much of the trade was already filled.

feeAccountIdstring

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.

feenumber

Percentage of the trade amount to be paid as a fee.

currency1AccountIdstring

ID of the account of the currenc 1 trade currency

currency2AccountIdstring

ID of the account of the currenc 2 trade currency

creatednumber

Creation date, UTC millis

Example response

{
  "id": "7c21ed165e294db78b95f0f1",
  "type": "BUY",
  "price": "8650.4",
  "amount": "15000",
  "pair": "BTC/EUR",
  "isMaker": true,
  "fill": "1500",
  "feeAccountId": "7c21ed165e294db78b95f0f1",
  "fee": 1.5,
  "currency1AccountId": "7c21ed165e294db78b95f0f1",
  "currency2AccountId": "7c21ed165e294db78b95f0f1",
  "created": 1585170363103,
  "attr": {
    "sealDate": 1572031674384,
    "percentBlock": 1.5,
    "percentPenalty": 1.5
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.