IsBrokerSafe Python SDK 🛡️⚡

The official Python client library for the IsBrokerSafe.com Threat Intelligence and Financial Broker Legitimacy API.

Audit any Forex broker, Crypto platform, or CFD entity in real-time across 9,732+ official regulatory records (8,995+ scam warnings & 737+ licensed brokers) and 82+ Worldwide Supervisory Authorities (IOSCO Network) (IOSCO, SEC, CFTC, NFA, FCA, BaFin, FINMA, AMF, CNMV, CONSOB, CySEC, CSSF, FSMA, ASIC, SFC, CSA, MAS, DFSA) with sub-5ms latency and WHOIS forensic age inspection.

📦 Installation

pip install --upgrade isbrokersafe

(Zero external dependencies! Works right out of the box with the Python standard library).

🚀 Quickstart

import isbrokersafe

# Initialize with your API key (or leave empty for anonymous free tier)
client = isbrokersafe.Client(api_key="YOUR_API_KEY")

# 1. Audit a broker or crypto domain
result = client.check("exness.com")

print(f"Status: {result.status}")                 # 'SAFE'
print(f"Safety Score: {result.safety_score}/100") # 96
print(f"Is Regulated: {result.is_regulated}")     # True
print(f"Regulators: {result.regulators}")         # ['FCA (UK), CySEC (Cyprus), FSCA, FSA']
print(f"Verdict: {result.trust_verdict}")

# 2. Check for scam / blacklisted domain
scam = client.check("cryptonomy.finance")
print(f"Status: {scam.status}")                   # 'BLACKLISTED'
print(f"Risk Factors: {scam.risk_factors}")       # ['BLACKLISTED BY ASIC (Australia)']

# 3. Search the 737+ Licensed & Regulated Brokers Registry
licensed = client.get_licensed(regulator="FINMA", limit=10)
for b in licensed["results"]:
    print(f"{b['entity_name']} ({b['domain']}) - {b['regulator']} [{b['license_number']}]")

🔍 Features

• 🏛️ Real-Time Regulatory Verification: Audits official license statuses from 737+ licensed financial institutions across Tier-1 & EU MiFID II / Swiss regulators (FCA, SEC/NFA, FINMA, CySEC, ASIC, BaFin, CONSOB, AMF, CNMV, MAS, DFSA).
• 🚨 Global Blacklist Feeds (8,995+ Alerts): Cross-references international enforcement warnings from IOSCO (82 Global Authorities), ASIC, SFC Hong Kong, CySEC, CSSF Luxembourg, US SEC, CONSOB, FSMA Belgium, and UK FCA.
• 🌐 WHOIS Forensic Age Inspection: Detects newly registered domains claiming false regulatory history.
• ⚡ Ultra-Fast & Lightweight: Sub-5ms response times worldwide.

📖 Advanced Usage

Fetching Latest Regulatory Warnings

warnings = client.get_warnings(regulator="asic", limit=20)

for w in warnings:
    print(f"[{w.warning_date}] {w.entity_name} ({w.domain}) - {w.reason}")

Querying Licensed & Regulated Brokers

licensed_data = client.get_licensed(query="swissquote", limit=10)
print(f"Total matching licensed institutions: {licensed_data['total_matching']}")

Global Threat Intelligence Stats

stats = client.get_stats()
print(f"Total Official Records: {stats.total_brokers:,}")
print(f"Regulated Institutions: {stats.regulated_entities:,}")
print(f"Blacklisted Scam Alerts: {stats.blacklisted_entities:,}")
print(f"Global Regulators Monitored: {stats.total_regulators_monitored}+")

Error Handling

from isbrokersafe import AuthenticationError, QuotaExceededError, IsBrokerSafeError

try:
    result = client.check("suspicious-broker.com")
except AuthenticationError:
    print("Invalid API Key! Get one free at https://isbrokersafe.com/api/v1/docs")
except QuotaExceededError:
    print("Monthly quota exceeded. Upgrade to Pro at https://isbrokersafe.com/pricing")
except IsBrokerSafeError as e:
    print(f"API Error: {e}")

🔑 Obtaining an API Key

Generate a free developer API key (100 requests/month) instantly at:
👉 https://isbrokersafe.com/api/v1/docs

📄 License

Distributed under the MIT License. Copyright © 2026 VasileDev Group (EU VIES: IT04226190041).