CrexSoft - Information

()

Справочная информация

Как торговать крипто монетами
Описание формата RPC API
Примеры работы с API

PHP
JS

Как торговать крипто монетами на CrexSosft

Для начала работы на бирже CrexSoft надо пройти процедуру регистрации.
Так как биржа не привязывается к email адресам и телефонам - обязательно сохраните регистрационный код,
только с его помощью можно будет сменить пароль и доказать что Вы владелец аккаунта,
ели кто-то украдет у вас логин/пароль.
После регистрации будут доступны все возможности для торговли криптовалютами.
Чтобы что-то продать или купить на бирже, надо пополнить один из кошельков. У каждой криптовалюты свой кошелек,
каждому пользователю выделяется персональный адрес для пополнения этого кошелька.
Когда монеты приходят на этот адрес они становятся доступны для торговли.
Чтобы купить или продать криптовалюту, надо зайти на страницу "Торги" и выбрать криптовалютную пару.
Это делается в левом меню в таблице "МАРКЕТ". Например если вы хотите купить Bitcoin за рубли,
нужно в таблице МАРКЕТ выбрать в заголовке RUR и затем выбрать строку с BTC,
откроется информация по торгам по паре BTC/RUR.

Когда пользователь хочет что-то купить или продать он создает Ордер. Ордера бывают на покупку и на продажу.
в каждом ордере указывается количество монет, цена по которой их продают или покупают и итоговая сумма,
которая является произведением цены на количество монет.

Ордера всех пользователей формируют два стакана ордеров - стакан на покупку и стакан на продажу.
Если пользователь хочет немедленно купить монеты, он должен в своем ордере на покупку поставить цену,
которая больше чем в стакане ордеров на продажу, тогда его ордер исполнится немедленно (торговля по рынку).

Если пользователь хочет купить монеты считает что цена продажи завышена и должна снизиться,
он может установить свою цену ниже цены в стакане ордеров продаж и тогда его ордер разместится
в списке ордеров на покупку и исполнится когда цена снизится до указанной в ордере.

Когда ордер на покупку исполнится то купленная криптовалюта окажется в кошельке пользователя,
и ее можно продать подороже на бирже или вывести с биржи, вывод делается в меню "Кошельки".

При вводе и выводе монет семь раз проверяйте адреса ввода вывода, так как это операция необратимая,
и если вы укажете неверную информацию, криптовалюта уйдет в никуда.

Описание формата RPC API

Пример на php демонстрирует вызов метода tradeHistory для валютной пары btc_rur

=== начало файла testapi.php ===
function request($req)
{
    $site='crexsoft.com';

    $api_key='a876a876a66a86a86a6a6a866a8a';
    $api_secret='a65a765a67a567a56a756a76a75a';

    $post_data = http_build_query($req, '', '&');
    $sign = hash_hmac("sha512", $post_data, $api_secret);
    $headers = array(
        'Sign: '.$sign,
        'Key: '.$api_key,
    );

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; SMART_API PHP client; '.php_uname('s').'; PHP/'.phpversion().')');
    curl_setopt($ch, CURLOPT_URL, 'https://'.$site.'/tapi/');
    curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
    curl_setopt($ch, CURLOPT_POST, true );
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_ENCODING , 'gzip');

    $res = curl_exec($ch);
    if($res === false)
    {
        $e = curl_error($ch);
        tolog3( "transaction error: ".print_r($e, true) );
        curl_close($ch);
        return null;
    }

    curl_close($ch);

    $result = json_decode($res, true);

    if($result['success']!=1){
        tolog2( "reply with error: ".print_r($result,true) );
    }
    return $result;
}

function tradeHistory($pair)
{
   $data['method']='TradeHistory';
   $data['pair']=$pair;
   $data['from_id']=0;
   $data['count']=3;
   //$data['order']='ASC';

   $ret=request($data);
   return $ret;
}

print_r( tradeHistory('btc_rur' );

=== конец файла testapi.php ===

Пример на JavaScript (node.js) демонстрирует создание ордера,удаление,получение информации о ордере и др.

=== начало файла testapi.js ===

const axios = require('axios');
const httpBuildQuery = require('http-build-query');
const crypto = require("crypto");

class CrexsoftApi {

    constructor(config) {
        this.config=config;
    }

    async get(method,params){
        let url = this.config.apiEndpoint + '/' + method+'/'+params;
        let response = await axios.get(url, {}, {
            headers: {
                'Content-Type': 'application/json',
            },
        });
        return response.data;
    }

    async doRequest(reqOpts) {
        let {url,method,body,headers} = reqOpts;
        let response = await axios.post(url, body, {
            headers
        });
        return response.data;
    }

    async makeSignedRequest(params){
        let signature = httpBuildQuery(params);
        let url=this.config.url;
        let reqUrl = 'https://' + url + '/tapi/';
        let hmacsignature = crypto.createHmac('sha512', this.config.secretkey).update(signature).digest('hex');
        let headers = {
            'Content-Type': 'application/x-www-form-urlencoded',
            'Key': this.config.publickey,
            'Sign': hmacsignature,
            'Cache-Control': 'no-cache'
        };
        let reqOpts = {
            url: reqUrl,
            method: "POST",
            body: signature,
            headers: headers
        };
        let res = await this.doRequest(reqOpts);
        return res;
    }

    async OrderInfo({orderid}){
        let params={};
        params.method='OrderInfo';
        params.order_id=orderid;
        let res = await this.makeSignedRequest(params);
        return res;
    }
    async Trade({pair,type,rate,amount}){
        let params={};
        params.method='Trade';
        params.pair=pair;
        params.type=type;
        params.rate=rate;
        params.amount=amount;
        let res = await this.makeSignedRequest(params);
        return res;
    }
    async getInfo(){
        let params={};
        params.method='getInfo';
        let res = await this.makeSignedRequest(params);
        return res;
    }
    async CancelOrder({orderid}){
        let params={};
        params.method='CancelOrder';
        params.order_id=orderid;
        let res = await this.makeSignedRequest(params);
        return res;
    }
}

let config={};
config.apiEndpoint = 'https://crexsoft.com/api'
config.publickey='публичный ключ из настроек';
config.secretkey='секретный ключ из настроек';
let crexsoft=new CrexsoftApi(config);

// информационные методы
crexsoft.get('ticker','btc_rur').then( console.log ).catch(console.error);
crexsoft.get('trades','btc_rur').then( console.log ).catch(console.error);
crexsoft.get('depth','btc_rur').then( console.log ).catch(console.error);

// торговые методы
crexsoft.getInfo().then( console.log ).catch(console.error);
crexsoft.OrderInfo({orderid:12345}).then( console.log ).catch(console.error);
crexsoft.CancelOrder({orderid:12345}).then( console.log ).catch(console.error);
crexsoft.Trade({pair:'btc_rur',type:'buy',rate:0.00000001,amount:1000}).then( console.log ).catch(console.error);

=== конец файла testapi.js ===