Antara muka API yang diperluaskan

FMZ Quant telah membuka antara muka API platform yang diperluaskan untuk menyokong panggilan berprogram ke pelbagai fungsi Platform Dagangan FMZ Quant.

Buat ApiKey

Platform Perdagangan Kuantum FMZ menyokong pengurusan kebenaran diperluaskan antara muka API, dan kebenaranAPI KEYboleh ditetapkan. Pada pilihan API antara muka pada pengaturan akaun (https://www.fmz.com/m/account) halaman platform, klik Buat butang baru ApiKey untuk mencipta sambunganAPI KEY.

Anda boleh mengedit kotak input API Permission apabila membuatAPI KEY, dan masukkan*simbol untuk membolehkan semuaAntara muka API yang diperluaskanjika anda ingin menentukan keizinan antara muka tertentu, anda perlu memasukkan nama fungsi API lanjutan yang sepadan. gunakan koma untuk memisahkan, contohnya:GetRobotDetail,DeleteRobotIni memberi iniAPI KEYizin untuk memanggilDapatkan maklumat terperinci perdagangan langsungantara muka danHapus perdagangan langsung interface.

PeraturanAPI KEYhalaman pengurusan juga membolehkan anda untukmengubah, mematikan, HapusYang diciptakanAPI KEY.

Kod Kembali Antarmuka API yang Terpanjang

Contoh struktur yang dikembalikan oleh antara muka API yang diperluaskan adalah seperti berikut:

    "code":0,
    "data":{
        // ...
    }
}

Peraturancodemedan adalah: Kod status hasil panggilan yang dikembalikan apabila antara muka API lanjutan dipanggil.

Penerangan	Kod
Pelaksanaan yang berjaya	0
KEY API yang salah	1
Tanda tangan yang salah	2
Kesalahan bukan	3
Kaedah yang salah	4
Parameter yang salah	5
Kesalahan dalaman yang tidak diketahui	6

Kod Dagangan Langsung

PeraturanGetRobotListantara muka,GetRobotDetailantara muka, danGetRobotLogsdata pengembalian antara muka dalamstatusmedan untuk: kod status dagangan secara langsung.

• Permulaan biasa

  Status	Kod
  Tidak aktif	0
  Dalam operasi	1
  Berhenti	2
  Ditandatangani keluar	3
  Hentikan	4
  Strategi ini mempunyai kesilapan.	5

• Tidak normal

  Status	Kod
  Strategi telah tamat tempoh, dan sila hubungi penulis untuk membelinya lagi	-1
  Tiada doker dijumpai	-2
  Kesalahan penyusunan strategi	-3
  Perdagangan langsung sudah berjalan	-4
  Saldo yang tidak mencukupi	-5
  Jumlah strategi serentak melebihi had	-6

Cara Pengesahan

Terdapat dua kaedah pengesahan apabila memanggil antara muka API yang dilanjutkan, menyokongtokenpengesahan dan pengesahan langsung.

Pengesahan token

Penggunaanmd5kaedah penyulitan untuk disahkan, contohPython, GolangPanggilan bahasa:

#!/usr/bin/python
# -*- coding: utf-8 -*-
import time
import json
import ssl
ssl._create_default_https_context = ssl._create_unverified_context

try:
    import md5
    import urllib2
    from urllib import urlencode
except:
    import hashlib as md5
    import urllib.request as urllib2
    from urllib.parse import urlencode

accessKey = ''   # your API KEY
secretKey = ''   

def api(method, *args):
    d = {
        'version': '1.0',
        'access_key': accessKey,
        'method': method,
        'args': json.dumps(list(args)),
        'nonce': int(time.time() * 1000),
        }

    d['sign'] = md5.md5(('%s|%s|%s|%d|%s' % (d['version'], d['method'], d['args'], d['nonce'], secretKey)).encode('utf-8')).hexdigest()
    # Note: for the timeout problem of "urllib2.urlopen" function, you can set the timeout time; for example, urllib2.urlopen ('https://www.fmz.com/api/v1', urlencode(d).encode('utf-8'), timeout = 10), that is, set timeout for 10 seconds
    return json.loads(urllib2.urlopen('https://www.fmz.com/api/v1', urlencode(d).encode('utf-8')).read().decode('utf-8'))

# Return the docker list
print(api('GetNodeList'))
# Return the exchange list
print(api('GetPlatformList'))
# GetRobotList(offset, length, robotStatus, label), passing "-1" means obtaining all
print(api('GetRobotList', 0, 5, -1, 'member2'))
# CommandRobot(robotId, cmd) sends command to live trading
print(api('CommandRobot', 123, 'ok'))
# StopRobot(robotId) returns the live trading status code
print(api('StopRobot', 123))  
# RestartRobot(robotId) returns the live trading status code
print(api('RestartRobot', 123))
# GetRobotDetail(robotId) returns detailed live trading information
print(api('GetRobotDetail', 123))

package main

import (
    "fmt"
    "time"
    "encoding/json"
    "crypto/md5"
    "encoding/hex"
    "net/http"
    "io/ioutil"
    "strconv"
    "net/url"
)

// Fill in your own FMZ platform api key
var apiKey string = ""                                  
// Fill in your own FMZ platform secret key
var secretKey string = ""                               
var baseApi string = "https://www.fmz.com/api/v1"

func api(method string, args ... interface{}) (ret interface{}) {
    // Process args
    jsonStr, err := json.Marshal(args)
    if err != nil {
        panic(err)
    }

    params := map[string]string{
        "version" : "1.0", 
        "access_key" : apiKey,
        "method" : method,
        "args" : string(jsonStr),
        "nonce" : strconv.FormatInt(time.Now().UnixNano() / 1e6, 10),
    }    

    data := fmt.Sprintf("%s|%s|%s|%v|%s", params["version"], params["method"], params["args"], params["nonce"], secretKey)
    h := md5.New()
    h.Write([]byte(data))
    sign := h.Sum(nil)

    params["sign"] = hex.EncodeToString(sign)

    // http request 
    client := &http.Client{}

    // request 
    urlValue := url.Values{}
    for k, v := range params {
        urlValue.Add(k, v)
    }
    urlStr := urlValue.Encode()
    request, err := http.NewRequest("GET", baseApi + "?" + urlStr, nil)
    if err != nil {
        panic(err)
    }    

    resp, err := client.Do(request)
    if err != nil {
        panic(err)
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    ret = string(b)
    return 
}

func main() {
    settings := map[string]interface{}{
        "name": "hedge test",
        "strategy": 104150,                      
        // K-line period parameter, "60" means 60 seconds
        "period": 60,                           
        "node" : 73938,                         
        "appid": "member2",                
        "exchanges": []interface{}{
            map[string]interface{}{
                "eid": "Exchange", 
                "label" : "test_bjex", 
                "pair": "BTC_USDT", 
                "meta" : map[string]interface{}{
                    // Fill in the access key
                    "AccessKey": "",                                
                    // Fill in the secret key
                    "SecretKey": "",                                
                    "Front" : "http://127.0.0.1:6666/exchange",
                },
            },
        },
    }

    method := "RestartRobot"
    fmt.Println("Call interface:", method)
    ret := api(method, 124577, settings)
    fmt.Println("main ret:", ret)
}

Pengesahan Langsung

Ia menyokong pengesahantoken(mengalir)secret_keyanda boleh menjana URL yang boleh diakses secara langsung. contohnya, URL yang secara langsung memberikan arahan interaktif untuk perdagangan langsung, yang boleh digunakan untukTradingViewatauWebHookpanggilan balik dalam kes lain.CommandRobot(RobotId, Cmd)fungsi, parameternoncetidak memerlukan pengesahan, dan kekerapan akses dan masa lawatan antara muka tidak terhad.

Sebagai contoh,AccessKeydari sambungan yang diciptaAPI KEYialah:xxxdanSecretKeyialah:yyy. Lihat pautan berikut untuk menghantar mesej arahan interaktif ke perdagangan langsung dengan ID perdagangan langsung186515, mesej content adalah rentetan:"ok12345".

https://www.fmz.com/api/v1?access_key=xxx&secret_key=yyy&method=CommandRobot&args=[186515,"ok12345"]

Di bawah keadaan bahawa pengesahan langsung disokong, HanyaCommandRobotantara muka disokong untuk mendapatkanBodydata dalam permintaan. Sebagai contoh, tetapan dalamWebHook URLdaripadaTradingView:

https://www.fmz.com/api/v1?access_key=xxx&secret_key=yyy&method=CommandRobot&args=[186515,+""]

Berhati-hati untuk menetapkan mengikut format berikut:args=[130350,+""], di mana130350adalah perdagangan secara langsungIDdari Platform Dagangan Kuantum FMZ.

Tetapkan dalam kotak mesejTrading View(yang diminta Badan data yang akan dihantar):

• Format JSON:

  https://www.fmz.com

  {"close": {{close}}, "name": "aaa"}
  

  Perdagangan langsung denganIDdaripada186515boleh menerima rentetan arahan interaktif:{"close": 39773.75, "name": "aaa"}.

• Format teks:

  https://www.fmz.com

  BTCUSDTPERP Crossing 39700.00 close: {{close}}
  

  Perdagangan langsung denganIDdaripada186515boleh menerima rentetan arahan interaktif:BTCUSDTPERP Crossing 39700.00 close: 39739.4.

ContohPython & GolangPanggilan bahasa:

#!/usr/bin/python
# -*- coding: utf-8 -*-

import json
import ssl

ssl._create_default_https_context = ssl._create_unverified_context

try:
    import urllib2
except:
    import urllib.request as urllib2

accessKey = 'your accessKey'
secretKey = 'your secretKey'

def api(method, *args):
    return json.loads(urllib2.urlopen(('https://www.fmz.com/api/v1?access_key=%s&secret_key=%s&method=%s&args=%s' % (accessKey, secretKey, method, json.dumps(list(args)))).replace(' ', '')).read().decode('utf-8'))

# If APIKEY does not have the interface permission, the call to
print(api('RestartRobot', 186515)) will fail, and the returned data
is: {'code': 4, 'data': None}
# print(api('RestartRobot', 186515))

# Printed Id: the live trading details of 186515
print(api('GetRobotDetail', 186515))  

package main

import (
    "fmt"
    "encoding/json"
    "net/http"
    "io/ioutil"
    "net/url"
)

// Fill in your own FMZ platform api key
var apiKey string = "your access_key"

// Fill in your own FMZ platform secret key
var secretKey string = "your secret_key"
var baseApi string = "https://www.fmz.com/api/v1"

func api(method string, args ... interface{}) (ret interface{}) {
    jsonStr, err := json.Marshal(args)
    if err != nil {
        panic(err)
    }
    
    params := map[string]string{
        "access_key" : apiKey,
        "secret_key" : secretKey,
        "method" : method,
        "args" : string(jsonStr),
    }    

    // http request 
    client := &http.Client{}

    // request 
    urlValue := url.Values{}
    for k, v := range params {
        urlValue.Add(k, v)
    }
    urlStr := urlValue.Encode()
    request, err := http.NewRequest("GET", baseApi + "?" + urlStr, nil)
    if err != nil {
        panic(err)
    }    

    resp, err := client.Do(request)
    if err != nil {
        panic(err)
    }

    defer resp.Body.Close()

    b, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    ret = string(b)
    return 
}

func main() {
    method := "GetRobotDetail"
    fmt.Println("Call interface:", method)
    ret := api(method, 186515)
    fmt.Println("main ret:", ret)
}

Gunakan API lanjutan di FMZ Quant untuk merealisasikan amaran TradingView Perdagangan isyarat

Penjelasan Antara muka API Terpanjang

• Antara muka API diperluaskan Platform Dagangan Kuantum FMZ Tambahkan parameter pertanyaan (dipecah oleh?) permohonan itu selepashttps://www.fmz.com/api/v1. Berikut adalah parameter permintaan yang dinyatakan menggunakanPython:

  {
      "version"   : "1.0",
      "access_key": "xxx",
      "method"    : "GetNodeList",
      "args"      : [],
      "nonce"     : 1516292399361,
      "sign"      : "085b63456c93hfb243a757366600f9c2"
  }
  

  Lapangan	Arahan
  versi	Nombor versi.
  access_key	AccessKey, memohonnya di halaman pengurusan akaun.
  kaedah	Kaedah panggilan tertentu.
  args	Senarai parameter kaedah tertentu dipanggil.
  bukan	Stempel masa, dalam milidetik, membenarkan kesilapan 1 jam dari stempel masa standard. Nonce mesti lebih besar daripada nilai nonce akses terakhir.
  tanda	Signature.

  Setiap nama parameter dipisahkan oleh watak&, dan nama parameter dan nilai yang berkaitan dengan simbol=. URL permintaan lengkap (mengambilmethod=GetNodeListsebagai contoh):

  https://www.fmz.com/api/v1?access_key=xxx&nonce=1516292399361&args=%5B%5D&sign=085b63456c93hfb243a757366600f9c2&version=1.0&method=GetNodeList
  

  Perhatikan bahawa tidak adasecret_keyparameter antara parameter permintaan.

• Kaedah tandatangan Peraturansignparameter dalam parameter permintaan disulitkan seperti berikut, mengikut format:

  version + "|" + method + "|" + args + "|" + nonce + "|" + secretKey
  

  Selepas menyambung tali, gunakanMD5algoritma penyulitan untuk menyulitkan rentetan dan menukarnya kepada nilai rentetan data hexadecimal, dirujuk kepada nilai parametersignUntuk bahagian tandatangan, lihatPythonAntara muka API pelanjutan kodCara Pengesahan :

  # Parameter
  d = {
      'version': '1.0',
      'access_key': accessKey,
      'method': method,
      'args': json.dumps(list(args)),
      'nonce': int(time.time() * 1000),
  }
  
  # Calculate "sign" signature
  d['sign'] = md5.md5(('%s|%s|%s|%d|%s' % (d['version'], d['method'], d['args'], d['nonce'], secretKey)).encode('utf-8')).hexdigest()
  

• Kesalahan perkhidmatan antara muka:

  • Parameter yang tidak mencukupi:

    {
        "code":0,
        "data":{
            "result":null,
            "error":"Params length incorrect"
        }
    }
    

GetNodeList

PeraturanGetNodeListkaedah digunakan untuk mendapatkan senarai pelabuhan di bawah akaun Platform Dagangan Kuantum FMZ yang sepadan denganAPI KEYdalam permintaan.

{
    "code": 0,
    "data": {
        "result": {
            "all": 1,
            "nodes": [{
                "build": "3.7",
                "city": "...",
                "created": "2024-11-08 09:21:08",
                "date": "2024-11-08 16:37:16",
                "forward": "...",
                "guid": "...",
                "host": "node.fmz.com:9902",
                "id": 123,
                "ip": "...",
                "is_owner": true,
                "loaded": 0,
                "name": "MacBook-Pro-2.local",
                "online": true,
                "os": "darwin/amd64",
                "peer": "...",
                "public": 0,
                "region": "...",
                "tunnel": false,
                "version": "...",
                "wd": 0
            }]
        },
        "error": null
    }
}

Penerangan bidang nilai yang dikembalikan (makna harfiah adalah jelas dan tidak akan diulangi):

• semua: Jumlah pelabuhan yang dikaitkan dengan akaun semasa.
• nodes: Mencatatkan butiran nod doker.
  • bina: nombor versi.
  • Bandar: Bandar di mana anda mencari.
  • is_owner: benar menunjukkan dok peribadi, salah menunjukkan dok awam.
  • dimuat: Muat, bilangan contoh strategi.
  • awam: 0 menunjukkan pelabuhan peribadi, 1 menunjukkan pelabuhan awam.
  • rantau: Lokasi geografi.
  • Versi: Maklumat versi terperinci dari docker.
  • wd: Sama ada untuk mengaktifkan penggera luar talian, 0 bermaksud tidak diaktifkan. Docker penyebaran satu klik mengandungi beberapa maklumat tambahan. medan bermula dengan awalanecs_danunit_, yang merakam maklumat yang relevan pelayan docker penyebaran satu klik (nama pengendali, konfigurasi, status, dll.), kitaran bil, harga dan maklumat lain, yang tidak akan diulangi di sini.

Tiada parameter

GetRobotGroupList

GetRobotGroupList()Mengembalikan senarai kumpulan dagangan langsung daripada akaun Platform Dagangan Kuantum FMZ yang sepadan denganAPI KEYdalam permintaan.

{
    "code": 0,
    "data": {
        "result": {
            "items": [{
                "id": 3417,
                "name": "Test"
            }, {
                "id": 3608,
                "name": "Live trading demo"
            }]
        },
        "error": null
    }
}

• Item: Maklumat pengelompokan dagangan langsung.
  • id: Kumpulan dagangan langsung Id.
  • Nama: Nama kumpulan perdagangan langsung. Peraturanitemsdefault kumpulan tidak dalamitems.

Tiada parameter

GetPlatformList

GetPlatformList()mengembalikan senarai bursa yang mempunyai telah ditambahkan oleh akaun Platform Dagangan Kuantum FMZ yang sepadan kepadaAPI KEYdalam permintaan.

{
    "code": 0,
    "data": {
        "result": {
            "all": 2,
            "platforms": [{
                "category": "加密货币||Crypto",
                "date": "2023-12-07 13:44:52",
                "eid": "Binance",
                "id": 123,
                "label": "Binance",
                "logo": "...",
                "name": "币安现货|Binance",
                "stocks": ["BTC_USDT", "LTC_USDT", "ETH_USDT", "ETC_USDT", "BTC_TUSD", "ETH_TUSD", "BNB_TUSD"],
                "website": "..."
            }, {
                "category": "通用协议|Custom Protocol",
                "date": "2020-11-09 11:23:48",
                "eid": "Exchange",
                "id": 123,
                "label": "XX Exchange REST Protocol",
                "logo": "...",
                "name": "通用协议|Custom Protocol",
                "stocks": ["BTC_USDT", "ETH_USDT"],
                "website": ""
            }]
        },
        "error": null
    }
}

• semua: Bilangan objek pertukaran yang ditambah/dikonfigurasikan.
• Platform: Maklumat yang berkaitan dengan pertukaran.
  • eid: ID bursa di Platform Dagangan Kuantum FMZ,eidakan digunakan dalam beberapa konfigurasi dan parameter.

Tiada parameter

GetRobotList

PeraturanGetRobotListkaedah digunakan untuk mendapatkan senarai hidup perdagangan di bawah akaun Platform Dagangan Kuantum FMZ yang sepadan denganAPI KEYdalam permintaan.

{
    "code": 0,
    "data": {
        "result": {
            "all": 1,
            "concurrent": 0,
            "robots": [{
                "charge_time": 1731654846,
                "date": "2024-11-12 14:05:29",
                "end_time": "2024-11-15 14:56:32",
                "fixed_id": 4509153,
                "id": 591026,
                "is_sandbox": 0,
                "name": "test",
                "node_guid": "45891bcf3d57f99b08a43dff76ee1ea1",
                "node_id": 4519153,
                "node_public": 0,
                "profit": 0,
                "public": 0,
                "refresh": 1731651257000,
                "start_time": "2024-11-15 14:56:30",
                "status": 3,
                "strategy_id": 411670,
                "strategy_isowner": true,
                "strategy_language": 0,
                "strategy_name": "test",
                "strategy_public": 0,
                "uid": "105ed6e511cc977921610fdbb7e2a1d6",
                "wd": 0
            }]
        },
        "error": null
    }
}

• robot: Maklumat perdagangan langsung
  • group_id: ID kumpulan perdagangan langsung. Jika strategi perdagangan langsung berada dalam kumpulan lalai, tidak adagroup_id field.

Tetapan penyesuaian permintaan panggilan. penyesuaian palsu nombor Tetapan panjang pertanyaan pelayaran. panjang palsu nombor Tentukan status perdagangan langsung yang akan ditanyakan, merujuk kepada antara muka API yang diperluaskanKod Dagangan Langsung, lulus-1untuk mendapatkan semua dagangan hidup. robotStatus palsu nombor Tentukan label tersuai dagangan langsung yang anda ingin query, dan anda boleh menapis semua dagangan langsung label ini. label palsu senar Cari kata kunci. Kata kunci palsu senar

AmbilPythonlanguages diperluaskan antara muka APICara Pengesahansebagai contoh:print(api('GetRobotList'))Dapatkan semua maklumat perdagangan secara langsung.print(api('GetRobotList', 'member2')): cetak maklumat semua perdagangan langsung dengan ahli label tersuai2.print(api('GetRobotList', 0, 5, -1, 'member2')): halaman dari 0 hingga 5 dan menyenaraikan sehingga 5 robot yang dilabel dengan member2.

CommandRobot

PeraturanCommandRobotkaedah digunakan untuk menghantar interaksi perintah kepada dagangan langsung di bawah Platform Dagangan Kuantum FMZ akaun yang sepadan denganAPI KEYdalam permintaan. daripada perdagangan hidup menerima arahan interaksi adalah hidup ID dagangan yang ditentukan olehrobotIdparameter, dan perintah interaksi dikembalikan olehGetCommand()fungsi dipanggil dalam strategi untuk menangkapnya.

{
    "code":0,
    "data":{
        "result":true,
        "error":null
    }
}

• Hasil: Sama ada perintah interaktif dihantar dengan berjaya; apabila menghantar perintah kepada perdagangan langsung yang tidak berjalan, hasilnya dalam data yang dikembalikan adalah salah.

ParameterrobotIddigunakan untuk menentukan ID perdagangan langsung yang menerima arahan interaktif. KesemuaGetRobotListkaedah untuk mendapatkan maklumat yang hidup perdagangan di bawah akaun, yang mengandungi ID dagangan langsung.

robotId betul nombor Parametercmdadalah perintah interaktif yang dihantar kepada bot; perintah akan ditangkap oleh fungsiGetCommand()Untuk pelaksanaan khusus logik interaksi dalam kod strategi, sila rujukGetCommand()fungsi dalamFMZ Quant Trading Platform API Manual.

cmd betul senar

Strategi perdagangan langsung, dengan andaian bahawa strategi ini beroperasi, ID perdagangan langsung adalah 123:

function main() {
    while (true) {
        var cmd = GetCommand()
        if (cmd) {
            Log(cmd)
        }
        Sleep(2000)
    }
}

Jika kita menggunakan skrip ujian Python dalam bab ini, mengakses API lanjutan Platform Dagangan Kuantum FMZ:api("CommandRobot", 123, "test command")Perdagangan langsung dengan ID 123 akan menerima arahan interaktif:test command, dan kemudian mencetak ia keluar melalui log output fungsi.

StopRobot

StopRobot(RobotId)digunakan untuk memintaAPI KEYyang sepadan dengan dagangan langsung FMZ Quant Trading akaun platform. id perdagangan hidup untuk berhenti berjalan adalah hidup ID dagangan yang ditentukan olehrobotId parameter.

{
    "code":0,
    "data":{
        "result":2,
        "error":null
    }
}

• Hasil: Kod status dagangan langsung adalah 2, yang bermaksud berhenti.

ParameterrobotIddigunakan untuk menentukan ID anda boleh menggunakanGetRobotListkaedah untuk mendapatkan maklumat perdagangan langsung di bawah akaun, yang mengandungi ID dagangan langsung.

robotId betul nombor

Mulakan semulaRobot

PeraturanRestartRobotkaedah ini digunakan untuk memulakan semula perdagangan langsung di bawahAPI KEYID perdagangan langsung yang dimulakan semula adalah ID perdagangan langsung yang ditentukan olehrobotId parameter.

{
    "code":0,
    "data":{
        "result":1,
        "error":null
    }
}

• Hasil: Kod status dagangan langsung, 1 bermaksud berjalan.

PeraturanrobotIdParameter digunakan untuk menentukan Id Perdagangan langsung akan dimulakan semula.GetRobotListkaedah untuk mendapatkan maklumat perdagangan langsung di bawah akaun, yang mengandungi ID dagangan langsung.

robotId betul nombor Parameter konfigurasi dagangan langsung, parametersettingsformat adalah seperti berikut:

{
    "appid":"test",
    "args":[],
    "exchanges":[
        {"pair":"SOL_USDT","pid":123},
        {"pair":"ETH_USDT","pid":456}
    ],
    "name":"test",
    "node":123,
    "period":60,
    "strategy":123
}

• appid: Lapangan tersuai Tag boleh ditentukan.
• args: Tetapan parameter strategi Struktur adalah array, setiap elemen adalah parameter.Interval, dan anda mahu menetapkanIntervalkepada 500 apabila memulakan semula strategi, makaargsmengandungi:["Interval", 500], iaitu:"args": [["Interval", 500]].
• Bursa: Konfigurasi objek bursa untuk mengikat perdagangan langsung Struktur adalah array, di mana setiap elemen adalah konfigurasi objek pertukaran.
  • Ia boleh mengikat kepada objek pertukaran yang telah dikonfigurasi pada platform Maksudnya, gunakanpidkonfigurasi:{"pair":"SOL_USDT","pid":123}; pidboleh ditanyakan melaluiGetPlatformListantara muka, danidmedan dalam data yang dikembalikan adalah pertukaranpid.
  • Kita boleh terus lulus dalam maklumat konfigurasi dan mengikat objek pertukaran Maksudnya, gunakaneidkonfigurasi:{"eid":"Huobi","label":"test Huobi","meta":{"AccessKey":"123","SecretKey":"123"},"pair":"BCH_BTC"}; maklumat sensitif sepertiAPI KEYJika jenis konfigurasi ini digunakan, maklumat mesti dikonfigurasi setiap kali perdagangan langsung dibuat atau dimulakan semula.
  • Ia boleh mengikatProtokol kastamobjek pertukaran Ia boleh lulus dalam maklumat konfigurasi:{"eid":"Exchange","label":"test exchange","pair":"BTC_USDT","meta":{"AccessKey":"123","SecretKey":"123","Front":"http://127.0.0.1:6666/test"}}. labelatribut adalah untuk menetapkan label untuk objek pertukaran diakses oleh yang semasaProtokol kastam, yang boleh diperolehi olehexchange.GetLabel()fungsi dalam strategi.
• Nama: Nama Strategi
• simpul: Docker ID Menentukan yang docker untuk dijalankan pada. Jika sifat ini tidak ditetapkan, docker akan ditetapkan untuk dijalankan secara automatik.
• Tempoh: Tempoh K-line lalai Parameter tempoh garis K, 60 bermaksud 60 saat.
• strategi: ID Strategi Ia boleh diperolehi dengan menggunakanGetStrategyList method.

tetapan palsu Objek JSON

Jika perdagangan langsung dicipta oleh API yang dilanjutkan, API yang dilanjutkanRestartRobot (RobotId, Settings)mesti digunakan untuk memulakan semula, dansettingsParameter mesti dilewatkan. Perdagangan langsung yang dicipta di halaman platform boleh dimulakan semula melalui API yang diperluaskan atau dengan mengklik butang di halaman.settingsJika anda hanya lulus parameterRobotIdparameter, mulakan perdagangan langsung mengikut tetapan perdagangan langsung semasa.

GetRobotDetail

PeraturanGetRobotDetailkaedah ini digunakan untuk mendapatkan butiran perdagangan langsung di bawah akaun Platform Dagangan Kuantum FMZ yang sepadan denganAPI KEYID dagangan langsung yang akan diambil adalah ID dagangan langsung yang ditentukan olehrobotId parameter.

{
    "code": 0,
    "data": {
        "result": {
            "robot": {
                "charge_time": 1732246539,
                "charged": 5850000,
                "consumed": 5375000000,
                "date": "2018-12-28 14:34:51",
                "favorite": {
                    "added": false,
                    "type": "R"
                },
                "fixed_id": 123,
                "hits": 1,
                "id": 123,
                "is_deleted": 0,
                "is_manager": true,
                "is_sandbox": 0,
                "name": "test",
                "node_id": 123,
                "pexchanges": {
                    "123": "Futures_OKCoin"
                },
                "phash": {
                    "123": "ca1aca74b9cf7d8624f2af2dac01e36d"
                },
                "plabels": {
                    "123": "OKEX futures V5"
                },
                "priority": 0,
                "profit": 0,
                "public": 0,
                "refresh": 1732244453000,
                "robot_args": "[]",
                "start_time": "2024-11-22 11:00:48",
                "status": 1,
                "strategy_args": "[]",
                "strategy_exchange_pairs": "[60,[123],[\"ETH_USDT\"]]",
                "strategy_id": 123,
                "strategy_last_modified": "2024-11-21 16:49:25",
                "strategy_name": "test",
                "strategy_public": "0",
                "uid": "105ed6e51bcc17792a610fdbb7e2a1d6",
                "username": "abc",
                "wd": 0
            }
        },
        "error": null
    }
}

• charge_time: Masa potongan seterusnya adalah masa tamat tempoh yang berkesan selepas potongan semasa.
• dicas: masa yang telah digunakan.
• digunakan: Jumlah yang digunakan (0.125 USD = 12500000 / 1e8).
• tarikh: tarikh penciptaan.
• fixed_id: ID docker yang diberikan apabila perdagangan langsung sedang berjalan. Jika ia automatik, nilainya adalah -1.
• is_manager: Sama ada anda mempunyai kuasa untuk menguruskan perdagangan langsung ini.
• is_sandbox: Sama ada ia adalah perdagangan simulasi.
• Nama: Nama perdagangan langsung.
• node_id: Docker ID.
• pexchanges: Objek pertukaran perdagangan langsung, 123 adalah pid, dan Futures_OKCoin adalah nama pertukaran.
• plabels: Maklumat tag objek pertukaran yang dikonfigurasikan dalam perdagangan langsung.
• keuntungan: data keuntungan dagangan langsung.
• awam: sama ada perdagangan langsung adalah awam.
• refresh: masa aktif terakhir.
• strategi_exchange_pairs: Objek pertukaran yang dikonfigurasi, set maklumat pasangan dagangan.
• wd: Sama ada untuk mengaktifkan penggera luar talian.

PeraturanrobotIdParameter digunakan untuk menentukan ID perdagangan langsung yang butir-butirnya akan diperoleh.GetRobotListkaedah untuk mendapatkan maklumat mengenai dagangan langsung di bawah akaun, yang mengandungi ID dagangan langsung.

robotId betul nombor

Penerangan atributstrategy_exchange_pairs, mengambil data berikut sebagai contoh:

"[60,[44314,42960,15445,14703],[\"BTC_USDT\",\"BTC_USDT\",\"ETH_USDT\",\"ETH_USDT\"]]"

Data pertama60mewakili set tempoh garis K lalai dengan perdagangan langsung adalah 1 minit, iaitu 60 saat.

[44314,42960,15445,14703]adalah objek pertukaranpidyang dikonfigurasi untuk perdagangan langsung (mengikut perintah penambahan).

[\"BTC_USDT\",\"BTC_USDT\",\"ETH_USDT\",\"ETH_USDT\"]Adakah Set pasangan dagangan untuk objek pertukaran yang dikonfigurasi oleh live perdagangan (dalam urutan penjumlahan dan dalam surat-menyurat satu ke satu denganpid).

DapatkanAkaun

PeraturanGetAccountkaedah digunakan untuk memperoleh maklumat akaun yang sepadan denganAPI KEYdalam permintaan akaun Platform Dagangan Kuantum FMZ.

{
    "code":0,
    "data":{
        "result":{
            "balance":22944702436,
            "concurrent":0,
            "consumed":211092719653,
            "currency":"USD",
            "email":"123@qq.com",
            "openai":false,
            "settings":null,
            "sns":{"wechat":true},
            "uid":"105ea6e51bcc177926a10fdbb7e2a1d6",
            "username":"abc"
        },
        "error":null
    }
}

• baki: baki akaun Nilai di sini adalah bilangan bulat kerana kawalan ketepatan. Untuk menukarnya kepada nilai sebenar, anda perlu membahagikannya dengan 1e8 (iaitu 10 pangkat ke-8). Nilai sebenar di sini adalah: 229.44702436

GetExchangeList

PeraturanGetExchangeListkaedah ini digunakan untuk memperoleh senarai bursa dan maklumat konfigurasi yang diperlukan yang disokong oleh Platform Dagangan Kuantum FMZ.

ApabilaisSummaryparameter ialahfalse, data yang dikembalikan ialah:

{
    "code": 0,
    "data": {
        "result": {
            "exchanges": [{
                "category": "加密货币||Crypto",
                "eid": "Futures_Binance",
                "id": 74,
                "logo": "/upload/asset/d8d84b23e573e9326b99.svg",
                "meta": "[{\"desc\": \"Access Key\", \"qr\":\"apiKey\",\"required\": true, \"type\": \"string\", \"name\": \"AccessKey\", \"label\": \"Access Key\"}, {\"encrypt\": true, \"qr\":\"secretKey\",\"name\": \"SecretKey\", \"required\": true, \"label\": \"Secret Key\", \"type\": \"password\", \"desc\": \"Secret Key\"}]",
                "name": "币安期货|Futures_Binance",
                "priority": 200,
                "stocks": "BTC_USDT,ETH_USDT,ETH_USD",
                "website": "https://accounts.binance.com/zh-TC/register?ref=45110270"
            }]
        },
        "error": null
    }
}

ApabilaisSummaryparameter ialahtrue, data yang dikembalikan ialah:

{
    "code": 0,
    "data": {
        "result": {
            "exchanges": [{
                "category": "加密货币||Crypto",
                "eid": "Futures_Binance",
                "id": 74,
                "logo": "/upload/asset/d8d84b23e573e9326b99.svg",
                "name": "币安期货|Futures_Binance",
                "priority": 200,
                "website": "https://accounts.binance.com/zh-TC/register?ref=45110270"
            }]
        },
        "error": null
    }
}

• meta: Bertukar metadata konfigurasi.

PeraturanisSummaryParameter digunakan untuk menentukan sama ada data yang dikembalikan adalah maklumat ringkasan.

isSimpul betul bool

DeleteNode

PeraturanDeleteNode(Nid)kaedah digunakan untuk memadam nod docker yang sepadan denganAPI KEYdalam permintaan akaun Platform Dagangan Kuantum FMZ. ID nod dok yang dipadamkan adalah ID dok yang ditentukan olehnid parameter.

{
    "code":0,
    "data":{
        "result":true,
        "error":null
    }
}

• Hasil: Sama ada program docker yang berkaitan dipadamkan dengan berjaya.

Peraturannidparameter digunakan untuk menentukan ID docker yang akan dipadam.GetNodeListkaedah untuk mendapatkan maklumat mengenai pelabuhan akaun.

tidak betul nombor

HapusRobot

PeraturanDeleteRobot(RobotId, DeleteLogs)kaedah digunakan untuk memadamkan perdagangan langsung yang sepadan denganAPI KEYdalam permintaan di bawah akaun Platform Dagangan Kuantum FMZ. ID dagangan langsung yang dipadamkan adalah ID dagangan langsung yang ditentukan olehrobotId parameter.

{
    "code":0,
    "data":{
        "result":0,
        "error":null
    }
}

• Hasil: Hasil maklum balas operasi penghapusan dagangan langsung. 0: Hapus secara normal. -2: Penghapusan berjaya, tetapi docker yang berkaitan dengan perdagangan langsung tidak dapat dihubungi. Sila hapus fail 123.db3 secara manual!

ParameterrobotIddigunakan untuk menentukan ID anda boleh menggunakanGetRobotListkaedah untuk mendapatkan maklumat perdagangan langsung di bawah akaun, yang mengandungi ID dagangan langsung.

robotId betul nombor PeraturandeleteLogsParameter digunakan untuk menetapkan sama ada untuk memadamkan log dagangan langsung, jika lulus nilai yang benar (contohnya:true), log dagangan langsung dihapuskan.

deleteLogs betul bool

GetStrategyList

PeraturanGetStrategyListkaedah digunakan untuk mendapatkan maklumat strategi platform.

{
    "code": 0,
    "data": {
        "result": {
            "all": 123,
            "strategies": [{
                "category": 9,
                "date": "2024-11-10 20:40:04",
                "description": "",
                "forked": 0,
                "hits": 0,
                "id": 123,
                "is_buy": false,
                "is_owner": false,
                "language": 2,
                "last_modified": "2024-11-11 17:23:52",
                "name": "HedgeGridStrategy",
                "profile": {
                    "avatar": "...",
                    "nickname": "abc",
                    "uid": "4ed225440db1eda23fe05ed10184113e"
                },
                "public": 0,
                "tags": "",
                "uid": "4ed225440db1eda23fe05ed10184113e",
                "username": "abc"
            }]
        },
        "error": null
    }
}

• semua: Jumlah keseluruhan strategi yang ditemui oleh pertanyaan penapis.
• strategi: Maklumat strategi khusus ditanyakan.

PeraturanoffsetParameter digunakan untuk menetapkan offset semasa pertanyaan.

penyesuaian betul nombor Peraturanlengthparameter digunakan untuk menetapkan panjang pertanyaan.

panjang betul nombor PeraturanstrategyTypeparameter digunakan untuk menetapkan jenis strategi yang akan ditanyakan.

• strategyTypetetapan parameter0: semua strategi.
• strategyTypetetapan parameter1: Strategi adalah awam.
• strategyTypetetapan parameter2: strategi yang perlu disemak semula.

strategiJenis betul nombor PeraturancategoryParameter digunakan untuk menetapkan kategori strategi yang akan ditanyakan.

• categorytetapan parameter-1: semua strategi.
• categorytetapan parameter0Strategi khusus.

kategori betul nombor PeraturanneedArgsparameter digunakan untuk menetapkan sama ada strategi yang akan ditanyakan mempunyai parameter.

• needArgstetapan parameter0: semua strategi.

perluArgs betul nombor Peraturanlanguageparameter digunakan untuk menetapkan bahasa pengaturcaraan strategi yang akan ditanyakan.

• languagetetapan parameter0: Bahasa JavaScript.
• languagetetapan parameter1: Bahasa Python.
• languagetetapan parameter2: Bahasa C ++.
• languagetetapan parameter3: Strategi visualisasi.
• languagetetapan parameter4Bahasa saya.
• languagetetapan parameter5: Bahasa PINE.

Bahasa betul nombor Peraturankwparameter digunakan untuk menetapkan kata kunci strategi yang akan ditanyakan.

• Menetapkan rentetan kosong bermakna tiada penapisan kata kunci digunakan.

kw betul senar

NewRobot

PeraturanNewRobotkaedah digunakan untuk membuat perdagangan langsung di bawahAPI KEYyang sepadan dengan akaun Platform Dagangan Kuantum FMZ dalam permintaan.

{
    "code":0,
    "data":{
        "result":591988,
        "error":null
    }
}

• Hasil: Penciptaan berjaya dan ID dagangan langsung dikembalikan.

Parameter konfigurasi dagangan langsung,settingsformat parameter adalah seperti berikut:

{
    "appid":"test",
    "args":[],
    "exchanges":[
        {"pair":"SOL_USDT","pid":123}
    ],
    "group":123,
    "name":"test",
    "node":123,
    "period":60,
    "strategy":123
}

• Kumpulan: Tentukan kumpulan perdagangan langsung.
• args: Parameter strategi, atau array kosong jika strategi tidak mempunyai parameter.
• pertukaran: Untuk konfigurasi objek pertukaran, sila rujukRestartRobot interface.

tetapan betul Objek JSON

Dalam konfigurasieiddalamsettingsparameter,"meta":{"AccessKey": "123", "SecretKey": "123"}maklumat sensitif ini tidak disimpan oleh Platform Dagangan Kuantum FMZ. Data ini dihantar terus ke program doker, jadi maklumat ini mesti dikonfigurasi setiap kali perdagangan langsung dibuat atau dimulakan semula.

Jika kita mencipta objek pertukaran perdagangan hidup menggunakan protokol tersuai, apabila mengkonfigurasisettingsparameter, kita boleh menggunakan tetapan berikut untukexchangesatribut:

{
    "eid": "Exchange",
    "label": "test",
    "pair": "ETH_BTC",
    "meta": {
        "AccessKey": "123",
        "SecretKey": "123",
        "Front": "http://127.0.0.1:6666/test"
    }
}

labelatribut adalah untuk menetapkan label untuk objek pertukaran diakses oleh protokol tersuai semasa, yang boleh diperoleh olehexchange.GetLabel()fungsi dalam strategi.

PluginRun

PeraturanPluginRunkaedah digunakan untuk memanggilalat debugfungsi Platform Dagangan Quant FMZ; Hanya bahasa JavaScript yang disokong.

{
    "code": 0,
    "data": {
        "result": "{\"logs\":[{\"PlatformId\":\"\",\"OrderId\":\"0\",\"LogType\":5,\"Price\":0,\"Amount\":0,\"Extra\":\"Hello FMZ\",\"Currency\":\"\",\"Instrument\":\"\",\"Direction\":\"\",\"Time\":1732267473108}],\"result\":\"\"}",
        "error": null
    }
}

• hasil: Alat debugging mengembalikan data hasil ujian selepas menjalankan kod JavaScript yang dilewatkan dengan berjaya.

Parameter tetapan dalam alat debugging,settingskonfigurasi, termasuk kod ujian dalamsourceAtribut.settingsFormat parameter adalah seperti berikut:

{
    "exchanges":[{"pair":"SOL_USDT","pid":123}],
    "node":123,
    "period":60,
    "source":"function main() {Log(\"Hello FMZ\")}"
}

• sumber: Kod yang memerlukan debugging.
• node: Docker ID, anda boleh menentukan yang docker untuk menjalankan perdagangan hidup pada. jika nilai adalah -1, ia bermakna peruntukan automatik.
• pertukaran: Untuk konfigurasi objek pertukaran, sila rujukRestartRobot interface.

tetapan betul Objek JSON

{"eid": "OKEX", "pair": "ETH_BTC", "meta" :{"AccessKey": "123", "SecretKey": "123"}} {"eid": "Huobi", "pair": "BCH_BTC", "meta" :{"AccessKey": "123", "SecretKey": "123"}}

Untukexchangesatribut dalamsettings, hanya satu perlu ditetapkan apabila memanggilPluginRunmethod (hanya satu objek pertukaran disokong apabila digunakan dalam halaman alat debug). Tiada kesilapan akan dilaporkan apabila anda menetapkan 2 objek pertukaran dalamsettings, tetapi kesilapan akan dilaporkan apabila objek pertukaran kedua diakses dalam kod.

GetRobotLogs

PeraturanGetRobotLogskaedah digunakan untuk mendapatkan maklumat log perdagangan langsung di bawah akaun Platform Dagangan Kuantum FMZ yang sepadan denganAPI KEYID platform dagangan langsung yang akan diperolehi adalah ID platform dagangan langsung yang ditentukan olehrobotId parameter.

{
    "code": 0,
    "data": {
        "result": {
            "chart": "",
            "chartTime": 0,
            "logs": [{
                "Total": 20,
                "Max": 20,
                "Min": 1,
                "Arr": []
            }, {
                "Total": 0,
                "Max": 0,
                "Min": 0,
                "Arr": []
            }, {
                "Total": 0,
                "Max": 0,
                "Min": 0,
                "Arr": []
            }],
            "node_id": 123,
            "online": true,
            "refresh": 1732201544000,
            "status": 4,
            "summary": "...",
            "updateTime": 1732201532636,
            "wd": 0
        },
        "error": null
    }
}

• log: Maklumat log: Beberapa item data log terdapat dalam medan Arr. Struktur data pertama dalam log adalah rekod log dalam jadual log strategi dalam pangkalan data perdagangan langsung. Struktur data kedua dalam log adalah rekod log dalam jadual log strategi dalam pangkalan data perdagangan langsung. Struktur data ketiga dalam log adalah rekod log dalam jadual log strategi dalam pangkalan data perdagangan langsung.
• Ringkasan: Data bar status dagangan secara langsung.

PeraturanrobotIdParameter digunakan untuk menentukan Id perdagangan langsung yang mana maklumat log akan diperoleh. Anda boleh gunakanGetRobotListkaedah untuk mendapatkan maklumat mengenai perdagangan langsung di bawah akaun, yang mengandungi ID perdagangan langsung.

robotId betul nombor PeraturanlogMinIdparameter digunakan untuk menentukan ID minimum Log.

logMinId betul nombor PeraturanlogMaxIdparameter digunakan untuk menentukan Id maksimum Log.

logMaxId betul nombor PeraturanlogOffsetparameter digunakan untuk menetapkan offset, selepas menentukan julat denganlogMinIddanlogMaxId, diimbangi berdasarkanlogOffsetMula sebagai kedudukan permulaan untuk mengambil data.

logOffset betul nombor ParameterlogLimitdigunakan untuk menetapkan bilangan rekod data yang akan dipilih selepas kedudukan permulaan ditentukan.

logLimit betul nombor PeraturanprofitMinIdparameter digunakan untuk menetapkan ID minimum log keuntungan.

keuntunganMinId betul nombor ParameterprofitMaxIddigunakan untuk menetapkan ID maksimum log keuntungan.

keuntunganMaxId betul nombor ParameterprofitOffsetdigunakan untuk menetapkan offset (berapa banyak rekod yang dilewatkan) sebagai kedudukan permulaan.

keuntunganOffset betul nombor ParameterprofitLimitdigunakan untuk menetapkan bilangan rekod data yang akan dipilih selepas kedudukan permulaan ditentukan.

KeuntunganLimit betul nombor ParameterchartMinIddigunakan untuk menetapkan ID minimum rekod data carta.

cartaMinId betul nombor ParameterchartMaxIddigunakan untuk menetapkan Id maksimum rekod data carta.

cartaMaxId betul nombor ParameterchartOffsetdigunakan untuk menetapkan ofset.

cartaOffset betul nombor ParameterchartLimitdigunakan untuk menetapkan bilangan rekod untuk mendapatkan.

chartLimit betul nombor ParameterchartUpdateBaseIddigunakan untuk menetapkan ID asas selepas pertanyaan dikemas kini.

chartUpdateBaseId betul nombor ParameterchartUpdateDatedigunakan untuk menetapkan data rekod kemas kini cap masa, dan ia akan menapis rekod yang lebih besar daripada cap waktu ini.

chartUpdateDate betul nombor ParametersummaryLimitdigunakan untuk menetapkan bilangan bytes data bar status yang akan ditanyakan. Parameter adalah jenis integer untuk menyoal data bar status Perdagangan. Tetapan untuk 0 bermakna tidak perlu menyoal bar status maklumat, dan menetapkan kepada nombor bukan sifar menunjukkan nombor daripada byte bar status maklumat yang akan ditanyakan (yang antara muka tidak mengehadkan kuantiti data, jadi anda boleh menentukan lebih besarsummaryLimitParameter untuk mendapatkan semua bar status Data bar status disimpan dalam data yang dikembalikansummary.

RingkasanHatapan betul nombor

• Jadual log strategi dalam pangkalan data PeraturanArrnilai atribut dalam elemen pertamaLogsNilai atribut (struktur array) dalam data pulangan (data log) digambarkan seperti berikut:

  "Arr": [
      [3977, 3, "Futures_OKCoin", "", 0, 0, "Sell(688.9, 2): 20016", 1526954372591, "", ""],
      [3976, 5, "", "", 0, 0, "OKCoin:this_week too many positions, long: 2", 1526954372410, "", ""]
  ],
  

  id	logType	eid	Perintah	harga	jumlah	tambahan	tarikh	kontrakJenis	Arah
  3977	3	Futures_OKCoin	""	0	0	Menjual ((688.9, 2): 20016	1526954372591	""	""
  3976	5	""	""	0	0	OKCoin:minggu ini_terlalu banyak kedudukan, panjang: 2	1526954372410	""	""

  extraadalah mesej lampiran log cetak.

  Jenis log tertentu yang diwakili olehlogTypenilai diterangkan sebagai berikut:

  logTipe:	0	1	2	3	4	5	6
  Makna logType:	Beli	Jualan	Mengundur	Kesilapan	Keuntungan	Mesej	Mulakan semula

• Jadual log carta keuntungan dalam pangkalan data Data dalam jadual log carta adalah konsisten dengan log keuntungan dalam jadual log strategi.

  "Arr": [
      [202, 2515.44, 1575896700315],
      [201, 1415.44, 1575896341568]
  ]
  

  Ambil salah satu data log sebagai contoh:

  [202, 2515.44, 1575896700315]
  

  202adalah logID; 2515.44ialah nilai keuntungan;1575896700315adalah cap masa.

• Jadual log carta dalam pangkalan data

  "Arr": [
      [23637, 0, "{\"close\":648,\"high\":650.5,\"low\":647,\"open\":650,\"x\":1575960300000}"],
      [23636, 5, "{\"x\":1575960300000,\"y\":3.0735}"]
  ]
  

  Ambil salah satu data log sebagai contoh:

  [23637, 0, "{\"close\":648,\"high\":650.5,\"low\":647,\"open\":650,\"x\":1575960300000}"],
  

  23637adalah logID, 0adalah indeks siri data carta, dan data terakhir"{\"close\":648,\"high\":650.5,\"low\":647,\"open\":650,\"x\":1575960300000}"adalah data log; Data ini adalah data K-line pada carta.

Perpustakaan terbina dalam Terminal Perdagangan