Summary

This page will provide basic documentation on using the CoinSpot API.

To use this API you need to generate an API key, you generate your API key from the settings page in your account. Please note that you must be registered customer to use the API, registering is free and only takes a minute, you can register here.

Important things to note
All requests and responses will be JSON
All requests will be made with the POST method.

The endpoint for the API is https://www.coinspot.com.au/api
The endpoint for the Public API is https://www.coinspot.com.au/pubapi

SDK

We currently have a node.js SDK, if you are interested in getting an SDK in another language Contact us

node.js - https://www.npmjs.org/package/coinspot-api

Latest Prices

Url

https://www.coinspot.com.au/pubapi/latest

Inputs

none

Response

status - ok, error
prices - object containing one property for each coin with the latest prices for that coin

Security

The API is secured using by using the shared secret key to create a HMAC with the SHA512 cryptographic hash function. Hash-based message authentication code (HMAC) is a mechanism for calculating a message authentication code involving a hash function in combination with a secret key. This can be used to verify the integrity and authenticity of a a message.

All requests to the API will need to include the following security data.

Headers

key - Your API key generated from the settings page
sign - The POST data is to be signed using your secret key according to HMAC-SHA512 method.

Post Params

nonce - Any integer value which must always be greater than the previous requests nonce value.

List Open Orders

Url

/orders

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'

Response

status - ok, error
buyorders - array containing all the open buy orders
sellorders - array containing all the open sell orders

List Order History

Url

/orders/history

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'

Response

status - ok, error
orders - list of the last 1000 completed orders

Deposit Coins

Url

/my/coin/deposit

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'

Response

status - ok, error
address - your deposit address for the coin

Send Coins

Url

/my/coin/send

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'
address - the address to send coins to
amount - the amount of coins to send

Response

status - ok, error

Quick Buy Quote

Url

/quote/buy

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'
amount - the amount of coins to buy

Response

status - ok, error
quote - the rate per coin
timeframe - estimate hours to wait for trade to complete (0 = immediate trade)

Quick Sell Quote

Url

/quote/sell

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'
amount - the amount of coins to sell

Response

status - ok, error
quote - the rate per coin
timeframe - estimate hours to wait for trade to complete (0 = immediate trade)

List My Balances

Url

/my/balances

Inputs

none

Response

status - ok, error
balances - object containing one property for each coin with your balance for that coin.

List My Orders

A list of your open orders by coin type, it will return a maximum of 100 results

Url

/my/orders

Inputs

none

Response

status - ok, error
buyorders - array containing all your buy orders
sellorders - array containing all your sell orders

Place Buy Order

Url

/my/buy

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'
amount - the amount of coins you want to buy, max precision 8 decimal places
rate - the rate in AUD you are willing to pay, max precision 6 decimal places

Response

status - ok, error

Place Sell Order

Url

/my/sell

Inputs

cointype - the coin shortname, example value 'BTC', 'LTC', 'DOGE'
amount - the amount of coins you want to sell, max precision 8 decimal places
rate - the rate in AUD you are willing to sell for, max precision 6 decimal places

Response

status - ok, error

Cancel Buy Order

Url

/my/buy/cancel

Inputs

id - the id of the order to cancel

Response

status - ok, error

Cancel Sell Order

Url

/my/sell/cancel

Inputs

id - the id of the order to cancel

Response

status - ok, error