Bid-Ask Spread

Returns the bid-ask spread for a token, calculated as the difference between the best ask and best bid price.

For one-sided books, the spread equals the best price on the existing side. Response is enriched with PolyNode market metadata.

GET /v1/spread/{token_id}

Bid-ask spread

cURL

curl --request GET \
  --url https://api.polynode.dev/v1/spread/{token_id} \
  --header 'x-api-key: <api-key>'

200

{
  "spread": "0.01",
  "token_id": "114694726451307654528948558967898493662917070661203465131156925998487819889437",
  "question": "Netanyahu out by end of 2026?",
  "slug": "netanyahu-out-before-2027-684-719-226"
}

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:

Identifier	Format	Returns
Token ID	All digits, 70+ chars	Single spread (Polymarket-compatible)
Condition ID	Starts with 0x	Spreads for both outcomes
Slug	Human-readable string	Spreads for all outcomes in the event

By token ID

curl "https://api.polynode.dev/v1/spread/114694726451307654528948558967898493662917070661203465131156925998487819889437" \
  -H "x-api-key: YOUR_KEY"

{
  "spread": "0.01",
  "token_id": "114694726451307654528948558967898493662917070661203465131156925998487819889437",
  "question": "Netanyahu out by end of 2026?",
  "slug": "netanyahu-out-before-2027-684-719-226"
}

By condition ID

curl "https://api.polynode.dev/v1/spread/0xd1796c09d0d6f876f8580086ae9808ec991784e3a74b25a1830a25de71a78c96" \
  -H "x-api-key: YOUR_KEY"

{
  "condition_id": "0xd1796c09d0d6f876f8580086ae9808ec991784e3a74b25a1830a25de71a78c96",
  "question": "Netanyahu out by end of 2026?",
  "event_title": "Netanyahu out by...?",
  "outcomes": [
    {"outcome": "Yes", "token_id": "11469472645...", "spread": "0.01"},
    {"outcome": "No", "token_id": "66255671088...", "spread": "0.01"}
  ]
}

Calculation

spread = best_ask - best_bid

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

200

application/json

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)