배당 데이터 API 문서

엔드포인트·과금·신선도·오류를 한 페이지에. 기계용 문서도 같은 내용입니다.

기계용: openapi.json · docs.md · llms.txt

시작하기

세 단계입니다.

  1. 키 받기 — POST https://oddsbunch.com/api/data/v1/keys 에 {"accept_notice": true}. 가입은 없습니다. 키(obd_…)는 한 번만 보입니다.
  2. 범위 고르기 — GET /meta/sports, /meta/leagues?sport=soccer, /matches?league=… 가 우리 ID 를 돌려줍니다.
  3. 비용 확인 뒤 받기 — GET /quote?league=… 는 차감 없이 새 경기가 몇 개 차감될지 알려 줍니다. 그다음 GET /odds?league=…, 이후로는 since=<meta.cursor> 를 붙여 바뀐 경기만 받으세요.

유료 사용은 아직 열리지 않았습니다. 지금은 모든 키가 무료 키입니다.

비용 규칙: 새 경기 수 × 0.03 USDT, UTC 달력 월마다 49 USDT 를 넘지 않습니다. 이미 받은 경기는 시작까지 다시 차감하지 않습니다.

무료 키는 5~10분 늦은 스냅숏·메인 라인만·하루 20경기·시간당 100회이고, 범위(ids·sport·league·team)를 하나 골라야 합니다. 둘러볼 때는 limit=5&main_only=true&markets=1x2 가 가볍습니다. 기본 주소: https://oddsbunch.com/api/data/v1.

쪽과 델타: meta.next_page 가 null 이 될 때까지 모든 쪽을 받으세요. 모든 쪽의 meta.cursor 는 같고, 모든 쪽을 받은 뒤에 그 커서로 다음 since 를 부릅니다. 410 cursor_expired 면 since 없이 처음부터(모든 쪽) 다시 받으세요.

BASE="https://oddsbunch.com/api/data/v1"

# 1) Free key, no sign-up (read GET $BASE/notice first). The key is shown once — save it.
curl -s -X POST "$BASE/keys" -H "Content-Type: application/json" -d '{"accept_notice": true}'
export ODDSBUNCH_KEY=obd_...   # data.key from the response

AUTH="Authorization: Bearer $ODDSBUNCH_KEY"

# 2) Scope: leagues of a sport (our IDs)
curl -s --compressed -H "$AUTH" "$BASE/meta/leagues?sport=soccer"

# 3) Cost preview (no charge), then fetch — follow meta.next_page until null (all pages share one cursor)
curl -s --compressed -H "$AUTH" "$BASE/quote?league=386"
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386" -o page1.json
CURSOR=$(jq -r '.meta.cursor' page1.json); NEXT=$(jq -r '.meta.next_page // empty' page1.json)
while [ -n "$NEXT" ]; do
  curl -s --compressed -H "$AUTH" "$BASE/odds?league=386&page_token=$NEXT" -o next.json
  NEXT=$(jq -r '.meta.next_page // empty' next.json)
done

# 4) Deltas: only matches changed since the cursor (after taking all pages)
curl -s --compressed -H "$AUTH" "$BASE/odds?league=386&since=$CURSOR"

# Errors: -i shows the status; on 429 read Retry-After, on 410 fetch again without since
curl -si --compressed -H "$AUTH" "$BASE/odds?league=386" | head -20

인증

키는 두 머리글 중 하나로 보냅니다: Authorization: Bearer obd_… 또는 X-API-Key: obd_…. 주소(쿼리)에 넣지 마세요. 사이트는 키의 해시만 저장하므로 잃은 키를 다시 보여 줄 수 없습니다 — 이메일을 연결해 뒀다면 POST /account/recover 로 계정을 되찾고, 아니면 새 무료 키를 받으세요(새 키 = 새 계정이라 산 경기·잔액이 옮겨지지 않습니다). 쓰던 키를 바꾸려면 POST /keys/rotate(부른 키는 "keep_old": true 가 아니면 바로 폐기), 키 하나 폐기는 DELETE /keys/{hint}. 폐기된 키는 401 key_revoked 와 reason 을 돌려줍니다 — 새 키를 만들지 말고 같은 계정의 다른 키를 쓰세요. 같은 계정의 키는 산 것을 모두 함께 씁니다. 읽기 엔드포인트는 Access-Control-Allow-Origin: * 라 브라우저 코드에서도 부를 수 있지만, 키 발급·복구는 CORS 를 열지 않습니다(서버·터미널에서). 유료 키를 공개 웹 페이지에 넣지는 마세요.

과금과 월 상한

유료 사용은 아직 열리지 않았습니다. 지금은 모든 키가 무료 키입니다.

  • 배당: 계정이 어떤 경기를 처음 받을 때 0.03 USDT 를 한 번 차감합니다. 그 뒤 계정의 모든 키가 그 경기(북메이커 전부·모든 시장·모든 라인)를 시작할 때까지 요청 한도 안에서 얼마든지 받으며, 시작 뒤 마감 배당과 결과도 포함됩니다.
  • 월 상한: UTC 달력 월에 시작하는 경기의 배당 차감이 49 USDT 에 닿으면 그 달 경기는 더 차감하지 않습니다. 상한은 경기가 시작하는 달 기준이라 다음 달 경기는 다음 달 상한에 듭니다. 상한에 걸치는 요청은 남은 몫만 차감합니다.
  • 필터: bookmakers·markets·main_only 는 응답을 줄일 뿐 가격을 바꾸지 않습니다. 필터로 줄이 하나도 남지 않은 경기와 배당이 없는 경기는 차감하지 않습니다(skipped: filtered_out·no_odds).
  • 직접 거는 한도: 요청마다 max_charge=<USDT>, 이미 가진 경기만 받는 buy=false, 모든 상품 합의 월 지출 한도(POST /account/budget). 넘는 요청은 402 over_budget 으로 거절되고 차감은 없습니다.
  • 부가 상품: 자체 배당 경기당 +0.01 USDT(상한 9), 조합·미들·괴리 이용권 30일 5 USDT, 마감 배당 기록 끝난 경기당 0.01 USDT(상한 밖).
  • 잔액이 모자랄 때: 이미 받은 경기는 그대로 주고, 새 경기는 빼서 billing.unpaid_matches 로 알려 줍니다(HTTP 200). 요청한 경기가 전부 새 경기인데 낼 수 없으면 402 payment_required. 유료 계정을 몰래 지연 데이터로 바꾸지 않습니다.
  • 모든 응답에 billing: charged·new_matches·balance·month_spent·month_cap·free_left_today.
  • USDT 선불: POST /account/topup 으로 충전(BSC·TRON, 최소 10 USDT). 키로만 만든 계정의 잔액은 출금할 수 없습니다. 수집이 멈춘 동안 경기를 샀거나 그 경기가 시작했고, 멈춘 동안 그 경기 배당이 갱신되지 않았다면(멈춘 데이터를 산 경우) 배당 차감을 경기 시작 뒤 자동으로 돌려 드립니다(자체 배당·마감 기록 제외). 돌려준 경기는 무효가 되어 다시 받으면 다시 차감되고, 그 금액은 상한 계산에서도 빠집니다. 취소된 경기도 돌려 드리며, 연기된 경기는 같은 ID·같은 패스로 이어집니다.
  • 가격·상한을 올리거나 무료·요청 한도를 줄이는 변경은 알린 날부터 7일이 지난 뒤 처음 오는 달 1일부터, 유리한 변경은 바로 적용합니다.

신선도 필드

배당 줄마다 네 필드가 붙어 오래된 값을 코드가 판단할 수 있습니다.

필드뜻
changed_at이 값이 마지막으로 바뀐 시각(UTC)
seen_at우리 수집에서 마지막으로 확인한 시각
age_secchanged_at 에서 meta.generated_at 까지 지난 초(응답을 만들 때 계산)
suspended북메이커가 그 라인을 내렸으면 true, 마지막 값은 남김

축구·미식축구는 증분으로 받아서, 값이 안 바뀐 줄의 seen_at 은 최대 10분 늦게 갱신됩니다 — 오래됐는지는 changed_at·age_sec 으로 보세요. book_marked_main 은 북메이커가 메인으로 표시한 라인, 줄 묶음의 main 은 우리가 고른 대표 라인입니다. 퍼센트 필드는 _pct 로 끝나고(combined_payout_pct), roi 는 비율입니다. 무료 키는 5분마다 다시 만들고 5분 이상 지난 것만 내주는 스냅숏이라 meta.delay_sec 은 300 에서 그 두 배 남짓 사이입니다. 조합은 다리마다 경과 초와 가장 오래된 다리의 경과 초를, 105% 이상 조합은 verify 상태(same 실제 값과 같음 · diff · unverifiable · pending)를 함께 줍니다.

실측 지연

북메이커가 값을 바꾼 시각부터 우리 changed_at 까지 걸린 시간(최근 데이터 실측). 보통 1분 안팎이며, 늦을 때는 몇 분입니다.

종목중앙값90%
축구42초75초
아이스하키39초174초
이스포츠43초67초
농구58초—
미식축구64초168초

측정 2026-11-18 · 최근 2시간 표본 · 북메이커 갱신 시각 → 우리 반영 시각

오류

오류는 늘 같은 모양이라 에이전트가 사람 없이 다음 일을 할 수 있습니다.

{
  "ok": false,
  "error": "payment_required",
  "message": "Balance 0.01 USDT is below the 0.03 USDT needed for 1 new match.",
  "fix": "Top up with POST /account/topup, or narrow the scope (ids=…).",
  "docs": "https://oddsbunch.com/api/data/v1/docs.md#errors",
  "docs_html": "https://oddsbunch.com/en/api/docs#errors",
  "request_id": "r_…"
}
HTTPerror할 일
400bad_scope응답에 허용 매개변수 목록이 있습니다. 쿼리를 고치세요.
400bad_param매개변수 값이 틀렸습니다. invalid 에 어느 칸인지 나옵니다.
400notice_required"accept_notice": true 를 보내세요(먼저 GET /notice).
400scope_required_free무료 키는 범위(ids·sport·league·team)를 하나 골라야 합니다.
400bad_json올바른 JSON 을 보내세요.
401key_missing · key_invalidPOST /keys 로 키를 받거나 머리글을 확인하세요.
401key_revoked폐기된 키입니다(reason). 새 계정을 만들지 말고 같은 계정의 다른 키를 쓰세요.
402payment_required충전(POST /account/topup)하거나 범위를 줄이세요.
402over_budgetmax_charge 나 월 지출 한도를 넘어 차감하지 않았습니다. 한도를 올리거나 범위를 줄이거나 buy=false 를 쓰세요.
402addon_required30일 이용권(POST /addons/arbs)이 필요합니다.
403suspended이 계정의 API 사용이 정지되었습니다. support@oddsbunch.com 으로 문의하세요.
403not_on_sale유료 기능이 열려 있지 않습니다(아직이거나 판매를 멈춤 — 이미 산 것은 계속 됩니다).
403bad_origin키 발급·복구는 다른 사이트의 페이지가 아니라 서버·터미널에서 하세요.
404not_found없는 주소나 경기이거나, 패스 없이 시작한 경기입니다.
409key_limit_account · last_key · ambiguous_hint활성 키가 너무 많음(하나 폐기) · 이메일 없는 계정의 마지막 키(정말 원하고 잔액이 0 일 때만 ?confirm=lose_account) · 끝 4자가 같은 키가 둘(하나를 교체).
410cursor_expiredsince 없이 처음부터(모든 쪽) 다시 받고 새 커서로 이어 가세요.
413 · 415body_too_large · unsupported_mediaJSON 본문은 16KB 아래로, Content-Type: application/json 으로 보내세요.
429rate_limitedRetry-After 초만큼 기다리세요(limit_kind 가 어느 한도인지 알려 줍니다).
429free_daily_limit오늘 무료 경기를 다 썼습니다. 이미 받은 경기는 계속 됩니다. resets_at(00:00 UTC)에 다시 채워집니다.
429key_limit_ip이 IP 에서 오늘 새 키를 너무 많이 받았습니다. 가진 키를 쓰세요.
500server간격을 늘려 다시 시도하세요.
503unavailableRetry-After 초 뒤 다시 시도하세요.

한도

무료 키유료 키
요청배당·경기·결과 시간당 100회, 메타·견적·계정·안내 시간당 300회분당 120회, 같은 범위 전체(델타 아님) 요청은 분당 2회
경기UTC 하루 새 경기 20개하루 셈 없음(경기당 과금, 월 상한)
데이터5~10분 늦은 스냅숏, 메인 라인최신(추가 지연 없음), 모든 라인
부가 상품성적표만자체 배당·조합 이용권·마감 배당 기록
키IP 당 하루 새 키 3개—

데이터가 바뀌는 속도보다 빨리 부르지 마세요: 유료 키는 60초쯤마다, 무료 키는 5분마다. since 를 쓰면 매번 바뀐 경기만 옵니다.

엔드포인트

OpenAPI 명세(openapi.json)에서 만든 목록입니다. 카드마다 과금 종류·매개변수·예시 응답.

POST /keys 무료

Free key without sign-up

Billing: free

JSON body
{
  "accept_notice": true,
  "label": "string",
  "lang": "string",
  "via": "page"
}
예시 응답
{
  "ok": true,
  "data": {
    "key": "string",
    "key_hint": "string",
    "shown_once": true,
    "tier": "string",
    "limits": {
      "delay_sec": 0,
      "delay_max_sec": 0,
      "daily_matches": 0,
      "hourly_requests": 0,
      "light_hourly_requests": 0,
      "main_lines_only": true,
      "scope_required": true
    },
    "notice": {
      "version": "string",
      "url": "string",
      "summary": [
        "string"
      ]
    },
    "warning": "string",
    "next": [
      {
        "do": "string",
        "request": "string"
      }
    ],
    "docs": {
      "openapi": "string",
      "markdown": "string",
      "human": "string"
    },
    "revoked_hint": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/sports 무료

Active sports

Billing: free

매개변수
이름형식필수설명
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/leagues 무료

Active leagues (ids for scopes)

Billing: free

매개변수
이름형식필수설명
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
예시 응답
{
  "ok": true,
  "data": [
    {
      "id": 0,
      "sport": "string",
      "name": "string",
      "name_en": "string",
      "country": "string",
      "upcoming_7d": 0
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/bookmakers 무료

Bookmaker slugs

Billing: free

매개변수 없음

예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /meta/markets 무료

Markets, outcomes, period, line_step

Billing: free

매개변수 없음

예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /matches 무료

Fixtures, status, scores (no odds)

Billing: free

매개변수
이름형식필수설명
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
fromstring–UTC date or date-time
tostring–UTC date or date-time
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
statusstring–scheduled,live,finished,other
예시 응답
{
  "ok": true,
  "data": [
    {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /results 무료

Finished scores

Billing: free

매개변수
이름형식필수설명
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
datestring–UTC day YYYY-MM-DD
fromstring–UTC date or date-time
tostring–UTC date or date-time
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
예시 응답
{
  "ok": true,
  "data": [
    {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /odds 경기당 과금 · 0.03 USDT

Odds for not-yet-started matches in scope

Billing: odds pass per new match (0.03 USDT, monthly cap 49)

매개변수
이름형식필수설명
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
hoursinteger–Matches starting within N hours (default 168)
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
sincestring–Cursor from meta.cursor (delta)
changes_onlyboolean–In a delta, only changed lines
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
예시 응답
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "pass": "odds",
      "source": "live",
      "markets": [
        {
          "market": "…",
          "lines": "…"
        }
      ]
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /odds/{match_id} 경기당 과금 · 0.03 USDT

One match, everything

Billing: odds pass per new match (0.03 USDT, monthly cap 49)

매개변수
이름형식필수설명
match_id (path)integer*
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
main_onlyboolean–Representative line only for handicap/totals (always true on free keys)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
예시 응답
{
  "ok": true,
  "data": {
    "match": {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    },
    "pass": "odds",
    "source": "live",
    "markets": [
      {
        "market": "1x2",
        "lines": [
          "…"
        ]
      }
    ]
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /quote 무료

Cost preview, no charge

Billing: free

매개변수
이름형식필수설명
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
hoursinteger–Matches starting within N hours (default 168)
marketsstring–Comma-separated: 1x2, ml, handicap, totals
bookmakersstring–Bookmaker slugs (does not change the price)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
productstring (odds | model | closing)–
예시 응답
{
  "ok": true,
  "data": {
    "product": "string",
    "tier": "string",
    "matches_in_scope": 0,
    "with_pass": 0,
    "new_matches": 0,
    "price": 0,
    "cost": 0,
    "month": "string",
    "month_spent": 0,
    "month_cap": 0,
    "cap_left": 0,
    "cap_reached_after": true,
    "balance": 0,
    "affordable_matches": 0,
    "would_be_unpaid": 0,
    "budget_month": 0,
    "budget_spent": 0,
    "budget_left": 0,
    "over_budget": true,
    "skipped": {
      "no_odds": 0,
      "filtered_out": 0,
      "started": 0,
      "free_daily_limit": 0
    },
    "free_left_today": 0,
    "if_paid": {},
    "note": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /model 자체 배당 · 경기당 과금 · 0.01 USDT 유료 — 준비 중

Model odds (soccer 1X2)

Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)

매개변수
이름형식필수설명
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
예시 응답
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "model": "string",
      "market": "string",
      "p": {
        "home": 0,
        "draw": 0,
        "away": 0
      },
      "fair": {
        "home": 0,
        "draw": 0,
        "away": 0
      },
      "basis": "lineup",
      "official": true,
      "computed_at": "string",
      "pre_complete": true,
      "complete": true,
      "history": [
        {
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /model/{match_id} 자체 배당 · 경기당 과금 · 0.01 USDT 유료 — 준비 중

Model odds for one match

Not open yet (403 not_on_sale until paid access opens). Billing: model pass per new match (0.01 USDT, monthly cap 9)

매개변수
이름형식필수설명
match_id (path)integer*
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
예시 응답
{
  "ok": true,
  "data": {
    "match": {
      "id": 0,
      "sport": "string",
      "league": {
        "id": 0,
        "sport": "string",
        "name": "string",
        "name_en": "string",
        "country": "string",
        "upcoming_7d": 0
      },
      "home": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "away": {
        "id": 0,
        "name": "string",
        "name_en": "string"
      },
      "start_time": "string",
      "status": "scheduled",
      "status_detail": "string",
      "score": {
        "home": 0,
        "away": 0
      },
      "score_regular": {
        "home": 0,
        "away": 0
      },
      "url": "string",
      "bookmakers": 0,
      "has_odds": true,
      "has_model": true
    },
    "model": "string",
    "market": "string",
    "p": {
      "home": 0,
      "draw": 0,
      "away": 0
    },
    "fair": {
      "home": 0,
      "draw": 0,
      "away": 0
    },
    "basis": "lineup",
    "official": true,
    "computed_at": "string",
    "pre_complete": true,
    "complete": true,
    "history": [
      {
        "p": {},
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /model/scorecard 무료

Live record of the model

Billing: free

매개변수 없음

예시 응답
{
  "ok": true,
  "data": {
    "model": "string",
    "what": "string",
    "since": "string",
    "updated_at": "string",
    "groups": [
      {
        "basis": "string",
        "data": "complete",
        "n": 0,
        "brier_model": 0,
        "brier_market": 0,
        "diff": 0,
        "se": 0,
        "verdict": "better",
        "virtual_picks": {
          "n": "…",
          "roi": "…"
        }
      }
    ],
    "notes": [
      "string"
    ]
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /arbs 30일 이용권 · 5 USDT 유료 — 준비 중

Arbitrage list

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

매개변수
이름형식필수설명
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_payoutnumber–
예시 응답
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "market": "string",
      "line": 0,
      "combined_payout_pct": 0,
      "legs": [
        {
          "outcome": "…",
          "side": "…",
          "line": "…",
          "bookmaker": "…",
          "odds": "…",
          "stake_share_pct": "…",
          "changed_at": "…",
          "age_sec": "…"
        }
      ],
      "oldest_leg_age_sec": 0,
      "stale": true,
      "verify": "string"
    }
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /middles 30일 이용권 · 5 USDT 유료 — 준비 중

Middles list

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

매개변수
이름형식필수설명
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
min_missnumber–
예시 응답
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "market": "string",
      "window": {
        "from": 0,
        "to": 0
      },
      "legs": [
        {
          "outcome": "…",
          "side": "…",
          "line": "…",
          "bookmaker": "…",
          "odds": "…",
          "stake_share_pct": "…",
          "changed_at": "…",
          "age_sec": "…"
        }
      ],
      "miss_payout_pct": 0,
      "hit_payout_pct": 0,
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /spreads 30일 이용권 · 5 USDT 유료 — 준비 중

Price gaps

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

매개변수
이름형식필수설명
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
outcomestring–
min_pctnumber–
예시 응답
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "market": "string",
      "outcome": "string",
      "best": {
        "bookmaker": "string",
        "odds": 0,
        "changed_at": "string"
      },
      "median": 0,
      "gap_pct": 0,
      "books": 0
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /closing 끝난 경기당 · 0.01 USDT 유료 — 준비 중

Closing odds of finished matches

Not open yet (403 not_on_sale until paid access opens). Billing: closing pass per finished match (0.01 USDT, outside the cap)

매개변수
이름형식필수설명
idsstring–Comma-separated match ids (max 100); not combined with sport/league/team
sportstring (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football)–Sport code (football = American football; american_football also works)
leaguestring–League ids, comma-separated (max 20)
teamstring–Team ids, comma-separated (max 20)
datestring–UTC day YYYY-MM-DD
max_chargenumber–Refuse (402 over_budget) if this request would charge more
buyboolean–false = only matches you already have
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
예시 응답
{
  "ok": true,
  "data": [
    {
      "match": {
        "id": 0,
        "sport": "string",
        "league": {
          "id": "…",
          "sport": "…",
          "name": "…",
          "name_en": "…",
          "country": "…",
          "upcoming_7d": "…"
        },
        "home": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "away": {
          "id": "…",
          "name": "…",
          "name_en": "…"
        },
        "start_time": "string",
        "status": "scheduled",
        "status_detail": "string",
        "score": {
          "home": "…",
          "away": "…"
        },
        "score_regular": {
          "home": "…",
          "away": "…"
        },
        "url": "string",
        "bookmakers": 0,
        "has_odds": true,
        "has_model": true
      },
      "result": {},
      "markets": [
        {
          "market": "…",
          "lines": "…"
        }
      ],
      "taken_at": "string",
      "source": "string"
    }
  ],
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /account 무료

Balance, spend, caps, passes, keys

Billing: free

매개변수 없음

예시 응답
{
  "ok": true,
  "data": {
    "account": {
      "kind": "anon",
      "tier": "string",
      "status": "string",
      "suspended": true,
      "email_linked": true,
      "created_at": "string",
      "withdrawable": true,
      "paid_enabled": true
    },
    "balance": 0,
    "month": "string",
    "budget": {
      "month_limit": 0,
      "spent": 0,
      "left": 0,
      "budget_month": 0
    },
    "odds": {
      "spent": 0,
      "cap": 0,
      "passes": 0,
      "cap_by_month": [
        {
          "month": "…",
          "spent": "…"
        }
      ],
      "free_today": {
        "used": 0,
        "limit": 0,
        "resets_at": "string"
      }
    },
    "model": {},
    "closing": {},
    "addons": [
      {
        "product": "arbs",
        "status": "string",
        "starts_at": "string",
        "ends_at": "string",
        "auto_renew": true,
        "charged": 0,
        "changed": "string"
      }
    ],
    "keys": [
      {
        "hint": "string",
        "label": "string",
        "created_at": "string",
        "last_used_at": "string",
        "current": true
      }
    ],
    "topup": {
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /account/passes 무료 유료 — 준비 중

Passes of the account

Not open yet (403 not_on_sale until paid access opens). Billing: free

매개변수
이름형식필수설명
monthstring–
kindstring–
limitinteger–Matches per page (odds max 100, matches/results max 200)
page_tokenstring–meta.next_page from the previous page
예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/budget 무료 유료 — 준비 중

Monthly spending limit

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "budget_month": 0
}
예시 응답
{
  "ok": true,
  "data": {
    "month_limit": 0,
    "spent": 0,
    "left": 0,
    "budget_month": 0
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/topup 무료 유료 — 준비 중

Deposit addresses (prepaid USDT)

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "accept_notice": true,
  "network": "bsc"
}
예시 응답
{
  "ok": true,
  "data": {
    "on_sale": true,
    "min": 0,
    "networks": [
      "string"
    ],
    "addresses_issued": true,
    "pending": [
      {}
    ],
    "not_credited": [
      {
        "network": "string",
        "amount": 0,
        "seen_at": "string",
        "reason": "string"
      }
    ],
    "not_credited_total": 0,
    "addresses": [
      {
        "network": "string",
        "token": "string",
        "address": "string",
        "confirmations": 0,
        "confirmation": "string",
        "watch_until": "string"
      }
    ],
    "below_min": "string",
    "credit": "string",
    "withdraw_note": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /addons/arbs 30일 이용권 · 5 USDT 유료 — 준비 중

30-day arbs subscription

Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)

JSON body
{
  "auto_renew": true
}
예시 응답
{
  "ok": true,
  "data": {
    "product": "arbs",
    "status": "string",
    "starts_at": "string",
    "ends_at": "string",
    "auto_renew": true,
    "charged": 0,
    "changed": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /keys/rotate 무료

New key for the same account

Billing: free

JSON body
{
  "label": "string",
  "keep_old": true
}
예시 응답
{
  "ok": true,
  "data": {
    "key": "string",
    "key_hint": "string",
    "shown_once": true,
    "tier": "string",
    "limits": {
      "delay_sec": 0,
      "delay_max_sec": 0,
      "daily_matches": 0,
      "hourly_requests": 0,
      "light_hourly_requests": 0,
      "main_lines_only": true,
      "scope_required": true
    },
    "notice": {
      "version": "string",
      "url": "string",
      "summary": [
        "string"
      ]
    },
    "warning": "string",
    "next": [
      {
        "do": "string",
        "request": "string"
      }
    ],
    "docs": {
      "openapi": "string",
      "markdown": "string",
      "human": "string"
    },
    "revoked_hint": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

DELETE /keys/{hint} 무료

Revoke a key by its last 4 characters

Billing: free

매개변수
이름형식필수설명
hint (path)string*
confirmstring (lose_account)–
예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/link-email 무료 유료 — 준비 중

Recovery email (sends a code)

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "email": "string"
}
예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/link-email/verify 무료 유료 — 준비 중

Confirm the recovery email

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "code": "string",
  "old_code": "string"
}
예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/link-email/old-code 무료 유료 — 준비 중

Code to the currently linked email

Not open yet (403 not_on_sale until paid access opens). Billing: free

매개변수 없음

예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/recover 무료 유료 — 준비 중

Start recovery with the linked email

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "email": "string"
}
예시 응답
{
  "ok": true,
  "data": null,
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
    "charged": 0,
    "new_matches": 0,
    "kind": "odds",
    "unpaid_matches": [
      0
    ],
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/recover/verify 무료 유료 — 준비 중

Finish recovery (new key)

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "email": "string",
  "code": "string",
  "accept_notice": true,
  "label": "string"
}
예시 응답
{
  "ok": true,
  "data": {
    "key": "string",
    "key_hint": "string",
    "shown_once": true,
    "tier": "string",
    "limits": {
      "delay_sec": 0,
      "delay_max_sec": 0,
      "daily_matches": 0,
      "hourly_requests": 0,
      "light_hourly_requests": 0,
      "main_lines_only": true,
      "scope_required": true
    },
    "notice": {
      "version": "string",
      "url": "string",
      "summary": [
        "string"
      ]
    },
    "warning": "string",
    "next": [
      {
        "do": "string",
        "request": "string"
      }
    ],
    "docs": {
      "openapi": "string",
      "markdown": "string",
      "human": "string"
    },
    "revoked_hint": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

POST /account/refund-address 무료 유료 — 준비 중

Refund address during a shutdown notice

Not open yet (403 not_on_sale until paid access opens). Billing: free

JSON body
{
  "chain": "bsc",
  "address": "string"
}
예시 응답
{
  "ok": true,
  "data": {
    "chain": "bsc",
    "address": "string",
    "ends_at": "string",
    "fallback": "string",
    "note": "string"
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
      "lang": "string"
    },
    "request_id": "string",
    "api_version": "string",
    "notice_update": {
      "version": "string",
      "url": "string"
    },
    "snapshot": "string",
    "notice": "string"
  },
  "billing": {
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

GET /notice 무료

Notice text (5 languages)

Billing: free

매개변수
이름형식필수설명
langstring (en | ko | ja | zh | zh-hant | es)–Names language (default: account language, else en)
예시 응답
{
  "ok": true,
  "data": {
    "version": "string",
    "lang": "string",
    "short": [
      "string"
    ],
    "items": [
      "string"
    ],
    "terms_url": "string",
    "docs_url": "string",
    "measured_delay": [
      {
        "sport": "string",
        "p50_sec": 0,
        "p90_sec": 0
      }
    ]
  },
  "skipped": [
    {
      "id": 0,
      "reason": "not_found",
      "fix": "string"
    }
  ],
  "data_added": [
    {
      "id": 0,
      "reason": "entered_window"
    }
  ],
  "data_removed": [
    {
      "id": 0,
      "reason": "started"
    }
  ],
  "meta": {
    "generated_at": "string",
    "data_as_of": "string",
    "delay_sec": 0,
    "tier": "free",
    "notice_url": "string",
    "docs": "string",
    "docs_html": "string",
    "cursor": "string",
    "next_page": "string",
    "applied": {
      "main_only": true,
      "markets": [
        "string"
      ],
      "bookmakers": "all",
      "hours": 0,
      "buy": true,
      "max_charge": 0,
      "sport": "string",
…

오류 응답: 400 · 401 · 402 · 403 · 404 · 409 · 410 · 413 · 415 · 429 · 500 · 503

안내(정확성·지연·책임)

  1. 이 데이터는 정보 제공용이며, 정확성·완전성·적시성을 보장하지 않습니다.
  2. 배당은 북메이커 사이트의 실제 값과 다를 수 있고, 수집 주기나 통신 문제로 늦거나 빠질 수 있습니다. 보통은 북메이커 갱신 뒤 1분 안팎에 반영되지만 늦으면 몇 분이 걸립니다(종목별 실측은 문서). 줄마다 붙는 changed_at·seen_at·age_sec 로 오래된 값을 직접 거르세요.
  3. 조합(아비트리지)·미들·배당 괴리는 수집한 배당으로 기계적으로 계산한 값이라, 배당 변경·중단·북메이커의 베팅 한도 때문에 실제로 성립하지 않을 수 있습니다.
  4. 자체 배당(oddsbunch-model-v1)은 과거 경기 기록으로 만든 추정치이며 결과를 보장하지 않습니다. 실전 성적표를 무료로 공개합니다.
  5. 이 데이터를 바탕으로 한 결정과 그로 인한 손실에 사이트는 책임지지 않습니다. 받은 데이터를 다시 팔거나 다른 사람에게 재배포하지 마세요(약관 7-2 가 허용한 범위의 이용은 제외).

이용약관 7-2 데이터 API 이용 →

동의: POST /keys·POST /account/topup 에 "accept_notice": true. 키를 받으면 이 안내와 이용약관 7-2 에 동의한 것으로 봅니다.

버전 정책

v1 은 늘어나기만 합니다: 필드·엔드포인트·enum 값·오류 코드는 언제든 더할 수 있으니 모르는 것은 무시하세요. 깨는 변경(필드 삭제·이름 변경·뜻이나 기본값 변경)은 새 버전(/api/data/v2)으로 내고, v1 은 최소 90일 함께 돌며 응답에 Deprecation·Sunset 머리가 붙습니다. 모든 변경은 변경 기록(docs.md#changelog)에 남고, 지금 버전은 meta.api_version 입니다. 북메이커·종목·리그 범위 변화는 버전 변경이 아닙니다(/meta/* 로 확인). 안내문이 바뀌면 새 키 발급·충전 때 다시 동의를 받고, 기존 키는 meta.notice_update 로 알립니다.