coinxview 1.0.0__tar.gz

coinxview-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CoinXview
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

coinxview-1.0.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: coinxview
+Version: 1.0.0
+Summary: Free crypto price API client: prices, market cap, OHLC candles, Fear & Greed and risk scores. No API key, no dependencies.
+Author: CoinXview
+License: MIT
+Project-URL: Homepage, https://coinxview.com/free-crypto-api
+Project-URL: Documentation, https://coinxview.com/free-crypto-api
+Keywords: crypto,cryptocurrency,bitcoin,ethereum,price,api,market cap,ohlc,fear and greed
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# coinxview
+
+Free crypto price API client for Python. Prices, market cap, OHLC candles, Fear & Greed and risk scores for 1,000+ coins, aggregated from 20+ exchanges.
+
+- No API key, no signup
+- Standard library only (no dependencies), Python 3.8+
+- Type hints included
+
+Full API docs: **https://coinxview.com/free-crypto-api**
+
+## Install
+
+```bash
+pip install coinxview
+```
+
+## Examples
+
+```python
+import coinxview
+
+# 1. Prices for a few coins
+for c in coinxview.coins(symbols=["BTC", "ETH", "SOL"])["data"]:
+    print(c["symbol"], c["price_usd"])
+
+# 2. Top 100 by market cap
+top = coinxview.coins(limit=100)
+
+# 3. One coin: markets, supply, 24h high / low
+btc = coinxview.coin("BTC")
+
+# 4. Daily candles: [time, open, high, low, close, volume]
+candles = coinxview.ohlc("ETH", interval="1d", limit=30)
+
+# 5. Market overview, Fear & Greed, risk score
+overview = coinxview.global_()      # "global" is a Python keyword
+fg = coinxview.fear_greed()
+risk = coinxview.risk("DOGE")
+```
+
+Or create a client with your own timeout:
+
+```python
+from coinxview import CoinXview
+cx = CoinXview(timeout=10)
+cx.coins(limit=10)
+```
+
+## Methods
+
+| Method | Endpoint |
+|---|---|
+| `coins(symbols=None, limit=None, start=None)` | `GET /api/v1/coins` |
+| `coin(symbol)` | `GET /api/v1/coins/:symbol` |
+| `global_()` | `GET /api/v1/global` |
+| `fear_greed()` | `GET /api/v1/fear-greed` |
+| `ohlc(symbol, interval="1d", limit=None)` | `GET /api/v1/ohlc/:symbol` — interval `1h`, `4h`, `1d`, `1w` |
+| `risk(symbol)` | `GET /api/v1/risk/:symbol` |
+
+Responses are returned as-is (same field names as the API docs).
+
+## Errors and limits
+
+Rate limit: **60 requests per minute per IP**. Over the limit, calls raise `CoinXviewError` with `status == 429`. Other HTTP errors raise `CoinXviewError` with the HTTP `status` and the response `body`.
+
+```python
+from coinxview import CoinXviewError
+try:
+    coinxview.coin("NOPE")
+except CoinXviewError as e:
+    print(e.status)
+```
+
+## Attribution
+
+Data by [CoinXview](https://coinxview.com) — please keep attribution when you show this data.
+
+## License
+
+MIT

coinxview-1.0.0/README.md

@@ -0,0 +1,80 @@
+# coinxview
+
+Free crypto price API client for Python. Prices, market cap, OHLC candles, Fear & Greed and risk scores for 1,000+ coins, aggregated from 20+ exchanges.
+
+- No API key, no signup
+- Standard library only (no dependencies), Python 3.8+
+- Type hints included
+
+Full API docs: **https://coinxview.com/free-crypto-api**
+
+## Install
+
+```bash
+pip install coinxview
+```
+
+## Examples
+
+```python
+import coinxview
+
+# 1. Prices for a few coins
+for c in coinxview.coins(symbols=["BTC", "ETH", "SOL"])["data"]:
+    print(c["symbol"], c["price_usd"])
+
+# 2. Top 100 by market cap
+top = coinxview.coins(limit=100)
+
+# 3. One coin: markets, supply, 24h high / low
+btc = coinxview.coin("BTC")
+
+# 4. Daily candles: [time, open, high, low, close, volume]
+candles = coinxview.ohlc("ETH", interval="1d", limit=30)
+
+# 5. Market overview, Fear & Greed, risk score
+overview = coinxview.global_()      # "global" is a Python keyword
+fg = coinxview.fear_greed()
+risk = coinxview.risk("DOGE")
+```
+
+Or create a client with your own timeout:
+
+```python
+from coinxview import CoinXview
+cx = CoinXview(timeout=10)
+cx.coins(limit=10)
+```
+
+## Methods
+
+| Method | Endpoint |
+|---|---|
+| `coins(symbols=None, limit=None, start=None)` | `GET /api/v1/coins` |
+| `coin(symbol)` | `GET /api/v1/coins/:symbol` |
+| `global_()` | `GET /api/v1/global` |
+| `fear_greed()` | `GET /api/v1/fear-greed` |
+| `ohlc(symbol, interval="1d", limit=None)` | `GET /api/v1/ohlc/:symbol` — interval `1h`, `4h`, `1d`, `1w` |
+| `risk(symbol)` | `GET /api/v1/risk/:symbol` |
+
+Responses are returned as-is (same field names as the API docs).
+
+## Errors and limits
+
+Rate limit: **60 requests per minute per IP**. Over the limit, calls raise `CoinXviewError` with `status == 429`. Other HTTP errors raise `CoinXviewError` with the HTTP `status` and the response `body`.
+
+```python
+from coinxview import CoinXviewError
+try:
+    coinxview.coin("NOPE")
+except CoinXviewError as e:
+    print(e.status)
+```
+
+## Attribution
+
+Data by [CoinXview](https://coinxview.com) — please keep attribution when you show this data.
+
+## License
+
+MIT

coinxview-1.0.0/coinxview/__init__.py

@@ -0,0 +1,92 @@
+"""CoinXview API v1 client — https://coinxview.com/free-crypto-api
+
+Standard library only (urllib). Python >= 3.8.
+"""
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Iterable, Optional, Union
+
+__version__ = "1.0.0"
+__all__ = ["CoinXview", "CoinXviewError", "coins", "coin", "global_", "fear_greed", "ohlc", "risk"]
+
+DEFAULT_BASE = "https://coinxview.com/api/v1"
+
+
+class CoinXviewError(Exception):
+    """HTTP or network error. ``status`` is the HTTP status (0 for network errors)."""
+
+    def __init__(self, message: str, status: int = 0, body: Any = None) -> None:
+        super().__init__(message)
+        self.status = status
+        self.body = body
+
+
+class CoinXview:
+    def __init__(self, base_url: str = DEFAULT_BASE, timeout: float = 15.0) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def _get(self, path: str, query: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        q = {}
+        for k, v in (query or {}).items():
+            if v is None or v == "":
+                continue
+            if isinstance(v, (list, tuple)):
+                v = ",".join(str(x) for x in v)
+            q[k] = v
+        url = self.base_url + path + ("?" + urllib.parse.urlencode(q) if q else "")
+        req = urllib.request.Request(url, headers={"Accept": "application/json", "User-Agent": "coinxview-python/" + __version__})
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                return json.loads(r.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            raw = e.read().decode("utf-8", "replace")
+            try:
+                body: Any = json.loads(raw)
+            except ValueError:
+                body = raw
+            if e.code == 429:
+                raise CoinXviewError("coinxview: rate limit 60/min per IP exceeded, retry in a minute", 429, body) from None
+            msg = body.get("error") if isinstance(body, dict) else None
+            raise CoinXviewError("coinxview: HTTP %d%s" % (e.code, " - " + msg if msg else ""), e.code, body) from None
+        except (urllib.error.URLError, TimeoutError, OSError) as e:
+            raise CoinXviewError("coinxview: request failed: %s" % e, 0, None) from None
+
+    def coins(self, symbols: Optional[Union[str, Iterable[str]]] = None, limit: Optional[int] = None, start: Optional[int] = None) -> Dict[str, Any]:
+        """Coin list sorted by market cap. ``symbols`` (max 50) or ``limit`` / ``start``."""
+        if symbols is not None and not isinstance(symbols, str):
+            symbols = list(symbols)
+        return self._get("/coins", {"symbols": symbols, "limit": limit, "start": start})
+
+    def coin(self, symbol: str) -> Dict[str, Any]:
+        """One coin with markets, supply and risk breakdown."""
+        return self._get("/coins/" + urllib.parse.quote(symbol.upper()))
+
+    def global_(self) -> Dict[str, Any]:
+        """Total market cap, volume, dominance, Fear & Greed. (``global`` is a Python keyword.)"""
+        return self._get("/global")
+
+    def fear_greed(self) -> Dict[str, Any]:
+        """Fear & Greed index now + 90 days of history."""
+        return self._get("/fear-greed")
+
+    def ohlc(self, symbol: str, interval: str = "1d", limit: Optional[int] = None) -> Dict[str, Any]:
+        """Candles [time, open, high, low, close, volume]. interval: 1h, 4h, 1d, 1w."""
+        return self._get("/ohlc/" + urllib.parse.quote(symbol.upper()), {"interval": interval, "limit": limit})
+
+    def risk(self, symbol: str) -> Dict[str, Any]:
+        """CoinXview Risk Score (0-100) with its 5 components."""
+        return self._get("/risk/" + urllib.parse.quote(symbol.upper()))
+
+
+_client = CoinXview()
+coins = _client.coins
+coin = _client.coin
+global_ = _client.global_
+fear_greed = _client.fear_greed
+ohlc = _client.ohlc
+risk = _client.risk

coinxview-1.0.0/coinxview.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: coinxview
+Version: 1.0.0
+Summary: Free crypto price API client: prices, market cap, OHLC candles, Fear & Greed and risk scores. No API key, no dependencies.
+Author: CoinXview
+License: MIT
+Project-URL: Homepage, https://coinxview.com/free-crypto-api
+Project-URL: Documentation, https://coinxview.com/free-crypto-api
+Keywords: crypto,cryptocurrency,bitcoin,ethereum,price,api,market cap,ohlc,fear and greed
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# coinxview
+
+Free crypto price API client for Python. Prices, market cap, OHLC candles, Fear & Greed and risk scores for 1,000+ coins, aggregated from 20+ exchanges.
+
+- No API key, no signup
+- Standard library only (no dependencies), Python 3.8+
+- Type hints included
+
+Full API docs: **https://coinxview.com/free-crypto-api**
+
+## Install
+
+```bash
+pip install coinxview
+```
+
+## Examples
+
+```python
+import coinxview
+
+# 1. Prices for a few coins
+for c in coinxview.coins(symbols=["BTC", "ETH", "SOL"])["data"]:
+    print(c["symbol"], c["price_usd"])
+
+# 2. Top 100 by market cap
+top = coinxview.coins(limit=100)
+
+# 3. One coin: markets, supply, 24h high / low
+btc = coinxview.coin("BTC")
+
+# 4. Daily candles: [time, open, high, low, close, volume]
+candles = coinxview.ohlc("ETH", interval="1d", limit=30)
+
+# 5. Market overview, Fear & Greed, risk score
+overview = coinxview.global_()      # "global" is a Python keyword
+fg = coinxview.fear_greed()
+risk = coinxview.risk("DOGE")
+```
+
+Or create a client with your own timeout:
+
+```python
+from coinxview import CoinXview
+cx = CoinXview(timeout=10)
+cx.coins(limit=10)
+```
+
+## Methods
+
+| Method | Endpoint |
+|---|---|
+| `coins(symbols=None, limit=None, start=None)` | `GET /api/v1/coins` |
+| `coin(symbol)` | `GET /api/v1/coins/:symbol` |
+| `global_()` | `GET /api/v1/global` |
+| `fear_greed()` | `GET /api/v1/fear-greed` |
+| `ohlc(symbol, interval="1d", limit=None)` | `GET /api/v1/ohlc/:symbol` — interval `1h`, `4h`, `1d`, `1w` |
+| `risk(symbol)` | `GET /api/v1/risk/:symbol` |
+
+Responses are returned as-is (same field names as the API docs).
+
+## Errors and limits
+
+Rate limit: **60 requests per minute per IP**. Over the limit, calls raise `CoinXviewError` with `status == 429`. Other HTTP errors raise `CoinXviewError` with the HTTP `status` and the response `body`.
+
+```python
+from coinxview import CoinXviewError
+try:
+    coinxview.coin("NOPE")
+except CoinXviewError as e:
+    print(e.status)
+```
+
+## Attribution
+
+Data by [CoinXview](https://coinxview.com) — please keep attribution when you show this data.
+
+## License
+
+MIT

coinxview-1.0.0/coinxview.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+coinxview/__init__.py
+coinxview/py.typed
+coinxview.egg-info/PKG-INFO
+coinxview.egg-info/SOURCES.txt
+coinxview.egg-info/dependency_links.txt
+coinxview.egg-info/top_level.txt

coinxview-1.0.0/coinxview.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

coinxview-1.0.0/coinxview.egg-info/top_level.txt

@@ -0,0 +1 @@
+coinxview

coinxview-1.0.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "coinxview"
+version = "1.0.0"
+description = "Free crypto price API client: prices, market cap, OHLC candles, Fear & Greed and risk scores. No API key, no dependencies."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "CoinXview" }]
+keywords = ["crypto", "cryptocurrency", "bitcoin", "ethereum", "price", "api", "market cap", "ohlc", "fear and greed"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Topic :: Office/Business :: Financial",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://coinxview.com/free-crypto-api"
+Documentation = "https://coinxview.com/free-crypto-api"
+
+[tool.setuptools]
+packages = ["coinxview"]
+
+[tool.setuptools.package-data]
+coinxview = ["py.typed"]

coinxview-1.0.0/setup.cfg

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