dexify-api-client 1.0.0b4__tar.gz

dexify_api_client-1.0.0b4/DATA_RIGHTS.md

@@ -0,0 +1,12 @@
+# SDK license and API data rights
+
+The Apache License 2.0 applies to the Dexify client-library code in this package. It does **not** grant:
+
+- access to the Dexify API or any subscription plan;
+- a license to Dexify or third-party catalog, market, image, or analytics data;
+- permission to mirror, bulk-extract, resell, sublicense, or redistribute API responses;
+- permission to use Dexify or third-party trademarks, logos, or branding; or
+- credentials, quota, support, service levels, or continued service availability.
+
+Use of the API and returned data requires an active authorized account and is governed by the current Dexify API
+Terms and the customer's approved plan or signed order. See https://www.dexifyvault.com/developers/terms.

dexify_api_client-1.0.0b4/LICENSE

@@ -0,0 +1,186 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the
+copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other
+entities that control, are controlled by, or are under common control with
+that entity. For the purposes of this definition, "control" means (i) the
+power, direct or indirect, to cause the direction or management of such
+entity, whether by contract or otherwise, or (ii) ownership of fifty percent
+(50%) or more of the outstanding shares, or (iii) beneficial ownership of
+such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation source, and
+configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation
+or translation of a Source form, including but not limited to compiled object
+code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work (an example is provided in the Appendix
+below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form,
+that is based on (or derived from) the Work and for which the editorial
+revisions, annotations, elaborations, or other modifications represent, as a
+whole, an original work of authorship. For the purposes of this License,
+Derivative Works shall not include works that remain separable from, or
+merely link (or bind by name) to the interfaces of, the Work and Derivative
+Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original
+version of the Work and any modifications or additions to that Work or
+Derivative Works thereof, that is intentionally submitted to Licensor for
+inclusion in the Work by the copyright owner or by an individual or Legal
+Entity authorized to submit on behalf of the copyright owner. For the
+purposes of this definition, "submitted" means any form of electronic,
+verbal, or written communication sent to the Licensor or its representatives,
+including but not limited to communication on electronic mailing lists,
+source code control systems, and issue tracking systems that are managed by,
+or on behalf of, the Licensor for the purpose of discussing and improving the
+Work, but excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on
+behalf of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
+section) patent license to make, have made, use, offer to sell, sell, import,
+and otherwise transfer the Work, where such license applies only to those
+patent claims licensable by such Contributor that are necessarily infringed
+by their Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You institute
+patent litigation against any entity (including a cross-claim or counterclaim
+in a lawsuit) alleging that the Work or a Contribution incorporated within
+the Work constitutes direct or contributory patent infringement, then any
+patent licenses granted to You under this License for that Work shall
+terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy
+of this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from the
+Source form of the Work, excluding those notices that do not pertain to any
+part of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution,
+then any Derivative Works that You distribute must include a readable copy of
+the attribution notices contained within such NOTICE file, excluding those
+notices that do not pertain to any part of the Derivative Works, in at least
+one of the following places: within a NOTICE text file distributed as part of
+the Derivative Works; within the Source form or documentation, if provided
+along with the Derivative Works; or, within a display generated by the
+Derivative Works, if and wherever such third-party notices normally appear.
+The contents of the NOTICE file are for informational purposes only and do
+not modify the License. You may add Your own attribution notices within
+Derivative Works that You distribute, alongside or as an addendum to the
+NOTICE text from the Work, provided that such additional attribution notices
+cannot be construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may
+provide additional or different license terms and conditions for use,
+reproduction, or distribution of Your modifications, or for any such
+Derivative Works as a whole, provided Your use, reproduction, and distribution
+of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License, without any
+additional terms or conditions. Notwithstanding the above, nothing herein
+shall supersede or modify the terms of any separate license agreement you may
+have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor, except as required
+for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work (and each Contributor provides its
+Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied, including, without limitation, any warranties
+or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort (including negligence), contract, or otherwise, unless required by
+applicable law (such as deliberate and grossly negligent acts) or agreed to in
+writing, shall any Contributor be liable to You for damages, including any
+direct, indirect, special, incidental, or consequential damages of any
+character arising as a result of this License or out of the use or inability
+to use the Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all other
+commercial damages or losses), even if such Contributor has been advised of
+the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work
+or Derivative Works thereof, You may choose to offer, and charge a fee for,
+acceptance of support, warranty, indemnity, or other liability obligations
+and/or rights consistent with this License. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility, not on behalf of any other Contributor, and only if You agree
+to indemnify, defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following boilerplate
+notice, with the fields enclosed by brackets "[]" replaced with your own
+identifying information. (Don't include the brackets!) The text should be
+enclosed in the appropriate comment syntax for the file format. We also
+recommend that a file or class name and description of purpose be included on
+the same "printed page" as the copyright notice for easier identification
+within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

dexify_api_client-1.0.0b4/NOTICE

@@ -0,0 +1,7 @@
+Dexify API Client Libraries
+Copyright 2026 Dexify
+
+This product includes software developed by Dexify.
+
+The Apache License applies only to the client-library code distributed in this
+package. API access and data use are governed separately.

dexify_api_client-1.0.0b4/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: dexify-api-client
+Version: 1.0.0b4
+Summary: Dependency-free server-side Python client for the Dexify Developer API
+License-Expression: Apache-2.0
+Keywords: pokemon,tcg,pricing,api,dexify
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: DATA_RIGHTS.md
+Dynamic: license-file
+
+# Dexify API clients
+
+Dependency-free, server-side clients for the Dexify Developer API. Both clients cover the complete v1 surface,
+keep credentials out of browser code, support conditional ETag requests, expose quota metadata, and preserve
+the API's history-depth metadata.
+
+These packages are release-ready source artifacts but are not published to npm or PyPI yet. Publication requires
+the Dexify organization credentials, final package names, and approval of the customer license.
+
+## JavaScript
+
+```js
+import { DexifyClient } from "@dexify/api-client";
+
+const dexify = new DexifyClient({ apiKey: process.env.DEXIFY_API_KEY });
+const history = await dexify.getPriceHistory("CARD_UUID", { market: "ebay", limit: 30 });
+console.log(history.meta.history_depth);
+```
+
+## Python
+
+```python
+import os
+from dexify_python import DexifyClient
+
+dexify = DexifyClient(os.environ["DEXIFY_API_KEY"])
+history = dexify.get_price_history("CARD_UUID", "ebay", limit=30)
+print(history["meta"]["history_depth"])
+```

dexify_api_client-1.0.0b4/README.md

@@ -0,0 +1,29 @@
+# Dexify API clients
+
+Dependency-free, server-side clients for the Dexify Developer API. Both clients cover the complete v1 surface,
+keep credentials out of browser code, support conditional ETag requests, expose quota metadata, and preserve
+the API's history-depth metadata.
+
+These packages are release-ready source artifacts but are not published to npm or PyPI yet. Publication requires
+the Dexify organization credentials, final package names, and approval of the customer license.
+
+## JavaScript
+
+```js
+import { DexifyClient } from "@dexify/api-client";
+
+const dexify = new DexifyClient({ apiKey: process.env.DEXIFY_API_KEY });
+const history = await dexify.getPriceHistory("CARD_UUID", { market: "ebay", limit: 30 });
+console.log(history.meta.history_depth);
+```
+
+## Python
+
+```python
+import os
+from dexify_python import DexifyClient
+
+dexify = DexifyClient(os.environ["DEXIFY_API_KEY"])
+history = dexify.get_price_history("CARD_UUID", "ebay", limit=30)
+print(history["meta"]["history_depth"])
+```

dexify_api_client-1.0.0b4/dexify_api_client.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: dexify-api-client
+Version: 1.0.0b4
+Summary: Dependency-free server-side Python client for the Dexify Developer API
+License-Expression: Apache-2.0
+Keywords: pokemon,tcg,pricing,api,dexify
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: DATA_RIGHTS.md
+Dynamic: license-file
+
+# Dexify API clients
+
+Dependency-free, server-side clients for the Dexify Developer API. Both clients cover the complete v1 surface,
+keep credentials out of browser code, support conditional ETag requests, expose quota metadata, and preserve
+the API's history-depth metadata.
+
+These packages are release-ready source artifacts but are not published to npm or PyPI yet. Publication requires
+the Dexify organization credentials, final package names, and approval of the customer license.
+
+## JavaScript
+
+```js
+import { DexifyClient } from "@dexify/api-client";
+
+const dexify = new DexifyClient({ apiKey: process.env.DEXIFY_API_KEY });
+const history = await dexify.getPriceHistory("CARD_UUID", { market: "ebay", limit: 30 });
+console.log(history.meta.history_depth);
+```
+
+## Python
+
+```python
+import os
+from dexify_python import DexifyClient
+
+dexify = DexifyClient(os.environ["DEXIFY_API_KEY"])
+history = dexify.get_price_history("CARD_UUID", "ebay", limit=30)
+print(history["meta"]["history_depth"])
+```

dexify_api_client-1.0.0b4/dexify_api_client.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+DATA_RIGHTS.md
+LICENSE
+NOTICE
+README.md
+dexify_python.py
+pyproject.toml
+dexify_api_client.egg-info/PKG-INFO
+dexify_api_client.egg-info/SOURCES.txt
+dexify_api_client.egg-info/dependency_links.txt
+dexify_api_client.egg-info/top_level.txt

dexify_api_client-1.0.0b4/dexify_api_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dexify_api_client-1.0.0b4/dexify_api_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+dexify_python

dexify_api_client-1.0.0b4/dexify_python.py

@@ -0,0 +1,143 @@
+"""Dependency-free reference client for the Dexify v1 API.
+
+Copy this module into a server-side Python project. Keep API keys in a secret
+manager or environment variable; never embed them in browser or mobile code.
+"""
+
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from typing import Callable, Iterator
+from urllib.error import HTTPError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+
+@dataclass(frozen=True)
+class ResponseMetadata:
+    request_id: str | None
+    rate_limit: int | None
+    rate_limit_remaining: int | None
+    rate_limit_reset: int | None
+    etag: str | None
+    not_modified: bool = False
+
+
+class DexifyError(RuntimeError):
+    def __init__(self, status: int, title: str, detail: str, request_id: str | None = None,
+                 retry_after: int | None = None):
+        super().__init__(f"Dexify API {status}: {detail}")
+        self.status = status
+        self.title = title
+        self.detail = detail
+        self.request_id = request_id
+        self.retry_after = retry_after
+
+
+class DexifyClient:
+    def __init__(self, api_key: str, base_url: str = "https://api.dexifyvault.com",
+                 timeout: float = 15, transport: Callable | None = None):
+        if not api_key.strip():
+            raise ValueError("api_key is required")
+        if not base_url.startswith("https://"):
+            raise ValueError("base_url must use HTTPS")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.transport = transport or urlopen
+        self.last_response: ResponseMetadata | None = None
+        self._cache: dict[str, tuple[str, dict]] = {}
+
+    @staticmethod
+    def _integer_header(headers, name: str) -> int | None:
+        value = headers.get(name)
+        try:
+            return int(value) if value is not None else None
+        except ValueError:
+            return None
+
+    def _metadata(self, headers, not_modified: bool = False) -> ResponseMetadata:
+        return ResponseMetadata(
+            request_id=headers.get("X-Request-Id"),
+            rate_limit=self._integer_header(headers, "RateLimit-Limit"),
+            rate_limit_remaining=self._integer_header(headers, "RateLimit-Remaining"),
+            rate_limit_reset=self._integer_header(headers, "RateLimit-Reset"),
+            etag=headers.get("ETag"),
+            not_modified=not_modified,
+        )
+
+    def request(self, path: str, **params) -> dict:
+        query = urlencode([(key, value) for key, value in params.items() if value is not None])
+        url = f"{self.base_url}/v1/{path.lstrip('/')}" + (f"?{query}" if query else "")
+        headers = {"X-API-Key": self.api_key, "Accept": "application/json",
+                   "User-Agent": "dexify-python-reference/1.0"}
+        cached = self._cache.get(url)
+        if cached:
+            headers["If-None-Match"] = cached[0]
+        request = Request(url, headers=headers, method="GET")
+        try:
+            with self.transport(request, timeout=self.timeout) as response:
+                payload = json.loads(response.read())
+                self.last_response = self._metadata(response.headers)
+                if self.last_response.etag:
+                    self._cache[url] = (self.last_response.etag, payload)
+                return payload
+        except HTTPError as error:
+            if error.code == 304 and cached:
+                self.last_response = self._metadata(error.headers, not_modified=True)
+                return cached[1]
+            try:
+                problem = json.loads(error.read())
+            except (json.JSONDecodeError, UnicodeDecodeError):
+                problem = {}
+            self.last_response = self._metadata(error.headers)
+            raise DexifyError(
+                error.code,
+                problem.get("title", "Request failed"),
+                problem.get("detail", "The API request failed."),
+                problem.get("request_id") or error.headers.get("X-Request-Id"),
+                self._integer_header(error.headers, "Retry-After"),
+            ) from None
+
+    def list_cards(self, **filters) -> dict:
+        return self.request("cards", **filters)
+
+    def list_markets(self) -> dict:
+        """Return supported market identifiers, native currencies, and price types."""
+        return self.request("markets")
+
+    def iter_cards(self, **filters) -> Iterator[dict]:
+        cursor = None
+        while True:
+            page = self.list_cards(**filters, cursor=cursor)
+            yield from page["data"]
+            cursor = page["meta"].get("next_cursor")
+            if not cursor:
+                return
+
+    def get_card(self, card_id: str) -> dict:
+        return self.request(f"cards/{card_id}")
+
+    def get_prices(self, card_id: str, **filters) -> dict:
+        return self.request(f"cards/{card_id}/prices", **filters)
+
+    def get_price_history(self, card_id: str, market: str, **filters) -> dict:
+        return self.request(f"cards/{card_id}/price-history", market=market, **filters)
+
+    def get_market_summary(self, card_id: str) -> dict:
+        return self.request(f"cards/{card_id}/market-summary")
+
+    def analyze_deal(self, card_id: str, asking_price_minor: int, market: str, **filters) -> dict:
+        return self.request(f"cards/{card_id}/deal-analysis",
+                            asking_price_minor=asking_price_minor, market=market, **filters)
+
+    def list_sets(self, **filters) -> dict:
+        return self.request("sets", **filters)
+
+    def get_set(self, set_id: str) -> dict:
+        return self.request(f"sets/{set_id}")
+
+    def get_usage(self) -> dict:
+        """Return this API key's current quota window after this request."""
+        return self.request("account/usage")

dexify_api_client-1.0.0b4/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools==84.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dexify-api-client"
+version = "1.0.0b4"
+description = "Dependency-free server-side Python client for the Dexify Developer API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "Apache-2.0"
+license-files = ["LICENSE", "NOTICE", "DATA_RIGHTS.md"]
+keywords = ["pokemon", "tcg", "pricing", "api", "dexify"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+]
+
+[tool.setuptools]
+py-modules = ["dexify_python"]

dexify_api_client-1.0.0b4/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+