coinpaprika-api

CoinPaprika API スキル

最新バージョンの確認（このスキルを参照する前に、セッションごとに1回実行してください）： このファイルのversion: 1.0.1です。最新ファイルのヘッダーを取得してください：

curl -s -r 0-400 https://raw.githubusercontent.com/coinpaprika/skills/main/coinpaprika-api/SKILL.md

リモートのversion:がこのファイルのものと異なる場合、このコピーは古くなっています。リモートファイル全体を取得して、こちらの代わりにそちらに従い、ローカルのコピーを置き換えてください。API の仕様は時間とともに変わるため、古いスキルでは古いエンドポイントやパラメーターを参照してしまう可能性があります。

2018年から運営されている、独立系の暗号資産データアグリゲーターです。12,000以上の暗号資産と350以上の取引所に対応しています。無料プランは、API キーなしですぐに利用できます。

• ドキュメント：https://docs.coinpaprika.com
• LLM 向けドキュメント：https://docs.coinpaprika.com/llms-full.txt
• 料金：https://coinpaprika.com/api/pricing
• GitHub：https://github.com/coinpaprika
• サポート：[email protected]

---

ベース URL と認証

無料プラン（API キー不要）

https://api.coinpaprika.com/v1/

月20,000回の呼び出し、2,000アセットまで対応します。API キーも登録も不要です。

curl -s "https://api.coinpaprika.com/v1/tickers/btc-bitcoin" | jq

有料プラン（Starter $99/mo から Enterprise まで）

https://api-pro.coinpaprika.com/v1/

Authorizationヘッダーに API キーが必要です：

curl -s "https://api-pro.coinpaprika.com/v1/tickers/btc-bitcoin" \
  -H "Authorization: ${COINPAPRIKA_API_KEY}" | jq

API キーをハードコードしないでください。環境変数に保存します：

export COINPAPRIKA_API_KEY="your_key_here"

プラン比較

プラン	料金	月間呼び出し数	アセット
無料	$0	20,000	2,000
Starter	$99	400,000	すべて
Pro	$199	1,000,000	すべて
Business	$799	5,000,000	すべて
Ultimate	$1,499	10,000,000	すべて
Enterprise	個別見積もり	無制限	すべて

レート制限：全プランで、IP ごとに毎秒10リクエストです。

---

統合オプション

オプション1：REST API（主要）

以下にすべてのエンドポイントを記載しています。プランに応じた適切なベース URL を使用してください。

オプション2：CLI

https://github.com/coinpaprika/coinpaprika-cli

ターミナルから暗号資産の市場データを利用できます。12,000以上の暗号資産、リアルタイム価格、OHLCV、取引所に対応しています。無料プランも利用できます。

CLI コマンドのリファレンスについては、references/cli-reference.mdを参照してください。

オプション3：MCP サーバー（AI IDE 向け）

Claude Desktop、Cursor、Windsurf、およびあらゆる MCP クライアントで利用できるホスト型 MCP サーバーです。

claude_desktop_config.jsonまたは同等のファイルに追加してください：

{
  "mcpServers": {
    "coinpaprika": {
      "url": "https://mcp.coinpaprika.com/sse"
    }
  }
}

ホスト型サーバーは、API キーなしですぐに利用できます。コイン、ティッカー、取引所、OHLCV、コントラクト、タグ、検索を照会するための31個のツールを公開しています。実際のtools/listでツール数を確認してください。

オプション4：SDK

言語	リポジトリ
Go	https://github.com/coinpaprika/coinpaprika-api-go-client
Python	https://github.com/coinpaprika/coinpaprika-api-python-client
Node.js	https://github.com/coinpaprika/coinpaprika-api-nodejs-client
PHP	https://github.com/coinpaprika/coinpaprika-api-php-client
Swift	https://github.com/coinpaprika/coinpaprika-api-swift-client
Kotlin	https://github.com/coinpaprika/coinpaprika-api-kotlin-client

LLM 向けドキュメント

LLM が直接利用できる Markdown 形式の API 仕様全体：

• インデックス：https://docs.coinpaprika.com/llms.txt
• 全ドキュメント：https://docs.coinpaprika.com/llms-full.txt

---

すべてのエンドポイント

グローバル

GET /global                                    # Market overview data

コイン

GET /coins                                     # List all coins
GET /coins/{coin_id}                           # Coin details (e.g., btc-bitcoin)
GET /coins/{coin_id}/events                    # Coin events
GET /coins/{coin_id}/exchanges                 # Exchanges listing a coin
GET /coins/{coin_id}/markets                   # Trading pairs for a coin
GET /coins/{coin_id}/ohlcv/historical          # Historical OHLCV (?start, ?end, ?interval, ?limit, ?quote)
GET /coins/{coin_id}/ohlcv/latest              # Last full day OHLCV
GET /coins/{coin_id}/ohlcv/today               # Today's OHLCV (partial)
GET /coins/{coin_id}/twitter                   # DEPRECATED

ティッカー（価格データ）

GET /tickers                                   # All tickers (?quotes=USD,BTC)
GET /tickers/{coin_id}                         # Specific coin ticker
GET /tickers/{coin_id}/historical              # Historical ticks (?start, ?end, ?interval, ?limit, ?quote)

取引所

GET /exchanges                                 # List all exchanges
GET /exchanges/{exchange_id}                   # Exchange details
GET /exchanges/{exchange_id}/markets           # Exchange markets

コントラクト

GET /contracts                                 # List contract platforms
GET /contracts/{platform_id}                   # Contracts on a platform
GET /contracts/{platform_id}/{contract_address}            # Ticker by contract (301 redirect)
GET /contracts/{platform_id}/{contract_address}/historical # Historical by contract (301 redirect)

コントラクトのティッカー／履歴に関する注意： これらは/tickers/{coin_id}への301リダイレクトを返します。Location ヘッダーでは、https://ではなくhttp://が使われる場合があります。Location ヘッダーを読み取り、スキームをhttps://に修正してから、Authorization ヘッダーを付けて2回目のリクエストを送信し、リダイレクトを手動で処理してください。

確認済みのレスポンス形式：

• GET /contractsは、フラットな文字列配列を返します：["btc-bitcoin", "eos-eos", "eth-ethereum", ...]
• GET /contracts/{platform_id}は、次の形式を返します：[{"address": "0xa974...", "type": "ERC20", "id": "xin-mixin", "active": true}]

タグ

GET /tags                                      # List all tags
GET /tags/{tag_id}                             # Tag details
GET /tags/{tag_id}?additional_fields=coins     # Tag with coin IDs
GET /tags/{tag_id}?additional_fields=coins,icos # Tag with coins and ICOs

人物

GET /people/{person_id}                        # Person details (e.g., vitalik-buterin)

検索とツール

GET /search?q={query}&c={categories}&limit={n} # Search (categories: currencies,exchanges,icos,people,tags)
GET /price-converter?base_currency_id={from}&quote_currency_id={to}&amount={n}

主な情報（有料プランのみ）

GET /key/info                                  # API key details and usage

レスポンス：{"plan", "plan_started_at", "plan_status", "portal_url", "usage": {"message", "current_month": {"requests_made", "requests_left"}}}

マッピング（Business+ のみ）

GET /coins/mappings?coinpaprika={id}           # ID mappings across providers

クエリパラメーター（いずれか1つを指定）：coinpaprika、coinmarketcap、coingecko、cryptocompare、isin、dti

レスポンス：{"coinpaprika", "coinmarketcap", "coingecko", "cryptocompare", "isin", "dti", "updated_at"}

変更履歴（Starter+ のみ）

GET /changelog/ids                             # Coin ID changes (?page, ?limit)

レスポンス：[{"currency_id", "old_id", "new_id", "changed_at"}]

すべてのスキーマ、パラメーター、レスポンスタイプを含む完全な OpenAPI 3.1 仕様については、references/openapi.yml をご覧ください。CLI コマンドについては、references/cli-reference.md をご覧ください。最新のオンラインドキュメント：https://docs.coinpaprika.com/llms-full.txt

---

よくあるワークフロー

Bitcoin の価格を取得する（無料プラン、キー不要）

curl -s "https://api.coinpaprika.com/v1/tickers/btc-bitcoin?quotes=USD" | jq '.quotes.USD.price'

時価総額上位10銘柄を取得する

curl -s "https://api.coinpaprika.com/v1/tickers" | jq 'sort_by(-.quotes.USD.market_cap) | .[0:10] | .[] | {name, symbol, price: .quotes.USD.price, market_cap: .quotes.USD.market_cap}'

ETH の過去30日間の OHLCV を取得する

curl -s "https://api.coinpaprika.com/v1/coins/eth-ethereum/ohlcv/historical?start=2025-01-01&end=2025-01-31" | jq

トークンを検索する

curl -s "https://api.coinpaprika.com/v1/search?q=pepe&c=currencies&limit=5" | jq '.currencies'

コントラクトアドレスでトークンを検索する

curl -s "https://api.coinpaprika.com/v1/contracts/eth-ethereum/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" -L | jq

注：-L により、301 リダイレクトを自動的に処理します。Authorization ヘッダーが必要な場合は、手動で処理する必要があるかもしれません。

タグを使ってすべてのステーブルコインを取得する

curl -s "https://api.coinpaprika.com/v1/tags/stablecoin?additional_fields=coins" | jq '.coins'

コイン ID の配列を返します：["usdt-tether", "usdc-usdc", "dai-dai", ...]

通貨間で価格を換算する

curl -s "https://api.coinpaprika.com/v1/price-converter?base_currency_id=btc-bitcoin&quote_currency_id=usd-us-dollars&amount=1" | jq

---

よく使う ID

コイン ID

パターン：{symbol}-{name}（小文字、スペースはハイフン）

btc-bitcoin、eth-ethereum、usdt-tether、usdc-usd-coin、bnb-binance-coin、sol-solana、xrp-xrp、ada-cardano、doge-dogecoin、dot-polkadot、avax-avalanche、matic-polygon

プラットフォーム ID（/contracts 用）

eth-ethereum、bnb-binance-coin、matic-polygon、sol-solana、arb-arbitrum、avax-avalanche、op-optimism、base-base

取引所 ID

binance、coinbase-exchange、kraken、bybit、okx、bitfinex、kucoin

---

よく使うパラメーター

パラメーター	説明	例
quotes	換算通貨（カンマ区切り）	USD,BTC,ETH
start	開始日（RFC3339 または yyyy-mm-dd）	2025-01-01
end	終了日	2025-12-31
interval	OHLCV：5m、15m、30m、1h、6h、12h、24h。過去のティッカー：5m、10m、15m、30m、45m、1h、2h、3h、6h、12h、24h、1d、7d、14d、30d、90d、365d	24h
limit	結果の上限数	100

主なレスポンスフィールド

ティッカー

• id、name、symbol、rank
• circulating_supply、total_supply、max_supply
• quotes.USD.price、quotes.USD.volume_24h、quotes.USD.market_cap
• quotes.USD.percent_change_1h、percent_change_24h、percent_change_7d、percent_change_30d
• quotes.USD.ath_price、quotes.USD.ath_date

OHLCV

• time_open、time_close
• open、high、low、close
• volume、market_cap

注意事項

• すべてのタイムスタンプは UTC です。RFC3339 形式（2025-01-01T00:00:00Z）または yyyy-mm-dd を使用してください。
• コイン ID のパターンは {symbol}-{name} です（小文字、スペースはハイフン）。
• /tickers エンドポイントにはタグが含まれません。タグからコイン ID を取得するには、/tags/{id}?additional_fields=coins を使用してください。
• /coins/{id}/twitter エンドポイントは非推奨で、エラーが返される場合があります。
• グローバルレート制限：IP あたり毎秒10リクエストです。
• 429 レート制限時： 数秒から数分待ってから再試行してください。ブロックは一時的なものです。問題が続く場合は、[email protected] にお問い合わせください。

関連：DexPaprika

DEX／オンチェーンデータ（プール、スワップ、コントラクト別トークン価格）には、代わりに DexPaprika を使用してください：

• API：https://api.dexpaprika.com（無料プランで、開始時にキーは不要）
• ドキュメント：https://docs.dexpaprika.com
• エージェント：https://agents.dexpaprika.com