Developers

Introduction

At Coinmerce we have the philosophy that we want to make cryptocurrency accessible to everyone, and therefore also to developers! Hence the Coinmerce API for developers. It is very easy to use this with minimal program knowledge. The API currently contains 2 Endpoints. 1 for requesting the available coins ( more then 80 ) and 1 for creating a new deposit address. And the best news is we charge ZERO fees / costs! We also have a webhook function available so that you automatically receive a notification when receiving cryptocurrencies. We are busy adding more functions and if you have suggestions or questions you can send this to [email protected]

General information

• The base endpoint is: https://cmapi.nl
• All request must be send as a POST or GET method
• All responses are in JSON format
• Rate limit: 60 calls per minute
• An endpoint can contain an error. Explanation of the error can then be read in the 'error' field

API

Token

Every user has his own unique token. This token must be sent with every API request. The token is always 28 characters long and contains only letters and or numbers.

Endpoints

Below you will find all available endpoints. At each endpoint you will find information about the URL to be called, the parameters that must be sent and the response values that are sent back.

  • 1. COINS LISTING

    EXPLANATION:
    This API call contains all the coins that are available to create addresses and receive coins.

    URL:
    https://cmapi.nl/dev//coins

    RESPONSE:
    STATUS = If successful it has the value '1' if not the value '0' and will contain an error message
    COINS = A list with all the coins that are available to receive. Every coin contains a symbol, a name and a note. Some coins need a note at every deposit. If so, the note value will be 1 otherwise it will be 0.

  • 2. NEW DEPOSIT ADDRESS

    EXPLANATION:
    This API call creates a new deposit address to which coins can be sent.

    URL:
    https://cmapi.nl/dev//SYMBOL/newaddress

    PARAMETERS:
    SYMBOL = Change this to the symbol of the coin you would like to receive

    RESPONSE:
    STATUS = If successful it has the value '1' if not the value '0' and will contain an error message
    ADDRESS = The address were the coins can be send to
    NOTE = Some coins need a note at every deposit. If so the note value will be 1 otherwise it will be 0
    HASH = A unique code with which you can distinguish the deposit. This code is also sent by the webhook upon receiving the deposit
    COIN = The symbol of the deposit
    EXPIRES = A deposit will by 6 hours valid. The expires value contains a unix timestamp (GMT) that indicates when the deposit is valid



Webhook

Coinmerce can dispatch webhook events that notify your application when an event occurs on your account. Save a URL as webhook and for every event a POST request with the values below will be sent to the specified URL. (Only letters, numbers and the following symbols : . / are allowed for the webhook URL !)

VALUES TO RECEIVE:
ADDRESS = The address thats received the coins
HASH = The unique code of the deposit.
COIN = The symbol of the deposit
RECEIVED = A unix timestamp (GMT) when the deposit was received
CRYPTO = The amount of crypto
FIAT = The amount of fiat in Euro. ( Pay close attention to this is an estimate by Coinmerce ! )
TOKEN = The unique token of your account