CoinGecko Simple Price 응답을 코인별 배열 구조의 ApiFuse 형식으로 정규화합니다.

CoinGecko Simple Price

통화별 중첩 price 맵을 코인별 레코드 배열로 펼쳐서 AI가 쓰기 쉬운 응답으로 제공합니다.

엔드포인트

GET /v1/coingecko

Upstream

Base URL: https://api.coingecko.com
Path: /api/v3/simple/price

요청 파라미터

파라미터	타입	필수	기본값	설명
`ids`	string	❌	`bitcoin`	코인 ID (comma-separated: bitcoin,ethereum)
`vsCurrencies`	string	❌	`krw,usd`	기준 통화 (comma-separated)

요청 예시

{
  "ids": "bitcoin",
  "vsCurrencies": "krw,usd"
}

응답 스키마

아래 스키마는 adapter의 Zod output schema에서 직접 생성됩니다.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "코인 ID"
      },
      "name": {
        "type": "string",
        "description": "코인 이름"
      },
      "krwPrice": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "description": "원화 가격"
      },
      "usdPrice": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "description": "달러 가격"
      },
      "krwChange24h": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "description": "KRW 24시간 등락률 (%)"
      },
      "usdChange24h": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "description": "USD 24시간 등락률 (%)"
      }
    },
    "required": [
      "id",
      "name",
      "krwPrice",
      "usdPrice",
      "krwChange24h",
      "usdChange24h"
    ],
    "additionalProperties": false
  }
}

응답 예시

{
  "data": [
    {
      "id": "bitcoin",
      "name": "Bitcoin",
      "krwPrice": 106351362,
      "usdPrice": 71096,
      "krwChange24h": -0.9054190681859636,
      "usdChange24h": 0.41894814093888266
    },
    {
      "id": "ethereum",
      "name": "Ethereum",
      "krwPrice": 3227192,
      "usdPrice": 2157.38,
      "krwChange24h": -0.9598395299801665,
      "usdChange24h": 0.36380036717236
    }
  ],
  "pagination": null,
  "meta": {
    "source": "coingecko",
    "fetchedAt": "2026-03-24T00:00:00.000Z"
  }
}

정규화 사항

중첩된 코인 맵 응답을 id/name 기반 배열로 평탄화합니다.
krw/usd 가격과 24시간 변동률을 명시적 필드로 분리합니다.
누락된 통화 값은 null로 유지해 스키마를 안정적으로 맞춥니다.
요청 파라미터는 vsCurrencies → vs_currencies 형태로 upstream에 맞춰 변환됩니다.

CoinGecko Simple Price

On this page