tcglookup 0.1.0

Rust SDK for TCG Price Lookup — live trading card prices across Pokemon, MTG, Yu-Gi-Oh, Lorcana, One Piece, SWU, Flesh and Blood
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

//! Public data types returned by the TCG Price Lookup API.

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// A single trading card with its current prices.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Card {
    pub id: String,
    pub tcgplayer_id: Option<i64>,
    pub name: String,
    pub number: Option<String>,
    pub rarity: Option<String>,
    pub variant: Option<String>,
    pub image_url: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub last_price_update: Option<String>,
    pub updated_at: String,
    pub set: CardSetRef,
    pub game: CardGameRef,
    pub prices: CardPrices,
}

/// Embedded set reference on a card.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CardSetRef {
    pub id: String,
    pub slug: String,
    pub name: String,
}

/// Embedded game reference on a card.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CardGameRef {
    pub id: String,
    pub slug: String,
    pub name: String,
}

/// Raw and graded prices for a card.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CardPrices {
    pub raw: HashMap<String, RawConditionPrices>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub graded: Option<HashMap<String, HashMap<String, GradedGradePrices>>>,
}

/// Source-keyed prices for one raw condition.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RawConditionPrices {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub tcgplayer: Option<TcgPlayerPrices>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub ebay: Option<EbayAverages>,
}

/// Standard TCGPlayer market / low / mid / high points.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TcgPlayerPrices {
    pub market: Option<f64>,
    pub low: Option<f64>,
    pub mid: Option<f64>,
    pub high: Option<f64>,
}

/// Rolling-window averages from eBay sold listings.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct EbayAverages {
    pub avg_1d: Option<f64>,
    pub avg_7d: Option<f64>,
    pub avg_30d: Option<f64>,
}

/// Per-source price block for a single grade.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GradedGradePrices {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub ebay: Option<EbayAverages>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub tcgplayer: Option<EbayAverages>,
}

/// Paginated card search response.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CardSearchResponse {
    pub data: Vec<Card>,
    pub total: usize,
    pub limit: usize,
    pub offset: usize,
}

/// Daily price history.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HistoryResponse {
    pub data: Vec<HistoryDay>,
    pub period: String,
}

/// One day of price observations.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HistoryDay {
    pub date: String,
    pub prices: Vec<HistoryPriceRow>,
}

/// One observation within a day.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HistoryPriceRow {
    pub source: String,
    pub condition: Option<String>,
    pub grader: Option<String>,
    pub grade: Option<String>,
    pub price_market: Option<f64>,
    pub price_low: Option<f64>,
    pub price_mid: Option<f64>,
    pub price_high: Option<f64>,
    pub avg_1d: Option<f64>,
    pub avg_7d: Option<f64>,
    pub avg_30d: Option<f64>,
}

/// One row in the sets list.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SetSummary {
    pub id: String,
    pub slug: String,
    pub name: String,
    pub game: String,
    pub count: usize,
    pub released_at: Option<String>,
}

/// Paginated set list response.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SetListResponse {
    pub data: Vec<SetSummary>,
    pub total: usize,
    pub limit: usize,
    pub offset: usize,
}

/// One row in the games list.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GameSummary {
    pub id: String,
    pub slug: String,
    pub name: String,
    pub count: usize,
}

/// Paginated game list response.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GameListResponse {
    pub data: Vec<GameSummary>,
    pub total: usize,
    pub limit: usize,
    pub offset: usize,
}