← 모든 가이드
이 페이지에서
가이드 GTO 전략 · 01/08 솔버 앱 10 분 중급

PokerAI Cache API로 만드는 저지연 실시간 포커 분석 제품

저장된 전략이 도착하면 액션 빈도를 바로 보여주세요. 실제 200NL 3벳 핸드로 스팟 검색부터 세 스트리트 탐색, 필요한 시점에 EV와 에퀴티를 조회하는 방법까지 살펴봅니다.

업데이트됨 관리 주체 Pokerai API

/cache/query 응답이 도착하는 즉시 전략을 표시하세요. 사용자가 해당 패널을 열 때 /cache/ev 또는 /cache/eq를 호출하면 지표를 불러오는 동안에도 전략을 살펴볼 수 있습니다.

Cache API를 쓰기 좋은 경우

세 스트리트의 전략을 바로 보여주고 싶을 때 쓰는 방식입니다. 전체 전략이 미리 계산된 스팟은 플랍, 턴, 리버를 하나의 포스트플랍 게임 트리에서 함께 풉니다. 보드나 액션이 달라져도 같은 해의 노드를 읽기 때문에 스트리트 사이의 균형 일관성이 유지됩니다. 내시 균형 근사는 원래 레인지, 스택, 베팅 트리와 솔버 정밀도에 따릅니다.

전략과 별도의 EV·에퀴티 요청에는 Builder 또는 Pro가 필요합니다. 유효한 API 키라면 누구나 커버리지를 무료로 확인할 수 있습니다. 현재 일부 스팟만 캐시에 있습니다. 디렉터리는 사용 가능한 루트를 보여주고, 개별 액션이나 카드의 조회 가능 여부는 전략 응답에서 확인할 수 있습니다.

200NL 3벳 팟의 핵심 정보

프리플랍 팩은 6max_RC_100bb_200NL입니다. MP가 오픈하고 SB가 **A♥K♥**로 3벳합니다. 플랍은 **4♣8♦9♥**입니다. 팟은 19 BB, 남은 유효 스택은 91 BB입니다.

세 스트리트 베팅 라인
스트리트와 보드액션다음 단계
플랍4♣ 8♦ 9♥SB 13 BB 베팅
MP 콜
다음 카드 A♠
턴A♠SB 14 BB 베팅
MP 콜
다음 카드 7♦
리버7♦SB 22 BB 베팅
MP 콜
쇼다운
그림 1. MP가 세 번 모두 콜해 쇼다운까지 진행합니다.

SB가 13, 14, 22 BB를 베팅하고 MP가 매번 콜하는 라인을 따라갑니다. 리버에서 A♥K♥는 대부분 체크하지만, 여기서는 22 BB 베팅을 선택해 쇼다운까지 진행합니다.

전략이 저장된 스팟 찾기

/cache/coverage에 프리플랍 팩과 플랍을 보내면 저장된 전략이 있는 스팟을 확인할 수 있습니다. 유효한 API 키라면 누구나 조회할 수 있으며 presolved, solve, cache 한도는 차감되지 않습니다.

curl -G 'https://pokerai.bet/v1/gto/postflop/cache/coverage' \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  --data-urlencode 'preflop_pack=6max_RC_100bb_200NL' \
  --data-urlencode 'board=4c8d9h' \
  --data-urlencode 'limit=200'

preflop_pack과 board는 필수입니다. 이 핸드에 해당하는 응답 항목은 아래와 같습니다. 디렉터리 응답이 포함된 원래 기록

{
  "preflop_pack": "6max_RC_100bb_200NL",
  "board": "4c8d9h",
  "pot_type": "3BET",
  "positions": {"raiser": "MP", "three_bettor": "SB", "hero": "SB"}
}

사용자가 ‘MP 오픈 · SB 3벳’을 고르면 응답에 있는 필드를 루트 노드 조회에 사용합니다. 다음 페이지에서도 팩과 플랍을 유지하고, next_cursor를 그대로 cursor에 넣습니다. items가 비어 있어도 커서가 있으면 계속 조회합니다. next_cursor: null에서 끝납니다. 일치하는 스팟이 없다면 저장된 전략이 없다는 안내를 표시하고, 사용자가 원할 때만 새로 계산을 요청합니다.

플랍 전략 불러오기

API 키를 백엔드에 보관하고 서버에서 /cache/query를 호출합니다. A♥K♥의 전략을 보려면 hole_cards: "AhKh"를 보냅니다.

Cache API 조회 순서
  1. 1. 저장된 스팟 찾기/cache/coverage디렉터리 조회 무료
  2. 2. 전략 조회 및 표시/cache/query루트와 새 카드는 각 1회, 일반 액션 조회는 무료
  3. 3. 필요한 지표 조회/cache/ev 또는 /cache/eq접수 조건을 충족한 요청당 1회
그림 2. 스팟을 찾고 전략을 표시한 뒤, 패널을 열 때 EV나 EQ를 조회합니다.

루트 노드를 열면 cache 한도가 1회 차감됩니다.

POST /v1/gto/postflop/cache/query
{
  "preflop_pack": "6max_RC_100bb_200NL",
  "board": "4c8d9h",
  "pot_type": "3BET",
  "positions": {"hero": "SB", "raiser": "MP", "three_bettor": "SB"},
  "hole_cards": "AhKh"
}

응답의 strategy를 액션 빈도로 표시하고 token을 보관합니다. 응답의 node: "root"는 화면의 경로 이름으로 쓸 수 있습니다. 다음 요청에서 node에 해당 노드의 토큰을 넘깁니다. 전체 레인지의 전략 행렬을 이미 받았다면, 다른 핸드를 선택할 때 해당 행을 바로 보여줄 수 있습니다. 액션 노드나 보드가 바뀌면 다시 조회합니다.

액션을 따라 턴과 리버로 이동하기

SB가 A♥K♥로 플랍에서 13 BB를 베팅하는 빈도는 약 **69.02%**입니다. MP가 콜하고 A♠가 나오면 14 BB 베팅 빈도는 **77.65%**입니다. MP가 다시 콜하고 7♦가 나오면 SB의 체크 빈도가 **88.63%**로 가장 높습니다. 예시에서는 22 BB 베팅(10.20%)과 콜을 따라갑니다.

A♥K♥의 액션 빈도
플랍 4♣ 8♦ 9♥
  • 체크 23.53%
  • 베팅 6 BB 7.45%
  • 베팅 13 BB 69.02%
  • 올인 0.00%
턴 A♠
  • 체크 1.96%
  • 베팅 14 BB 77.65%
  • 베팅 31 BB 20.39%
  • 올인 0.00%
리버 7♦
  • 체크 88.63%
  • 베팅 22 BB 10.20%
  • 올인 1.18%
그림 3. 각 빈도는 앞서 설명한 액션 경로를 기준으로 정규화하고 반올림한 값입니다. 원래 값은 실측 기록을 참고하세요.

베팅이나 콜을 선택할 때는 해당 하위 노드의 토큰을 node로 보냅니다. chance 노드에 도착하면 그 토큰과 turn_card 또는 river_card를 보냅니다. 예시의 query는 /cache/query를 호출하는 함수입니다. 인증과 오류 처리를 포함한 Node.js 예제

const opponent = await query("flop-bet", {
  node: cachedAction(flop, "bet", 13),
});
const chance = await query("flop-call", {
  node: cachedAction(opponent, "call"),
});
const turn = await query("turn-deal", {
  node: chance.token,
  turn_card: "As",
  hole_cards: "AhKh",
});

유효한 토큰으로 베팅과 콜 이후 노드를 읽는 데는 한도가 차감되지 않습니다. 새 턴 카드나 리버 카드를 선택할 때마다 cache 한도가 1회 차감됩니다. 액션 경로를 보관하면 이미 본 노드로 돌아갈 수 있습니다.

EV와 에퀴티는 필요할 때 조회하기

/cache/ev로 액션의 기댓값을, /cache/eq로 핸드의 에퀴티를 조회합니다. 두 엔드포인트에 현재 action 노드 토큰과 특정 핸드를 전달합니다. 팩, 보드, 레인지는 토큰으로 결정됩니다.

const hand = { node: flop.token, hole_cards: "AhKh" };

const ev = await http("flop-ev", "/v1/gto/postflop/cache/ev", hand);
const actionValues = ev.ev.status === "ok" ? ev.ev.action_values : null;

const eq = await http("flop-eq", "/v1/gto/postflop/cache/eq", hand);
const equityPercent = eq.eq.status === "ok" ? eq.eq.value * 100 : null;

/cache/query는 전략을 반환합니다. 기존 include_ev:true와 include_eq:true는 HTTP 400을 반환하며 한도 차감이나 계산이 시작되지 않습니다. 이 필드를 생략하거나 기존 클라이언트에서 false로 유지하세요.

EV는 저장된 전략을 따랐을 때의 순기댓값으로, 단위는 BB입니다. EQ는 현재 보드와 저장된 플랍 루트의 상대 레인지를 사용합니다. 해당 레인지는 액션을 따라가도 바뀌지 않습니다.

노드와 이전 액션 A♥K♥ EV EQ
플랍 4♣8♦9♥ (앞선 측정) −6.4512 BB 44.5677%
턴 A♠ (13 BB 베팅과 콜) 18.8904 BB 83.2143%
리버 7♦ (이어서 14 BB 베팅과 콜) 5.3115 BB 73.4660% (재검증)

같은 노드에서 액션별 EV를 비교하려면 응답의 action_values를 사용합니다. 측정한 지표 응답

응답 시간과 차감 기준

같은 플랍 측정에서 전략은 4.425초, EV는 14.184초, EQ는 8.566초가 걸렸습니다. 리버 재검증에서는 카드 선택 후 전략이 1.319초, 별도 EQ 조회가 6.827초였습니다. 전략 빈도를 먼저 표시하고 사용자가 패널을 열 때 해당 지표를 조회하면, 전략을 보는 데 EV와 EQ를 기다릴 필요가 없습니다.

스트리트별 응답 시간 200NL 베팅 라인 · 공통 눈금(초)
요청소요 시간회차
플랍4♣ 8♦ 9♥
전략 · 루트4.425초A
EV14.184초A
EQ8.566초A
턴A♠
전략 · 새 카드1.348초B
EV6.983초B
EQ6.482초B
리버7♦
전략 · 새 카드1.319초C
EV6.519초B
EQ6.827초C
같은 문자는 같은 측정 회차 · 11월 18일 홍콩 시간 A 플랍 루트, 13:37–13:38 B 베팅 라인, 17:44–17:45 C 리버 EQ 재검증, 20:52
그림 4. 공개 HTTPS 요청을 보낸 시점부터 응답 읽기를 마칠 때까지입니다. 리버 EV와 EQ는 다른 회차에서 측정했습니다. 실측 기록 보기。

각 막대는 공개 HTTPS 요청 1건이 성공한 결과이며 응답을 끝까지 읽는 시점까지 측정했습니다. 소요 시간은 노드와 서비스 상태에 따라 달라집니다.

API 작업 cache 한도 차감
/cache/coverage로 디렉터리 검색 0회
/cache/query로 새 루트 노드 열기 1회
유효한 토큰으로 일반 액션 노드 계속 조회 0회
/cache/query로 새 턴 카드 또는 리버 카드 선택 요청당 1회
접수 조건을 충족한 독립 EV 또는 EQ 조회 요청당 1회

세 스트리트의 전략을 모두 읽으면 3회 차감됩니다. 각 스트리트에서 EV와 EQ까지 조회하면 총 9회입니다. 리버 재검증은 EQ만 한 번 조회해 총 4회였습니다. 직전 턴 콜 조회는 1.317초가 걸렸고 차감은 없었습니다.

잘못된 입력, 만료된 토큰 등 접수 전에 거절된 요청은 차감되지 않습니다. 차감 뒤 오류가 발생할 수도 있으므로 cache_quota가 있으면 먼저 확인하고 자동 재시도는 피하세요. 다시 보내면 새 요청으로 처리됩니다.

전체 예제 실행하기

포지션, 핸드, 보드, 액션 경로를 함께 저장하세요. EV와 EQ는 각각 로딩과 오류 상태를 관리하면 지표를 읽지 못해도 전략은 계속 표시할 수 있습니다.

Node.js 예제 다운로드. 스팟을 찾고 세 번의 베팅과 콜을 따라 쇼다운까지 간 뒤 각 스트리트의 EV와 EQ를 읽습니다. 디렉터리 한 페이지에서 찾고 모두 성공하면 16건을 요청하며 총 9회가 차감됩니다.

실제 서비스에서 실행하려면 Builder 또는 Pro API 키가 필요하며 해당 계정의 한도가 차감됩니다. 오류가 나면 실행을 멈추고 앞서 출력한 결과는 남깁니다.

export POKERAI_API_KEY='YOUR_SERVER_API_KEY'
node reproduce.mjs

운영 환경 실측 자료와 인용 방법

2026년 11월 18일의 데이터입니다. 최초 측정에서는 13건이 성공했고 리버 EQ 1건에서 HTTP 503이 발생했습니다. 같은 라인에서 새 토큰으로 재검증한 요청 8건은 모두 성공했습니다. 플랍 루트, 새 카드 두 장, 리버 EQ가 각각 1회씩 차감됐습니다.

수치를 인용할 때는 팩, 보드, 액션 경로, 날짜, 측정 방법을 함께 표기해 주세요. 수치는 개별 요청에서 관측한 값입니다. 이 흐름은 훈련과 연구, 플레이가 끝난 뒤 핸드를 복기하는 데 사용하세요. 실제 돈을 거는 테이블에서 실시간 보조 도구를 사용하는 것은 금지됩니다.

API 문서 · API 레퍼런스 · OpenAPI · llms.txt

캐시에 스팟이 없거나 Free 또는 Starter를 쓰고 있거나 이후 스트리트의 레인지와 사이즈를 바꾸고 싶다면, 미리 계산된 플랍 전략을 먼저 보여주고 나머지는 필요할 때 풉니다.

사전 계산 데이터와 실시간 솔버로 만드는 저지연 포커 분석. 후속 가이드는 같은 200NL 3벳 핸드로 양쪽 레인지를 넘기고 턴과 리버 전략을 표시하는 과정을 소개합니다.