배당 데이터 API 문서
엔드포인트·과금·신선도·오류를 한 페이지에. 기계용 문서도 같은 내용입니다.
기계용: openapi.json · docs.md · llms.txt
시작하기
세 단계입니다.
- 키 받기 —
POST https://oddsbunch.com/api/data/v1/keys에{"accept_notice": true}. 가입은 없습니다. 키(obd_…)는 한 번만 보입니다. - 범위 고르기 —
GET /meta/sports,/meta/leagues?sport=soccer,/matches?league=…가 우리 ID 를 돌려줍니다. - 비용 확인 뒤 받기 —
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 -20import os, time, requests
BASE = "https://oddsbunch.com/api/data/v1"
def get_key():
# Free key, no sign-up. Store it safely; it cannot be shown again.
r = requests.post(f"{BASE}/keys", json={"accept_notice": True}, timeout=30)
r.raise_for_status()
return r.json()["data"]["key"]
KEY = os.environ.get("ODDSBUNCH_KEY") or get_key()
S = requests.Session()
S.headers["Authorization"] = f"Bearer {KEY}" # requests sends Accept-Encoding: gzip by default
class CursorExpired(Exception):
pass
def call(path, **params):
while True:
r = S.get(f"{BASE}{path}", params=params, timeout=30)
if r.status_code == 429: # rate limited
time.sleep(int(r.headers.get("Retry-After", "60")))
continue
body = r.json()
if r.status_code == 410: # cursor_expired: start over without since
raise CursorExpired()
if r.status_code == 401: # key_missing / key_invalid / key_revoked
raise SystemExit(f"Key problem: {body['error']} -> {body['fix']}")
if r.status_code == 402: # payment_required / over_budget
raise SystemExit(f"{body['error']}: {body['message']} -> {body['fix']}")
if not body.get("ok"):
raise RuntimeError(f"{body['error']}: {body['message']} ({body['docs']})")
return body
def fetch_all(**params):
"""All pages of one request. Every page has the same meta.cursor."""
items, removed, cursor, token = [], [], None, None
while True:
page = call("/odds", **params, **({"page_token": token} if token else {}))
cursor = page["meta"]["cursor"]
items += page["data"]
removed += page.get("data_removed", [])
token = page["meta"]["next_page"]
if not token:
return items, removed, cursor, page["meta"]["tier"]
leagues = call("/meta/leagues", sport="soccer")["data"]
league_id = leagues[0]["id"]
quote = call("/quote", league=league_id)["data"]
print("new matches:", quote["new_matches"], "cost:", quote["cost"], "USDT")
# An agent should ask its human before a large charge (or pass max_charge=…).
seen = set() # de-duplicate lines across deltas
items, _, cursor, tier = fetch_all(league=league_id)
for item in items:
m = item["match"]
print(m["id"], m["home"]["name"], "vs", m["away"]["name"])
while True:
time.sleep(60 if tier == "paid" else 300) # free snapshots are rebuilt every 5 min
try:
items, removed, cursor, tier = fetch_all(league=league_id, since=cursor)
except CursorExpired:
items, removed, cursor, tier = fetch_all(league=league_id) # start over (all pages)
for item in items:
for mk in item["markets"]:
for ln in mk["lines"]:
for b in ln["books"]:
k = (item["match"]["id"], b["bookmaker"], mk["market"], ln["line"], b["changed_at"])
if k not in seen:
seen.add(k)
print("changed:", k)
for r in removed:
print("removed:", r["id"], r["reason"])const BASE = "https://oddsbunch.com/api/data/v1";
async function getKey() {
// Free key, no sign-up (call from a server or a terminal). Store it safely; it cannot be shown again.
const r = await fetch(`${BASE}/keys`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ accept_notice: true }),
});
if (!r.ok) throw new Error(`key: HTTP ${r.status}`);
return (await r.json()).data.key;
}
const KEY = process.env.ODDSBUNCH_KEY || (await getKey());
const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
class CursorExpired extends Error {}
async function call(path, params = {}) {
const url = `${BASE}${path}?${new URLSearchParams(params)}`;
for (;;) {
const r = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } }); // fetch handles gzip
if (r.status === 429) { await sleep(1000 * Number(r.headers.get("Retry-After") || 60)); continue; }
const body = await r.json();
if (r.status === 410) throw new CursorExpired();
if (r.status === 401) throw new Error(`Key problem: ${body.error} -> ${body.fix}`);
if (r.status === 402) throw new Error(`${body.error}: ${body.message} -> ${body.fix}`);
if (!body.ok) throw new Error(`${body.error}: ${body.message} (${body.docs})`);
return body;
}
}
async function fetchAll(params) {
// All pages of one request share meta.cursor; use it only after the last page.
let items = [], removed = [], token = null, page;
do {
page = await call("/odds", token ? { ...params, page_token: token } : params);
items = items.concat(page.data);
removed = removed.concat(page.data_removed || []);
token = page.meta.next_page;
} while (token);
return { items, removed, cursor: page.meta.cursor, tier: page.meta.tier };
}
const leagues = (await call("/meta/leagues", { sport: "soccer" })).data;
const league = leagues[0].id;
const quote = (await call("/quote", { league })).data;
console.log("new matches:", quote.new_matches, "cost:", quote.cost, "USDT");
let res = await fetchAll({ league });
console.log(res.items.length, "matches");
for (;;) {
await sleep(res.tier === "paid" ? 60_000 : 300 * 1000);
try {
res = await fetchAll({ league, since: res.cursor });
} catch (e) {
if (!(e instanceof CursorExpired)) throw e;
res = await fetchAll({ league }); // start over (all pages)
}
for (const item of res.items) console.log("changed:", item.match.id);
for (const r of res.removed) console.log("removed:", r.id, r.reason);
}
인증
키는 두 머리글 중 하나로 보냅니다: 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_sec | changed_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_…"
}
| HTTP | error | 할 일 |
|---|---|---|
| 400 | bad_scope | 응답에 허용 매개변수 목록이 있습니다. 쿼리를 고치세요. |
| 400 | bad_param | 매개변수 값이 틀렸습니다. invalid 에 어느 칸인지 나옵니다. |
| 400 | notice_required | "accept_notice": true 를 보내세요(먼저 GET /notice). |
| 400 | scope_required_free | 무료 키는 범위(ids·sport·league·team)를 하나 골라야 합니다. |
| 400 | bad_json | 올바른 JSON 을 보내세요. |
| 401 | key_missing · key_invalid | POST /keys 로 키를 받거나 머리글을 확인하세요. |
| 401 | key_revoked | 폐기된 키입니다(reason). 새 계정을 만들지 말고 같은 계정의 다른 키를 쓰세요. |
| 402 | payment_required | 충전(POST /account/topup)하거나 범위를 줄이세요. |
| 402 | over_budget | max_charge 나 월 지출 한도를 넘어 차감하지 않았습니다. 한도를 올리거나 범위를 줄이거나 buy=false 를 쓰세요. |
| 402 | addon_required | 30일 이용권(POST /addons/arbs)이 필요합니다. |
| 403 | suspended | 이 계정의 API 사용이 정지되었습니다. support@oddsbunch.com 으로 문의하세요. |
| 403 | not_on_sale | 유료 기능이 열려 있지 않습니다(아직이거나 판매를 멈춤 — 이미 산 것은 계속 됩니다). |
| 403 | bad_origin | 키 발급·복구는 다른 사이트의 페이지가 아니라 서버·터미널에서 하세요. |
| 404 | not_found | 없는 주소나 경기이거나, 패스 없이 시작한 경기입니다. |
| 409 | key_limit_account · last_key · ambiguous_hint | 활성 키가 너무 많음(하나 폐기) · 이메일 없는 계정의 마지막 키(정말 원하고 잔액이 0 일 때만 ?confirm=lose_account) · 끝 4자가 같은 키가 둘(하나를 교체). |
| 410 | cursor_expired | since 없이 처음부터(모든 쪽) 다시 받고 새 커서로 이어 가세요. |
| 413 · 415 | body_too_large · unsupported_media | JSON 본문은 16KB 아래로, Content-Type: application/json 으로 보내세요. |
| 429 | rate_limited | Retry-After 초만큼 기다리세요(limit_kind 가 어느 한도인지 알려 줍니다). |
| 429 | free_daily_limit | 오늘 무료 경기를 다 썼습니다. 이미 받은 경기는 계속 됩니다. resets_at(00:00 UTC)에 다시 채워집니다. |
| 429 | key_limit_ip | 이 IP 에서 오늘 새 키를 너무 많이 받았습니다. 가진 키를 쓰세요. |
| 500 | server | 간격을 늘려 다시 시도하세요. |
| 503 | unavailable | Retry-After 초 뒤 다시 시도하세요. |
한도
| 무료 키 | 유료 키 | |
|---|---|---|
| 요청 | 배당·경기·결과 시간당 100회, 메타·견적·계정·안내 시간당 300회 | 분당 120회, 같은 범위 전체(델타 아님) 요청은 분당 2회 |
| 경기 | UTC 하루 새 경기 20개 | 하루 셈 없음(경기당 과금, 월 상한) |
| 데이터 | 5~10분 늦은 스냅숏, 메인 라인 | 최신(추가 지연 없음), 모든 라인 |
| 부가 상품 | 성적표만 | 자체 배당·조합 이용권·마감 배당 기록 |
| 키 | IP 당 하루 새 키 3개 | — |
데이터가 바뀌는 속도보다 빨리 부르지 마세요: 유료 키는 60초쯤마다, 무료 키는 5분마다. since 를 쓰면 매번 바뀐 경기만 옵니다.
엔드포인트
OpenAPI 명세(openapi.json)에서 만든 목록입니다. 카드마다 과금 종류·매개변수·예시 응답.
/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
/meta/sports
Active sports
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| lang | string (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
/meta/leagues
Active leagues (ids for scopes)
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| lang | string (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
/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
/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
/matches
Fixtures, status, scores (no odds)
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| status | string | – | 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
/results
Finished scores
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| from | string | – | UTC date or date-time |
| to | string | – | UTC date or date-time |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/odds
Odds for not-yet-started matches in scope
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| since | string | – | Cursor from meta.cursor (delta) |
| changes_only | boolean | – | In a delta, only changed lines |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/odds/{match_id}
One match, everything
Billing: odds pass per new match (0.03 USDT, monthly cap 49)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| match_id (path) | integer | * | |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| main_only | boolean | – | Representative line only for handicap/totals (always true on free keys) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (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
/quote
Cost preview, no charge
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| hours | integer | – | Matches starting within N hours (default 168) |
| markets | string | – | Comma-separated: 1x2, ml, handicap, totals |
| bookmakers | string | – | Bookmaker slugs (does not change the price) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| product | string (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
/model
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)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/model/{match_id}
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_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (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
/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
/arbs
Arbitrage list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_payout | number | – |
예시 응답
{
"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
/middles
Middles list
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| min_miss | number | – |
예시 응답
{
"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
/spreads
Price gaps
Not open yet (403 not_on_sale until paid access opens). Billing: arbs subscription (5 USDT per 30 days)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | meta.next_page from the previous page |
| outcome | string | – | |
| min_pct | number | – |
예시 응답
{
"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
/closing
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)
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| ids | string | – | Comma-separated match ids (max 100); not combined with sport/league/team |
| sport | string (soccer | basketball | baseball | football | volleyball | esports | hockey | american_football) | – | Sport code (football = American football; american_football also works) |
| league | string | – | League ids, comma-separated (max 20) |
| team | string | – | Team ids, comma-separated (max 20) |
| date | string | – | UTC day YYYY-MM-DD |
| max_charge | number | – | Refuse (402 over_budget) if this request would charge more |
| buy | boolean | – | false = only matches you already have |
| lang | string (en | ko | ja | zh | zh-hant | es) | – | Names language (default: account language, else en) |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/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
/account/passes
Passes of the account
Not open yet (403 not_on_sale until paid access opens). Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| month | string | – | |
| kind | string | – | |
| limit | integer | – | Matches per page (odds max 100, matches/results max 200) |
| page_token | string | – | 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
/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
/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
/addons/arbs
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
/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
/keys/{hint}
Revoke a key by its last 4 characters
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| hint (path) | string | * | |
| confirm | string (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
/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
/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
/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
/account/link-email
Unlink the recovery email
Not open yet (403 not_on_sale until paid access opens). Billing: free
JSON body
{
"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
/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
/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
/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
/notice
Notice text (5 languages)
Billing: free
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| lang | string (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분 안팎에 반영되지만 늦으면 몇 분이 걸립니다(종목별 실측은 문서). 줄마다 붙는 changed_at·seen_at·age_sec 로 오래된 값을 직접 거르세요.
- 조합(아비트리지)·미들·배당 괴리는 수집한 배당으로 기계적으로 계산한 값이라, 배당 변경·중단·북메이커의 베팅 한도 때문에 실제로 성립하지 않을 수 있습니다.
- 자체 배당(oddsbunch-model-v1)은 과거 경기 기록으로 만든 추정치이며 결과를 보장하지 않습니다. 실전 성적표를 무료로 공개합니다.
- 이 데이터를 바탕으로 한 결정과 그로 인한 손실에 사이트는 책임지지 않습니다. 받은 데이터를 다시 팔거나 다른 사람에게 재배포하지 마세요(약관 7-2 가 허용한 범위의 이용은 제외).
동의: 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 로 알립니다.