आपको इस सप्ताह एक वित्त-फेसिंग कार्ड खोज और मूल्य निर्धारण सुविधा भेजने की आवश्यकता है—खेल कार्ड के लिए खोज-के-समय के बारे में सोचें और हाल की बिक्री की कीमतें जिन्हें आप चार्ट कर सकते हैं और मूल्यांकन के लिए उपयोग कर सकते हैं। इस पोस्ट के अंत तक, आप व्यापारिक कार्डों की खोज करने में सक्षम होंगे और Zyla API Hub से उत्पादन-तैयार एंडपॉइंट्स का उपयोग करके समय-श्रृंखला कीमतें खींच सकेंगे, उन्हें अपने मूल्य निर्धारण या पोर्टफोलियो लॉजिक में वायर कर सकेंगे, और यहां तक कि उन्हें MCP के माध्यम से एक AI एजेंट से कॉल कर सकेंगे।
इस एपीआई के लिए वित्त कार्यप्रवाह क्या प्रदान करता है
स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड एपीआई खोजने योग्य कार्ड मेटाडेटा और समय-श्रृंखला मूल्य डेटा लौटाता है। वैकल्पिक संपत्तियों के लिए वित्त-शैली ऐप्स बनाने वाले डेवलपर्स—पोर्टफोलियो ट्रैकर्स, मूल्य अलर्ट, मूल्यांकन डैशबोर्ड, या एनालिटिक्स—इसे उपयोग करते हैं:
- फ्री-टेक्स्ट खोज (“लेब्रोन टॉप्स क्रोम आरसी पीएसए 10”) को साफ पहचानकर्ताओं में हल करें, जिसमें एक स्थिर card_id और सेट मेटाडेटा शामिल है।
- चार्ट, जोखिम स्कोरिंग, और मार्क-टू-मार्केट गणनाओं को शक्ति देने के लिए कार्ड और ग्रेड द्वारा हाल की कीमतों को क्वेरी करें।
सभी कॉल Zyla API Hub पर चलते हैं, जो एक खाता, एक एपीआई कुंजी, और 10,000 से अधिक सार्वजनिक एपीआई के बीच एक सदस्यता + कोटा मॉडल प्रदान करता है। इस एपीआई के लिए, आप इसके मार्केटप्लेस पृष्ठ से 7-दिन की परीक्षण शुरू कर सकते हैं, फिर सदस्यता और कोटा के तहत जारी रख सकते हैं (कोई पे-पर-कॉल नहीं)।
Zyla API Hub पर शुरू करना
- एपीआई के मार्केटप्लेस पृष्ठ को खोलें और परीक्षण शुरू करें: स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड एपीआई पर 7-दिन का परीक्षण शुरू करें.
- अपनी एपीआई कुंजी प्राप्त करने के लिए सब्सक्राइब या फ्री ट्रायल शुरू करें (जब उपलब्ध हो)।
- नीचे दिए गए एंडपॉइंट्स पर हेडर Authorization: Bearer YOUR_API_KEY के साथ अनुरोध भेजें।
यदि आप Zyla में नए हैं, तो आप zylalabs.com पर श्रेणियों को ब्राउज़ कर सकते हैं और सदस्यताओं का प्रबंधन कर सकते हैं। सदस्यता कोटा का उपयोग करती है, न कि पे-पर-कॉल। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, एपीआई पृष्ठ की जांच करें।
एंडपॉइंट: कार्ड खोज
फजी मिलान के साथ ट्रेडिंग कार्ड खोजें और उम्मीदवारों की एक JSON सूची और मेटाडेटा प्राप्त करें। यह आपके उपयोगकर्ता के फ्री-टेक्स्ट क्वेरी से एक कैनोनिकल card_id तक आपका रिसॉल्वर है जिसे आप मूल्य निर्धारण फ़ेच के लिए उपयोग कर सकते हैं।
- विधि: GET
- URL: https://zylalabs.com/api/2511/sports-card-and-trading-card-api/2494/card-search
- क्वेरी पैरामीटर:
- search (string, आवश्यक): लेब्रोन जेम्स
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("Selected:", 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 (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 टाइमस्टैम्प है जिसमें Z-संलग्नक (UTC) है। अपने चार्टिंग और कैश अमान्यकरण को UTC पर संरेखित करें ताकि एक-दिन की समस्याओं से बचा जा सके।
- price एक स्ट्रिंगिफाइड न्यूमेरिक वैल्यू है। अपने स्टैक के लिए उपयुक्त दशमलव/संख्या प्रकार में पार्स करें ताकि फ्लोटिंग-पॉइंट राउंडिंग त्रुटियों से बचा जा सके।
- Grade एक स्ट्रिंग है जैसे "PSA 10"; इसे लेबलिंग के लिए उपयोग करें और ग्रेड-विशिष्ट मूल्यांकन नियमों को लागू करें।
संरचना: खोज से मूल्य श्रृंखला तक
विशिष्ट प्रवाह:
- उपयोगकर्ता के इनपुट के साथ कार्ड खोजें।
- उपयोगकर्ता को सही कार्ड (सेट, संख्या, वैरिएंट) की पुष्टि करने दें।
- चाहे गए ग्रेड और लुकबैक विंडो के लिए Get Card Prices के साथ लौटाए गए card_id का उपयोग करें।
- मैट्रिक्स की गणना करें: 7/30/90-दिन के औसत, अस्थिरता के अनुमान, ड्रॉडाउन, और प्रतिशत परिवर्तन।
व्यावहारिक एकीकरण विवरण जो समय बचाते हैं
- Authorization: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY पास करें।
- Caching: मूल्य एंडपॉइंट्स के लिए, एक कार्ड_id और ग्रेड (जैसे, प्रति घंटा) के लिए एक छोटा कैश विंडो आमतौर पर डैशबोर्ड के लिए पर्याप्त होता है जबकि कोटा उपयोग को कम करता है।
- Timezones: closing_date को UTC के रूप में मानें। दिन/सप्ताह द्वारा बकेट करने से पहले सभी डाउनस्ट्रीम गणनाओं को UTC में सामान्य करें।
- Search UX: इनपुट परिवर्तन पर कार्ड खोज जारी करें जिसमें एक छोटा डेबाउंस (जैसे, 200–300ms) हो। अपने पदों में चयनित card_id को बनाए रखें।
- त्रुटि हैंडलिंग: "कोई परिणाम नहीं" को सुचारू रूप से प्रदर्शित करें; पावर उपयोगकर्ताओं को खोज स्ट्रिंग में सेट, वर्ष, और कार्ड संख्या जोड़कर क्वेरी को परिष्कृत करने की अनुमति दें।
उदाहरण: एक कार्ड मूल्यांकन विजेट बनाएं
नीचे एक न्यूनतम, दो-चरण प्रवाह है जिसे आप एक वित्तीय डैशबोर्ड में वायर कर सकते हैं:
- "लेब्रोन जेम्स" की खोज करें और विवरण, सेट, संख्या, और card_id के साथ उम्मीदवारों की सूची बनाएं।
- जब उपयोगकर्ता "2003 टॉप्स क्रोम बास्केटबॉल #111" card_id 1586412050491x786559417729941500 का चयन करता है और ग्रेड "PSA 10" चुनता है, तो 90-दिन की मूल्य श्रृंखला प्राप्त करें और इसे प्लॉट करें। अपने पद के मूल्यांकन के रूप में नवीनतम मूल्य को बनाए रखें।
क्योंकि एपीआई साफ पहचानकर्ता और टाइमस्टैम्प लौटाता है, आप अपने मौजूदा पोर्टफोलियो कोड पथों का उपयोग करके रोलिंग औसत और P/L की गणना कर सकते हैं।
AI एजेंटों के माध्यम से MCP से एपीआई कॉल करना
यदि आप AI एजेंट (जैसे, क्लॉड कोड, कर्सर, विंडसर्फ) से खोज और मूल्य कॉल को समन्वयित करना पसंद करते हैं, तो आप उन्हें Zyla के MCP एंडपॉइंट के माध्यम से रूट कर सकते हैं। अपने MCP-संगत क्लाइंट को इस पर इंगित करें:
अपनी Zyla API कुंजी का उपयोग करें और एजेंट को ऊपर दिखाए गए दो HTTPS एंडपॉइंट्स को उसी Authorization हेडर और क्वेरी पैरामीटर के साथ सक्रिय करने दें। यह एजेंटों को एक कार्ड_id हल करने और एक ही उपकरण कॉल अनुक्रम के भीतर मूल्य समय श्रृंखला प्राप्त करने की अनुमति देता है।
वित्त-केंद्रित उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं
- मार्क-टू-मार्केट पोर्टफोलियो: प्रत्येक स्थिति के लिए card_id और ग्रेड संग्रहीत करें; Get Card Prices के माध्यम से ताज़ा करें और अवास्तविक P/L की गणना करें।
- मूल्य अलर्ट: जब नवीनतम मूल्य एक थ्रेशोल्ड को पार करता है या एक मूविंग एवरेज से X% भिन्न होता है, तो सूचनाएं ट्रिगर करें।
- वॉचलिस्ट में मूल्यांकन कार्ड: एक बार खोजें, card_id को पिन करें, और टॉकर-जैसे टाइलों के बगल में वर्तमान और ट्रेलिंग कीमतें प्रदर्शित करें।
- जोखिम डैशबोर्ड: वैकल्पिक संपत्तियों के लिए ग्रेड-विशिष्ट जोखिम स्कोरिंग के लिए समय श्रृंखला से रोलिंग अस्थिरता निकालें।
समस्या निवारण और मान्यता
- खाली या शोर खोज: फजी मिलानों को कड़ा करने के लिए खोज स्ट्रिंग को वर्ष, सेट, या कार्ड संख्या से समृद्ध करें।
- एकाधिक वैरिएंट: उपयोगकर्ताओं को मूल्य निर्धारण से पहले सही एक चुनने के लिए अपने UI में वैरिएंट और सेट_प्रकार प्रस्तुत करें।
- दशमलव: पोर्टफोलियो कुल में राउंडिंग ड्रिफ्ट से बचने के लिए मूल्य को Decimal/BigNumber के रूप में पार्स करें।
- डेटा ताज़ा करने की आवृत्ति: यदि आप दैनिक NAV का स्नैपशॉट लेते हैं, तो closing_date (UTC) द्वारा बकेट करें ताकि सुसंगत दैनिक बार बनाए रखा जा सके।
जहां पहुंच और कोटा प्रबंधित करें
सभी पहुंच Zyla API Hub के माध्यम से एक सदस्यता + कोटा मॉडल (कोई पे-पर-कॉल नहीं) के तहत प्रदान की जाती है। पहली बार की पहुंच आमतौर पर 7-दिन की परीक्षण या 50 अनुरोधों के साथ शुरू होती है। उपलब्धता और सटीक विवरण के लिए, एपीआई के आइटम पृष्ठ का उपयोग करें। आप zylalabs.com पर श्रेणियों के बीच अपनी सदस्यताओं को देख और प्रबंधित कर सकते हैं।
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणीकरण के लिए कौन सा हेडर उपयोग करूं?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY का उपयोग करें।
मैं एक विशिष्ट कार्ड के लिए कीमतें कैसे प्राप्त करूं?
पहले कार्ड खोज के साथ कार्ड को हल करें ताकि card_id प्राप्त हो सके, फिर card_id, days, और grade के साथ Get Card Prices को कॉल करें।
टाइमस्टैम्प किस टाइमज़ोन में हैं?
closing_date मान UTC (Z-संलग्नक ISO 8601) में हैं। सीमा समस्याओं से बचने के लिए अपने एनालिटिक्स को UTC में सामान्य करें।
क्या मैं प्रतिक्रिया से सीधे कीमतों का चार्ट बना सकता हूं?
हाँ। ऐरे पर इटरेट करें, मूल्य को न्यूमेरिक प्रकार में पार्स करें, और closing_date के अनुसार चढ़ते क्रम में प्लॉट करें।
क्या कोई मुफ्त योजना है?
पहुँच सदस्यता + कोटा आधारित है। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें; आप आइटम पृष्ठ से 7-दिन का परीक्षण शुरू कर सकते हैं।
क्या आप अपने वित्तीय ऐप में कार्ड खोज और मूल्य निर्धारण जोड़ने के लिए तैयार हैं? परीक्षण शुरू करें, अपनी कुंजी प्राप्त करें, और आज एकीकरण भेजें: स्पोर्ट्स कार्ड और ट्रेडिंग कार्ड एपीआई.
आधिकारिक एपीआई प्रतिक्रिया
[
{
"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": "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",…
