期货

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

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

获取期货交易所

操作名

QuoteApiService.FUTURE_EXCHANGE = future_exchange。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureExchangeResponse>

ModelValue: FutureExchangeModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
SecTypestringsec_typenullOptional—

返回

响应数据类型:List<FutureExchangeItem>。

字段C# 类型说明
Codestring交易所代码
Namestring名称
ZoneIdstring时区标识

示例

TigerRequest<FutureExchangeResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_EXCHANGE,
    ModelValue = new FutureExchangeModel { 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"}
  ]
}

频率限制

基础额度:每分钟 10 次。

按代码获取期货合约

操作名

QuoteApiService.FUTURE_CONTRACT_BY_CONTRACT_CODE = future_contract_by_contract_code。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureContractResponse>

ModelValue: FutureContractByConCodeModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodestringcontract_codenullRequired—

返回

响应数据类型:FutureContractItem。

字段C# 类型说明
Typestring合约类型
Namestring名称
IbCodestringIB 代码
ContractCodestring合约代码
ContractMonthstring合约月
ExchangeCodestring交易所代码
Exchangestring交易所
LastTradingDatestring最后交易日
FirstNoticeDatestring首个通知日
Currencystring币种
Multiplierdecimal合约乘数
MinTickdecimal最小变动价位
LastBiddingCloseTimelong最后竞价结束时间戳
Continuousbool是否连续合约
Tradebool是否可交易

示例

TigerRequest<FutureContractResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTRACT_BY_CONTRACT_CODE,
    ModelValue = new FutureContractByConCodeModel { 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"
  }
}

频率限制

基础额度:每分钟 120 次。

按交易所获取期货合约

操作名

QuoteApiService.FUTURE_CONTRACT_BY_EXCHANGE_CODE = future_contract_by_exchange_code。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByExchCodeModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ExchangeCodestringexchange_codenullRequired—

返回

响应数据类型:List<FutureContractItem>。

字段C# 类型说明
Typestring合约类型
Namestring名称
IbCodestringIB 代码
ContractCodestring合约代码
ContractMonthstring合约月
ExchangeCodestring交易所代码
Exchangestring交易所
LastTradingDatestring最后交易日
FirstNoticeDatestring首个通知日
Currencystring币种
Multiplierdecimal合约乘数
MinTickdecimal最小变动价位
LastBiddingCloseTimelong最后竞价结束时间戳
Continuousbool是否连续合约
Tradebool是否可交易

示例

TigerRequest<FutureContractsResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTRACT_BY_EXCHANGE_CODE,
    ModelValue = new FutureContractByExchCodeModel { 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"}
  ]
}

频率限制

基础额度:每分钟 120 次。

获取连续合约

操作名

QuoteApiService.FUTURE_CONTINUOUS_CONTRACTS = future_continuous_contracts。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByTypeModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
FutureTypestringtypenullOptional—

返回

响应数据类型:List<FutureContractItem>。

字段C# 类型说明
Typestring合约类型
Namestring名称
IbCodestringIB 代码
ContractCodestring合约代码
ContractMonthstring合约月
ExchangeCodestring交易所代码
Exchangestring交易所
LastTradingDatestring最后交易日
FirstNoticeDatestring首个通知日
Currencystring币种
Multiplierdecimal合约乘数
MinTickdecimal最小变动价位
LastBiddingCloseTimelong最后竞价结束时间戳
Continuousbool是否连续合约
Tradebool是否可交易

示例

TigerRequest<FutureContractsResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTINUOUS_CONTRACTS,
    ModelValue = new FutureContractByTypeModel()
};
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}
  ]
}

频率限制

基础额度:每分钟 120 次。

获取当前合约

操作名

QuoteApiService.FUTURE_CURRENT_CONTRACT = future_current_contract。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureContractResponse>

ModelValue: FutureContractByTypeModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
FutureTypestringtypenullOptional—

返回

响应数据类型:FutureContractItem。

字段C# 类型说明
Typestring合约类型
Namestring名称
IbCodestringIB 代码
ContractCodestring合约代码
ContractMonthstring合约月
ExchangeCodestring交易所代码
Exchangestring交易所
LastTradingDatestring最后交易日
FirstNoticeDatestring首个通知日
Currencystring币种
Multiplierdecimal合约乘数
MinTickdecimal最小变动价位
LastBiddingCloseTimelong最后竞价结束时间戳
Continuousbool是否连续合约
Tradebool是否可交易

示例

TigerRequest<FutureContractResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CURRENT_CONTRACT,
    ModelValue = new FutureContractByTypeModel()
};
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"
  }
}

频率限制

基础额度:每分钟 120 次。

获取期货合约列表

操作名

QuoteApiService.FUTURE_CONTRACTS = future_contracts。该常量用于设置 TigerRequest.ApiMethodName。

服务端已注册此操作。

请求

TigerRequest<FutureContractsResponse>

ModelValue: FutureContractByTypeModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
FutureTypestringtypenullOptional—

返回

响应数据类型:List<FutureContractItem>。

字段C# 类型说明
Typestring合约类型
Namestring名称
IbCodestringIB 代码
ContractCodestring合约代码
ContractMonthstring合约月
ExchangeCodestring交易所代码
Exchangestring交易所
LastTradingDatestring最后交易日
FirstNoticeDatestring首个通知日
Currencystring币种
Multiplierdecimal合约乘数
MinTickdecimal最小变动价位
LastBiddingCloseTimelong最后竞价结束时间戳
Continuousbool是否连续合约
Tradebool是否可交易

示例

TigerRequest<FutureContractsResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_CONTRACTS,
    ModelValue = new FutureContractByTypeModel()
};
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。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureKlineResponse>

ModelValue: FutureKlineModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodes列表,元素为 stringcontract_codesnullRequiredNon-empty list
PeriodstringperiodFutureKType.min1.ValueOptional—
BeginTimeInt64begin_timeCLR 默认值;序列化时省略OptionalTimestamp or date format; maintain chronological order
EndTimeInt64end_timeCLR 默认值;序列化时省略OptionalTimestamp or date format; maintain chronological order
LimitInt32limit300OptionalPositive integer
PageTokenstringpage_tokennullOptional—

返回

响应数据结构:List<FutureKlineBatchItem>。

字段C# 类型说明
ContractCodestring合约代码
NextPageTokenstring下一页标记
ItemsList<FutureKlineItem>K 线数据点列表

Items 项:FutureKlineItem

字段C# 类型说明
Timelong时间戳
LastTimelong最新时间
Volumelong成交量
OpenInterestlong持仓量
Opendecimal开盘价
Closedecimal收盘价
Highdecimal最高价
Lowdecimal最低价
Settlementdecimal结算价

示例

TigerRequest<FutureKlineResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_KLINE,
    ModelValue = new FutureKlineModel { 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}
      ]
    }
  ]
}

频率限制

基础额度:每分钟 60 次。

获取期货实时行情

操作名

QuoteApiService.FUTURE_REAL_TIME_QUOTE = future_real_time_quote。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureRealTimeQuoteResponse>

ModelValue: FutureContractCodesModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodes列表,元素为 stringcontract_codesnullRequiredNon-empty list

返回

响应数据类型:List<FutureRealTimeItem>。

字段C# 类型说明
ContractCodestring合约代码
LatestSizelong最新成交量
LatestTimelong最新成交时间
BidSizelong买盘量
AskSizelong卖盘量
OpenInterestlong持仓量
Volumelong成交量
LatestPricedecimal最新价
BidPricedecimal买价
AskPricedecimal卖价
Opendecimal开盘价
Highdecimal最高价
Lowdecimal最低价
Settlementdecimal结算价
LimitUpdecimal涨停价
LimitDowndecimal跌停价

示例

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

响应类型

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

频率限制

基础额度:每分钟 120 次。


获取期货逐笔成交

操作名

QuoteApiService.FUTURE_TICK = future_tick。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureTickResponse>

ModelValue: FutureTickModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodestringcontract_codenullRequired—
BeginIndexInt64begin_indexCLR 默认值;序列化时省略Optional—
EndIndexInt64end_indexCLR 默认值;序列化时省略Optional—
LimitInt32limit200OptionalPositive integer

返回

响应数据结构:FutureTickBatchItem。

字段C# 类型说明
ContractCodestring合约代码
ItemsList<FutureTickItem>逐笔成交列表

Items 项:FutureTickItem

字段C# 类型说明
Indexlong成交序号
Volumelong成交量
Timelong成交时间戳
Pricedecimal成交价

示例

TigerRequest<FutureTickResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_TICK,
    ModelValue = new FutureTickModel { 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": "-"}
      ]
    }
  ]
}

频率限制

基础额度:每分钟 120 次。

获取期货交易时间

操作名

QuoteApiService.FUTURE_TRADING_DATE = future_trading_date。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureTradingDateResponse>

ModelValue: FutureTradingDateModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodestringcontract_codenullRequired—
TradingDatelongtrading_dateCLR 默认值;序列化时省略Optional—

返回

响应数据类型:FutureTradingDateItem。

字段C# 类型说明
TimeSectionstring交易时段

示例

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

响应类型

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

频率限制

基础额度:每分钟 60 次。

获取历史主力合约

操作名

QuoteApiService.FUTURE_HISTORY_MAIN_CONTRACT = future_history_main_contract。该常量用于设置 TigerRequest.ApiMethodName。

请求

TigerRequest<FutureHistoryMainContractResponse>

ModelValue: FutureHistoryMainContractModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodes列表,元素为 stringcontract_codesnullRequiredNon-empty list
BeginTimeInt64begin_timeCLR 默认值;序列化时省略OptionalTimestamp or date format; maintain chronological order
EndTimeInt64end_timeCLR 默认值;序列化时省略OptionalTimestamp or date format; maintain chronological order

返回

响应数据结构:List<FutureHistoryMainContractItem>。

字段C# 类型说明
ContractCodestring主连合约代码
ItemsList<FutureHistoryContractItem>历史对应合约列表

Items 项:FutureHistoryContractItem

字段C# 类型说明
Timelong生效时间戳
ReferContractCodestring对应合约代码

示例

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

响应类型

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

频率限制

基础额度:每分钟 60 次。


获取期货深度行情

操作名

QuoteApiService.FUTURE_DEPTH = future_depth。该常量用于设置 TigerRequest.ApiMethodName。

服务端已注册此操作。

请求

TigerRequest<FutureDepthResponse>

ModelValue: FutureDepthModel.

参数

SDK propertyC# typeAPI fieldSDK defaultRequiredConstraints
LangLanguagelangCLR 默认值;序列化时省略no—
Accountstring (nullable)accountnullNot applicableAccount 是继承字段;QuoteClient 不会从 TigerConfig.DefaultAccount 注入,null 时序列化省略
ContractCodes列表,元素为 stringcontract_codesnullRequiredNon-empty list

返回

响应数据结构:List<FutureDepthItem>。

字段C# 类型说明
ContractIdstring合约标识
ContractCodestring合约代码
AskList<FutureDepthAskBidItem>卖盘深度列表
BidList<FutureDepthAskBidItem>买盘深度列表

Ask / Bid 项:FutureDepthAskBidItem

字段C# 类型说明
Pricedecimal委托价
Volumelong对应价位数量

示例

TigerRequest<FutureDepthResponse> request = new()
{
    ApiMethodName = QuoteApiService.FUTURE_DEPTH,
    ModelValue = new FutureDepthModel { 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}
      ]
    }
  ]
}

Did this page help you?