RFC: Add Pricing Information

[Aviortheking]

Summary

This RFC introduces support for card pricing data in the TCGdex API. This is one of the most requested features and aims to provide users with up-to-date card price information from multiple sources.

Supported Providers

The following providers are planned (in this order):

1. Cardmarket (EU-focused) ✅
2. eBay France (fallback for obscure or low-availability cards) ✅
3. TCGPlayer (US-focused) ❌ Currently unavailable due to API access restrictions

API Changes

The GET /cards/{id} response will include a prices object with pricing data from supported providers.

two special non provider specific fields :

1. updated: indicate the last time the data has changed !
2. unit: indicate the price unit of the provider

Example Response

"prices": {
  "cardmarket": {
    "updated": "2025-08-08",
    "unit": "EUR",
    "avg": 0.08,
    "low": 0.02,
    "trend": 0.08,
    "avg1": 0.08,
    "avg7": 0.07,
    "avg30": 0.07,
    "avg-holo": null,
    "low-holo": null,
    "trend-holo": 0,
    "avg1-holo": null,
    "avg7-holo": null,
    "avg30-holo": null
  },
  "tcgplayer": {
    "updated": "2025-08-08",
    "unit": "USD",
    // Placeholder until API access is granted
  },
  "ebay-fr": {
    "updated": "2025-08-08",
    "unit": "EUR",
    "avg1": 0.08,
    "avg7": 0.08,
    "avg28": 0.08
  }
}

the database will also earn a new field on sets & cards which link with external services :

links: {
	cardMarket: "",
}

Roadmap

Cardmarket

1. Auto-map TCGdex IDs to Cardmarket IDs.
2. Daily sync script for fetching the full Cardmarket catalog.
3. Integrate prices into the main API response.

TCGPlayer

1. Acquire API access (waiting for approval or alternatives).
2. Implement data mapping + syncing logic.

eBay France

1. Improve scraper resilience to prevent takedowns or blocking.
2. Follow a similar flow to Cardmarket (ID mapping + periodic sync).

Final Notes

• Implementation is modular: each provider is fetched independently.
• Future enhancements may include historical price graphs or currency conversion.

[thomas-bassett]

There is a tcgplayer source that updates daily that could be used in place of having api access. Tcgcsv.com

[thomas-bassett]

And has pricecharting been considered as a price source?

[Aviortheking]

Currently, Pricecharting is not in the projects, but if enough interest gather, I can see to add it.

Also I'll take a look at tcgcsv.com