您需要特定交易卡的时间序列价格,以支持本周的估值、损益或警报工作流程。在本指南结束时,您将通过名称查询卡片,获取其 card_id,并获取特定等级的历史价格,您可以直接将其放入您的财务仪表板或模型中。
您将构建的内容:一个专注的卡片定价管道
本教程使用 Zyla API Hub 上的体育卡和交易卡 API 来:(1) 使用自由文本查询搜索卡片和 (2) 获取给定等级(例如,PSA 10)在选定窗口内的时间序列价格。该 API 返回紧凑的 JSON,易于持久化到您的数据存储中并像其他资产价格系列一样进行分析。
开发人员使用此 API 来支持估值页面、替代资产组合、比较跟踪和价格变动警报。您提供财务逻辑;API 提供可搜索的库存元数据和特定卡片和等级的销售价格时间序列。
在 Zyla API Hub 上开始
打开 API 页面并订阅以获取 API 密钥。Zyla 采用订阅 + 配额模型(不是按调用付费)。第一个 API 通常包括 7 天的试用或 50 次请求;请查看 API 页面以获取当前访问选项和定价。您的授权头将如下所示:Authorization: Bearer YOUR_API_KEY。
- 开始 7 天的体育卡和交易卡 API 试用
- 在 Zyla API Hub 上探索超过 10,000 个公共 API
API 概述和工作流程
此 API 暴露两个端点,您将将它们串联在一起:
- 卡片搜索(GET):通过单个字符串搜索,返回带有元数据和 card_id 字段的匹配卡片数组。
- 获取卡片价格(GET):给定 card_id、等级和时间窗口(天),返回价格和 closing_date 值的 JSON 时间序列。
在财务集成中,第 1 步解析标识符(card_id),类似于股票代码或 CUSIP,第 2 步提取用于分析、图表或风险控制的历史价格系列。
端点:卡片搜索
通过简洁的单字符串查询进行搜索。包括球员和系列详细信息以获得更精确的匹配。该端点返回候选卡片的 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": "//942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1766768512710x492230808547762700/resize",
"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",…
您现在将实际使用的字段:
- description、set、number、variant:确认您拥有正确的卡片。
- card_id:您将传递到定价端点的标识符。
端点:获取卡片价格
获取特定等级的价格,作为选定天数窗口的日期索引系列。使用此方法计算收益、移动平均、回撤或价格警报,就像您对待股票或加密货币一样。
- 方法:GET
- URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
- 所需查询参数:
- card_id(字符串):来自卡片搜索结果。
- 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)。将其视为期末关闭时间戳。
- 价格以字符串形式返回。解析为十进制/大数字以进行财务安全的算术运算。
- Grade 和 card_id 回显您的输入以便于追溯。
将其结合起来:解析 card_id 然后获取价格
1)解析精确的卡片
广泛搜索(例如,“Lebron James”)或包括系列/年份/变体以缩小匹配。选择描述和系列与您的库存匹配的条目,然后复制其 card_id。
2)提取特定等级的时间序列
决定您持有的等级(例如,“PSA 10”)和回顾窗口的天数。调用获取卡片价格端点并绘制 closing_date 与价格,或计算您的财务指标(CAGR、波动率、峰值到谷底回撤、滚动中位数)。
代码:Python 示例以获取和规范化价格
下面的示例调用获取卡片价格端点,以获取 LeBron James 2003 Topps Chrome 篮球(显示的 card_id),在 90 天内获取 PSA 10 的价格,并将值转换为 Pandas 准备好的列表。
import requests
from decimal import Decimal
from datetime import datetime, timezone
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices"
params = {
"card_id": "1586412050491x786559417729941500",
"days": "90",
"grade": "PSA 10",
}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
series = []
for row in data:
# closing_date 是 ISO 8601 格式的 UTC("...Z")
dt = datetime.fromisoformat(row["closing_date"].replace("Z", "+00:00")).astimezone(timezone.utc)
# price 是字符串;使用 Decimal 避免财务代码中的浮点舍入
px = Decimal(row["price"])
series.append({"ts": dt, "price": px, "grade": row["Grade"], "card_id": row["card_id"]})
# 示例:如果可用,计算最后两个观察值之间的简单收益
if len(series) >= 2:
p0, p1 = series[-2]["price"], series[-1]["price"]
simple_return = (p1 - p0) / p0 if p0 != 0 else Decimal("0")
print(f"最后的简单收益:{simple_return:.6f}")
else:
print("返回的数据点不足")
提示:
- 使用 Decimal/BigInt 类型而不是浮点数进行价格计算。
- 始终将时间戳视为 UTC,并在应用程序的边缘进行一次转换。
您本周可以交付的财务级用例
- 替代资产的投资组合估值:每个持有的 card_id 存储;夜间作业刷新您头寸的 PSA 10 价格系列。
- 价格变动警报:将最新价格与 20 个会话的中位数进行比较,并在偏差时触发 Slack/电子邮件警报。
- 比较和公允价值:提取同一球员在不同系列/年份的多个 card_id 系列,以计算相对价值或 z 分数。
- 风险控制:监控过去 N 天的回撤,如果回撤超过阈值,则限制购买规则。
- 报告:生成每月标记、已实现/未实现的损益,以及按资产的贡献,以供投资者更新。
节省时间的操作细节
- 身份验证:每个请求的 Authorization: Bearer YOUR_API_KEY。
- 时间戳:closing_date 是 ISO 8601 UTC(“Z”)。与您系统的时区政策保持一致。
- 数字:价格是字符串;解析为 Decimal 以进行财务计算。有效负载中未指定货币;在您的应用程序上下文中一致地显示/假设。
- 缓存:如果您频繁渲染仪表板,请缓存最近的响应几分钟,以减少相同的提取。
- 回填:对于历史分析,一次提取更大的天数窗口,然后按计划以较小的窗口增量刷新。
通过 MCP 从 AI 代理调用 API
如果您使用 Claude Code、Cursor、Windsurf 或其他兼容 MCP 的客户端,您可以通过 Zyla 的 MCP 端点路由调用。提供您的 API 密钥,并让代理请求上述文档中相同的 Hub URL,使用相同的授权头语义。
- MCP 端点: MCP
- 确保代理的出站请求使用:
- GET https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search,带有搜索
- GET https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices,带有 card_id、days、grade
- 头:Authorization: Bearer YOUR_API_KEY
这使您可以直接在 IDE 的代理中提示“获取此 card_id 的 PSA 10 价格,持续 90 天”,并将输出粘贴到您的分析中。
您可以复制的端到端示例流程
- 搜索并选择确切的卡片:
- 使用提供的卡片搜索 cURL 查找“LeBron James 2003 Topps Chrome 篮球”。
- 复制其 card_id:1586412050491x786559417729941500。
- 提取特定等级的价格系列:
- 使用 grade=PSA 10 和 days=90 运行提供的获取卡片价格 cURL。
- 存储 closing_date 和价格以用于图表和计算。
- 计算财务指标:
- 在 N 天内的收益、滚动波动率和从峰值到谷底的回撤。
- 当价格穿越移动平均线或突破阈值时发出警报。
为什么选择 Zyla API Hub 进行替代资产定价
一个帐户和一个 API 密钥解锁对超过 10,000 个公共 API 的访问。您在端点之间获得一致的订阅 + 配额模型、集中式 API 密钥,以及包括直接 REST 和基于 MCP 的代理调用的集成选项。在 zylalabs.com 上浏览目录,并将额外数据集插入您的财务堆栈,而无需为每个服务启动新的身份验证流程。
常见问题解答
我如何找到我持有的正确 card_id?
使用卡片搜索端点,进行紧密查询,包括球员、年份、系列和变体。确认描述、系列和编号与您的物品匹配,然后复制返回的 card_id。
closing_date 时间戳使用什么时区?
它们是带有尾随 Z 的 ISO 8601,表示 UTC。在您的摄取中标准化为 UTC,然后在需要时转换以进行显示。
价格是数字还是字符串?
API 将价格作为字符串返回。在执行财务计算之前解析为 Decimal 或 BigNumber 类型,以避免浮点舍入问题。
我可以访问同一张卡的不同等级吗?
可以。使用相同的 card_id 和不同的等级值(例如,PSA 10)来检索另一等级的时间序列。
访问选项是什么?
Zyla 采用订阅 + 配额(不是按调用付费)。对于您的第一个 API,您通常可以开始 7 天的试用或 50 次请求。请查看 API 页面以获取当前访问选项和定价。
准备好交付您的卡片定价集成了吗?在项目页面上订阅并获取您的 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",…