Documentation

Use below GET endpoints to obtain ticker and general crypto news. To further refine and filter news results use our STRING parameters.

Use this endpoint to obtain news for one ticker/symbol. In this example "BTC" is the ticker for Bitcoin.

If you want to retrieve news for multiple tickers/symbols separate them with a comma.

Important: The Timezone of all news are displayed is Eastern Timezone (GMT -0400).

Use below endpoint to retrieve General Crypto News.

Use below endpoint to view all tickers/symbols in our Database. This endpoint can be accessed once per day (non-trial).

Number of news items returned. Items value must be between 1 and 50. This parameter is required.

Use below parameter if you would like to download the data as a .csv file.

Use below parameters if you want to filter on news sources. Use a comma if you would like to include/exclude multiple news sources. To view the list of all news sources: Click here

Use below parameters if you only would like to retrieve video or article news.

Use this parameter if you would like to filter only on neutral, positive or negative news.

Use this parameter if you would like to sort by importance. This parameter uses our rank score algorithm. Sort by Rank is only compatible with Crypto Ticker News endpoint. It provides a better user experience for sites and apps. Adding &days will sort by rank but for the last X days.

By default our news is sorted by date (newest first). If you would like to showcase oldest news first, use below parameter:

Use these parameters if you would like to retrieve News ID or Event ID field on the GET response.

Use below parameter if you would like to retrieve our rank score.

You can also combine extra-fields parameters.

For more advanced features use below endpoints and parameters.

If you want to retrieve all the news published under All crypto tickers, use below endpoint.

Retrieve the top 50 most mentioned tickers. Use the &date= parameter to specify your desired date range.

By default this endpoint has a cache of 1 hour. To not have any delay add parameter.

Retrieve the daily sentiment of Tickers and General Crypto News. Use the &date= Parameter to specify your desired date range. For Individual tickers/symbols use below endpoint:

For All Tickers/symbols use below endpoint.

For General Crypto News use below endpoint.

By default this endpoint has a cache of 1 hour. To not have any delay add parameter.

Note: The Sentiment Score ranges from -1.5 (Negative) to +1.5 (Positive) and is based on the # of positive and negative news on a specific timeframe.

Retrieve the latest news events and eventIDs. Events are important headlines that are receiving a significant amount of news coverage.

Add &eventid= to retrieve all news item from a specific event:

To search for events related to a specific ticker use below request:

By default this endpoint has a cache of 1 hour. To not have any delay add parameter.

Use the date parameters to obtain historical news (up to December 2020). Please use the following format: MMDDYYYY. You can also use: last5min, last10min, last15min, last30min, last45min, last60min, today, yesterday, last7days, last30days, last60days, last90days, yeartodate.

Filter on exact time. The format is hours, minutes and seconds - HHMMSS. This parameter is only compatible with &date parameter.

Use this parameter to filter topics. To view the available topics: Click here

  Topics "Digital Yuan" AND "Libra".

  Topics "Technical Analysis" OR "Libra".

  Exclude the Topic "Stablecoins".

Or you can use your own Keywords:

  Search keywords "Congress" AND "Hard Fork".

  Search keywords "Congress" OR "Hard Fork".

Use the page parameter if you would like to obtain more than 50 news results.

If a specific crypto ticker/symbol doesn't have any news associated with it you can use the fallback parameter to obtain general crypto news. This parameter is useful for sites and apps to avoid showing empty responses to users.

Basic

Premium | Business

If you have any feedback or questions, don't hesitate to contact us.