Перейти к основному содержимому
Разработчикам

Стройте на Flicker

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

Спецификации и справочники

REST API

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

Base URL
https://api.flicker.finance
Versions
/v1/ /v2/

Аутентификация

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

x-api-key: <your key>
Key scope
/v2/analysis /v2/assets /v2/insights /v2/config /v1/exchanges
Credits
GET https://api.flicker.finance/v1/users/api_keys/credits

Быстрый старт

Три запроса, которые вернут настоящие данные сразу после создания ключа.

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 / 60s
Headers
x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window retry-after

Ошибки

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

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

ErrorResponse · 400 · 401 · 402 · 403 · 404 · 410 · 422 · 500 · 503

Версионирование и вывод из эксплуатации

Мажорная версия указана в пути URL. Обе живые версии маршрутизируются независимо, поэтому ломающее изменение выходит под новой версией пути, а не меняет ту, от которой вы уже зависите. Изменения API публикуются в машиночитаемой ленте релизов, где записи размечены по платформе.

https://flicker.finance/changelog.json

MCP-сервер

Сервер Model Context Protocol поверх Streamable HTTP: Claude, ChatGPT, Cursor и любой другой MCP-клиент вызывают Flicker как набор инструментов. Авторизация — OAuth 2.1: укажите клиенту адрес, остальное он узнает из ответа сервера.

https://api.flicker.finance/mcp

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

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

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

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