Add sealed product listings (#5)

SealedResource had no listings surface at all, so neither sealed endpoint was
reachable from the SDK: the TCGplayer one is new, and the eBay one has been
live since sealed_sales started being scraped but was never wired up.

Adds client.sealed.listings.{ebay,tcgplayer} with the same iterate_*/all_*
helpers as client.cards.listings, on both the sync and async clients, so both
product types paginate identically.

The sealed ebay() signature deliberately omits graded/grader/grade. Sealed
products are not graded and the API rejects those filters on this route, so
accepting them would have offered keyword arguments that always fail.

Author: preaverage

README.md

@@ -83,6 +83,22 @@ for offer in client.cards.listings.iterate_tcgplayer(789, condition="Near Mint")
     print(offer.seller_name, offer.price, offer.shipping_price)
 ```
 
+Sealed products carry the same two listing sources, under `client.sealed.listings`:
+
+```python
+for offer in client.sealed.listings.iterate_tcgplayer(5678):
+    print(offer.seller_name, offer.price, offer.quantity)
+
+for sale in client.sealed.listings.iterate_ebay(5678, sort="price_desc"):
+    print(sale.title, sale.price, sale.sold_at)
+```
+
+Sealed TCGplayer offers are normally condition `"Unopened"` with an empty
+`printing`, so those two filters rarely narrow anything. Sealed eBay sales are
+never graded, so `graded`, `grader`, and `grade` aren't accepted there and
+`grader`/`grade` come back `None`. The async client mirrors all of these on
+`AsyncPkmnPrices`.
+
 ## Currency
 
 Every price has a `currency` field. Pass `currency="usd"` or `currency="eur"` to filter, or leave it off to get everything your plan allows. EUR (Cardmarket) prices need a Pro plan; a free key asking for `eur` raises `ForbiddenError`.

src/pkmnprices/_endpoints.py

@@ -66,6 +66,14 @@ def sealed_history(sealed_id: int, **query: Any) -> Request:
     return Request("GET", f"/v1/sealed/{sealed_id}/prices/history", _clean(query))
 
 
+def sealed_listings_ebay(sealed_id: int, **query: Any) -> Request:
+    return Request("GET", f"/v1/sealed/{sealed_id}/listings/ebay", _clean(query))
+
+
+def sealed_listings_tcgplayer(sealed_id: int, **query: Any) -> Request:
+    return Request("GET", f"/v1/sealed/{sealed_id}/listings/tcgplayer", _clean(query))
+
+
 def build_page(raw: dict[str, Any], model: type[Model]) -> Page[Any]:
     items = [model.from_dict(item) for item in raw["data"]]
     return Page(items, PageInfo.from_dict(raw["pagination"]))

src/pkmnprices/aio.py

@@ -144,9 +144,51 @@ def iterate_price_history(self, card_id: int, **params: Any) -> AsyncIterator[Pr
         return paginate_async(lambda page: self.price_history(card_id, **{**params, "page": page}), start)
 
 
+class AsyncSealedListingsResource:
+    def __init__(self, transport: AsyncTransport) -> None:
+        self._t = transport
+
+    # Sealed eBay sales are never graded, so graded/grader/grade don't apply.
+    async def ebay(
+        self, sealed_id: int, *, min_price: float | None = None, max_price: float | None = None,
+        sort: str | None = None, limit: int | None = None, cursor: str | None = None,
+    ) -> CursorPage[EbayListing]:
+        raw = await self._t.request(ep.sealed_listings_ebay(
+            sealed_id, min_price=min_price, max_price=max_price,
+            sort=sort, limit=limit, cursor=cursor,
+        ))
+        return ep.build_cursor_page(raw, EbayListing)
+
+    def iterate_ebay(self, sealed_id: int, **params: Any) -> AsyncIterator[EbayListing]:
+        return paginate_cursor_async(lambda cursor: self.ebay(sealed_id, **{**params, "cursor": cursor}))
+
+    async def all_ebay(self, sealed_id: int, **params: Any) -> List[EbayListing]:
+        return [item async for item in self.iterate_ebay(sealed_id, **params)]
+
+    # Sealed offers are normally condition "Unopened" with an empty printing,
+    # so those two filters rarely narrow anything here.
+    async def tcgplayer(
+        self, sealed_id: int, *, condition: str | None = None, language: str | None = None,
+        printing: str | None = None, min_price: float | None = None, max_price: float | None = None,
+        sort: str | None = None, limit: int | None = None, cursor: str | None = None,
+    ) -> CursorPage[TcgplayerListing]:
+        raw = await self._t.request(ep.sealed_listings_tcgplayer(
+            sealed_id, condition=condition, language=language, printing=printing,
+            min_price=min_price, max_price=max_price, sort=sort, limit=limit, cursor=cursor,
+        ))
+        return ep.build_cursor_page(raw, TcgplayerListing)
+
+    def iterate_tcgplayer(self, sealed_id: int, **params: Any) -> AsyncIterator[TcgplayerListing]:
+        return paginate_cursor_async(lambda cursor: self.tcgplayer(sealed_id, **{**params, "cursor": cursor}))
+
+    async def all_tcgplayer(self, sealed_id: int, **params: Any) -> List[TcgplayerListing]:
+        return [item async for item in self.iterate_tcgplayer(sealed_id, **params)]
+
+
 class AsyncSealedResource:
     def __init__(self, transport: AsyncTransport) -> None:
         self._t = transport
+        self.listings = AsyncSealedListingsResource(transport)
 
     async def list(
         self, *, set_id: int | None = None, name: str | None = None, language: str | None = None,

src/pkmnprices/resources.py

@@ -144,9 +144,51 @@ def iterate_price_history(self, card_id: int, **params: Any) -> Iterator[PriceHi
         return paginate(lambda page: self.price_history(card_id, **{**params, "page": page}), start)
 
 
+class SealedListingsResource:
+    def __init__(self, transport: SyncTransport) -> None:
+        self._t = transport
+
+    # Sealed eBay sales are never graded, so graded/grader/grade don't apply.
+    def ebay(
+        self, sealed_id: int, *, min_price: float | None = None, max_price: float | None = None,
+        sort: str | None = None, limit: int | None = None, cursor: str | None = None,
+    ) -> CursorPage[EbayListing]:
+        raw = self._t.request(ep.sealed_listings_ebay(
+            sealed_id, min_price=min_price, max_price=max_price,
+            sort=sort, limit=limit, cursor=cursor,
+        ))
+        return ep.build_cursor_page(raw, EbayListing)
+
+    def iterate_ebay(self, sealed_id: int, **params: Any) -> Iterator[EbayListing]:
+        return paginate_cursor(lambda cursor: self.ebay(sealed_id, **{**params, "cursor": cursor}))
+
+    def all_ebay(self, sealed_id: int, **params: Any) -> List[EbayListing]:
+        return list(self.iterate_ebay(sealed_id, **params))
+
+    # Sealed offers are normally condition "Unopened" with an empty printing,
+    # so those two filters rarely narrow anything here.
+    def tcgplayer(
+        self, sealed_id: int, *, condition: str | None = None, language: str | None = None,
+        printing: str | None = None, min_price: float | None = None, max_price: float | None = None,
+        sort: str | None = None, limit: int | None = None, cursor: str | None = None,
+    ) -> CursorPage[TcgplayerListing]:
+        raw = self._t.request(ep.sealed_listings_tcgplayer(
+            sealed_id, condition=condition, language=language, printing=printing,
+            min_price=min_price, max_price=max_price, sort=sort, limit=limit, cursor=cursor,
+        ))
+        return ep.build_cursor_page(raw, TcgplayerListing)
+
+    def iterate_tcgplayer(self, sealed_id: int, **params: Any) -> Iterator[TcgplayerListing]:
+        return paginate_cursor(lambda cursor: self.tcgplayer(sealed_id, **{**params, "cursor": cursor}))
+
+    def all_tcgplayer(self, sealed_id: int, **params: Any) -> List[TcgplayerListing]:
+        return list(self.iterate_tcgplayer(sealed_id, **params))
+
+
 class SealedResource:
     def __init__(self, transport: SyncTransport) -> None:
         self._t = transport
+        self.listings = SealedListingsResource(transport)
 
     def list(
         self, *, set_id: int | None = None, name: str | None = None, language: str | None = None,

tests/test_client.py

@@ -176,6 +176,47 @@ def handler(request: httpx.Request) -> httpx.Response:
     assert "printing=1st+Edition+Holofoil" in captured["url"]
 
 
+def test_sealed_tcgplayer_listings() -> None:
+    captured = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        captured["url"] = str(request.url)
+        return _json({"data": [{"id": 9, "listing_id": 991122, "printing": "",
+                                "condition": "Unopened", "language": "English", "price": 128.99,
+                                "shipping_price": 0.0, "seller_name": "SealedVault", "seller_id": "77321",
+                                "seller_rating": 99.2, "seller_sales": "10000+", "quantity": 4,
+                                "listing_type": "standard", "direct_seller": False, "gold_seller": True,
+                                "verified_seller": True, "custom_title": None,
+                                "updated_at": "2026-08-13T09:10:00+00:00"}],
+                      "pagination": {"has_more": False, "next_cursor": None, "count": 1}})
+
+    client = PkmnPrices("pk_test", _transport=httpx.MockTransport(handler))
+    listings = client.sealed.listings.all_tcgplayer(5678, sort="price_asc")
+    assert len(listings) == 1
+    assert listings[0].seller_name == "SealedVault"
+    assert listings[0].condition == "Unopened"
+    assert "/v1/sealed/5678/listings/tcgplayer" in captured["url"]
+    assert "sort=price_asc" in captured["url"]
+
+
+def test_sealed_ebay_listings() -> None:
+    captured = {}
+
+    def handler(request: httpx.Request) -> httpx.Response:
+        captured["url"] = str(request.url)
+        return _json({"data": [{"id": 4, "title": "Obsidian Flames Booster Box", "price": 119.0,
+                                "grader": None, "grade": None, "sold_at": "2026-08-01",
+                                "listing_url": "https://example.test/x"}],
+                      "pagination": {"has_more": False, "next_cursor": None, "count": 1}})
+
+    client = PkmnPrices("pk_test", _transport=httpx.MockTransport(handler))
+    page = client.sealed.listings.ebay(5678, min_price=100.0)
+    assert page.data[0].grader is None
+    assert page.data[0].price == 119.0
+    assert "/v1/sealed/5678/listings/ebay" in captured["url"]
+    assert "min_price=100" in captured["url"]
+
+
 def test_cardmarket_listings() -> None:
     captured = {}