Skip to main content

Get trade history

GET 

/history

This endpoint returns the most recent 100 trades prior to the specified lastTime value up to past 7 days or recent trading engine restart (whichever is sooner).

If no lastTime specified, it will return 100 most recent trades.

Request

Query Parameters

    symbol stringrequired

    The symbol of the Futures.

    lastTime string

    Returns the last 100 trades from the specified lastTime value.

Responses

Schema
    oneOf
    history object[]required

    A list containing structures with historical price information. The list is sorted descending by time.

  • Array [
  • price numberrequired

    For futures: The price of a fill

    For indices: The calculated value

    side string

    The classification of the taker side in the matched trade: "buy" if the taker is a buyer, "sell" if the taker is a seller.

    size string

    For futures: The size of a fill For indices: Not returned because N/A

    time stringrequired

    The date and time of a trade or an index computation

    For futures: The date and time of a trade. Data is not aggregated For indices: The date and time of an index computation. For real-time indices, data is aggregated to the last computation of each full hour. For reference rates, data is not aggregated

    trade_id int32

    For futures: A continuous index starting at 1 for the first fill in a Futures contract maturity For indices: Not returned because N/A

    type string

    Possible values: [fill, liquidation, assignment, termination, block]

    The classification of the matched trade in an orderbook:

    • fill - it is a normal buyer and seller
    • liquidation - it is a result of a user being liquidated from their position
    • assignment - the fill is the result of a users position being assigned to a marketmaker
    • termination - it is a result of a user being terminated
    • block - it is an element of a block trade
    uid string
    instrument_identification_type string
    isin string
    execution_venue string
    price_notation string
    price_currency string
    notional_amount number
    notional_currency string
    publication_time string
    publication_venue string
    transaction_identification_code string
    to_be_cleared boolean
  • ]
  • result stringrequired

    Possible values: [success]

    serverTime date-timerequired

    Server time in Coordinated Universal Time (UTC)

Loading...