REST API
所有端点由同一个 HTTPS 主机提供。完整接口由机器可读的 OpenAPI 3.1 文档描述：每个操作都有唯一的 operation id、带类型的参数和带类型的响应结构，可直接接入客户端生成器或 LLM 函数调用循环。
- 基础 URL
https://api.flicker.finance- 版本
/v1/ /v2/
开发者
基于 Flicker 开发
应用背后的同一套结论、分析和市场数据，既以 REST API（附 OpenAPI 描述）提供，也以 MCP 服务器提供，您的 AI 智能体可以直接调用。
两种接入方式
按调用方选择。两者都随 Flicker 账户提供，没有单独的 API 套餐。
快速开始
三个调用，密钥一创建就能返回真实数据。
- 1
创建 Flicker 账户
密钥在账户中创建，账户本身就是注册。
- 2
创建密钥
打开账户中的 API 密钥标签页。在那里创建、查看和撤销密钥，并查看当天已用的额度。
- 3
通过请求头发送
在每个请求的 x-api-key 请求头中放入密钥，如下方示例所示。
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/config
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/assets/?limit=5
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/analysis/bitcoinAPI 的工作方式
认证
在账户的 API Keys 标签页中自行创建密钥（无需联系销售，无需排队），并放在请求头中发送。密钥只能访问只读的市场数据接口：analysis、assets、insights、config 和 exchanges。它无法读取其他账户，也无法下单或转移资金。不提供匿名访问；没有有效凭证的请求会被拒绝。
x-api-key: <your key>- 密钥范围
/v2/analysis /v2/assets /v2/insights /v2/config /v1/exchanges- 每日额度
GET /v1/users/api_keys/credits
速率限制
额度按端点加权计算，而不是按请求次数计。每个响应都会告诉您当前用量，客户端可以据此自行限流，不必去猜。
- 预算
- 每个客户端 IP 每 60 秒 2,000 个加权单位
- 响应头
x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window retry-after
错误
所有失败都返回同样结构的响应体：稳定的机器可读 code、人类可读的 message，以及值为 false 的 success 标志。请根据 code 分支处理；message 是写进日志的英文说明，不适合用于 switch 语句。
{
"success": false,
"code": "NotificationLimitExceeded",
"message": "…"
}- 结构
ErrorResponse- 状态码
400 401 402 403 404 410 422 500 503
版本与弃用
主版本号放在 URL 路径中。两个在用版本独立路由，因此破坏性变更会以新的路径版本发布，不会改动您已依赖的版本。API 变更会发布在机器可读的发布订阅源中，条目按平台打标签。
什么时候用 Flicker
当问题需要算出来的市场解读，而不是一条新闻标题时，就用 Flicker。
- 需要某个资产的买入 / 持有 / 卖出解读，以及背后的区域、止损位和目标价，而不只是一个价格。
- 需要一次在所有跟踪的资产中筛选某种形态（突破、超卖区域、放量），而不是逐个代码去查。
- 需要按资产给出的情绪数值，而不是整个市场一个指数：针对某个币种、股票或货币的 0 到 100 恐惧与贪婪评分。
- 需要一次调用就拿到加密货币、股票和外汇的实时价格、永续合约资金费率或市场广度。
- 需要用户自己在各交易所的持仓、余额和订单，跨交易所汇总，且只读。
不要用 Flicker 下单、转移资金或托管资产。产品从设计上就是只读的，没有执行通道；这类需求请搭配交易所 API。
无需密钥的小组件
如果想在网站上展示 Flicker 数据而不是调用 API，可以嵌入小组件：一段代码、一个沙盒框架和一个指向 Flicker 的链接。免费，无需 API 密钥，也无需注册。
恐惧与贪婪指数
单个资产的情绪评分，0 到 100。
关键价位
最近的支撑和阻力区域，以及与当前价格的距离。
技术展望
基于六个市场因素得出的买入、持有或卖出解读。
突破评分
突破形态的强弱及其方向。
价格图表
当前价格、24 小时涨跌和近期价格走势线。
加密货币市场情绪
全市场恐惧与贪婪指数，附市值和 BTC 市占率。