crypto-news-api

CryptoControl Crypto News API

Official Node.js client for the CryptoControl.io API. The CryptoControl Node.js client lets developers access rich formatted articles from cryptonews sources from all around the world.

Installation

Node

npm install crypto-news-api --save

Bower - Browser/Web

bower install crypto-news-api --save

<script src="./bower_components/crypto-news-api/dist/bundle.js"></script>

Usage

First make sure that you've recieved an API key by visiting https://cryptocontrol.io/apis. With the API key, you can write the following code.

NOTE: API access is rate-limited to 5 req/sec and 10,000 req/hour. It'll be a good idea to cache your API calls.

Node.js ES6/Typescript

import CryptoNewsApi from 'crypto-news-api'

const Api = new CryptoNewsApi('API_KEY_HERE')

Api.getTopNews()
    .then(articles => console.log(articles))
    .catch(error => console.error(error))

Node.js ES5

var CryptoNewsAPI = require('crypto-news-api').default

const Api = new CryptoNewsAPI('API_KEY_HERE')

Api.getTopNews()
    .then(function (articles) { console.log(articles) })
    .catch(function (error) { console.log(error) })

Bower/Webpack

<script src="./bower_components/crypto-news-api/dist/bundle.js"></script>
<script>
    const Api = new window.CryptoNewsApi('API_KEY_HERE')

    Api.getTopNews()
        .then(articles => console.log(articles))
        .catch(error => console.error(error))
</script>

Available Functions

• getTopNews() Get the top news articles from the CryptoControl News API.
• getLatestNews() Get the latest news articles from the CryptoControl News API.
• getTopNewsByCategory() Get news articles grouped by category from the CryptoControl News API.
• getTopNewsByCoin(coinSlug: String) Get the top news articles for a specific coin from the CryptoControl API.
• getLatestNewsByCoin(coinSlug: String) Get the latest news articles for a specific coin from the CryptoControl News API.
• getTopNewsByCoinCategory(coinSlug: String) Get news articles grouped by category for a specific coin from the CryptoControl News API.

The coin slugs are the coin id's used from the CoinMarketCap api. You can see the full list of coins here: https://api.coinmarketcap.com/v1/ticker/?limit=2000

Sample Response from the API

[
    {
        "publishedAt": "2018-05-23T06:30:51.000Z",
        "hotness": 70698.68569444444,
        "activityHotness": 1.6,
        "primaryCategory": "General",
        "words": 302,
        "similarArticles": [
            {
                "publishedAt": "2018-05-23T03:00:05.000Z",
                "_id": "5b04de8d18f173000f9a6d72",
                "title": "PayPal: We’ll ‘Definitely Support’ Bitcoin If It Becomes ‘Better Currency’",
                "url": "https://cryptocontrol.io/r/api/article/5b04de8d18f173000f9a6d72?ref=5ac11440ec0af7be35528459"
            }
        ],
        "coins": [
            {
                "_id": "59cb59e81c073f09e76f614b",
                "name": "Bitcoin",
                "slug": "bitcoin",
                "tradingSymbol": "btc"
            }
        ],
        "_id": "5b07ea76214428000f55a513",
        "description": "Welcome to Crypto Daily™ News, this news piece \"Ripple XRP And Bitcoin Cash Now Live On Revolut\" is breaking news from the Crypto sector.",
        "title": "Ripple XRP And Bitcoin Cash Now Live On Revolut - Crypto Daily™",
        "url": "https://cryptocontrol.io/r/api/article/5b07ea76214428000f55a513?ref=5ac11440ec0af7be35528459",
        "thumbnail": "https://cryptocontrol.io/r/thumbnail/5b07ea76214428000f55a513?ref=5ac11440ec0af7be35528459",
        "originalImageUrl": "https://cryptodaily.co.uk/wp-content/uploads/2018/05/ripple-bitcoincash-credit.jpg"
    }
]