proplineapi/propline-mcp

Создайте для пользователя бесплатный персональный ключ PropLine API и отправьте его по ЭЛЕКТРОННОЙ ПОЧТЕ. Используйте этот инструмент, когда пользователь хочет собственный ключ: например, он упёрся в лимит запросов shared-demo-key, платное поле вернулось скрытым или он спрашивает, как получить ключ. Вызывайте его только с адресом электронной почты, который пользователь явно дал вам для этой цели в этом разговоре; никогда не угадывайте, не переиспользуйте адрес из других источников и не регистрируйте третьих лиц. Ключ никогда не возвращается сюда: он уходит в этот почтовый ящик с инструкциями, как переподключить этого ассистента с его помощью. Бесплатный тариф: 1 000 запросов в день, карта не нужна. Если на адрес уже выпущен ключ, ключ отправляется повторно (не чаще раза в день).

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

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

Эндпоинт бесплатного уровня. Насколько точно каждая букмекерская контора котирует player props: котировки props на закрытии каждой конторы очищаются от маржи и оцениваются (Brier) относительно реального результата и относительно других контор на той же линии. По каждой конторе: props scored, brier, consensus_brier, skill_bp (> 0 = ближе к результату, чем среднее по рынку) с 95% интервалом, verdict (beats_market / trails_market / in_line) и margin_pct (средний overround), плюс разбивки by_sport и by_market. Полезно для: 'какая контора точнее всех котирует props', 'у какой конторы самая низкая маржа'. Отчёт по ценообразованию, а не заявка на прибыль или преимущество в ставках.

Бесплатный уровень: справочные вычисления. Возвращает таблицу выплат для 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.

Эндпоинт бесплатного тарифа. Сопоставление id для одного вида спорта: один объект на событие в диапазоне от 3 дней назад до 30 дней вперёд с event id из PropLine, commence_time, командами (+ ключи/id команд), espn_event_id, mlb_game_pk, merged_from_event_ids и собственным event id каждой букмекерской конторы + ссылкой в books. Пригодится для: «соединить события PropLine с ESPN / MLB Stats API / собственным фидом букмекера», «какой id у DraftKings для этой игры».

Движение линии + детекция steam по истории тиков из снапшота. Для каждой (book, market, outcome): открывающая линия, последняя линия, знаковое смещение подразумеваемой вероятности, смещение пункта, направление. Массив steam[] помечает исходы, где несколько букмекеров двинули в одну сторону - классический сигнал sharp-money, рассчитанный по всем 37 букмекерам, которые опрашивает PropLine. Когда букмекер сам двигает линию, prob_shift у этого исхода равен null, а direction - 'line_moved' (исключается из steam-сигнала). Ни один pull-only odds API такого не выдаёт. У каждого исхода есть outcome_id (id, который используют /odds и вебхуки); строки steam содержат team (team totals) плюс open_point/latest_point. Hobby+ full; в бесплатном тарифе данные скрыты.

Рыночная консенсус-проекция по каждой паре (игрок, рынок) для события: линия, где 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 для бэктестинга».

Эндпоинт бесплатного тарифа. Возвращает синтетический дневной тотал голов NHL (хоккейный аналог MLB Grand Salami) на заданную дату по восточному времени США: суммарные голы во всех матчах NHL в этот день (включая OT/SO) плюс подразумеваемая линия Daily Goals Total от каждой конторы (медиана основных тоталов по каждому матчу среди наших букмекеров NHL). Ни одна розничная букмекерская контора не котирует это как отдельный рынок. Полезен для: «какой тотал голов на весь сегодняшний игровой день NHL», «сыграл ли Daily Goals Total на больше вчера», «исторические результаты дневных голов NHL для бэктестинга».

Получает лайв-коэффициенты. Если передан event_id, возвращает полный набор пропов по этому событию; иначе возвращает общий набор коэффициентов на игровые линии по всему виду спорта. Передавайте markets списком через запятую (например, 'h2h,spreads,totals' или 'player_points,player_rebounds'). Ответ содержит массив bookmakers[] по всем конторам, которые предлагают запрошенные markets (сейчас до 37 - букмекеры: Bovada, DraftKings, FanDuel, Pinnacle, BetMGM, BetRivers, Unibet, Betway, Hard Rock Bet, Fanatics, BetUS, BetOnline.ag, LowVig.ag, 1xBet, TAB AU, ReBet, Fliff, Courtside, Sportzino, Heritage Sports, Jazz Sports, YouWager, Thrillzz; DFS: PrizePicks, Underdog, Sleeper, Dabble, ParlayPlay, DraftKings Pick6; биржи и рынки предсказаний: Kalshi, Polymarket, Polymarket US, Matchbook, Smarkets, Novig, ProphetX, SX Bet - покрытие зависит от вида спорта). У каждого market есть line_type: 'main', 'alternate' или 'milestone' (ступень N+, например '3+ Strikeouts'); фильтруйте по line_type == 'main', чтобы взять основную линию каждой конторы. Строки Kalshi и Polymarket US также задают line_type у каждого outcome. Outcomes Underdog Fantasy несут payout_multiplier у КАЖДОГО outcome (1.0 = стандартный пик, например 1.5 = буст, 0.75 = дисконт; null значит, что контора не Underdog) - оставляйте только payout_multiplier == 1.0 при сравнении линий DFS с консенсусом букмекеров, потому что фильтр по non-null выкинул бы все линии Underdog. У каждого market есть suspended_at: null, пока он в линии; значение выставляется, когда контора сняла market до игры (поздняя замена, отказ от типа market) - тогда его outcomes это последние котировавшиеся плечи, а не лайв-цена. Считайте приостановленный market неиграбельным, а если его показывают несколько контор по одному игроку, то вероятной заменой. У каждого BOOKMAKER есть pregame_only: true, когда событие в лайве, а контора не даёт на него котировок в игре, так что её цены это последняя предматчевая котировка, и больше в этом матче они не изменятся. suspended_at этого не покажет - контору без лайв-фида вообще не опрашивают после старта игры, так что пропадать и подавать сигнал нечему. Исключайте…

Эндпоинт уровня Hobby+. Возвращает линию OPENING и CLOSING по (book, market, outcome) для события. CLOSING = последний снимок на момент commence_time или раньше (price/point/closing_at); OPENING = первый снимок, который PropLine хранит для outcome, как бы задолго до старта букмекер его ни выложил (opening_price/opening_point/opening_at); передайте opening_window, чтобы ограничить эту ретроспективу. Каноничный помощник для отслеживания CLV: один вызов возвращает обе точки данных, с которыми нужно сравнивать вашу ставку, вместо того чтобы тянуть всю историю и обрабатывать её постфактум. Сравнивайте и POINTS, и цены: на спредах и тоталах число двигается не меньше цены, поэтому сравнение только по цене даёт неверную оценку для этих рынков. opening_age_seconds показывает, за сколько до старта был записан открывающий снимок: архив начинается с 2026-04, так что маленькое значение означает, что PropLine поздно начал опрос и это не настоящее открытие букмекера. Бесплатный тариф возвращает структуру с вырезанными данными и указанием на апгрейд.

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

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

История prop-ставок игрока по недавним играм для одного рынка. Возвращает каждую предыдущую prop-ставку, которую сделал этот игрок, с line, prices, resolution, actual value, is_main_line (основная линия букмекера против ступени альтернативной лестницы) и line_moved_in_play. Передайте main_line_only=true, чтобы убрать альтернативные ступени. Тариф Pro возвращает полные данные; бесплатный тариф возвращает скрытые resolution/actual_value с указателем на апгрейд.

Тренды по проценту попаданий / процент превышения за последние 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 действительны для других инструментов.

Перечисляет вебхук-подписки API-ключа (тариф Streaming Lite и выше; на остальных тарифах приходит 403 со ссылкой на апгрейд). Только чтение: секреты подписи всегда маскируются, а инструментов создания/обновления/удаления на этом сервере намеренно нет - управляйте подписками через REST API или SDK. Каждая строка показывает url, события, на которые оформлена подписка (line_movement, resolution, steam, market_suspended, ev), фильтры (в т.ч. min_ev_pct / max_ev_pct / ev_fair_source для событий ev) и статус активности. Сначала используйте этот инструмент, чтобы найти id вебхука для propline_get_webhook_deliveries.

Hobby+ эндпоинт. Оценивает экспресс на одну игру по СОБСТВЕННЫМ скоррелированным коэффициентам букмекера: это цена, которую клиент FanDuel получил бы за этот точный купон прямо сейчас, а не модель такой цены. Параметр bookmaker принимает значение fanduel (по умолчанию, собственный прайсер), draftkings (прайсер его виджета SGP), betonlineag / lowvig (общий движок Sportcast, у них одинаковая цена сборки) или 'all', чтобы получить котировки всех букмекеров по одним и тем же исходам за один вызов. Тогда ответ содержит {quotes, errors, best_bookmaker}, и best_bookmaker - это букмекер с наименьшим снижением за корреляцию (используйте 'all' всякий раз, когда пользователь спрашивает, у какого букмекера поставить SGP). Отправьте 2-10 исходов из ОДНОГО события, каждый должен быть назван точно так же, как propline_get_odds называет исход: market key, name (team / Over / Under / player для пропов только на Да), description (игрок в двустороннем пропе, '' для игровых линий), point (опустите для h2h и пропов только на Да), period (опустите для полного матча) и team для TEAM total (опустите для общего тотала; тотал без команды соответствует только общему тоталу), или book_outcome_id из includeBookIds (на betonlineag / lowvig это settlement id от Sportcast, например MatchWinner_Home). Ответ содержит sgp_price (цену экспресса букмекера), independent_price (произведение текущих цен отдельных исходов) и correlation_factor = их отношение: ниже 1 букмекер берёт плату за корреляцию, выше 1 он платит за антикорреляцию - укажите, какой это случай, при представлении ответа. Сопоставление работает по принципу fail-closed: исход, который не привязывается ровно к одному сохранённому результату, возвращает ошибку 422 leg_unmatched с указанием исхода (Over без point на событии с двумя тоталами отклоняется, а не угадывается) - исправьте исход, не повторяйте вслепую. quoted=false означает, что букмекер не предложит эту комбинацию как SGP; отклонённые исходы содержат собственный failure_code букмекера. Бесплатный тариф возвращает сопоставленные исходы со всеми ценами null.

Повторно читает события подписки вебхука по порядку от курсора — отвечает на вопрос «мой 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 честно показывает «насколько отстали», даже когда строки уже удалены. Номера последовательности всегда растут и не повторяются, но НЕ гарантированно плотные — пропущенный номер это норма, а не признак потери данных.

Находит игрока по фрагменту имени и получает его стабильный player_id (например, 'mlb:677951'), а также все варианты написания, которые используют букмекеры (known_names). Бесплатный тариф. Передайте player_id как player_name в propline_get_player_history / propline_get_player_trends, чтобы избежать неоднозначности из-за написания имени.