# CoinGecko API 与 Tiingo 通过 鹦鹉AI：按次计费，查实时价格与历史行情

给 agent 一个币种，就能拿回结构化价格：一次调用取整个自选列表在任意计价货币下的现价，或者取一天、一个月乃至该币种全生命周期的价格、市值和成交量序列。CoinGecko 和 Tiingo 都通过 鹦鹉AI 应答，0 积分/次 起、按各自费率计费；不需要把 CoinGecko 密钥粘进表格、看板或设备里。返回的是聚合价格，不是订单簿；是轮询得来，不是流式推送。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「用鹦鹉AI 一次调用取 bitcoin、ethereum 和 solana 以 USD 计的现价和 24 小时涨跌，然后拉每个币最近 30 天的每日价格，告诉我哪一个相对其 30 日均值波动最大。先告诉我每次调用的价格。」

- **用 CoinGecko 的币种 id** 调用收的是 bitcoin、ethereum 这样的 id，不是交易代码。BTC 不是币种 id，而且好几个代币共用同一个符号。
- **整个自选列表一次要** 现价接口收逗号分隔的币种列表和计价货币列表。五十个币一次调用，和一个币一次调用的成本一样。
- **指明时间窗** 历史接口接受 1、7、30、365 或 max 天，粒度跟着窗口走：一天以内是五分钟一个点，90 天以内是按小时，再往上按天。
- **先问价格** 鹦鹉AI 在调用前返回费率，agent 可以先说明每天刷新一百个币要花多少。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `coingecko.simple.price` — 按币种 id 获取当前加密货币价格——市值、24 小时涨跌 (crypto): https://parrot.amorist.cn/catalog/crypto
- `coingecko.coins.history` — 按日期获取加密货币快照——价格、市值、成交量 (crypto): https://parrot.amorist.cn/catalog/crypto
- `tiingo.crypto.prices` — 按货币对获取加密货币 OHLCV 数据——1 分钟至日线 (crypto): https://parrot.amorist.cn/catalog/crypto
- `coingecko.coins.market-chart` — 按币种 id 获取加密货币价格历史——市值、成交量序列 (crypto): https://parrot.amorist.cn/catalog/crypto

## 大家实际卡在哪

加密数据的帖子，三分之二是噪声：2026 年 8 月读过的约 170 篇 Reddit 与 X 帖子中，大多是代币吹票、订阅转售，以及两篇「终于找到一个免费 API」的帖子——同一个套路发在两个 subreddit。下面这五条，是在价格数据上做东西的人。

**共享的速率限制是第一个崩掉的东西**

> "结果我在 Coingecko API 本身的速率限制上撞了墙。" (r/coingecko: https://www.reddit.com/r/coingecko/comments/1cibixi/google_sheet_not_working_rate_limits/)

这一页能帮上的： 那位发帖人是从 Google Sheets 里发请求的，那里的每个请求都从同一个共享的 Google IP 出去。通过 鹦鹉AI，这次调用是在付费密钥上的一个按量计费请求，一次调用搞定整张自选列表，而表格、看板或设备里根本不持有任何密钥。

**历史数据比人们预想的更早断掉**

> "CoinGecko 只能回溯 12 个月，但我希望能再往前一些" (r/CryptoCurrency: https://www.reddit.com/r/CryptoCurrency/comments/1kq99z1/historic_market_cap_data/)

这一页能帮上的： 按币种算，把 days 设成 max 的序列调用会返回 CoinGecko 保存的每日历史，走的是 鹦鹉AI 提供服务的付费密钥。那位发帖人想要的是全网总市值的历史，那不是这个端点能做到的，本页也不会假装它能。

**免费是用来测试的；真正的疑问是规模上去之后会怎样**

> "免费 API 用来测试没问题，但我想要一个能撑得起规模的东西。" (r/ethdev, 6 points: https://www.reddit.com/r/ethdev/comments/1rf4ehy/best_crypto_market_data_api_for_real_time/)

这一页能帮上的： 这里的“规模”指的是每次调用一个额度、按量计费，看板长大了也不用跳到更高的套餐档。它不意味着流式：这条数据源是轮询的，而需要每一个 tick 的机器人得用另一种产品。

**谁的数字都和别人的对不上**

> "CoinGecko API 在 700M 这个市值数据上显示错了！" (r/SmoothLovePotion: https://www.reddit.com/r/SmoothLovePotion/comments/sq6odb/coingecko_api_shows_wrongs_market_capital_data/)

这一页能帮上的： 这个问题没有现成的答案。价格是工具自己的聚合值，鹦鹉AI 原样转发。便宜的校验办法是把同一个交易对拉一条 Tiingo 的 K 线，让 agent 标出差距，而它可以在同一个提示词里完成。

**限流器是 agent 写的**

> "直到我让 ChatGPT 按每分钟 500 次的速率限制把限流做了进去" (r/api_connector: https://www.reddit.com/r/api_connector/comments/1dg1of5/coingecko_api_x_mixed_analytics_crypto_tracker/)

这一页能帮上的： 这些底层接线 agent 本来就会做。它缺的是密钥和价格，而一条设置行两样都给它：那次调用、花钱之前先显示的费率，以及它的上下文里不会出现任何 CoinGecko 令牌。

## 真正不一样的地方

- 费率是按请求算，不是按币种。现价调用收的是币种 id 列表和计价货币列表，所以论坛上那句 “it only returns 28 of my 131 coins” 是另一个端点的分页问题，不是这里的上限。调用按各自费率从团队余额计费。
- 历史深度由 CoinGecko 决定，这一页不会把它拉长。序列调用按 1、7、30、365 或 max 天返回逐币价格，粒度由窗口决定；快照调用返回某个币在指定日期的价格、市值和成交量。两者都不是全市场市值历史，也都不是逐日 Top-N 表；agent 要靠循环逐个币来拼，每个币一次计量调用。Tiingo 的柱线是交易所风格的另一条路，按次计费。
- 价格是聚合值，原样透传。CoinGecko 的市值和供应量数据是它自己算的，调研里确有小型代币在这两项上出错的实例；鹦鹉AI 逐字转发结果，不加共识价、不加买卖价差、也不给第二意见。某个数字要紧时，把同一交易对的 Tiingo 柱线拉出来让 agent 对比——这个对比是你做的，不是鹦鹉AI 替你做的。这里没有任何 websocket、订单簿或交易所连接。

## 什么是 CoinGecko API？

CoinGecko API 是 CoinGecko 聚合市场数据的查询接口：任何已收录币种在任意计价货币下的现价，可按需带上市值、24 小时成交量和 24 小时涨跌；另有历史接口，按你选定的窗口返回某个币的价格、市值和成交量序列。这个数字是 CoinGecko 所追踪各家交易所的聚合，这正是看板或 agent 想要的，而不是只盯一家交易所的交易者想要的。这里的另一个工具是 Tiingo，它回答的是另一种形态：btcusd 这类交易对的开高低收加成交量柱，重采样频率从一分钟到一天。

## 开始之前

**历史能回溯多久？** 到 CoinGecko 为该币种保留的序列为止，把 days 设为 max，粒度是日线。日内数据只在近期窗口内提供：一天以内为五分钟，90 天以内为按小时。Tiingo 的柱线在它支持的交易对上最细可到一分钟，用的是它自己的历史。

**agent 能流式接收价格，或者据此交易吗？** 不能。这里的两个工具都是用一次请求换一个数字；没有 websocket、没有订单簿、也不执行交易。每隔几分钟刷新一次自选列表的 agent 适合它；需要逐笔 tick 数据的机器人不适合。

**agent 该用哪个工具？** 要币种 id、计价货币和聚合市场视图，用 CoinGecko；要某个交易对的开高低收加成交量柱，用 Tiingo。鹦鹉AI 不替你路由，也不替你切换容错。

HTML 版本： https://parrot.amorist.cn/use-cases/live-crypto-prices-and-history