> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 💼 Crypto News

> This endpoint allows you to **query the latest crypto news and guides on CoinGecko**

<Tip>
  ### Tips

  * You may obtain the coin ID (API ID) via several ways:
    * Refer to respective coin page and find 'API ID'.
    * Refer to [`/coins/list`](/reference/coins-list) endpoint.
    * Refer to Google Sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing).
  * Without specifying `coin_id`, it returns all latest news as seen on [CoinGecko News](https://www.coingecko.com/en/news) (news only, no guides).
  * When `coin_id` is specified, it returns both news and guides by default (`type=all`). You can use the `type` parameter to filter by news or guides only.
  * `page` supports up to 20 pages, and `per_page` supports up to 20 results per page.
    * You can retrieve up to the latest 400 news articles in total.
  * CoinGecko equivalent page: [https://www.coingecko.com/en/news](https://www.coingecko.com/en/news).
</Tip>

<Note>
  ### Note

  * Cache / Update Frequency: every 1 minute.
  * Exclusive for Analyst, Lite, Pro and Enterprise plan subscribers.
</Note>


## OpenAPI

````yaml api-reference/coingecko-pro.json get /news
openapi: 3.0.0
info:
  title: CoinGecko Pro API
  version: 3.0.0
servers:
  - url: https://pro-api.coingecko.com/api/v3
security:
  - apiKeyAuth: []
  - apiKeyQueryParam: []
paths:
  /news:
    get:
      tags:
        - News
      summary: 💼 Crypto News
      description: >-
        This endpoint allows you to **query the latest crypto news and guides on
        CoinGecko**
      operationId: news
      parameters:
        - name: page
          in: query
          description: |-
            page through results 
             Default value: **1**
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
            maximum: 20
        - name: per_page
          in: query
          description: |-
            total results per page 
             Default value: **10**
          required: false
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 20
        - name: coin_id
          in: query
          description: |-
            filter news by coin ID 
             *refers to [`/coins/list`](/reference/coins-list).
          required: false
          schema:
            type: string
        - name: language
          in: query
          description: |-
            filter news by language 
             Default value: **en**
          required: false
          schema:
            type: string
            default: en
            enum:
              - en
              - ru
              - de
              - pl
              - es
              - vi
              - fr
              - pt-br
              - ar
              - bg
              - cs
              - da
              - el
              - fi
              - he
              - hi
              - hr
              - hu
              - id
              - it
              - ja
              - ko
              - lt
              - nl
              - 'no'
              - ro
              - sk
              - sl
              - sv
              - th
              - tr
              - uk
              - zh
              - zh-tw
        - name: type
          in: query
          description: |-
            filter news by type 
             Default value: **all** 
             Note: `guides` filter is only applicable if `coin_id` is specified and valid
          required: false
          schema:
            type: string
            default: all
            enum:
              - all
              - news
              - guides
      responses:
        '200':
          description: List latest crypto news
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/News'
components:
  schemas:
    News:
      type: array
      items:
        $ref: '#/components/schemas/NewsArticle'
      example:
        - title: 'Bitcoin stalls: Why BTC risks $65K fall despite $23M whale buy'
          url: >-
            https://ambcrypto.com/bitcoin-stalls-why-btc-risks-65k-fall-despite-23m-whale-buy/
          image: >-
            https://assets.coingecko.com/articles/images/106731445/large/open-uri20260327-7-fuq6r9.?1774609423
          author: Gladys Makena
          posted_at: '2026-03-27T11:00:42Z'
          type: news
          source_name: AMBCrypto
          related_coin_ids:
            - 1-token-2
            - 1-token
            - bitcoin
        - title: How to Fetch Historical Crypto Data with Python
          url: >-
            https://www.coingecko.com/learn/how-to-fetch-historical-crypto-data-with-python
          image: >-
            https://coin-images.coingecko.com/posts/images/102135584/large/How_To_Fetch_Historical_Crypto_Data_with_Python.png?1771925926
          author: Brian Lee
          posted_at: '2026-02-24T06:26:58Z'
          type: guide
          source_name: CoinGecko
          related_coin_ids:
            - bitcoin
    NewsArticle:
      type: object
      properties:
        title:
          type: string
          description: news article title
        url:
          type: string
          description: news article URL
        image:
          type: string
          description: news article image URL
        author:
          type: string
          description: news article author
        posted_at:
          type: string
          description: news article published timestamp in ISO 8601 format
        type:
          type: string
          description: news article type
          enum:
            - news
            - guide
        source_name:
          type: string
          description: news article source name
        related_coin_ids:
          type: array
          items:
            type: string
          description: related coin IDs
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-cg-pro-api-key
    apiKeyQueryParam:
      type: apiKey
      in: query
      name: x_cg_pro_api_key

````