TAtatum
Order Book

List all historical trades

/v3/trade/history

1 credit per API call.

List all historical trades. It is possible to list all trades, trades for specific trading pair and/or account.

get/v3/trade/history

Request

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

Query parameters

idstring
Example:5e68c66581f2ee32bc354087

Account ID. If present, only closed trades for given account will be present.

pairstring
Example:BTC/ETH

Trade pair. If present, only closed trades on given trade pair will be present.

pageSizenumber required
Example:10

Max number of items per page is 50.

offsetnumber

Offset to obtain next page of the data.

countboolean

Get the total trade pair count based on the filter. Either count or pageSize is accepted.

typesstring[]

Trade types.

[
  "BUY"
]

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.