Readable URLs

Get readable prices

Prices always return an array, including when a finish filter selects a single variant. The path language identifies card content, not the price market.

1 admitted HTTP request. Unknown query/body parameters are rejected. Examples contain illustrative data and placeholder IDs; they are not live catalogue records.

get/v1/{game}/{language}/cards/{slug}/prices

Request

  • Base URL: https://tcgdata-api.ottenniels1999.workers.dev
  • URL: https://tcgdata-api.ottenniels1999.workers.dev/v1/{game}/{language}/cards/{slug}/prices
  • Auth: HTTP bearer

Path parameters

game'pokemon' | 'pokemon_jp' | 'magic' | 'lorcana' | 'onepiece' | 'yugioh' required

pokemon, magic, lorcana, onepiece or yugioh. Japanese Pokémon uses pokemon/ja; pokemon_jp/ja is also supported.

languagestring required

Catalogue/artwork language from catalogue_language, not a price-market filter.

slugstring required

Readable address returned by the scoped catalogue. Slugs can change; use tcg_ IDs as permanent keys.

Query parameters

finishstring

Exact price-guide bucket from finish_details.guide_finish (normal or foil for Cardmarket). Physical nonfoil is not a guide bucket: a One Piece nonfoil printing can use finish=normal while its legacy finish is null. Required for history when more than one variant matches; an opaque tcg_ variant ID avoids this filter.

view'full' | 'compact'

Use compact for lists and recurring price syncs. Full includes card metadata.

selectstring

Comma-separated top-level fields; overrides view. id is always returned. Unknown or nested fields return 400. This route also always returns slug, catalogue_language and finish. Allowed top-level fields: id, slug, catalogue_language, name, game, set_id, set_name, number, printed_number, finish, metadata, metadata_status, metadata_quality, metadata_text, finish_details, images, language, condition, currency, observed_at, avg, low, trend, avg1, avg7, avg30, changes, quote_scope, language_scope, edition_scope, condition_scope.

Comma-separated top-level fields; overrides view. id is always returned. Unknown or nested fields return 400. This route also always returns slug, catalogue_language and finish.

Response

Success. 1 admitted HTTP request.

Changes

No recorded changes to this operation across all 1 revision of this API.