Skip to main content

Join the Graylayer Discord

Request an API key in #api-key-request under the Community tab.

​
Overview

Platform key: polymarket-us Upstream base: https://gateway.polymarket.us/v1 Auth required: No — all endpoints are public read-only. Trading: All non-GET requests are blocked. Route any supported endpoint through the proxy: 
GET /api/v1/polymarket-us/{path}
All requests require your proxy API key: 
X-API-Key: YOUR_KEY

​
Events

​
Get Events

GET /api/v1/polymarket-us/events
Query params (all optional):
ParamTypeDescription
limitintMax results
offsetintPagination offset
activeboolFilter active events
closedboolFilter closed events
archivedboolFilter archived events
featuredboolFeatured events only
slugstringFilter by slug
tagSlugstringFilter by tag slug
corystringFilter by category
seriesIdstringFilter by series
startDateMin / startDateMaxISO dateDate range
endDateMin / endDateMaxISO dateDate range
liquidityMin / liquidityMaxnumberLiquidity range
volumeMin / volumeMaxnumberVolume range
liveboolCurrently live
orderBystringSort field
orderDirectionasc | descSort direction
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/events?limit=10&active=true"

​
Get Event By ID

GET /api/v1/polymarket-us/events/{id}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/events/31"

​
Get Event By Slug

GET /api/v1/polymarket-us/events/{slug}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/events/nba-sa-chi-2025"

​
Get Event By Partner External ID

GET /api/v1/polymarket-us/partners/events/{externalId}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/partners/events/EXTERNAL_ID"

​
Markets

​
Get Markets

GET /api/v1/polymarket-us/markets
Query params (all optional):
ParamTypeDescription
limitintMax results
offsetintPagination offset
activeboolFilter active
closedboolFilter closed
categorystringFilter by category
seriesIdstringFilter by series
orderBystringSort field
orderDirectionasc | descSort direction
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets?limit=10&active=true"

​
Get Market By ID

GET /api/v1/polymarket-us/markets/{id}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/1"

​
Get Market By Slug

GET /api/v1/polymarket-us/markets/{slug}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/will-trump-win"

​
Get Market BBO

Best bid/offer and market stats for a market. 
GET /api/v1/polymarket-us/markets/{slug}/bbo

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/will-trump-win/bbo"

​
Get Market Book

Full order book and stats for a market. 
GET /api/v1/polymarket-us/markets/{slug}/book

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/will-trump-win/book"

​
Get Market Settlement

Settlement price for a resolved market. 
GET /api/v1/polymarket-us/markets/{slug}/settlement

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/will-trump-win/settlement"

​
Series

​
Get Series

GET /api/v1/polymarket-us/series

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/series?limit=10"

​
Get Series By ID

GET /api/v1/polymarket-us/series/{id}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/series/nba-2025"

​
Sports

​
Get Events By League Slug

GET /api/v1/polymarket-us/sports/leagues/{slug}/events

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/leagues/nfl/events"

​
Get Events By Sport Slug

GET /api/v1/polymarket-us/sports/{slug}/events

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/basketball/events"

​
Sports (Legacy)

​
Get Sports

GET /api/v1/polymarket-us/sports

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports"

​
Get Sports Events

GET /api/v1/polymarket-us/sports/{series}/events

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/nba-2025/events"

​
Get Sports Teams

GET /api/v1/polymarket-us/sports/teams

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/teams"

​
Get Sports Teams For Provider

GET /api/v1/polymarket-us/sports/teams/{provider}

curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/teams/sportradar"

​
Search

Full-text search across events and markets. 
GET /api/v1/polymarket-us/search
ParamTypeDescription
qstringSearch query
limitintMax results
offsetintPagination offset
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/search?q=election&limit=10"