Trade History

GET 
/marketdata/api/v1/history/:symbol

Retrieves historical trade data for a specific market (ticker) based on the specified type (buy/sell).

Request

Path Parameters

symbol stringrequired

Possible values: Value must match regular expression ^[a-z0-9]{3,}_[a-z0-9]{3,}$

market symbol like btc_usdc

Query Parameters

type OrderSide

Possible values: [Buy, Sell]

Type of Order, Buy or Sell

limit int32

Number of historical trades to retrieve from time of query. Default 100; max 500.

endDateTime date-time

End time for historical trades query

cursor string

Cursor for pagination (optional).

Responses

200

Success

text/plain

Schema

Schema

nextCursor stringnullable

Cursor for fetching next set of records

items

object[]

nullable

Array of trade history

Array [

tradeId int64

Unique identifier for the trade.

price double

The price at which the trade occurred.

baseVolume double

The volume of the base currency traded.

targetVolume double

The volume of the target currency traded.

timestamp date-time

The timestamp of when the trade occurred.

side OrderSide

Possible values: [Buy, Sell]

]

Example (from schema)

{
  "nextCursor": "30",
  "items": [
    {
      "tradeId": 10,
      "price": 58000.1,
      "baseVolume": 1000.01,
      "targetVolume": 100000.04,
      "timestamp": "3/12/2024 7:47:14 AM",
      "side": "Buy"
    }
  ]
}

Example

{
  "nextCursor": "20",
  "items": [
    {
      "tradeId": 10,
      "price": 60000.1,
      "baseVolume": 0.1,
      "targetVolume": 6000.04,
      "timestamp": "2024-05-14T08:03:04.2652465Z",
      "side": "Buy"
    },
    {
      "tradeId": 9,
      "price": 60000.02,
      "baseVolume": 0.5,
      "targetVolume": 10000.06,
      "timestamp": "2024-05-14T08:03:04.2652476Z",
      "side": "Sell"
    }
  ]
}

application/json

Schema

Schema

nextCursor stringnullable

Cursor for fetching next set of records

items

object[]

nullable

Array of trade history

Array [

tradeId int64

Unique identifier for the trade.

price double

The price at which the trade occurred.

baseVolume double

The volume of the base currency traded.

targetVolume double

The volume of the target currency traded.

timestamp date-time

The timestamp of when the trade occurred.

side OrderSide

Possible values: [Buy, Sell]

]

Example (from schema)

{
  "nextCursor": "30",
  "items": [
    {
      "tradeId": 10,
      "price": 58000.1,
      "baseVolume": 1000.01,
      "targetVolume": 100000.04,
      "timestamp": "3/12/2024 7:47:14 AM",
      "side": "Buy"
    }
  ]
}

Example

{
  "nextCursor": "20",
  "items": [
    {
      "tradeId": 10,
      "price": 60000.1,
      "baseVolume": 0.1,
      "targetVolume": 6000.04,
      "timestamp": "2024-05-14T08:03:04.2652465Z",
      "side": "Buy"
    },
    {
      "tradeId": 9,
      "price": 60000.02,
      "baseVolume": 0.5,
      "targetVolume": 10000.06,
      "timestamp": "2024-05-14T08:03:04.2652476Z",
      "side": "Sell"
    }
  ]
}

text/json

Schema

Schema

nextCursor stringnullable

Cursor for fetching next set of records

items

object[]

nullable

Array of trade history

Array [

tradeId int64

Unique identifier for the trade.

price double

The price at which the trade occurred.

baseVolume double

The volume of the base currency traded.

targetVolume double

The volume of the target currency traded.

timestamp date-time

The timestamp of when the trade occurred.

side OrderSide

Possible values: [Buy, Sell]

]

Example (from schema)

{
  "nextCursor": "30",
  "items": [
    {
      "tradeId": 10,
      "price": 58000.1,
      "baseVolume": 1000.01,
      "targetVolume": 100000.04,
      "timestamp": "3/12/2024 7:47:14 AM",
      "side": "Buy"
    }
  ]
}

Example

{
  "nextCursor": "20",
  "items": [
    {
      "tradeId": 10,
      "price": 60000.1,
      "baseVolume": 0.1,
      "targetVolume": 6000.04,
      "timestamp": "2024-05-14T08:03:04.2652465Z",
      "side": "Buy"
    },
    {
      "tradeId": 9,
      "price": 60000.02,
      "baseVolume": 0.5,
      "targetVolume": 10000.06,
      "timestamp": "2024-05-14T08:03:04.2652476Z",
      "side": "Sell"
    }
  ]
}

Loading...