TAtatum
Order Book

List all active sell trades

/v3/trade/sell

1 credit per API call.

List all active sell trades.

get/v3/trade/sell

Request

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

Query parameters

idstring
Example:5e68c66581f2ee32bc354087

Account ID. If present, list current active sell trades for that account.

customerIdstring
Example:5e68c66581f2ee32bc354087

Customer ID. If present, list current active buy trades for that customer.

pageSizenumber required
Example:10

Max number of items per page is 50.

offsetnumber

Offset to obtain next page of the data.

pairstring
Example:BTC/EUR

Trade pair. If present, list current active sell trades for that pair.

countboolean

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

tradeType'FUTURE_SELL' | 'SELL'

Trade type.

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.