altilly API


Terms

By using our API you confirm that you have read and accept the API License Agreement

- Rest Api
- Websocket Api

REST API


REST API reference

Our REST API reference can be found here:
https://www.altilly.com/page/restapi

API Endpoint URL

The endpoint for our REST API is: https://api.altilly.com/api

Authentication

Our API uses HTTP Basic Auth for authenticated calls.

Generate API Keys

You can generate API Keys here: https://www.altilly.com/user/profile/api

Datetime Formatting

Unless otherwise stated, all timestamps are returned in ISO8601 format in UTC. Example: "2018-04-01T00:00:00Z" or "2018-04-01T00:00:00.000Z". If a timestamp is returned as an Integer, then that is a Unix timestamp.

Number Formatting

All finance data such as price, quantity, and fee should be arbitrary precision numbers and string representation. Example: "5.39300000"

Helpful Classes

Tobias created this Python class which we are maintaining: https://github.com/altilly/python-altilly

HTTP Status Codes

200 OK Successful request
400 Bad Request. Returns JSON with the error message
401 Unauthorized. Authorization required or failed
403 Forbidden. Action is forbidden for API key
429 Too Many Requests. Your connection is being rate limited
500 Internal Server. Internal Server Error
503 Service Unavailable. Service is down for maintenance
504 Gateway Timeout. Request timeout expired

Error Codes

Error CodeHTTP Status CodeMessageDetails
400 400 Unknown error An unknown error occurred somewhere in the system
402 400 Method not found The requested API method was not found
403 401 Action is forbidden for account
429 429 Too many requests Action is being rate limited for account
500 500 Internal Server Error
503 503 Service Unavailable Try it again later
504 504 Gateway Timeout Check the result of your request later
1001 401 Authorization required
1002 401 Authorization failed
1003 403 Action is forbidden for this API key Check permissions for API key
1004 401 Unsupported authorisation method Use Basic authentication
2001 400 Symbol not found
2002 400 Currency not found
10001 400 Validation error Input not valid
20001 400 Insufficient funds Insufficient funds for creating order or any account operation
20002 400 Order not found Attempt to get active order that not existing, filled, canceled or expired.
20003 400 Limit exceeded Withdrawal limit exceeded
20004 400 Transaction not found Requested transaction not found
20005 400 Payout not found
20006 400 Payout already committed
20007 400 Payout already rolled back
20008 400 Duplicate clientOrderId
20010 400 Address generation error Unable to generate a new deposit address. Try request later.
20011 400 Withdrawal not found The referenced withdrawal was not found.
20012 400 Withdrawals disabled Withdrawals are disabled for this currency or system wide. Check system status page.
20013 400 Withdrawal amount below minimum Minimum withdrawal amount for any currency is Withdraw Fee * 2.
20014 400 Withdrawal address invalid Ensure the address you are withdrawing to is correct.
20015 400 Payment ID Required This currency requires a paymentId when making a withdrawal request.
20016 400 Invalid confirmation code The provided confirmation code is incorrect.
20017 400 Withdraw already confirmed The withdrawal request has already been confirmed.

Websocket / Streaming API


Note: This API has recently been released - Let us know if you encounter any errors

Websocket API reference

Our Websocket API reference can be found here:
https://www.altilly.com/page/websocketapi

API Endpoint URL

The endpoint for our REST API is: wss://wsapi.altilly.com:2096

Authentication

Public methods do not require any authentication. Private methods use the "login" method to authenticate using your Api Key & API Secret. Once authenticated, you do not need to reauthenticate as long as your websocket connection remains active.

Datetime Formatting

Unless otherwise stated, all timestamps are returned in ISO8601 format in UTC. Example: "2018-04-01T00:00:00Z" or "2018-04-01T00:00:00.000Z". If a timestamp is returned as an Integer, then that is a Unix timestamp.

Number Formatting

All finance data such as price, quantity, and fee should be arbitrary precision numbers and string representation. Example: "5.39300000"

Helpful Classes

None yet avalable

Errors

All Errors are formatted with error code and message. We use the same error code numbers as the REST API. (HTTP status codes are not used)

{"jsonrpc":"2.0","error":{"code":10001,"message":"Invalid JSON Request"}}