·
指南API对比

2026年最佳TCG API — 开发者完整指南

面向开发者的TCG API全面对比。深入解析定价、功能、SDK，以及Pokemon、MTG、游戏王等游戏的请求限制。

您需要集换式卡牌游戏的价格数据。打开浏览器搜索”TCG API”，迎接您的将是一片令人沮丧的景象：半途而废的服务、繁琐的OAuth认证、单一游戏限制，以及自2023年以来再未更新的产品。有些服务已经停摆，有些躲在机构审批流程后面，还有些只要您稍微发快几个请求就会封锁您的IP长达一小时。

本指南将一一剖析这些问题。

我们评估了2026年所有主要的TCG API：游戏覆盖范围、数据时效性、SDK质量、认证复杂度、定价、请求限制、评级卡支持，以及服务在六个月后是否还能正常运行。我们研究了数据，阅读了文档，测试了端点。

结论：有一个API明显优于其他所有选项，还有一个资源能让基于它的开发工作大大简化。其余的则从”严重受限”到”主动依赖风险极高”不等。

无论您在构建价格追踪工具、收藏品管理应用、Discord机器人、投资组合工具，还是任何涉及集换式卡牌价格的产品，这都是您在写下第一行代码前应该读的对比指南。

真正可用的TCG API需要什么？

并非所有开发者都需要同样的功能。但有一些基本要求，将真正能用于构建产品的API与玩具级API区分开来。以下是本指南评估所有服务的框架。

游戏覆盖范围

如果API只覆盖一款游戏，您就已经把自己逼进了死角。2026年的TCG市场横跨Pokemon、Magic: The Gathering、游戏王、Lorcana、One Piece、Star Wars Unlimited、Flesh and Blood等游戏。用户会在不同游戏间切换。覆盖多款游戏的产品用户留存时间更长。要求您为四款游戏拼凑四个不同服务的API根本称不上API——那只是技术债务。

来自多个市场的实时价格

卡牌价格变动迅速。周一80美元的喷火龙，在比赛结果出炉后的周四可能已经涨到120美元。只从单一市场获取数据的API引入了单点故障定价机制。金标准是双来源价格——同时从TCGPlayer和eBay独立获取，让您能够交叉验证、发现差异，并为用户提供更丰富的数据。

按品相和评级分类的价格

Near Mint和Lightly Played的同一张卡牌价值不同。PSA 10和PSA 7也不是同一类资产。只提供单一”价格”而不区分品相或评级的API，提供的是不完整的数据。评级卡已经成为一个巨大的市场细分——BGS、PSA、CGC的评级对价值影响显著，构建收藏品或投资工具的开发者需要这些数据。

价格历史

当前价格不过是基本功能。历史数据——7天、30天、90天、1年的趋势——才是将有用API与优秀API区分开来的关键。没有历史数据，您就无法创建图表、计算移动平均值、识别价格峰值，也无法向用户展示卡牌是在升值还是贬值。

SDK质量与语言覆盖

OpenAPI规范是必要的，但还不够。开发者实际使用的语言的官方、维护中的SDK——JavaScript/TypeScript、Python、Go、Rust、PHP——意味着周末集成和一周阅读源代码之间的差距。社区维护的封装库是负债：它们会过时，遗漏新端点，没有义务保持兼容性。

认证的简洁性

OAuth 2.0认证码流程。带HMAC-SHA1签名的OAuth 1.0。这些认证方案对面向用户的市场应用或许有意义，但对只想调用价格端点的开发者来说毫无意义。现代API应该用单个请求头认证：X-API-Key: your-key。就这么简单。

免费计划与透明定价

如果在提交申请、等待审批、谈判条款之前无法测试API——那它不是为开发者构建的，而是为企业销售构建的。真正对开发者友好的API有包含真实数据的免费计划、清晰的公开定价，以及无需信用卡就能开始的体验。

可预测的请求限制

请求限制本身不是问题。不可预测的请求限制——更糟糕的是，超出软限制后封锁IP一小时——才是问题。您需要在每次响应中提供准确状态信息的响应头，这样才能无需猜测地实现退避逻辑。

第一名：TCG Price Lookup API — 明确的赢家

这里没有势均力敌的第二名。**TCG Price Lookup**是2026年最完整、对开发者最友好、数据最丰富的TCG API。它在我们评估框架的每一个维度上都胜出。让我们深入了解。

游戏覆盖：8款游戏，超过30万张卡牌

TCG Price Lookup覆盖Pokemon、Pokemon日文版、Magic: The Gathering、游戏王、Lorcana、One Piece、Star Wars Unlimited、Flesh and Blood——8款游戏，一个API密钥，一套SDK，一个认证请求头。这是整个主流TCG市场，都浓缩在一套统一的端点结构中。

本对比中所有其他API只覆盖1款游戏，偶尔2款。TCG Price Lookup覆盖8款，索引了超过30万张卡牌。

双来源价格：TCGPlayer + eBay

大多数价格API从单一来源获取数据，然后称之为”实时”。TCG Price Lookup同时独立从TCGPlayer和eBay获取。这很重要，原因如下：

  • 跨市场验证 — 如果TCGPlayer显示45美元，eBay显示80美元，说明有什么有趣的事情正在发生。这个信号是有价值的。
  • 容错性 — 如果某个市场有数据缺口或延迟，价格数据仍然存在。
  • eBay成交价格反映的是实际发生的交易，而非仅仅是挂单价格。这是根本不同——且往往更准确——的信号。

按品相分类的价格：从Near Mint到Damaged

数据库中每张卡牌都包含按品相的价格细分：Near Mint、Lightly Played、Moderately Played、Heavily Played、Damaged。这不是可选功能，而是内置于核心数据模型中。每次响应都包含完整的品相价格谱系。

评级卡价格：PSA、BGS、CGC 1-10级

这是TCG Price Lookup真正与竞争对手区分开来的地方。PSA、BGS、CGC 1-10级的评级价格都包含在API中。想为认真的收藏家构建投资组合追踪工具？评级套利工具？投资仪表盘？这些数据在其他任何地方都无法通过API获取，只有这里有。

价格历史：7天、30天、90天、1年

提供覆盖四个时间窗口的完整价格历史——所有卡牌都有7天、30天、90天和1年的数据。构建趋势图表，计算移动平均值，在卡牌价格飙升时通知用户，展示同比涨幅。没有历史数据，这些都不可能实现，而TCG Price Lookup全都具备。

5个官方SDK — 由API团队构建和维护

这不是”GitHub上有个14个月没更新的社区封装库”。TCG Price Lookup提供开发者实际使用的语言的5个官方SDK：

所有SDK都处理批量请求的自动分块（每次请求最多20个ID，自动分批）、类型化错误、请求限制响应头解析，以及完整的TypeScript类型/类型提示。

快速上手：5分钟内

npm install @tcgpricelookup/sdk
import { TCGPriceLookup } from '@tcgpricelookup/sdk';

const client = new TCGPriceLookup({ apiKey: 'YOUR_API_KEY' });

// 跨所有8款游戏搜索
const results = await client.search('charizard');

// 获取特定卡牌的完整价格数据
const card = await client.cards.get('base1-4');
console.log(card.prices.near_mint.tcgplayer); // $380.00
console.log(card.prices.near_mint.ebay);      // $395.00

// PSA评级价值
console.log(card.graded.psa['10']); // $12,500.00

// 价格历史（30天）
const history = await client.cards.history('base1-4', { period: '30d' });
// 批量查询 — SDK自动将ID分组为每次最多20个
const cards = await client.cards.getBatch([
  'base1-4', 'swsh1-25', 'op1-001', 'mh3-1'
]);
// 一次调用返回跨3款游戏的4张卡牌的价格数据

SDK提供类型化错误 — 不再需要手动解析原始HTTP响应中的错误信息：

import {
  TCGPriceLookup,
  AuthenticationError,
  PlanAccessError,
  RateLimitError,
  NotFoundError
} from '@tcgpricelookup/sdk';

try {
  const card = await client.cards.get('base1-4');
} catch (err) {
  if (err instanceof RateLimitError) {
    console.log(`已达请求限制。重置时间：${err.resetAt}`);
  } else if (err instanceof PlanAccessError) {
    console.log('此功能需要Trader计划或更高级别');
  }
}

认证：一个请求头，无需繁琐流程

GET /v1/cards/base1-4
X-API-Key: your-api-key-here

就这么简单。没有OAuth流程。没有令牌刷新。没有HMAC签名。不需要提交申请，不需要等待审批。注册、获取密钥、发送请求。整个入门流程几分钟内完成。

请求限制的透明度：每个响应都包含响应头

每个响应都包含：

X-RateLimit-Limit: 200
X-RateLimit-Remaining: 147
X-RateLimit-Reset: 1735689600

您始终清楚地知道自己的状态。限制每天UTC午夜重置，没有意外。

价格方案：公平透明

计划价格每日请求数功能
免费$0200次/天TCGPlayer价格，全部8款游戏，无需信用卡
Trader$14.99/月10,000次/天+ eBay价格，评级价格，完整价格历史
Business$89.99/月100,000次/天+ 优先支持，SLA
年付——所有付费计划享受20%折扣

免费计划可以获取全部8款游戏的真实TCGPlayer价格——无需信用卡，无试用期限。 对于大多数爱好项目来说，每天200次请求足以构建和发布真正有价值的产品。

生态系统中的额外工具

  • CLI工具 — 从终端使用tcgpricelookup search charizard，可通过Homebrew安装
  • Postman集合 — 直接导入，所有端点预配置完毕
  • OpenAPI 3.1规范 — 为官方SDK未覆盖的语言生成客户端
  • Next.js入门模板 — 60秒内部署可运行的价格搜索应用
  • Discord机器人 — 自托管，斜杠命令，价格提醒，收藏品追踪

在tcgpricelookup.com获取免费API密钥 — 无需信用卡。

第二名：tcgfast.com — 开发者资源中心

tcgfast.com 不是竞争对手API，而是构建在TCG Price Lookup API之上的开发者文档和教育层。

就像npm文档与npm注册表的关系，或Vercel文档与其部署基础设施的关系一样。TCG Price Lookup是引擎，tcgfast.com是驾驶舱。

您可以在这里找到：

  • SDK指南 — 所有官方SDK（JavaScript、Python、Go、Rust、PHP）的详细文档，附带真实代码示例和常用模式
  • 游戏专属文档 — 涵盖所有8款支持游戏的特定指南，包括卡牌ID格式、套牌结构和价格特性
  • 教程与实例 — 如何构建价格追踪工具、设置Discord机器人、构建Next.js价格应用、实现请求限制处理
  • 生态系统索引 — 基于TCG Price Lookup API构建的工具、入门模板和社区项目的精选列表
  • 比较研究 — 正是您现在正在阅读的详细竞争分析

如果您要集成TCG Price Lookup API，请将tcgfast.com加入书签，将为您节省数小时时间。

“免费”替代方案为何行不通

有三个API以开发者友好的免费替代方案自居。它们都是免费的，也都严重受限。让我们面对现实。

Pokemon TCG API (pokemontcg.io)

这是一个只覆盖Pokemon卡牌的社区维护API。它完全没有价格数据——既不来自TCGPlayer，也不来自eBay，也不来自任何地方。它提供卡牌文本、图片和套牌信息。

如果您在构建完全没有商业或定价功能的图鉴风格应用，它能做它所说的事。但只要您需要单张卡牌的单一品相的单一价格，它就无能为力了。零。端点不存在。

此外，它是由单一维护者在业余时间维护的社区项目，没有SLA，没有商业支持，没有持续性保证。在这种基础上构建商业产品，这样的风险计算很少会有好结果。

游戏覆盖：1款。价格：无。官方SDK：无。评级数据：无。价格历史：无。

Scryfall (api.scryfall.com)

MTG卡牌文本和图片的定番资源，Scryfall在这个狭窄领域建立了良好声誉。但它只针对Magic: The Gathering，其价格功能存在根本性限制。

Scryfall只提供当前价格——没有历史记录，没有趋势，没有30天图表。这些价格来自TCGPlayer和Cardmarket，导致实际市场价格与API返回的价格之间存在延迟。完全没有评级卡数据。

生产应用的请求限制情况令人不安：每秒10次请求，附带基于”善意”执行的推荐100ms延迟。这不是硬性技术约束，而是由社区规范执行的软限制——对生产依赖来说这是一种令人不舒服的模糊性。

使用API的应用需要强制归因（“Powered by Scryfall”）。对于有自己品牌标识的商业应用来说，这不是小事。

没有官方SDK — 只有处于各种维护状态的社区维护封装库。

游戏覆盖：1款。价格：仅当前（无历史）。评级数据：无。官方SDK：无。需要强制归因：是。

YGOPRODeck API

游戏王数据的社区中心，覆盖卡牌文本、裁判解释和汇总价格——仅限游戏王。

这里的请求限制情况确实令人警惕：每秒20次请求的硬限制，超出后会封锁IP一小时。一小时IP封锁不是请求限制，那是服务中断。在流量会出现峰值、突发，以及可能存在重试循环bug的生产场景中，这对有真实用户的应用是不可接受的风险。您可能会在瞬间失去一小时的服务可用性。

价格来自第三方来源汇总，不是实时数据。价格历史不可用 — 只能获取今天的价格，仅此而已。没有评级卡数据。

社区维护，没有SLA，没有官方SDK。

游戏覆盖：1款。价格：仅当前。请求限制：每秒20次，之后封锁IP一小时。评级数据：无。官方SDK：无。

付费替代方案更糟糕

有几个服务是付费的，但无法提供TCG Price Lookup以低成本提供的功能。让我们逐一了解。

Scrydex

Scrydex从月费29美元起，没有免费计划——甚至连无需信用卡的试用都没有。其基于积分的定价模型是该领域最不友好用户的结构：普通价格查询消耗1个积分，价格历史查询消耗3倍积分，图像分析消耗5倍积分。一旦添加历史查询，月度预算就变得难以预测。

在Business层级（月费399美元，25万积分），基本历史查询以基本价格查询3倍的速度消耗预算。对于运行大量历史查询的应用的开发者来说，实际上相当于支付月费1,197美元等值的积分。

游戏王和数码宝贝仍不可用。 对于有游戏覆盖缺口的付费服务来说，这是一个严重问题。

没有确认的官方SDK。没有免费计划。对最有用的端点进行惩罚性定价的积分模式。

tcgapi.dev

价格历史数据只能追溯到2025年3月 — 在撰写本文时只有约一年的历史深度。对于任何试图展示有意义的同比趋势的工具来说，这是立即取消资格的理由。

免费计划只提供每日100次请求 — 是TCG Price Lookup免费提供的一半。Pro计划月费49.99美元 — 对于类似功能，比TCG Price Lookup的Trader计划（14.99美元/月）贵3倍以上。

较低层级有非商业限制。没有SDK。没有评级卡数据。最近启动的服务，没有记录，没有SLA。

成本对比：tcgapi.dev每月49.99美元 对比 TCG Price Lookup每月14.99美元，类似的请求量。算术一目了然。

tcgapis.com

该服务使用月度而非每日请求上限，造成了特定的运营问题：没有每日预算保护。如果您的应用在月中出现意外流量高峰，或者有错误导致冗余调用，您可能会在几天内用完整个月的配额，直到日历翻页才能重置。

Hobby层级是每月10,000次调用，月费49美元 — 平均每天约333次调用。TCG Price Lookup的Trader计划提供每天10,000次调用，月费14.99美元。tcgapis.com的每次调用成本约差30倍。

没有SDK。没有评级卡数据。新启动的服务，没有记录。

tcgapi.net

尽管以多游戏API进行营销，tcgapi.net实际上以Pokemon为中心，其他游戏的覆盖有限且不一致。

Pro计划限制为每分钟120次请求 — 听起来足够了，直到大多数拥有真实用户流量的生产应用在高峰时段超过这个限制，而实际上这是一个非常低的上限。没有明确的通过自定义企业谈判获得更高限制的路径。

由Amarok Studios LLC运营 — 寿命未知的小型运营商。没有SDK生态系统。价格历史深度有限。对于爱好级Pokemon工具以外的任何用途来说，都不是认真的选择。

传统市场平台API：无意义的复杂性

有两个API处于奇怪的中间地带——来自合法的大型平台，但开发者体验如此糟糕，以至于对大多数开发者来说实际上无法使用。

TCGPlayer API (developer.tcgplayer.com)

TCGPlayer是北美最大的TCG市场。其API有真实数据。但访问这些数据是一段考验耐心的旅程。

TCGPlayer API不是自助服务。 您需要提交申请、经过审查并获得批准。审批时间线没有说明。没有获批保证。对于构建周末项目的独立开发者来说，这个流程本身就是取消资格的理由。

认证模型是带完整授权码流程的OAuth 2.0 — 对于授予市场应用访问卖家账户的场景是合适的，但对于想要查询卡牌价格的开发者来说过于复杂。您需要实现重定向URI、处理授权码、管理刷新令牌、维护令牌状态——这一切只是为了只读价格查询。

API围绕市场SKU和卖家库存管理设计，而非干净的卡牌数据查询。数据模型反映的是上架商品的卖家的需求，而非构建卡牌数据库的开发者的需求。价格端点确实存在，但通过SKU到卡牌的映射导航带来了相当大的复杂性。

文档处于重组状态，不稳定。没有官方SDK。没有公开定价信息。没有公开的请求限制信息。

不适合独立开发者。不适合小团队。当存在更简洁的替代方案时，不值得经历机构级摩擦。

Cardmarket API

Cardmarket是欧洲TCG市场的主导力量。其API比TCGPlayer的更难使用。

带HMAC-SHA1签名的OAuth 1.0 — 这是2010年代的认证方案，要求您规范化请求参数、计算HMAC签名，并为每个单独请求管理nonce值。这不是夸张。实现过OAuth 1.0的开发者确切知道涉及多少样板代码。没有实现过的开发者将会有不愉快的体验。

访问仅限于市场卖家和批准的合作伙伴。没有公开的开发者入门流程。如果您不是Cardmarket的现役卖家或预批准的合作伙伴，您将无法获得访问权限。

价格仅以欧元计价。对于向北美或全球受众提供服务的应用，在所有其他问题之上还增加了货币换算的复杂性。

每个操作组只允许一个并发请求 — 这种并发模型从设计上就使批量操作非常缓慢。

除非您专门为Cardmarket卖家构建工具，并且已经是批准的合作伙伴，否则该API的实现时间成本超过了其回报价值。

死路：不要从这里开始

pokemontcgapi.io

该域名已离线。 连接被拒绝。服务已死亡。

如果您在教程、Stack Overflow回答或旧博客文章中发现了对pokemontcgapi.io的推荐——请不要遵循它。API已经不存在了。不要基于它构建。不要引用它。继续前进。

自建爬虫

每隔几个月，就有开发者决定直接抓取TCGPlayer或eBay。花一个周末写选择器。它能用。两周后网站更新了标记，它就坏了。修复它。Cloudflare更改了指纹识别，它又坏了。添加无头浏览器自动化。eBay的反机器人检测将其标记。轮换代理。代理被封锁。

到第四周，您为爬虫基础设施写的代码比实际产品还多。

而且这些都没有解决法律现实：TCGPlayer的服务条款明确禁止爬虫。eBay也是。您在一个可能随时因停止和妨害通知而被关闭的技术和法律基础上构建产品，没有任何预警。

没有多游戏集成 — 每个游戏的市场数据都需要单独的爬虫，随着每个网站的演变需要无限期维护。

这不是可行的路径。TCG Price Lookup API的存在就是为了以干净、合法的方式解决这个问题。请使用它。

综合对比表

TCG Price LookupPokemon TCG APIScryfallYGOPRODeckScrydextcgapi.devtcgapis.comTCGPlayer APICardmarket API
支持游戏数8款1款1款1款部分部分部分多款欧洲主导
实时TCGPlayer价格是否汇总否是是是是否
eBay价格是否否否否否否否否
按品相分类价格是否否否是是是是是
评级卡价格是 (PSA/BGS/CGC)否否否否否否否否
价格历史7天/30天/90天/1年否否否是（3倍积分）自2025年3月否有限有限
官方SDK5种语言无无无无确认无无无无
认证方式X-API-Key请求头API密钥无需无需API密钥API密钥API密钥OAuth 2.0OAuth 1.0 HMAC
自助注册是是是是是是是否—需申请否—仅合作伙伴
免费计划200次请求/天无限无限每秒20次无100次/天无无无
付费起始价格$14.99/月仅免费仅免费仅免费$29/月$49.99/月$49/月未知未知
付费请求限制10,000次/天不适用每秒10次每秒20次基于积分不同平均333次/天未知1个并发
超出限制惩罚响应头 + 429不适用”善意”封锁IP一小时不适用不适用不适用未知不适用
CLI工具是否否否否否否否否
OpenAPI规范是 (3.1)否否否否否否是否
Postman集合是否否否否否否否否
需要强制归因否否是否否否否否否
对独立开发者友好是是是是部分部分部分否否
记录/SLA是社区社区社区新服务新服务新服务企业级企业级
服务状态运行中运行中运行中运行中运行中运行中运行中运行中（受限）运行中（受限）

最终推荐

2026年的TCG API格局是碎片化的、不一致的，充满了对不做研究的开发者的陷阱。没有价格的单游戏API。没有历史的价格API。没有评级数据的价格API。需要OAuth噩梦才能获取单个价格的服务。稍微请求快一点就封锁您IP一小时的服务。简单地已经离线的服务。

有一个API同时穿过了所有这些针眼。

**TCG Price Lookup**覆盖8款游戏、超过30万张卡牌，提供来自TCGPlayer和eBay的双来源价格、按品相分类、PSA/BGS/CGC评级价格、完整价格历史、5个官方SDK、CLI工具、OpenAPI规范、Postman集合、Next.js入门模板、Discord机器人、从0美元开始的透明定价，以及单个HTTP请求头认证。

相比之下，该领域资金最雄厚的替代方案（TCGPlayer自己的API），您需要申请访问、实现OAuth 2.0、导航以卖家为中心的数据模型，并以某种方式从为市场库存管理设计的API中提取干净的价格数据。结果是数月的集成工作，换来TCG Price Lookup在5分钟内就能提供的数据。

从这里开始：

  1. 注册免费API密钥 — 无需信用卡，每天200次请求，立即获取真实价格
  2. 阅读SDK文档 — 选择您的语言，按照快速入门指南，几分钟内发送请求
  3. 查看游戏专属文档 — 了解您所覆盖游戏的卡牌ID格式和数据模型
  4. 查看价格页面 — 当准备好扩展时，Trader计划以每月14.99美元提供每天10,000次请求，包含eBay价格、评级数据和完整历史

如果您在TCG领域构建任何东西——价格追踪工具、收藏品管理应用、Discord机器人、投资组合工具、市场扫描器——TCG Price Lookup是您唯一需要的API。 请回到tcgfast.com获取SDK指南、教程和生态系统资源。

停止评估，开始构建。

开始使用 TCG API 构建应用

获取免费 API 密钥，几分钟内即可开始查询卡牌价格。

获取免费 API 密钥 阅读文档