proplineapi/propline-mcp

Только для Backfill-pass / Enterprise. Массовая история изменений коэффициентов в формате CSV - каждый записанный снимок коэффициентов (цена + линия, по каждой букмекерской конторе, включая рынки по периодам) по всему виду спорта, одна строка на (исход, снимок). Это сырой поток данных, который ни один тариф подписки не может выгружать массово (Pro/Streaming используют propline_get_odds_history для каждого события). ТРЕБУЕТСЯ окно since/until, чтобы ограничить выгрузку - полный архив занимает гигабайты на каждый вид спорта. Результат ограничен первыми 200 строками для безопасности контекста; для полного набора данных используйте конечную точку /v1/exports/odds-history напрямую с curl/SDK и сохраняйте поток на диск. Неподписанные ключи получают 403 с указанием на обновление.

Сравнение линий между букмекерами (Hobby+ — для цен; бесплатный тариф получает полную структуру с идентификаторами букмекеров и ранжированием от лучшего к худшему, но цены обнулены и redacted:true). Для каждого кортежа (рынок, игрок, линия) на событии возвращает единственную лучшую американскую цену по всем сопоставимым букмекерам, а также массив all_prices, отсортированный от лучшего к худшему (одна строка на букмекера, каждая с last_update). Сопутствующая функция для propline_get_event_ev: /ev показывает, превышает ли цена безвиговую справедливую линию; best-line показывает, какой букмекер платит больше всех. Букмекеры DFS pick'em (PrizePicks, Sleeper, Dabble) исключены; Underdog — только для четких двухсторонних линий. Опциональный фильтр букмекеров для сравнения только тех контор, где у пользователя есть счета.

Бесплатный уровень: справочные вычисления. Возвращает таблицу выплат для PrizePicks Power Play (все выборы должны выиграть) и Flex Play (частичные выплаты) для 2–6 выборов, а также вероятность безубыточности на выбор для каждой игры. Передайте leg_win_prob (например, 0.58), чтобы также получить expected_return (на $1) и is_plus_ev для каждой игры — безубыточность на уровне купона. Полезно для: «какой процент попаданий нужен, чтобы обыграть Power Play из 4 выборов в PrizePicks», «является ли Flex из 3 выборов +EV при 60% на выбор». ПРИМЕЧАНИЕ: только стандартные опубликованные выплаты — модификаторы demon/goblin на выбор отсутствуют в ленте PrizePicks (см. поле дисклеймера); безубыточность предполагает независимые выборы.

Контекст игры для события — условия, при которых завершается ставка на атрибут. MLB: предполагаемые стартовые питчеры и их бросающая рука (L/R/S — расстановочный контекст для каждой ставки на отбивающего), флаг подтверждённого состава, арбитр за домом и погода на момент первого броска (температура, ветер, осадки) на стадионах под открытым небом или с раздвижной крышей (на крытых стадионах погода=null). NFL и NCAAF: стадион и погода на момент начала игры. Тот же блок встроен в get_event_results, поэтому каждая оценённая ставка несёт свои условия — это уникальная особенность PropLine. Бесплатный тариф. 404, если контекст для события ещё не сохранён.

Конечная точка уровня Pro. Возвращает +EV по каждому исходу события. За точку отсчёта берём самую острую букмекерскую контору, убираем маржу, получаем честную линию без маржи и считаем EV% для каждой конторы по одной и той же линии. Исходы сортируются так, что +EV варианты поднимаются наверх в каждой группе линий. PrizePicks исключается из расчёта EV (выплаты в DFS несопоставимы с коэффициентами обычных контор). Точка отсчёта выбирается ДЛЯ КАЖДОЙ ЛИНИИ в порядке: pinnacle → polymarket → kalshi → bovada → smarkets, и в каждой линии поле fair_source указывает, какая контора использовалась — ориентируйтесь на fair_source для каждой линии, не думайте, что Pinnacle всегда был точкой отсчёта. Необязательный параметр bookmakers фильтрует коэффициенты по конторам, где есть аккаунт у пользователя; он не меняет точку отсчёта, так что фильтрация по DraftKings всё равно сравнивает DraftKings с Pinnacle.

Детекция движения линии и стима на основе истории тиков снимков. По каждому (букмекер, рынок, исход): открывающая линия, последняя линия, знаковое смещение подразумеваемой вероятности, смещение пунктов, направление. Массив steam[] помечает исходы, где несколько букмекеров двинули линию в одном направлении — классический сигнал умных денег, рассчитывается по всем 27 букмекерам в опросах PropLine. Когда букмекер двигает линию сам, prob_shift у такого исхода равен null, а direction — 'line_moved' (исключается из сигнала стима). Ни одно API с коэффициентами только по запросу такого не даёт. В Hobby+ всё доступно; на бесплатном тарифе эта функция скрыта.

Рыночная консенсус-проекция по каждой паре (игрок, рынок) для события: линия, где no-vig P(over) пересекает 50%, медиана по всем участвующим букмекерам. Используйте её для проверки статистических или фэнтези-проекций против живого рынка. Это РЫНОЧНЫЕ значения, полученные исключительно из букмекерских коэффициентов — это не прогноз, и никакой точности не гарантируется; подавайте их как «рынок подразумевает X», а не «PropLine прогнозирует X». Цены DFS pick'em исключены; каждая строка содержит books_contributing и стабильный player_id (null, пока игрок не отыгран). Hobby+ — для значений; бесплатный тариф получает структуру без деталей.

Эндпоинт Pro-tier. Возвращает оцененные исходы проп-ставок для завершенного события — каждый Over/Under отмечен как выигранный, проигранный, возврат или аннулирован с фактическим статистическим значением рядом с линией. Единственная самая отличительная особенность по сравнению с the-odds-api: они не оценивают проп-ставки ни на каком уровне. Бесплатный уровень возвращает ту же структуру, но resolution и actual_value скрыты, плюс указание на обновление.

Независимая от букмекеров сырая статистика бокс-скора для завершенного события. Возвращает статистику по игрокам (например, страйкауты, хиты, очки, подборы, броски по воротам), отделенную от линий любой букмекерской конторы. Бесплатный тариф.

Бесплатный тарифный план. Возвращает долгосрочные рынки (аутрайты) на сезон для вида спорта — победители чемпионата/Супербоула/дивизиона/конференции, MVP и обладатели наград, тоталы побед за сезон — сведённые по Bovada, FanDuel, DraftKings, Pinnacle и Kalshi. Одна строка на (событие фьючерса, букмекера, рынок) с исходом каждой команды/игрока и его коэффициентом. Крупные рынки (победитель Супербоула, MVP, дивизион/конференция) котируются несколькими букмекерами для сравнения; экзотические рынки часто доступны только у одного. Применение: «кто фавориты Супербоула у разных букмекеров», «коэффициенты на MVP NFL», «чемпионские фьючерсы NBA». Фьючерсы не рассчитаны (нет оценки расчёта).

Эндпоинт бесплатного тарифа. Возвращает синтетический ежедневный MLB Grand Salami для указанной даты в UTC: общее количество ранов, набранных во всех играх MLB в рамках слота, плюс подразумеваемая линия Grand Salami каждой букмекерской конторы (медиана первичных сумм на отдельные игры по нашим MLB-букмекерам, включая Pinnacle, Polymarket, Matchbook, Smarkets). Ни одна розничная букмекерская контора не котирует это как отдельный рынок. Полезен для: «какая общая линия ранов на сегодняшний полный слот MLB», «превысил ли Grand Salami вчера», «исторические результаты Grand Salami для бэктестинга».

Эндпоинт для бесплатного уровня. Возвращает синтетический ежедневный тотал голов НХЛ (хоккейный аналог MLB Grand Salami) для заданной даты по UTC: общее количество голов, забитых во всех матчах НХЛ в этот игровой день (включая овертаймы и буллиты), плюс подразумеваемая линия ежедневного тотала голов от каждой букмекерской конторы (медиана основных тоталов на матч по всем нашим букмекерам НХЛ). Ни одна розничная букмекерская контора не выставляет этот рынок как отдельный. Полезен для: 'какова линия тотала на весь сегодняшний игровой день НХЛ', 'превысил ли вчерашний Daily Goals Total', 'исторические результаты ежедневного тотала голов НХЛ для бэктестинга'.

Возвращает живые коэффициенты. Если указан event_id, возвращает полные коэффициенты по событиям для этого матча; в противном случае возвращает массовые коэффициенты на линию игры для всего вида спорта. Передавайте маркеты в виде списка через запятую (например, 'h2h,spreads,totals' или 'player_points,player_rebounds'). Ответ содержит массив bookmakers[] по каждой букмекерской конторе, которая ведет запрошенные маркеты (на данный момент до 27: Bovada, DraftKings, FanDuel, Pinnacle, BetMGM, BetRivers, Unibet, BetUS, BetOnline.ag, LowVig.ag, MyBookie.ag, Fanatics, Marathon Bet, 1xBet, TAB, Underdog Fantasy, PrizePicks, Sleeper, Dabble, Betr Picks, ReBet, Kalshi, Polymarket, Matchbook, Smarkets, Novig, ProphetX — покрытие зависит от вида спорта). Исходы Underdog Fantasy несут payout_multiplier в КАЖДОМ исходе (1.0 = стандартный выбор, например, 1.5 = буст, 0.75 = дисконт; null означает, что контора — не Underdog) — при сравнении линий DFS с консенсусом букмекерских контор учитывайте только payout_multiplier == 1.0, поскольку фильтрация по непустому значению отбросит все линии Underdog. У каждого маркета есть suspended_at: null, пока он в игре, и значение, когда контора сняла маркет до игры (поздний отказ, снятый тип маркета) — тогда его исходы являются последними озвученными выборами, а не живой ценой. Считайте приостановленный маркет не подлежащим ставкам, а если несколько контор показывают его по одному игроку, то вероятным отказом. Каждая БУКМЕКЕРСКАЯ КОНТОРА несет pregame_only: true, когда событие идет в лайве и эта контора не выставляет цены в игре, поэтому ее цены являются последней предматчевой котировкой и больше не изменятся в этом матче. suspended_at не может это показать — контора без лайв-фида не опрашивается после начала игры, поэтому ничего не пропадает для пометки. Исключайте pregame_only конторы при анализе лайв-игры; они все равно возвращаются, потому что на DFS-биржах замороженная линия — это то, с чем рассчитывается ставка. Каждый маркет также несет team: каноническое имя командного события, когда маркет ограничен ОДНОЙ командой (командный тотал), и null для общего тотала. Оба используют ключ totals, поэтому НИКОГДА не сравнивайте тоталы только по (маркету, пункту) — командный тотал на 0.5...

Hobby+ endpoint. Возвращает линию закрытия для каждой (книга, рынок, исход) события — последний снимок в момент commence_time или до него. Канонический помощник отслеживания CLV; один вызов возвращает точку данных, с которой должна сравниваться ваша ставка, вместо загрузки полной истории и постобработки. Каждый исход содержит поле closing_at с recorded_at снимка. Бесплатный тариф возвращает сокращенную структуру с указанием на обновление.

Hobby+ endpoint. Возвращает историческую серию снимков движения линии для события (каждое зарегистрированное изменение цены/показателя по исходу за время существования события). Бесплатный тариф возвращает структуру рынка со скрытыми снимками и указателем на обновление. Поддерживает фильтры за период: from/to (абсолютный ISO), relative_from/relative_to (смещения относительно commence_time, например '-3h' или '0'), downsample по интервалу ('30s'/'1m'/'5m'/'15m'/'30m'/'1h') и changes_only=true, чтобы отбросить неизменённые соседние снимки.

Игрок получает последние игры с полной статистикой по каждому матчу — один вызов вместо отдельного запроса на каждое событие. Используйте это, чтобы ответить на вопрос «как X на самом деле выступал в последнее время?» и самостоятельно построить разбивки по L5/L10/L20, сезону и очным встречам. Передайте opponent для H2H (принимает полное имя, прозвище или аббревиатуру — 'Boston Red Sox', 'Red Sox', 'BOS'); параметр limit применяется ПОСЛЕ этого фильтра, поэтому opponent + limit=10 означает последние 10 ВСТРЕЧ, а не игры против Boston среди последних 10 матчей. H2H не ограничивается текущим сезоном. ВАЖНО: это архив сырых бокс-скоров, а НЕ история ставок на линии — он охватывает каждую игру с доступным бокс-скором, включая матчи, на которые букмекеры не выставляли линию, так что окно «последние 10 игр» здесь действительно означает последние 10 игр (в отличие от данных из propline_get_player_trends, где матчи без линии молча пропускаются). Здесь нет линии, коэффициента или результата ставки; для статистики по ставкам против выставленной линии используйте propline_get_player_trends. Поля player_team/opponent/is_home остаются пустыми, когда сторону игрока определить нельзя, и всегда пусты для индивидуальных видов спорта (теннис, гольф, UFC) — сообщайте их как неизвестные, а не угадывайте.

История проп-ставок игрока за последние игры. Возвращает каждую предыдущую проп-ставку этого игрока с линией, коэффициентами, результатом и фактическим значением. Pro-уровень возвращает полные данные; бесплатный уровень возвращает скрытые результат/фактическое значение с подсказкой об обновлении.

Тренды по проценту попаданий / процент превышения за последние N игр для игрока — уникальны для данных по разрешению пропозиций PropLine. Для каждого рынка, по которому у игрока есть история оценок, возвращает разбивки по превышению/непревышению/равенству по последним 5/10/20/50 оценённым играм, текущую серию, средний фактический показатель и последнюю линию. Это поверхность «превысил ли X в N из последних M игр?». Опустите market для всех рынков или передайте один для сужения (например, 'player_points', 'batter_hits').

Бесплатный эндпоинт. Возвращает фактический объём ставок на действия игроков (player props), по которым PropLine вывел результаты (graded) на основе реальных бокс-скоров за последние N дней (только агрегированные подсчёты): всего выведено/урегулировано, игры, охваченные виды спорта, а также разбивка по видам спорта и топ-рынкам. Полезно для: «сколько данных по размеченным ставкам PropLine имеет, какой охват». Доказательство охвата, а не заявление о доходности.

Бесплатный endpoint. Возвращает текущие и live-счета игр, а также статус (запланирована, идёт, завершена) для вида спорта. Полезно для вопросов вроде: «эта игра уже закончилась? какой финальный счёт?»

Последние попытки доставки для одного вебхука (тариф Streaming Lite и выше), сначала новые — отладочная поверхность для вопроса «почему мой вебхук не срабатывает». Каждая строка: статус (pending/success/failed), HTTP response_code, attempts, delivered_at и отправленный payload. Строка со статусом pending и attempts > 0 находится в процессе retry-backoff; статус 'failed' с response_code null означает, что endpoint недоступен или истекло время ожидания (8 с). Перелистывайте страницы назад по глубокой очереди с before_id = наименьший id на предыдущей странице; страница короче limit — последняя.

Эндпоинт Hobby+. Оценивает РАЗМЕЩЕННЫЕ ставки относительно их закрывающих линий. Значение закрывающей линии — единственный надежный показатель наличия у игрока преимущества: превысила ли цена, которую он взял, число, на котором остановился рынок? Отправляет ставки, и каждая возвращается со своей закрывающей ценой, очищенной от маржи справедливой вероятностью закрытия, CLV, а после завершения игры — с оцененным результатом и фактическим значением статистики, а также со сводкой портфеля. Не сохраняет состояние: ничего не хранится. ДВА значения CLV возвращаются намеренно. clv_pct: цена против цены, знакомое и цитируемое значение, но СЛЕПОЕ К МАРЖЕ, поэтому оно льстит ставке, сделанной на выгодной стороне широкого рынка. ev_vs_close_pct оценивает цену относительно ОЧИЩЕННОЙ ОТ МАРЖИ цены закрытия и даёт честную оценку. Сообщайте его, когда пользователь спрашивает, получил ли он ценность. Очистка от маржи привязывается к САМОЙ ОСТРОЙ букмекерской конторе, котировавшей эту линию на закрытии (fair_source), а не к конторе, в которой они сделали ставку, потому что очистка от маржи в их собственной конторе всегда возвращает отрицательное число (они заплатили её удержание). Ставки, событие по которым ещё не началось, имеют closing_is_final=false, учитываются в summary.pending и ИСКЛЮЧАЮТСЯ из средних значений сводки: до начала матча «закрывающая» цена — это просто последняя цена, поэтому CLV по построению равен ~0. Не представляйте их как результаты. Сопоставление работает по принципу отказа с блокировкой: ставка, которая не может быть привязана ровно к одному сохранённому исходу, возвращает matched=false с unmatched_reason вместо неверного сопоставления, поэтому выводите такие строки, а не молча отбрасывайте их. Максимум 500 ставок на запрос. Бесплатный тариф возвращает структуру, в которой все числа равны null.

Перечисляет типы рынков, доступные для конкретного события (например, h2h, spreads, totals, player_points, pitcher_strikeouts). Полезно, когда вы не знаете, какие проп-рынки содержит событие.

Перечисляет предстоящие события для вида спорта. Возвращает id каждого события, home_team, away_team, commence_time. Используйте возвращённый event_id для детального просмотра коэффициентов, дополнительных ставок (props), +EV или результатов.

Перечисляет все виды спорта, по которым PropLine в настоящее время собирает данные. Возвращает ключи видов спорта (например, baseball_mlb, basketball_nba, soccer_epl) вместе с удобочитаемыми названиями и статусом активности. Сначала используйте этот инструмент, чтобы узнать, какие значения sport_key действительны для других инструментов.

Перечисляет подписки на webhook для ключа API (тариф Streaming Lite и выше; остальные тарифы получают 403 с URL для обновления). Только чтение: секреты подписи всегда маскируются, и этот сервер намеренно не имеет инструментов создания/обновления/удаления — управляйте подписками через REST API или SDK. Каждая строка показывает URL, подписанные события (line_movement, resolution, steam, market_suspended), фильтры и статус активности. Используйте это в первую очередь, чтобы найти ID webhook для propline_get_webhook_deliveries.

Hobby+ endpoint. Prices a same-game parlay at the BOOK'S OWN correlated odds — the price a FanDuel customer would be offered for that exact slip right now, not a model of it. bookmaker is fanduel (default, its own pricer) or betonlineag / lowvig (the Sportcast engine both share, same builder price). Send 2-10 legs from ONE event, each named exactly as propline_get_odds names an outcome: market key, name (team / Over / Under / player for YES-only props), description (the player on a two-way prop, '' for game lines), point (omit for h2h and YES-only props), period (omit for full game) and team for a TEAM total (omit for the game total; a totals leg with no team matches the game total only) — or book_outcome_id from includeBookIds (on betonlineag / lowvig that is Sportcast's settlement id, e.g. MatchWinner_Home). The response carries sgp_price (the book's parlay price), independent_price (the product of the live single-leg prices) and correlation_factor = their ratio: below 1 the book is charging for correlation, above 1 it is paying for anti-correlation — say which when presenting it. Matching is fail-closed: a leg that does not pin to exactly one stored outcome is a 422 leg_unmatched naming the leg (an Over with no point on an event with two total lines is refused, not guessed) — fix the leg, do not retry blindly. quoted=false means the book will not offer that combination as an SGP; refused legs carry the book's own failure_code. Free tier returns the matched legs with every price nulled.

Повторно читает события подписки вебхука по порядку от курсора — отвечает на вопрос «мой endpoint был недоступен, что я пропустил?». Каждая доставка несёт заголовок X-PropLine-Sequence, счётчик, монотонный В ПРЕДЕЛАХ одной подписки; передавайте самое высокое значение, которое пользователь уже обработал, как since_seq. НЕ используйте delivery id как курсор: этот id глобален для всех подписок, так что пропуски в нём — это чужой трафик, и они ничего не значат. События возвращаются ОТ СТАРЫХ К НОВЫМ (в отличие от propline_get_webhook_deliveries, где порядок от новых к старым — это отладочный лог). Листайте, передавая next_seq как since_seq, пока has_more равно true. ВСЕГДА проверяйте truncated: значение true означает, что события после курсора уже вышли за срок хранения (2 дня, максимум 5 000 доставок на подписку) и невосстановимы — сообщите пользователю, что нужно пересинхронизироваться через REST endpoints, а не считайте их доставленными. latest_seq не подчиняется сроку хранения, поэтому latest_seq - next_seq честно показывает «насколько отстали», даже когда строки уже удалены. Номера последовательности всегда растут и не повторяются, но НЕ гарантированно плотные — пропущенный номер это норма, а не признак потери данных.