语法手册

exchange.SetContractType


```exchange.SetContractType()```函数返回一个结构体，包含当前合约代码对应的交易所合约标识符。例如，在币安期货交易所，当设置合约代码为```quarter```时，该函数返回的结构体为：```{"InstrumentID":"BTCUSD_230630","instrument":"BTCUSD_230630"}```。
object

exchange.SetContractType(symbol)

```symbol```参数用于设置合约代码，可选值包括：```"this_week"```、```"next_week"```、```"quarter"```、```"next_quarter"```、```"swap"```等。

加密货币期货合约中的**交割合约**代码（如无特殊说明）通常包括：

- ```this_week```：当周合约。

- ```next_week```：次周合约。

- ```quarter```：季度合约。

- ```next_quarter```：次季度合约。


加密货币期货合约中的**永续合约**代码（如无特殊说明）通常包括：

- ```swap```：永续合约。
symbol
true
string

```javascript
function main() {
    // 设置为当周合约
    exchange.SetContractType("this_week")
}```
```python
def main():
    exchange.SetContractType("this_week")```
```cpp
void main() {
    exchange.SetContractType("this_week");
}```
设置当前合约为当周合约：
```javascript
function main() {
    // 默认交易对为BTC_USD，设置合约为当周，合约为币本位合约
    exchange.SetContractType("this_week")
    Log("ticker:", exchange.GetTicker())

    // 切换交易对，然后设置合约，切换成USDT作为保证金的合约，区别于币本位合约
    exchange.IO("currency", "BTC_USDT")
    exchange.SetContractType("swap")
    Log("ticker:", exchange.GetTicker())
}```
```python
def main():
    exchange.SetContractType("this_week")
    Log("ticker:", exchange.GetTicker())
    exchange.IO("currency", "BTC_USDT")
    exchange.SetContractType("swap")
    Log("ticker:", exchange.GetTicker())```
```cpp
void main() {
    exchange.SetContractType("this_week");
    Log("ticker:", exchange.GetTicker());
    exchange.IO("currency", "BTC_USDT");
    exchange.SetContractType("swap");
    Log("ticker:", exchange.GetTicker());
}```
设置以```USDT```作为保证金的合约时，需要在代码中切换交易对（也可以在添加交易所对象时直接设置交易对）：
```javascript
function main(){
    // 设置合约为当周
    var ret = exchange.SetContractType("this_week")
    // 返回当周合约的信息
    Log(ret)
}```
```python
def main():
    ret = exchange.SetContractType("this_week")
    Log(ret)```
```cpp
void main() {
    auto ret = exchange.SetContractType("this_week");
    Log(ret);
}```
打印```exchange.SetContractType()```函数的返回值：

在加密货币期货合约策略中，以切换至```BTC_USDT```交易对为例：

当使用```exchange.SetCurrency("BTC_USDT")```或```exchange.IO("currency", "BTC_USDT")```函数切换交易对时，切换后需要使用```exchange.SetContractType()```函数重新设置合约，以便在新交易对下确定当前需要操作的合约。系统根据交易对来判断是**币本位合约**还是**USDT本位合约**。


例如：当交易对设置为```BTC_USDT```时，使用```exchange.SetContractType("swap")```函数设置合约代码为```swap```，此时设置的是```BTC```的**USDT本位**永续合约。如果交易对为```BTC_USD```，使用```exchange.SetContractType("swap")```函数设置合约代码为```swap```，此时设置的是```BTC```的**币本位**永续合约。
详细介绍支持的加密货币期货合约交易所，每个交易所的合约命名规则如下：
- Futures_OKCoin（OKX）
  设置为永续合约：```exchange.SetContractType("swap")```
  设置为当周合约：```exchange.SetContractType("this_week")```
  设置为次周合约：```exchange.SetContractType("next_week")```
  设置为月度合约：```exchange.SetContractType("month")```
  设置为次月合约：```exchange.SetContractType("next_month")```
  设置为季度合约：```exchange.SetContractType("quarter")```
  设置为次季合约：```exchange.SetContractType("next_quarter")```

  OKX支持盘前交易合约：合约交割日期为固定时间，交易所定义的合约代码示例为：```HMSTR-USDT-250207```，在发明者量化平台设置交易对为```HMSTR_USDT```，然后使用```exchange.SetContractType("HMSTR-USDT-250207")```设置该合约。
  对于支持```symbol```参数的函数，例如：```exchange.GetTicker()```、```exchange.CreateOrder()```等，可以指定```symbol```参数为：```HMSTR_USDT.HMSTR-USDT-250207```来获取该合约的行情数据或进行下单等操作。
- Futures_HuobiDM（火币期货）
  设置为当周合约：```exchange.SetContractType("this_week")```。
  设置为次周合约：```exchange.SetContractType("next_week")```。
  设置为季度合约：```exchange.SetContractType("quarter")```。
  设置为次季合约：```exchange.SetContractType("next_quarter")```。
  设置为永续合约：```exchange.SetContractType("swap")```。
  支持```USDT```作为保证金的合约，以```BTC```合约为例：使用```exchange.IO("currency", "BTC_USDT")```即可切换为使用```USDT```作为保证金的合约，
  或者在配置实盘参数、添加交易所对象时直接设置当前交易对为```BTC_USDT```。切换交易对后需要重新调用```exchange.SetContractType()```函数设置合约。
- Futures_BitMEX（BitMEX）
  设置为永续合约：```exchange.SetContractType("swap")```。
  Futures_BitMEX交易所交割合约为月度合约，合约代码如下（一月至十二月）：
  ```code
  "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"

设置交割合约：exchange.SetContractType("December")。例如交易对设置为XBT_USDT时，调用exchange.SetContractType("December")函数设置BTC的USDT本位十二月交割合约（对应的实际合约代码为XBTUSDTZ23）。

USDT作为保证金的合约：例如交易对设置为BTC_USDT，再设置合约代码，即为USDT作为保证金的合约。设置为永续合约：exchange.SetContractType("swap")。 - Futures_Binance 币安期货交易所默认为当前交易对的永续合约，合约代码：swap。设置为永续合约：exchange.SetContractType("swap")，币安的永续合约包括使用USDT作为保证金的合约，例如BTC的USDT本位永续合约，交易对设置为BTC_USDT。币安也支持使用币作为保证金的永续合约，例如BTC的币本位永续合约，交易对设置为BTC_USD。设置为季度合约：exchange.SetContractType("quarter")，交割合约包括币本位合约（即使用币作为保证金），例如BTC的季度合约，交易对设置为：BTC_USD，再设置合约exchange.SetContractType("quarter")，即设置为BTC的币本位季度合约。设置为次季合约：exchange.SetContractType("next_quarter")，例如BTC的币本位次季度合约，交易对设置为：BTC_USD，再设置合约exchange.SetContractType("next_quarter")。币安支持部分USDT作为保证金的交割合约，以BTC为例，交易对设置为BTC_USDT，再设置合约代码即可。

支持币安期权合约：期权合约代码格式以交易所定义的期权合约代码为准：BTC-241227-15000-C、XRP-240112-0.5-C、BTC-241227-15000-P。以币安期权合约代码BTC-241227-15000-P为例：BTC为期权币种代码，241227为行权日期，15000为行权价格，P表示看跌期权，C表示看涨期权。期权类型具体是欧式期权还是美式期权，请查阅交易所期权合约相关资料。交易所可能会限制期权卖方，需要单独申请资格。币安期权需要申请卖方资格。 - Futures_Bibox Bibox永续合约的合约代码：swap。设置为永续合约：exchange.SetContractType("swap")。 - Futures_Bybit 默认为当前交易对的永续合约，合约代码：swap。当周合约代码：this_week。次周合约代码：next_week。第三周合约代码：third_week。月度合约代码：month。次月合约代码：next_month。季度合约代码：quarter。次季度合约代码：next_quarter。第三季度合约代码：third_quarter。直接使用交易所合约命名：例如ETHUSDT-04APR25，因为bybit交易所有一些合约品种并无明确的周期性，所以直接使用交易所定义的合约代码命名。 - Futures_Kraken 默认为当前交易对的永续合约，合约代码：swap。

  ```month```：当月合约。
  ```quarter```：季度合约。
  ```next_quarter```：次季合约。
  ```third_quarter```：第三季度合约。
  ```swap_pf```：混合保证金永续合约。
  ```quarter_ff```：混合保证金季度合约。
  ```month_ff```：混合保证金当月合约。
  ```next_quarter_ff```：混合保证金次季度合约。
  ```third_quarter_ff```：混合保证金第三季度合约。
  直接使用交易所合约命名：例如```FF_ETHUSD_250307```，因为Kraken交易所有一些合约品种并无明确的周期性，所以直接使用交易所定义的合约代码命名。
- Futures_Bitfinex
  默认为当前交易对的永续合约，合约代码：```swap```。
- Futures_Bitget
  默认为当前交易对的永续合约，合约代码：```swap```。
  交易对设置为```BTC_USD```为币本位合约，交易对设置为```BTC_USDT```为```USDT```结算的合约。模拟合约可以设置交易对为：```SBTC_USD```、```BTC_SUSDT```。
- Futures_dYdX (v4)
  dYdX永续合约的合约代码：```swap```。
  设置为永续合约：```exchange.SetContractType("swap")```，dYdX仅有```USD.swap```品种维度，使用的保证金为USDC。
- Futures_MEXC
  MEXC（抹茶）永续合约的合约代码：```swap```。
  设置为永续合约：```exchange.SetContractType("swap")```。交易对设置为```BTC_USD```为币本位合约，交易对设置为```BTC_USDT```为```USDT```结算的合约。
- Futures_Crypto
  crypto.com交易所的账户中的代币可以折算为USD计价的额度，用于合约交易的保证金。
  设置为永续合约：```exchange.SetContractType("swap")```。例如交易对设置为```BTC_USD```时，调用```exchange.SetContractType("swap")```函数设置BTC的永续合约。
  crypto.com交易所交割合约为月度合约，合约代码如下（一月至十二月）：
  ```code
  "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"

设置交割合约：exchange.SetContractType("October")。例如交易对设置为BTC_USD时，调用exchange.SetContractType("October")函数设置BTC的十月交割合约。当前时刻对应的合约代码为：BTCUSD-231027。 - Futures_WOO Futures_WOO交易所支持USDT本位合约，永续合约代码为swap。例如交易对设置为BTC_USDT时，调用exchange.SetContractType("swap")函数设置当前合约为BTC的USDT本位永续合约。 - Futures_Hyperliquid Futures_Hyperliquid交易所支持USDC本位合约，永续合约代码为swap。例如交易对设置为ETH_USD，调用exchange.SetContractType("swap")函数设置当前合约为ETH的USDC本位永续合约。 Futures_Hyperliquid仅有USD.swap品种维度，使用的保证金为USDC。 - Futures_Backpack Futures_Backpack交易所支持USDC本位合约，永续合约代码为swap。例如交易对设置为ETH_USDC，调用exchange.SetContractType("swap")函数设置当前合约为ETH的USDC本位永续合约。 - Futures_edgeX Futures_edgeX交易所支持USDT本位合约，永续合约代码为swap。例如交易对设置为BTC_USDT，调用exchange.SetContractType("swap")函数设置当前合约为BTC的USDT本位永续合约。 - Futures_WOOFI Futures_WOOFI交易所支持USDC本位合约，永续合约代码为swap。例如交易对设置为ETH_USDC，调用exchange.SetContractType("swap")函数设置当前合约为ETH的USDC本位永续合约。 - Futures_Coinw Futures_Coinw交易所支持USDT本位合约，永续合约代码为swap。例如交易对设置为ETH_USDT，调用exchange.SetContractType("swap")函数设置当前合约为ETH的USDT本位永续合约。 - Futures_Aster Futures_Aster交易所支持USDT本位合约，永续合约代码为swap。例如交易对设置为ETH_USDT，调用exchange.SetContractType("swap")函数设置当前合约为ETH的USDT本位永续合约。 - Futures_DeepCoin 币本位合约，例如交易对设置为BTC_USD，再设置合约代码，即为币本位合约：设置为永续合约：exchange.SetContractType("swap")。

USDT作为保证金的合约：例如交易对设置为BTC_USDT，再设置合约代码，即为USDT作为保证金的合约。设置为永续合约：exchange.SetContractType("swap")。

{@fun/Futures/exchange.GetContractType exchange.GetContractType}, {@fun/Account/exchange.SetCurrency exchange.SetCurrency}

< exchange.SetDirection exchange.GetContractType >

Forums

PINE Language FAQ Summary MyLanguage Web3 About Us

Product

Robot Strategy Node Platforms Tickets

API

Syntax guide User guide Trading api Blockchain Indicator