> ## 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](/compare/pricing) at \$29/month handles settlement comfortably alongside live odds polling.

***

## Related Pages

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

<CardGroup cols={2}>
  <Card title="Get Your Free API Key" icon="key" href="/quickstart">
    Start building in 5 minutes — settlement included on free tier
  </Card>

  <Card title="Settlement Engine Guide" icon="gears" href="/guides/build-settlement-engine">
    Build a production-ready settlement loop
  </Card>
</CardGroup>