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 string

The symbol of the Futures.

lastTime string

Returns the last 100 trades from the specified lastTime value.

Responses

200

application/json

Schema

Schema

oneOf

Success Response

history object[]

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

Array [

price number

For futures: The price of a fill

For indices: The calculated value

side stringnull

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 stringnull

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

time string

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 stringnull

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 stringnull

instrument_identification_type stringnull

isin stringnull

execution_venue stringnull

price_notation stringnull

price_currency stringnull

notional_amount numbernull

notional_currency stringnull

publication_time stringnull

publication_venue stringnull

transaction_identification_code stringnull

to_be_cleared booleannull

]

result stringrequired

Possible values: [success]

serverTime date-timerequired

Server time in Coordinated Universal Time (UTC)

ErrorResponse

errors Error (string)[]

Possible values: [accountInactive, apiLimitExceeded, authenticationError, insufficientFunds, invalidAccount, invalidAmount, invalidArgument, invalidUnit, Json Parse Error, marketUnavailable, nonceBelowThreshold, nonceDuplicate, notFound, requiredArgumentMissing, Server Error, Unavailable, unknownError]

error Error (string)

Possible values: [accountInactive, apiLimitExceeded, authenticationError, insufficientFunds, invalidAccount, invalidAmount, invalidArgument, invalidUnit, Json Parse Error, marketUnavailable, nonceBelowThreshold, nonceDuplicate, notFound, requiredArgumentMissing, Server Error, Unavailable, unknownError]

Error description.

• accountInactive: The Futures account the request refers to is inactive
• apiLimitExceeded: The API limit for the calling IP address has been exceeded
• authenticationError: The request could not be authenticated
• insufficientFunds: The amount requested for transfer is below the amount of funds available
• invalidAccount: The Futures account the transfer request refers to is invalid
• invalidAmount: The amount the transfer request refers to is invalid
• invalidArgument: One or more arguments provided are invalid
• invalidUnit: The unit the transfer request refers to is invalid
• Json Parse Error: The request failed to pass valid JSON as an argument
• marketUnavailable: The market is currently unavailable
• nonceBelowThreshold: The provided nonce is below the threshold
• nonceDuplicate: The provided nonce is a duplicate as it has been used in a previous request
• notFound: The requested information could not be found
• requiredArgumentMissing: One or more required arguments are missing
• Server Error: There was an error processing the request
• Unavailable: The endpoint being called is unavailable
• unknownError: An unknown error has occurred

result stringrequired

Possible values: [error]

serverTime date-timerequired

Server time in Coordinated Universal Time (UTC)

Loading...