cli-web-futbin

CLI for FUTBIN — EA FC Ultimate Team player database. Installed at: cli-web-futbin (run cli-web-futbin --help to verify).

Quick Start

# Search by name
cli-web-futbin players search --name "Mbappe" --json

# List with filters
cli-web-futbin players list --position ST --cheapest --json

# Compare two players
cli-web-futbin players compare 40 42 --json

# Market index
cli-web-futbin market index --json

# Popular/trending players
cli-web-futbin market popular --limit 20 --json

# Newly released cards
cli-web-futbin market latest --json

# Cheapest players by rating (for SBCs/trading)
cli-web-futbin market cheapest --rating-min 88 --json

# Price analysis + buy/sell signal
cli-web-futbin market analyze 40 --json

# Find undervalued players (bulk scan)
cli-web-futbin market scan --rating-min 85 --rating-max 89 --json

# Cross-platform arbitrage (PS vs PC price gaps)
cli-web-futbin market arbitrage --rating-min 88 --min-gap 5 --json

# All versions of a player compared with value score
cli-web-futbin players versions --name "Haaland" --json

# Price history & trends
cli-web-futbin players price-history 40 --json

# SBCs
cli-web-futbin sbc list --json

# Evolutions
cli-web-futbin evolutions list --json

Always use --json when you need to parse or display data programmatically.

Commands

players search

Searches by player name. Uses the FUTBIN JSON API — fast, returns ratings and prices.

cli-web-futbin players search --name "Salah" --json
cli-web-futbin players search --name "Ronaldo" --year 25 --json
cli-web-futbin players search --name "Mbappe" --evolutions --json

Options: --name (required), --year (default 26), --evolutions (include evo cards)

Output fields: id, name, rating, position, version, club, nation, year, ps_price, xbox_price, url, stats (empty {} in search — use players get for full stats)

players list

Browse/filter the full player database. Supports comprehensive filters.

# Cheapest gold rare strikers
cli-web-futbin players list --position ST --version gold_rare --cheapest --json

# Top rated CAMs rated 85+, page 2
cli-web-futbin players list --position CAM --rating-min 85 --page 2 --json

# TOTY players under 500K
cli-web-futbin players list --version toty --max-price 500000 --cheapest --page 1 --json

# 5-star skill players
cli-web-futbin players list --min-skills 5 --json

Filter options:

Common --version values: gold_rare, gold_if, gold_nr, silver_rare, bronze, toty, toty_icon, fut_birthday, fut_birthday_hero, icons, heroes, non_icons, flashback, moments, showdown, thunderstruck, unbreakables, winter_wildcards, future_stars, world_tour, potm_pl, potm_bundesliga

players get

Full detail for a specific player by ID (get the ID from players search).

cli-web-futbin players get 40 --json

Output fields: name, rating, position, version, club, nation, ps_price, xbox_price, stats (pac/sho/pas/dri/def/phy), skill_moves, weak_foot, height, foot, trend (e.g., "0.17% (-12K)"), price_range (min/max EA listing bounds), ps_bin_listings (array of current BIN prices), pc_bin_listings

The extended fields (skill_moves, weak_foot, trend, price_range, bin_listings) are only populated from the detail page scrape, not from list/search results.

players compare

Side-by-side comparison of two players.

cli-web-futbin players compare 40 42 --json

Output fields: per-player: name, rating, position, stats (pac/sho/pas/dri/def/phy), ps_price, xbox_price

players price-history

Price history and trends for a player. Shows current, lowest, highest, and recent trend.

cli-web-futbin players price-history 40 --json
cli-web-futbin players price-history 40 --year 25 --json

Output fields: player_id, player_name, ps_prices (array of [timestamp_ms, price]), pc_prices, ps_current, ps_min, ps_max, pc_current, pc_min, pc_max, data_points

market index

EA FC market price tracker. Shows all rating tier indices, or detail for a specific tier.

cli-web-futbin market index --json                     # all tiers overview
cli-web-futbin market index --rating 83 --json          # detail: current/open/low/high for 83-rated
cli-web-futbin market index --rating 100 --json         # overall index 100
cli-web-futbin market index --rating icons --json       # icons index

Options: --rating (81, 82, 83, 84, 85, 86, 100, icons)

Detail output: current, change_pct, open, lowest, highest

market popular

Trending/most-viewed players on FUTBIN.

cli-web-futbin market popular --json
cli-web-futbin market popular --limit 50 --json

Options: --limit (number of players, default 30, max 250)

Output fields: Same as players list — id, name, rating, position, ps_price, xbox_price, stats

market latest

Newly released player cards.

cli-web-futbin market latest --json
cli-web-futbin market latest --page 2 --json

Options: --page (page number, default 1)

market cheapest

Find cheapest players by rating — best value for SBCs and trading.

cli-web-futbin market cheapest --rating-min 88 --json
cli-web-futbin market cheapest --rating-min 85 --rating-max 87 --max-price 10000 --json
cli-web-futbin market cheapest --rating-min 90 --platform pc --json

Options: --rating-min (default 83), --rating-max (default 99), --max-price, --platform (ps/pc), --page

market movers

Biggest price risers or fallers — spot momentum and crash opportunities.

cli-web-futbin market movers --json                    # biggest risers
cli-web-futbin market movers --fallers --json           # biggest fallers
cli-web-futbin market movers --rating-min 85 --json     # only 85+ rated

Options: --fallers (show fallers instead of risers), --rating-min (default 80), --min-price (default 1000), --max-price (default 15M), --platform (ps/pc), --page

Tip: Adjust --min-price and --rating-min to control noise. Use --min-price 200 for bronze/silver movers, or --min-price 50000 --rating-min 85 for high-end market only.

market fodder

SBC fodder prices — cheapest player at each rating tier (81-99). Essential for SBC cost planning.

cli-web-futbin market fodder --json
cli-web-futbin market fodder --rating-min 85 --json     # only 85+ tiers
cli-web-futbin market fodder --rating-min 88 --rating-max 91 --json

Options: --rating-min, --rating-max

Output fields: rating, cheapest_price, players (array of {id, name, position, price})

sbc list / sbc get

Squad Building Challenges.

cli-web-futbin sbc list --json
cli-web-futbin sbc list --category "League SBC" --json
cli-web-futbin sbc get 665 --json

Options: --category TEXT (filter by SBC category), --year INTEGER (game year)

Output fields: id, name, expires, cost_ps, cost_xbox, repeatable, reward

evolutions list / evolutions get

Player evolution paths.

cli-web-futbin evolutions list --json
cli-web-futbin evolutions list --expiring --json   # expiring soon
cli-web-futbin evolutions list --category "Lengthy" --json
cli-web-futbin evolutions get 666 --json

Options: --category TEXT, --expiring (show expiring soon), --year INTEGER

config

Persistent configuration (year, platform, etc.).

cli-web-futbin config set year 26       # Set game year
cli-web-futbin config set platform ps   # Set price platform
cli-web-futbin config get year          # Get a setting
cli-web-futbin config show --json       # Show all settings
cli-web-futbin config reset             # Reset to defaults

When --year is omitted on other commands, it falls back to the value set in config.

market analyze

Deep price analysis for a single player — trend, buy/sell signal, platform gap.

cli-web-futbin market analyze 40 --json
cli-web-futbin market analyze 67 --year 26 --json

Output fields per platform (ps/pc): current, min, max, avg_30d, price_position_pct (0%=floor, 100%=ceiling), vs_avg_30d_pct (negative=below avg=undervalued), trend_7d, trend_30d, volatility_30d, signal (BUY/SELL/HOLD)

Signal logic: BUY if >10% below 30d avg with stable/rising 7d trend. SELL if >15% above 30d avg with falling 7d trend. HOLD otherwise.

Also includes platform_gap_pct — cross-platform price difference %.

market scan

Bulk undervalue detection — scans players by rating and flags those trading below their 30-day average.

cli-web-futbin market scan --rating-min 85 --rating-max 89 --json
cli-web-futbin market scan --rating-min 88 --limit 10 --threshold 15 --json
cli-web-futbin market scan --rating-min 84 --rating-max 86 --platform pc --json

Options: --rating-min (default 84), --rating-max (default 90), --limit (default 20), --threshold (default 10 — min % below avg to flag), --platform, --json

Output fields: id, name, position, rating, version, current_price, avg_30d, vs_avg_30d_pct, trend_7d, signal

Note: Makes one request per player for price history — uses Rich progress bar. Rate-limited at 0.5s/request.

market arbitrage

Find cross-platform price gaps — identifies players where PS and PC prices diverge significantly.

cli-web-futbin market arbitrage --rating-min 88 --rating-max 92 --min-gap 5 --json
cli-web-futbin market arbitrage --rating-min 85 --min-gap 10 --json

Options: --rating-min (default 85), --rating-max (default 92), --min-gap (default 5 — minimum gap % to show), --page, --json

Output fields: id, name, position, rating, version, ps_price, pc_price, gap_pct, gap_coins, cheaper_on (ps/pc)

players versions

All versions of a player compared — with value score (stats per 1K coins).

cli-web-futbin players versions --name "Haaland" --json
cli-web-futbin players versions --name "Mbappe" --year 26 --json

Options: --name (required), --year, --json

Output fields: Standard player fields + total_stats (pac+sho+pas+dri+def+phy), value_score (total_stats / price_in_thousands — higher = better value)

Fetches up to 10 versions with Rich progress bar. Sorted by rating descending.

Agent Patterns

# What's Mbappe's current PS price?
cli-web-futbin players search --name "Mbappe" --json | python -c "import json,sys; p=json.load(sys.stdin)[0]; print(p['name'], p['ps_price'])"

# Compare two players (now includes value metrics)
cli-web-futbin players compare 40 42 --json

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

# Get player detail
cli-web-futbin players get 40 --json

# SBCs with cost under 100K (PS)
cli-web-futbin sbc list --json | python -c "import json,sys; [print(s['name'], s['cost_ps']) for s in json.load(sys.stdin) if s.get('cost_ps') and s['cost_ps'] < 100000]"

# Get all active evolutions
cli-web-futbin evolutions list --json

# What's trending right now?
cli-web-futbin market popular --limit 10 --json

# What new cards just dropped?
cli-web-futbin market latest --json

# Cheapest 88+ rated players for SBCs
cli-web-futbin market cheapest --rating-min 88 --json

# Is Mbappe at a good price to buy?
cli-web-futbin market analyze 40 --json

# Find deals: cheapest 90+ rated under 50K
cli-web-futbin market cheapest --rating-min 90 --max-price 50000 --json

Market Knowledge Base

For in-depth trading intelligence — weekly price cycles, EA tax formulas, promo crash calendar, fodder investment rules, mass bidding strategy, and step-by-step CLI workflows — read the reference file:

Read references/market-knowledge-base.md when the user asks about:

• When to buy or sell players
• Market timing, weekly cycles, best days to trade
• Promo schedules, market crashes, TOTY/TOTS/Black Friday impact
• Fodder investment strategies
• Mass bidding techniques
• EA tax calculations and profit margins
• Step-by-step trading workflows

Quick reference (details in the reference file):

• Best buy days: Wednesday (midweek crash), Thursday AM (rewards flood), Sunday night (post-WL sell-off)
• Best sell days: Friday (WL demand), Saturday (peak prices)
• EA tax: 5% on all sales. Break-even = Buy Price / 0.95. Min margin: 10-15%
• Fodder sweet spot: 84-87 rated. Buy when no SBCs active, sell when popular SBC drops
• Signal guide: BUY = >10% below 30d avg + stable trend. SELL = >15% above avg + falling trend

Trading Strategies

1. Buy the Dip — Find undervalued players

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

# Deep analysis on a specific player before buying
cli-web-futbin market analyze <player_id> --json
# Look for: signal=BUY, price_position_pct < 15%, trend_7d positive

2. SBC Fodder Trading — Buy cheap fodder before SBC drops

# Check current fodder prices at each tier
cli-web-futbin market fodder --json

# Find the absolute cheapest 85-rated players
cli-web-futbin market cheapest --rating-min 85 --rating-max 85 --json

# When SBC drops, fodder prices spike — check movers to confirm
cli-web-futbin market movers --rating-min 84 --min-price 1000 --max-price 20000 --json

3. Cross-Platform Arbitrage — Exploit PS/PC price gaps

# Find players with >10% price gap between platforms
cli-web-futbin market arbitrage --rating-min 88 --min-gap 10 --json

# Verify with deep analysis (check liquidity/trend context)
cli-web-futbin market analyze <player_id> --json

4. Version Value Hunting — Best bang for your coins

# Compare all versions of a player to find the best value
cli-web-futbin players versions --name "Salah" --json
# Look for: highest value_score (stats per 1K coins)

# Compare two specific versions head-to-head
cli-web-futbin players compare <base_id> <special_id> --json
# Check value.value_winner and coins_per_stat

5. Market Crash Detection — Spot opportunities after events

# Check which high-rated players are crashing
cli-web-futbin market movers --fallers --rating-min 88 --min-price 10000 --json

# Cross-reference with market index to see if it's market-wide
cli-web-futbin market index --json

# Drill into specific tier
cli-web-futbin market index --rating 88 --json

6. Trending Player Flip — Buy what's getting attention

# See what's trending on FUTBIN right now
cli-web-futbin market popular --limit 30 --json

# Check if trending players are still cheap (analyze before spike)
cli-web-futbin market analyze <trending_player_id> --json
# Buy if: signal=BUY or HOLD, price_position_pct < 30%

Notes

• Prices are in EA FC coins
• Year 26 = EA FC 26 (current default); use --year 25 for last year's cards. --year falls back to config value if omitted
• Errors: --json mode returns structured JSON errors {"error": true, "code": "...", "message": "..."}
• Rate limiting: 0.5s delay between requests
• players list scrapes HTML — may show limited data in some fields
• players search uses the JSON API — more reliable for name/rating/price data