Odds API

Polymarket Odds API

An odds API for Polymarket is a price API read in odds units: the /prices, /books, and /metrics endpoints already serve what odds are made of, and converting is arithmetic. This page covers the endpoints, the conversion, and the honest odds contract.

Figures measured as of 2026-09-24 on the published PolyOrderbooks archive.

Endpoints

The endpoints that serve odds

Convert

From probability to odds

Decimal odds = 1 / price; American odds = (price / (1 - price)) * 100 for a favorite-positive or the negative convention of the closing line. The conversion is exact arithmetic, and the honest odds value is the executable side, not the mid.

The venue's own free surface (live odds) is the same data in probability form; an "odds API" is a relabeling of the price contract, which is why this page maps every endpoint back to the price and book ground truth.

Honest

The honest framing

Odds conversion changes the unit, not the meaning: a 0.99 bunching executable price is +9900-style odds that no one trades at — the honest odds feed pairs a price with its depth so the number is never mistaken for a level at which you could fill.

Probability

Odds as probability

Polymarket's native unit is probability, and an odds feed is a relabeling of the same price contract: decimal odds are 1 divided by price, American odds are the closing-line convention of the executable side. The conversion is exact arithmetic; the honest odds value is the executable price, not the mid, because the mid can be imaginary on one-sided frames.

The endpoints on this page therefore map every odds surface back to the price and book ground truth, so a study can always recover the probability beneath the label.

FAQ

Is there an odds API for Polymarket?

Yes — the /prices, /books, and /metrics endpoints serve odds-forming data; conversion to decimal/American is arithmetic.

Which price should I convert?

The executable side of the recorded book, never a mid that smooths one-sided frames.

Where is the honest ground truth?

The 250ms recorded grid: prices, books, and metrics all derive from the same frames.