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

# Betting API with Settlement — Auto-Resolve Bets

> Find a betting API with built-in settlement. FieldFunded auto-resolves bets across 30+ sports with market_id matching and void handling.

# Betting API with Automatic Settlement

FieldFunded is the only sports odds API that includes automatic bet settlement on every plan, including free. Send your bet details, get back won/lost/refund — no manual result checking, no scraping scoreboards.

## What Settlement Means for Your Product

Without settlement, your workflow looks like this:

```
Game ends → You scrape scores → You match scores to markets → You guess the resolution logic → You pray you got it right → You pay out
```

With FieldFunded's settlement API:

```
Game ends → Call checkBet() → Get won/lost/refund → Pay out
```

The API handles score matching, market resolution rules, void conditions, and edge cases (postponed, cancelled, walkover, abandoned) for you.

## Settlement Endpoints

| Endpoint | Purpose | When to use |
| - | - | - |
| `POST /v1/bets/check` | Resolve a single bet | Standard singles |
| `POST /v1/bets/check-parlay` | Resolve a parlay/accumulator | Multi-leg bets |
| `GET /v1/settlements` | Poll for resolved markets | Batch processing |
| `GET /v1/events/{id}/result` | Get final score and status | Custom resolution logic |

## How It Works

```typescript theme={null}
import { FieldFundedSDK } from '@fieldfunded/sdk';

const ff = new FieldFundedSDK({
  apiKey: process.env.FIELDFUNDED_API_KEY!,
  baseUrl: 'https://api.fieldfunded.com/v1',
});

// Check if "Arsenal to win" settled
const result = await ff.checkBet({
  event_id: 'evt_123',
  market: 'Winner',
  selection: 'Arsenal',
  stake: 50,
  odds: 1.75,
  market_id: 'mkt_456',       // Optional but recommended
  selection_id: 'sel_789',     // Guarantees exact match
});

console.log(result.status);  // "won" | "lost" | "refund" | "pending"
console.log(result.payout);  // 87.50 if won
```

## Who Has Settlement?

| Provider | Settlement | Sports | Void handling | Parlay support |
| - | - | - | - | - |
| FieldFunded | Yes (all plans) | 30+ | Automatic | Yes |
| The Odds API | No | 14 | N/A | N/A |
| Sportradar | Manual (scores only) | 40+ | Manual | N/A |
| BetRadar | Enterprise only | 30+ | Manual | Manual |

FieldFunded is the only provider where settlement is available on the free tier. Sportradar provides scores and results, but you must build the resolution logic yourself.

## Edge Case Handling

The settlement API handles every edge case automatically:

* **Postponed games**: 48-hour rule. If the game resumes within 48 hours, bets stay active. After 48 hours, all markets refund.
* **Cancelled / Walkover**: Immediate refund on all markets.
* **Void legs in parlays**: Void leg odds set to 1.0, combined odds recalculated, payout adjusted.
* **Partial settlement**: Complex markets (player props, correct score) may resolve 10-30 minutes after simple markets (1x2, Winner). The API returns "pending" for unresolved markets.

## Rate Limit Math for Settlement

Settlement polling is lightweight. A typical settlement loop:

| Action | Frequency | Requests/day |
| - | - | - |
| Poll `getSettlements()` | Every 60s | 1,440 |
| Call `checkBet()` per pending bet | \~50 bets/day | 50 |
| Call `getEventResult()` for edge cases | \~5/day | 5 |
| **Total** | | **\~1,500/day** |

The free tier (10,000 req/month) can handle settlement for \~6 days of moderate volume. For production, the [Starter plan](https://docs.fieldfunded.com/compare/pricing.md) at \$29/month handles settlement comfortably alongside live odds polling.

***

## Related Pages

* [Build a Settlement Engine](https://docs.fieldfunded.com/guides/build-settlement-engine.md) — full implementation guide with code
* [Affordable Odds API](https://docs.fieldfunded.com/compare/affordable-odds-api.md) — pricing for all tiers
* [FieldFunded vs Sportradar](https://docs.fieldfunded.com/compare/vs-sportradar.md) — settlement is where we win
* [Settlement API Reference](https://docs.fieldfunded.com/api-reference/settlement/get-settlements.md) — endpoint documentation

> [card] [Get Your Free API Key](https://docs.fieldfunded.com/quickstart.md)
>
> Start building in 5 minutes — settlement included on free tier

> [card] [Settlement Engine Guide](https://docs.fieldfunded.com/guides/build-settlement-engine.md)
>
> Build a production-ready settlement loop


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.