---
name: Futbin CLI
slug: futbin-cli
category: Data
description: Futbin CLI queries FUTBIN for EA FC player prices, SBCs, evolutions, and market analytics. Use it to look up cards, compare values, and decide whether to buy, sell, or hold.
github: "https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/futbin-cli"
language: Python
stars: 215
forks: 45
install: "npx degit https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/futbin-cli ~/.claude/skills/futbin-cli"
installs_to: ~/.claude/skills/futbin-cli
source_path: .claude/skills/futbin-cli/SKILL.md
collection_size: 25
category_size: 729
collection_url: "https://dirskills.com/collections/ItamarZand88/CLI-Anything-WEB"
added: 2026-09-04T05:25:47.742Z
last_synced: 2026-09-04T05:25:47.742Z
canonical_url: "https://dirskills.com/skills/futbin-cli"
---

# Futbin CLI

Futbin CLI queries FUTBIN for EA FC player prices, SBCs, evolutions, and market analytics. Use it to look up cards, compare values, and decide whether to buy, sell, or hold.

**Install:**

```bash
npx degit https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/futbin-cli ~/.claude/skills/futbin-cli
```

## README

# cli-web-futbin

EA FC Ultimate Team database and market analytics. Prices are in coins; current game year is 26 (use `--year 25` for last year's cards, or set a default via `config`).
Install: `pip install cli-web-futbin`

For trading strategy, market timing, and promo-cycle guidance, read [market-playbook.md](market-playbook.md) — weekly buy/sell cycle, EA tax formulas, promo crash calendar, fodder rules, mass bidding, and step-by-step CLI workflows.

## Commands

### players
- `players search --name TEXT` — search by name (JSON API; fast, reliable prices). Options: `--year N`, `--evolutions`
- `players list` — browse with filters. Options: `--position`, `--rating-min/--rating-max`, `--version` (gold_rare, gold_if, toty, icons, heroes, fut_birthday, moments, …), `--min-price/--max-price`, `--cheapest`, `--min-skills/--min-wf` (1–5), `--gender [men|women]`, `--league/--nation/--club ID`, `--platform [ps|pc]`, `--page N`, `--year N`
- `players get PLAYER_ID` — full detail: stats, skill moves/weak foot, trend, EA price range, current BIN listings
- `players compare ID1 ID2` — side-by-side with value metrics
- `players price-history PLAYER_ID` — price series + current/min/max per platform
- `players versions --name TEXT` — all versions of a player with `value_score` (total stats per 1K coins)

### market
- `market index [--rating 81-86|100|icons]` — tier indices, or current/open/low/high for one tier
- `market popular [--limit N]` — trending/most-viewed players (max 250)
- `market latest [--page N]` — newly released cards
- `market cheapest` — cheapest by rating, for SBCs/trading. Options: `--rating-min` (default 83), `--rating-max`, `--min-price` (default 200, excludes extinct), `--max-price`, `--platform`, `--page`
- `market movers [--fallers]` — biggest risers/fallers. Options: `--rating-min` (default 80), `--min-price` (default 1000), `--max-price`, `--platform`, `--page`
- `market fodder` — cheapest player at each rating tier 81–99. Options: `--rating-min`, `--rating-max`
- `market analyze PLAYER_ID` — trend analysis + BUY/SELL/HOLD signal, platform gap. Option: `--year`
- `market scan` — bulk undervalue detection (flags cards below 30d average; ~0.5s/player). Options: `--rating-min` (default 84), `--rating-max` (default 90), `--limit` (default 20), `--threshold` (default 10, min % below avg), `--platform`
- `market arbitrage` — PS vs PC price gaps. Options: `--rating-min` (default 85), `--rating-max` (default 92), `--min-gap` (default 5, %), `--page`

### sbc / evolutions / config
- `sbc list [--category TEXT] [--year N]`, `sbc get SBC_ID` — Squad Building Challenges (requirements, rewards, cost)
- `evolutions list [--category ID] [--expiring] [--year N]`, `evolutions get EVOLUTION_ID` — evolution paths (`--category` is a numeric ID)
- `config set|get|show|reset` — persistent defaults, e.g. `config set year 26`, `config set platform ps`

## Examples

```bash
# Current price for a player — search returns [{id, name, rating, version, ps_price, ...}]
cli-web-futbin players search --name "Mbappe" --json

# Cheapest gold rare CAMs rated 85+
cli-web-futbin players list --position CAM --version gold_rare --rating-min 85 --cheapest --json

# Is this a good time to buy player 40? (signal: BUY/SELL/HOLD)
cli-web-futbin market analyze 40 --json

# Find cards trading >10% below their 30-day average
cli-web-futbin market scan --rating-min 85 --rating-max 89 --threshold 10 --json

# SBC fodder cost check + active SBCs
cli-web-futbin market fodder --rating-min 84 --json
cli-web-futbin sbc list --json
```

## JSON output

Add `--json` to any command for structured output (bare arrays/objects per command; key fields shown above). Errors: `{"error": true, "code": "...", "message": "..."}`. `market analyze` returns per-platform `current`, `min`, `max`, `avg_30d`, `price_position_pct` (0=floor, 100=ceiling), `vs_avg_30d_pct` (negative = below average), `trend_7d`, `trend_30d`, `volatility_30d`, `signal`, plus `platform_gap_pct`.

## Utilities

`cli-web-futbin doctor [--json]` diagnoses local setup. `cli-web-futbin mcp-serve` exposes the commands as MCP tools over stdio. Running with no subcommand opens an interactive REPL.

## Agent tips

- Get player IDs from `players search`; use `players get` for full stats (search returns empty `stats`).
- `players search` (JSON API) is more reliable than `players list` (HTML scrape) for name/rating/price.
- Requests are rate-limited at 0.5s; `market scan` and `players versions` make one request per player, so keep `--limit` modest.