Count poker chips with one API call

Send a photo of stacked chips, get back the chip count, the per-stack breakdown, and the total value as structured JSON. Built for casinos, tournament organisers, and streamers.

Get an API key Read the docs

POST /api/v1/count

curl https://api.chipsstory.com/api/v1/count \
  -H "Authorization: Bearer $CHIPS_STORY_KEY" \
  -F image=@table.jpg \
  -F 'denominations=[{"value":25},{"value":100},{"value":500}]'

{
  "object": "chip_count",
  "total": 4725,
  "chip_count": 47,
  "stack_count": 3,
  "stacks": [
    { "value": 25,  "count": 20, "subtotal": 500,  "resolved_by": "ocr" },
    { "value": 100, "count": 17, "subtotal": 1700, "resolved_by": "ocr" },
    { "value": 500, "count": 5,  "subtotal": 2500, "resolved_by": "ocr" }
  ],
  "usage": { "units": 1, "quota_remaining": 249 }
}

Why the API

Computer vision for the felt, as an endpoint

🧮

Counts and values

One request returns the chip count, a per-stack and per-denomination breakdown with subtotals, and the total value on the table.

🔍

Reads the chip faces

Denominations come from the printed face of the chips first, with colour matching as a fallback — and every value tells you how it was resolved.

🚦

Honest about uncertainty

Stacks that need a human look are flagged needs_review, and if a fallback path was used the response says so in a degraded block. No silent guesses.

📐

Framing feedback

Enable strict framing and the API rejects photos it can't count reliably, so bad captures fail fast instead of returning bad numbers.

📊

Metering built in

Every response reports your remaining quota, usage is visible in the dashboard, and failed requests on our side are never counted against you.

🃏

Any chip set

You define the denominations in play — values, colours, or both — per request. No pre-registration, no fixed chip catalogue.

How it works

Photo in. Numbers out.

1

Create a key

2

POST a photo

Send the image and the denominations in play to /api/v1/count — multipart or JSON, whichever fits your stack. Try it live in the portal playground first.

3

Use the JSON

Get back the count, per-stack subtotals, the total value, and confidence signals — ready to feed a tournament clock, an overlay, or a floor report.

Playing, not building?

The Chips Story mobile app puts the same counting engine in your pocket — snap your stack at every break and track your tournament journey.

Start counting today

Free tier with 250 requests a month. Issue a key, open the playground, and make your first count in minutes.

Get an API key Read the docs