Historical trades

PreviousSpot NextOrderbook

spotHistoricalTrades Aggregator

get

This endpoint provide data on historical completed trades for a given market pair.

Query parameters

ticker_idstringRequired

Specify unique ticker to search.

Example: INJ/USDT

typestringRequired

To indicate nature of trade - buy/sell - for a given market pair.

Example: buy

limitinteger · int64Optional

Number of historical trades to retrieve from time of query. [0, 200, 500...]. 0 returns full history.

Example: 7254303766472678000

Responses

application/json

objectOptionalExample:

{"buy":[{"base_volume":0.1,"price":50.1,"target_volume":1,"trade_id":"0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141","trade_timestamp":1484871000,"type":"buy"},{"base_volume":0.1,"price":50.1,"target_volume":1,"trade_id":"0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141","trade_timestamp":1484871000,"type":"buy"},{"base_volume":0.1,"price":50.1,"target_volume":1,"trade_id":"0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141","trade_timestamp":1484871000,"type":"buy"}],"sell":[{"base_volume":0.1,"price":50.1,"target_volume":1,"trade_id":"0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141","trade_timestamp":1484871000,"type":"buy"},{"base_volume":0.1,"price":50.1,"target_volume":1,"trade_id":"0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141","trade_timestamp":1484871000,"type":"buy"}]}

application/vnd.goa.error

get

GET /api/aggregator/v1/spot/historical_trades HTTP/1.1
Host: inj-indexer.nownodes.io
Accept: */*

{
  "buy": [
    {
      "base_volume": 0.1,
      "price": 50.1,
      "target_volume": 1,
      "trade_id": "0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141",
      "trade_timestamp": 1484871000,
      "type": "buy"
    },
    {
      "base_volume": 0.1,
      "price": 50.1,
      "target_volume": 1,
      "trade_id": "0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141",
      "trade_timestamp": 1484871000,
      "type": "buy"
    },
    {
      "base_volume": 0.1,
      "price": 50.1,
      "target_volume": 1,
      "trade_id": "0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141",
      "trade_timestamp": 1484871000,
      "type": "buy"
    }
  ],
  "sell": [
    {
      "base_volume": 0.1,
      "price": 50.1,
      "target_volume": 1,
      "trade_id": "0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141",
      "trade_timestamp": 1484871000,
      "type": "buy"
    },
    {
      "base_volume": 0.1,
      "price": 50.1,
      "target_volume": 1,
      "trade_id": "0x747e0978c13261a8c8286f86649d5d3b2cc75cd69ec2461c29d2a8358a3c3141",
      "trade_timestamp": 1484871000,
      "type": "buy"
    }
  ]
}