CrexSoft - Справка

()

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

How to Trade Crypto Coins
RPC API Format Description
API Usage Examples

PHP
JS

How to Trade Crypto Coins on CrexSoft

To start trading on the CrexSoft exchange, you need to complete the registration process.
Since the exchange does not link accounts to email addresses or phone numbers, it is very important to save your registration code.
Only with this code can you change your password and prove that you are the account owner in case someone steals your login/password.
After registration, all trading features will become available.
To sell or buy anything on the exchange, you first need to fund one of your wallets. Each cryptocurrency has its own wallet, and each user is given a unique personal address to deposit funds into that wallet.
When coins are received at this address, they become available for trading.
To buy or sell cryptocurrency, go to the "Trades" page and select a cryptocurrency pair.
This is done from the left menu in the "MARKET" table. For example, if you want to buy Bitcoin for rubles (RUR),
select RUR in the MARKET table header and then choose the BTC row.
This will open trading information for the BTC/RUR pair.

When a user wants to buy or sell something, they create an Order. Orders can be for buying or selling.
Each order specifies the number of coins, the price at which they are being sold or bought, and the total amount, which is calculated by multiplying the price by the number of coins.

All users’ orders form two order books — a buy order book and a sell order book.
If a user wants to buy coins immediately, they need to set a buy order price higher than the price in the sell order book.
In this case, their order will be executed instantly (market order).

If a user believes the current selling price is too high and expects it to drop, they can set their buy order price below the current selling price.
Their order will then be placed in the buy order list and will execute automatically when the price drops to the specified level.

When a buy order is executed, the purchased cryptocurrency will appear in the user’s wallet.
It can then be sold later for a higher price or withdrawn from the exchange. Withdrawals are made through the "Wallets" menu.

When depositing or withdrawing coins, double-check addresses carefully — at least seven times — because these operations are irreversible.
If you enter incorrect information, the cryptocurrency will be lost permanently.

RPC API Format Description

PHP Example demonstrating the tradeHistory method for the btc_rur currency pair

=== start of file 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') );
=== end of file testapi.php ===

JavaScript (node.js) example demonstrating order creation, cancellation, retrieving order info, etc.

=== start of file 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={ method:'OrderInfo', order_id:orderid };
        return await this.makeSignedRequest(params);
    }

    async Trade({pair,type,rate,amount}){
        let params={ method:'Trade', pair, type, rate, amount };
        return await this.makeSignedRequest(params);
    }

    async getInfo(){
        let params={ method:'getInfo' };
        return await this.makeSignedRequest(params);
    }

    async CancelOrder({orderid}){
        let params={ method:'CancelOrder', order_id:orderid };
        return await this.makeSignedRequest(params);
    }
}

let config={ apiEndpoint: 'https://crexsoft.com/api', publickey:'your public key from settings', secretkey:'your secret key from settings' };
let crexsoft=new CrexsoftApi(config);

// informational methods
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);

// trading methods
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);

=== end of file testapi.js ===