জিএমপি ব্যবহারের নথিপত্র

যে কোন একটিতে প্রবেশ করতে পারবেনAPIট্রেডিং এর এক্সচেঞ্জ, নির্দিষ্ট API- র সাথে সীমাবদ্ধ নয়,rest、websocket、fix… ব্যবহার করা যাবে। পাইথন জেনারেল প্রোটোকল উদাহরণঃhttps://www.fmz.com/strategy/101399

• ### ১, জিপিএস প্লাগইন চালানো, পোর্ট সেটিং

জিপিএস প্লাগইন ট্যাবের নিরীক্ষণের ঠিকানা এবং পোর্ট সেটিং লিখুন। উদাহরণ:http://127.0.0.1:6666/DigitalAssetঅথবাঃhttp://127.0.0.1:6666/exchange。

কেন এই সেট আপIP、পথপশমী কাপড়? কারণআবিষ্কারক পরিমাণপাতানিয়ন্ত্রণ কেন্দ্রপাল্টাএক্সচেঞ্জ যোগ করুনপৃষ্ঠা, নির্বাচন করুন জিপিএক্স ট্যাব, প্রদর্শিত ছাড়াAPI-KEY, এবং একটি টুকরো পরিষেবা ঠিকানা টুকরো, এই পরিষেবা ঠিকানাটি হোস্টকে জানায় যে কোন আইপি এবং পোর্টটি অ্যাক্সেস করার সময় এসেছে ((হোস্ট এবং জিপিআর প্লাগইন একই ডিভাইসে চলতে পারে না)) । পরিষেবা ঠিকানা উদাহরণ পূরণ করুনhttp://127.0.0.1:6666/DigitalAsset。DigitalAssetএই নামটি একটি উদাহরণ মাত্র।

ইনভেন্টর কোয়ান্টাম অ্যাড এক্সচেঞ্জের পেজটি এরকমঃ সাধারণত, এক্সচেঞ্জের কনফিগারেশন অ্যাকাউন্টের তথ্য শুধুমাত্র কনফিগারেশন প্রয়োজনaccess keyএবংsecret keyতবে কিছু এক্সচেঞ্জের এপিআই ইন্টারফেসগুলি লেনদেনের পাসওয়ার্ড প্রেরণ করতে বলে (যেমন কিছু এক্সচেঞ্জের অর্ডার ইন্টারফেস) এবং যখন আমরা এই জাতীয় এক্সচেঞ্জের এপিআইগুলির সাথে দেখা করি তখন আমরা অতিরিক্ত কনফিগারেশন তথ্য লিখতে পারি যেহেতু জিপিও পৃষ্ঠায় অতিরিক্ত নিয়ন্ত্রণ নেই।secret keyযদি তথ্যটি সংবেদনশীল না হয়, তাহলে এটি লিখতে পারেনaccess key), তারপর জিপিও প্লাগইন মধ্যে স্ট্রিং তৈরিsplitঅপারেশন, এই তথ্যগুলোকে আলাদা করুন, যেমন চিত্রের উদাহরণে দেখানো হয়েছে।

এবং তারপর প্লাগইন মধ্যে এটি প্রক্রিয়া, এবং আপনি পাবেনXXX_PassWord。 উদাহরণস্বরূপ, এই পোস্টের শেষ সম্পূর্ণ উদাহরণে, newBitgo ফাংশনঃ

  func newBitgo(accessKey, secretKey string) *iBitgo {
      s := new(iBitgo)
      s.accessKey = accessKey
      s.secretKey = secretKey
      // 在此可以分离secretKey中的额外配置信息，可以写成如下注释中的内容
      /*
      arr := strings.SplitN(secretKey, ",", 2)
      if len(arr) != 2 {
          panic("配置错误！")
      }
      s.secretKey = arr[0]   // secret key 
      s.passWord = arr[1]    // XXX_PassWord
      */
      s.apiBase = "https://www.bitgo.cn"
      s.timeout = 20 * time.Second
      s.timeLocation = time.FixedZone("Asia/Shanghai", 8*60*60)

      return s
  }

জিপিও প্লাগইনmainফাংশন উদাহরণঃ Goবর্ণনাঃ

  func main(){
      var addr = flag.String("b", "127.0.0.1:6666", "bing addr")   // 设置命令行参数，默认值描述，端口设置6666
      flag.Parse()                                                 // 解析命令行
      if *addr == "" {
          flag.Usage()                                             // 显示命令行描述
          return 
      }
      basePath := "/DigitalAsset"
      log.Println("Running ", fmt.Sprintf("http://%s%s", *addr, basePath), "...")   // 打印监听端口信息
      http.HandleFunc(basePath, OnPost)
      http.ListenAndServe(*addr, nil)
  }

• #### ২, প্রতিক্রিয়া ফাংশন

জিপিএস প্লাগইন ক্যাচ প্রোগ্রাম নির্দিষ্ট পোর্ট উপর ক্রমাগত মনিটরিং, কোন অনুরোধ পাঠানো হয়requestএকটি অনুরোধের পরে, প্রতিক্রিয়া ফাংশনটি প্রতিক্রিয়া কার্যকরকরণকে কল করে এবং অনুরোধের ডেটাতে প্যারামিটারগুলি বিশ্লেষণ করে। হোস্ট দ্বারা প্রেরিত অনুরোধের ডেটা হ’লঃ

  /* request的JSON结构，发明者量化调用GetTicker，托管者发送给通用协议插件情况举例（各个API调用时，params的值可能不一样，此处method为ticker）：
  {
      "access_key" : "XXX",               // `json:"access_key"`
      "secret_key" : "XXX",               // `json:"secret_key"`
      "nonce" : "1502345965295519602",    // `json:"nonce"`
      "method" : "ticker",                // `json:"method"`
      "params" : {                        // `json:"params"`
                     "symbol" : "btc",
                     ...
                 },                       // 各个请求参数略有区别。即在策略中调用不同的 发明者量化 API会有不同的参数, 在下文各个API 有介绍说明。
  }
  */

সুতরাং জিপিএস প্লাগইন প্রোগ্রামের মধ্যে প্রাপ্ত অনুরোধের বডি ডেটা থেকে JSON- এর বিপরীত সিকোয়েন্সিংয়ের পরে প্রাপ্ত কাঠামোrequestমধ্যেMethodএবং আমরা ব্যবহার করতে পারেনswitchবিভিন্ন আবিষ্কারক দ্বারা প্রাপ্ত এপিআইগুলিকে শ্রেণিবদ্ধ করুন, অর্থাৎ হোস্টের উপর চালিত নীতিগুলি সনাক্ত করুন যে কোন আবিষ্কারক দ্বারা প্রাপ্ত হয়API) কল করুনঃ

Goভাষার উদাহরণঃ

  switch request.Method {    // 此处request.Method的M为大写，通用协议程序接收到的请求主体中为JSON数据，在Go语言中反JSON序列化(Unmarshal)为结构体，字段首字母必须大写
    case "accounts" :        // 当托管者上的机器人策略中调用了exchange.GetAccount()函数，托管者会发送来请求，其中Body携带的数据中method属性值为accounts
        data, err = e.GetAccount(symbol)
    case "ticker" :
        data, err = e.GetTicker(symbol)
    case "depth" :
        data, err = e.GetDepth(symbol)
    case "trades" :
        data, err = e.GetTrades(symbol)
    case "trade" :
    ...
    default:
        ...

এই শাখাগুলি জিপিএস প্লাগইন প্রোগ্রামের দ্বারা প্রতিক্রিয়া জানাতে হবে এমন কাঠামোর মধ্যে ফিরে আসা ডেটা সম্পাদন করে এবং ট্রাস্টিদের অনুরোধের জবাব দেয়।

Go ভাষার উদাহরণঃ

  defer func(){                                // 处理收尾工作 
        if e := recover(); e != nil {          // recover()函数用于捕获panic，e != nil即有错误发生
            if ee, ok := e.(error); ok {       // 类型推导，推导成功把ee.Error()赋值给e
                e = ee.Error()                 // 调用Error方法获取返回的错误字符串
            }
            ret = map[string]string{"error": fmt.Sprintf("%v", e)}
        }
        b, _ := json.Marshal(ret)              // 把本次调用获取的结果ret编码，赋值给b，写入响应指针
        w.Write(b)
        //fmt.Println("after w.Write the b is", string(b))     // 测试
    }()

• #### ৩. এপিআই কলের ধরন

এই ছবিগুলোকে দুই ভাগে ভাগ করা যায়ঃ ১। স্বাক্ষরবিহীন পাবলিক ইন্টারফেস যেমনঃ

GetTicker()

GetDepth()

GetTrades()

GetRecords(period) …

২। ব্যবহারকারীর ইন্টারফেস যা স্বাক্ষর প্রয়োজন, যেমনঃ

Buy、Sell

GetOrder(id)

GetOrders()

GetAccount()

CancelOrder(id) … প্রতিটি এক্সচেঞ্জের স্বাক্ষর পদ্ধতি ভিন্ন হতে পারে এবং প্রয়োজন অনুসারে এটি লিখতে হবে।

• ### ৪, আবিষ্কারক যখন বিভিন্ন এপিআই ইন্টারফেস কলের পরিমাণ নির্ধারণ করেজিপিএস প্লাগইনএবংঅভিভাবকইন্টারেক্টিভ ডেটা ফরম্যাটঃ

কিছু উদ্ভাবক এপিআই ইন্টারফেসকে কোয়ান্টাইজ করেছেন যেমনঃGetName()，GetLabel()ইত্যাদি ফাংশন, যখন কল করা হয় নাজিপিএস প্লাগইনঅনুরোধ পাঠান exchange.GetName()সাধারণ প্লাগইন কনফিগার করা এক্সচেঞ্জগুলি যখন কল করা হয় তখন “Exchange” ফিরে আসে।

• 1、GetTicker: বর্তমান তথ্যের জন্য ব্যবহৃত হয়।

  অভিভাবকমনিটরিং প্রতিক্রিয়া ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃticker。

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.symbol: মনিটর দ্বারা বট পৃষ্ঠায় সেট করা মুদ্রায় পাঠানো।

  জিপিও প্লাগইনটির কাছে অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা তথ্য ফর্ম্যাট (জেএসওএন)

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "ticker",
      "params" :     {"symbol" : "ETH_BTC"},     // 以ETH_BTC交易对举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচার: ((যেমন জিপিএস প্লাগইন এক্সচেঞ্জ ইন্টারফেস অনুরোধের পরে ডেটা হোস্টে ফেরত ফর্ম্যাট)

  JSON গঠন

  {
      "data": {
          "time": 1500793319499,  // 毫秒时间戳，整型
          "buy": 1000,            // 以下浮点型
          "sell": 1001,
          "last": 1005,
          "high": 1100,
          "low": 980,
          "vol": 523,
      }
  }
  

• 2、GetRecords:এক্সচেঞ্জ দ্বারা সরবরাহিত K-লাইন ডেটা পেতে ব্যবহৃত হয়।

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃrecords

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.periodমান সম্পর্কিতঃexchange.GetRecordsফাংশন এর প্রথম প্যারামিটার, বাস্তবrequest.Params.periodমিনিটের সংখ্যায় প্রকাশিত একটি সময়কাল, যেমন দৈনিক সময়কাল60*24এখনই1440、request.Params.symbol: ট্রাস্টি দ্বারা সেট করা মুদ্রায় পাঠানো হচ্ছে।

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "records",
      "params" :     {"symbol" : "ETH_BTC", "period" : "1440"},     // 以ETH_BTC交易对，K线周期为日线举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  {
      "data": [
              [1500793319, 1.1, 2.2, 3.3, 4.4, 5.5],         // "Time":1500793319000,"Open":1.1,"High":2.2,"Low":3.3,"Close":4.4,"Volume":5.5
              [1500793259, 1.01, 2.02, 3.03, 4.04, 5.05],
              ...
      ]
  }
  

  Go ভাষার পরীক্ষার তথ্যঃ

  ret_records = []interface{}{
      [6]interface{}{1500793319, 1.1, 2.2, 3.3, 4.4, 5.5}, 
      [6]interface{}{1500793259, 1.01, 2.02, 3.03, 4.04, 5.05}
  }
  

  আবিষ্কারক কোয়ান্টামেশন প্ল্যাটফর্মLogপ্রদর্শনrecordsতথ্যঃ

  [
      {"Time":1500793319000,"Open":1.1,"High":2.2,"Low":3.3,"Close":4.4,"Volume":5.5},
      {"Time":1500793259000,"Open":1.01,"High":2.02,"Low":3.03,"Close":4.04,"Volume":5.05}
  ]
  

  নোটঃ ১, দ্বিতীয় মাত্রিক অ্যারেতে প্রথম উপাদানটি হলintটাইপ, সময়কে বোঝায় 。 ২। অ্যাডমিনিস্ট্রেটর স্বয়ংক্রিয়ভাবে সময়কে multiplied by 1000, এর উপরে দেখা যাবে 。

• 3、GetDepth：এক্সচেঞ্জের গভীরতার তথ্য (অর্ডার কম, এক বিক্রি, দুই বিক্রি, এক কেনা, দুই কেনা…)

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃdepth

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.symbol: প্রশাসক দ্বারা নীতি অনুসারে প্রেরিত মুদ্রা

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "depth",
      "params" :     {"symbol" : "ETH_BTC"},     // 以ETH_BTC交易对举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  {
      "data" : {
          "time" : 1500793319499,
          "asks" : [ [1000, 0.5], [1001, 0.23], [1004, 2.1], ... ],
          "bids" : [ [999, 0.25], [998, 0.8], [995, 1.4], ... ],
      }
  }
  

• 4、GetTrades：এক্সচেঞ্জ দ্বারা প্রদত্ত পুরো এক্সচেঞ্জের নির্দিষ্ট সময়ের লেনদেনের রেকর্ডগুলি অ্যাক্সেস করুন (নিজের নয়)

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃtrades

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.symbolউদাহরণস্বরূপঃbtcকয়েনগুলি নীতি অনুসারে ট্রাস্টি কর্তৃক প্রেরণ করা হয়।

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "trades",
      "params" :     {"symbol" : "ETH_BTC"},     // 以ETH_BTC交易对举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  { 
      "data": [
          {
              "id": 12232153,
              "time" : 1529919412968,
              "price": 1000,
              "amount": 0.5,
              "type": "buy",             // "buy"、"sell"
          },{
              "id": 12545664,
              "time" : 1529919412900,
              "price": 1001,
              "amount": 1,
              "type": "sell",
          },{
              ...
          }
      ]
  }
  

• 5、GetAccount：অ্যাকাউন্টের সম্পদের তথ্য

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃaccounts

  ট্রাস্টি পাঠানো প্যারামিটারঃ ((বিপরিচিত! সাধারণভাবে অ্যাকাউন্টের সমস্ত সম্পদ প্রাপ্ত করুন! এক্সচেঞ্জের ইন্টারফেসের উপর নির্ভর করে, পৃথকভাবে বা মোট সম্পদ তথ্য প্রাপ্ত করুন))

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "accounts",
      "params" :     {},                         
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  {
      "data": [
          {"currency": "btc", "free": 1.2, "frozen": 0.1},
          {"currency": "ltc", "free": 25, "frozen": 2.1},
          {"currency": "ltc", "free": 25, "frozen": 2.1},
          ...
      ],
      "raw" : {...}             // 可以写入插件访问交易所时，交易所返回的原始信息（response）
  }
  

• 6、Buy、Sell：কন্ট্রাক্ট ওয়ারেন্টি পাঠান, লেনদেনের জন্য অর্ডার দিন।

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃtrade

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.typeকলের উপর নির্ভর করেঃexchange.Buyঅথবাexchange.Sellপাঠানrequest.Params.priceনীতিমালায় বলা হয়েছেঃAPIফাংশনের প্রথম প্যারামিটার,request.Params.amountনীতিমালায় বলা হয়েছেঃAPIফাংশনের দ্বিতীয় প্যারামিটার,request.Params.symbol: ট্রাস্টি দ্বারা সেট করা মুদ্রায় পাঠানো হচ্ছে।

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "trade",
      "params" :     {
                         "symbol" : "ETH_BTC", 
                         "type" : "buy", 
                         "price" : "1000", 
                         "amount" : "1"
                     },                          // 以ETH_BTC交易对，"type":"buy"买请求，价格1000，数量1举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  {
      "data": {
          "id": 125456,      // 下单后返回的订单id
                             // 如果订单id是"asdf346sfasf532"这样的字符串形式
                             // 此处id也可以是字符串类型
      }
  }
  

• 7、GetOrder：অর্ডার নাম্বার থেকে অর্ডার তথ্য পেতে

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃorder

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.id、request.Params.symbol

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "order",
      "params" :     {"symbol" : "ETH_BTC", "id" : "XXX"},     // 以ETH_BTC交易对，订单id为XXX举例，注意有些交易所的订单号是数字形式的订单ID，如123456，有些交易所的订单号是字符串形式的ID，如poimd55sdfheqxv，具体看交易所的订单ID格式
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  { 
      "data": {
          "id": 2565244,
          "amount": 0.15,
          "price": 1002,
          "status": "open",    // "open":挂起状态、"closed":完成关闭状态、"cancelled":已取消
          "deal_amount": 0,
          "type": "buy",       // "buy"、"sell"
          "avg_price": 0,      // 如果交易所没有提供，在处理时可以赋值为0
      }
  }
  

• 8、GetOrders: আপনার সমস্ত অর্ডার সম্পর্কে তথ্য পান

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestএর method হল:orders

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.symbol

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "orders",
      "params" :     {"symbol" : "ETH_BTC"},     // 以ETH_BTC交易对举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  {
      "data": [{
          "id": 542156,
          "amount": 0.25,
          "price": 1005,
          "deal_amount": 0,
          "type": "buy",      // "buy"、"sell"
          "status": "open",   // "open"
      },{
          ...
      }]
  }
  

• 9、CancelOrder: অর্ডার নাম্বার দিয়ে অর্ডার কমান্ড বাতিল করুন

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্যঃcancel

  অ্যাডমিনিস্ট্রেটররা প্যারামিটার পাঠিয়েছেঃrequest.Params.id: স্ট্রিং টাইপ, নীতি কল করা API ফাংশনের প্রথম প্যারামিটার,request.Params.symbol:btc (উদাহরণ) প্রশাসক দ্বারা নীতি অনুসারে প্রেরিত মুদ্রা

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "cancel",
      "params" :     {"symbol" : "ETH_BTC", "id" : "XXX"},     // 以ETH_BTC交易对，id为"XXX"（同GetOrder函数的参数id一样），举例
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  JSON গঠন

  {
      "data": true,        // true or false
  }
  

• 10、IO: এক্সচেঞ্জ.আইও ফাংশন, যা ইনভেন্টর কোয়ান্টামাইজেশন প্ল্যাটফর্মকে কল করে

  মনিটরিং রেসপন্স ফাংশন পাঠানোrequestমধ্যেmethodএর জন্য__api_যে পদ্ধতির নাম দিয়ে শুরু।

  একটি জিপিও প্লাগইন অনুরোধ করার সময় হোস্ট কর্তৃক অনুরোধ করা ডেটা ফর্ম্যাট

  {
      "access_key" : "access_key",
      "secret_key" : "secret_key",
      "nonce" :      "1500793319499",            // 毫秒时间戳
      "method" :     "__api_XXX",                // XXX为具体交易所的API接口（不包含基地址）
      "params" :     {"borrow_id" : "123", "symbol" : "cny"},      // 具体是传入IO函数的参数
  }
  

  অবশেষে হোস্টে পাঠানো রিটার্ন ভ্যালু স্ট্রাকচারঃ

  {
      "data": {...}       // 具体的接口调用的返回值
  }
  

  উদাহরণস্বরূপ, কৌশলগত কলঃ

  var io_str = exchange.IO("api", "POST", "cancel_borrow", "symbol=cny&borrow_id=123")
  

  প্লাগ-ইন-এর টেস্ট কোড (go ভাষায়):

  fmt.Println("request.Method:", request.Method, "request.Params:", request.Params)
  

  প্লাগইন কমান্ড লাইন: 2017/08/31 10:19:59 Running http://127.0.0.1:6666/DigitalAsset …

  request.Method,request.Params প্লাগইন কমান্ড লাইনে মুদ্রিত হোস্ট দ্বারা পাঠানো অনুরোধের বডিতে ডেটা বিশ্লেষণের পরে অনুরোধেঃrequest.Methodএর জন্যঃ__api_cancel_borrow হোস্ট দ্বারা পাঠানো অনুরোধের বডিতে ডেটা বিশ্লেষণের পরে অনুরোধেঃrequest.Paramsএর জন্যঃ{"borrow_id" : "123", "symbol" : "cny"}

  এই সরাসরি অ্যাক্সেস এক্সচেঞ্জ কাস্টমাইজডAPIএরexchange.IOকল করুন

  # 注意：
  # 在调用exchange.IO("api", "POST", "/api/v1/getAccount", "symbol=BTC_USDT")时，
  # 如果第二个参数不是POST，而是:exchange.IO("api", "GET", "/api/v1/getAccount", "symbol=BTC_USDT")
  # 是GET方法，这时在通用协议插件接受到的http请求中头部Http-Method中储存的才是GET，
  # 所以在通用协议处理IO函数实现时，需要参考以下范例代码：
  // tapiCall函数定义
  func (p *iStocksExchange) tapiCall(method string, params map[string]string, httpType string) (js *Json, err error) {
      ...
  }
  
  
  // 在OnPost函数中
  if strings.HasPrefix(request.Method, "__api_") {
      var js *Json
      js, err = e.tapiCall(request.Method[6:], request.Params, r.Header.Get("Http-Method"))
      ...
  }
  

• এক্সচেঞ্জ.গেটরাউজেসন সমর্থন

  নিচের স্তর স্বয়ংক্রিয়exchange.GetRawJSONএই প্লাগইনটি ব্যবহার করার জন্য, আপনাকে এটির সাথে যুক্ত হতে হবে না।

• এক্সচেঞ্জ.গো-র জন্য সমর্থন

  নিচের স্তর স্বয়ংক্রিয়exchange.Goএই প্লাগইনটি ব্যবহার করার জন্য, আপনি যে কোন একটি ব্যবহার করতে পারেন।

  var beginTime = new Date().getTime()
  var ret = exchange.Go("GetDepth")
  var endTime = new Date().getTime()
  Log(endTime - beginTime, "#FF0000")
  
  
  // Sleep(2000)
  beginTime = new Date().getTime()
  Log(exchange.GetTicker())
  endTime = new Date().getTime()
  Log(endTime - beginTime, "#FF0000")
  var depth = ret.wait()
  Log("depth:", depth)
  

  

  

  # 注意：使用exchange.Go在wait的时候如果指定了超时时间， 
  #      一定要确保获取到最终的数据，这样申请的并发线程才能回收。
  

• ফরওয়ার্ড ফাংশন সমর্থন

  প্লাগইন প্রোগ্রামে নির্দিষ্ট প্রক্রিয়াকরণের প্রয়োজন, যেমন লিভারেজ, চুক্তি কোড, অর্ডার দিকনির্দেশ, একটি স্থানীয় ভেরিয়েবল রেকর্ড সেট আপ করা যেতে পারে, হোল্ডিং অ্যাক্সেস করতে এক্সচেঞ্জ ইন্টারফেসে অ্যাক্সেস করতে হবে এবং FMZ প্ল্যাটফর্মে সংজ্ঞায়িত হোল্ডিং কাঠামোর জন্য কাঁচা ডেটা এবং প্রক্রিয়াকরণের জন্য ফিরে আসতে হবে। প্লাগইনটি যখন নিম্নলিখিত ফাংশনটি কল করে তখন প্লাগইনটি যা পায় তা হলRpcঅনুরোধের বিন্যাসটি অন্যান্য ইন্টারফেসের থেকে সামান্য ভিন্ন, জেনে রাখা দরকার যে জিপিএস প্লাগইনRpcRequestএই ফরম্যাটে, প্রধান পার্থক্য হল যে params এর মান একটি সমষ্টিগত গঠন।

  • SetContractType
    চুক্তি কোড সেট করুন

    {"access_key":"123","method":"io","nonce":1623307269528738000,"params":{"args":["quarter"],"code":2},"secret_key":"123"}
  

  • SetDirection ফরমেট সেট করুনঃ

    {"access_key":"123","method":"io","nonce":1623308734966484000,"params":{"args":["closesell"],"code":1},"secret_key":"123"}
  

  • SetMarginLevel ফরওয়ার্ড লিভারেজ সেট করুন

    {"access_key":"123","method":"io","nonce":1623308734966939000,"params":{"args":[12],"code":0},"secret_key":"123"}
  

  • GetPosition ফরওয়ার্ড হোল্ডিংয়ের সুবিধা। যখনexchange.GetPosition()কল করার সময়ঃ

    {"access_key":"123","method":"io","nonce":1623308734967442000,"params":{"args":[],"code":3},"secret_key":"123"}
  

  যখনexchange.GetPosition("swap")কল করার সময়ঃ

    {"access_key":"123","method":"io","nonce":1623308734967442000,"params":{"args":["swap"],"code":3},"secret_key":"123"}
  

---

• ### একটি সাধারণ প্রোটোকল প্লাগইন সম্পূর্ণ Go ভাষার উদাহরণ (বিট এক্সচেঞ্জ অ্যাক্সেস)

”`go /* GOOS=linux GOARCH=amd64 go build -ldflags ‘-s -w -extldflags -static’ rest_bitgo.go */ package main

import ( “bytes” “crypto/md5” “encoding/hex” “encoding/json” “errors” “flag” “fmt” “io/ioutil” “log” “net/http” “net/url” “sort” “strconv” “strings” “time” )

func toFloat(s interface{}) float64 { var ret float64 switch v := s.(type) { case float64: ret = v case float32: ret = float64(v) case int64: ret = float64(v) case int: ret = float64(v) case int32: ret = float64(v) case string: ret, _ = strconv.ParseFloat(strings.TrimSpace(v), 64) } return ret }

func float2str(i float64) string { return strconv.FormatFloat(i, ‘f’, -1, 64) }

func toInt64(s interface{}) int64 { var ret int64 switch v := s.(type) { case int: ret = int64(v) case float64: ret = int64(v) case bool: if v { ret = 1 } else { ret = 0 } case int64: ret = v case string: ret, _ = strconv.ParseInt(strings.TrimSpace(v), 10, 64) } return ret }

func toString(s interface{}) string { var ret string switch v := s.(type) { case string: ret = v case int64: ret = strconv.FormatInt(v, 10) case float64: ret = strconv.FormatFloat(v, ‘f’, -1, 64) case bool: ret = strconv.FormatBool(v) default: ret = fmt.Sprintf(“%v”, s) } return ret }

type Json struct { data interface{} }

func NewJson(body []byte) (*Json, error) { j := new(Json) err := j.UnmarshalJSON(body) if err != nil { return nil, err } return j, nil }

func (j *Json) UnmarshalJSON(p []byte) error { return json.Unmarshal(p, &j.data) }

func (j *Json) Get(key string) *Json { m, err := j.Map() if err == nil { if val, ok := m[key]; ok { return &Json{val} } } return &Json{nil} }

func (j *Json) CheckGet(key string) (*Json, bool) { m, err := j.Map() if err == nil { if val, ok := m[key]; ok { return &Json{val}, true } } return nil, false }

func (j *Json) Map() (map[string]interface{}, error) { if m, ok := (j.data).(map[string]interface{}); ok { return m, nil } return nil, errors.New(“type assertion to map[string]interface{} failed”) }

func (j *Json) Array() ([]interface{}, error) { if a, ok := (j.data).([]interface{}); ok { return a, nil } return nil, errors.New(“type assertion to []interface{} failed”) }

func (j *Json) Bool() (bool, error) { if s, ok := (j.data).(bool); ok { return s, nil } return false, errors.New(“type assertion to bool failed”) }

func (j *Json) String() (string, error) { if s, ok := (j.data).(string); ok { return s, nil } return “”, errors.New(“type assertion to string failed”) }

func (j *Json) Bytes() ([]byte, error) { if s, ok := (j.data).(string); ok { return []byte(s), nil } return nil, errors.New(“type assertion to []byte failed”) }

func (j *Json) Int() (int, error) { if f, ok := (j.data).(float64); ok { return int(f), nil }

return -1, errors.New("type assertion to float64 failed")

}

func (j *Json) MustArray(args …[]interface{}) []interface{} { var def []interface{}

switch len(args) {
case 0:
case 1:
    def = args[0]
default:
    log.Panicf("MustArray() received too many arguments %d", len(args))
}

a, err := j.Array()
if err == nil {
    return a
}

return def

}

func (j *Json) MustMap(args …map[string]interface{}) map[string]interface{} { var def map[string]interface{}

switch len(args) {
case 0:
case 1:
    def = args[0]
default:
    log.Panicf("MustMap() received too many arguments %d", len(args))
}

a, err := j.Map()
if err == nil {
    return a
}

return def

}

func (j *Json) MustString(args …string) string { var def string

switch len(args) {
case 0:
case 1:
    def = args[0]
default:
    log.Panicf("MustString() received too many arguments %d", len(args))
}

s, err := j.String()
if err == nil {
    return s
}

return def

}

func (j *Json) MustInt64() int64 { var ret int64 var err error switch v := j.data.(type) { case int: ret = int64(v) case int64: ret = v case float64: ret = int64(v) case string: if ret, err = strconv.ParseInt(v, 10, 64); err != nil { panic(err) } default: ret = 0 //panic(“type assertion to int64 failed”) } return ret }

func (j *Json) MustFloat64() float64 { var ret float64 var err error switch v := j.data.(type) { case int: ret = float64(v) case int64: ret = float64(v) case float64: ret = v case string: v = strings.Replace(v, “,”, “”, -1) if ret, err = strconv.ParseFloat(v, 64); err != nil { panic(err) } default: ret = 0 //panic(“type assertion to float64 failed”) } return ret }

type iBitgo struct { accessKey string secretKey string currency string opCurrency string baseCurrency string secret string secretExpires int64 apiBase string step int64 newRate float64 timeout time.Duration timeLocation *time.Location }

type MapSorter []Item

type Item struct { Key string Val string }

func NewMapSorter(m map[string]string) MapSorter { ms := make(MapSorter, 0, len(m))

for k, v := range m {
    if strings.HasPrefix(k, "!") {
        k = strings.Replace(k, "!", "", -1)
    }
    ms = append(ms, Item{k, v})
}

return ms

}

func (ms MapSorter) Len() int { return len(ms) }

func (ms MapSorter) Less(i, j int) bool { //return ms[i].Val < ms[j].Val // 按值排序 return ms[i].Key < ms[j].Key // 按键排序 }

func (ms MapSorter) Swap(i, j int) { ms[i], ms[j] = ms[j], ms[i] }

func encodeParams(params map[string]string, escape bool) string { ms := NewMapSorter(params) sort.Sort(ms)

v := url.Values{}
for _, item := range ms {
    v.Add(item.Key, item.Val)
}
if escape {
    return v.Encode()
}
var buf bytes.Buffer
keys := make([]string, 0, len(v))
for k := range v {
    keys = append(keys, k)
}
sort.Strings(keys)
for _, k := range keys {
    vs := v[k]
    prefix := k + "="
    for _, v := range vs {
        if buf.Len() > 0 {
            buf.WriteByte('&')
        }
        buf.WriteString(prefix)
        buf.WriteString(v)
    }
}
return buf.String()

}

func newBitgo(accessKey, secretKey string) *iBitgo { s := new(iBitgo) s.accessKey = accessKey s.secretKey = secretKey s.apiBase = “https://www.bitgo.cn” s.timeout = 20 * time.Second s.timeLocation = time.FixedZone(“Asia/Shanghai”, 8*60*60)

return s

}

func (p *iBitgo) apiCall(method string) (*Json, error) { req, err := http.NewRequest(“POST”, fmt.Sprintf(“%s/appApi.html?%s”, p.apiBase, method), nil) if err != nil { return nil, err } req.Header.Set(“Content-Type”, “application/x-www-form-urlencoded”) resp, err := http.DefaultClient.Do(req) if err != nil { return nil, err } defer resp.Body.Close() b, err := ioutil.ReadAll(resp.Body) if err != nil { return nil, err } return NewJson(b) }

func (p *iBitgo) GetTicker(symbol string) (ticker interface{}, err error) { var js *Json js, err = p.apiCall(“action=market&symbol=” + symbol) if err != nil { return } dic := js.Get(“data”) ticker = map[string]interface{}{ “time”: js.Get(“time”).MustInt64(), “buy”: dic.Get(“buy”).MustFloat64(), “sell”: dic.Get(“sell”).MustFloat64(), “last”: dic.Get(“last”).MustFloat64(), “high”: dic.Get(“high”).MustFloat64(), “low”: dic.Get(“low”).MustFloat64(), “vol”: dic.Get(“vol”).MustFloat64(), } return }

func (p *iBitgo) GetDepth(symbol string) (depth interface{}, err error) { var js *Json js, err = p.apiCall(“action=depth&symbol=” + symbol) if err != nil { return } dic := js.Get(“data”)

asks := [][2]float64{}
bids := [][2]float64{}

for _, pair := range dic.Get("asks").MustArray() {
    arr := pair.([]interface{})
    asks = append(asks, [2]float64{toFloat(arr[0]), toFloat(arr[1])})
}

for _, pair := range dic.Get("bids").MustArray() {
    arr := pair.([]interface{})
    bids = append(bids, [2]float64{toFloat(arr[0]), toFloat(arr[1])})
}
depth = map[string]interface{}{
    "time": js.Get("time").MustInt64(),
    "asks": asks,
    "bids": bids,
}
return

}

func (p *iBitgo) GetTrades(symbol string) (trades interface{}, err error) { var js *Json js, err = p.apiCall(“action=trades&symbol=” + symbol) if err != nil { return } dic := js.Get(“data”) items := []map[string]interface{}{} for _, pair := range dic.MustArray() { item := map[string]interface{}{} arr := pair.(map[string]interface{}) item[“id”] = toInt64(arr[“id”]) item[“price”] = toFloat(arr[“price”]) item[“amount”] = toFloat(arr[“amount”]) // trade.Time = toInt64(arr[“time”]) * 1000 if toString(arr[“en_type”]) == “bid” { item[“type”] = “buy” } else { item[“type”] = “sell” } items = append(items, item) } trades = items return }

func (p *iBitgo) GetRecords(step int64, symbol string) (records interface{}, err error) { var js *Json js, err = p.apiCall(fmt.Sprintf(“action=kline&symbol=%s&step=%d”, symbol, step*60)) if err != nil { return } items := []interface{}{} for _, pair := range js.Get(“data”).MustArray() { arr := pair.([]interface{}) if len(arr) < 6 { err = errors.New(“response format error”) return } item := [6]interface{}{} item[0] = toInt64(arr[0]) item[1] = toFloat(arr[1]) item[2] = toFloat(arr[2]) item[3] = toFloat(arr[3]) item[4] = toFloat(arr[4]) item[5] = toFloat(arr[5])

    items = append(items, item)
}
records = items
return

}

func (p *iBitgo) tapiCall(method string, params map[string]string) (js *Json, err error) { if params == nil { params = map[string]string{} } params[“api_key”] = p.accessKey h := md5.New() h.Write([]byte(encodeParams(params, false) + “&secret_key=” + p.secretKey)) params[“sign”] = strings.ToUpper(hex.EncodeToString(h.Sum(nil))) params[“action”] = method qs := encodeParams(params, false)

req, err := http.NewRequest("POST", fmt.Sprintf("%s/appApi.html?%s", p.apiBase, qs), nil)
if err != nil {
    return nil, err
}
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
resp, err := http.DefaultClient.Do(req)
if err != nil {
    return nil, err
}
defer resp.Body.Close()
b, err := ioutil.ReadAll(resp.Body)
if err != nil {
    return nil, err
}
js, err = NewJson(b)
if js != nil {
    if code := js.Get("code").MustInt64(); code != 200 {
        s := js.Get("msg").MustString()
        if s == "" {
            s = fmt.Sprintf("%v", toString(js.data))
        }
        return nil, errors.New(s)
    }
}
return js, err

}

func (p *iBitgo) GetAccount(symbol string) (account interface{}, err error) { var js *Json js, err = p.tapiCall(“userinfo”, nil) if err != nil { return } mp := js.Get(“data”) assets := map[string]map[string]interface{}{} for k := range mp.MustMap() { dic := mp.Get(k) if k == “free” { for c := range dic.MustMap() { if _, ok := assets[c]; !ok { assets[c] = map[string]interface{}{} } assets[c][“currency”] = c assets[c][“free”] = dic.Get©.MustFloat64() } } else if k == “frozen” { for c := range dic.MustMap() { if _, ok := assets[c]; !ok { assets[c] = map[string]interface{}{} } assets[c][“currency”] = c assets[c][“frozen”] = dic.Get©.MustFloat64() } } } accounts := []map[string]interface{}{} for _, pair := range assets { accounts = append(accounts, pair) }

account = accounts
return

}

func (p *iBitgo) Trade(side string, price, amount float64, symbol string) (orderId interface{}, err error) { var js *Json js, err = p.tapiCall(“trade”, map[string]string{ “symbol”: symbol, “type”: side, “price”: float2str(price), “amount”: float2str(amount), }) if err != nil { return } orderId = map[string]int64{“id”: js.Get(“orderId”).MustInt64()} return }

func (p *iBitgo) GetOrders(symbol string) (orders interface{}, err error) { var js *Json js, err = p.tapiCall(“entrust”, map[string]string{“symbol”: symbol}) if err != nil { return } items := []map[string]interface{}{} for _, ele := range js.Get(“data”).MustArray() { mp := ele.(map[string]interface{}) item := map[string]interface{}{} item[“id”] = toInt64(mp[“id”]) item[“amount”] = toFloat(mp[“count”]) if _, ok := mp[“prize”]; ok { item[“price”] = toFloat(mp[“prize”]) } else { item[“price”] = toFloat(mp[“price”]) } item[“deal_amount”] = toFloat(mp[“success_count”])

    if toInt64(mp["type"]) == 0 {
        item["type"] = "buy"
    } else {
        item["type"] = "sell"
    }
    item["status"] = "open"
    items = append(items, item)
}
return items, nil

}

func (p *iBitgo) GetOrder(orderId int64, symbol string) (order interface{}, err error) { var js *Json js, err = p.tapiCall(“order”, map[string]string{“id”: toString(orderId)}) if err != nil { return }

found := false
item := map[string]interface{}{}
for _, ele := range js.Get("data").MustArray() {
    mp := ele.(map[string]interface{})
    if toInt64(mp["id"]) != orderId {
        continue
    }
    item["id"] = toInt64(mp["id"])
    item["amount"] = toFloat(mp["count"])
    if _, ok := mp["prize"]; ok {
        item["price"] = toFloat(mp["prize"])
    } else {
        item["price"] = toFloat(mp["price"])
    }
    item["deal_amount"] = toFloat(mp["success_count"])