# コイン市場 **API:** Data API **Endpoint:** `GET /v1/beta/coingecko/coins/markets` **Tags:** CoinGecko 1 回の呼び出しで多数のコインを扱うランク付き市場テーブルです。コインごとに 1 行で、`current_price`、`market_cap`、`market_cap_rank`、`total_volume`、`high_24h`、`low_24h`、`price_change_percentage_24h`、`circulating_supply`、`total_supply`、`max_supply`、`ath` と `atl`（日付付き）、`image` を含みます。`per_page` と `page` でページングし、`order`（時価総額、出来高、id の昇順または降順）で並べ替え、`ids` または `category` で絞り込みます。`price_change_percentage` を渡すと、対応する `price_change_percentage_24h_in_currency` フィールドが追加されます。リーダーボードやセグメントのスキャンに使います。既知の少数のコインの価格だけなら `get_coingecko_simple_price` の方がはるかに軽量で、1 つのコインの全体像には `get_coingecko_coins_id` を使います。 ### 料金の参考情報 - 計測方法：プランのリソースユニット。 - 参考リクエスト見積もり：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 | | --- | --- | --- | --- | --- | | `category` | query | no | string | コインのカテゴリで絞り込みます。 *詳細は [`/coins/categories/list`](/reference/coins-categories-list) を参照してください。 | | `ids` | query | no | string, default: "bitcoin" | コインの ID。複数のコインを照会する場合はカンマ区切りで指定します。 *詳細は [`/coins/list`](/reference/coins-list) を参照してください。 | | `include_rehypothecated` | query | no | boolean | 結果に再担保（rehypothecated）トークンを含めます。true の場合、`market_cap_rank_with_rehypothecated` フィールドを返します。 既定：false | | `include_tokens` | query | no | string, enum: "top", "all" | `symbols` での検索では、`all` を指定すると一致するすべてのトークンが含まれます。 既定の `top` は、時価総額または出来高で上位のトークンを返します。 | | `locale` | query | no | string, enum: "ar", "bg", "cs", "da", "de", "el", … | 言語背景。 既定：en | | `names` | query | no | string, default: "Bitcoin" | コインの名前。複数のコインを照会する場合はカンマ区切りで指定します。 | | `order` | query | no | string, enum: "market_cap_asc", "market_cap_desc", "volume_asc", "volume_desc", "id_asc", "id_desc" | フィールドで結果を並べ替えます。 既定：market_cap_desc | | `page` | query | no | integer | 結果をページ送りします。 既定：1 | | `per_page` | query | no | integer | 1 ページあたりの総結果数。 既定：100 有効な値：1...250 | | `precision` | query | no | string, enum: "full", "0", "1", "2", "3", "4", … | 通貨価格の小数桁数 | | `price_change_percentage` | query | no | string | 価格変化率の時間枠を含めます。複数の時間枠を照会する場合はカンマ区切りで指定します。 有効な値：`1h`、`24h`、`7d`、`14d`、`30d`、`200d`、`1y` | | `sparkline` | query | no | boolean | 7 日間の sparkline データを含めます。 既定：false | | `symbols` | query | no | string, default: "btc" | コインのシンボル。複数のコインを照会する場合はカンマ区切りで指定します。 | | `vs_currency` | query | yes | string, default: "usd" | コインと市場データの基準通貨。 *詳細は [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies) を参照してください。 | ## Responses ### 200 — 市場データ付きのコイン一覧 Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: `Response860C3Ae68Ea5_CoinsMarkets` (`#/components/schemas/Response860C3Ae68Ea5_CoinsMarkets`) Example: ```json [ { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "image": "https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400", "current_price": 77671, "market_cap": 1555886872303, "market_cap_rank": 1, "fully_diluted_valuation": 1555914058873, "total_volume": 33235034316, "high_24h": 78419, "low_24h": 76696, "price_change_24h": -747.3360347281705, "price_change_percentage_24h": -0.95302, "market_cap_change_24h": -15184401491.513184, "market_cap_change_percentage_24h": -0.9665, "circulating_supply": 20030493, "total_supply": 20030843, "max_supply": 21000000, "ath": 126080, "ath_change_percentage": -38.39571, "ath_date": "2025-10-06T18:57:42.558Z", "atl": 67.81, "atl_change_percentage": 114443.23093, "atl_date": "2013-07-06T00:00:00.000Z", "roi": null, "last_updated": "2026-05-18T12:49:21.599Z", "market_cap_rank_with_rehypothecated": 1, "sparkline_in_7d": { "price": [ 81045.84776489827, 81001.73089268175, 80898.20817826076 ] }, "price_change_percentage_1h_in_currency": 0.5823392426906319, "price_change_percentage_24h_in_currency": -0.9530164743774191, "price_change_percentage_7d_in_currency": -4.042267423689584, "price_change_percentage_14d_in_currency": -1.5720857443461431, "price_change_percentage_30d_in_currency": 1.9453890367549207, "price_change_percentage_200d_in_currency": -29.452371850925864, "price_change_percentage_1y_in_currency": -25.214612207475373 } ] ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### Response860C3Ae68Ea5_CoinsMarkets `#/components/schemas/Response860C3Ae68Ea5_CoinsMarkets` ```json { "type": "array", "items": { "type": "object", "required": [ "id", "symbol", "name", "image", "current_price", "market_cap", "market_cap_rank", "fully_diluted_valuation", "total_volume", "high_24h", "low_24h", "price_change_24h", "price_change_percentage_24h", "market_cap_change_24h", "market_cap_change_percentage_24h", "circulating_supply", "total_supply", "max_supply", "ath", "ath_change_percentage", "ath_date", "atl", "atl_change_percentage", "atl_date", "roi", "last_updated" ], "properties": { "id": { "type": "string", "description": "コイン ID" }, "symbol": { "type": "string", "description": "トークンシンボル" }, "name": { "type": "string", "description": "トークン名" }, "image": { "type": "string", "description": "コイン画像の URL" }, "current_price": { "type": [ "number", "null" ], "description": "対象通貨での現在価格" }, "market_cap": { "type": [ "number", "null" ], "description": "対象通貨での時価総額" }, "market_cap_rank": { "type": [ "integer", "null" ], "description": "時価総額ランク" }, "fully_diluted_valuation": { "type": [ "number", "null" ], "description": "対象通貨での完全希薄化評価額" }, "total_volume": { "type": [ "number", "null" ], "description": "対象通貨での総取引量" }, "high_24h": { "type": [ "number", "null" ], "description": "対象通貨での 24 時間高値" }, "low_24h": { "type": [ "number", "null" ], "description": "対象通貨での 24 時間安値" }, "price_change_24h": { "type": [ "number", "null" ], "description": "対象通貨での 24 時間の価格変動" }, "price_change_percentage_24h": { "type": [ "number", "null" ], "description": "24 時間の価格変動率" }, "market_cap_change_24h": { "type": [ "number", "null" ], "description": "対象通貨での 24 時間の時価総額変動" }, "market_cap_change_percentage_24h": { "type": [ "number", "null" ], "description": "24 時間の時価総額変動率" }, "circulating_supply": { "type": [ "number", "null" ], "description": "流通供給量" }, "total_supply": { "type": [ "number", "null" ], "description": "総供給量" }, "max_supply": { "type": [ "number", "null" ], "description": "最大供給量" }, "ath": { "type": [ "number", "null" ], "description": "対象通貨での過去最高値" }, "ath_change_percentage": { "type": [ "number", "null" ], "description": "史上最高値の変化率" }, "ath_date": { "type": [ "string", "null" ], "format": "date-time", "description": "史上最高値の日付" }, "atl": { "type": [ "number", "null" ], "description": "対象通貨での過去最安値" }, "atl_change_percentage": { "type": [ "number", "null" ], "description": "史上最安値の変化率" }, "atl_date": { "type": [ "string", "null" ], "format": "date-time", "description": "史上最安値の日付" }, "roi": { "type": [ "object", "null" ], "description": "投資収益率データ", "properties": { "times": { "type": "number", "description": "投資収益率の倍率" }, "currency": { "type": "string", "description": "投資収益率の通貨" }, "percentage": { "type": "number", "description": "投資収益率（%）" } } }, "last_updated": { "type": "string", "format": "date-time", "description": "最終更新タイムスタンプ" }, "market_cap_rank_with_rehypothecated": { "type": [ "integer", "null" ], "description": "再担保トークンを含む時価総額ランク" }, "sparkline_in_7d": { "type": "object", "description": "過去 7 日間の sparkline 価格データ", "properties": { "price": { "type": "array", "items": { "type": "number" }, "description": "価格値の配列" } } }, "price_change_percentage_1h_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 1 時間の価格変動率" }, "price_change_percentage_24h_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 24 時間の価格変動率" }, "price_change_percentage_7d_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 7 日間の価格変動率" }, "price_change_percentage_14d_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 14 日間の価格変動率" }, "price_change_percentage_30d_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 30 日間の価格変動率" }, "price_change_percentage_200d_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 200 日間の価格変動率" }, "price_change_percentage_1y_in_currency": { "type": [ "number", "null" ], "description": "対象通貨での 1 年間の価格変動率" } } } } ```