---
title: "Recent odds drops (queryable buffer)"
method: GET
path: "/api/drops"
---

# Recent odds drops (queryable buffer)

`GET /api/drops`

## Request

- Base URL: `https://pinnodds.com`
- URL: `https://pinnodds.com/api/drops`
- Auth: API key in header `x-api-key`

Pull-style access to recent dropping odds. ALWAYS send max_age_sec — omitting it returns zero rows. For push delivery use the SSE streams (see /docs).

## Query parameters

- `mode` 'live' | 'prematch'
- `max_age_sec` integer, required
- `min_drop_pct` number
- `sport_id` integer
- `limit` integer

## Response `200`

{ total, drops[], meta } — rows carry market, designation, from/to, drop_pct

- object

## Other responses

- `401`: Missing or invalid API key
- `429`: Plan rate limit hit; retry_after_ms in the body

---

[API](https://skmtc.dev/pinnodds/apis/pinnodds-pinnacle-odds-api.md) · [All operations](https://skmtc.dev/pinnodds/apis/pinnodds-pinnacle-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinnodds/apis/pinnodds-pinnacle-odds-api/revisions/090bad848c9b?raw)