Metode API publice

Există 6 metode publice care acceptă solicitări HTTP GET și returnează răspunsul în formatul JSON:

ReturnTicker

Metoda returnează bilete pentru toate/anumite piețe; exemple de solicitări și răspunsuri:

Exemplul 1. Returneaza toate biletele.

Solicitare: https://api.crex24.com/CryptoExchangeService/BotPublic/ReturnTicker

Răspuns:

{
  Tickers: [{
    BaseVolume: "0.00000000",
    HighPrice: "0.09611615",
    Last: "0.05125186",
    LowPrice: "0.04456261",
    ...
  },  {
    BaseVolume: "0.00000000",
    HighPrice: "0.02062280",
    Last: "0.01025148",
    LowPrice: "0.00972667",
    ...
  },  {
    BaseVolume: "0.00000000",
    HighPrice: "0.00105385",
    Last: "0.00050066",
    LowPrice: "0.00040122",
    ...
  },  ...]
}

Exemplul 2. Returnează biletele BTC_LTC și BTC_DOG.

Solicitare: https://api.crex24.com/CryptoExchangeService/BotPublic/ReturnTicker?request=[NamePairs=BTC_LTC,BTC_DOGE]

Răspuns:

{
  Tickers:  [{
    BaseVolume: "0.00000000",
    HighPrice: "0.02062280",
    Last: "0.01023842",
    LowPrice: "0.00972667",
    ...
  },  {
    BaseVolume: "0.47617000",
    HighPrice: "0.00000080",
    Last: "0.00000041",
    LowPrice: "0.00000035",
    ...
  }]
}


Return24Volume

Metoda returnează volumul tranzacțiilor pentru 24 de ore pentru toate/anumite piețe:

Exemplu. Returnează volumul pentru BTC_DOGE.

Solicitare:https://api.crex24.com/CryptoExchangeService/BotPublic/Return24Volume?request=[NamePairs=BTC_DOGE]

Răspuns:

{
  Volume: {
    VolumesByOne: [{
      Name: "BTC",
      Volume: 0.23673
    }, {
      Name: "DOGE",
      Volume: 577000
    }],
    VolumesByTwo: [{
      First: {
        Name: "BTC",
        Volume: 0.23673
      },
      Name: "BTC_DOGE",
      Second: {
        Name: "DOGE",
        Volume: 577000
      }
    }]
  }
}


ReturnOrderBook

Metoda returnează mulțimea de ordine pentru piața specificată

Exemplu. Returnează mulțimea de ordine pentru BTC_DOGE.

Solicitare:https://api.crex24.com/CryptoExchangeService/BotPublic/ReturnOrderBook?request=[PairName=BTC_DOGE]

Răspuns:

{
  BuyOrders: [{
    AccumulateMoneyCount: "36826.27800846",
    AccumulateMoneyVolume: "0.01509877",
    CoinCount: "36826.27800846",
    ...
  },  {
    AccumulateMoneyCount: "67304.76798074",
    AccumulateMoneyVolume: "0.02729017",
    CoinCount: "30478.48997228",
    ...
  },  {
    AccumulateMoneyCount: "75084.76074510",
    AccumulateMoneyVolume: "0.03032437",
    CoinCount: "7779.99276436",
    ...
  },  {
    AccumulateMoneyCount: "75433.94286209",
    AccumulateMoneyVolume: "0.03045706",
    CoinCount: "349.18211699",
    ...
  }],
  SellOrders: [{
    AccumulateMoneyCount: "10642.66536957",
    AccumulateMoneyVolume: "0.00446992",
    CoinCount: "10642.66536957",
    ...
  },  {
    AccumulateMoneyCount: "31738.44031685",
    AccumulateMoneyVolume: "0.01354110",
    CoinCount: "21095.77494728",
    ...
  }, {
    AccumulateMoneyCount: "41156.60557210",
    AccumulateMoneyVolume: "0.01768510",
    CoinCount: "9418.16525525",
    ...
  }, {
    AccumulateMoneyCount: "50937.97566773",
    AccumulateMoneyVolume: "0.02208671",
    CoinCount: "9781.37009563",
    ...
  }]
}


ReturnTradeHistoryPub

Metoda returnează ultimele 1.000 tranzacții (sau mai puțin dacă parametrul Count este specificat) sau tranzacții pentru timpul specificat de parametrii StartTS și EndT în formatul timestamp UNIX.

Exemplu. Returnearea istoricului tranzacțiilor pentru BTC_DOGE.

Solicitare:https://api.crex24.com/CryptoExchangeService/BotPublic/ReturnTradeHistoryPub?request=[PairName=BTC_DOGE]

Răspuns:

{
  Trades: [{
    CoinCount: "716.23394813",
    CoinPrice: "0.00000037",
    Commission: "0.00000027",
    DtCreateTS: 1502771794,
    ...
  }, {
    CoinCount: "283.76605187",
    CoinPrice: "0.00000037",
    Commission: "0.00000010",
    DtCreateTS: 1502771794,
    ...
  }]
}


ReturnChartData

Metoda returnează date candlestick pentru un anumit pariu. Timpul în minute al candlestick poate fi setat de parametrul CandleTimeInMinutes, începutul și sfârșitul intervalului pot fi setate de parametrii StartTS și EndTS în formatul timestamp UNIX.

Exemplu. Metoda returnează candlesticks de cinci-minute pentru BTC_DOGE înainte de 16 august 2017.

Solicitare:https://api.crex24.com/CryptoExchangeService/BotPublic/ReturnChartData?request=\ [PairName=BTC_DOGE][CandleTimeInMinutes=5][StartTS=1][EndTS=1502876344]

Răspuns:

{
  Candles:  [{
    EndOrderPrice: "0.00000099",
    MaxOrderPrice: "0.00000100",
    MinOrderPrice: "0.00000098",
    OrderCount: 4,
    ...
  },  {
    EndOrderPrice: "0.00000100",
    MaxOrderPrice: "0.00000101",
    MinOrderPrice: "0.00000099",
    OrderCount: 2,
    ...
  },  {
    EndOrderPrice: "0.00000102",
    MaxOrderPrice: "0.00000103",
    MinOrderPrice: "0.00000100",
    OrderCount: 4 ,
    ...
  },  ...]
}


ReturnCurrencies

Metoda returnează informații despre toate/anumite valute.

Exemplu. Informații despre valuta DOGE

Solicitare:https://api.crex24.com/CryptoExchangeService/BotPublic/ReturnCurrencies?request=[Names=DOGE]

Răspuns:

{
  Currencies: [{
    Delisted: false,
    Disabled: false,
    Frozen: false,
    MinConf: 6,
    Name: "Dogecoin",
    ...
  }]
}

Metode de tranzacționare API

Url pentru tranzacționare API: https://api.crex24.com/CryptoExchangeService/BotTrade/<MethodName>

Este necesar să creați un cod API pentru a putea tranzacționa pe API(https://crex24.com/settings/tokens).

Vă rugăm să rețineți că limita implicită este de 6 solicitări pe secundă. Dacă nu este suficient, vă rugăm să contactați Echipa de Suport Clienți pentru a discuta crșterea limitei.

Toate solicitările de tranzacționare API sunt trimise la adresa HTTP prin metoda POST și ar trebui să conțină următoarele antete:
  • UserKey — API key.
  • Semnare - Semnătura de solicitare POST a fost creată folosind un cod secret prin HMACSHA512.

Toate solicitările ar trebui să conțină POST parametri Nonce. Nonce nu este semnat int64 care trebuie să fie întotdeauna mai mare decât valoarea precedentă. Trebuie să folosiți parametri timestamp în aceste scopuri.

Este trimis un răspuns în formatul JSON. Dacă intervine o eroare, răspunsul va fi în formatul următor:

{"Error" : {"Message" : "<error message>"}}

Exemple de solicitări trimise spre tranzacționare API în diferite limbaje de programare:

Readme: https://github.com/iiw/Crex24.Examples

Python: https://github.com/iiw/Crex24.Examples/blob/master/python/app.py

C#: https://github.com/3P3C/Crex24.Example/blob/master/Crex24Example/Program.cs

JS: https://github.com/iiw/Crex24.Examples/tree/master/js

PHP: https://github.com/iiw/Crex24.Examples/blob/master/php/app.php

ReturnBalances

Obțineți soldurile disponibile.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnBalances

Conținutul solicitării:

{
    "Names" : ["BTC", "LTC"],    # Lista valutelor. Dacă nu este disponibilă, atunci regăsiți pentru toate monedele.
    "NeedNull" : "true"          # Includeți soldurile zero în listă.
}

Răspuns:

{
  "Balances": [
    {
      "AvailableBalances": 10.00000000,
      "InOrderBalances": 10.00000000,
      "Name": "BTC"
    },
    {
      "AvailableBalances": 0.00000000,
      "InOrderBalances": 0.00000000,
      "Name": "LTC"
    }
  ]
}

ReturnOpenOrders

Luați ordinele deschise.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnOpenOrders

Conținutul solicitării:

{
  "Pairs": ["BTC_LTC", "BTC_ETH"]    # Lista perechilor tranzacționare. Dacă lipsesc atunci regăsiți pentru toate perechile tranzacționare.
}

Răspuns:

{
  "Orders": [
    {
      "CoinCount": 1.00000000,
      "CoinPrice": 0.01135442,
      "Id": 71463796,
      "IsCloseRequired": false,
      "IsSell": true,
      "PairName": "BTC_LTC"
    },
    {
      "CoinCount": 1.00000000,
      "CoinPrice": 0.06835904,
      "Id": 71463169,
      "IsCloseRequired": false,
      "IsSell": true,
      "PairName": "BTC_ETH"
    },
    ...
  ]
}

ReturnTradeHistory

Obțineți istoric de tranzacționare.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnTradeHistory

Conținutul solicitării:

{
  "Pairs": ["BTC_LTC", "BTC_ETH"]   # Lista perechilor tranzacționare. Dacă lipsesc atunci regăsiți pentru toate perechile tranzacționare.
}

Răspuns:

{
  "Trades": [
    {
      "CoinCount": 1.00000000,
      "CoinPrice": 0.06835904,
      "Commission": 0.00000166,
      "DtCreateTS": 1506517638,
      "Id": 185197,
      "IsMaker": true,
      "IsSell": true,
      "PairName": "BTC_ETH"
    },
    {
      "CoinCount": 1.00000000,
      "CoinPrice": 0.01135442,
      "Commission": 0.00000166,
      "DtCreateTS": 1506085177,
      "Id": 185169,
      "IsMaker": true,
      "IsSell": false,
      "PairName": "BTC_LTC"
    },
    ...
  ]
}

ReturnOrderTrades

Obțineți toate tranzacțiile comerciale în funcție de ordine.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnOrderTrades

Conținutul solicitării:

{
  "OrderId": 51893150
}

Răspuns:

{
  "Trades": [
    {
      "CoinCount": 10.00000000,
      "CoinPrice":  0.06835904,
      "Commission": 0.00000166,
      "DtCreateTS": 1506517638,
      "Id": 185197,
      "IsMaker": true,
      "IsSell": true,
      "PairName": "BTC_ETH"
    },
    ...
  ]
}

Buy

Plasați un ordin de cumpărare.

Exemplu. Plasați un ordin de cumpărare 10 LTC pentru BTC la un preț de 0.01194538:

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/Buy

Conținutul solicitării:

{
  "Pair": "BTC_LTC",
  "Course": 0.01194538,
  "Volume": 10.0
}

Răspuns:

{
  "Id": 51893288
}

Sell

Plasați un ordin de vânzare.

Exemplu. Plasați un ordin de vânzare 10 LTC pentru BTC la prețul de 0.01194538:

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/Sell

Conținutul solicitării:

{
  "Pair": "BTC_LTC",
  "Course": 0.01194538,
  "Volume": 10.0
}

Răspuns:

{
  "Id": 51893294
}

CancelOrder

Anulare ordin.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/CancelOrder

Conținutul solicitării:

{
  "OrderId": 51893294
}

Răspuns:

{
  "Success": true
}

CancelOrderMulti

Anulați mai multe ordine după lista de ID-uri sau după perechile tranzacționare.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/CancelOrderMulti

Exemplul 1. Anulați ordinile după lista de ID-uri:

Conținutul solicitării:

{
  "OrderIds": [51893293, 51893292]
}

Exemplul 2. Anulați toate ordinile după perechile tranzacționare:

Conținutul solicitării:

{
  "PairNames": ["BTC_ETH", "BTC_LTC"]
}

Răspuns:

{
  "Success": true
}

ReturnOrderStatus

Obțineți informații și toate tranzacțiile comerciale în funcție de ordin.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnOrderStatus

Conținutul solicitării:

{
  "OrderId": 51893312
}

Răspuns:

{
  "CurrentOrder": {               # Status actual al comezii.
    "CoinCount": 9.00000000,
    "CoinPrice": 0.01194538,
    "Id": 51893314,
    "IsCloseRequired": false,
    "IsSell": false,
    "PairName": "BTC_LTC"
  },
  "SourceOrder": {                #Status inițial al comenzii.
    "CoinCount": 10.00000000,
    "CoinPrice": 0.01194538,
    "Id": 51893314,
    "IsCloseRequired": false,
    "IsSell": false,
    "PairName": "BTC_LTC"
  },
  "Trades": [                     # Lista tranzacțiilor comerciale în funcție de ordin.
    {
      "CoinCount": 1.00000000,
      "CoinPrice": 0.01194538,
      "Commission": 0.00000000,
      "DtCreateTS": 1507465556,
      "Id": 185250,
      "IsMaker": true,
      "IsSell": false,
      "PairName": "BTC_LTC"
    }
  ]
}

ReturnDepositsWithdrawals

Obțineți istoricul depunerilor și al retragerilor. Tranzacțiile vor fi afișate pagină cu pagină începând cu cea mai recentă tranzacție. Pentru a vizualiza următoarea pagină completați câmpul Formld cu cel mai mic ID înregistrat obținut la răspunsul precedent.

Exemplu. Obțineți ultimele 100 de înregistrări:

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnDepositsWithdrawals

Conținutul solicitării:

{
  "Names": ["BTC", "LTC"],       # Lista valutelor. Dacă nu este disponibilă, atunci regăsiți pentru toate monedele.
  "FromId": 0,                   # 0 sau cel mai mic ID de înregistrare din răspunsul anterior.
  "Take": 100                    # Numărul de înregistrări pentru răspuns. Număr maxim de înregistrări este 1.000.
}

Răspuns:

{
  "CountRemain": 1000,                          # Număr de înregistrări rămase. Dacă rezultatul este 0 atunci înseamnă că este ultima pagină.
  "Changes": [
    {
      "Address": "17XjwyX78jusTPXHxxF14ST9fWrCUcLT6L",   # Adresa de plată.
      "AgentName": null,                        # Numele sistemului de plată pentru moneda fiat.
      "CurrenceName": "BTC",
      "Id": 151,                                # Înregistrare ID.
      "NeedConfirm": 15,
      "NumConfirm": 17,
      "Status": 3,                              # Statusul plății. Vedeți mai jos.
      "Sum": 0.20000000,
      "TimeTs": 1504100143,                     # Ora de creare a înregistrării în format UTC.
      "TxId": "4f37855e4ecfc8f15b58f3397a6f339ca6f941d63d097c08004f7c9dfc4ec700",   # ID Tranzacție
      "Type": 2                                 # Tipul înregistrării. Vedeți mai jos.
    },
    ...
  ],
}

Valori posibile pentru câmpul "Status":
  1. - Confirmată de utilizator
  2. - Tranzacție creată
  3. - Prima confirmare
  4. - Procesat cu succes
  5. - Tranzacție respinsă
  6. - În curs de procesare
  7. - Anulată de utilizator
  8. - Se așteaptă trimiterea
Valori posibile pentru câmpul "Tip":
  1. - Depunere criptomonedă
  2. - Retragere criptomonedă
  3. - Depunere valută fiat
  4. - Retragere valută fiat

Withdraw

Creați o solicitare de retragere.

Exemplu.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/Withdraw

Conținutul solicitării:

{
  "Currency": "BTC",
  "Sum": 1.0,
  "Address": "17XjwyX78jusTPXHxxF14ST9fWrCUcLT6L",
  "Message": "any_message"         #Mesaj pentru tranzacții (va fi trimis dacă moneda acceptă).
}

Răspuns:

{
  "NewBalance": 9.00000000,                         # Sold nou.
  "OutId": 613                                      # ID -ul solicitării de retragere. Dacă nu este 0, solicitarea a fost creată cu succes.
}

ReturnDepositAddress

Obțineți adresa pentru a depune valută. Dacă trebuie specificat un mesaj pentru depunere, mesajul va fi prezent în răspuns.

Solicitați: https://api.crex24.com/CryptoExchangeService/BotTrade/ReturnDepositAddress

Exemplul 1. Obțineți adresa pentru depunere BTC:

Conținutul solicitării:

{
  "Currency": "BTC"
}

Răspuns:

{
  "Address": "1JH6h3qDbAMEzAD8e7usWEqePddHzpSTgK",
  "Message": null 
}

Exemplul 2. Obțineți adresa pentru depunere XMR:

Conținutul solicitării:

{
  "Currency": "XMR"
}

Răspuns:

{
  "Address": "NC6GOUR4ICVVPPK7N4UIYWDJM6LTUBJFR7OVXDS5",
  "Message": "950a239c0f98ca41"                             # Un mesaj care trebuie specificat la depunere.
}