# コインのティッカー

**API:** Data API

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

**Tags:** CoinGecko

1 つのコインの全取引所にわたるすべての取引ペアです。`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`（信頼スコアまたは出来高）で並べ替えます。1 つの資産がどこで取引され、各板の厚みがどれほどかを比較するのに使います。コインを問わず 1 つの取引所のすべてのペアを見るには、`get_coingecko_exchanges_id_tickers` を使います。

### 料金の参考情報

- 計測方法：プランのリソースユニット。
- 参考リクエスト見積もり：USD 0.008。
- ユニットコスト基準：USD 0.0。
- リソースユニット：`provider_credit`。
- コスト基準は、ゼロの場合も含め、最終的な顧客価格を確定するものではありません。

参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは 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" | `symbol` に設定すると、DEX ペアの基軸通貨と対象通貨がシンボルで表示されます。 既定：`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）"
          }
        }
      }
    }
  }
}
```
