NAV Navbar
shell

Introduction

Welcome to MixCoins API documentation! You can use our API to make secure and anonimity transactions in Bitcoin, Bitcoin Cash or Ethereum networks.

Now we have only JSON REST API. In few time we publish PHP and JS libs for access to API.

Getting started

MixCoins uses API token to allow access to the API. You can register a new Kittn API key here.

MixCoins expects for the API key to be included in all API requests to the server in a header that looks like the following:

X-Api-Token: it2jg1kb51oqwq0bi1otr254xkb01ow0

Create mix transaction

curl "http://mixcoins.xyz/api/create/btc"
  -H "X-Api-Token: it2jg1kb51oqwq0bi1otr254xkb01ow0"
  -F "address[]=1M69Aw8SsJw3xhnDhrHTvUa6YP2xLyfL9T"
  -F "amount=1"

The above command returns JSON structured like this:

{
  "amount" : 1.0858,
  "address" : "1GyEhPjbP3uKCys4vLs2PmZzixp6q96TRX",
  "address_legacy" : null,
  "currency" : "btc"
}

HTTP Request

GET http://mixcoins.xyz/api/create/{currency}

Available currencies

You must replace {currency} to one of this labels: btc for Bitcoin, bch for Bitcoin Cash (Bitcoin ABC), eth for Ethereum.

Form Parameters

Parameter Required Type Description
address true array HTTP array of valid addresses for transaction payout for current currency.
amount true float Amount to mixing in float. Only in basic currency (for example, 1 means 1BTC).

Errors

The Kittn API uses the following error codes:

Error Code Meaning
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
403 Forbidden -- The kitten requested is hidden for administrators only.
404 Not Found -- The specified kitten could not be found.
405 Method Not Allowed -- You tried to access a kitten with an invalid method.
406 Not Acceptable -- You requested a format that isn't json.
410 Gone -- The kitten requested has been removed from our servers.
418 I'm a teapot.
429 Too Many Requests -- You're requesting too many kittens! Slow down!
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.