---
title: "Best prices comparison"
method: GET
path: "/v1/arb/best-prices"
tags: ["Arb & Value"]
---

# Best prices comparison

`GET /v1/arb/best-prices`

## Request

- Base URL: `https://api.puntersedge.online`
- URL: `https://api.puntersedge.online/v1/arb/best-prices`
- Auth: API key in header `X-API-Key`

Cost: 2 credits. Returns the best available price per selection plus full bookmaker comparison, worst price, average price, spread and overlay percentage. Every all_prices entry carries updated_at / age_seconds (when we last read that bookmaker), price_changed_at / unchanged_seconds (when its price last changed) and stale_suspect: true when a price has not moved for an hour while two or more other books moved away from it, in which case it is listed but never the best price.

## Query parameters

- `maxAgeMinutes` integer: Exclude bookmaker markets older than this many minutes. Same bound and default as /v1/sports/{sport_key}/odds, so an arb can never be built on a price that endpoint refuses to show.
- `sport_key` string

## Headers

- `X-API-Key` string
- `X-RapidAPI-Proxy-Secret` string

## Response `200`

Successful Response

- BestPricesOut[]
  - `id` string, required
  - `sport_key` string, required
  - `home_team` string, nullable, required
  - `away_team` string, nullable, required
  - `commence_time` string, required
  - `selections` object[], required

## Other responses

- `401`: Missing or invalid API key. Send `X-API-Key`. See https://puntersedge.online/developers/errors
- `402`: Monthly credit allowance exhausted for this plan. Upgrade at https://puntersedge.online/api/pricing
- `422`: Validation Error
- `429`: Rate limit exceeded for this plan. Honour the `Retry-After` header (seconds) before retrying. See https://puntersedge.online/developers/rate-limits
- `500`: Unexpected server error. Safe to retry with backoff.

---

[API](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api.md) · [All operations](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/revisions/f35b6aab1946?raw)