CryptoCompare

CryptoCompare News API

Crypto news articles, sources, categories, and search.

GitHub OpenAPI

Operations 7

GET /news/v1/article/list Get News Article List #
GET /news/v1/source/list Get News Source List #
GET /news/v1/category/list Get News Category List #
GET /v2/news/ Get Latest News Articles #
GET /news/feeds Get News Sources #
GET /news/categories Get News Categories #
GET /news/feedsandcategories Get News Feeds and Categories #

Documentation

📖
Documentation
https://developers.coindesk.com/documentation/legacy/Price/SingleSymbolPriceEndpoint
📖
Authentication
https://min-api.cryptocompare.com/documentation
📖
Documentation
https://developers.coindesk.com/documentation/data-api/introduction
📖
Authentication
https://developers.coindesk.com/documentation/data-api/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/openapi/cryptocompare-news-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-fullticker-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-ohlcvcandle-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-newsarticle-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-coinlistentry-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-exchange-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-blockchaindatapoint-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-socialstats-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-orderbookl1-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-indextick-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/json-schema/cryptocompare-asset-schema.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/overlays/cryptocompare-news-api-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/examples/cryptocompare-getSingleSymbolPrice-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/examples/cryptocompare-getHistoricalDailyOHLCV-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/examples/cryptocompare-getTopListByTotalVolumeFull-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/examples/cryptocompare-getLatestNewsArticles-example.json
🔗
Signup
https://www.cryptocompare.com/cryptopian/api-keys
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cryptocompare/refs/heads/main/examples/cryptocompare-getIndexLatestTick-example.json
🔗
Signup
https://developers.coindesk.com/pricing/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cryptocompare-news-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cryptocompare-news-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Cryptocompare News API
  version: '1.0'
  description: 'Operations tagged News across 2 of this provider''s published API definitions: cryptocompare-data-api-openapi.yml, cryptocompare-min-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://data-api.cryptocompare.com
  description: Production Server
- url: https://min-api.cryptocompare.com/data
  description: Production Server
security:
- apiKeyQuery: []
- apiKeyHeader: []
tags:
- name: News
  description: Crypto news articles, sources, categories, and search.
paths:
  /news/v1/article/list:
    get:
      operationId: getNewsArticleList
      summary: Get News Article List
      description: Returns the most recent news articles aggregated across integrated sources. Supports filtering by language, source, category, search keyword, and timestamp.
      tags:
      - News
      parameters:
      - name: lang
        in: query
        description: ISO 639-1 language code (default EN).
        schema:
          type: string
          default: EN
      - name: source_ids
        in: query
        description: Comma-separated list of source IDs.
        schema:
          type: string
      - name: source_key
        in: query
        description: Source key (e.g. coindesk).
        schema:
          type: string
      - name: categories
        in: query
        description: Comma-separated list of category keys.
        schema:
          type: string
      - name: exclude_categories
        in: query
        description: Comma-separated list of category keys to exclude.
        schema:
          type: string
      - name: search_string
        in: query
        description: Full-text search query.
        schema:
          type: string
      - name: to_ts
        in: query
        description: Upper bound timestamp (seconds).
        schema:
          type: integer
          format: int64
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: News article list envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsArticleListResponse'
    servers:
    - url: https://data-api.cryptocompare.com
      description: Production Server
  /news/v1/source/list:
    get:
      operationId: getNewsSourceList
      summary: Get News Source List
      description: Returns the list of integrated news sources.
      tags:
      - News
      parameters:
      - name: lang
        in: query
        description: Filter sources by language.
        schema:
          type: string
      - name: source_type
        in: query
        description: Filter sources by type (RSS, TWITTER, API).
        schema:
          type: string
      responses:
        '200':
          description: News source list envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsSourceListResponse'
    servers:
    - url: https://data-api.cryptocompare.com
      description: Production Server
  /news/v1/category/list:
    get:
      operationId: getNewsCategoryList
      summary: Get News Category List
      description: Returns the list of news categories used for tagging articles.
      tags:
      - News
      responses:
        '200':
          description: News category list envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsCategoryListResponse'
    servers:
    - url: https://data-api.cryptocompare.com
      description: Production Server
  /v2/news/:
    get:
      operationId: getLatestNewsArticles
      summary: Get Latest News Articles
      description: Returns the most recent cryptocurrency news articles aggregated from every integrated source. Filterable by language, source, and category.
      tags:
      - News
      parameters:
      - name: lang
        in: query
        description: ISO 639-1 language code. Defaults to EN.
        schema:
          type: string
          default: EN
      - name: feeds
        in: query
        description: Comma-separated list of source feed keys.
        schema:
          type: string
      - name: categories
        in: query
        description: Comma-separated list of category keys.
        schema:
          type: string
      - name: excludeCategories
        in: query
        description: Comma-separated list of categories to exclude.
        schema:
          type: string
      - name: lTs
        in: query
        description: Latest timestamp (seconds) to return articles before.
        schema:
          type: integer
          format: int64
      - name: sortOrder
        in: query
        description: Sort order, latest or popular.
        schema:
          type: string
          enum:
          - latest
          - popular
      - name: limit
        in: query
        description: Number of articles to return (default 50).
        schema:
          type: integer
          default: 50
      responses:
        '200':
          description: List of news articles with source and category metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsListResponse'
    servers:
    - url: https://min-api.cryptocompare.com/data
      description: Production Server
  /news/feeds:
    get:
      operationId: getNewsSources
      summary: Get News Sources
      description: Returns the list of news source feeds available for filtering.
      tags:
      - News
      responses:
        '200':
          description: List of news sources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsSourcesResponse'
    servers:
    - url: https://min-api.cryptocompare.com/data
      description: Production Server
  /news/categories:
    get:
      operationId: getNewsCategories
      summary: Get News Categories
      description: Returns the list of news categories used for tagging articles.
      tags:
      - News
      responses:
        '200':
          description: List of news categories.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsCategoriesResponse'
    servers:
    - url: https://min-api.cryptocompare.com/data
      description: Production Server
  /news/feedsandcategories:
    get:
      operationId: getNewsFeedsAndCategories
      summary: Get News Feeds and Categories
      description: Returns both available source feeds and categories in a single call.
      tags:
      - News
      responses:
        '200':
          description: Feeds and categories envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsFeedsAndCategoriesResponse'
    servers:
    - url: https://min-api.cryptocompare.com/data
      description: Production Server
components:
  parameters:
    LimitParam:
      name: limit
      in: query
      description: Number of data points to return.
      schema:
        type: integer
        default: 30
        maximum: 2000
  schemas:
    NewsCategoryListResponse:
      type: object
      properties:
        Data:
          type: array
          items:
            type: object
            properties:
              TYPE:
                type: string
              ID:
                type: integer
              NAME:
                type: string
              CATEGORY:
                type: string
    NewsArticle:
      type: object
      properties:
        TYPE:
          type: string
        ID:
          type: integer
        GUID:
          type: string
        PUBLISHED_ON:
          type: integer
          format: int64
        IMAGE_URL:
          type: string
        TITLE:
          type: string
        SUBTITLE:
          type: string
        AUTHORS:
          type: string
        URL:
          type: string
        SOURCE_ID:
          type: integer
        BODY:
          type: string
        KEYWORDS:
          type: string
        LANG:
          type: string
        UPVOTES:
          type: integer
        DOWNVOTES:
          type: integer
        SCORE:
          type: integer
        SENTIMENT:
          type: string
          enum:
          - POSITIVE
          - NEUTRAL
          - NEGATIVE
        STATUS:
          type: string
        CREATED_ON:
          type: integer
          format: int64
        SOURCE_DATA:
          type: object
        CATEGORY_DATA:
          type: array
          items:
            type: object
    NewsSourceListResponse:
      type: object
      properties:
        Data:
          type: array
          items:
            type: object
            properties:
              TYPE:
                type: string
              ID:
                type: integer
              SOURCE_KEY:
                type: string
              NAME:
                type: string
              URL:
                type: string
              LANG:
                type: string
              SOURCE_TYPE:
                type: string
              LAUNCH_DATE:
                type: integer
                format: int64
              BENCHMARK_SCORE:
                type: number
              STATUS:
                type: string
    NewsArticleListResponse:
      type: object
      properties:
        Data:
          type: array
          items:
            $ref: '#/components/schemas/NewsArticle'
        Err:
          type: object
    NewsSourcesResponse:
      type: object
      properties:
        Message:
          type: string
        Type:
          type: integer
        Data:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
              name:
                type: string
              lang:
                type: string
              img:
                type: string
    NewsFeedsAndCategoriesResponse:
      type: object
      properties:
        Type:
          type: integer
        Message:
          type: string
        Data:
          type: object
          properties:
            Feeds:
              type: array
              items:
                type: object
            Categories:
              type: array
              items:
                type: object
    NewsListResponse:
      type: object
      properties:
        Type:
          type: integer
        Message:
          type: string
        Promoted:
          type: array
          items:
            type: object
        Data:
          type: array
          items:
            $ref: '#/components/schemas/NewsArticle'
    NewsCategoriesResponse:
      type: object
      properties:
        Message:
          type: string
        Type:
          type: integer
        Data:
          type: array
          items:
            type: object
            properties:
              categoryName:
                type: string
              wordsAssociatedWithCategory:
                type: array
                items:
                  type: string
  securitySchemes:
    apiKeyQuery:
      type: apiKey
      name: api_key
      in: query
      description: API key supplied as the api_key query parameter.
    apiKeyHeader:
      type: apiKey
      name: Authorization
      in: header
      description: 'API key supplied as `Authorization: Apikey {apiKey}`.'
x-refined-from:
- cryptocompare-data-api-openapi.yml
- cryptocompare-min-api-openapi.yml