# Flashscore (Spain) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track and compare pre-match betting odds across all sports leagues with daily match overviews showing 1X2 odds, or dive deeper into individual matches to see detailed odds from every bookmaker including opening lines and how odds have shifted. Stay ahead of betting movements with real-time data on odds changes and bookmaker-specific pricing.

**Category:** Sports | **Website:** [www.flashscore.es/](https://www.flashscore.es/) | **Docs:** [parse.bot/marketplace/9272ebd0-2151-4202-b528-c1a62c5269b0/flashscore-es-api](https://parse.bot/marketplace/9272ebd0-2151-4202-b528-c1a62c5269b0/flashscore-es-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-flashscore-es-api-9272ebd0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_daily_odds

Returns all scheduled matches for a given sport and day with their primary 1X2 (home/draw/away) odds from the featured bookmaker. Each match includes league, country, team names, start timestamp, and current/previous odds. Makes two internal requests (matches feed + odds feed) per call. Results are not paginated; one call returns all matches for the day (typically 200-900+ for football).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `day_offset` | integer | No | Day offset from today. 0 = today, 1 = tomorrow, -1 = yesterday, etc. |
| `sport` | string | No | Sport to retrieve odds for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-es-api-9272ebd0/get_daily_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"day_offset":"<integer>","sport":"<string>"}'
```

### get_match_odds

Returns detailed pre-match odds for a specific match event from a specific bookmaker. Includes current value, opening value, active status, and movement direction (UP/DOWN/NONE) for each outcome. Supports multiple bet types (1X2, over/under, both teams to score, asian handicap, double chance) and time scopes (full time, first half, second half). Returns odds=null when the bookmaker does not offer the requested market for the event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bet_scope` | string | No | Time scope for the bet. |
| `bet_type` | string | No | Type of betting market. |
| `bookmaker_id` | string | No | Numeric bookmaker identifier. Common IDs: 1133 (FanDuel), 549 (bet365), 851 (BetMGM), 1205 (DraftKings). Defaults to 1133 (FanDuel). |
| `event_id` | string | Yes | Flashscore event identifier (8-character alphanumeric). Obtainable from get_daily_odds results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-es-api-9272ebd0/get_match_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bet_scope":"<string>","bet_type":"<string>","bookmaker_id":"<string>","event_id":"<string>"}'
```