期货

以下操作均通过 QuoteClient.ExecuteAsync 调用。

STOCK_DETAIL 与 QUOTE_OVERNIGHT 需额外行情权限，未开通时服务端返回权限错误码。

获取期货交易所

操作名

QuoteApiService.FUTURE_EXCHANGE = future_exchange. 使用服务端方法 future_exchange。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureExchangeResponse>

ModelValue: FutureExchangeModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`SecType`	string	`sec_type`	null	Optional	—

FutureExchangeResponse inherits TigerResponse; its data property is 列表，元素为 FutureExchangeItem. Key SDK fields: Code: string, Name: string, ZoneId: string.

示例

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

响应类型

List<FutureExchangeItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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"}
  ]
}

按代码获取期货合约

操作名

QuoteApiService.FUTURE_CONTRACT_BY_CONTRACT_CODE = future_contract_by_contract_code. 使用服务端方法 future_contract_by_contract_code。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureContractResponse>

ModelValue: FutureContractByConCodeModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCode`	string	`contract_code`	null	Required	—

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.

示例

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);

响应类型

FutureContractItem? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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"
  }
}

按交易所获取期货合约

操作名

QuoteApiService.FUTURE_CONTRACT_BY_EXCHANGE_CODE = future_contract_by_exchange_code. 使用服务端方法 future_contract_by_exchange_code。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByExchCodeModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ExchangeCode`	string	`exchange_code`	null	Required	—

FutureContractsResponse 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.

示例

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);

响应类型

List<FutureContractItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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"}
  ]
}

获取连续合约

操作名

QuoteApiService.FUTURE_CONTINUOUS_CONTRACTS = future_continuous_contracts. 使用服务端方法 future_continuous_contracts。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByTypeModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`FutureType`	string	`type`	null	Optional	—

示例

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

响应类型

List<FutureContractItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

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

获取当前合约

操作名

QuoteApiService.FUTURE_CURRENT_CONTRACT = future_current_contract. 使用服务端方法 future_current_contract。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureContractResponse>

ModelValue: FutureContractByTypeModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`FutureType`	string	`type`	null	Optional	—

示例

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

响应类型

FutureContractItem? data = response?.Data; // response 或 data 缺失时为 null

返回示例

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

获取期货合约列表

操作名

QuoteApiService.FUTURE_CONTRACTS = future_contracts. 使用服务端方法 future_contracts。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByTypeModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`FutureType`	string	`type`	null	Optional	—

示例

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

响应类型

List<FutureContractItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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"}
  ]
}

获取期货 K 线

操作名

QuoteApiService.FUTURE_KLINE = future_kline. 使用服务端方法 future_kline。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureKlineResponse>

ModelValue: FutureKlineModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCodes`	列表，元素为 string	`contract_codes`	null	Required	Non-empty list
`Period`	string	`period`	FutureKType.min1.Value	Optional	—
`BeginTime`	Int64	`begin_time`	None (omitted if not set)	Optional	Timestamp or date format; maintain chronological order
`EndTime`	Int64	`end_time`	None (omitted if not set)	Optional	Timestamp or date format; maintain chronological order
`Limit`	Int32	`limit`	300	Optional	Positive integer
`PageToken`	string	`page_token`	null	Optional	—

FutureKlineResponse inherits TigerResponse; its data property is 列表，元素为 FutureKlineBatchItem. Key SDK fields: Items: list of FutureKlineItem.

示例

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);

响应类型

List<FutureKlineBatchItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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}
      ]
    }
  ]
}

获取期货实时行情

操作名

QuoteApiService.FUTURE_REAL_TIME_QUOTE = future_real_time_quote. 使用服务端方法 future_real_time_quote。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureRealTimeQuoteResponse>

ModelValue: FutureContractCodesModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCodes`	列表，元素为 string	`contract_codes`	null	Required	Non-empty list

FutureRealTimeQuoteResponse inherits TigerResponse; its data property is 列表，元素为 FutureRealTimeItem. Key SDK fields: ContractCode: string, LatestPrice: Decimal, LatestSize: Int64, LatestTime: Int64, BidPrice: Decimal, BidSize: Int64, AskPrice: Decimal, AskSize: Int64.

示例

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);

响应类型

List<FutureRealTimeItem>? data = response?.Data; // response 或 data 缺失时为 null

获取期货逐笔

操作名

QuoteApiService.FUTURE_TICK = future_tick. 使用服务端方法 future_tick。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureTickResponse>

ModelValue: FutureTickModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCode`	string	`contract_code`	null	Required	—
`BeginIndex`	Int64	`begin_index`	None (omitted if not set)	Optional	—
`EndIndex`	Int64	`end_index`	None (omitted if not set)	Optional	—
`Limit`	Int32	`limit`	200	Optional	Positive integer

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

示例

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

响应类型

FutureTickBatchItem? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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": "-"}
      ]
    }
  ]
}

获取期货交易时间

操作名

QuoteApiService.FUTURE_TRADING_DATE = future_trading_date. 使用服务端方法 future_trading_date。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureTradingDateResponse>

ModelValue: FutureTradingDateModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCode`	string	`contract_code`	null	Required	—
`TradingDate`	long	`trading_date`	None (omitted if not set)	Optional	—

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

示例

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

响应类型

FutureTradingDateItem? data = response?.Data; // response 或 data 缺失时为 null

获取历史主力合约

操作名

QuoteApiService.FUTURE_HISTORY_MAIN_CONTRACT = future_history_main_contract. 使用服务端方法 future_history_main_contract。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureHistoryMainContractResponse>

ModelValue: FutureHistoryMainContractModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCodes`	列表，元素为 string	`contract_codes`	null	Required	Non-empty list
`BeginTime`	Int64	`begin_time`	None (omitted if not set)	Optional	Timestamp or date format; maintain chronological order
`EndTime`	Int64	`end_time`	None (omitted if not set)	Optional	Timestamp or date format; maintain chronological order

FutureHistoryMainContractResponse inherits TigerResponse; its data property is 列表，元素为 FutureHistoryMainContractItem. Key SDK fields: Items: list of FutureHistoryContractItem.

示例

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);

响应类型

List<FutureHistoryMainContractItem>? data = response?.Data; // response 或 data 缺失时为 null

获取期货深度

操作名

QuoteApiService.FUTURE_DEPTH = future_depth. 使用服务端方法 future_depth。这是 *ApiService 常量，不是客户端成员方法。

请求

TigerRequest<FutureDepthResponse>

ModelValue: FutureDepthModel.

参数

SDK property	C# type	API field	SDK default	Required	Constraints
`Lang`	Language	`lang`	None (omitted if not set)	no	—
`Account`	string (nullable)	`account`	null	Not applicable	TradeClient uses DefaultAccount when empty
`ContractCodes`	列表，元素为 string	`contract_codes`	null	Required	Non-empty list

FutureDepthResponse inherits TigerResponse; its data property is 列表，元素为 FutureDepthItem. Key SDK fields: ContractId: string, ContractCode: string, Ask: list of FutureDepthAskBidItem, Bid: list of FutureDepthAskBidItem.

示例

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);

响应类型

List<FutureDepthItem>? data = response?.Data; // response 或 data 缺失时为 null

返回示例

{
  "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}
      ]
    }
  ]
}