Early access · PLO4 and PLO5

Table image in.
Solver strategy out.

Rangefinder is an API that reads a poker table from a screenshot (cards, board, stacks, pot, action) and returns the solver's play with frequencies and EV. One HTTP call, structured JSON back.

100 free requests with your key. No payment details.

POST /v1/solve

image table.png · 1280 × 800

200 OK

Sample request and response for illustration. The numbers are not from a live solve.

Two face-down playing cards on dark felt crossed by a thin line of green light

How it works

Three steps, one request.

  1. Send the image

    POST a PNG, JPEG or WebP of the table. A full-table screenshot is enough. No hand history, no parser, no plugin on the player's machine.

  2. We read the table

    Rangefinder finds Hero's cards, the board, positions, stacks, pot and bets, and sends back exactly what it read.

  3. You get the solve

    Every available action with its frequency and EV, from a pre-solved library when the spot is covered and from a live solve when it is not.

The response

You always see what we saw.

A wrong card read gives a confident wrong answer. So every response carries the read next to the solution, and says how close the solved spot is to the real one.

read
The parsed table: game, street, cards, board, positions, stacks, pot and the action line. Compare it with the image before you trust the answer.
read.confidence
A score for the read, from 0 to 1. Set your own threshold and skip anything below it.
solution.match
exact when the tree, stacks and board are the same. approximate when we mapped to the nearest solved spot, with a note on what changed.
error
An image we cannot read returns an error with a reason. It never returns a guess.
200 OKapplication/json
{
  "id": "slv_7f3k2m9q",
  "read": {
    "game": "plo5",
    "street": "turn",
    "hero": {
      "position": "BTN",
      "cards": ["Ah", "Kd", "Qh", "Tc", "7s"],
      "stack_bb": 102.25
    },
    "board": ["Js", "9h", "4d", "2h"],
    "pot_bb": 21,
    "to_call_bb": 0,
    "players": 6,
    "in_hand": 2,
    "line": { "preflop": "F-F-R-C-F-F", "flop": "B-C", "turn": "X" },
    "confidence": 0.97
  },
  "solution": {
    "match": "approximate",
    "note": "Solved at 100 bb stacks. This hand started at 112 bb.",
    "source": "library",
    "actions": [
      { "action": "check", "frequency": 0.46, "ev_bb": 11.86 },
      { "action": "bet", "size_pct_pot": 50, "frequency": 0.17, "ev_bb": 11.88 },
      { "action": "bet", "size_pct_pot": 100, "frequency": 0.37, "ev_bb": 11.89 }
    ]
  },
  "timing_ms": { "read": 210, "solve": 38, "total": 262 }
}
curl https://api.rangefinderapi.com/v1/solve \
  -H "Authorization: Bearer $RANGEFINDER_KEY" \
  -F image=@table.png

Integration

One endpoint. No table logic on your side.

Reading a table and tracking a hand is most of the work in any solver product. Rangefinder does both, so you ship the part your users see.

  • Image or state. Send a screenshot, or skip the vision step and post the spot as JSON to /v1/solve/state.
  • Frame sequences. Send frames from the same hand with one hand_id and the action line is tracked for you.
  • A cap on waiting. max_wait_ms limits how long a live solve may take before you get the best answer available.
See the full reference

Built for

Products that teach, review and explain poker.

Training apps

Turn any screenshot into a drill. Show the solver line next to the one the player chose.

Hand review tools

Let users drop in screenshots from a session and get an answer for each decision, without importing hand histories.

Coaching platforms

Annotate a student's hands in seconds and share each spot with frequencies and EV attached.

Streams and broadcasts

Feed delayed broadcast frames to the API and put solver frequencies in the overlay or the commentary notes.

Research and analytics

Batch-process frames into structured spots and build your own datasets and reports.

Something else?

Tell us what you are building in the access form. It decides what we ship next.

Request access

Coverage

What it reads and solves in early access.

Games

PLO4PLO5 cash games.

Hold'emPLO6Tournaments are not built yet. Vote for them in the access form.

Tables

Heads-up to 6-max.

Streets

Preflop, flop, turn and river.

Lines

Common lines are answered from the exact tree. Rarer lines and unusual stack depths are mapped to the nearest solved spot and marked approximate.

Speed

Target: under one second end to end for spots in the library. A live solve takes a few seconds and is capped by max_wait_ms.

Table layouts

A starter set of common online layouts. Tell us which ones you need when you request access.

Pricing

Pay per request.

Start with 100 free requests. After that, buy a pack and use it when you need it. No subscription, no seats.

Free trial

Try every endpoint on your own tables.

$0

  • 100 requests
  • Free with your key
  • No payment details
  • Image and state endpoints
  • PLO4 and PLO5, every street
Get early access

Starter

Top up after the trial and keep testing.

$15

  • 100 requests
  • $0.15 per request
  • One-time purchase, no subscription
  • Everything in the trial
  • Live solves for spots outside the library
Request access

Scale

For volume and batch work.

$699

  • 10,000 requests
  • About $0.07 per request
  • One-time purchase, no subscription
  • Everything in Builder
  • 53% less per request than Starter
Request access

Early-access pricing, which may change before general availability. Need more than 10,000 requests? Tell us in the access form. Details on the pricing page.

Questions

Before you ask.

Is the API live?

Rangefinder is in private early access. We onboard developers in small groups and send keys in batches. Request access and tell us what you are building.

Which table layouts can it read?

Early access starts with a set of common online layouts and grows on request. Screenshots work best when the whole table is visible, the image is at least 900 pixels wide, and nothing covers the cards.

What happens when the read is wrong?

Every response includes the parsed table and a confidence score, so you can check the read against the image or drop low-confidence answers. An image that cannot be read returns an error, not a guess.

Where do the solutions come from?

A library of pre-solved spots answers most requests. When a spot is not in the library we solve it live, and the response says which of the two you got.

Can I skip the image and send the spot myself?

Yes. /v1/solve/state takes the cards, board, stacks and action line as JSON and returns the same solution object.

Can it be used during a real-money game?

Rangefinder is built for study, review, training and broadcast tools. Most poker operators prohibit real-time assistance during play, and you are responsible for following the rules of any platform you or your users play on. We may revoke keys that are used to break them. See acceptable use.

Early access

Get a key in the next batch.

We are onboarding developers in small groups. Tell us what you are building and how much you expect to call the API. It decides who we onboard first and what we build next.

  • 100 free requests with your key
  • No payment details now
  • One email when your key is ready

Questions? Reach out to @we_will_give_a_username on Telegram.

Games you need

We use your email only to contact you about access.