Midpoint Card Prices
Trading card prices and grading ROI for 1.5M+ Pokémon, Magic, Yu-Gi-Oh! and sports cards. Read-only.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~6,224Token（工具定義）
~6.6 KB典型回應大小
顯著的注意力影響（128k 上下文的 4.86%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"card-prices": {
"url": "https://mcp.cardcenteringtool.com/mcp"
}
}
}遠端端點
https://mcp.cardcenteringtool.com/mcpstreamable-http它能做什麼
工具清單
工具（9）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢search_cards(query, game, set_id, limit)
Use this first when the user names a trading card and wants its value, price, or whether to grade it. Searches 1.5M+ Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lorcana, sports (baseball, basketball, football, hockey, soccer, wrestling, UFC and more) and entertainment cards by name, set, number and year, returning ungraded and PSA 10 market prices in USD from real sold listings. Returns card ids for get_card_prices, grading_roi and get_price_history. Do not use for sealed product, for cards you already have an id for, or for price prediction.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Card name, optionally with set, number or year. Examples: \"Umbreon VMAX Evolving Skies\", \"1986 Fleer Jordan\", \"Charizard base set 4/102\"."
},
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Restrict to one game or sport. Omit when unsure."
},
"set_id": {
"type": "string",
"maxLength": 60,
"pattern": "^[a-zA-Z0-9_.-]*$",
"description": "Expansion id from list_sets, to search inside one set."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"matched_on": {
"type": "string",
"description": "The search term that produced the results"
},
"count": {
"type": "integer"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history."
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
],
"description": "Ungraded (raw) market price in USD"
},
"psa10_market_usd": {
"type": [
"number",
"null"
],
"description": "PSA 10 market price in USD"
},
"url": {
"type": "string",
"description": "Card page with the full price ladder and history"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url"
],
"additionalProperties": false
}
},
"note": {
"type": "string"
}
},
"required": [
"query",
"matched_on",
"count",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_card_prices(card_id)
Use this when the user wants the full current value of a specific card: ungraded prices by condition (NM/LP/MP/HP) and graded prices for every company and grade on record (PSA, CGC, BGS, SGC, TAG). Requires a card id from search_cards. Prices are USD market values from real sold listings, refreshed daily. Do not use to search by name.
輸入結構描述
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Catalog card id from search_cards, e.g. \"swsh7-215\" or \"pricecharting-1821843\"."
}
},
"required": [
"card_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"card": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"set_release_date": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"rarity",
"set_release_date"
],
"additionalProperties": false
},
"currency": {
"type": "string",
"const": "USD"
},
"captured_on": {
"type": [
"string",
"null"
],
"description": "Date of the latest price capture (UTC)"
},
"variant": {
"type": [
"string",
"null"
],
"description": "The printing the raw and graded rungs refer to (e.g. \"holofoil\", \"1st edition\"). Other printings are listed under other_variants."
},
"raw_note": {
"type": [
"string",
"null"
],
"description": "Set when the raw condition ladder is out of order (thin data): treat raw prices as low confidence."
},
"raw": {
"type": "array",
"items": {
"type": "object",
"properties": {
"condition": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
},
"low_usd": {
"type": [
"number",
"null"
]
},
"high_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"condition",
"market_usd",
"low_usd",
"high_usd"
],
"additionalProperties": false
}
},
"graded": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"company",
"grade",
"market_usd"
],
"additionalProperties": false
}
},
"other_variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variant": {
"type": "string"
},
"raw": {
"type": "array",
"items": {
"type": "object",
"properties": {
"condition": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
},
"low_usd": {
"type": [
"number",
"null"
]
},
"high_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"condition",
"market_usd",
"low_usd",
"high_usd"
],
"additionalProperties": false
}
},
"graded": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"company",
"grade",
"market_usd"
],
"additionalProperties": false
}
}
},
"required": [
"variant",
"raw",
"graded"
],
"additionalProperties": false
},
"description": "Other printings of the same card id (reverse holo, 1st edition…) with their own prices. Never mix these with the main ladder."
},
"summary": {
"type": "object",
"properties": {
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"psa9_usd": {
"type": [
"number",
"null"
]
},
"psa10_usd": {
"type": [
"number",
"null"
]
},
"best_graded_usd": {
"type": [
"number",
"null"
]
},
"change_30d_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"best_graded_usd",
"change_30d_pct"
],
"additionalProperties": false
},
"links": {
"type": "object",
"properties": {
"card_page": {
"type": "string"
},
"worth_grading": {
"type": "string"
}
},
"required": [
"card_page",
"worth_grading"
],
"additionalProperties": false
}
},
"required": [
"card",
"currency",
"captured_on",
"variant",
"raw_note",
"raw",
"graded",
"other_variants",
"summary",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢grading_roi(card_id, grading_fee_usd)
Use this when the user asks whether a card is worth grading, submitting to PSA/CGC/BGS/SGC/TAG, or what a PSA 10 adds. Returns raw vs PSA 9 vs PSA 10 market prices, the gem premium, net profit after grading fees per outcome, expected value by gem probability, the break-even gem rate, which company pays most, and a plain-language verdict. Requires a card id from search_cards. It does not assess the condition of the user's copy.
輸入結構描述
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Catalog card id from search_cards."
},
"grading_fee_usd": {
"type": "number",
"minimum": 0,
"maximum": 5000,
"description": "Grading fee to assume. Defaults to a $25 economy tier; the table also shows $50 and $150."
}
},
"required": [
"card_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"card": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"game",
"set",
"number"
],
"additionalProperties": false
},
"currency": {
"type": "string",
"const": "USD"
},
"captured_on": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"psa9_usd": {
"type": [
"number",
"null"
]
},
"psa10_usd": {
"type": [
"number",
"null"
]
},
"gem_premium_multiple": {
"type": [
"number",
"null"
],
"description": "PSA 10 price ÷ raw price"
},
"verdict": {
"anyOf": [
{
"type": "object",
"properties": {
"tone": {
"type": "string",
"enum": [
"strong",
"conditional",
"weak"
]
},
"headline": {
"type": "string"
},
"body": {
"type": "string"
}
},
"required": [
"tone",
"headline",
"body"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"top_grade_by_company": {
"type": "array",
"items": {
"type": "object",
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"value_usd": {
"type": "number"
},
"centering_tolerance_front": {
"type": "string"
},
"centering_tolerance_back": {
"type": "string"
}
},
"required": [
"company",
"grade",
"value_usd",
"centering_tolerance_front",
"centering_tolerance_back"
],
"additionalProperties": false
}
},
"net_after_fee": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"type": "string"
},
"sale_usd": {
"type": "number"
},
"net_usd_by_fee": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fee_usd": {
"type": "number"
},
"net_usd": {
"type": "number"
}
},
"required": [
"fee_usd",
"net_usd"
],
"additionalProperties": false
}
}
},
"required": [
"outcome",
"sale_usd",
"net_usd_by_fee"
],
"additionalProperties": false
}
},
"expected_value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"gem_probability": {
"type": "number"
},
"expected_sale_usd": {
"type": "number"
},
"expected_net_usd": {
"type": "number"
}
},
"required": [
"gem_probability",
"expected_sale_usd",
"expected_net_usd"
],
"additionalProperties": false
}
},
"break_even_gem_probability": {
"type": [
"number",
"null"
],
"description": "Chance of a PSA 10 needed to break even at the assumed fee; null when grading never breaks even"
},
"assumed_fee_usd": {
"type": "number"
},
"links": {
"type": "object",
"properties": {
"worth_grading": {
"type": "string"
},
"card_page": {
"type": "string"
},
"measure_centering": {
"type": "string"
}
},
"required": [
"worth_grading",
"card_page",
"measure_centering"
],
"additionalProperties": false
}
},
"required": [
"card",
"currency",
"captured_on",
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"gem_premium_multiple",
"verdict",
"top_grade_by_company",
"net_after_fee",
"expected_value",
"break_even_gem_probability",
"assumed_fee_usd",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_price_history(card_id, days, grade)
Use this when the user asks how a card's price has changed over weeks or months, or wants a trend for the raw or a PSA-graded series. Returns dated USD market values for the last 7 to 180 days. Requires a card id from search_cards. Do not use for forecasts.
輸入結構描述
{
"type": "object",
"properties": {
"card_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Catalog card id from search_cards."
},
"days": {
"type": "integer",
"minimum": 7,
"maximum": 180,
"default": 90
},
"grade": {
"type": "string",
"maxLength": 10,
"description": "PSA grade for a graded series, e.g. \"10\" or \"9\". Omit for the raw (ungraded) series."
}
},
"required": [
"card_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"card_id": {
"type": "string"
},
"name": {
"type": "string"
},
"series": {
"type": "string",
"description": "\"raw\" or \"PSA <grade>\""
},
"variant": {
"type": [
"string",
"null"
],
"description": "The printing the series follows (e.g. \"holofoil\"); other printings are separate markets and are never mixed in."
},
"days": {
"type": "integer"
},
"coverage": {
"type": "object",
"properties": {
"days_with_data": {
"type": "integer"
},
"note": {
"type": "string"
}
},
"required": [
"days_with_data",
"note"
],
"additionalProperties": false,
"description": "How many of the requested days have a capture, and how to read repeated or sparse values."
},
"currency": {
"type": "string",
"const": "USD"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"date",
"market_usd"
],
"additionalProperties": false
},
"description": "Oldest first. Graded series only contain days with sales; gaps are normal."
},
"first_usd": {
"type": [
"number",
"null"
]
},
"last_usd": {
"type": [
"number",
"null"
]
},
"change_pct": {
"type": [
"number",
"null"
],
"description": "First-to-last change; null when change_note is set because a single step carries it."
},
"change_note": {
"type": [
"string",
"null"
],
"description": "Set when one step between consecutive captures accounts for the change: usually a data correction, not a market move. change_pct is null in that case."
},
"source": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"card_page": {
"type": "string"
}
},
"required": [
"card_page"
],
"additionalProperties": false
}
},
"required": [
"card_id",
"name",
"series",
"variant",
"days",
"coverage",
"currency",
"points",
"first_usd",
"last_usd",
"change_pct",
"change_note",
"source",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢best_cards_to_grade(game, set_slug, grading_fee_usd, limit)
Use this when the user asks which cards in a game, sport or set have the biggest payoff from grading. Ranks priced cards by expected net profit at a 50% gem rate (half PSA 10, half PSA 9, minus raw and the fee), requiring both PSA 9 and PSA 10 prices so thin-market outliers are excluded. Returns card ids for grading_roi. Do not use for a single named card.
輸入結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Game or sport to rank."
},
"set_slug": {
"type": "string",
"maxLength": 80,
"pattern": "^[a-z0-9-]*$",
"description": "Optional set slug (as used on /sets/<game>/<slug>) to rank inside one set."
},
"grading_fee_usd": {
"type": "number",
"minimum": 0,
"maximum": 5000,
"description": "Grading fee to assume. Defaults to $25."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 12
}
},
"required": [
"game"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string"
},
"criteria": {
"type": "string"
},
"assumed_fee_usd": {
"type": "number"
},
"count": {
"type": "integer"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": "number"
},
"psa9_usd": {
"type": "number"
},
"psa10_usd": {
"type": "number"
},
"expected_net_usd_at_50pct_gem": {
"type": "number",
"description": "0.5 × PSA 10 + 0.5 × PSA 9 − raw − fee"
},
"gem_premium_multiple": {
"type": [
"number",
"null"
],
"description": "PSA 10 ÷ raw"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"set",
"number",
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"expected_net_usd_at_50pct_gem",
"gem_premium_multiple",
"url"
],
"additionalProperties": false
}
},
"links": {
"type": "object",
"properties": {
"worth_grading_index": {
"type": "string"
}
},
"required": [
"worth_grading_index"
],
"additionalProperties": false
}
},
"required": [
"game",
"criteria",
"assumed_fee_usd",
"count",
"cards",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢trending_cards(game, direction, min_market_usd, limit)
Use this when the user asks which cards are rising, hot, spiking, crashing or trending, in one game or across all games. Returns the biggest 30-day gainers (or drops) with the percentage change, measured on the PSA 10 price where the card has one and on the raw price otherwise; moves over 300% are excluded as bad data. Do not use for a single named card or for long-term history.
輸入結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Restrict to one game or sport; omit for all."
},
"direction": {
"type": "string",
"enum": [
"up",
"down"
],
"default": "up",
"description": "\"up\" = biggest gainers, \"down\" = biggest drops."
},
"min_market_usd": {
"type": "number",
"minimum": 0.5,
"maximum": 1000,
"default": 5,
"description": "Ignore cards whose raw price is below this."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 15
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"window_days": {
"type": "number",
"const": 30
},
"direction": {
"type": "string",
"enum": [
"up",
"down"
]
},
"game": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"excluded_unstable": {
"type": "integer",
"description": "Candidates dropped because their own 40-day series did not hold together (too few captures, a baseline that swings >2×, a >6× range, or a one-capture jump)."
},
"criteria": {
"type": "string"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"basis": {
"type": "string",
"enum": [
"PSA 10",
"raw"
],
"description": "Which price series the change refers to"
},
"price_30d_ago_usd": {
"type": "number"
},
"price_now_usd": {
"type": "number"
},
"change_30d_pct": {
"type": "number"
},
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"psa10_market_usd": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"basis",
"price_30d_ago_usd",
"price_now_usd",
"change_30d_pct",
"raw_market_usd",
"psa10_market_usd",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"window_days",
"direction",
"game",
"count",
"excluded_unstable",
"criteria",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢liquid_movers(game, include_unknown_volume, limit)
Use this when the user wants cards that are both rising in price and easy to sell: recent gainers filtered to cards with at least 25 recorded sales a year and a raw price of at least $5, across all games and sports. Better than trending_cards for flipping or selling decisions. Do not use for a single named card.
輸入結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
],
"description": "Restrict to one game or sport; omit for all."
},
"include_unknown_volume": {
"type": "boolean",
"default": false,
"description": "Also include cards whose yearly sales count is not tracked (mostly Pokémon from the Scrydex source). Off by default so every result has a verifiable sales figure."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 15
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"as_of": {
"type": "string",
"description": "When this ranking was computed (ISO 8601)"
},
"criteria": {
"type": "string"
},
"count": {
"type": "integer"
},
"volume_verified": {
"type": "boolean",
"description": "False when the list had to include cards whose yearly sales count is not tracked (Pokémon and other Scrydex-sourced games have no volume data)."
},
"excluded_unstable": {
"type": "integer",
"description": "Candidates dropped because their own 40-day raw series did not hold together."
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history."
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
],
"description": "Ungraded (raw) market price in USD"
},
"psa10_market_usd": {
"type": [
"number",
"null"
],
"description": "PSA 10 market price in USD"
},
"url": {
"type": "string",
"description": "Card page with the full price ladder and history"
},
"change_pct": {
"type": [
"number",
"null"
]
},
"sales_per_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Recorded sales in the last year; null only when include_unknown_volume is on and the source does not track volume."
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url",
"change_pct",
"sales_per_year"
],
"additionalProperties": false
}
}
},
"required": [
"as_of",
"criteria",
"count",
"volume_verified",
"excluded_unstable",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_sets(game, query, limit)
Use this to find the set id for a game or sport (e.g. "Evolving Skies", "2019 Panini Prizm") before calling get_set_cards, or when the user asks which sets exist. Newest first. Do not use to price a single card.
輸入結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
]
},
"query": {
"type": "string",
"maxLength": 60,
"description": "Optional substring to filter set names, e.g. \"evolving\" or \"2019 prizm\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 30
}
},
"required": [
"game"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string"
},
"count": {
"type": "integer"
},
"sets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"set_id": {
"type": "string",
"description": "Pass to get_set_cards or search_cards.set_id"
},
"name": {
"type": [
"string",
"null"
]
},
"release_date": {
"type": [
"string",
"null"
]
},
"card_count": {
"type": "integer"
}
},
"required": [
"set_id",
"name",
"release_date",
"card_count"
],
"additionalProperties": false
}
},
"links": {
"type": "object",
"properties": {
"sets_index": {
"type": "string"
}
},
"required": [
"sets_index"
],
"additionalProperties": false
}
},
"required": [
"game",
"count",
"sets",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_set_cards(game, set_id, sort, limit)
Use this when the user wants the most valuable cards in a specific set or a priced checklist of a set. Requires a set id from list_sets. Returns raw and PSA 10 USD prices per card. Do not use for a single named card; use search_cards instead.
輸入結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string",
"enum": [
"pokemon",
"magicthegathering",
"yugioh",
"onepiece",
"lorcana",
"riftbound",
"gundam",
"dragonball",
"digimon",
"baseball",
"basketball",
"football",
"hockey",
"soccer",
"wrestling",
"ufc",
"racing",
"tennis",
"golf",
"boxing",
"marvel",
"starwars",
"gpk",
"entertainment",
"othertcg"
]
},
"set_id": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"pattern": "^[a-zA-Z0-9_.-]+$",
"description": "Expansion id from list_sets."
},
"sort": {
"type": "string",
"enum": [
"value",
"number"
],
"default": "value",
"description": "\"value\" = most valuable first; \"number\" = checklist order."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
}
},
"required": [
"game",
"set_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"game": {
"type": "string"
},
"set_id": {
"type": "string"
},
"set_name": {
"type": [
"string",
"null"
]
},
"total_cards": {
"type": "integer"
},
"count": {
"type": "integer"
},
"cards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history."
},
"name": {
"type": "string"
},
"game": {
"type": "string"
},
"set": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
],
"description": "Ungraded (raw) market price in USD"
},
"psa10_market_usd": {
"type": [
"number",
"null"
],
"description": "PSA 10 market price in USD"
},
"url": {
"type": "string",
"description": "Card page with the full price ladder and history"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url"
],
"additionalProperties": false
}
}
},
"required": [
"game",
"set_id",
"set_name",
"total_cards",
"count",
"cards"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據
近期觀測
已驗證未記錄版本9 個工具
已驗證未記錄版本9 個工具
已驗證未記錄版本9 個工具