# Ticker sàn

**API:** Data API

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

**Tags:** CoinGecko

Mọi cặp giao dịch được niêm yết trên một sàn, có phân trang: `base`, `target`, `market`, `last`, `volume`, `converted_last`, `converted_volume`, `trust_score`, `bid_ask_spread_percentage`, `timestamp`, `trade_url` và cờ `is_anomaly` / `is_stale`. Thu hẹp theo tài sản cụ thể bằng `coin_ids`, sắp xếp bằng `order`, và đặt `depth` để thêm chi phí dịch chuyển sổ lệnh. Dùng để kiểm toán độ phủ hoặc thanh khoản của một sàn. Với các cặp của một đồng tiền trên mọi sàn, dùng `get_coingecko_coins_id_tickers` thay thế.

### Tham chiếu giá

- Đo lường: Đơn vị tài nguyên theo gói.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.008.
- Cơ sở chi phí đơn vị: USD 0.0.
- Đơn vị tài nguyên: `provider_credit`.
- Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của 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 sàn. *tham chiếu [`/exchanges/list`](/reference/exchanges-list). |
| `coin_ids` | query | no | string | Lọc ticker theo ID coin, phân tách bằng dấu phẩy nếu truy vấn nhiều hơn 1 coin. *tham khảo [`/coins/list`](/reference/coins-list). |
| `depth` | query | no | boolean | Bao gồm độ sâu sổ lệnh 2% (cost_to_move_up_usd và cost_to_move_down_usd). Mặc định: false |
| `dex_pair_format` | query | no | string, enum: "contract_address", "symbol" | Đặt thành `symbol` để hiển thị base và target của cặp DEX dưới dạng ký hiệu. Mặc định: `contract_address` |
| `include_exchange_logo` | query | no | boolean | Bao gồm logo sàn. Mặc định: false |
| `order` | query | no | string, enum: "market_cap_asc", "market_cap_desc", "trust_score_desc", "trust_score_asc", "volume_desc", "volume_asc", … | Sắp xếp thứ tự phản hồi. Mặc định: `trust_score_desc` |
| `page` | query | no | number | Phân trang kết quả. |

## Responses

### 200 — Ticker sàn

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ 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 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response860C3Ae68Ea5_CoinsIdTickers

`#/components/schemas/Response860C3Ae68Ea5_CoinsIdTickers`

```json
{
  "type": "object",
  "required": [
    "name",
    "tickers"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tên đồng tiền"
    },
    "tickers": {
      "type": "array",
      "description": "Danh sách ticker",
      "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": "Đơn vị tiền tệ cơ sở của ticker"
          },
          "target": {
            "type": "string",
            "description": "Đơn vị tiền tệ đích của ticker"
          },
          "market": {
            "type": "object",
            "description": "Thông tin sàn",
            "properties": {
              "name": {
                "type": "string",
                "description": "Tên sàn"
              },
              "identifier": {
                "type": "string",
                "description": "Mã định danh sàn"
              },
              "has_trading_incentive": {
                "type": "boolean",
                "description": "Ưu đãi giao dịch của sàn"
              },
              "logo": {
                "type": "string",
                "description": "URL logo sàn"
              }
            }
          },
          "last": {
            "type": "number",
            "description": "Giá gần nhất"
          },
          "volume": {
            "type": "number",
            "description": "Khối lượng giao dịch"
          },
          "cost_to_move_up_usd": {
            "type": "number",
            "description": "Chi phí để tăng giá 2% tính bằng USD"
          },
          "cost_to_move_down_usd": {
            "type": "number",
            "description": "Chi phí để giảm giá 2% tính bằng USD"
          },
          "converted_last": {
            "type": "object",
            "description": "Giá gần nhất quy đổi",
            "properties": {
              "btc": {
                "type": "number"
              },
              "eth": {
                "type": "number"
              },
              "usd": {
                "type": "number"
              }
            }
          },
          "converted_volume": {
            "type": "object",
            "description": "Khối lượng giao dịch quy đổi",
            "properties": {
              "btc": {
                "type": "number"
              },
              "eth": {
                "type": "number"
              },
              "usd": {
                "type": "number"
              }
            }
          },
          "trust_score": {
            "type": [
              "string",
              "null"
            ],
            "description": "Điểm tin cậy"
          },
          "bid_ask_spread_percentage": {
            "type": "number",
            "description": "Phần trăm chênh lệch giá mua-bán"
          },
          "timestamp": {
            "type": "string",
            "description": "Dấu thời gian của ticker"
          },
          "last_traded_at": {
            "type": "string",
            "description": "Dấu thời gian giao dịch gần nhất"
          },
          "last_fetch_at": {
            "type": "string",
            "description": "Dấu thời gian lấy dữ liệu gần nhất"
          },
          "is_anomaly": {
            "type": "boolean",
            "description": "Ticker có bất thường hay không"
          },
          "is_stale": {
            "type": "boolean",
            "description": "Ticker có lỗi thời hay không"
          },
          "trade_url": {
            "type": "string",
            "description": "URL giao dịch"
          },
          "token_info_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL thông tin token"
          },
          "coin_id": {
            "type": "string",
            "description": "ID đồng tiền của đơn vị tiền tệ cơ sở"
          },
          "target_coin_id": {
            "type": "string",
            "description": "ID đồng tiền của đơn vị tiền tệ đích"
          },
          "coin_mcap_usd": {
            "type": "number",
            "description": "Vốn hóa thị trường của đồng tiền tính bằng USD"
          }
        }
      }
    }
  }
}
```
