CardMetrics public API

GET /api/public/prices/

No authentication

Latest known price for a batch of cards. Ids without a price are simply absent from the response.

Parameters

• ids — required. 1 to 100 comma-separated providerIds (allowed characters: A–Z a–z 0–9 _ -).

Errors

• 400 — ids missing, empty, >100 ids, or invalid characters.

Responses are CDN-cacheable: Cache-Control: public, s-maxage=300, stale-while-revalidate=600.

GET /api/public/cards/{providerId}/

Requires API key (Bearer)

Full record of one card printing + its latest price. providerId accepts up to 80 characters (A–Z a–z 0–9 _ - : .).

Request:

curl "https://cards.faseconsulting.es/api/public/cards/0948e6dc-8af7-45d3-91de-a2aebee83e82/" \
     -H "Authorization: Bearer cm_YOUR_API_KEY"

Response 200:

{
  "providerId": "0948e6dc-8af7-45d3-91de-a2aebee83e82",
  "game": "mtg",
  "name": "Black Lotus",
  "setCode": "ced",
  "setName": "Collectors' Edition",
  "number": "233",
  "rarity": "rare",
  "language": "en",
  "printing": "standard",
  "imageUrl": "https://cards.scryfall.io/normal/front/0/9/0948e6dc-8af7-45d3-91de-a2aebee83e82.jpg?1782756162",
  "latest": {
    "source": "cardmarket",
    "currency": "EUR",
    "amount": 4360.36,
    "capturedAt": "2026-07-11T03:58:15.052Z"
  }
}

Errors

• 400 — {"error":"invalid_provider_id"}
• 401 — missing Authorization header, or unknown/revoked/expired key:

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="api"

{"error":"missing_authorization"}

• 404 — {"error":"not_found"}
• 429 — {"error":"rate_limited"} + Retry-After

GET /api/public/movers/

No authentication

Top gaining or falling cards — the same query behind the movers pages, with a small cap designed for bots and embeds. Ranking is by percent change; each row carries its own currency (a row's change never mixes EUR and USD).

Parameters

• game — optional. One of: mtg · pokemon · yugioh · lorcana · onepiece · swu · digimon. Unknown values → cross-game ranking (no 400).
• direction — up | down (default up).
• window — 7 | 30 | 90 days (default 7).
• limit — 1–10 (default 5).

Forgiving contract: any invalid parameter falls back to its default instead of answering 400. The path field is locale-less — prefix /es/, /en/… when linking.

Request:

curl "https://cards.faseconsulting.es/api/public/movers/?limit=1"

Response 200:

{
  "window": 7,
  "direction": "up",
  "movers": [
    {
      "providerId": "swshp-SWSH153",
      "game": "pokemon",
      "name": "Pikachu",
      "setCode": "swshp",
      "setName": "SWSH Black Star Promos",
      "number": "SWSH153",
      "imageUrl": "https://images.pokemontcg.io/swshp/SWSH153_hires.png",
      "currency": "EUR",
      "currentAmount": 129.05,
      "priorAmount": 11.25,
      "pctChange": 1047.111111111111,
      "path": "/pokemon/swshp/pikachu-SWSH153/"
    }
  ]
}

CDN cache: Cache-Control: public, s-maxage=600, stale-while-revalidate=3600.

GET /api/public/card-summary/

No authentication

One-card summary: identity + primary quote, secondary quote in the other currency, and 30-day change. The primary quote is the deepest coherent price series (single source and currency); the secondary is the best series in the OTHER currency and is omitted (null) when stale for more than 14 days. delta30d is computed on the primary series only.

Parameters

• id — required. One providerId (1–80 characters: A–Z a–z 0–9 _ - : .).

Request:

curl "https://cards.faseconsulting.es/api/public/card-summary/?id=sv1-258"

Response 200:

{
  "providerId": "sv1-258",
  "game": "pokemon",
  "name": "Basic Fighting Energy",
  "setCode": "sv1",
  "setName": "Scarlet & Violet",
  "number": "258",
  "rarity": "Hyper Rare",
  "imageUrl": "https://images.pokemontcg.io/sv1/258_hires.png",
  "path": "/pokemon/sv1/basic-fighting-energy-258/",
  "primary": {
    "amount": 4.76,
    "currency": "EUR",
    "source": "cardmarket",
    "capturedAt": "2026-07-11T03:45:50.476Z"
  },
  "secondary": {
    "amount": 7.35,
    "currency": "USD",
    "source": "tcgplayer",
    "capturedAt": "2026-07-11T03:45:50.476Z"
  },
  "delta30d": 4.2857142857142785
}

Errors

• 400 — {"error":"expected ?id=<providerId>"} (id missing or with invalid characters)
• 404 — {"error":"card_not_found"}

CDN cache: Cache-Control: public, s-maxage=300, stale-while-revalidate=600.

GET /api/public/set-completion/

No authentication

Set-completion snapshot: total prints, full-set value and a providerId → price map, all in ONE currency (whichever prices the most cards of the set; EUR on ties). Designed for client-side completion math without uploading your owned list: missing = totalCards − owned; cost = totalValue − Σ prices[id]. Cards unpriced in that currency are absent from the map.

Parameters

• game — required. One of: mtg · pokemon · yugioh · lorcana · onepiece · swu · digimon.
• setCode — required. Set code (1–40 characters: A–Z a–z 0–9 space _ - .).

If the set exceeds 3,000 prints the response ships oversized: true with an empty prices map (safety valve; the totals are still returned).

Request:

curl "https://cards.faseconsulting.es/api/public/set-completion/?game=pokemon&setCode=sv1"

Response 200:

{
  "game": "pokemon",
  "setCode": "sv1",
  "setName": "Scarlet & Violet",
  "totalCards": 258,
  "pricedCards": 258,
  "currency": "USD",
  "totalValue": 853.08,
  "prices": {
    "sv1-1": 0.12,
    "sv1-2": 0.11,
    … 258 entries (providerId → amount) …
  },
  "oversized": false
}

Errors

• 400 — {"error":"expected ?game=<TcgGame>&setCode=<code>"}
• 404 — {"error":"set_not_found"}

CDN cache: Cache-Control: public, s-maxage=600, stale-while-revalidate=3600 (404s are cached for 300 s).