# 거래소 티커

**API:** Data API

**Endpoint:** `GET /v1/beta/coingecko/exchanges/{id}/tickers`

**Tags:** CoinGecko

한 거래소에 상장된 모든 거래 쌍을 페이지 단위로 조회합니다. `base`, `target`, `market`, `last`, `volume`, `converted_last`, `converted_volume`, `trust_score`, `bid_ask_spread_percentage`, `timestamp`, `trade_url`, `is_anomaly` / `is_stale` 플래그가 포함됩니다. `coin_ids`로 특정 자산만 좁히고, `order`로 정렬하며, `depth`를 설정해 호가창 이동 비용을 추가하세요. 한 거래소의 커버리지나 유동성을 감사할 때 사용하세요. 한 코인의 모든 거래소 쌍은 `get_coingecko_coins_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: "binance" | 거래소 ID입니다. *참조: [`/exchanges/list`](/reference/exchanges-list). |
| `coin_ids` | query | no | string | 코인 ID로 티커를 필터링하며, 코인이 2개 이상이면 쉼표로 구분합니다. *[`/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` |
| `include_exchange_logo` | query | no | boolean | 거래소 로고를 포함합니다. 기본값: false |
| `order` | query | no | string, enum: "market_cap_asc", "market_cap_desc", "trust_score_desc", "trust_score_asc", "volume_desc", "volume_asc", … | 응답 순서를 정렬합니다. 기본값: `trust_score_desc` |
| `page` | query | no | number | 결과를 페이지 단위로 조회합니다. |

## Responses

### 200 — 거래소 티커

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

**application/json**

Schema: `Response860C3Ae68Ea5_CoinsIdTickers` (`#/components/schemas/Response860C3Ae68Ea5_CoinsIdTickers`)

Example:

```json
{
  "name": "Binance",
  "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": 77172.88,
      "volume": 9243.62632,
      "cost_to_move_up_usd": 21983152.092277337,
      "cost_to_move_down_usd": 19695552.01703934,
      "converted_last": {
        "btc": 0.99912594,
        "eth": 36.349604,
        "usd": 77080
      },
      "converted_volume": {
        "btc": 9236,
        "eth": 336002,
        "usd": 712501236
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010013,
      "timestamp": "2026-05-26T10:32:37+00:00",
      "last_traded_at": "2026-05-26T10:32:37+00:00",
      "last_fetch_at": "2026-05-26T10:33:31+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": 1545160286928.7285
    },
    {
      "base": "BTC",
      "target": "USDC",
      "market": {
        "name": "Binance",
        "identifier": "binance",
        "has_trading_incentive": false,
        "logo": "https://coin-images.coingecko.com/markets/images/52/small/binance.jpg?1706864274"
      },
      "last": 77189.96,
      "volume": 2736.40541,
      "cost_to_move_up_usd": 5747075.588603265,
      "cost_to_move_down_usd": 4869585.811774237,
      "converted_last": {
        "btc": 1.000158,
        "eth": 36.386207,
        "usd": 77159
      },
      "converted_volume": {
        "btc": 2737,
        "eth": 99567,
        "usd": 211138535
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.010013,
      "timestamp": "2026-05-26T10:32:01+00:00",
      "last_traded_at": "2026-05-26T10:32:01+00:00",
      "last_fetch_at": "2026-05-26T10:33:30+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://www.binance.com/en/trade/BTC_USDC?ref=37754157",
      "token_info_url": null,
      "coin_id": "bitcoin",
      "target_coin_id": "usd-coin",
      "coin_mcap_usd": 1545160286928.7285
    }
  ]
}
```

### 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)"
          }
        }
      }
    }
  }
}
```