कार्ड की कीमतें प्राप्त करने के लिए API

आपको ट्रेडिंग कार्ड की कीमतों के इतिहास तक विश्वसनीय, प्रोग्रामेबल पहुंच की आवश्यकता है ताकि आप एक पोर्टफोलियो का मूल्यांकन कर सकें, P&L चला सकें, या इस सप्ताह खरीद/बेचने के अलर्ट ट्रिगर कर सकें। इस गाइड के अंत तक, आप एक विशिष्ट कार्ड के लिए खोज करेंगे और इसके हाल के ग्रेडेड बिक्री मूल्य निकालेंगे—जो आपके वित्तीय वर्कफ़्लो, डैशबोर्ड और स्वचालित कार्यों में डालने के लिए तैयार हैं।

यह API क्या प्रदान करता है

स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड API दो मुख्य क्षमताओं को उजागर करता है जो वित्त और मूल्य निर्धारण के काम के लिए महत्वपूर्ण हैं:

• कार्ड खोजें: एक मानव प्रश्न को एक विशिष्ट कार्ड पहचान में हल करने के लिए तेज़ फजी खोज और एक कार्ड_id और बुनियादी मेटाडेटा प्राप्त करें।
• कार्ड की कीमतें प्राप्त करें: एक दिए गए कार्ड_id और ग्रेड के लिए समय-श्रृंखला मूल्य डेटा एक अनुरोधित लुकबैक विंडो (दिनों में) के भीतर।

आप कार्ड खोज का उपयोग करेंगे ताकि “LeBron James Topps Chrome 2003” जैसे प्रश्न को एक सटीक कार्ड_id से मैप किया जा सके, फिर कार्ड की कीमतें प्राप्त करने के लिए विशिष्ट ग्रेड (जैसे, PSA 10) के लिए हाल की बिक्री समय श्रृंखला प्राप्त करें। परिणाम एक हल्का लेकिन वित्तीय-तैयार पाइपलाइन है जिसे आप मूल्यांकन, NAV स्नैपशॉट, अलर्ट और रिपोर्टिंग में वायर कर सकते हैं।

Zyla API Hub पर शुरू करना

API पृष्ठ खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। Zyla API Hub एक खाते, एक API कुंजी, और एक सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं) के साथ 10,000 से अधिक सार्वजनिक APIs को केंद्रीकृत करता है। इस API के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए लिस्टिंग की जांच करें।

स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड API पर 7-दिन की परीक्षण अवधि शुरू करें

प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।

आप जिन एंडपॉइंट्स का उपयोग करेंगे

1) कार्ड खोजें

विधि: GET
URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
उद्देश्य: एक फ्री-टेक्स्ट प्रश्न को एक या अधिक मिलान करने वाले कार्डों में हल करना, प्रत्येक के साथ एक कार्ड_id और मेटाडेटा जिसे आपको कीमतें अनुरोध करने की आवश्यकता होगी।

आवश्यक प्रश्न पैरामीटर:

• search (string): आपका फ्री-टेक्स्ट प्रश्न, जैसे, 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",…

मुख्य क्षेत्र:

• description, player, set, number, variant: UI और लॉग के लिए मानव-पठनीय पहचान।
• card_id: वह पहचानकर्ता जिसे आपको कार्ड की कीमतें प्राप्त करने के लिए उपयोग करना होगा।
• image: कार्ड की छवि के लिए सापेक्ष पथ।

2) कार्ड की कीमतें प्राप्त करें

विधि: GET
URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2495/get-card-prices
उद्देश्य: एक विशिष्ट कार्ड और ग्रेड के लिए हाल की कीमतों की समय श्रृंखला को पुनः प्राप्त करना।

आवश्यक प्रश्न पैरामीटर:

• card_id (string): जैसे, 1586412050491x786559417729941500
• days (string): लुकबैक अवधि (जैसे, 90)
• grade (string): ग्रेडिंग लेबल (जैसे, 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: ISO 8601 UTC टाइमस्टैम्प जो कीमत बंद होने के समय को चिह्नित करता है (Z प्रत्यय UTC को इंगित करता है)।
• price: बिक्री मूल्य राशि का प्रतिनिधित्व करने वाला एक स्ट्रिंग। प्रतिक्रिया में मुद्रा निर्दिष्ट नहीं की गई है—इसे उचित रूप से स्टोर और प्रस्तुत करें।
• Grade: वह ग्रेडिंग लेबल जो आपने अनुरोध की गई मूल्य श्रृंखला का है।
• card_id: वह कार्ड जो आपने क्वेरी की; जोड़ों और मल्टी-कार्ड पाइपलाइनों के लिए उपयोगी।

Python कॉपी-पेस्ट करें: कीमतें प्राप्त करें और एक त्वरित मैट्रिक की गणना करें

नीचे दिया गया स्निपेट एक विशिष्ट card_id पर PSA 10 ग्रेड के लिए 90-दिन की श्रृंखला का अनुरोध करता है और एक सरल अंतिम मूल्य और औसत की गणना करता है। आप NAVs, ड्रॉडाउन, या जोखिम सीमाओं के लिए समेकन को अनुकूलित कर सकते हैं।

import os
import requests
from decimal import Decimal
from statistics import mean

API_KEY = os.getenv("ZYLA_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, headers=headers, params=params, timeout=30)
resp.raise_for_status()
data = resp.json() # array of { closing_date, Grade, card_id, price }

# Parse price strings into Decimal for finance-safe arithmetic
prices = [Decimal(entry["price"]) for entry in data]
dates = [entry["closing_date"] for entry in data]

last_price = prices[0] if prices else None # most recent appears first in the sample
avg_price = (mean(prices) if prices else None)

print("observations:", len(prices))
print("most_recent_date:", dates[0] if dates else None)
print("most_recent_price:", str(last_price) if last_price is not None else None)
print("average_price_lookback:", str(Decimal(avg_price)) if avg_price is not None else None)

वित्तीय कार्यप्रवाह जो आप इस सप्ताह भेज सकते हैं

• पोर्टफोलियो मूल्यांकन: कार्ड_id + ग्रेड जोड़ों की एक वॉच लिस्ट स्टोर करें; नवीनतम मूल्य खींचने और NAV और P&L की गणना करने के लिए एक दैनिक कार्य चलाएं। चूंकि closing_date टाइमस्टैम्प UTC हैं, सब कुछ UTC में रखें।
• जोखिम और एक्सपोजर मॉनिटरिंग: एक लुकबैक विंडो (जैसे, 30–90 दिन) के भीतर रोलिंग औसत या अधिकतम ड्रॉडाउन पर थ्रेशोल्ड सेट करें और जब उल्लंघन हो तो अलर्ट करें।
• ऑर्डर राउटिंग और मूल्य बैंड: उन मार्केटप्लेस के लिए जो पूर्व-व्यापार जांच की आवश्यकता होती है, आने वाले पूछने की तुलना एक चलती औसत या सबसे हाल के प्रिंट से करें ताकि आउटलेयर को अस्वीकार किया जा सके।
• प्रदर्शन रिपोर्टिंग: सप्ताह के अंत में कीमतों का स्नैपशॉट लें और ट्रेडिंग कार्ड शामिल करने वाले वैकल्पिक संपत्ति स्लीव के लिए समय-भारित रिटर्न उत्पन्न करें।

समय बचाने वाले कार्यान्वयन नोट्स

• प्रमाणीकरण: हर अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल होना चाहिए।
• समय क्षेत्र: closing_date मान UTC हैं (Z पर ध्यान दें)। आधी रात की सीमाओं के चारों ओर ऑफ-बाय-वन समस्याओं से बचने के लिए सभी दिनांक गणित UTC में करें।
• आदेश: यदि आप “सबसे हाल का पहले” पर निर्भर करते हैं, तो अपनी तरफ से आदेश की पुष्टि करें। रोलिंग मैट्रिक्स की गणना करने से पहले दिनांक के अनुसार क्रमबद्ध दृश्य बनाए रखें।
• पार्सिंग: मूल्य को एक स्ट्रिंग के रूप में मानें और अंकगणित से पहले Decimal (या आपकी भाषा के सटीक दशमलव प्रकार) में परिवर्तित करें ताकि फ्लोट ड्रिफ्ट से बचा जा सके।
• कैशिंग: डैशबोर्ड के लिए, एक कार्ड_id/ग्रेड/दिनों के ट्यूपल के लिए अंतिम प्रतिक्रिया को कैश करने पर विचार करें ताकि एक ही रिफ्रेश अंतराल के भीतर पुनरावृत्त कॉल से बचा जा सके।
• कोटा: Zyla सदस्यता + कोटा का उपयोग करता है। प्रारंभिक एकीकरण के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं; विशिष्टताओं के लिए लिस्टिंग की जांच करें क्योंकि वे बदल सकते हैं।

चरण-दर-चरण: एक कार्ड को हल करें और इसकी कीमतें प्राप्त करें

1) कार्ड को हल करें

एक विशिष्ट प्रश्न स्ट्रिंग के साथ कार्ड खोज का उपयोग करें जिसमें खिलाड़ी, सेट, वर्ष, और संभव हो तो भिन्नता शामिल हो। प्रतिक्रिया से, इच्छित मिलान चुनें और इसका card_id कॉपी करें।

2) ग्रेडेड समय श्रृंखला खींचें

चुने हुए card_id, आपकी इच्छित दिनों की विंडो, और ग्रेड (जैसे, PSA 10) के साथ कार्ड की कीमतें प्राप्त करें। श्रृंखला को अपने डेटा स्टोर में स्टोर करें और डाउनस्ट्रीम एनालिटिक्स करें।

AI एजेंटों के माध्यम से API का उपयोग करना MCP के माध्यम से

यदि आप एक AI एजेंट के माध्यम से कॉल को समन्वयित करना पसंद करते हैं जो मॉडल संदर्भ प्रोटोकॉल (MCP) बोलता है, तो अपने क्लाइंट को MCP एंडपॉइंट पर इंगित करें और अपनी API कुंजी प्रदान करें। यहाँ दस्तावेज़ीकरण देखें: MCP। MCP कॉन्फ़िगर करने के साथ, आपका एजेंट ऊपर दिखाए गए समान मार्केटप्लेस एंडपॉइंट्स को कॉल कर सकता है, वही Authorization हेडर और URL पथ का उपयोग करते हुए।

cURL में एंड-टू-एंड उदाहरण

अपने पाइपलाइन को मान्य करने का सबसे तेज़ तरीका इन दो कॉल को कॉपी करना है:

1. कार्ड के लिए खोजें (YOUR_API_KEY को बदलें):
2. प्रतिक्रिया से, एक card_id चुनें (उदाहरण के लिए, 1586412050491x786559417729941500), फिर इसकी कीमतें प्राप्त करें:

यह वित्तीय स्टैक में कहाँ फिट होता है

ट्रेडिंग कार्ड संग्रहकर्ताओं, फंडों और मार्केटप्लेस के लिए एक बढ़ता हुआ वैकल्पिक संपत्ति स्लीव हैं। कार्ड खोज और कार्ड की कीमतें प्राप्त करने का संयोजन आपको:

• card_id का उपयोग करके पहचान को सामान्य करें ताकि आप वॉच लिस्ट और होल्डिंग्स को डुप्लिकेट न करें।
• प्रत्येक ग्रेड के लिए एक साफ मूल्य श्रृंखला बनाएं ताकि रिटर्न, रोलिंग वोल, और z-स्कोर की गणना की जा सके।
• संरचित, टाइमस्टैम्प प्रिंट के साथ पोर्टफोलियो उपकरण, लेखांकन प्रणाली, और जोखिम जांच को फीड करें।

क्योंकि API ISO 8601 टाइमस्टैम्प और स्ट्रिंगिफाइड कीमतें लौटाता है, आप कच्चे मूल्यों को जैसे हैं, स्टोर कर सकते हैं, फिर मैट्रिक्स की गणना करते समय निश्चित रूप से पार्स कर सकते हैं।

सदस्यता लें और भेजें

अब एकीकृत करने के लिए, मार्केटप्लेस आइटम पृष्ठ पर सदस्यता लें, अपनी कुंजी प्राप्त करें, और ऊपर दिए गए cURL को चलाएं। Zyla API Hub आपकी सभी APIs को एक कुंजी और सदस्यता के तहत रखता है, इसलिए आपको कई विक्रेता खातों का प्रबंधन नहीं करना पड़ता। यहाँ से शुरू करें: स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड API पर 7-दिन की परीक्षण अवधि शुरू करें

FAQ

मैं सही card_id कैसे ढूंढूं?
कार्ड खोज एंडपॉइंट का उपयोग करें एक विस्तृत प्रश्न के साथ, फिर प्रतिक्रिया से इच्छित आइटम चुनें और इसका card_id कॉपी करें। इसे कार्ड की कीमतें प्राप्त करने में फीड करें।

closing_date टाइमस्टैम्प किस समय क्षेत्र में हैं?
ये ISO 8601 हैं जिनमें Z प्रत्यय है, जो UTC को इंगित करता है। सीमा समस्याओं से बचने के लिए UTC में दिनांक गणित करें।

कीमतें किस मुद्रा में हैं?
प्रतिक्रिया में एक मूल्य क्षेत्र शामिल है जो एक स्ट्रिंग राशि के रूप में है। प्रतिक्रिया में मुद्रा निर्दिष्ट नहीं की गई है; अपने ऐप में प्रस्तुति को लगातार संभालें।

क्या कोई मुफ्त योजना है?
पहुँच एक सदस्यता + कोटा मॉडल का पालन करती है (पे-पर-कॉल नहीं)। लिस्टिंग 7-दिन की परीक्षण अवधि या 50 अनुरोधों की पेशकश करती है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

क्या मैं इन एंडपॉइंट्स को AI एजेंट के माध्यम से कॉल कर सकता हूँ?
हाँ। अपने MCP-संगत क्लाइंट को MCP एंडपॉइंट का उपयोग करने के लिए कॉन्फ़िगर करें और अपनी API कुंजी शामिल करें। देखें: MCP.

आधिकारिक 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",…