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

# Crypto News

> Crypto news headlines from CoinGecko. Requires an upstream Analyst plan — currently returns 401.

Crypto news headlines from CoinGecko, filterable by `coin_id`, `language` and `type` (`news` or `guides`), paged with `page` and `per_page`. Availability warning: this endpoint is restricted to CoinGecko Analyst plans and above, and on the current upstream subscription it returns HTTP 401 with an upgrade message in the body. Treat it as unavailable until the upstream plan changes. For coin context that does work today, [`get_coingecko_coins_id`](/docs/api-reference/coingecko/get_coingecko-coins-id) returns `description` and `links` including official channels.


## OpenAPI

````yaml openapi/coingecko.json GET /coingecko/news
openapi: 3.0.3
info:
  title: CoinGecko API
  version: 1.0.0
  description: >-
    CoinGecko crypto market data routed through the AIsa gateway. Covers coin
    metadata, live and historical prices, OHLC, exchanges, tickers, categories,
    and trending search. Proxies the public CoinGecko v3 API at
    `https://api.coingecko.com/api/v3/`.
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /coingecko/news:
    get:
      summary: Crypto News
      description: >-
        Crypto news headlines from CoinGecko, filterable by `coin_id`,
        `language` and `type` (`news` or `guides`), paged with `page` and
        `per_page`. Availability warning: this endpoint is restricted to
        CoinGecko Analyst plans and above, and on the current upstream
        subscription it returns HTTP 401 with an upgrade message in the body.
        Treat it as unavailable until the upstream plan changes. For coin
        context that does work today, `get_coingecko_coins_id` returns
        `description` and `links` including official channels.
      operationId: get_coingecko_news
      parameters:
        - name: coin_id
          in: query
          schema:
            type: string
          description: Filter news by CoinGecko coin ID.
          example: bitcoin
        - name: language
          in: query
          schema:
            type: string
          description: Filter news by language.
          example: en
        - name: type
          in: query
          schema:
            type: string
            enum:
              - news
              - guides
          description: Filter by article type.
          example: news
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page through results.
        - name: per_page
          in: query
          schema:
            type: integer
            default: 100
          description: Total results per page.
      responses:
        '200':
          description: Array of news articles.
          content:
            application/json:
              example:
                data:
                  - title: Bitcoin hits new high
                    url: https://example.com/article
                    published_at: 1713398400
              schema:
                $ref: '#/components/schemas/CoinGeckoNewsArticleArray'
        '401':
          description: >-
            CoinGecko plan restriction or authorization error returned by the
            upstream provider.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CoinGeckoError'
components:
  schemas:
    CoinGeckoNewsArticleArray:
      type: array
      items:
        type: object
        properties:
          title:
            type: string
          url:
            type: string
          image:
            type: string
          author:
            type: string
          posted_at:
            type: string
          type:
            type: string
          source_name:
            type: string
          related_coin_ids:
            type: array
            items:
              type: string
        additionalProperties: true
    CoinGeckoError:
      type: object
      properties:
        status:
          type: object
          additionalProperties: true
        error:
          type: object
          additionalProperties: true
      additionalProperties: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key

````