Skip to main content

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 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

EndpointPurposeWhen to use
POST /v1/bets/checkResolve a single betStandard singles
POST /v1/bets/check-parlayResolve a parlay/accumulatorMulti-leg bets
GET /v1/settlementsPoll for resolved marketsBatch processing
GET /v1/events/{id}/resultGet final score and statusCustom resolution logic

​
How It Works

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?

ProviderSettlementSportsVoid handlingParlay support
FieldFundedYes (all plans)30+AutomaticYes
The Odds APINo14N/AN/A
SportradarManual (scores only)40+ManualN/A
BetRadarEnterprise only30+ManualManual
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:
ActionFrequencyRequests/day
Poll getSettlements()Every 60s1,440
Call checkBet() per pending bet~50 bets/day50
Call getEventResult() for edge cases~5/day5
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 at $29/month handles settlement comfortably alongside live odds polling.

Get Your Free API Key

Start building in 5 minutes — settlement included on free tier

Settlement Engine Guide

Build a production-ready settlement loop