Эндпоинты, параметры, поля

Подтверждает, что ключ действителен, сервис поднят, а ваши часы сходятся с нашими. Параметров нет. Используйте как смоук-тест интеграции и как liveness-проверку.

{ "status": "ok", "server_ts": "2026-07-24T18:41:07Z", "version": "v1" }

Без параметров — сводка того, что живо прямо сейчас: покрытые события, их главные линии и свежесть. Для обнаружения покрытия, а не для чтения лестниц.

Параметры

Ответ — объект поверхности

Ответ — rungs[]

curl -s "https://api.foreline.io/v1/surface?event_id=EVT_8F3A21" \
  -H "X-Foreline-Key: $FORELINE_KEY"

{
  "event_id": "EVT_8F3A21",
  "sport": "football",
  "market": "handicap",
  "main_line": -0.5,
  "fair_market": 0.5312,
  "vig": 0.0214,
  "data_cadence_s": 60,
  "updated_ts": "2026-07-24T18:41:07Z",
  "rungs": [
    { "line": -1.0,  "p_home": 0.3874, "band_pp": 1.6, "src": "quote" },
    { "line": -0.75, "p_home": 0.4593, "band_pp": 1.9, "src": "table" },
    { "line": -0.5,  "p_home": 0.5312, "band_pp": 1.4, "src": "quote" }
  ]
}

Значения иллюстративные. Глубина истории, доступная через ?asof=, следует вашему контракту; архив уходит к 2022 году по футболу.

Смены главных линий типизированными фактами, в порядке обнаружения. Это догоняющий канал: после перезапуска доберите с последнего курсора — и ничего не потеряете. Для живой доставки берите стрим или вебхук.

Удерживаемое HTTP-соединение, отдающее text/event-stream. Сейчас один тип события — line_change, с тем же пейлоадом, что и у /v1/line-events. При переподключении доберите разрыв через /v1/line-events?since=, передав последний обработанный detected_ts.

curl -N "https://api.foreline.io/v1/stream" \
  -H "X-Foreline-Key: $FORELINE_KEY"

event: line_change
data: {"event_id":"EVT_8F3A21","market":"handicap","from":-0.5,"to":-0.75,
       "detected_ts":"2026-07-24T18:41:07Z","data_cadence_s":60}

Скорит счёт по CLV против нашего честного клоза — по тем самым линиям, которые он брал, включая линии, которых референсный рынок не котировал (они репрайсятся по табличным лестницам). На вход идут обезличенный идентификатор счёта и параметры ставок; персональные данные не принимаются и не нужны.

Тело запроса

Ответ

Пороги флага и его словарь настраиваются по контракту при подключении — скор можно подстроить под вашу риск-политику, не меняя интеграцию. Ставки на события вне вашей области отчитываются как нескоренные, а не отбрасываются молча.

Предупреждения о разрыве — где ваша выставленная цена ушла от честной — вместе с состоянием жизненного цикла. Фильтруйте по state или листайте переходы через since.

Чтобы сравнивать вашу цену с честной, нужны ваши цены. Они приходят по интеграции, согласованной при подключении; ничего о вашей книге не додумывается из сторонних источников.

Ваш расход против квот на ключе: запросы за текущую минуту и сутки, потолки rpm и rpd, а также счётчики по классам bulk, point и events. Опрашивайте по расписанию и алертите на собственный запас, а не узнавайте о нём из 429.

Получение ключа (self-serve тарифы): после оплаты в Stripe вас переадресует на одноразовую страницу — сырой ключ показывается ровно один раз, у нас остаётся только его sha256. Потерянный ключ перевыпускает поддержка. Мини-кабинет (ключ → тариф, лимиты, живой расход) — /v1/portal.