Public Player API

Overview

The public API lets approved partners search our player database by name and filters (version, rating, position, league, team, nationality), load a single player, and retrieve BIN history for console or PC. Responses include metadata, current prices, previous BIN, and momentum for both platforms. All requests are made over HTTPS and return JSON. Results are scoped to the current FIFA year.

Base URL: https://api.thecoinprinter.com

Endpoints:

• GET /api/v1/public/players/search — search or list recently updated players (Gold versions by default; filter by rating, position, league, team, nationality)
• GET /api/v1/public/players/:id — player detail
• GET /api/v1/public/players/:id/previous-values — BIN history for a platform

Authentication

Every request must include your API key as a bearer token in the Authorization header:

Authorization: Bearer tcp_your_api_key

API keys are issued by The Coin Printer — there is no self-serve signup. To request access, contact us at contact@thecoinprinter.com. We'll email you a secure payment link for your plan; your key is generated and emailed automatically once payment is complete. Treat your key like a password; requests with a missing, invalid, or revoked key return 401 Unauthorized.

Rate limits

Each API key is limited to 60 requests per minute. Exceeding the limit returns 429 Too Many Requests with a message indicating when you can retry.

Search players

GET /api/v1/public/players/search

Case-insensitive name search with optional attribute filters. With q, results are ordered by popularity then rating. Without q, the most recently updated players are returned. By default only Gold card versions are included (REGULAR, GOLD, NORMAL); pass version=all to include specials and other types.

Query parameters

Example request

curl "https://api.thecoinprinter.com/api/v1/public/players/search?q=mbappe&min_rating=85&max_rating=92&position=ST&page=1&take=20" \
  -H "Authorization: Bearer tcp_your_api_key"

Example response

{
  "data": [
    {
      "id": "8f3c1e2a-...",
      "name": "Kylian Mbappé",
      "rating": 91,
      "image": "https://.../player.png",
      "group_type": "REGULAR",
      "console_price": 1250000,
      "pc_price": 1180000,
      "console_previous_price": 1190000,
      "pc_previous_price": 1140000,
      "console_momentum_pct": 5.0,
      "pc_momentum_pct": 3.5,
      "league": "LaLiga EA Sports",
      "team": "Real Madrid",
      "nationality": "France",
      "position": "ST",
      "alt_positions": ["LW", "CF"],
      "pace": 97,
      "shooting": 90,
      "passing": 82,
      "dribbling": 92,
      "defending": 38,
      "physical": 78,
      "year": 27,
      "popularity": 984,
      "updated_at": "2026-08-01T12:00:00.000Z"
    }
  ],
  "pagination": { "page": 1, "take": 20, "total": 3 }
}

Get player

GET /api/v1/public/players/:id

Returns the same player object as a search hit: metadata, current console/PC BIN, previous BIN, and momentum for both platforms. Unknown ids return 404.

Path parameters

Example request

curl "https://api.thecoinprinter.com/api/v1/public/players/8f3c1e2a-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer tcp_your_api_key"

Example response

{
  "id": "8f3c1e2a-...",
  "name": "Kylian Mbappé",
  "rating": 91,
  "image": "https://.../player.png",
  "group_type": "REGULAR",
  "console_price": 1250000,
  "pc_price": 1180000,
  "console_previous_price": 1190000,
  "pc_previous_price": 1140000,
  "console_momentum_pct": 5.0,
  "pc_momentum_pct": 3.5,
  "league": "LaLiga EA Sports",
  "team": "Real Madrid",
  "nationality": "France",
  "position": "ST",
  "alt_positions": ["LW", "CF"],
  "pace": 97,
  "shooting": 90,
  "passing": 82,
  "dribbling": 92,
  "defending": 38,
  "physical": 78,
  "year": 27,
  "popularity": 984,
  "updated_at": "2026-08-01T12:00:00.000Z"
}

BIN history

GET /api/v1/public/players/:id/previous-values

Append-only lowest-BIN snapshots for one platform, newest first. Each item is { value, createdAt } where value is the BIN and createdAt is when it was captured.

Path parameters

Query parameters

Example request

curl "https://api.thecoinprinter.com/api/v1/public/players/8f3c1e2a-0000-0000-0000-000000000000/previous-values?platform=CONSOLE&limit=500" \
  -H "Authorization: Bearer tcp_your_api_key"

Example response

{
  "previous_values": [
    { "value": 1250000, "createdAt": "2026-08-28T12:00:00.000Z" },
    { "value": 1190000, "createdAt": "2026-08-27T12:00:00.000Z" }
  ]
}

Player object

Search items and the get-player response share this shape. Attribute fields may be null until a player has been scraped after that data was added. Previous BIN and momentum are null when there is not enough history.

Errors

Errors are returned as JSON with an HTTP status code and a human-readable message.