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"