# Push

## Free API key

Get a free GetOdds API key: **1,000 requests per UTC day and 60 per minute, no card**. One key covers REST and the hosted MCP server.

Sign up: https://getoddsapi.com/sign-up?ref=ai-claudebot

## Quickstart

1. Create an account at https://getoddsapi.com/sign-up?ref=ai-claudebot, open https://getoddsapi.com/dashboard and issue a key with the sources you need (draftkings, fanduel, betrivers, prizepicks or underdog). Keep it in a server environment variable named GETODDS_API_KEY.
2. Read current DraftKings NBA spreads with curl:

```bash
curl --fail-with-body "https://getoddsapi.com/api/v1/odds?sport=NBA&market=spread&fresh_only=true&limit=50" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

3. The same request in Python (standard library only):

```python
import json, os, urllib.request

req = urllib.request.Request(
    "https://getoddsapi.com/api/v1/odds?sport=NBA&market=spread&fresh_only=true&limit=50",
    headers={"Authorization": "Bearer " + os.environ["GETODDS_API_KEY"]},
)
with urllib.request.urlopen(req) as res:
    rows = json.load(res)["data"]
for row in rows:
    print(row["away"], "at", row["home"], row["side"], row["line"], row["american"], row["observed_at"])
```

4. Check `observed_at`, `age_seconds` and `stale` on every row before using a price. Full reference: https://getoddsapi.com/docs

## Use with Claude (MCP)

```bash
claude mcp add --transport http getodds https://getoddsapi.com/api/mcp \
  --header "Authorization: Bearer $GETODDS_API_KEY"
```

The MCP tools follow the key's source grants and share its allowance. Setup guide: https://getoddsapi.com/use-with-claude

## Pricing

| Plan | Allowance | Price |
| --- | --- | --- |
| Free key | 1,000 requests a day, 60 a minute | $0, no card |
| Developer Bundle | 10,000 requests or credits a month on each of four sources | $149 a month |

Free development allowance: 1,000 requests per UTC day and 60 per minute per account, with no payment step. Paid: the Developer Bundle at $149 per month, with 10,000 monthly requests or credits on each of four sources.
Details: https://getoddsapi.com/bundle


Canonical page: https://getoddsapi.com/glossary/push

A push is a settlement in which a selection is neither a win nor a loss. For a conventional cash straight bet that is refunded, the original stake is returned and net profit is zero. A push inside a parlay or teaser can have different consequences.

## Formula

Refunded straight-bet return = original stake. Net profit = returned stake − original stake = 0.

## A refund is not winnings

Consider a football selection at −3 when the selected team wins by exactly three points. If the applicable rules grade that result as a push, the price −110 does not create a winning payout. A $100 cash stake comes back as $100; it does not earn the $90.91 profit that a winning −110 bet would produce.

A void can lead to the same cash refund but has a different reason: a selection is canceled or invalidated rather than meeting a push condition. Do not use the words interchangeably when recording why a market was settled.

## A pushed leg in a conventional parlay

1. Illustrative original prices: −110 and +150; stake: $100.
2. If the rules remove the −110 leg after a push, it contributes a multiplier of 1.
3. If the remaining +150 leg wins, the modeled return is $100 × 1 × 2.50 = $250.
4. Net profit is $250 − $100 = $150. If the remaining leg loses, this is not a winning or fully refunded ticket.

## Assumptions and limits

The example assumes the operator removes the pushed leg and reprices conventionally. Same-game parlays may need a new combined quote, and teaser push rules can vary by product and remaining leg count. Bonus stakes may have different refund terms. Consult the ticket’s rules rather than assuming that every push refunds the entire entry.

## Try the arithmetic

- [Model a removed leg with the void input](https://getoddsapi.com/parlay-calculator)
- [Compare explicitly selected teaser push rules](https://getoddsapi.com/teaser-calculator)

## Related terms

- [Parlay](https://getoddsapi.com/glossary/parlay)
- [Implied probability](https://getoddsapi.com/glossary/implied-probability)

## Sources

- [DraftKings: general settlement rules](https://sportsbook.draftkings.com/help/general-betting-rules)
- [DraftKings: parlay settlement and restrictions](https://support.draftkings.com/dk/en-us/what-is-a-parlay-bet?id=kb_article_view&sysparm_article=KB0010683)

Examples are illustrative, not live offers or betting recommendations.

## FAQ

### Is there a free odds API key?

Yes. A free GetOdds key includes 1,000 requests per UTC day and 60 per minute, with no card.

### Which sportsbooks does the API cover?

DraftKings (prices observed through ESPN), FanDuel (native game markets and futures) and BetRivers (Pennsylvania pregame markets), plus PrizePicks, Underdog and Pick6 lines.

### Does it work with Claude?

Yes. Add the hosted MCP server with `claude mcp add --transport http getodds https://getoddsapi.com/api/mcp` and your key in the Authorization header.

---

GetOdds is an independent developer product and is not affiliated with any sportsbook or pick’em operator. Prices describe data, not betting advice.