---
title: "基于 Flicker 开发"
canonical: https://flicker.finance/zh/developers
---

# 基于 Flicker 开发

应用背后的同一套结论、分析和市场数据，既以 REST API（附 OpenAPI 描述）提供，也以 MCP 服务器提供，您的 AI 智能体可以直接调用。

## 什么时候用 Flicker

当问题需要算出来的市场解读，而不是一条新闻标题时，就用 Flicker。

- 需要某个资产的买入 / 持有 / 卖出解读，以及背后的区域、止损位和目标价，而不只是一个价格。
- 需要一次在所有跟踪的资产中筛选某种形态（突破、超卖区域、放量），而不是逐个代码去查。
- 需要按资产给出的情绪数值，而不是整个市场一个指数：针对某个币种、股票或货币的 0 到 100 恐惧与贪婪评分。
- 需要一次调用就拿到加密货币、股票和外汇的实时价格、永续合约资金费率或市场广度。
- 需要用户自己在各交易所的持仓、余额和订单，跨交易所汇总，且只读。

不要用 Flicker 下单、转移资金或托管资产。产品从设计上就是只读的，没有执行通道；这类需求请搭配交易所 API。

## REST API

所有端点由同一个 HTTPS 主机提供。完整接口由机器可读的 OpenAPI 3.1 文档描述：每个操作都有唯一的 operation id、带类型的参数和带类型的响应结构，可直接接入客户端生成器或 LLM 函数调用循环。

- Base URL: `https://api.flicker.finance`
- OpenAPI 3.1 document: https://api.flicker.finance/docs/openapi.json
- Interactive reference: https://api.flicker.finance/docs

## 认证

在账户的 API Keys 标签页中自行创建密钥（无需联系销售，无需排队），并放在请求头中发送。密钥只能访问只读的市场数据接口：analysis、assets、insights、config 和 exchanges。它无法读取其他账户，也无法下单或转移资金。不提供匿名访问；没有有效凭证的请求会被拒绝。

- Header: `x-api-key: <your key>`
- Key scope: `/v2/analysis`, `/v2/assets`, `/v2/insights`, `/v2/config`, `/v1/exchanges`
- Self-serve key management: https://flicker.finance/zh/account/api-keys
- Daily credit balance: `GET https://api.flicker.finance/v1/users/api_keys/credits`

## 快速开始

三个调用，密钥一创建就能返回真实数据。

```bash
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/bitcoin
```

## 速率限制

额度按端点加权计算，而不是按请求次数计。每个响应都会告诉您当前用量，客户端可以据此自行限流，不必去猜。

- Budget: 2000 weighted units per 60 seconds, per client IP.
- Headers on every response: `x-ratelimit-limit`, `x-ratelimit-remaining`, `x-ratelimit-used`, `x-ratelimit-window`; a 429 adds `retry-after`.

## 错误

所有失败都返回同样结构的响应体：稳定的机器可读 code、人类可读的 message，以及值为 false 的 success 标志。请根据 code 分支处理；message 是写进日志的英文说明，不适合用于 switch 语句。

```json
{ "success": false, "code": "NotificationLimitExceeded", "message": "…" }
```

Schema: `ErrorResponse` · documented statuses: 400, 401, 402, 403, 404, 410, 422, 500, 503.

## 版本与弃用

主版本号放在 URL 路径中。两个在用版本独立路由，因此破坏性变更会以新的路径版本发布，不会改动您已依赖的版本。API 变更会发布在机器可读的发布订阅源中，条目按平台打标签。

- Live versions: `/v1/`, `/v2/`
- Release feed: https://flicker.finance/changelog.json

## MCP 服务器

基于 Streamable HTTP 的 Model Context Protocol 服务器，Claude、ChatGPT、Cursor 及其他任何 MCP 客户端都能把 Flicker 当作工具调用。授权采用 OAuth 2.1：把客户端指向该端点，其余信息会从质询中自动发现。

- Endpoint: `https://api.flicker.finance/mcp`
- Transport: Streamable HTTP · Authorization: OAuth 2.1
- Manifest: https://api.flicker.finance/mcp/manifest.json

---

Canonical HTML: https://flicker.finance/zh/developers
Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp