# 코인 티커 **API:** Data API **Endpoint:** `GET /v1/beta/coingecko/coins/{id}/tickers` **Tags:** CoinGecko 한 코인의 모든 거래 쌍을 거래소별로 조회합니다. `base`, `target`, `market`, `last`, `volume`, `converted_last`, `converted_volume`, `trust_score`, `bid_ask_spread_percentage`, `last_traded_at`, `trade_url`, 이상 플래그 `is_anomaly`와 `is_stale`이 포함됩니다. `depth`를 설정하면 `cost_to_move_up_usd`와 `cost_to_move_down_usd`가 추가됩니다. `exchange_ids`로 좁히고, `page`로 페이지를 나누며, `order`(신뢰 점수 또는 거래량)로 정렬하세요. 한 자산이 어디서 거래되고 각 호가창이 얼마나 깊은지 비교할 때 사용하세요. 코인과 무관하게 한 거래소의 모든 쌍은 `get_coingecko_exchanges_id_tickers`를 사용하세요. ### 가격 참고 - 과금 방식: 플랜 리소스 단위. - 참조 요청 추정치: USD 0.008. - 단위 원가 기준: USD 0.0. - 리소스 단위: `provider_credit`. - 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다. 참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 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 | | --- | --- | --- | --- | --- | | `id` | path | yes | string, default: "bitcoin" | 코인 ID입니다. *참조: [`/coins/list`](/reference/coins-list) | | `depth` | query | no | boolean | 2% 오더북 깊이, 즉 `cost_to_move_up_usd`와 `cost_to_move_down_usd`를 포함합니다. 기본값: false | | `dex_pair_format` | query | no | string, enum: "contract_address", "symbol" | DEX 페어의 기준 통화와 대상 통화를 심볼로 표시하려면 `symbol`로 설정하세요. 기본값: `contract_address` | | `exchange_ids` | query | no | string | 거래소 ID입니다. *참조: [`/exchanges/list`](/reference/exchanges-list) | | `include_exchange_logo` | query | no | boolean | 거래소 로고를 포함합니다. 기본값: false | | `order` | query | no | string, enum: "trust_score_desc", "trust_score_asc", "volume_desc", "volume_asc" | 응답 순서를 정렬합니다. 기본값: trust_score_desc | | `page` | query | no | integer | 결과를 페이지 단위로 조회합니다. | ## Responses ### 200 — 코인 티커 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: `Response860C3Ae68Ea5_CoinsIdTickers` (`#/components/schemas/Response860C3Ae68Ea5_CoinsIdTickers`) Example: ```json { "name": "Bitcoin", "tickers": [ { "base": "BTC", "target": "USDT", "market": { "name": "Binance", "identifier": "binance", "has_trading_incentive": false, "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274" }, "last": 76894.07, "volume": 13786.06991, "cost_to_move_up_usd": 19320706.3958517, "cost_to_move_down_usd": 16360235.3694131, "converted_last": { "btc": 0.99664066, "eth": 36.004874, "usd": 76856 }, "converted_volume": { "btc": 13740, "eth": 496366, "usd": 1059536991 }, "trust_score": null, "bid_ask_spread_percentage": 0.010013, "timestamp": "2026-05-18T13:37:29+00:00", "last_traded_at": "2026-05-18T13:37:29+00:00", "last_fetch_at": "2026-05-18T13:37:29+00:00", "is_anomaly": false, "is_stale": false, "trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157", "token_info_url": null, "coin_id": "bitcoin", "target_coin_id": "tether", "coin_mcap_usd": 1544810408447.1313 } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### Response860C3Ae68Ea5_CoinsIdTickers `#/components/schemas/Response860C3Ae68Ea5_CoinsIdTickers` ```json { "type": "object", "required": [ "name", "tickers" ], "properties": { "name": { "type": "string", "description": "코인 이름" }, "tickers": { "type": "array", "description": "티커 목록", "items": { "type": "object", "required": [ "base", "target", "market", "last", "volume", "converted_last", "converted_volume", "trust_score", "bid_ask_spread_percentage", "timestamp", "last_traded_at", "last_fetch_at", "is_anomaly", "is_stale", "trade_url", "token_info_url", "coin_id", "target_coin_id", "coin_mcap_usd" ], "properties": { "base": { "type": "string", "description": "티커 기준 통화" }, "target": { "type": "string", "description": "티커 대상 통화" }, "market": { "type": "object", "description": "거래소 정보", "properties": { "name": { "type": "string", "description": "거래소 이름" }, "identifier": { "type": "string", "description": "거래소 식별자" }, "has_trading_incentive": { "type": "boolean", "description": "거래소 거래 인센티브" }, "logo": { "type": "string", "description": "거래소 로고 URL" } } }, "last": { "type": "number", "description": "최근 가격" }, "volume": { "type": "number", "description": "거래량" }, "cost_to_move_up_usd": { "type": "number", "description": "가격을 2% 상승시키는 데 드는 비용(USD)" }, "cost_to_move_down_usd": { "type": "number", "description": "가격을 2% 하락시키는 데 드는 비용(USD)" }, "converted_last": { "type": "object", "description": "환산 최근 가격", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "converted_volume": { "type": "object", "description": "환산 거래량", "properties": { "btc": { "type": "number" }, "eth": { "type": "number" }, "usd": { "type": "number" } } }, "trust_score": { "type": [ "string", "null" ], "description": "신뢰 점수" }, "bid_ask_spread_percentage": { "type": "number", "description": "매수-매도 호가 스프레드 비율" }, "timestamp": { "type": "string", "description": "티커 타임스탬프" }, "last_traded_at": { "type": "string", "description": "최근 거래 타임스탬프" }, "last_fetch_at": { "type": "string", "description": "최근 조회 타임스탬프" }, "is_anomaly": { "type": "boolean", "description": "티커 이상 여부" }, "is_stale": { "type": "boolean", "description": "티커 만료 여부" }, "trade_url": { "type": "string", "description": "거래 URL" }, "token_info_url": { "type": [ "string", "null" ], "description": "토큰 정보 URL" }, "coin_id": { "type": "string", "description": "기준 통화 코인 ID" }, "target_coin_id": { "type": "string", "description": "대상 통화 코인 ID" }, "coin_mcap_usd": { "type": "number", "description": "코인 시가총액(USD)" } } } } } } ```