2.6 Barang

Pembagian

• Komoditas berjangka

  Struktur sederhana dari strategi komoditas berjangka (berbeda dengan strategi mata uang digital yang dipelajari sebelumnya, memeriksa status koneksi ke server bursa pada awal setiap siklus) tentu saja lebih baik untuk menilai kembali apakah kontrak yang akan diperdagangkan berada dalam jangka waktu perdagangan.

function MainLoop(){ //  处理具体工作的函数
    // deal Main task
}
function main() {
    var status = null;
    while(true){
        status = exchange.IO("status");      //  调用API 确定连接状态
        if(status === true){                 //  判断状态
            LogStatus("已连接！");
            MainLoop();                      //  连接上 交易所服务器后，执行主要工作函数。
        }else{                               //  如果没有连接上 即 exchange.IO("status") 函数返回 false
            LogStatus("未连接状态！");         //  在状态栏显示 未连接状态。
        }
        Sleep(1000);                         //  需要有轮询间隔， 以免访问过于频繁。
    }
}

Kemudian kita akan menguji setiap API dengan arsitektur seperti ini.

• Mengakses informasi akun

Di sini diasumsikan bahwa pembaca telah memahami proses penambahan CTP Commodity Futures Simulator Account dan telah menambahkan CTP Commodity Futures Simulator Account. Yang tidak jelas dapat dipelajari Bagian 1.3.3 Bursa , CTP komoditas berjangka Analog Disc Konfigurasi

Kode sumber uji coba adalah sebagai berikut, menggunakan CTP Commodity Futures Simulator Disks.

var Account = null;
function MainLoop(){
    Account = _C(exchange.GetAccount);
}
function main() {
    var status = null;
    while(true){
        status = exchange.IO("status");
        if(status === true){
            LogStatus("已连接！", new Date(), '\n', "Account:", Account);
            MainLoop();            
        }else{
            LogStatus("未连接状态！", new Date());
        }
        Sleep(1000);
    }
}

Di sini, Anda dapat melihat beberapa gambar yang menarik.

• Mengatur Leverage, Mengatur Jenis Kontrak

Pengguna baru mungkin mengalami kesalahan seperti ini, ketika menulis strategi berjangka komoditas CTP, ketika belajar, langsung memanggil API untuk mendapatkan K-line, data pasar.exchange.IO("status"); yang dikembalikan dengan nilai ditemukan benar, telah terhubung. Alasan ini adalah: tidak ada informasi jenis berlangganan apa pun, maka hubungi API untuk mendapatkan K-line, transaksi (pengelola tidak tahu apa yang akan dikirimkan kepada Anda). Jadi mari kita lihat bagaimana untuk berlangganan informasi kontrak, yaitu mengatur jenis kontrak yang sedang beroperasi. Di bawah ini adalah deskripsi dari dokumen API:

SetContractType(ContractType)	设置合约类型
传统的CTP期货的ContractType就是指的合约ID,  如SetContractType("au1506") 返回合约的详细信息, 如最少一次买多少, 手续费, 交割时间等
股票合约格式为 股票代码.(SH/SZ), SH指上交所, SZ指深交所, 如000001.SZ就是指深交所的平安银行
商品期货与股票取消订阅合约, 在合约名前加上"-"前缀重新调用即可, 如SetContractType("-au1506"); 成功返回true
数字货币796支持: "week", "weekcny", 默认为子账户A, 要指定子账户是A还是B, 在合约后加"@A"或"@B", 如: "day@A" 为日合约A子账户
BitVC有week和quarter和next_week三个可选参数, OKCoin期货有this_week, next_week, quarter三个参数
exchange.SetContractType("week");

ContractType adalah kode kontrak, dan parameternya adalah string, jadi jangan lupa tanda kutip ganda.

Sebagai contoh, Methanol MA, kontrak yang diserahkan pada Januari 2017, kode adalah MA701. Di bawah ini kita akan menggunakan contoh MA701 untuk memanggil fungsi SetContractType untuk mendapatkan informasi kontrak dan mengatur kontrak yang sedang beroperasi.

Kode adalah sebagai berikut:

var Account = null;
var isFirstSetContractType = true;   // 标记是否第一次设置 合约。
function MainLoop(){
    Account = _C(exchange.GetAccount);
    if(isFirstSetContractType === true){    // 是第一次设置合约 ，执行以下设置。
        var ContractInfo = exchange.SetContractType("MA701");   // SetContractType 函数返回 设置的合约的详细信息。
        for(var k in ContractInfo){    // 遍历这个信息结构。
            Log(k, ContractInfo[k]);   // 逐行打印。
        }
        isFirstSetContractType = false;    // 设置过合约了。
    }
}
function main() {
    var status = null;
    while(true){
        status = exchange.IO("status");
        if(status === true){
            LogStatus("已连接！", new Date(), '\n', "Account:", Account);
            MainLoop();            
        }else{
            LogStatus("未连接状态！", new Date());
        }
        Sleep(1000);
    }
}

Anda dapat melihat detail kontrak MA701 yang dicetak.

Di bawah ini adalah beberapa sifat yang dapat Anda ambil dari artikel ini: Kontrak: Nama Instrumen, Satuan: VolumeMultiple, Jumlah pesanan maksimum: MaxLimitOrderVolume, tingkat jaminan: LongMarginRatio (multiposisi), ShortMarginRatio (kosong), Tanggal pengiriman: StartDelivDate.

Jika Anda menggunakan aplikasi ini, Anda mungkin mengalami masalah berikut:Saya ingin tahu apakah ada kontrak yang bisa saya atur?exchange.IO("instruments"); pertanyaan. Saya ingin tahu apakah semua program saat ini berlangganan kontrak-kontrak itu?exchange.IO("subscribed"); pertanyaan. Cobalah:

var Account = null;
var isFirstSetContractType = true;                              // 标记是否第一次设置 合约。
function MainLoop(){
    Account = _C(exchange.GetAccount);
    if(isFirstSetContractType === true){                        // 是第一次设置合约 ，执行以下设置。
        var ContractInfo = exchange.SetContractType("MA701");   // SetContractType 函数返回 设置的合约的详细信息。
        for(var k in ContractInfo){                             // 遍历这个信息结构。
            Log(k, ContractInfo[k]);                            // 逐行打印。
        }
        isFirstSetContractType = false;                         // 设置过合约了。
        var contracts = exchange.IO("instruments");             // 查询 可订阅的合约 
        var str = "";
        for(var i in contracts){
            str += (i + "--");
        }
        Log("已经订阅的合约：" ,exchange.IO("subscribed"));        // 查询已经订阅的合约
        Log("可订阅的合约：", str);                               // 显示可以订阅的合约信息 
    }
}
function main() {
    var status = null;
    while(true){
        status = exchange.IO("status");
        if(status === true){
            LogStatus("已连接！", new Date(), '\n', "Account:", Account);
            MainLoop();            
        }else{
            LogStatus("未连接状态！", new Date());
        }
        Sleep(1000);
    }
}

Hasil tes piringan:

Saat ini, CTP tidak mendukung pengaturan leverage komoditas berjangka.

• Mendapatkan data pasar

Dengan SetContractType, kontrak operasi saat ini dapat disiapkan untuk mendapatkan data K-line dan pasar dari kontrak tersebut. Perlu dicatat bahwa dengan fungsi SetContractType yang disetel sebagai kontrak, misalnya dengan mengatur SetContractType (MA705), berlangganan (MA705), dan mengatur kontrak saat ini menjadi MA705, yaitu kontrak methanol yang dikirimkan pada Mei 2017. Kemudian pada saat ini memanggil fungsi API seperti GetRecords, GetTicker, GetDepth.

var Account = null;   // 全局变量  用来保存每次获取的账户信息
var ticker = null;    //          用来保存每次获取的行情信息
var records = null;   //          用来保存每次获取的K线数据
var isFirstSetContractType = true;                              // 标记是否第一次设置 合约。
function MainLoop(){
        Account = _C(exchange.GetAccount);
        if(isFirstSetContractType === true){                        // 是第一次设置合约 ，执行以下设置。
            var ContractInfo = exchange.SetContractType("MA701");   // SetContractType 函数返回 设置的合约的详细信息。
            for(var k in ContractInfo){                             // 遍历这个信息结构。
                Log(k, ContractInfo[k]);                            // 逐行打印。
            }
            isFirstSetContractType = false;                         // 设置过合约了。
            var contracts = exchange.IO("instruments");             // 查询 可订阅的合约 
            var str = "";
            for(var i in contracts){
                str += (i + "--");
            }
        }
        ticker = exchange.GetTicker();      //    调用API  GetTicker 
        records = exchange.GetRecords();    //    调用API  GetRecords   默认周期
}
function main() {
        var status = null;
        while(true){
            status = exchange.IO("status");
            if(status === true){
                LogStatus("已连接！", new Date(), '\n', "Account:", Account, '\n', "ticker:", ticker , '\n', "records:", records);
                MainLoop();            
            }else{
                LogStatus("未连接状态！", new Date());
            }
            Sleep(1000);
        }
}

Hasilnya:

• Mendapatkan saham

Fungsi GetPosition API didokumentasikan:

GetPosition	获取当前持仓信息
返回一个Position数组, (BitVC和OKCoin)可以传入一个参数, 指定要获取的合约类型
Position 结构	期货交易中的持有仓位信息, 由GetPosition()函数返回此结构数组
{
        MarginLevel :杆杠大小, 796期货有可能为5, 10, 20三个参数, OKCoin为10或者20, 
                      BitVC期货和OK期货的全仓模式返回为固定的10, 因为原生API不支持。
        Amount       :持仓量, 796期货表示持币的数量, BitVC指持仓的总金额(100的倍数), OKCoin表示合约的份数(整数且大于1)
        CanCover     :可平量, 只有股票有此选项, 表示可以平仓的数量(股票为T+1)今日仓不能平
        FrozenAmount :冻结量, 支持传统期货与股票, 数字货币只支持796交易所
        Price        :持仓均价
        Profit       :持仓浮动盈亏(数据货币单位：BTC/LTC, 传统期货单位:RMB, 股票不支持此字段, 
                     注: OKCoin期货全仓情况下指实现盈余, 并非持仓盈亏, 逐仓下指持仓盈亏)
        Type	     :PD_LONG为多头仓位(CTP中用closebuy_today平仓), PD_SHORT为空头仓位(CTP用closesell_today)平仓, 
              (CTP期货中)PD_LONG_YD为咋日多头仓位(用closebuy平), PD_SHORT_YD为咋日空头仓位(用closesell平)
        ContractType :商品期货为合约代码, 股票为'交易所代码_股票代码', 具体参数SetContractType的传入类型
}

Kode tes:

var Account = null;   // 全局变量  用来保存每次获取的账户信息
var ticker = null;    //          用来保存每次获取的行情信息
var records = null;   //          用来保存每次获取的K线数据
var positions = null;  //          用来获取 账户的持仓信息。
var isFirstSetContractType = true;                              // 标记是否第一次设置 合约。
function MainLoop(){
        Account = _C(exchange.GetAccount);
        if(isFirstSetContractType === true){                        // 是第一次设置合约 ，执行以下设置。
            var ContractInfo = exchange.SetContractType("MA701");   // SetContractType 函数返回 设置的合约的详细信息。
            for(var k in ContractInfo){                             // 遍历这个信息结构。
                Log(k, ContractInfo[k]);                            // 逐行打印。
            }
            isFirstSetContractType = false;                         // 设置过合约了。
            var contracts = exchange.IO("instruments");             // 查询 可订阅的合约 
            var str = "";
            for(var i in contracts){
                str += (i + "--");
            }
            exchange.SetDirection("buy");     // 设置 操作
            exchange.Buy(_C(exchange.GetTicker).Sell + 2, 1);    // 开多仓。
        }
        positions = exchange.GetPosition();   //    获取所有持仓信息
}
function main() {
        var status = null;
        while(true){
            status = exchange.IO("status");
            if(status === true){
                LogStatus("已连接！", new Date(), '\n', "Account:", Account, '\n', "ticker:", ticker 
                    , '\n', "records:", records, '\n', "positions:", positions);
                MainLoop();            
            }else{
                LogStatus("未连接状态！", new Date());
            }
            Sleep(1000);
        }
}

Hasilnya:

Anda dapat melihat bahwa jika saya hanya menyimpan satu varietas, maka saya akan memanggil fungsi GetPosition. Apa yang saya dapatkan adalah suatu array yang hanya berisi satu elemen. Jika saya menyimpan beberapa varietas, apa yang saya dapatkan adalah array yang berisi beberapa elemen.

• Mengatur arah operasi, posisi terbuka, posisi rata (posisi sekarang, posisi sebelumnya)

Setelah jenis kontrak sudah diatur, sebelum operasi posisi terbuka, arah operasi harus diatur (tidak seperti posisi langsung), kita membutuhkan fungsi API lain: SetDirection

SetDirection(Direction)	设置Buy或者Sell下单类型
Direction可以取buy, closebuy, sell, closesell四个参数, 传统期货多出closebuy_today,与closesell_today, 指平今仓,
默认为closebuy/closesell为平昨仓
对于CTP传统期货, 可以设置第二个参数"1"或者"2"或者"3", 分别指"投机", "套利", "套保", 不设置默认为投机
股票只支持buy与closebuy, 因为股票只能买跟平仓
exchange.SetMarginLevel(5);
exchange.SetDirection("buy");
exchange.Buy(1000, 2);
exchange.SetMarginLevel(5);
exchange.SetDirection("closebuy");
exchange.Sell(1000, 2);

Parameter SetDirection dijelaskan sebagai berikut:

• 1. buy: parameter ini ditransfer saat memanggil SetDirection, kemudian dipanggil kembali untuk memanggil fungsi exchange.Buy, dan dilakukan.KeterlibatanOperasi.
• 2. sell button: Parameter ini ditransfer saat memanggil SetDirection, dan setelah dipanggil, fungsi exchange.Sell dipanggil kembali, dan dilakukan.Gudang kosongOperasi.
• 3. closebuy button: parameter ini ditransfer saat memanggil SetDirection, dan setelah dipanggil, kembali ke fungsi exchange.Sell, dan lakukan.PerkebunanOperasi (() dapat dilihat juga sebagai panggilan untuk fungsi exchange.Sell, yang dapat dibedakan dengan pengaturan arah operasi sebelumnya dengan panggilan SetDirection.Gudang kosongAtauPerkebunan)
• 4. closesell button: Parameter ini ditambahkan saat memanggil SetDirection, dan setelah dipanggil, fungsi exchange.Buy dipanggil kembali, dan dilakukan.gudang kosongOperasi...............................

Di sisi lain, ada dua parameter yang ditambahkan pada futures tradisional:

• 1. closebuy_today : digunakan untuk membeli lebih banyak saham hari ini.
• 2. closesell_today : digunakan untuk menebak stok kosong hari ini.

Dengan kata lain, ada dua parameter default yang berarti:

• 1. closebuy: digunakan untuk membiayai kemaren banyak saham.
• 2. closesell : digunakan untuk menebus kosong kemarin.

A: Data yang dikembalikan oleh bursa akan memberi tahu kita jawabannya. Dalam data yang dipanggil GetPosition untuk mendapatkan informasi kepemilikan, ada sifat Type yang akan memberi tahu kita bahwa kepemilikan adalah posisi sekarang atau posisi kemarin.

Mari kita coba, cobalah, cobalah!

function main() {  // 这次为了方便重点看  开仓平仓操作，我们在回测系统中进行测试。
    var initAccount = exchange.GetAccount();   // 获取初始 账户信息
    var info = exchange.SetContractType("MA701");   //   设置我们要操作的合约  甲醇 
    var ticker = exchange.GetTicker();   // 先获取当前的行情 数据
    
    Log("initAccount:", initAccount);
    Log(info);
    
    // 开仓买入做多
    exchange.SetDirection("buy");
    exchange.Buy(ticker.Sell + 1, 1);  // 吃掉卖一价这个单子，  买入一手。
    
    Sleep(1000);
    
    // 获取一下持仓信息
    var positions = exchange.GetPosition();  // 获取持仓信息
    Log("当前所有持仓:", positions);
    
    //平仓
    var pos = null;
    for(var i = 0 ; i < positions.length ; i++){
        if(positions[i].ContractType == "MA701"){
            pos = positions[i];
        }
    }
    exchange.SetDirection("closebuy_today");
    exchange.Sell(ticker.Buy - 1, pos.Amount);
    
    positions = exchange.GetPosition();
    Log("当前所有持仓:", positions);
}

Dalam sistem retargeting, biaya pengoperasian dikurangi secara otomatis, dan uang jaminan juga dikembalikan secara otomatis ke dalam akun. Dan sistem retargeting tidak membedakan posisi sekarang, posisi kemarin. Saat menulis kebijakan, sebaiknya tulis sesuai permintaan, agar tidak diubah lagi saat bermain.

• Perpustakaan perdagangan komoditas berjangka yang mudah dipahami

Untuk pengguna yang lebih mudah menggunakannya, platform ini telah dibungkus dengan toolbar yang mudah digunakan untuk membuat template toko komoditas berjangka. Kode sumbernya terbuka, siswa yang tertarik dapat melihat implementasinya dan dapat mempelajari banyak pengetahuan dan ide. Di bawah ini kita akan melihat beberapa fitur yang ditawarkan oleh template tersebut. 1. Salin dulu templatnya

2. Singkatkan kode, dalam kode template sendiri ada fungsi main untuk diuji, yang dapat langsung dijalankan. Setelah kita menyalin template, template yang sudah ada akan muncul di jendela template kebijakan, yang perlu ditambahkan ke kebijakan akan ditandakan di kotak di depannya.

3. Coba gunakan: Templat ini memilikiSpesies tunggal、 MultitaskingDua model kerja, yang pertama kita ketahui adalah metode penggunaan yang bersifat monogenik.

function main() {
    var p = $.NewPositionManager();   // $.NewPositionManager() 是 商品期货交易类库 模板的导出函数（接口）。
                                      // 该函数的作用是返回一个对象，用该对象管理开仓、平仓等操作。
    p.OpenShort("MA701", 1);          // p对象 的方法 OpenShort() , 功能是开空仓， 参数传入 合约代码 ，数量
                                      // 会根据当前行情的价格 开空仓。
    p.OpenShort("MA701", 1);          // 继续开空
    Log(p.GetPosition("MA701", PD_SHORT));   // 调用对象 p的 方法 GetPosition() ，传入合约代码， 合约类型， 找出相应的持仓，打印出来。

    Log(p.Account());
    Sleep(60000 * 10);                // 暂停一段时间
    p.CoverAll();                     // 调用 对象 p的方法 CoverAll() 把持仓全部平掉。
    LogProfit(p.Profit());            // 调用 对象 p的方法 Profit()  并打印 盈亏信息。
}

Dalam kode template, fungsi yang dimulai dengan $. adalah fungsi yang diekspor ke template dan dapat dipanggil oleh kebijakan lain (asalkan telah ditambahkan ke kebijakan).

• Futures Mata Uang Digital

Dukungan utama untuk BitVC, OKCoin, 796

• Anda dapat menggunakan fungsi SetMarginLevel untuk mengubah leverage, 10, 20, yang sedikit berbeda dari satu bursa ke bursa lainnya.

SetMarginLevel(MarginLevel)	设置杆杠大小
设置Buy(多单)或者Sell(空单)的杆杠大小, MarginLevel有5, 10, 20 三个可选参数
796支持5,10,20,50三个选项, BitVC的LTC不支持20倍杠杆, OKCoin支持10倍和20倍
如: exchange.SetMarginLevel(5)

• Spesies Kontrak OKCoin futures memiliki this_week (minggu), next_week (minggu berikutnya), quarter (kuartal). Kontrak yang berbeda untuk setiap bursa dapat dilihat pada dokumen API.