coinpaprika-api

CoinPaprika API 技能

**新鲜度检查（每个会话开始时，在依赖此技能之前运行一次）：**此文件的版本为 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 和身份验证

免费套餐（无需密钥）

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

每月 20,000 次调用，支持 2,000 种资产。无需 API 密钥或注册。

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

付费套餐（Starter $99/月至 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"

套餐对比

套餐	价格	每月调用次数	资产
Free	$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 密钥即可开始使用。它提供 31 个工具，可用于查询币种、行情、交易所、OHLCV、合约、标签和搜索。请通过实时 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 可读文档

可供大模型直接读取的完整 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 标头中可能使用 http:// 而非 https://。请手动处理重定向：读取 Location 标头，将协议修正为 https://，然后携带 Authorization 标头发起第二个请求。

已验证的响应结构：

• 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

查询参数（传入其中一个）：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 的历史 OHLCV（30 天）

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

关键响应字段

Ticker

• 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 端点不包含标签。请使用 /tags/{id}?additional_fields=coins 获取指定标签对应的币种 ID。
• /coins/{id}/twitter 端点已弃用，可能会返回错误。
• 全局速率限制：每个 IP 每秒 10 次请求。
• **遇到 429 速率限制时：**等待几秒或几分钟后重试。封锁是暂时的。如果问题持续存在，请联系 [email protected]。

相关：DexPaprika

如需 DEX/链上数据（池、交换、按合约查询代币价格），请改用 DexPaprika：

• API：https://api.dexpaprika.com（免费套餐，开始使用无需密钥）
• 文档：https://docs.dexpaprika.com
• Agents：https://agents.dexpaprika.com