Server definition
- Hash
- sha256:f9b34656171fdbaa1fe0c47755f428cd9396014203dcfc8db1d2f6ff2fd6a317
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "Midpoint trading-card market data: 1.5M+ Pokémon, Magic, Yu-Gi-Oh!, One Piece, Lorcana, Gundam, sports (baseball, basketball, football, hockey, soccer, wrestling, UFC, golf, tennis, boxing, racing) and entertainment cards. All prices are USD market values from real sold listings, refreshed daily; raw = ungraded. Start with search_cards to get a card id, then get_card_prices, grading_roi or get_price_history. No account is needed and nothing is written.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"game": {
"description": "Game or sport to rank.",
"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"
],
"type": "string"
},
"grading_fee_usd": {
"description": "Grading fee to assume. Defaults to $25.",
"maximum": 5000,
"minimum": 0,
"type": "number"
},
"limit": {
"default": 12,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"set_slug": {
"description": "Optional set slug (as used on /sets/<game>/<slug>) to rank inside one set.",
"maxLength": 80,
"pattern": "^[a-z0-9-]*$",
"type": "string"
}
},
"required": [
"game"
],
"type": "object"
},
"name": "best_cards_to_grade",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumed_fee_usd": {
"type": "number"
},
"cards": {
"items": {
"additionalProperties": false,
"properties": {
"expected_net_usd_at_50pct_gem": {
"description": "0.5 × PSA 10 + 0.5 × PSA 9 − raw − fee",
"type": "number"
},
"gem_premium_multiple": {
"description": "PSA 10 ÷ raw",
"type": [
"number",
"null"
]
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"psa10_usd": {
"type": "number"
},
"psa9_usd": {
"type": "number"
},
"raw_market_usd": {
"type": "number"
},
"set": {
"type": [
"string",
"null"
]
},
"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"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "integer"
},
"criteria": {
"type": "string"
},
"game": {
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"worth_grading_index": {
"type": "string"
}
},
"required": [
"worth_grading_index"
],
"type": "object"
}
},
"required": [
"game",
"criteria",
"assumed_fee_usd",
"count",
"cards",
"links"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"card_id": {
"description": "Catalog card id from search_cards, e.g. \"swsh7-215\" or \"pricecharting-1821843\".",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "get_card_prices",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"captured_on": {
"description": "Date of the latest price capture (UTC)",
"type": [
"string",
"null"
]
},
"card": {
"additionalProperties": false,
"properties": {
"game": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"set": {
"type": [
"string",
"null"
]
},
"set_release_date": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"rarity",
"set_release_date"
],
"type": "object"
},
"currency": {
"const": "USD",
"type": "string"
},
"graded": {
"items": {
"additionalProperties": false,
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"company",
"grade",
"market_usd"
],
"type": "object"
},
"type": "array"
},
"links": {
"additionalProperties": false,
"properties": {
"card_page": {
"type": "string"
},
"worth_grading": {
"type": "string"
}
},
"required": [
"card_page",
"worth_grading"
],
"type": "object"
},
"other_variants": {
"description": "Other printings of the same card id (reverse holo, 1st edition…) with their own prices. Never mix these with the main ladder.",
"items": {
"additionalProperties": false,
"properties": {
"graded": {
"items": {
"additionalProperties": false,
"properties": {
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"company",
"grade",
"market_usd"
],
"type": "object"
},
"type": "array"
},
"raw": {
"items": {
"additionalProperties": false,
"properties": {
"condition": {
"type": "string"
},
"high_usd": {
"type": [
"number",
"null"
]
},
"low_usd": {
"type": [
"number",
"null"
]
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"condition",
"market_usd",
"low_usd",
"high_usd"
],
"type": "object"
},
"type": "array"
},
"variant": {
"type": "string"
}
},
"required": [
"variant",
"raw",
"graded"
],
"type": "object"
},
"type": "array"
},
"raw": {
"items": {
"additionalProperties": false,
"properties": {
"condition": {
"type": "string"
},
"high_usd": {
"type": [
"number",
"null"
]
},
"low_usd": {
"type": [
"number",
"null"
]
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"condition",
"market_usd",
"low_usd",
"high_usd"
],
"type": "object"
},
"type": "array"
},
"raw_note": {
"description": "Set when the raw condition ladder is out of order (thin data): treat raw prices as low confidence.",
"type": [
"string",
"null"
]
},
"summary": {
"additionalProperties": false,
"properties": {
"best_graded_usd": {
"type": [
"number",
"null"
]
},
"change_30d_pct": {
"type": [
"number",
"null"
]
},
"psa10_usd": {
"type": [
"number",
"null"
]
},
"psa9_usd": {
"type": [
"number",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"raw_market_usd",
"psa9_usd",
"psa10_usd",
"best_graded_usd",
"change_30d_pct"
],
"type": "object"
},
"variant": {
"description": "The printing the raw and graded rungs refer to (e.g. \"holofoil\", \"1st edition\"). Other printings are listed under other_variants.",
"type": [
"string",
"null"
]
}
},
"required": [
"card",
"currency",
"captured_on",
"variant",
"raw_note",
"raw",
"graded",
"other_variants",
"summary",
"links"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"card_id": {
"description": "Catalog card id from search_cards.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"days": {
"default": 90,
"maximum": 180,
"minimum": 7,
"type": "integer"
},
"grade": {
"description": "PSA grade for a graded series, e.g. \"10\" or \"9\". Omit for the raw (ungraded) series.",
"maxLength": 10,
"type": "string"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "get_price_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"card_id": {
"type": "string"
},
"change_note": {
"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.",
"type": [
"string",
"null"
]
},
"change_pct": {
"description": "First-to-last change; null when change_note is set because a single step carries it.",
"type": [
"number",
"null"
]
},
"coverage": {
"additionalProperties": false,
"description": "How many of the requested days have a capture, and how to read repeated or sparse values.",
"properties": {
"days_with_data": {
"type": "integer"
},
"note": {
"type": "string"
}
},
"required": [
"days_with_data",
"note"
],
"type": "object"
},
"currency": {
"const": "USD",
"type": "string"
},
"days": {
"type": "integer"
},
"first_usd": {
"type": [
"number",
"null"
]
},
"last_usd": {
"type": [
"number",
"null"
]
},
"links": {
"additionalProperties": false,
"properties": {
"card_page": {
"type": "string"
}
},
"required": [
"card_page"
],
"type": "object"
},
"name": {
"type": "string"
},
"points": {
"description": "Oldest first. Graded series only contain days with sales; gaps are normal.",
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"market_usd": {
"type": [
"number",
"null"
]
}
},
"required": [
"date",
"market_usd"
],
"type": "object"
},
"type": "array"
},
"series": {
"description": "\"raw\" or \"PSA <grade>\"",
"type": "string"
},
"source": {
"type": "string"
},
"variant": {
"description": "The printing the series follows (e.g. \"holofoil\"); other printings are separate markets and are never mixed in.",
"type": [
"string",
"null"
]
}
},
"required": [
"card_id",
"name",
"series",
"variant",
"days",
"coverage",
"currency",
"points",
"first_usd",
"last_usd",
"change_pct",
"change_note",
"source",
"links"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"game": {
"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"
],
"type": "string"
},
"limit": {
"default": 25,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"set_id": {
"description": "Expansion id from list_sets.",
"maxLength": 60,
"minLength": 1,
"pattern": "^[a-zA-Z0-9_.-]+$",
"type": "string"
},
"sort": {
"default": "value",
"description": "\"value\" = most valuable first; \"number\" = checklist order.",
"enum": [
"value",
"number"
],
"type": "string"
}
},
"required": [
"game",
"set_id"
],
"type": "object"
},
"name": "get_set_cards",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cards": {
"items": {
"additionalProperties": false,
"properties": {
"game": {
"type": "string"
},
"id": {
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history.",
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"psa10_market_usd": {
"description": "PSA 10 market price in USD",
"type": [
"number",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"description": "Ungraded (raw) market price in USD",
"type": [
"number",
"null"
]
},
"set": {
"type": [
"string",
"null"
]
},
"url": {
"description": "Card page with the full price ladder and history",
"type": "string"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "integer"
},
"game": {
"type": "string"
},
"set_id": {
"type": "string"
},
"set_name": {
"type": [
"string",
"null"
]
},
"total_cards": {
"type": "integer"
}
},
"required": [
"game",
"set_id",
"set_name",
"total_cards",
"count",
"cards"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"card_id": {
"description": "Catalog card id from search_cards.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"grading_fee_usd": {
"description": "Grading fee to assume. Defaults to a $25 economy tier; the table also shows $50 and $150.",
"maximum": 5000,
"minimum": 0,
"type": "number"
}
},
"required": [
"card_id"
],
"type": "object"
},
"name": "grading_roi",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assumed_fee_usd": {
"type": "number"
},
"break_even_gem_probability": {
"description": "Chance of a PSA 10 needed to break even at the assumed fee; null when grading never breaks even",
"type": [
"number",
"null"
]
},
"captured_on": {
"type": [
"string",
"null"
]
},
"card": {
"additionalProperties": false,
"properties": {
"game": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"set": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"game",
"set",
"number"
],
"type": "object"
},
"currency": {
"const": "USD",
"type": "string"
},
"expected_value": {
"items": {
"additionalProperties": false,
"properties": {
"expected_net_usd": {
"type": "number"
},
"expected_sale_usd": {
"type": "number"
},
"gem_probability": {
"type": "number"
}
},
"required": [
"gem_probability",
"expected_sale_usd",
"expected_net_usd"
],
"type": "object"
},
"type": "array"
},
"gem_premium_multiple": {
"description": "PSA 10 price ÷ raw price",
"type": [
"number",
"null"
]
},
"links": {
"additionalProperties": false,
"properties": {
"card_page": {
"type": "string"
},
"measure_centering": {
"type": "string"
},
"worth_grading": {
"type": "string"
}
},
"required": [
"worth_grading",
"card_page",
"measure_centering"
],
"type": "object"
},
"net_after_fee": {
"items": {
"additionalProperties": false,
"properties": {
"net_usd_by_fee": {
"items": {
"additionalProperties": false,
"properties": {
"fee_usd": {
"type": "number"
},
"net_usd": {
"type": "number"
}
},
"required": [
"fee_usd",
"net_usd"
],
"type": "object"
},
"type": "array"
},
"outcome": {
"type": "string"
},
"sale_usd": {
"type": "number"
}
},
"required": [
"outcome",
"sale_usd",
"net_usd_by_fee"
],
"type": "object"
},
"type": "array"
},
"psa10_usd": {
"type": [
"number",
"null"
]
},
"psa9_usd": {
"type": [
"number",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"top_grade_by_company": {
"items": {
"additionalProperties": false,
"properties": {
"centering_tolerance_back": {
"type": "string"
},
"centering_tolerance_front": {
"type": "string"
},
"company": {
"type": "string"
},
"grade": {
"type": "string"
},
"value_usd": {
"type": "number"
}
},
"required": [
"company",
"grade",
"value_usd",
"centering_tolerance_front",
"centering_tolerance_back"
],
"type": "object"
},
"type": "array"
},
"verdict": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"body": {
"type": "string"
},
"headline": {
"type": "string"
},
"tone": {
"enum": [
"strong",
"conditional",
"weak"
],
"type": "string"
}
},
"required": [
"tone",
"headline",
"body"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"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"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"game": {
"description": "Restrict to one game or sport; omit for all.",
"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"
],
"type": "string"
},
"include_unknown_volume": {
"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.",
"type": "boolean"
},
"limit": {
"default": 15,
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "liquid_movers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"as_of": {
"description": "When this ranking was computed (ISO 8601)",
"type": "string"
},
"cards": {
"items": {
"additionalProperties": false,
"properties": {
"change_pct": {
"type": [
"number",
"null"
]
},
"game": {
"type": "string"
},
"id": {
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history.",
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"psa10_market_usd": {
"description": "PSA 10 market price in USD",
"type": [
"number",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"description": "Ungraded (raw) market price in USD",
"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."
},
"set": {
"type": [
"string",
"null"
]
},
"url": {
"description": "Card page with the full price ladder and history",
"type": "string"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url",
"change_pct",
"sales_per_year"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "integer"
},
"criteria": {
"type": "string"
},
"excluded_unstable": {
"description": "Candidates dropped because their own 40-day raw series did not hold together.",
"type": "integer"
},
"volume_verified": {
"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).",
"type": "boolean"
}
},
"required": [
"as_of",
"criteria",
"count",
"volume_verified",
"excluded_unstable",
"cards"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"game": {
"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"
],
"type": "string"
},
"limit": {
"default": 30,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Optional substring to filter set names, e.g. \"evolving\" or \"2019 prizm\".",
"maxLength": 60,
"type": "string"
}
},
"required": [
"game"
],
"type": "object"
},
"name": "list_sets",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"type": "integer"
},
"game": {
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"sets_index": {
"type": "string"
}
},
"required": [
"sets_index"
],
"type": "object"
},
"sets": {
"items": {
"additionalProperties": false,
"properties": {
"card_count": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"release_date": {
"type": [
"string",
"null"
]
},
"set_id": {
"description": "Pass to get_set_cards or search_cards.set_id",
"type": "string"
}
},
"required": [
"set_id",
"name",
"release_date",
"card_count"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"game",
"count",
"sets",
"links"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"game": {
"description": "Restrict to one game or sport. Omit when unsure.",
"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"
],
"type": "string"
},
"limit": {
"default": 10,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Card name, optionally with set, number or year. Examples: \"Umbreon VMAX Evolving Skies\", \"1986 Fleer Jordan\", \"Charizard base set 4/102\".",
"maxLength": 80,
"minLength": 2,
"type": "string"
},
"set_id": {
"description": "Expansion id from list_sets, to search inside one set.",
"maxLength": 60,
"pattern": "^[a-zA-Z0-9_.-]*$",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_cards",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cards": {
"items": {
"additionalProperties": false,
"properties": {
"game": {
"type": "string"
},
"id": {
"description": "Catalog card id. Pass to get_card_prices, grading_roi or get_price_history.",
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"psa10_market_usd": {
"description": "PSA 10 market price in USD",
"type": [
"number",
"null"
]
},
"rarity": {
"type": [
"string",
"null"
]
},
"raw_market_usd": {
"description": "Ungraded (raw) market price in USD",
"type": [
"number",
"null"
]
},
"set": {
"type": [
"string",
"null"
]
},
"url": {
"description": "Card page with the full price ladder and history",
"type": "string"
}
},
"required": [
"id",
"name",
"game",
"set",
"number",
"raw_market_usd",
"url"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "integer"
},
"matched_on": {
"description": "The search term that produced the results",
"type": "string"
},
"note": {
"type": "string"
},
"query": {
"type": "string"
}
},
"required": [
"query",
"matched_on",
"count",
"cards"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"direction": {
"default": "up",
"description": "\"up\" = biggest gainers, \"down\" = biggest drops.",
"enum": [
"up",
"down"
],
"type": "string"
},
"game": {
"description": "Restrict to one game or sport; omit for all.",
"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"
],
"type": "string"
},
"limit": {
"default": 15,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"min_market_usd": {
"default": 5,
"description": "Ignore cards whose raw price is below this.",
"maximum": 1000,
"minimum": 0.5,
"type": "number"
}
},
"type": "object"
},
"name": "trending_cards",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cards": {
"items": {
"additionalProperties": false,
"properties": {
"basis": {
"description": "Which price series the change refers to",
"enum": [
"PSA 10",
"raw"
],
"type": "string"
},
"change_30d_pct": {
"type": "number"
},
"game": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"number": {
"type": [
"string",
"null"
]
},
"price_30d_ago_usd": {
"type": "number"
},
"price_now_usd": {
"type": "number"
},
"psa10_market_usd": {
"type": [
"number",
"null"
]
},
"raw_market_usd": {
"type": [
"number",
"null"
]
},
"set": {
"type": [
"string",
"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"
],
"type": "object"
},
"type": "array"
},
"count": {
"type": "integer"
},
"criteria": {
"type": "string"
},
"direction": {
"enum": [
"up",
"down"
],
"type": "string"
},
"excluded_unstable": {
"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).",
"type": "integer"
},
"game": {
"type": [
"string",
"null"
]
},
"window_days": {
"const": 30,
"type": "number"
}
},
"required": [
"window_days",
"direction",
"game",
"count",
"excluded_unstable",
"criteria",
"cards"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:f9b34656171fdbaa1fe0c47755f428cd9396014203dcfc8db1d2f6ff2fd6a317 | sha256sum