ofac-sanctions-screening 0.1.0__py3-none-any.whl

ofac_sanctions_screening/__init__.py

@@ -0,0 +1,136 @@
+"""ofac-sanctions-screening — OFAC / sanctions / PEP / KYB screening for Python.
+
+Screen any person, company, or crypto wallet against OFAC SDN, EU, UK (OFSI),
+UN + 100+ global watchlists (OpenSanctions) and get a PASS / WARN / BLOCK verdict.
+
+Free demo (no key, rate-limited):
+    from ofac_sanctions_screening import Client
+    c = Client()
+    print(c.screen("Vladimir Putin"))          # sanctions / PEP screen
+    print(c.screen_wallet("1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"))  # OFAC SDN crypto
+    print(c.kyb("Acme Inc"))                    # KYB screen
+
+Paid (real data, full coverage) — get a key at https://api.gocreativeai.com/credits/buy
+(card, instant) or pay-per-call in USDC via x402:
+    c = Client(api_key="gck_...")
+    print(c.verdict("Some Person"))            # one PASS / WARN / BLOCK decision
+"""
+import json
+import urllib.request
+import urllib.error
+import urllib.parse
+
+__version__ = "0.1.0"
+__all__ = ["Client", "ComplianceError"]
+
+_BASE = "https://api.gocreativeai.com"
+
+
+class ComplianceError(Exception):
+    """Raised on API/transport errors."""
+
+
+class Client:
+    """Client for the GoCreative OFAC / Sanctions / KYB screening API.
+
+    Args:
+        api_key: a ``gck_...`` key from https://api.gocreativeai.com/credits/buy.
+                 If omitted, the client uses the free, rate-limited demo endpoints.
+        base_url: override the API base (default https://api.gocreativeai.com).
+        timeout: request timeout in seconds (default 30).
+    """
+
+    def __init__(self, api_key=None, base_url=_BASE, timeout=30):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    # -- internals --
+    @staticmethod
+    def _enc(value):
+        return urllib.parse.quote(str(value), safe="")
+
+    def _get(self, path):
+        req = urllib.request.Request(self.base_url + path)
+        req.add_header("User-Agent", "ofac-sanctions-screening-py/" + __version__)
+        req.add_header("Accept", "application/json")
+        if self.api_key:
+            req.add_header("Authorization", "Bearer " + self.api_key)
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as exc:
+            if exc.code == 402:
+                raise ComplianceError(
+                    "Payment required. Pass api_key=... (get one instantly with a card at "
+                    "https://api.gocreativeai.com/credits/buy) or use the free demo methods."
+                ) from None
+            if exc.code == 429:
+                raise ComplianceError(
+                    "Rate limit / free-demo quota reached. Add an api_key for full access."
+                ) from None
+            body = exc.read().decode("utf-8", "replace")[:300]
+            raise ComplianceError("HTTP %s: %s" % (exc.code, body)) from None
+        except urllib.error.URLError as exc:
+            raise ComplianceError("Network error: %s" % exc.reason) from None
+
+    @property
+    def _paid(self):
+        return bool(self.api_key)
+
+    # -- public methods --
+    def screen(self, name):
+        """Sanctions & PEP screen a person or company (OFAC, EU, UK, UN + 100+ lists)."""
+        path = ("/v1/verdict/screen/" if self._paid else "/demo/sanctions/") + self._enc(name)
+        return self._get(path)
+
+    def screen_wallet(self, address):
+        """OFAC-screen a Bitcoin/Ethereum wallet address against the OFAC SDN crypto list."""
+        path = ("/v1/verdict/wallet/" if self._paid else "/demo/ofac-wallet/") + self._enc(address)
+        return self._get(path)
+
+    def kyb(self, name):
+        """KYB screen a company (sanctions + entity risk + registry + legal)."""
+        path = ("/v1/verdict/kyb/" if self._paid else "/demo/kyb/") + self._enc(name)
+        return self._get(path)
+
+    def verdict(self, name):
+        """One PASS / WARN / BLOCK compliance decision (paid — requires api_key)."""
+        if not self._paid:
+            raise ComplianceError(
+                "verdict() is a paid endpoint. Get a key at "
+                "https://api.gocreativeai.com/credits/buy, then Client(api_key=...)."
+            )
+        return self._get("/v1/verdict/check/" + self._enc(name))
+
+    def screening_report(self, name):
+        """Audit-ready sanctions/PEP screening REPORT — documented evidence (FCA/EU-AML) that
+        screening was performed, with name-variants tested, methodology, PASS/REVIEW/BLOCK + audit id.
+        Works free (rate-limited) without a key; full report with an api_key."""
+        path = ("/v1/verdict/screening-report/" if self._paid else "/demo/screening-report/") + self._enc(name)
+        return self._get(path)
+
+    def wallet_report(self, address):
+        """Audit-ready crypto-wallet OFAC screening report (VASP Travel-Rule / FinCEN evidence).
+        Works free (rate-limited) without a key; full report with an api_key."""
+        path = ("/v1/verdict/wallet-report/" if self._paid else "/demo/wallet-report/") + self._enc(address)
+        return self._get(path)
+
+    def batch_screen(self, names):
+        """Bulk sanctions/PEP screen — up to 25 comma-separated names in one call. Free demo without a key."""
+        path = ("/v1/verdict/batch-screen/" if self._paid else "/demo/batch-screen/") + self._enc(names)
+        return self._get(path)
+
+    def kyb_report(self, name):
+        """Audit-ready KYB / vendor due-diligence report (procurement / EU CSDDD evidence). Paid (requires api_key)."""
+        if not self._paid:
+            raise ComplianceError("kyb_report() is a paid endpoint. Get a key at https://api.gocreativeai.com/credits/buy.")
+        return self._get("/v1/verdict/kyb-report/" + self._enc(name))
+
+    def risk(self, name):
+        """Entity risk score 0-100 with an onboarding flag (paid — requires api_key)."""
+        if not self._paid:
+            raise ComplianceError(
+                "risk() is a paid endpoint. Get a key at https://api.gocreativeai.com/credits/buy."
+            )
+        return self._get("/v1/risk/entity-score/" + self._enc(name))

ofac_sanctions_screening-0.1.0.dist-info/METADATA

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: ofac-sanctions-screening
+Version: 0.1.0
+Summary: OFAC, sanctions, PEP & KYB screening for Python — screen names, companies & crypto wallets against OFAC SDN, EU, UK, UN + 100+ watchlists. Free demo, no key.
+Author: GoCreative
+License: MIT
+Project-URL: Homepage, https://api.gocreativeai.com/p/compliance-screening
+Project-URL: Documentation, https://api.gocreativeai.com/v1/docs
+Project-URL: Free demo, https://api.gocreativeai.com/demo/sanctions/Vladimir%20Putin
+Keywords: ofac,sanctions,sanctions-screening,aml,kyc,kyb,pep,compliance,watchlist,sdn,ofac-api,crypto-compliance,wallet-screening,opensanctions
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ofac-sanctions-screening
+
+**OFAC / sanctions / PEP / KYB screening for Python.** Screen any **person, company, or crypto wallet** against **OFAC SDN, EU, UK (OFSI), UN + 100+ global watchlists** (powered by OpenSanctions) and get a **PASS / WARN / BLOCK** verdict — in one call, with cited sources.
+
+- ✅ **Free demo, no signup** — start screening in 10 seconds, no API key.
+- 🪙 **Crypto-wallet OFAC screening** — screen BTC/ETH addresses against the OFAC SDN crypto list (most APIs only do names & companies).
+- 🏢 **KYB-360** — sanctions + PEP + entity risk + registry in one call.
+- ⚖️ **One PASS / WARN / BLOCK verdict** — no raw-list parsing.
+- 🔌 **Zero dependencies**, Python 3.8+. Pay-per-call (card or USDC via x402) — no seat license, no enterprise contract.
+
+## Install
+
+```bash
+pip install ofac-sanctions-screening
+```
+
+## Quickstart (free, no key)
+
+```python
+from ofac_sanctions_screening import Client
+
+c = Client()  # free demo mode, rate-limited
+
+# Sanctions / PEP screen a person or company
+print(c.screen("Vladimir Putin"))
+# {'result': {'flagged': True, 'match_count': 2, 'risk_topics': ['sanction', 'role.pep', ...], 'matches': [...]}}
+
+# OFAC-screen a crypto wallet against the SDN crypto list
+print(c.screen_wallet("1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"))
+
+# KYB screen a company
+print(c.kyb("Acme Inc"))
+```
+
+## Full access (paid)
+
+Get an API key instantly with a card at **https://api.gocreativeai.com/credits/buy** (or pay-per-call in USDC via [x402](https://api.gocreativeai.com/no-api-key) — no key at all):
+
+```python
+c = Client(api_key="gck_...")
+
+c.screen("Some Person")        # full sanctions & PEP coverage
+c.screen_wallet("0xabc...")    # full OFAC wallet screen
+c.kyb("Some Company Ltd")      # full KYB-360 dossier
+c.verdict("Some Person")       # one PASS / WARN / BLOCK decision
+c.risk("Some Company")         # entity risk score 0-100 + onboarding flag
+```
+
+## Methods
+
+| Method | Free demo | Paid endpoint | Returns |
+|---|---|---|---|
+| `screen(name)` | ✅ | `/v1/verdict/screen` | sanctions & PEP matches across OFAC/EU/UK/UN + 100+ lists |
+| `screen_wallet(address)` | ✅ | `/v1/verdict/wallet` | OFAC SDN crypto-wallet match |
+| `kyb(name)` | ✅ | `/v1/verdict/kyb` | KYB-360 dossier |
+| `verdict(name)` | — | `/v1/verdict/check` | PASS / WARN / BLOCK |
+| `risk(name)` | — | `/v1/risk/entity-score` | risk score 0-100 |
+
+All methods return parsed JSON (`dict`). Errors raise `ComplianceError` with a clear message (402 → how to get a key, 429 → demo quota reached).
+
+## Why this vs the incumbents
+
+Same OpenSanctions data the serious vendors use, but **keyless and pay-per-call** — a fraction of the cost of Dataspike, ComplyAdvantage, or enterprise contracts, and it adds **crypto-wallet OFAC screening** most don't. See the comparisons: [vs Dataspike](https://api.gocreativeai.com/vs/dataspike) · [vs sanctions.io](https://api.gocreativeai.com/vs/sanctions-io) · [vs ComplyAdvantage](https://api.gocreativeai.com/vs/complyadvantage).
+
+## Disclaimer
+
+Screening results draw on public watchlist + sanctions data and are provided for compliance-screening support. Verify matches before acting; absence of a match is not a guarantee of clearance. Not legal advice.
+
+## License
+
+MIT © GoCreative · [Product page](https://api.gocreativeai.com/p/compliance-screening) · [Docs](https://api.gocreativeai.com/v1/docs)

ofac_sanctions_screening-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+ofac_sanctions_screening/__init__.py,sha256=tjpgrvh7FxGxMQ2lFx_WD2BFtxrmst4vFQRc3Nv6aeg,6112
+ofac_sanctions_screening-0.1.0.dist-info/licenses/LICENSE,sha256=m_9mvjZ-xYt_pH4zl1h9jsDl9FCjU9CtfliJFLsQ4vw,1067
+ofac_sanctions_screening-0.1.0.dist-info/METADATA,sha256=reUl7wttv9Gf8zw_l7PkX8bqy7rOoWr6D01ZJLXAVZ8,4476
+ofac_sanctions_screening-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ofac_sanctions_screening-0.1.0.dist-info/top_level.txt,sha256=NjgKux8OaLrjEgmTAZbQ2lxju4TKfzYBzpBmTvkMhto,25
+ofac_sanctions_screening-0.1.0.dist-info/RECORD,,

ofac_sanctions_screening-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ofac_sanctions_screening-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GoCreative
+
+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.

ofac_sanctions_screening-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ofac_sanctions_screening