Три продукта, один ключ, один идентификатор

Все события, которые мы сейчас отдаём, со всеми полями, нужными для сопоставления: наш id, спорт, лига, обе команды, время начала и список рынков, которые мы по этому событию считаем. По умолчанию JSON, по запросу CSV.

Параметры

Ответ — events[]

# задача сопоставления: всё, что стартует в ближайшие 48 часов, в CSV
curl -s "https://api.foreline.io/v1/catalog/events?hours=48&format=csv" \
  -H "X-Foreline-Key: $FORELINE_KEY"

event_id,sport,league,home,away,starts,markets,updated_ts
1632737351,football,UEFA - Champions League Qualifiers,Shamrock Rovers,Ararat-Armenia,2026-07-28T19:00:00Z,moneyline|spread|totals,1785262578.971

# тот же срез в JSON
curl -s "https://api.foreline.io/v1/catalog/events?hours=48" \
  -H "X-Foreline-Key: $FORELINE_KEY"

В CSV поле markets склеено вертикальной чертой (moneyline|spread|totals), чтобы запятая внутри названия лиги не заставляла вас разбирать правила экранирования. Значения в примерах — иллюстративные.

Тот же срез, свёрнутый до уникальных лиг: сколько в каждой событий и когда ближайший старт. Принимает те же sport, hours и format. Удобно сверить покрытие со своим списком турниров до того, как сопоставлять тысячи матчей.

league,sport,events,next_start
Argentina - Liga Pro,football,4,2026-07-28T22:00:00Z
USA - Major League Soccer,football,15,2026-07-29T00:00:00Z

Тело запроса

curl -s -X POST "https://api.foreline.io/v1/score" \
  -H "X-Foreline-Key: $FORELINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account_id": "a_7731",
       "bets": [{"event_id": 1632737351, "market": "ah", "line": -0.25,
                 "side": "home", "odds": 1.95, "stake": 120,
                 "placed_at": "2026-07-28T14:02:11Z"}]}'

Ответ

Коды отказа

Журнал алертов, свежие сверху, с фильтрами since и status. Алерты, рождённые из ваших цен, привязаны к вашему ключу и видны только вам — другой подписчик Радара вашу линию не увидит. Опрашивайте журнал в своём темпе или получайте те же события потоком.

Это выбор, а не требование. Вы присылаете цены, которые сейчас показываете; мы снимаем с них вашу маржу, сравниваем каждую с честной на той же ступени и кладём всё, что вышло за ваш порог, в тот самый журнал, который вы уже читаете через GET /v1/alerts. Ничего о вашей линии не выводится из сторонних источников: не прислали цены — значит, их у нас нет.

Тело запроса

{ "quotes": [
    { "event_id": 1632737351, "market": "spread", "line": -0.25,
      "price_home": 1.95, "price_away": 1.95 },
    { "event_id": 1632737351, "market": "totals", "line": 2.75,
      "price_over": 1.90, "price_under": 1.98 },
    { "event_id": 1632737351, "market": "1x2",
      "price_home": 2.10, "price_draw": 3.40, "price_away": 3.60 }
] }

• Нужны все стороны рынка. Пока с ваших цен не снята маржа, сравнивать не с чем, а для этого нужны обе (или все три) цены. Односторонняя строка отбивается.
• Цены — десятичные коэффициенты ровно в том виде, в каком вы их показываете. Мы никогда не просим вашу честную цену или размер маржи — маржу мы выводим из самих цен.
• Линия обязана быть ступенью нашей лестницы по этому событию и рынку: главная линия плюс ступени, которые мы вокруг неё публикуем. Линию, которую мы не считаем, мы отбиваем, а не приближаем.

Конвенция знака форы — прочитайте дважды

Поле line на рынке spread — это фора ХОЗЯЕВ, и p_home растёт вместе с ростом line, ровно как в surface.markets.spread.rungs[].line. Если у вас фора хранится от гостей или как положительное число рядом с той стороной, которая её получает, — переведите её перед отправкой. Это самый частый дефект интеграции на этом эндпоинте.

Разбор перевода. Ваш трейдер выставил «Арарат-Армения −0,5» — фору даёт гостевая команда. Это значит, что полмяча получают хозяева, то есть вы присылаете line: +0.5, где price_home — цена на «Шемрок Роверс», а price_away — на «Арарат-Армению». Пришлёте -0.5 — и мы честно сравним вашу цену со ступенью, отстоящей примерно на 28 пп, и выдадим алерт на расхождение, которого нет.

Проверка перед боем: возьмите GET /v1/surface?event_id= по одному событию, отправьте честные цены обратно как котировки и убедитесь, что в ответе нет ни одного алерта. Правильно подключённая интеграция даёт нулевой гэп на собственных числах. Значения лестницы выше — иллюстративные.

Ответ и коды отказа

Каденс и порог

• Батч раз в 30–60 секунд. Данные под нами меняются в лучшем случае раз в минуту, поэтому более частый цикл сравнивает ваши цены с теми же честными числами. Класс квоты разрешает четыре батча в минуту — вдвое щедрее рекомендации, чтобы один ретрай после сетевого сбоя не выбивал вас из окна.
• Один батч, много строк. Присылайте всю активную линию одним POST, а не запросом на котировку; потолок батча большой, а построчные отказы позволяют продолжать работу, пока вы чините сопоставление.
• Закрытие гэпа не теряется. Присылайте каждый цикл все активные цены, а не только изменившиеся: алерт закрывается статусом withdrawn только тогда, когда мы видим исправленную цену.
• alert_threshold_pp — настройка, а не статистика. Значение по умолчанию 2,0 пп не выведено статистически: оно калибруется на вашем собственном фиде при онбординге, и ответ повторяет этот дисклеймер каждый раз, чтобы ниже по течению его никто не принял за измеренную константу. Попросите нас изменить порог — он применится без перезапуска на вашей стороне.