2.1 API کا استعمال کرتے ہوئے اکاؤنٹ کی معلومات حاصل کریں، مارکیٹ کے اعداد و شمار حاصل کریں، K لائن ڈیٹا حاصل کریں، مارکیٹ کی گہرائی حاصل کریں

2.1 API کا استعمال کرتے ہوئے اکاؤنٹ کی معلومات حاصل کریں، مارکیٹ کے اعداد و شمار حاصل کریں، K لائن ڈیٹا حاصل کریں، مارکیٹ کی گہرائی حاصل کریں

آخر میں دوسرا باب آگیا ہے ، اور پچھلے باب کے دورے کے ذریعے ، آپ کو انوینٹر کی کوانٹیٹیشن کے مختلف افعال کے بارے میں کچھ سمجھنے کی ضرورت ہے۔ پھر کوڈ لکھنا شروع کریں!

• API کا استعمال کرتے ہوئے اکاؤنٹ کی معلومات حاصل کریں

  فرض کریں کہ پہلے باب کے ذریعے جانے والے دورے کے بعد ہم نے ایک مینیجر، ایک ایکسچینج شامل کیا ہے، اور یقینا ہم کوڈ ٹیسٹنگ کے لئے موجد کی مقدار کی ڈسک کا استعمال کرسکتے ہیں۔

  تو پہلے ہم ایک حکمت عملی بناتے ہیں جسے ہم ٹیسٹ 1 کہتے ہیں۔

  حکمت عملی ایڈیٹر انٹرفیس

  یہ کوڈ مندرجہ ذیل ہے:

function main() {
    Log(exchange.GetAccount()); // 看过API 文档后知道， exchange就是交易所对象，实际上策略有个全局变量
                                // exchanges 数组，这个数组存放的就是你创建机器人或者回测时添加的交易所（可以是多个）
                                // 添加1个交易所 exchanges 数组就只包含1个交易所对象，即添加的交易所对象。
                                // 那么 exchange 和 exchanges 是什么关系呢？ 其实 exchange 就是 exchanges[0] ,
                                // exchange 就是 exchanges 数组的第一个元素（这里这个元素是交易所对象）。
                                
                                // Log()函数应该也不陌生吧，这个API 就是输出一条日志，日志内容就是Log括号里面的参数。
}

ایک روبوٹ بنانا جسے ٹیسٹ ون بھی کہا جاتا ہے ، کوڈ ٹیسٹ ون نامی پابند حکمت عملی کا استعمال کرتے ہوئے ایجاد کنندہ کی طرف سے کیوٹیفائی کیا گیا ہے۔

یہ حکمت عملی فوری طور پر چلتی ہے اور اکاؤنٹ کی معلومات دکھاتی ہے۔

یہ ظاہر ہوتا ہے کہ ہم اکاؤنٹ کی معلومات کے ساتھ موازنہ کرتے ہیں جو ہم نے ڈسک پر دیکھا تھا۔

• مارکیٹ کے اعداد و شمار حاصل کریں

function main() {
    Log(exchange.GetAccount()); // 已经知道怎么获取 主交易所 账户信息了
    //下面我们来试试 不停的获取行情数据。 
    while(true){ // 这里用一个无限循环的结构来不停的获取 交易所行情数据。
        Log("行情数据：", exchange.GetTicker()); // 哇！ Log() 函数的括号里面可以写2个参数，第一个参数是: "行情数据:"
                                               // 第二个参数是 exchange.GetTicker() 这个函数的返回值。就是主交易所的行情数据。
                                               // 注意 Log() 函数的参数要用 逗号分隔。
        Sleep(1000);   // 咦~ 这个又是什么？ 答：机器人程序 执行循环也需要休息！它可是执行很快的哦！（一秒N次）
                       // Sleep 函数的作用就是让程序暂停一会儿，括号里面的参数 1000 是 毫秒数， 1秒 = 1000毫秒。Sleep(1000);就是暂停1000毫秒。
                       // 不要小看这个参数，这个参数控制了程序的轮询频率，间接影响访问 交易所API 的频率，有些交易所API访问过于频繁可是会拒绝访问的。
    }
}

نوٹ:شاید آپ کو معلوم ہو کہ گیٹ ٹکر فنکشن کی طرف سے حاصل کردہ اعداد و شمار میں سب سے زیادہ قیمت اور سب سے کم قیمت میں بہت فرق ہے۔ اس کے بارے میں ، گیٹ ٹکر کے ذریعہ واپس آنے والے مارکیٹ کے اعداد و شمار کی اعلی ، کم قیمت ایک معاہدہ شدہ سائیکل کے اندر اندر سب سے زیادہ ، سب سے کم قیمت ہے ، خاص طور پر تبادلے کی ترتیب کے مطابق۔

• K لائن ڈیٹا حاصل کریں

  آئیے پہلے ای پی آئی دستاویزات کی وضاحت دیکھتے ہیں:

GetRecords(Period)	返回一个K线历史, K线周期在创建机器人时指定, Record数组结构
不加参数, 默认返回添加机器人时时指量的K线周期, 但也可以自定义K线周期
支持: PERIOD_M1 指1分钟, PERIOD_M5 指5分钟, PERIOD_M15 指15分钟, PERIOD_M30 指30分钟, PERIOD_H1 指1小时, PERIOD_D1 指一天

ہم نے کوڈ کا ایک ٹکڑا لکھا ہے اور اسے ٹیسٹ کیا ہے کہ کیا ہم ڈیفالٹ سائیکل (5 منٹ) کے لئے K لائن ڈیٹا حاصل کرسکتے ہیں؟

function main() {
    Log(exchange.GetAccount()); // 已经知道怎么获取 主交易所 账户信息了
    //下面我们来试试 不停的获取行情数据。 
    var records = exchanges[0].GetRecords();  // 按照默认周期获取K线数据
    Log("records:", records);  // 在日志中输出 获取到的K线数据。
}

آؤٹ پٹ دکھائیں: ریکارڈز: [{Time:1478260200000,Open:4765.14,High:4773,Low:4764.54,Close:4769.47,Volume:5211.5399999999}، {Time:1478260500000,Open:4769.47,High:4773.01,Low:4764,Close:4764.78,Volume:3742.250000000002}، {Time:1478260800000,Open:4764.78,High:4782,Low:4764,Close:4781.28,Volume:7929.090000000004}، {Time:1478261100000,Open:4781.28,High:4795,Low:4774,Close:4792.02,Volume:11793.540000000006}، {Time:1478261400000,Open:4792.02,High:4792.96,Low:4781,Close:4786.78,Volume:9204.90000000001}، {Time:1478261700000,Open:4786.51,High:4788.66,Low:4775,Close:4775.31,Volume:7722.33999999965}

جیسا کہ آپ دیکھ سکتے ہیں کہ متغیر ریکارڈز ایک ساختی صف ہے جو K لائن کے وقت کے مطابق ترتیب دی گئی ہے، دور سے قریب تک۔ ہم K لائن کے بارے میں بات کرتے ہیں: ((کچھ گراف سرخ سورج کی روشنی کے لئے ہیں ، سبز صنف کے لئے ہیں ، اور کچھ اس کے برعکس رنگ کے لئے ہیں۔))ذیل میں پلیٹ فارم کے 5 منٹ کے دورانیے کے لئے K لائن مثال چارٹ ملاحظہ کریں۔ نوٹ:ایک K لائن کا دورانیہ مکمل ہونے کے بعد ہی اس کی قدر طے ہوتی ہے۔ عملی استعمال میں ہم var records = exchanges[0] کو کال کرتے ہیں۔ GetRecords (() ؛ واپس آنے والے ڈیٹا ریکارڈز صف میں آخری عنصر یعنی: records[records.length - 1] ، اس کا دورانیہ مکمل ہونے تک مستقل طور پر بدلتا رہتا ہے۔ یہاں تک کہ ممکنہ طور پر آخری سیکنڈ میں ، سورج کی روشنی سے جینس تبدیل ہوجاتا ہے۔

GetRecords فنکشن بغیر کسی پیرامیٹر کے پالیسی کی ترتیبات کے مطابق ڈیفالٹ دوروں کا ڈیٹا واپس کرتا ہے۔ یہ بھی ممکن ہے کہ پیرامیٹرز کو K لائنوں کے دوروں کی وضاحت کے لئے منتقل کیا جائے۔ فی الحال، ریٹرننگ سسٹم نے پیرامیٹرز کو منتقل کرنے کے لئے پیرامیٹرز کو منتقل کرنے کے لئے پیرامیٹرز کی وضاحت کرنے کے لئے GetRecords کی حمایت کی ہے (غیر پیرامیٹرز کے مطابق ڈیفالٹ دوروں کا ڈیٹا واپس) تاکہ پالیسی ریٹرننگ کے دوران ایک ہی وقت میں مختلف دوروں کا استعمال کیا جاسکے۔

• مارکیٹ کی گہرائی سے معلومات حاصل کریں

  GetDepth ایک گہرائی ساخت واپس کرتا ہے

function main() {
    var depth = exchanges[0].GetDepth();   //获取市场深度信息，  返回订单薄信息，一个对象包含2个属性，每个属性是一个对象数组。
    Log("depth:", depth);    // 日志中输出，一下的输出是 整理过的格式，是方便读者理解，实际上是所有内容都在一行显示的。
}

مندرجہ بالا کوڈ کی جانچ پڑتال مندرجہ ذیل ہے:

depth: 
{"Asks":[{"Price":4726.07,"Amount":15},   // 卖单数组，回测时，数据都是模拟出来的，所以Amount 都是 15，索引为0的是卖一，依次类推。
         {"Price":4726.08,"Amount":15},
         {"Price":4726.09,"Amount":15},
         {"Price":4726.1,"Amount":15},
         {"Price":4726.11,"Amount":15},
         {"Price":4726.12,"Amount":15},
         {"Price":4726.13,"Amount":15},
         {"Price":4726.14,"Amount":15},
         {"Price":4726.15,"Amount":15},
         {"Price":4726.16,"Amount":15},
         {"Price":4726.17,"Amount":15}],
"Bids":[{"Price":4726.05,"Amount":15},   //  买单数组，索引为0的是买一， 向后依次类推。
        {"Price":4726.04,"Amount":15},
        {"Price":4726.03,"Amount":15},
        {"Price":4726.02,"Amount":15},
        {"Price":4726.01,"Amount":15},
        {"Price":4726,"Amount":15},
        {"Price":4725.99,"Amount":15},
        {"Price":4725.98,"Amount":15},
        {"Price":4725.97,"Amount":15},
        {"Price":4725.96,"Amount":15},
        {"Price":4725.95,"Amount":15}]
}

اسی طرح کے آرڈر بِن ایسے ہیں ((یہ او کے کوائن کے حقیقی اعداد و شمار ہیں) ؛ اصل عمل میں مارکیٹ کی گہرائی کی معلومات ((آرڈر بِن) بہت تیزی سے بدلتی ہے ، دلچسپی رکھنے والے طلباء او کے کوائن کے لئے رجسٹر ہوسکتے ہیں ، پھر لاگ ان کریں اور دیکھیں۔

مارکیٹ کی گہرائی سے متعلق معلومات کے ساتھ کیا کرنا ہے؟ مارکیٹ کے اعداد و شمار کے بہت سے استعمال ہوتے ہیں ، مثال کے طور پر کھانے کی فہرست (یقینی طور پر ، فہرست بھی ہے) ۔

function main() {    
    var depth = exchanges[0].GetDepth();    // 获取市场深度
    Log("depth:", depth);                   // 日志输出显示
    Log(exchanges[0].GetAccount());         // 输出 吃单前的 账户信息
    var buyPrice = depth.Asks[0].Price;     // 设置吃卖单的价格，即卖一，
                                            // 有时为确保吃单成功，这样处理：var buyPrice = depth.Asks[0].Price + slidePrice;
    var buyAmount = depth.Asks[0].Amount;   // 吃卖单的量
    exchanges[0].Buy(buyPrice, buyAmount);  // 执行买入操作， 吃掉卖一 这个单子
    Log(exchanges[0].GetAccount());         // 显示买入后的  账户信息，对比初始账户信息。可以对比出 买入操作的成交的数量。
}

انوینٹر کیوٹیفیکیشن کے نتائج: