--- title: "Flicker 公开 API：通过 REST 获取加密货币分析、区域和市场数据" canonical: https://flicker.finance/zh/blog/public-api-launch --- # Flicker 公开 API：通过 REST 获取加密货币分析、区域和市场数据 Flicker API 提供与应用相同的解读：结论、六个因素中几个一致、每个区域的止损与目标价，以及情绪和市场数据。 Flicker 提供公开的 REST API。它返回的解读与网页和手机应用中显示的相同，因此您自己的代码可以查询 Flicker 对某个资产的解读：结论、理由，以及先离场、后入场的计划。 接入方式有两种，都随免费的 Flicker 账户提供： - **REST API**：使用您自己创建的 API 密钥，供您自己的代码调用。 - **MCP 服务器**：通过 OAuth 登录，供 Claude、ChatGPT 等 AI 助手使用。详见 [Flicker 的 MCP 服务器](/mcp)。 完整说明见 **[开发者门户](/developers)**。 --- ## API 提供哪些数据 所有接口都由同一个主机提供：`https://api.flicker.finance`。主版本号写在路径中（`/v1`、`/v2`）。API 密钥可以访问其中只读的市场数据部分： - 单个资产的**分析**。结论（买入、持有或卖出）来自六个因素：趋势方向、动量、Fear & Greed、突破形态、风险水平和周期阶段。响应会说明其中有几个与结论一致；这是一致程度，不是概率。与结论一起返回的还有各个区域，每个区域都带有止损、最多两个目标价、入场区间和风险回报比，另外还有图表 K 线。 - 资产的**文字概述**。由 AI 用通俗的语言撰写，支持应用的七种语言。概述中提到的结论、区域和止损是计算得出的，不是 AI 写的。 - **资产**：搜索和筛选 Flicker 解读的加密货币、股票、外汇和贵金属列表，每个资产都附带默认时间周期上的结论；还可以筛选出当前正处于买入区或卖出区内的资产。 - **情绪**：每个资产 0 到 100 的 Fear & Greed 分数、它的每日历史，以及跨资产的排行榜。 - **市场数据**：全球市场统计、某个资产按成交量排序的交易市场、衍生品平台的资金费率，以及 Flicker 覆盖的交易所列表。 每条路由、参数和响应结构都在[交互式参考文档](https://api.flicker.finance/docs)中，机器可读的 OpenAPI 3.1 文档位于 `https://api.flicker.finance/docs/openapi.json`。 ### 密钥做不到的事 密钥不能下单、不能转移资金，也不能读取任何人的账户。Flicker 只负责解读、标注和解释，没有任何执行交易的路径。如果您的项目需要执行交易，这部分要通过交易所自己的 API 完成。 --- ## 如何开始 1. **注册 Flicker 账户。** 密钥由账户生成，所以注册账户就是开通流程。 2. 在账户的 [API 密钥页面](/account/api-keys)**创建密钥**。您也可以在那里查看和吊销密钥，并查看当天已用的额度。 3. 在每个请求的 **`x-api-key` 请求头中发送密钥**。 第一次调用： ```bash curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/analysis/bitcoin ``` 响应为 JSON 格式。没有匿名访问：没有有效密钥的请求会被拒绝并返回 403。 --- ## 限制与错误 - **速率限制**：每个客户端 IP 每 60 秒 2,000 个加权单位。较重的接口比较轻的接口消耗更多单位。每个响应都会在 `x-ratelimit-limit`、`x-ratelimit-remaining`、`x-ratelimit-used` 和 `x-ratelimit-window` 请求头中报告当前用量；429 响应还会附带 `retry-after`。 - **每日额度**：每个账户每天都有一定的 API 调用额度，在 UTC 时间 00:00 重置。API 密钥页面会显示您已用了多少，`GET /v1/users/api_keys/credits` 也会返回同样的数据。Pro 和 Elite 的额度更高。 - **错误**：所有错误响应体的结构相同：`{ "success": false, "code": "…", "message": "…" }`。请根据 `code` 判断分支；`message` 用于日志。 --- ## 您的套餐会影响什么 API 密钥和 MCP 服务器是账户功能，不是单独的付费套餐。和在应用中一样，密钥能打开哪些解读，由您现有的套餐决定： - **免费**：默认时间周期，即日线解读，包括结论、区域、止损和目标价，以及 500 根 K 线的图表历史。DEX 代币在其数据源提供的所有时间周期上都开放。 - **[Pro](/subscription)**：其他所有时间周期，以及更长的图表历史。超出套餐范围的请求会返回 402，并附带说明触及了哪项限制的代码。 领取[合作伙伴优惠](/promotions)也可以解锁 30 天 Pro。 --- ## 大家用它来做什么 - 为您关注的资产做一个**看板**：结论、几个因素一致，以及每个区域的止损和目标价，一屏看完。 - 一个把解读**发布到您自己的 Telegram 或 Discord 频道的机器人**。它只报告 Flicker 的解读，不进行交易。 - 一个**监控脚本**，每天检查一次您的列表，告诉您哪些资产正处于某个区域内，并列出做决定前值得看的止损和目标价。 - 一个**研究笔记本**，把某个资产的情绪历史和它的价格放在一起。 如果您只是想在网站上展示 Flicker 的数据，不需要密钥：[小组件](/widgets)只需一段代码，免费且无需注册。 --- ## AI 助手：MCP 服务器 MCP 服务器以工具的形式，向 Claude、ChatGPT、Cursor 和其他 MCP 客户端提供同样的分析；经您批准后，还能访问您自己的投资组合、自选列表和提醒。它不使用 API 密钥。您只需把服务器 URL 添加到客户端，登录一次 Flicker 并批准连接；之后随时可以在账户的安全设置中断开该应用。没有任何工具会下单。 - [Flicker MCP 服务器](/blog/mcp-server-launch)：它是什么，以及工具覆盖哪些内容。 - [把 Claude 和 ChatGPT 连接到实时加密货币数据](/blog/connect-claude-chatgpt-to-live-crypto-data-mcp)：三步完成设置。 --- ## 常见问题 ### Flicker API 免费吗？ 任何 Flicker 账户都可以免费创建 API 密钥。免费账户在每日额度内读取日线时间周期。Pro 开放其他时间周期，并提供更高的额度。 ### API 能替我交易吗？ 不能。API 只负责解读和报告。密钥只能访问市场数据，不能下单、不能转移资金，也不能读取账户。 ### 分析接口返回什么？ 结论以及六个因素中有几个与之一致，每个区域的止损、目标价、入场区间和风险回报比，以及图表 K 线。[参考文档](https://api.flicker.finance/docs)列出了所有字段。 ### MCP 服务器会使用我的 API 密钥吗？ 不会。MCP 服务器通过 OAuth 登录您的 Flicker 账户；API 密钥用于 REST API。 ### 速率限制是多少？ 每个客户端 IP 每 60 秒 2,000 个加权单位，在响应头中报告；另外每个账户还有每日额度。 我们分析，您决定。我们从不替您交易。 **基于 Flicker 开发** — 结论、理由，以及每个区域的止损和目标价，通过 REST 或 MCP 获取。用 Flicker 账户免费开始。 — [开发者门户](https://flicker.finance/developers?utm_source=blog-public-api-launch) --- **相关阅读**： - [Flicker MCP 服务器](/blog/mcp-server-launch)：把 AI 助手连接到 Flicker 的分析。 - [把 Claude 和 ChatGPT 连接到实时加密货币数据](/blog/connect-claude-chatgpt-to-live-crypto-data-mcp)：三步完成 MCP 设置。 > 仅为分析，不构成投资建议。价格会波动，您可能亏损。 --- Canonical HTML: https://flicker.finance/zh/blog/public-api-launch Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp