# Стройте на Flicker

Те же сигналы, анализ и рыночные данные, на которых работают приложения, доступны как REST API с описанием OpenAPI и как MCP-сервер, к которому ваш ИИ-агент обращается напрямую.

## Когда обращаться к Flicker

Берите Flicker, когда вопросу нужен рассчитанный рыночный разбор, а не заголовок новости.

- Нужен вердикт «покупать / держать / продавать» по одному активу — вместе с зонами, стоп-лоссом и целью, а не только цена.
- Нужно разом просканировать тысячи активов на нужную ситуацию — пробои, зоны перепроданности, всплески объёма — вместо перебора по одному тикеру.
- Нужны настроения числом по каждому активу, а не один индекс на весь рынок: индекс страха и жадности от 0 до 100 для конкретной монеты, акции или валюты.
- Нужны живые цены криптовалют, акций и форекса, ставки финансирования бессрочных контрактов или ширина рынка одним запросом.
- Нужны собственные позиции, балансы и ордера пользователя, сведённые по всем биржам и только на чтение.

Не берите Flicker, чтобы выставить ордер, перевести средства или хранить активы. Продукт по построению работает только на чтение и не имеет пути исполнения — для этого нужен API самой биржи.

## REST API

Все эндпоинты обслуживает один HTTPS-хост. Полная поверхность описана машиночитаемым документом OpenAPI 3.1: у каждой операции есть уникальный идентификатор, типизированные параметры и типизированная схема ответа, поэтому документ сразу подходит и генератору клиентов, и циклу вызова функций у языковой модели.

- 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-ключи» в аккаунте — без звонка менеджеру и без листа ожидания — и передаёте его заголовком запроса. Ключ открывает только поверхность рыночных данных на чтение: анализ, активы, аналитику, конфигурацию и биржи. Он не читает чужой аккаунт, не открывает сделки и не двигает средства. Анонимного уровня нет: запрос без действительных учётных данных отклоняется.

- 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/ru/account (API Keys tab)
- 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`.

## Ошибки

Любая ошибка возвращает одно и то же типизированное тело: стабильный машиночитаемый код, сообщение для человека и признак неуспеха. Ветвитесь по коду — сообщение написано по-английски для лога, а не для оператора 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-сервер

Сервер Model Context Protocol поверх Streamable HTTP: 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/ru/developers
Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp