Futures

All operations use QuoteClient.ExecuteAsync.

STOCK_DETAIL and QUOTE_OVERNIGHT require additional market-data entitlements. The server returns a permission error code when an entitlement is missing.

Get Futures Exchanges

Operation

QuoteApiService.FUTURE_EXCHANGE = future_exchange. Uses server method future_exchange.

Request

TigerRequest<FutureExchangeResponse>

ModelValue: FutureExchangeModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
SecTypestringsec_typenullOptional

Return

FutureExchangeResponse inherits TigerResponse; its data property is list of FutureExchangeItem. Key SDK fields: Code: string, Name: string, ZoneId: string.

Example

TigerRequest<FutureExchangeResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_EXCHANGE,
    ModelValue = new FutureExchangeModel { Account = tradeClient.GetDefaultAccount, SecType = "STK" }
};
FutureExchangeResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureExchangeItem>? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"code": "CME", "name": "CME", "zoneId": "America/Chicago"},
    {"code": "HKEX", "name": "HKEX", "zoneId": "Asia/Hong_Kong"},
    {"code": "SGX", "name": "SGX", "zoneId": "Asia/Singapore"}
  ]
}

Related APIs

See Requests, responses, and operations.

Get Contract by Code

Operation

QuoteApiService.FUTURE_CONTRACT_BY_CONTRACT_CODE = future_contract_by_contract_code. Uses server method future_contract_by_contract_code.

Request

TigerRequest<FutureContractResponse>

ModelValue: FutureContractByConCodeModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodestringcontract_codenullRequired

Return

FutureContractResponse inherits TigerResponse; its data property is FutureContractItem. Key SDK fields: Type: string, Name: string, IbCode: string, ContractCode: string, ContractMonth: string, ExchangeCode: string, Exchange: string, Multiplier: decimal.

Example

TigerRequest<FutureContractResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTRACT_BY_CONTRACT_CODE,
    ModelValue = new FutureContractByConCodeModel { Account = tradeClient.GetDefaultAccount, ContractCode = "ES2609" }
};
FutureContractResponse? response = await quoteClient.ExecuteAsync(request);

Response type

FutureContractItem? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "contractCode": "ES2612",
    "type": "ES",
    "name": "E-mini S&P 500",
    "exchangeCode": "CME",
    "multiplier": 50.0,
    "contractMonth": "202612",
    "lastTradingDate": "2026-12-18",
    "firstNoticeDate": null,
    "currency": "USD"
  }
}

Related APIs

See Requests, responses, and operations.

Get Contracts by Exchange

Operation

QuoteApiService.FUTURE_CONTRACT_BY_EXCHANGE_CODE = future_contract_by_exchange_code. Uses server method future_contract_by_exchange_code.

Request

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByExchCodeModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ExchangeCodestringexchange_codenullRequired

Return

FutureContractsResponse inherits TigerResponse; its data property is list of FutureContractItem. Key SDK fields: Type: string, Name: string, IbCode: string, ContractCode: string, ContractMonth: string, ExchangeCode: string, Exchange: string, Multiplier: decimal.

Example

TigerRequest<FutureContractsResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTRACT_BY_EXCHANGE_CODE,
    ModelValue = new FutureContractByExchCodeModel { Account = tradeClient.GetDefaultAccount, ExchangeCode = "CME" }
};
FutureContractsResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureContractItem>? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"contractCode": "ES2612", "type": "ES", "name": "E-mini S&P 500", "exchangeCode": "CME", "multiplier": 50.0, "contractMonth": "202612"},
    {"contractCode": "NQ2612", "type": "NQ", "name": "E-mini Nasdaq 100", "exchangeCode": "CME", "multiplier": 20.0, "contractMonth": "202612"}
  ]
}

Related APIs

See Requests, responses, and operations.

Get Continuous Contracts

Operation

QuoteApiService.FUTURE_CONTINUOUS_CONTRACTS = future_continuous_contracts. Uses server method future_continuous_contracts.

Request

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByTypeModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
FutureTypestringtypenullOptional

Return

FutureContractsResponse inherits TigerResponse; its data property is list of FutureContractItem. Key SDK fields: Type: string, Name: string, IbCode: string, ContractCode: string, ContractMonth: string, ExchangeCode: string, Exchange: string, Multiplier: decimal.

Example

TigerRequest<FutureContractsResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTINUOUS_CONTRACTS,
    ModelValue = new FutureContractByTypeModel { Account = tradeClient.GetDefaultAccount }
};
FutureContractsResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureContractItem>? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"contractCode": "ESmain", "type": "ES", "name": "E-mini S&P 500 (Main)", "exchangeCode": "CME", "multiplier": 50.0}
  ]
}

Related APIs

See Requests, responses, and operations.

Get Current Contract

Operation

QuoteApiService.FUTURE_CURRENT_CONTRACT = future_current_contract. Uses server method future_current_contract.

Request

TigerRequest<FutureContractResponse>

ModelValue: FutureContractByTypeModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
FutureTypestringtypenullOptional

Return

FutureContractResponse inherits TigerResponse; its data property is FutureContractItem. Key SDK fields: Type: string, Name: string, IbCode: string, ContractCode: string, ContractMonth: string, ExchangeCode: string, Exchange: string, Multiplier: decimal.

Example

TigerRequest<FutureContractResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CURRENT_CONTRACT,
    ModelValue = new FutureContractByTypeModel { Account = tradeClient.GetDefaultAccount }
};
FutureContractResponse? response = await quoteClient.ExecuteAsync(request);

Response type

FutureContractItem? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": {
    "contractCode": "ES2609",
    "type": "ES",
    "name": "E-mini S&P 500",
    "exchangeCode": "CME",
    "multiplier": 50.0,
    "contractMonth": "202609"
  }
}

Related APIs

See Requests, responses, and operations.

Get Contract List

Operation

QuoteApiService.FUTURE_CONTRACTS = future_contracts. Uses server method future_contracts.

Request

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByTypeModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
FutureTypestringtypenullOptional

Return

FutureContractsResponse inherits TigerResponse; its data property is list of FutureContractItem. Key SDK fields: Type: string, Name: string, IbCode: string, ContractCode: string, ContractMonth: string, ExchangeCode: string, Exchange: string, Multiplier: decimal.

Example

TigerRequest<FutureContractsResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTRACTS,
    ModelValue = new FutureContractByTypeModel { Account = tradeClient.GetDefaultAccount }
};
FutureContractsResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureContractItem>? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {"contractCode": "ES2609", "type": "ES", "name": "E-mini S&P 500", "exchangeCode": "CME", "multiplier": 50.0, "contractMonth": "202609"},
    {"contractCode": "ES2612", "type": "ES", "name": "E-mini S&P 500", "exchangeCode": "CME", "multiplier": 50.0, "contractMonth": "202612"}
  ]
}

Related APIs

See Requests, responses, and operations.

Get Futures K-Line

Operation

QuoteApiService.FUTURE_KLINE = future_kline. Uses server method future_kline.

Request

TigerRequest<FutureKlineResponse>

ModelValue: FutureKlineModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodeslist of stringcontract_codesnullRequiredNon-empty list
PeriodstringperiodFutureKType.min1.ValueOptional
BeginTimeInt64begin_timeNone (omitted if not set)OptionalTimestamp or date format; maintain chronological order
EndTimeInt64end_timeNone (omitted if not set)OptionalTimestamp or date format; maintain chronological order
LimitInt32limit300OptionalPositive integer
PageTokenstringpage_tokennullOptional

Return

FutureKlineResponse inherits TigerResponse; its data property is list of FutureKlineBatchItem. Key SDK fields: Items: list of FutureKlineItem.

Example

TigerRequest<FutureKlineResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_KLINE,
    ModelValue = new FutureKlineModel { Account = tradeClient.GetDefaultAccount, ContractCodes = new List<string> { "ES2609" }, Period = "day", BeginTime = 1780272000000L, EndTime = 1782864000000L }
};
FutureKlineResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureKlineBatchItem>? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "contractCode": "ES2612",
      "period": "day",
      "items": [
        {"time": 1785355200000, "open": 7600.0, "high": 7640.0, "low": 7580.0, "close": 7625.0, "volume": 125000},
        {"time": 1785441600000, "open": 7625.0, "high": 7650.0, "low": 7610.0, "close": 7640.0, "volume": 98000}
      ]
    }
  ]
}

Related APIs

See Requests, responses, and operations.

Get Futures Quotes

Operation

QuoteApiService.FUTURE_REAL_TIME_QUOTE = future_real_time_quote. Uses server method future_real_time_quote.

Request

TigerRequest<FutureRealTimeQuoteResponse>

ModelValue: FutureContractCodesModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodeslist of stringcontract_codesnullRequiredNon-empty list

Return

FutureRealTimeQuoteResponse inherits TigerResponse; its data property is list of FutureRealTimeItem. Key SDK fields: ContractCode: string, LatestPrice: Decimal, LatestSize: Int64, LatestTime: Int64, BidPrice: Decimal, BidSize: Int64, AskPrice: Decimal, AskSize: Int64.

Example

TigerRequest<FutureRealTimeQuoteResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_REAL_TIME_QUOTE,
    ModelValue = new FutureContractCodesModel { Account = tradeClient.GetDefaultAccount, ContractCodes = new List<string> { "ES2609" } }
};
FutureRealTimeQuoteResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureRealTimeItem>? data = response?.Data; // null when response or data is absent

Related APIs

See Requests, responses, and operations.

Get Futures Ticks

Operation

QuoteApiService.FUTURE_TICK = future_tick. Uses server method future_tick.

Request

TigerRequest<FutureTickResponse>

ModelValue: FutureTickModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodestringcontract_codenullRequired
BeginIndexInt64begin_indexNone (omitted if not set)Optional
EndIndexInt64end_indexNone (omitted if not set)Optional
LimitInt32limit200OptionalPositive integer

Return

FutureTickResponse inherits TigerResponse; its data property is FutureTickBatchItem. Key SDK fields: Items: list of FutureTickItem.

Example

TigerRequest<FutureTickResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_TICK,
    ModelValue = new FutureTickModel { Account = tradeClient.GetDefaultAccount, ContractCode = "ES2609", Limit = 20 }
};
FutureTickResponse? response = await quoteClient.ExecuteAsync(request);

Response type

FutureTickBatchItem? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "contractCode": "ES2612",
      "items": [
        {"time": 1785527980000, "price": 7625.0, "volume": 12, "type": "+"},
        {"time": 1785527980100, "price": 7624.75, "volume": 5, "type": "-"}
      ]
    }
  ]
}

Related APIs

See Requests, responses, and operations.

Get Trading Hours

Operation

QuoteApiService.FUTURE_TRADING_DATE = future_trading_date. Uses server method future_trading_date.

Request

TigerRequest<FutureTradingDateResponse>

ModelValue: FutureTradingDateModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodestringcontract_codenullRequired
TradingDatelongtrading_dateNone (omitted if not set)Optional

Return

FutureTradingDateResponse inherits TigerResponse; its data property is FutureTradingDateItem. Key SDK fields: TimeSection: string.

Example

TigerRequest<FutureTradingDateResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_TRADING_DATE,
    ModelValue = new FutureTradingDateModel { Account = tradeClient.GetDefaultAccount, ContractCode = "ES2609" }
};
FutureTradingDateResponse? response = await quoteClient.ExecuteAsync(request);

Response type

FutureTradingDateItem? data = response?.Data; // null when response or data is absent

Related APIs

See Requests, responses, and operations.

Get Historical Main Contract

Operation

QuoteApiService.FUTURE_HISTORY_MAIN_CONTRACT = future_history_main_contract. Uses server method future_history_main_contract.

Request

TigerRequest<FutureHistoryMainContractResponse>

ModelValue: FutureHistoryMainContractModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodeslist of stringcontract_codesnullRequiredNon-empty list
BeginTimeInt64begin_timeNone (omitted if not set)OptionalTimestamp or date format; maintain chronological order
EndTimeInt64end_timeNone (omitted if not set)OptionalTimestamp or date format; maintain chronological order

Return

FutureHistoryMainContractResponse inherits TigerResponse; its data property is list of FutureHistoryMainContractItem. Key SDK fields: Items: list of FutureHistoryContractItem.

Example

TigerRequest<FutureHistoryMainContractResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_HISTORY_MAIN_CONTRACT,
    ModelValue = new FutureHistoryMainContractModel { Account = tradeClient.GetDefaultAccount, ContractCodes = new List<string> { "ES2609" }, BeginTime = 1780272000000L, EndTime = 1782864000000L }
};
FutureHistoryMainContractResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureHistoryMainContractItem>? data = response?.Data; // null when response or data is absent

Related APIs

See Requests, responses, and operations.

Get Futures Depth

Operation

QuoteApiService.FUTURE_DEPTH = future_depth. Uses server method future_depth.

Request

TigerRequest<FutureDepthResponse>

ModelValue: FutureDepthModel.

Parameters

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangNone (omitted if not set)no
Accountstring (nullable)accountnullNot applicableTradeClient uses DefaultAccount when empty
ContractCodeslist of stringcontract_codesnullRequiredNon-empty list

Return

FutureDepthResponse inherits TigerResponse; its data property is list of FutureDepthItem. Key SDK fields: ContractId: string, ContractCode: string, Ask: list of FutureDepthAskBidItem, Bid: list of FutureDepthAskBidItem.

Example

TigerRequest<FutureDepthResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_DEPTH,
    ModelValue = new FutureDepthModel { Account = tradeClient.GetDefaultAccount, ContractCodes = new List<string> { "ES2609" } }
};
FutureDepthResponse? response = await quoteClient.ExecuteAsync(request);

Response type

List<FutureDepthItem>? data = response?.Data; // null when response or data is absent

Response Example

{
  "code": 0,
  "message": "success",
  "timestamp": 1785528000000,
  "data": [
    {
      "contractCode": "ES2612",
      "asks": [
        {"price": 7623.50, "volume": 120},
        {"price": 7624.00, "volume": 85}
      ],
      "bids": [
        {"price": 7622.25, "volume": 95},
        {"price": 7622.00, "volume": 150}
      ]
    }
  ]
}

Related APIs

See Requests, responses, and operations.


Did this page help you?