Valo.Data API
Catalogue and price data for trading card games (Pokémon, One Piece, Yu-Gi-Oh!, Magic, Lorcana and more): Cardmarket and US market prices, eBay sold prices,…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Catalogue and price data for trading card games (Pokémon, One Piece, Yu-Gi-Oh!, Magic, Lorcana and more):
Cardmarket and US market prices, eBay sold prices, graded prices, PSA/PCA/CCC populations and price history.
Français
Authentification. Chaque requête porte une clé API : Authorization: Bearer vd_live_…. Les clés se créent dans
le portail développeur et ne sont affichées qu'une fois. vd_test_ etvd_live_ sont une étiquette choisie à la création pour séparer préproduction et production : mêmes données, mêmes
crédits, mêmes quotas. Une clé peut porter une date d'expiration (401 api_key_expired), une liste d'adresses IP ou
de blocs CIDR autorisés (403 ip_not_allowed) et un plafond mensuel de crédits (429 key_credit_cap_reached). Le Sandbox
sert les mêmes prix que les forfaits payants, sans les cotes gradées ni les populations. Les
identifiants et les liens Cardmarket et marché US (cardmarket_product_id, tcgplayer_product_id, cardmarket_url,tcgplayer_url) sont inclus à partir de Growth : ils valent null en Sandbox et en Starter.
Autres langues. À partir de Growth, la fiche GET /data/v1/cards/{card_id} donne les versions de la même carte dans
d'autres langues (other_languages), sans crédit supplémentaire. Une même langue peut revenir plusieurs fois quand
l'illustration a été imprimée dans plusieurs éditions : POST /data/v1/cards/batch renvoie leur édition, leur numéro et
leurs prix. [] quand aucune autre version n'est connue, null en Sandbox et en Starter. Tous les jeux ne sont pas couverts.
Crédits. Chaque forfait inclut des crédits mensuels (barème ci-dessous). Les réponses en erreur ne sont jamais
facturées. Une fois les crédits épuisés, l'API répond 429 quota_exceeded jusqu'au renouvellement (resets_at). Le Sandbox
lit au plus 250 cartes et produits scellés distincts par mois, toutes routes confondues ; une fiche déjà lue
reste disponible, une nouvelle au-delà répond 429 catalog_limit_reached. Il envoie au plus 100 requêtes facturées
par jour (UTC) : au-delà, 429 daily_limit_reached jusqu'à minuit UTC (resets_at).
Débit. Les requêtes sont limitées par organisation et par minute selon le forfait : 429 rate_limited, à rejouer aprèsRetry-After secondes.
Prix. Chaque source garde sa devise native, sans conversion. amount vaut null (jamais 0) dès que status
n'est pas available. observed_at est la date d'observation par la source ; computed_at celle du dernier calcul.
Les ventes eBay sont collectées au mieux (collection: best_effort).
Variantes. variants liste les impressions d'une carte cotées à part, chacune avec ses propres cotes (variant) et
son historique (/cards/{card_id}/price-history?variant=) : default (impression principale), foil pour les jeux qui cotent la
finition à part (Magic, Lorcana, Riftbound, Dragon Ball Super…), et pour Pokémon reverse (reverse holo), pokeball etmasterball (reverse motif Poké Ball et Master Ball) sur les cartes imprimées dans ces versions. Cardmarket vend les
motifs sous le produit de la carte : leurs cotes Cardmarket sont missing (reason: not_split_by_source), le marché
US les cote par produit. eBay cote default et chaque version Pokémon à part : une vente dont le titre nomme la
reverse, la Poké Ball ou la Master Ball d'une carte qui l'a compte pour cette variante, plus pour default. L'offre
française Cardmarket reste sur default.
Analyses. Les routes /data/v1/analysis/* répondent prêt à afficher : identification d'une carte à partir d'un texte libre, prix recommandé, fiabilité et variations sur 7, 30 et 90 jours, plus fortes hausses et baisses, comparaison, synthèse d'une édition. recommended est le prix qu'affiche l'app ValoTCG, toujours en EUR : le marché US y est converti au dernier taux BCE (fx_rate), alors que prices[] garde la devise native.
Pagination. Les listes renvoient next_cursor ; passez-le en cursor pour la page suivante (page_size ≤ 100).
Attribution. Affichez « Données : ValoTCG » à proximité des données affichées. Voir les
conditions de l'API ; badges « Prices by ValoTCG » et extraits HTML, Markdown
et React sur la page attribution.
English
Authentication. Every request carries an API key: Authorization: Bearer vd_live_…. Keys are created in the
developer portal and shown once. vd_test_ and vd_live_ are a label
chosen at creation to separate staging from production: same data, same credits, same quotas. A key may carry an
expiry date (401 api_key_expired), a list of allowed IP addresses or CIDR blocks (403 ip_not_allowed) and a
monthly credit cap (429 key_credit_cap_reached). The Sandbox serves the same prices as paid plans, without graded prices
and populations. Cardmarket and US market…
Endpoints 20
Games
- GETList games (0 credit)
/data/v1/games - GETList rarity codes of a game (0 credit)
/data/v1/games/:game/raritiesCanonical rarity codes of a game: the values of rarity_code on cards, accepted by the rarity filter of GET /data/v1/cards. Every code of the game is listed,…
Editions
- GETList editions of a game (1 credit)
/data/v1/editions?game=string
Cards
- GETSearch cards (1 credit)
/data/v1/cards?game=string - GETCard sheet (1 credit)
/data/v1/cards/:card_id - GETCurrent prices (1 credit, +1 per include)
/data/v1/cards/:card_id/prices - POSTBatch prices for cards and sealed products (1 credit per 100, +1 per card include)
/data/v1/cards/batch - GETDaily price history of one source (3 credits)
/data/v1/cards/:card_id/price-history?source=cardmarket
Sealed
- GETSearch sealed products (1 credit)
/data/v1/sealed?game=string - GETSealed product sheet (1 credit)
/data/v1/sealed/:sealed_id - GETCurrent prices (1 credit)
/data/v1/sealed/:sealed_id/prices - GETDaily price history of one source (3 credits)
/data/v1/sealed/:sealed_id/price-history?source=cardmarket
Analysis
- GETIdentify a card from free text (1 credit)
/data/v1/analysis/identify?q=string - GETRecommended price, reliability and changes of a card (1 credit, +1 per include)
/data/v1/analysis/cards/:card_id/summary - GETRecommended price, reliability and changes of a sealed product (1 credit)
/data/v1/analysis/sealed/:sealed_id/summary - POSTCompare up to 10 cards and sealed products (1 credit, +1 per card include)
/data/v1/analysis/compare - GETLargest price rises or falls of a game or an edition (3 credits)
/data/v1/analysis/top-movers?game=string - GETMost valuable cards or sealed products of a game, an edition or a language (3 credits)
/data/v1/analysis/top-priced?game=string&kind=cardRanked by recommended.amount, the price the ValoTCG app shows (EUR), across the whole catalogue of the game, every edition and language unless filtered. - GETChase cards, sealed products and price coverage of an edition (3 credits)
/data/v1/analysis/editions/:edition_id/overview
Usage
- GETCredits, scans or questions used in the current window (0 credit)
/developer/v1/usage
API details
- Base URL
https://api.valotcg.comhttps://api.preprod.valotcg.com- Authentication
- A bearer token in the Authorization header
- Operations
- 20 operations on 20 pathsGET 18POST 2
- Main resources
- Analysis 7Cards 5Sealed 4Games 2Editions 1Usage 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.2.0 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- Valotcg's published OpenAPI description
How to test the Valo.Data API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Valo.Data API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List games (0 credit)” (GET /data/v1/games), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Valo.Data API?
Catalogue and price data for trading card games (Pokémon, One Piece, Yu-Gi-Oh!, Magic, Lorcana and more): Cardmarket and US market prices, eBay sold prices,… It is listed under Media & content and has 20 endpoints.
Who publishes the Valo.Data API?
It is listed from ValoTCG's public API description (an OpenAPI document), not published by ValoTCG on Swastik Codes. Anyone who controls valotcg.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Valo.Data API?
Its description lists 2 base URLs: https://api.valotcg.com, https://api.preprod.valotcg.com. The first is the usual one; the others are typically sandbox or regional servers.
How do I authenticate with the Valo.Data API?
With A bearer token in the Authorization header.
How many endpoints does the Valo.Data API have?
20 operations on 20 paths (18 GET, 2 POST). The largest groups are Analysis, Cards, Sealed, Games.
Is forking the Valo.Data API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.