API

Are you looking to use the BestMixer API but are unsure of where to start? APIs (**A**pplication **P**rogramming **I**nterface) are software-to-software interactions which allow two applications to talk to each other. BestMixer's very own REST API allows you to:

• Apply the powers and potential of BestMixer on your blog or website
• Give your project the edge it needs by integrating BestMixer's industry-leading features
• Create your own Bitcoin tumbler service for free
• Guarantee the security and anonymity of client payments

To get your API key and find out more about connection limits, please contact our support service.

code/info

Returns BestMixer code related information.

Request:

Method	Url	HTTP headers
`POST`	`https://BestMixer/api/ext/code/info`	`Content-Type: application/json`

Request parameters:

Name	Type	Description
`api_key`	`string`	required, a unique 10-symbols code tracking and controlling use of API.
`bm_code`	`string`	required, a unique 10-symbols code generated during your first order to ensure you will not get back your old coins when using the BestMixer service again.

Example request:

POST https://BestMixer/api/ext/code/info HTTP/1.1
Content-Type: application/json

{
    "api_key": "XXXXXXXXXX",
    "bm_code": "XXXXXXXXXX"
}

Example response:

{
    "error": null,
    "data": {
        "min_service_fee": {
            "btc": 1.0000,
            "bch": 3.0000,
            "ltc": 3.0000        }
    }
}

fee/info

Returns max. miner's fee for each receiving address.
To prevent blockchain analysis based on minimal fee amounts, a floating miner's fee for transaction processing is being used instead.

Request:

Method	Url	HTTP headers
`POST`	`https://BestMixer/api/ext/fee/info`	`Content-Type: application/json`

Request parameters:

Name	Type	Description
`api_key`	`string`	required, a unique 10-symbols code tracking and controlling use of API.

Example request:

POST https://BestMixer/api/ext/fee/info HTTP/1.1
Content-Type: application/json

{
    "api_key": "XXXXXXXXXX"
}

Example response:

{
    "error": null,
    "data": {
        "fee_per_address": {
            "btc": "0.000XXXXX",
            "bch": "0.000XXXXX",
            "ltc": "0.000XXXXX",
            "eth": "0.000XXXXX"
        }
    }
}

order/create

Creates order and returns order related information.

Request:

Method	Url	HTTP headers
`POST`	`https://BestMixer/api/ext/order/create`	`Content-Type: application/json`

Request parameters:

Name	Type	Description
`api_key`	`string`	required, a unique 10-symbols code tracking and controlling the use of API.
`bm_code`	`string`	a unique 10-symbols code generated during your first order to ensure you will not get back your old coins when using the BestMixer service again.
`coin`	`string`	required, cryptocurrency, available value: btc, bch, ltc, eth.
`fee`	`float`	required, a service fee varying from 1.0000% to 5.0000% (btc). Preset it greater than minimum possible value and define it to hundredths or thousandths of a percent.
`output`	`array`	required, an array of output objects.

output array:

Name	Type	Description
`address`	`string`	required, receiving address(es) to send coins to.
`percent`	`float`	required, the different percentage of transfers with accuracy to tenths. Note: The total percentage of all transfers should be equal to 100%.
`delay`	`int`	required, transfer delay varying from 0 to 4320 minutes. Set different delay with accuracy to minutes for all transfers.

Example request:

POST https://BestMixer/api/ext/order/create HTTP/1.1
Content-Type: application/json

{
    "api_key": "XXXXXXXXXX",
    "bm_code": "XXXXXXXXXX",
    "coin": "btc",
    "fee": 1.0001,
    "output": [
        {
            "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "percent": 5.5,
            "delay": 33
        },
        {
            "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "percent": 4.5,
            "delay": 0
        },
        {
            "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "percent": 90,
            "delay": 121
        }
    ]
}

Example response:

{
    "error": null,
    "data": {
        "order_id": "XXXXXXXXXX",
        "input_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "min_amount": 0.005,
        "max_amount": 123.456,
        "bm_code": "XXXXXXXXXX",
        "letter_of_guarantee": "...Base64..."
    }
}

order/create_fixed

Creates order and returns order related information.

Request:

Method	Url	HTTP headers
`POST`	`https://BestMixer/api/ext/order/create_fixed`	`Content-Type: application/json`

Request parameters:

Name	Type	Description
`api_key`	`string`	required, a unique 10-symbols code tracking and controlling the use of API.
`bm_code`	`string`	a unique 10-symbols code generated during your first order to ensure you will not get back your old coins when using the BestMixer service again.
`coin`	`string`	required, cryptocurrency, available value: btc, bch, ltc, eth.
`fee`	`float`	required, a service fee varying from 1.0000% to 5.0000% (btc). Preset it greater than minimum possible value and define it to hundredths or thousandths of a percent.
`output`	`array`	required, an array of output objects.

output array:

Name	Type	Description
`address`	`string`	required, receiving address(es) to send coins to.
`amount`	`float`	required, exactly amount
`delay`	`int`	required, transfer delay varying from 0 to 4320 minutes. Set different delay with accuracy to minutes for all transfers.

Example request:

POST https://BestMixer/api/ext/order/create_fixed HTTP/1.1
Content-Type: application/json

{
    "api_key": "XXXXXXXXXX",
    "bm_code": "XXXXXXXXXX",
    "coin": "btc",
    "fee": 1.0001,
    "output": [
        {
            "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "amount": 0.1,
            "delay": 33
        },
        {
            "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "amount": 0.1,
            "delay": 0
        },
        {
            "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "amount": 0.1,
            "delay": 121
        }
    ]
}

Example response:

{
    "error": null,
    "data": {
        "order_id": "XXXXXXXXXX",
        "input_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "exactly_amount": 0.30915986
        "bm_code": "XXXXXXXXXX",
        "letter_of_guarantee": "...Base64..."
    }
}

order/info

Returns order related information.

Request:

Method	Url	HTTP headers
`POST`	`https://BestMixer/api/ext/order/info`	`Content-Type: application/json`

Request parameters:

Name	Type	Description
`api_key`	`string`	required, a unique 10-symbols code tracking and controlling the use of API.
`order_id`	`string`	required, a unique number of your order.

Example request:

POST https://BestMixer/api/ext/order/info HTTP/1.1
Content-Type: application/json

{
    "api_key": "XXXXXXXXXX",
    "order_id": "XXXXXXXXXX"
}

Example response:

{
    "error": null,
    "data": {
        "status": "Awaiting",
        "input_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "received": 0,
        "coin": "btc",
        "fixed": 0,
        "min_amount": 0.005,
        "max_amount": 123.456,
        "service_fee": "0.XXXX",
        "fee_per_address": "0.000XXXXX",
        "output": [
            {
                "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "percent": 5.5,
                "delay": 33,
                "delay_countdown" => 0,
                "amount" => 0,
                "status" => Pending
            },
            {
                "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "percent": 4.5,
                "delay": 0,
                "delay_countdown" => 0,
                "amount" => 0,
                "status" => Pending
            },
            {
                "address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "percent": 90,
                "delay": 121,
                "delay_countdown" => 0,
                "amount" => 0,
                "status" => Pending
            }
        ]
    }
}

BestMixer API libraries

On GitHub, there are ready libraries using BestMixer API. You can use it for the creation of your client-applications.

• BestMixer.php - PHP library