API로 포커 레인지 에퀴티를 어떻게 계산하나요?

각 플레이어의 레인지, 선택적 보드 및 재현 가능한 몬테카를로 제어 값을 PokerKit 에퀴티 엔드포인트로 전송하세요. 반환된 지분을 사용해 제공된 시나리오를 설명하되, 결과를 예측하는 데 사용하지 마세요.

업데이트됨 2026년 7월 26일관리 주체: Pokerai API

직접 답변: 플레이어별 표기법 배열 하나를 포함하는 ranges와 함께 POST /v1/pokerkit/equity를 호출합니다. 선택적으로 보드, sample_count, seed를 포함할 수 있습니다. 응답은 제공된 각 레인지의 몬테카를로 에퀴티 하나와 사용된 샘플 수를 반환합니다.

빠른 정보

엔드포인트	`POST /v1/pokerkit/equity`
입력	PokerKit 레인지 표기법으로 된 플레이어별 레인지 두 개 이상이며, `board`는 선택 사항입니다.
방법	몬테카를로 에퀴티 추정입니다. 제공된 레인지와 보드에 대한 추정값을 반환하며, 승률 보장은 아닙니다.
응답	`result.equities`는 `ranges`와 일치하도록 정렬됩니다. `result.sample_count`는 샘플링 컨텍스트를 보고합니다.
할당량	이 엔드포인트는 풀이 할당량 1을 차감합니다. 현재 Free 등급에는 매월 실시간 풀이 25회가 포함됩니다.
접근	PokerKit 및 GTO 엔드포인트는 동일한 API 키를 사용합니다. 지원되는 API 키 헤더 하나를 전송하세요.

입력 의미

각 플레이어에 대해 중첩된 레인지 배열 하나를 사용합니다. 반환되는 에퀴티는 동일한 순서를 사용하므로 배열 순서가 중요합니다. 보드를 제공하는 경우 AhKhQh와 같이 구분자가 없는 카드 문자열입니다.

필드	의미
`ranges`	필수입니다. 플레이어별 레인지 표기 문자열 배열입니다. 예: `[["AA"], ["KK"]]`.
`board`	알려진 보드를 위한 선택적 카드 문자열입니다. 보드를 알 수 없는 경우 생략하거나 빈 문자열을 사용하세요.
`sample_count`	선택 사항인 몬테카를로 샘플 수입니다. 문서화된 서비스 상한이 적용되며, 설정하지 않으면 기본값이 사용됩니다.
`seed`	재현 가능한 샘플링을 위한 선택적 시드입니다.

최소 API 요청

이 공개 문서 코드 예제는 보드가 나오기 전에 고정된 샘플 수와 시드로 AA와 KK를 비교합니다. HTTP 요청을 보낼 때 인증 헤더로 API 키를 추가하세요.

{"ranges": [["AA"], ["KK"]], "board": "", "sample_count": 2000, "seed": 7}

예시 응답 및 해석

{"result": {"equities": [0.8235, 0.1765], "sample_count": 2000}}

첫 번째 값인 0.8235는 첫 번째 입력 레인지(AA)에 해당하고, 두 번째 값인 0.1765는 KK에 해당합니다. UI 또는 보고서에서 이 순서를 유지하세요.

sample_count: 2000은 이 응답에 사용된 몬테카를로 샘플 수로 읽으세요. 이는 이 추정치의 샘플링 맥락을 설명하며, 향후 딜, 베팅 또는 성능에 관한 약속이 아닙니다.

사용 시점

레인지와 보드가 사용자에게 명시적으로 표시되는 교육 제품, 종료된 핸드 검토, 코칭 도구, 연구 또는 설명 UI에서 이 엔드포인트를 사용하세요. 추정값을 감사 가능하게 유지하려면 제공된 입력을 결과와 함께 저장하세요.

사용하지 말아야 할 경우

에퀴티 추정치를 실제 돈이 걸린 핸드에서의 행동 프롬프트로 사용하지 마세요. 이는 플레이어의 판단, 완전한 게임 모델 또는 솔버 전략을 대체하지 않습니다. 하나의 추정치가 승리, 미래 카드 또는 베팅 결과를 보장한다고 암시하지 마세요.

할당량 및 인증

요청과 함께 Authorization: Bearer $POKERAI_API_KEY(또는 동등한 X-API-Key)를 전송하세요. 이 엔드포인트는 풀이 할당량 1을 소모하며, 현재 Free 등급에는 매월 실시간 풀이 25회가 포함됩니다. 대량 작업을 설계하기 전에 대시보드에서 현재 사용량을 확인하고 할당량 주제를 읽으세요.

오류

HTTP	의미	수행할 작업
401	`missing_api_key` 또는 `invalid_api_key`입니다.	유효한 API 키 헤더 하나를 전송하고 키가 클라이언트 로그에 기록되지 않도록 하세요.
할당량	해당 월간 할당량이 소진되면 `quota_exceeded`가 발생합니다.	월간 재설정을 기다리거나 작업량을 조정하세요. 변경되지 않은 요청은 재시도하지 마세요.
422	잘못된 본문 형태 등의 이유로 요청 유효성 검사가 실패했습니다.	현재 API 참조 또는 OpenAPI 스키마를 확인하고 입력을 수정하세요.

교육 및 검토 전용

Pokerai API를 교육, 코칭, 핸드 리뷰, 학습 및 연구에 사용하세요. 실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다. 에퀴티 표시를 라이브 테이블 자동화에서 제외하고, 이를 액션 추천으로 바꾸지 마세요.