# Sleeper Fantasy Football State and Trending API

> Sleeper fantasy sports: current NFL week and season, and the players most added or dropped

- Vendor: `sleeperfantasyfootballstateand` · version 1.0 · category Sports · tags sleeper api, fantasy football api, nfl week api, trending players api, waiver wire api, nfl fantasy api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/sleeperfantasyfootballstateand
- This document: https://apiclay.com/docs/sleeperfantasyfootballstateand.md
- OpenAPI 3.1: https://apiclay.com/api/sleeperfantasyfootballstateand/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `sleeperfantasyfootballstateand`
- Updated: 2026-11-18

## About

## Sleeper Fantasy Football State and Trending API

The public read-only API of Sleeper, the fantasy sports app: the current state of the NFL season (week, season type, season and league-creation season, start date) and the players most added or dropped on waivers across Sleeper leagues over the last hours, with counts.

Data comes from **sleeper.com** (https://sleeper.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/state?sport=nfl`, then `/trending?sport=nfl&amp;type=add&amp;lookback_hours=24&amp;limit=25`.

### Routes

#### GET `/state` - Sport state
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| sport | path | string | yes | `nfl`. |

Returns: `week`, `display_week`, `season`, `season_type`, `league_season`, `previous_season`, `season_start_date`, `league_create_season`, `season_has_scores`.

#### GET `/trending` - Trending players
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| sport | path | string | yes | `nfl`. |
| type | path | string | yes | `add` or `drop`. |
| lookback_hours | query | number | no | Hours to look back (default 24). |
| limit | query | number | no | Players to return (default 25). |

Returns: Array: `player_id` (Sleeper player id) and `count` (adds or drops in the window).

### Caveats

- Player ids are Sleeper's own; the full player list (about 5 MB) is too large to serve here.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by sleeper.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /state — Sport state
- Gateway: `GET https://api.apiclay.com/v1/api/sleeperfantasyfootballstateand/state`
- Public query params: `sport` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /trending — Trending players
- Gateway: `GET https://api.apiclay.com/v1/api/sleeperfantasyfootballstateand/trending`
- Public query params: `lookback_hours` (number), `limit` (number), `sport` (string, required), `type` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/sleeperfantasyfootballstateand/state?sport=<sport>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
