Skip to main content
GET
/
v1
/
spread
/
{token_id}
Bid-ask spread
curl --request GET \
  --url https://api.polynode.dev/v1/spread/{token_id} \
  --header 'x-api-key: <api-key>'
{
  "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:
IdentifierFormatReturns
Token IDAll digits, 70+ charsSingle spread (Polymarket-compatible)
Condition IDStarts with 0xSpreads for both outcomes
SlugHuman-readable stringSpreads 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

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)