# 암호화폐 뉴스

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/news`

**Tags:** CoinGecko

CoinGecko의 암호화폐 뉴스 헤드라인으로, `coin_id`, `language`, `type`(`news` 또는 `guides`)으로 필터링하고 `page`와 `per_page`로 페이지를 나눕니다. 가용성 경고: 이 엔드포인트는 CoinGecko Analyst 이상 플랜으로 제한되며, 현재 업스트림 구독에서는 본문에 업그레이드 메시지와 함께 HTTP 401을 반환합니다. 업스트림 플랜이 바뀔 때까지 사용할 수 없는 것으로 간주하세요. 현재 동작하는 코인 컨텍스트는 `get_coingecko_coins_id`가 공식 채널을 포함한 `description`과 `links`를 반환합니다.

### 가격 참고

- 과금 방식: 요청당 참조.
- 참조 요청 추정치: 제공되지 않음.

참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `coin_id` | query | no | string | CoinGecko 코인 ID로 뉴스를 필터링합니다. |
| `language` | query | no | string | 언어로 뉴스를 필터링합니다. |
| `type` | query | no | string, enum: "news", "guides" | 기사 유형으로 필터링합니다. |
| `page` | query | no | integer, default: 1 | 결과를 페이지 단위로 조회합니다. |
| `per_page` | query | no | integer, default: 100 | 페이지당 총 결과 수입니다. |

## Responses

### 200 — 뉴스 기사 배열입니다.

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: array

```json
{
  "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
  }
}
```

Example:

```json
[
  {
    "title": "Example market news",
    "url": "https://example.com/article",
    "posted_at": "2026-09-01T00:00:00Z",
    "source_name": "Example Publisher"
  }
]
```

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 업스트림 공급자가 반환한 CoinGecko 플랜 제한 또는 권한 부여 오류입니다.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "object",
      "additionalProperties": true
    },
    "error": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "additionalProperties": true
}
```

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 작업이 실패했습니다. Felo 지원에 문의할 때 응답의 요청 ID를 보관하세요.