エンドポイント
すべて GET、JSON を返し、キーは不要です。
| エンドポイント | 返すもの |
|---|---|
| /api/v1/market | 指定スコープのランキング 1 ページ分とスナップショットのメタデータ |
| /api/v1/cards/<id> | id 指定のカード 1 件。掲載外なら 404 とエラー本文 |
クエリパラメータ
不正な値は既定値に黙って戻さず、HTTP 400 を返します。
| パラメータ | 受け付ける値 | 備考 |
|---|---|---|
| scope | all、pokemon、one-piece、watchlist | それ以外は 400 |
| page | 正の整数 | 数値でない場合や 0 は 400 |
| pageSize | 正の整数 | サーバ側の上限で丸められる |
レスポンスのフィールド
マーケットのレスポンスはカード一覧をスナップショットの識別情報で包んでいるため、保存したレスポンスは常に生成元のビルドまで辿れます。
| フィールド | 意味 |
|---|---|
| generation | レスポンスの元になったスナップショットビルドの識別子 |
| generatedAt | スナップショットが構築された日時 |
| effectiveAt | 数値が表す日付 |
| coverage | 掲げた対象範囲に対する充足度 |
| count | このレスポンスに含まれるカード数 |
| cards | 順位付けされたカード。各々に価格・鑑定枚数・時価総額 |
リクエスト例
ポケモンスコープの 1 ページ目を取得する：
curl -s "https://cardzmarketcap.com/api/v1/market?scope=pokemon&page=1"レスポンスはエッジで短時間キャッシュされます。どの日付の数値かは、レスポンス時刻ではなく effectiveAt フィールドで判断してください。
更新頻度
新しいスナップショットは毎日公開され、API は現在のものを配信します。過去の generation はこれらのエンドポイントからは取得できません。
レスポンスを保存する場合は generation と effectiveAt も一緒に保存してください。generation の異なる 2 つの数値は、日付なしでは比較できません。
フェアユース
API は公開かつ認証不要です。リクエスト頻度は常識の範囲に保ってください。1 ページ読んでキャッシュし、データの更新より速くポーリングしないでください。スナップショットは 1 日 1 回しか動きません。
過剰な自動アクセスはレート制限の対象になることがあります。一括取得が必要な場合は、スクレイピングではなくご相談ください。
出典表示とライセンス
数値は CC BY 4.0（https://creativecommons.org/licenses/by/4.0/）に基づき引用・再掲載できます。CardZ Marketcap を出典として明記し、引用したページまたはエンドポイントへリンクしてください。
時価総額は毎日の更新で再計算されるため、出典表記にはその数値の基準日を必ず併記してください。
出典表記
CardZ Marketcap、https://cardzmarketcap.com、データ基準日 2026-08-28
機械可読ファイル
クローラー、エージェント、言語モデル向け：
- /llms.txt — サイトと主要ページの短い説明
- /llms-full.txt — 算出方法の要約を含む拡張版
- /sitemap.xml — インデックス対象の全ページ
CardZ Marketcap はトレカの価格指数です。暗号資産でもトークンでも上場企業でもありません。ティッカーは存在せず、CARDS という名称の暗号資産とは無関係です。
