Polymarket US

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):

Param	Type	Description
`limit`	int	Max results
`offset`	int	Pagination offset
`active`	bool	Filter active events
`closed`	bool	Filter closed events
`archived`	bool	Filter archived events
`featured`	bool	Featured events only
`slug`	string	Filter by slug
`tagSlug`	string	Filter by tag slug
`cory`	string	Filter by category
`seriesId`	string	Filter by series
`startDateMin` / `startDateMax`	ISO date	Date range
`endDateMin` / `endDateMax`	ISO date	Date range
`liquidityMin` / `liquidityMax`	number	Liquidity range
`volumeMin` / `volumeMax`	number	Volume range
`live`	bool	Currently live
`orderBy`	string	Sort field
`orderDirection`	`asc` \| `desc`	Sort 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):

Param	Type	Description
`limit`	int	Max results
`offset`	int	Pagination offset
`active`	bool	Filter active
`closed`	bool	Filter closed
`category`	string	Filter by category
`seriesId`	string	Filter by series
`orderBy`	string	Sort field
`orderDirection`	`asc` \| `desc`	Sort 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

Param	Type	Description
`q`	string	Search query
`limit`	int	Max results
`offset`	int	Pagination offset

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

Getting started

Platforms

WebSockets

Join the Graylayer Discord

Overview

Events

Get Events

Get Event By ID

Get Event By Slug

Get Event By Partner External ID

Markets

Get Markets

Get Market By ID

Get Market By Slug

Get Market BBO

Get Market Book

Get Market Settlement

Series

Get Series

Get Series By ID

Sports

Get Events By League Slug

Get Events By Sport Slug

Sports (Legacy)

Get Sports

Get Sports Events

Get Sports Teams

Get Sports Teams For Provider

Search

Search

Join the Graylayer Discord

​Overview

​Events

​Get Events

​Get Event By ID

​Get Event By Slug

​Get Event By Partner External ID

​Markets

​Get Markets

​Get Market By ID

​Get Market By Slug

​Get Market BBO

​Get Market Book

​Get Market Settlement

​Series

​Get Series

​Get Series By ID

​Sports

​Get Events By League Slug

​Get Events By Sport Slug

​Sports (Legacy)

​Get Sports

​Get Sports Events

​Get Sports Teams

​Get Sports Teams For Provider

​Search

​Search

Overview

Events

Get Events

Get Event By ID

Get Event By Slug

Get Event By Partner External ID

Markets

Get Markets

Get Market By ID

Get Market By Slug

Get Market BBO

Get Market Book

Get Market Settlement

Series

Get Series

Get Series By ID

Sports

Get Events By League Slug

Get Events By Sport Slug

Sports (Legacy)

Get Sports

Get Sports Events

Get Sports Teams

Get Sports Teams For Provider

Search

Search