Introducing the Coindirect CWS API

Coindirect provides financial technology companies with access to its underlying tech platform via the Coindirect Cryptocurrency Web Services (CWS) API. The CWS API offers a crypto to fiat integration-as-a-service to anyone wanting to create a cryptocurrency application. At its heart, the Coindirect CWS connects the decentralised crypto ecosystem with traditional financial systems and exposes this connection as an easy to use API. Complete API coverage is provided for all of the features used by our consumer products, including:

  • Coindirect Wallet: Buy, store and convert your cryptocurrencies.
  • Coindirect Exchange: Trade with the biggest selection of cryptocurrencies.
  • Coindirect Marketplace: Peer to peer offer marketplace.

Getting Started

This document describes the Coindirect Cryptocurrency Web Services (CWS) REST API and everything that is necessary to access its resources. The Coindirect CWS API is organised around the following main categories:

  • Exchange
  • Accounts and Users
  • Currencies and Prices
  • Peer to peer marketplace
  • Wallets
  • Transactions
  • Payment Methods and Types
  • Countries and Languages

Full detail of each section can be found by clicking on the header in the left hand menu.

All API requests are performed over HTTPS and follow JSON API conventions. All data is sent and received as JSON with the content type application/json.

API Reference

Access the complete API here. Alternatively, view the individual sections of the API by browsing the menu on the left.

Accessing the API

In order to use the API, you first need to create a Coindirect user account. If you have not yet done so, please . Contact us at support@coindirect.com if you have any difficulties signing up.

You will also need to have two factor authentication (2FA) enabled on your account in order to access your API key.

Creation of API key

To use the Coindirect CWS API you have to first create an API key from within the Security section of your Coindirect account. Below is the step by step process to follow in order to generate such a key:

  1. Enable two factor authentication (2FA) on your Coindirect account by going to the Security page of your profile (accessible from the top-right drop down menu).
  2. Once 2FA is enabled on your account, return to the Security page.
  3. In the ‘Manage API keys’ section, generate a new API key by entering a description and your 2FA code and clicking the ‘Create’ button.
  4. The new API key will be displayed to you in the ‘Manage API keys’ section. Your secret key will also be displayed to you, however you will need to take note of this as this key will not be accessible later. You can generate multiple API keys if required. Should you no longer require a specific API key, you can click the ‘Revoke’ button to deactivate the API key.

Environments

All calls to the Coindirect CWS API will be in the live environment. We unfortunately cannot provide access to a public staging or testing environment at this stage. The live base URL host for all API requests documented below is: https://api.coindirect.com

Versioning

The API version is indicated in the request URL e.g. /v1/transaction indicates version 1. All changes made to the API are backwards compatible, hence any major features that are released, that would otherwise break existing implementations, will be released using a new version.

Pagination

Many Coindirect API methods support a way to retrieve a list of records. For example, you can retrieve a list of transactions. When retrieving a list, you can control the number of records returned by adding two parameters to your request:

  • offset: This tells the Coindirect API where to start fetching the records.
  • max: This limits the number of records returned per page. The default is 10 records.

Errors

Coindirect CWS uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided and codes in the 5xx range indicate an error with Coindirect CWS’s servers (these are rare). The message returned is not always in a suitable format to present to the end-user. Where appropriate, detailed error descriptions are provided for each error code next to the relevant method in the API documentation. Please note that new error codes may be added and existing error codes may be removed without notice.

Code Samples

Our API documentation provides sample code for the various requests and responses in any of the following languages: Shell, Go, Java, Javascript, Node, Obj-C, PHP, Python, Ruby, Swift, C sharp, C.

Navigate to the specific request, scroll down to the ‘Send a Test Request’ section and click the ‘Code Generator’ tab. From there select the language and library you’re looking for from the dropdown menus.