> ## Documentation Index
> Fetch the complete documentation index at: https://docs.graylayer.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket US

> Proxy for the Polymarket US public API — events, markets, series, sports, and search.

<Card title="Join the Graylayer Discord" icon="discord" href="https://discord.gg/UxGa5C4C2A" horizontal>
  Request an API key in **#api-key-request** under the Community tab.
</Card>

## 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

```bash theme={null}
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         |

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/events?limit=10&active=true"
```

***

### Get Event By ID

```bash theme={null}
GET /api/v1/polymarket-us/events/{id}
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/events/31"
```

***

### Get Event By Slug

```bash theme={null}
GET /api/v1/polymarket-us/events/{slug}
```

```bash theme={null}
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

```bash theme={null}
GET /api/v1/polymarket-us/partners/events/{externalId}
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/partners/events/EXTERNAL_ID"
```

***

## Markets

### Get Markets

```bash theme={null}
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     |

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets?limit=10&active=true"
```

***

### Get Market By ID

```bash theme={null}
GET /api/v1/polymarket-us/markets/{id}
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/1"
```

***

### Get Market By Slug

```bash theme={null}
GET /api/v1/polymarket-us/markets/{slug}
```

```bash theme={null}
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.

```bash theme={null}
GET /api/v1/polymarket-us/markets/{slug}/bbo
```

```bash theme={null}
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.

```bash theme={null}
GET /api/v1/polymarket-us/markets/{slug}/book
```

```bash theme={null}
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.

```bash theme={null}
GET /api/v1/polymarket-us/markets/{slug}/settlement
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/markets/will-trump-win/settlement"
```

***

## Series

### Get Series

```bash theme={null}
GET /api/v1/polymarket-us/series
```

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

***

### Get Series By ID

```bash theme={null}
GET /api/v1/polymarket-us/series/{id}
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/series/nba-2025"
```

***

## Sports

### Get Events By League Slug

```bash theme={null}
GET /api/v1/polymarket-us/sports/leagues/{slug}/events
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/leagues/nfl/events"
```

***

### Get Events By Sport Slug

```bash theme={null}
GET /api/v1/polymarket-us/sports/{slug}/events
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/basketball/events"
```

***

## Sports (Legacy)

### Get Sports

```bash theme={null}
GET /api/v1/polymarket-us/sports
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports"
```

***

### Get Sports Events

```bash theme={null}
GET /api/v1/polymarket-us/sports/{series}/events
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/nba-2025/events"
```

***

### Get Sports Teams

```bash theme={null}
GET /api/v1/polymarket-us/sports/teams
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/teams"
```

***

### Get Sports Teams For Provider

```bash theme={null}
GET /api/v1/polymarket-us/sports/teams/{provider}
```

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://gateway.graylayer.tech/api/v1/polymarket-us/sports/teams/sportradar"
```

***

## Search

### Search

Full-text search across events and markets.

```bash theme={null}
GET /api/v1/polymarket-us/search
```

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

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