Public Player API

Overview

The public API lets approved partners search our player database by name and filters (version, rating, positions, league, team, nationality), with optional sort/order, 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 name, rating, positions, league, team, nationality; sort with sort/order)
• 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

Filter the catalogue with optional attribute filters and optional sorting. By default results are ordered by most recently updated (updated_at desc). Pass sort / order to override. By default only Gold card versions are included (REGULAR, GOLD, NORMAL); pass version=all to include specials and other types.

Query parameters

Positions

Pass one or more of these codes as positions (comma-separated). Matching is case-insensitive and includes both the player's primary position and alt_positions. Multiple values are OR'd — a player matches if any requested position appears on the card.

Sort keys

Pass one of these values as sort. Combine with order=asc or order=desc (default desc). When sort is omitted, results use updated_at.

Example request

curl "https://api.thecoinprinter.com/api/v1/public/players/search?name=mbappe&min_rating=85&max_rating=92&positions=ST,CF&sort=rating&order=desc&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.