This is a RESTful API for crypto tracker-like websites, it provides user authentication, cryptocurrency market data and more!
For more information, see the documentation below.
Go to cryptotracker.rocks to try our API!
Note: currently not available
- Price Historical route is not available for now
- For local usage you need to set up Postgresql and Redis:
- Set Up Redis
-
Authentication
-
Setting
-
Profile
-
Friend List (new)
-
Administration
-
Transaction
-
Crypto Information
-
Subscribe
-
Recommendation
- Recommendation (new)
-
Test
- Make a Transaction (new)
Authorization
Notification
Issues
npm install redis redis-server --save
Install redis using brew:
$ brew install redis
Run redis in terminal:
$ redis-server
Congratulation! You are all set.
-
Request
POST /registerParameters Data Type Required / Optional Description username string Required length 6-30, no space email string Required your email password string Required length 8-20, must have upper, lower case and digits, no space firstname string Required your first name lastname string Required your last name public string Optional, true by defualt If you willing to share you profile Response
{
"user": {
"email": "your email",
"password": "your password",
"firstname": "your first name",
"lastname": "your last name",
"public": "true/false",
"administrator": "true/false",
"createAt": "some date",
"upedateAt": "some date"
},
"token": "xxx"
} {
"error": "Some error message"
}-
Request
POST /verify/registerParameters Data Type Required / Optional Description username string Required length 6-30, no space email string Required your email password string Required length 8-20, must have upper, lower case and digits, no space firstname string Required your first name lastname string Required your last name public string Optional, true by defualt If you willing to share you profile Response
{
"success": "true",
"message": "We sent a link to your email, please check your email and activate your account"
} {
"error": "Some error message"
}-
Request
POST /loginParameters Data Type Required / Optional Description email/email string Required your email or username password string Required your password
{
"user": {
"email": "your email",
"password": "your password",
"firstname": "your first name",
"lastname": "your last name",
"public": "true/false",
"administrator": "true/false",
"createAt": "some date",
"upedateAt": "some date"
},
"token": "xxx"
} {
"error": "Error message showing that why it didn't login successfully"
}-
Purpose: Set your account to public
Request
GET /user/publicheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
{
"message": "Your status has been changed to public"
} {
"error": "reason why your request failed"
}-
Purpose: Set your account to private
Request
GET /user/privateheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
{
"message": "Your status has been changed to private"
} {
"error": "reason why your request failed"
}-
Request
PUT /user/settingheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Parameters Data Type Required / Optional Description email string Required your email password string Required your password firstname string Required your first name lastname string Required your last name public string Optional, true by defualt If you willing Response
{
"email": "your email",
"password": "your password",
"firstname": "your first name",
"lastname": "your last name",
"public": "true/false",
"administrator": "true/false",
"createAt": "some date",
"upedateAt": "some date"
} {
"error": "reason why your request failed"
}-
Request
GET /user/settingheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
{
"email": "your email",
"password": "your password",
"firstname": "your first name",
"lastname": "your last name",
"public": "true/false",
"administrator": "true/false",
"createAt": "some date",
"upedateAt": "some date"
} {
"error": "reason why your request failed"
}-
Request
POST /user/profileheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Parameters Data Type Required / Optional Description email String Optional Your contact email github String Optional Your github account interest String Optional Your interest areas investment String Optional Your current investment Response
{
"email": "your email",
"github": "your github account",
"interest": "your interest areas",
"investment": "req.body.investment",
"createAt": "some date",
"upedateAt": "some date"
} {
"error": "reason why your request failed"
}-
Request
GET /user/profileheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
{
"email": "your email",
"github": "your github account",
"interest": "your interest areas",
"investment": "req.body.investment",
"createAt": "some date",
"upedateAt": "some date"
} {
"error": "reason why your request failed"
}-
Request
PUT /user/profileheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Parameters Data Type Required / Optional Description email String Optional Your contact email github String Optional Your github account interest String Optional Your interest areas investment String Optional Your current investment Response
{
"email": "your email",
"github": "your github account",
"interest": "your interest areas",
"investment": "req.body.investment",
"createAt": "some date",
"upedateAt": "some date"
} {
"error": "reason why your request failed"
}-
Request
GET /user/profile/clearheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
{
"email": "",
"github": "",
"interest": "",
"investment": "",
"createAt": "some date",
"upedateAt": "some date"
} {
"error": "reason why your request failed"
}- This feature is for users managing their list of friends.
-
Request
POST /user/profile/friendsParameters Data Type Required / Optional Description userId string Required user id of the friend Response
{
"id": 1,
"email": "test01@email",
"github": "test01.github",
"interest": "coding",
"investment": "10000",
"friends": [
"user-5b4h5w8jjki83tj",
"user-5b4h5w8jjki80es",
"user-5b4h5w8jjki7wl7"
],
"createdAt": "2018-07-13T21:52:23.566Z",
"updatedAt": "2018-07-17T04:44:22.660Z",
"userId": "user-5b4h5w8jjki7sq9"
}-
Request
POST /user/profile/friends/searchnameParameters Data Type Required / Optional Description username string Required username of the friend Response All users' information which matches given Username
[
{
"id": "user-5b4h5w8jjki7wl7",
"email": "[email protected]",
"username": "test02",
"password": "35bacce75bdb5c98e3a2afbe6c1b57df",
"firstname": "Test",
"lastname": "01",
"public": true,
"administrator": false,
"createdAt": "2018-07-13T21:38:27.643Z",
"updatedAt": "2018-07-13T21:38:27.643Z"
}
]-
Request
GET /user/profile/friendsParameters Data Type Required / Optional Description userId string Required user id of the friend Response
[
{
"username": "test04",
"id": "user-5b4h5w8jjki83tj"
},
{
"username": "test03",
"id": "user-5b4h5w8jjki80es"
},
{
"username": "test01",
"id": "user-5b4h5w8jjki7sq9"
},
{
"username": "test02",
"id": "user-5b4h5w8jjki7wl7"
}
]-
Request
DELETE /user/profile/friends/deleteParameters Data Type Required / Optional Description userId string Required user id of the friend
-
Request
POST /user/profile/friends/portfolioParameters Data Type Required / Optional Description userId string Required user id of the friend
- This feature is for setting up adminstrator and website management.
-
Request
POST /adminregisterParameters Data Type Required / Optional Description email string Required your email password string Required your password firstname string Required your first name lastname string Required your last name public string Optional If you willing to share you profile Response
{
"user": {
"email": "your email",
"password": "your password",
"firstname": "your first name",
"lastname": "your last name",
"public": "true/false",
"administrator": "true",
"createAt": "some date",
"upedateAt": "some date"
},
"token": "xxx"
} {
"error": "reason why your request failed"
}-
list all the users in database
Request
GET /administrator/listheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
[
{
"email": "your email",
"password": "your password",
"firstname": "your first name",
"lastname": "your last name",
"public": "true/false",
"administrator": "true",
"createAt": "some date",
"upedateAt": "some date"
},
{
},
] {
"error": "error messages"
}-
Request
POST /administrator/sendallheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Parameters Data Type Required / Optional Description subject string Optional subject message string Optional message content string Optional html content included in email
- This feature is for users to make trasaction and check their current assets.
-
Make a transaction
Request
POST /user/make-transactionheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Parameters Data Type Required / Optional Description sell_type string required Selling coin's type sell_price double required Coin's value in USD sell_amount double required Selling coins amount income_type string required Income type (USD for example) income_price double required Currency's value in USD income_amount double required Income amount Response
[
{
"id": "transaction id",
"sell_type": "BTC",
"sell_price": "6000",
"sell_amount": "2",
"income_type": "USD",
"income_price": "1",
"income_amount": "12000",
"createAt": "some date",
"upedateAt": "some date",
"portfolioId": "The associate portfolio id",
}
] {
"error": "error messages"
}-
Check user's current assets (All the currency type and amount the user recently hold)
Request
GET /user/assetheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
[
{
"id": "transaction id",
"type": "BTC",
"amount": "2",
"createAt": "some date",
"upedateAt": "some date",
"portfolioId": "The associate portfolio id",
},
{
},
] {
"error": "error messages"
}-
List all the transactions the user has made
Request
GET /user/transactionsheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
[
{
"id": 6,
"sell_type": "BTC",
"sell_price": 6000,
"sell_amount": 10,
"income_type": "USD",
"income_price": 1,
"income_amount": 6000,
"createdAt": "2018-07-10T00:32:56.310Z",
"updatedAt": "2018-07-10T00:32:56.310Z",
"portfolioId": 7
},
{
"id": 7,
"sell_type": "BTC",
"sell_price": 6000,
"sell_amount": 10,
"income_type": "USD",
"income_price": 1,
"income_amount": 6000,
"createdAt": "2018-07-11T00:32:56.310Z",
"updatedAt": "2018-07-11T00:32:56.310Z",
"portfolioId": 7
},
] {
"error": "Some error message"
}-
Get the current list of all cryptocurrencies and the following information about each coin.
Request
GET /user/coinlistheader Data Type Required / Optional Description authorization jwt token Required Your jwt token Response
{
"BTC": {
"Id": "1182",
"Url": "/coins/btc/overview",
"ImageUrl": "/media/19633/btc.png",
"Name": "BTC",
"Symbol": "BTC",
"CoinName": "Bitcoin",
"FullName": "Bitcoin (BTC)",
"Algorithm": "SHA256",
"ProofType": "PoW",
"FullyPremined": "0",
"TotalCoinSupply": "21000000",
"PreMinedValue": "N/A",
"TotalCoinsFreeFloat": "N/A",
"SortOrder": "1",
"Sponsored": false
},
"ETH": {},
} {
"error": "error messages"
}Returns all the exchanges that CryptoCompare has integrated with.
Request
GET /user/exchange-list
| header | Data Type | Required / Optional | Description |
|---|---|---|---|
| authorization | jwt token | required | Your jwt token |
Response
{
"Cryptsy":
{
"42":["BTC","XRP"],
"EMC2":["BTC","XRP"],
"POINTS":["BTC"],
"VTC":["BTC","LTC","XRP"]
}
} {
"error": "error messages"
}Get the current price of any cryptocurrency in any other currency.
Request
POST /user/price
| header | Data Type | Required / Optional | Description |
|---|---|---|---|
| authorization | jwt token | required | Your jwt token |
| Parameters | Data Type | Required / Optional | Description |
|---|---|---|---|
| fsym | string | required | From symbal |
| tsyms | array of strings | required | To Symbol(s) |
Response
{
"USD": 1100.24,
"BTC": 0.16
} {
"error": "error messages"
}Works like price, except it allows you to specify a matrix of From Symbols.
Request
POST /user/price-multi
| header | Data Type | Required / Optional | Description |
|---|---|---|---|
| authorization | jwt token | required | Your jwt token |
| Parameters | Data Type | Required / Optional | Description |
|---|---|---|---|
| fsym | array of strings | required | From symbal |
| tsyms | array of strings | required | To Symbol(s) |
Response
{
"BTC": {"USD": 6213.54}
} {
"error": "error messages"
}Get all the current trading info (price, vol, open, high, low, etc.) of any list of cryptocurrencies in any other currency.
Request
POST /user/price-historical
| header | Data Type | Required / Optional | Description |
|---|---|---|---|
| authorization | jwt token | required | Your jwt token |
| Parameters | Data Type | Required / Optional | Description |
|---|---|---|---|
| fsym | array of strings | required | From symbal |
| tsyms | array of strings | required | To Symbol(s) |
| time (Date) | date | required | Date in history that you want price data for |
Response
{
"BTC": {
"USD": {
"TYPE": "5",
"MARKET": "CCCAGG",
"FROMSYMBOL": "BTC",
"TOSYMBOL": "USD",
"FLAGS": "4",
"PRICE": 1152.42,
"LASTUPDATE": 1487865689,
"LASTVOLUME": 0.21,
"LASTVOLUMETO": 242.20349999999996,
"LASTTRADEID": 1224703,
"VOLUME24HOUR": 53435.45299122338,
"VOLUME24HOURTO": 60671593.843186244,
"OPEN24HOUR": 1119.31,
"HIGH24HOUR": 1170,
"LOW24HOUR": 1086.641,
"LASTMARKET": "itBit",
"CHANGE24HOUR": 33.11000000000013,
"CHANGEPCT24HOUR": 2.958072383879366,
"SUPPLY": 16177825,
"MKTCAP": 18643649086.5
},
"EUR": "..."
},
"ETH": "..."
}
-
Subscribe a currency that user like Request
POST /user/subscribeheader Data Type Required / Optional Description authorization jwt token required Your jwt token Parameters Data Type Required / Optional Description symbol String required coin's symbol Response
message: some success messageerror: some error message
-
Subscribe a currency that user like Request
POST /user/unsubscribeheader Data Type Required / Optional Description authorization jwt token required Your jwt token Parameters Data Type Required / Optional Description symbol String required coin's symbol Response
message: some success messageerror: some error message
-
Recommend Users or Coins base on user's current portfolio
For this function you need to install redis and its server, and run redis in backend
npm install redis redis-server --saveInstall redis using brew:
$ brew install redisRun redis in terminal:
$ redis-serverCongratulation! You are all set.
-
Returns an ranked sorted array of Coins' symbol which represent the top recommendations for that individual user based on knn. number is the number of recommendations you want to receive. asking for recommendations queries the 'recommendedZSet' sorted set for the user.
Request
POST /user/recommend/coinsheader Data Type Required / Optional Description authorization jwt token required Your jwt token Parameters Data Type Required / Optional Description number Integer required How many coins do you want to recommend to user Response
[
"BTC",
"ETH"
] {
"error": "error message"
}-
Request
POST /user/recommend/usersheader Data Type Required / Optional Description authorization jwt token required Your jwt token Parameters Data Type Required / Optional Description
returns an array of the 'similarityZSet' ranked sorted set for the user which
represents their ranked similarity to all other users given the Jaccard Coefficient. the value is between -1 and 1. -1 means that the user is the exact opposite, 1 means they're exactly the same. ex. results = ['garyId', 'andrewId', 'jakeId']
Response
[
"Huang Xiaoming",
"Sun Zhongshan",
"Li Bai"
] {
"error": "error message"
}--
-
-
To make a random transaction for every user in the DB:
- Go to your project's folder
- run:
$ npm run make_a_transaction - control + c to exit the script
-
-
-
Every route start with baseURL/user/ will check the token sent by a client, and the server will recognize the token and know which user you are. If you update your email, username or password, the token will expire. Also, the token will expire after it was generated 24h.
-
Our backend will send a confirmation link when user registers his/her account. The link contains an encrypted parameter which includes user registration information. When the user clicks the link backend verify and decode the parameter using a private key to acquire the user's registration information then create an account accordingly.
-
-
- Administrators can manually send notifications to every user's email. Whereas at every day 8 am users will receive an email containing the latest news about the coin they hold the most.
-
-
We are currently using Gmail for sending email, which could cause problems when it comes to sending bulk emails.
-
When sending notifications, server traverses the every user. And traverse every coin the user has. The time complexity will be O(n * m), which should be improved.
-
All the array parameters are not available, you can only pass one single parameter instead!
-
Update setting can set username and email but does not check if they are duplicated.
-
For recommendation, we use user-based recommendation. The problems with this method are that in the early stage of the product, there is no sufficient user's behaviors data. Second, how to store the users' similarity to the relational database is a question. The space complexity of the data will be O(n^2).
-