Foreline/Продукты/Поверхность цен

Продукт 1 · Поверхность цен

Каждая ступень лестницы — с полосой неопределённости

Референсный рынок котирует на матч считанные цены. Поверхность возвращает всю лестницу — и те ступени, которые он котирует, и те, которых нет: девигнутые одной документированной методологией, каждая с 80%-полосой неопределённости. Данные обновляются примерно раз в минуту в последние сутки до матча.

Документированный девиг Вся лестница 80%-полосы История as-of
Запросить доступ Каждая цифра ниже — акт валидации, который мы готовы раскрыть построчно.
Что вы получаете

Девигнутая лестница, а не горсть котировок

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

  • Девиг документированной методологией. Снятие маржи — это записанная процедура с заявленной моделью, а не ручка, которую мы крутим под рынок. Измеренная маржа возвращается в ответе (vig) — видно, что именно было снято.
  • Вся лестница, котируемая и нет. Ступени, которые референс котирует, и ступени, которых он не котировал никогда, приходят в одном массиве. Каждая помечена src: quote или src: table — вы всегда знаете, читаете вы рыночную цену или модельную. Без тихого смешивания.
  • 80%-полоса на каждой ступени (band_pp, в процентных пунктах). Полоса расширяется там, где лестница достраивается, и сужается там, где она измеряется, — то есть честно показывает, где именно наша уверенность.
  • Внутренняя согласованность. Ступени читаются с одной лестницы, поэтому цена никогда не противоречит соседней — проверено на нуле нарушений монотонности (ниже).
  • История as-of-time для бэктестов: поверхность такой, какой она была в прошлый момент времени, а не такой, какой её потом пересчитали.

Публикуемых полос неопределённости по каждой ступени мы не нашли ни у одного из 30+ вендоров, вошедших в наш обзор рынка (июль 2026). Устройство модели и источники данных остаются проприетарными — публикуем мы результат и доказательство.

Валидация

Что говорят акты

Четыре независимые проверки: против полного архива, против фактических исходов, против живого рынка в движении и против самого времени.

6,4 млн
ступеней лестниц полного архива, пересчитанных в офлайн-акте валидации
78–80%
фактическое покрытие 80%-полос — на номинале или чуть ниже, но не выше
0
нарушений монотонности на всём валидированном архиве
  • Смещение по полному архиву: от −0,024 до +0,002 пп. На 6,4 млн ступеней у поверхности нет систематического наклона ни в одну сторону — она не подкрашивает тихо один край лестницы.
  • Калибровка полос: покрытие 78–80% при номинале 80%. Полосы честные, местами чуть консервативные. Полоса, покрывающая 60% исходов, — это маркетинг; полоса на 78–80% — рабочий риск-параметр.
  • Live-сверка: 8 859 смен линий за 13 дней. При сверке с рынком, который реально двигался, смещение остаётся сбалансированным в 0,02–0,04 пп — офлайн-результат держится и в проде, а не только в архиве.
  • Согласованность: 0 нарушений монотонности. На всём валидированном архиве ни одна ступень не оценена вопреки соседней. Именно это позволяет читать лестницу целиком, а не по одной цене за раз.
  • Сезонный дрейф: 40+ месяцев, с 2023 по 2026, все в пределах 0,10 пп. Ни один сезон, цикл турниров или смена правил не тянет агрегат на себе.

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

Покрытие и свежесть

Что покрыто и насколько это свежо

Футбол

Полное покрытие: все лиги, которые котирует референсный рынок, полные лестницы фор и тоталов, 1X2 и расчётные производные.

Баскетбол — скоро

В финальной валидации (поверхность уже сверена со 118 000+ рассчитанных матчей); войдёт в покрытие со старта сезона NBA. До этого не продаётся — полупродукт мы не отгружаем.

Каденс обновления

Раз в 60 с в последние 24 часа до матча, раз в 5 мин на горизонте 24–96 часов, раз в 15 мин дальше. В каждом ответе есть data_cadence_s — чтобы ваш поллер шёл в такт.

  • История as-of: футбол с 2022 года. Любой прошлый момент читается через ?asof=.
  • Защита от подмены (tamper-evident) — с 23 июля 2026. Всё, что публикуется с этой даты, попадает в хеш-цепочку и Merkle-коммиты в момент создания. Архивные строки старше реестра отдаются как архив — мы помечаем разницу, а не размываем её.
  • Лицензия исключает использование в продуктах для беттеров: поверхность — это B2B вход в ваш прайсинг.
Доставка

Четыре способа прочитать одну и ту же поверхность

Один эндпоинт, четыре режима: сводка, одно событие целиком, историческая точка или bulk-дельта всего, что изменилось с вашего курсора.

РежимВызовДля чегоКласс лимита
СводкаGET /v1/surfaceЧто живо прямо сейчасpoint · 60/мин
Полная лестницаGET /v1/surface?event_id=Одно событие, все ступени с полосамиpoint · 60/мин
Историческая точкаGET /v1/surface?asof=Бэктесты, разбор спорных случаевpoint · 60/мин
Bulk-дельтаGET /v1/surface?since=Синхронизация локальной копииbulk · 4/мин
# одно событие, полная лестница
curl -s "https://api.foreline.io/v1/surface?event_id=EVT_8F3A21" \
  -H "X-Foreline-Key: $FORELINE_KEY"

{
  "event_id": "EVT_8F3A21",
  "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" }
  ]
}

Значения в примере иллюстративные. Семантика полей — в референсе API, лимиты опроса объяснены в разделе Каденс и опрос.

Документация API →

Доказательства

Проверяете вы, а не рассказываем мы

  • Криптографический реестр. Каждая опубликованная строка — в хеш-цепочке, каждый проход — Merkle-коммит, дневные корни ежедневно якорятся в Биткоине через OpenTimestamps. Выборочное раскрытие и правки задним числом нам недоступны.
  • Публичный верификатор. Доказательства и независимый скрипт лежат на github.com/foreline-io/foreline-proofs — одна команда python3 verify.py проверяет дневные корни, цепочку коммитов и биткоин-штампы. Без NDA, без интеграции, без аккаунта.
  • Проба на ваших референсных данных — практичный следующий шаг: наша лестница против цен, которые у вас уже есть, на ваших событиях и за ваш период.
С чего начать

Запросить тестовый доступ к поверхности

Напишите, какие виды спорта, лиги и период вам важны. В ответ пришлём ключ для пробы и акты валидации за числами с этой страницы.

Напишите нам

Обычно отвечаем в течение одного рабочего дня. Цены считаем под объём — напишите, и пришлём условия.

Запросить доступ