Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ccxt-rest/ccxt-rest
Open Source Unified REST API of 100+ Crypto Exchange Sites (18k+ docker pulls) - https://ccxt-rest.io/
https://github.com/ccxt-rest/ccxt-rest
altcoin api arbitrage bitcoin bot btc crypto cryptocurrency docker eth ethereum exchange rest trading
Last synced: 7 days ago
JSON representation
Open Source Unified REST API of 100+ Crypto Exchange Sites (18k+ docker pulls) - https://ccxt-rest.io/
- Host: GitHub
- URL: https://github.com/ccxt-rest/ccxt-rest
- Owner: ccxt-rest
- License: mit
- Created: 2018-06-09T21:52:07.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-27T19:08:22.000Z (almost 2 years ago)
- Last Synced: 2024-10-25T22:31:06.623Z (13 days ago)
- Topics: altcoin, api, arbitrage, bitcoin, bot, btc, crypto, cryptocurrency, docker, eth, ethereum, exchange, rest, trading
- Language: JavaScript
- Homepage:
- Size: 6.49 MB
- Stars: 462
- Watchers: 24
- Forks: 81
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Connect to 100+ Crypto Currency eXchange Trading platforms using the same REST API!
[](https://travis-ci.org/ccxt-rest/ccxt-rest)
[](https://npmjs.com/package/ccxt-rest)
[](https://www.npmjs.com/package/ccxt-rest)
[](https://img.shields.io/docker/pulls/ccxtrest/ccxt-rest.svgt)
[](https://github.com/ccxt/ccxt/wiki/Exchange-Markets)
[](https://gitter.im/ccxt-rest/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://adroit.ph/ccxt-rest-contact-us/)
# Table of Contents
- [Table of Contents](#table-of-contents)
- [Introduction](#introduction)
- [Installation](#installation)
- [Docker](#docker)
- [NPM Package](#npm-package)
- [Getting Started](#getting-started)
- [Providing API Keys and Secret](#providing-api-keys-and-secret)
- [List All Supported Currency Pairs](#list-all-supported-currency-pairs)
- [Get Ticker for a Currency Pair](#get-ticker-for-a-currency-pair)
- [Get Order Book for a Currency Pair](#get-order-book-for-a-currency-pair)
- [Placing an Order](#placing-an-order)
- [Cancelling an Order](#cancelling-an-order)
- [API](#api)
- [Exchange Summary](#exchange-summary)
- [Feature / Support Request](#feature--support-request)
# Introduction
CCXT-REST provides a Unified REST APIs to allow clients access to retrieve data (ticker, order book, trades, your order, your trades, balances, etc) and to create and cancel orders from over 100 cryptocurrency exhange sites. And it is built on top of the popular open source project [CCXT](https://github.com/ccxt/ccxt/)
# Installation
You can install either through docker or as a global node package
## Docker
```bash
$ docker run -p 3000:3000 ccxtrest/ccxt-rest
```
## NPM Package
```bash
$ npm install -g ccxt-rest
$ ccxt-rest
```
# Getting Started
CCXT-REST supports over 100 crytpocurrency exchange sites. If you want to access public data, for most exchanges, you can access them directly without any API Keys or Secret.
* `GET:/exchanges/{exchangeName}/markets`
* `GET:/exchanges/{exchangeName}/ticker`
* `GET:/exchanges/{exchangeName}/tickers`
* `GET:/exchanges/{exchangeName}/orderBook`
* `GET:/exchanges/{exchangeName}/trades`
In binance, it would look something like this
* `GET:/exchanges/binance/markets`
* `GET:/exchanges/binance/ticker?symbol=BTC/USDT`
* `GET:/exchanges/binance/tickers`
* `GET:/exchanges/binance/orderBook?symbol=BTC/USDT`
* `GET:/exchanges/binance/trades?symbol=BTC/USDT`
However, some exchanges though require you to have an API Key and Secret even when accessing public data. For example, for cointiger, you would need to get an API Key and Secret first from cointiger [see cointiger's official documentation for more info](https://github.com/cointiger/api-docs-en/wiki#create-api-key), and then you would need to provide those to `ccxt-rest`
* `POST:/exchanges/cointiger -d {"id":"myCoinTiger","apiKey":"myApiKey","secret":"$hcreT"}`
* `GET:/exchanges/cointiger/markets -H 'Authorization: Bearer xxx.yyy.zzz'`(_where `xxx.yyy.zzz` was part of the response of `POST:/exchanges/cointiger`_)
* `GET:/exchanges/cointiger/ticker?symbol=BTC/LTC -H 'Authorization: Bearer xxx.yyy.zzz'`
* `GET:/exchanges/cointiger/tickers -H 'Authorization: Bearer xxx.yyy.zzz'`
* `GET:/exchanges/cointiger/orderBook?symbol=BTC/LTC -H 'Authorization: Bearer xxx.yyy.zzz'`
* `GET:/exchanges/cointiger/trades?symbol=BTC/LTC -H 'Authorization: Bearer xxx.yyy.zzz'`
Lastly, for private data like your user orders, trades, balances and for actions like placing and cancelling orders, you would definitely need to provide the API Key and Secret for your exchange to `ccxt-rest`.
*****
_**Note: The API listing below is now comprehensive. For a full list of APIs supported, see https://ccxt-rest.io**_
*****
## Providing API Keys and Secret
```bash
$ curl -X POST http://localhost:3000/exchange/binance \
-H 'Accept: application/json'
-d {
"id" : "myBinance",
"apiKey" : "myApiKey",
"secret" : "s3cr3t"
}
```
This would then return something like this
```
{
"token":"xxx.yyy.zzz"
}
```
## List All Supported Currency Pairs
```bash
$ curl -X GET http://localhost:3000/exchange/binance/markets \
-H 'Accept: application/json'
```
## Get Ticker for a Currency Pair
```bash
$ curl -X GET http://localhost:3000/exchange/binance/ticker?symbol=BTC/USDT \
-H 'Accept: application/json'
```
## Get Order Book for a Currency Pair
```bash
$ curl -X GET http://localhost:3000/exchange/binance/orderBook?symbol=BTC/USDT \
-H 'Accept: application/json'
```
## Placing an Order
```bash
$ curl -X POST http://localhost:3000/exchange/binance/order \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer xxx.yyy.zzz'
-d {
"symbol": "string",
"type": "market",
"side": "buy",
"amount": 0,
"price": 0
}
```
## Cancelling an Order
_Note: `12345` is the id of the order you want to cancel_
```bash
$ curl -X DELETE http://localhost:3000/exchange/binance/order/12345 \
-H 'Accept: application/json'
-H 'Authorization: Bearer xxx.yyy.zzz'
```
# API
For a complete list of API, see https://ccxt-rest.io
# Exchange Summary
For a full list of supported exchanges and as to which of their APIs are public, private or even broken, checkout https://ccxt-rest.io/docs/exchange_api_status. The format there looks something like this
_**Note: The table below is just an example. This does NOT represent the current state of these API statuses**_
| Exchange | Connect | Market | Ticker | Tickers | Order Book | Trades |
| -------- | ------- | ------ | ------ | ------- | ---------- | ------ |
| ... | ... | ... | ... | ... | ... | ... |
| _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ |
| binance |  |  |  | |  |  |
| coinspot |  |  |  | |  |  |
| gemini |  |  |  | |  |  |
| kraken |  |  |  | |  |  |
| poloniex |  |  |  | |  |  |
| _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ | _(sample only)_ |
| ... | ... | ... | ... | ... | ... | ... |
_**Note: The table above is just an example. This does NOT represent the current state of these API statuses**_
For full list of the current statuses, see https://ccxt-rest.io/docs/exchange_api_status
# Feature / Support Request
Need a feature or need support? Reach out and let us know what you need.
[](https://adroit.ph/ccxt-rest-contact-us/)