# Futbin — 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.

> Search and retrieve FIFA Ultimate Team player data including market prices, detailed statistics, and performance metrics. Analyze market trends and compare player values across the full EA FC player catalog.

**Category:** Sports | **Website:** [futbin.com/](https://futbin.com/) | **Docs:** [parse.bot/marketplace/1b6234f9-0dfb-4cca-99b4-2d6d37aec6a7/futbin-com-api](https://parse.bot/marketplace/1b6234f9-0dfb-4cca-99b4-2d6d37aec6a7/futbin-com-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-futbin-com-api-1b6234f9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_evos

Retrieves all current and recently available player evolutions from Futbin. Returns evolution name, status, description, unlock/expiry timing, cost, repeatability, eligibility requirements (max OVR, eligible positions, other requirements), stat boosts granted, and card image URL. Returns up to 220 evolutions ordered by recency.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_evos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_market_trends

Retrieves current market trend data from Futbin including console and PC market index time-series and top mover players. Market indices show recent price index values as timestamp-value pairs. Top movers list players with significant price changes (may be empty during low-activity periods).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_market_trends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_objectives

Retrieves current live objectives from Futbin including objective name, description, reward details, expiry time, and task count. Returns objectives ordered by latest/current first. Shows up to 20 objectives per page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_objectives \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_player_details

Retrieves detailed statistics, current market prices, playstyles, skill moves, and weak foot for a specific player by their Futbin player ID. Includes all in-game stats broken down by category, playstyles grouped into plus (gold), basic (white), and locked categories with name, category, and logo URL, and platform-specific market prices when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Futbin player ID (e.g. '25561' for Rodri). Obtainable from search_players results[*].id or get_players players[*].id. |
| `slug` | string | No | Player URL slug. If not provided, defaults to 'player'. |
| `year` | string | No | Game year identifier (e.g. '26' for EA FC 26). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_player_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>","slug":"<string>","year":"<string>"}'
```

### get_players

Retrieves a paginated list of players from Futbin with ratings, positions, market prices, skill moves, weak foot, and core stats. Approximately 30 players per page. Supports filters for minimum pace, league, version/promo, minimum overall rating, optional GK stat filters (diving, handling, kicking, reflexes, positioning), and an FC 26 filter. When any GK stat filter is set, only goalkeepers meeting the threshold are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fc26_only` | boolean | No | When true, only players from the EA FC 26 catalog are returned; results from prior game years are excluded. |
| `league_id` | string | No | Futbin league identifier to filter players by league (e.g. '13' for Premier League, '53' for LaLiga, '31' for Serie A, '19' for Bundesliga, '16' for Ligue 1, '350' for Saudi Pro League). When omitted, returns players from all leagues. |
| `min_gk_diving` | integer | No | Minimum GK Diving stat filter. Only goalkeepers with DIV >= this value are returned. When any GK stat filter is set, non-GK players are excluded. |
| `min_gk_handling` | integer | No | Minimum GK Handling stat filter. Only goalkeepers with HAN >= this value are returned. When any GK stat filter is set, non-GK players are excluded. |
| `min_gk_kicking` | integer | No | Minimum GK Kicking stat filter. Only goalkeepers with KIC >= this value are returned. When any GK stat filter is set, non-GK players are excluded. |
| `min_gk_positioning` | integer | No | Minimum GK Positioning stat filter. Only goalkeepers with POS >= this value are returned. When any GK stat filter is set, non-GK players are excluded. |
| `min_gk_reflexes` | integer | No | Minimum GK Reflexes stat filter. Only goalkeepers with REF >= this value are returned. When any GK stat filter is set, non-GK players are excluded. |
| `min_pace` | integer | No | Minimum pace filter. Only players with PAC stat >= this value are returned. |
| `min_rating` | integer | No | Minimum overall rating filter. Only players with OVR >= this value are returned. |
| `page` | integer | No | Page number for pagination. |
| `version` | string | No | Card version/promo filter (e.g. 'TOTY', 'Path to Glory', 'Summer Stars', 'TOTS', 'Futties'). When provided, only players of that version are returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fc26_only":"<boolean>","league_id":"<string>","min_gk_diving":"<integer>","min_gk_handling":"<integer>","min_gk_kicking":"<integer>","min_gk_positioning":"<integer>","min_gk_reflexes":"<integer>","min_pace":"<integer>","min_rating":"<integer>","page":"<integer>","version":"<string>"}'
```

### get_players_by_league

Retrieves a paginated list of players belonging to a specific league from Futbin. Returns approximately 30 players per page with their ratings, positions, headshot images, club, nation, skill moves, weak foot, and card design image URLs. Supports optional version/promo filter and minimum rating filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_id` | string | Yes | Futbin league identifier (e.g. '13' for Premier League, '53' for LaLiga, '31' for Serie A, '19' for Bundesliga, '16' for Ligue 1, '350' for Saudi Pro League). |
| `min_rating` | integer | No | Minimum overall rating filter. Only players with OVR >= this value are returned. |
| `page` | integer | No | Page number for pagination. |
| `version` | string | No | Card version/promo filter (e.g. 'TOTY', 'Path to Glory', 'Summer Stars', 'TOTS', 'Futties'). When provided, only players of that version are returned. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_players_by_league \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_id":"<string>","min_rating":"<integer>","page":"<integer>","version":"<string>"}'
```

### get_sbcs

Retrieves current Squad Building Challenges (SBCs) from Futbin ordered latest first. Returns SBC name, description, expiry time, required squad count, reward card info (name, rating, image) for player rewards, and a URL to the SBC page. The site shows up to 12 SBCs at a time; use page parameter to paginate through them.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `active_only` | boolean | No | When true (default), returns only currently active/non-expired SBCs. |
| `page` | integer | No | Page number for pagination (12 SBCs per page). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/get_sbcs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active_only":"<boolean>","page":"<integer>"}'
```

### search_players

Searches for players by name using Futbin's internal search API. Returns matching player cards across all versions with ratings, positions, card versions, image URLs, and the card design image URL. Useful for finding a specific player's ID before fetching full details. When fc26_only is true, uses HTML-based search to return only EA FC 26 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fc26_only` | boolean | No | When true, only players from the EA FC 26 catalog are returned; results from prior game years are excluded. |
| `query` | string | Yes | Player name or partial name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/search_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fc26_only":"<boolean>","query":"<string>"}'
```

### search_players_fc26

Searches for players by name exclusively within the EA FC 26 catalog. Returns only FC 26 player cards with their current market prices, ratings, positions, card versions, skill moves, weak foot, and image URLs. Results are ordered by rating descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Player name or partial name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-futbin-com-api-1b6234f9/search_players_fc26 \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```