Skip to main content
GET
Bid-ask spread
Returns the bid-ask spread for a token or market, calculated as the difference between the best ask and best bid.

Identifier types

The {token_id} parameter accepts three types:

By token ID

By condition ID

Calculation

For one-sided books (only bids or only asks), the spread equals the best price on the existing side.

Notes

  • The spread value is a decimal string (e.g. "0.01").
  • Returns a 404 if no book exists for the identifier.

Authorizations

x-api-key
string
header
required

Path Parameters

token_id
string
required

Token ID (all digits), condition ID (starts with 0x), or event slug. Token ID returns a single book; condition ID and slug return all outcomes.

Response

Bid-ask spread

Bid-ask spread. The spread field matches Polymarket's CLOB /spread response. Additional fields are PolyNode enrichment.

spread
string
required

Bid-ask spread as decimal string, calculated as best_ask - best_bid

token_id
string

Token ID (PolyNode enrichment)

question
string

Market question (PolyNode enrichment)

slug
string

Event slug (PolyNode enrichment)