卡片搜索的API

您需要在本周推出一个面向金融的卡片搜索和定价功能——想想体育卡的搜索即输入即得，以及您可以图表化并用于估值的最近销售价格。在本篇文章结束时，您将能够使用来自Zyla API Hub的生产就绪端点搜索交易卡并提取时间序列价格，将它们连接到您的定价或投资组合逻辑中，甚至可以通过MCP从AI代理调用它们。

此API为金融工作流提供的功能

体育卡和交易卡API返回可搜索的卡片元数据和时间序列价格数据。为替代资产构建金融风格应用程序的开发人员——投资组合跟踪器、价格警报、估值仪表板或分析——使用它来：

将自由文本搜索（“Lebron topps chrome rc psa 10”）解析为干净的标识符，包括稳定的card_id和集合元数据。
按卡片和等级查询最近价格，以支持图表、风险评分和市值计算。

所有调用都在 Zyla API Hub 上运行，该平台提供一个账户、一个API密钥，以及一个订阅+配额模型，涵盖超过10,000个公共API。对于此API，您可以从其市场页面开始7天的试用，然后继续在订阅和配额下使用（无按调用付费）。

在Zyla API Hub上开始

打开API的市场页面并开始试用：在体育卡和交易卡API上开始7天试用。
点击订阅或开始免费试用（可用时）以获取您的API密钥。
向以下端点发送请求，带上头部Authorization: Bearer YOUR_API_KEY。

如果您是Zyla的新用户，您还可以在 zylalabs.com 浏览类别并管理订阅。该订阅使用配额，而不是按调用付费。有关当前访问选项和定价，请查看API页面。

端点：卡片搜索

搜索交易卡，使用模糊匹配并接收候选者的JSON列表及元数据。这是您从用户的自由文本查询到可以用于定价提取的规范card_id的解析器。

方法：GET
URL：https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
查询参数：
- search（字符串，必需）：Lebron James

cURL请求

curl -s -X GET "https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search?search=Lebron+James" \
-H "Authorization: Bearer YOUR_API_KEY"

官方JSON示例

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

您将在金融上下文中使用的关键字段：

card_id：用于提取价格并在您的数据存储中连接的稳定标识符。
description、set、number、variant：投资组合行和估值报告的规范标签。
image：在价格图表和头寸旁边渲染缩略图。

Python示例：搜索、选择卡片并准备定价

import requests

API_KEY = "YOUR_API_KEY"
q = "Lebron James"

resp = requests.get(
"https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search",
params={"search": q},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30,
)
resp.raise_for_status()
cards = resp.json()

# 选择具有清晰集合/编号的候选者，保留其card_id以进行定价
for c in cards:
print(f"{c.get('description')} | #{c.get('number')} | id={c.get('card_id')}")
# 示例下游选择：
target = next((c for c in cards if c.get('card_id') == "1586412050491x786559417729941500"), None)
if target:
print("选择：", target["description"], "->", target["card_id"])

端点：获取卡片价格

提取特定卡片和等级的最近价格点。使用卡片搜索中的card_id进行查询。结果是适合图表、移动平均、趋势检测和投资组合估值管道的时间序列。

方法：GET
URL：https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
查询参数：
- card_id（字符串，必需）：1586412050491x786559417729941500
- days（字符串，必需）：90
- grade（字符串，必需）：PSA 10

cURL请求

示例JSON

[
{
"closing_date": "2026-08-03T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "16150.00"
},
{
"closing_date": "2026-08-01T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "18250.00"
},
{
"closing_date": "2026-07-31T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17900.00"
},
{
"closing_date": "2026-07-27T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17303.00"
},
{
"closing_date": "2026-07-21T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "17373.00"
},
{
"closing_date": "2026-07-17T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",
"price": "15337.20"
},
{
"closing_date": "2026-07-15T23:59:00.000Z",
"Grade": "PSA 10",
"card_id": "1586412050491x786559417729941500",…

金融实现的注意事项：

closing_date是带有Z后缀的ISO 8601时间戳（UTC）。在UTC上对齐您的图表和缓存失效，以避免一天的偏差问题。
price是字符串化的数值。解析为适合您堆栈的十进制/数字类型，以避免浮点舍入错误。
Grade是字符串，例如“PSA 10”；用于标签和强制特定等级的估值规则。

组合：从搜索到价格系列

典型流程：

调用卡片搜索，使用用户的输入。
让用户确认确切的卡片（集合、编号、变体）。
使用返回的card_id与获取卡片价格进行所需等级和回顾窗口的查询。
计算指标：7/30/90天平均值、波动率近似、回撤和百分比变化。

节省时间的实用集成细节

授权：在每个请求中传递Authorization: Bearer YOUR_API_KEY。
缓存：对于价格端点，通常每个card_id和等级的短缓存窗口（例如，每小时）对于仪表板是足够的，同时减少配额使用。
时区：将closing_date视为UTC。在按天/周分组之前，将所有下游计算标准化为UTC。
搜索用户体验：在输入更改时发出卡片搜索，并进行小的防抖（例如，200–300毫秒）。在您的头寸中持久化所选的card_id。
错误处理：优雅地显示“没有结果”；允许高级用户通过添加集合、年份和卡片编号来细化查询。

示例：构建卡片估值小部件

以下是您可以连接到金融仪表板的最小两步流程：

搜索“Lebron James”，列出候选者及其描述、集合、编号和card_id。
当用户选择“2003 Topps Chrome Basketball #111” card_id 1586412050491x786559417729941500并选择等级“PSA 10”时，获取90天价格系列并绘制它。将最新价格持久化为您头寸的估值。

由于API返回干净的标识符和时间戳，您可以使用现有的投资组合代码路径计算滚动平均值和盈亏。

通过MCP从AI代理调用API

如果您希望通过AI代理（例如Claude Code、Cursor、Windsurf）协调搜索和价格调用，您可以通过Zyla的MCP端点路由它们。将您的MCP兼容客户端指向：

MCP

使用您的Zyla API密钥，并让代理调用上述两个HTTPS端点，使用相同的Authorization头和查询参数。这允许代理在单个工具调用序列中解析card_id并提取价格时间序列。

您本周可以推出的金融相关用例

市值投资组合：每个头寸存储card_id和等级；通过获取卡片价格刷新并计算未实现的盈亏。
价格警报：当最新价格超过阈值或偏离移动平均X%时触发通知。
在观察列表中估值卡片：搜索一次，固定card_id，并在类似于股票代码的瓷砖旁边呈现当前和滞后价格。
风险仪表板：从时间序列中推导出滚动波动率，以进行特定等级的风险评分，涵盖替代资产。

故障排除和验证

空或嘈杂的搜索：通过年份、集合或卡片编号丰富搜索字符串，以收紧模糊匹配。
多个变体：在您的用户界面中呈现变体和集合类型，以便用户在定价之前选择正确的。
小数：将价格解析为Decimal/BigNumber，以避免投资组合总额中的舍入漂移。
数据刷新频率：如果您快照每日NAV，请按closing_date（UTC）分组，以保持一致的每日条形图。

管理访问和配额的地方

所有访问通过Zyla API Hub根据订阅+配额模型（无按调用付费）进行配置。首次访问通常从7天的试用或50个请求开始。有关可用性和确切细节，请使用API的项目页面。您可以在 zylalabs.com 上查看和管理您在各个类别中的订阅。

常见问题

我使用什么头部进行身份验证？
在每个请求中使用Authorization: Bearer YOUR_API_KEY。

我如何获取特定卡片的价格？
首先通过卡片搜索解析卡片以获取card_id，然后使用card_id、days和grade调用获取卡片价格。

时间戳的时区是什么？
closing_date值为UTC（Z后缀ISO 8601）。将您的分析标准化为UTC，以避免边界问题。

我可以直接从响应中绘制价格图表吗？
可以。遍历数组，将价格解析为数值类型，并按closing_date升序绘制。

是否有免费计划？
访问基于订阅+配额。请查看API页面以获取当前访问选项和定价；您可以从项目页面开始7天的试用。

准备好将卡片搜索和定价添加到您的金融应用程序中吗？开始试用，获取您的密钥，并立即推出集成：体育卡和交易卡API。

官方API响应

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

官方API响应

[
{
"description": "LeBron James 2003 Topps Basketball",
"player": "Lebron James",
"set": "2003 Topps Basketball",
"number": "221",
"variant": "Base",
"card_id": "1588290260620x609083468203688000",
"image": "//s3.amazonaws.com/appforest_uf/f1588290324330x374737296708651100/2003-Topps-Basketball-LeBron-James-graded.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Basketball"
},
{
"description": "LeBron James 2003 Upper Deck Rookie Exclusives Basketball",
"player": "Lebron James",
"set": "2003 Upper Deck Rookie Exclusives Basketball",
"number": "1",
"variant": "Base",
"card_id": "1593982609906x272877681796710400",
"image": "//s3.amazonaws.com/appforest_uf/f1593982606419x316822824595257800/2003-Upper-Deck-Rookie-Exclusives-Lebron-James-1.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Upper Deck Rookie Exclusives Basketball"
},
{
"description": "LeBron James 2025 Topps Chrome Cactus Jack Basketball",
"player": "LeBron James",
"set": "2025 Topps Chrome Cactus Jack Basketball",
"number": "46",
"variant": "Base",
"card_id": "1782184797693x851477815192830800",
"image": "//s3.amazonaws.com/appforest_uf/f1598843985116x489100344198574160/05-Basketball.jpg",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Cactus Jack Basketball"
},
{
"description": "LeBron James 2003 Topps Chrome Basketball",
"player": "Lebron James",
"set": "2003 Topps Chrome Basketball",
"number": "111",
"variant": "Base",
"card_id": "1586412050491x786559417729941500",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"category": "Basketball",
"category_group": "Sports Cards",
"set_type": "Topps Chrome Basketball"
},
{
"description": "LeBron James 2024 Panini Prizm Basketball",
"player": "LeBron James",
"set": "2024 Panini Prizm Basketball",
"number": "130",
"variant": "Base",
"card_id": "1740403688997x505339465151470000",
"image": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1757384268822x692013733346557700/resize",…

准备使用 Zyla API HUB？

立即尝试！

卡片搜索的API

此API为金融工作流提供的功能

在Zyla API Hub上开始

端点：卡片搜索

cURL请求

官方JSON示例

Python示例：搜索、选择卡片并准备定价

端点：获取卡片价格

cURL请求

示例JSON

组合：从搜索到价格系列

节省时间的实用集成细节

示例：构建卡片估值小部件

通过MCP从AI代理调用API

您本周可以推出的金融相关用例

故障排除和验证

管理访问和配额的地方

常见问题

准备使用 Zyla API HUB？

相关文章

最近文章

面向 API 提供商

Zyla API Hub VS

Marketplace

公司

联系我们

卡片搜索的API

此API为金融工作流提供的功能

在Zyla API Hub上开始

端点：卡片搜索

cURL请求

官方JSON示例

Python示例：搜索、选择卡片并准备定价

端点：获取卡片价格

cURL请求

示例JSON

组合：从搜索到价格系列

节省时间的实用集成细节

示例：构建卡片估值小部件

通过MCP从AI代理调用API

您本周可以推出的金融相关用例

故障排除和验证

管理访问和配额的地方

常见问题

准备使用 Zyla API HUB？

相关文章

使用 SWIFT - IBAN - 路由银行检查器 API

获取视频转录的API

使用路由银行号码检查器API

获取卡片价格的API

用于路由号码查找的API

使用体育卡和交易卡API

搜索

相关文章

最近文章

面向 API 提供商

Zyla API Hub VS

Marketplace

公司