{"id":24124,"library":"ntropy-sdk","title":"Ntropy SDK","description":"SDK for the Ntropy API, enabling financial transaction enrichment and categorization. Current version 5.3.0, actively maintained with weekly releases.","status":"active","version":"5.3.0","language":"python","source_language":"en","source_url":"https://github.com/ntropy-network/ntropy-sdk","tags":["financial","transaction","enrichment","sdk","ntropy"],"install":[{"cmd":"pip install ntropy-sdk","lang":"bash","label":"Latest release"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false}],"imports":[{"note":"Top-level module not importable; use ntropy_sdk package","wrong":"import ntropy","symbol":"Ntropy","correct":"from ntropy_sdk import Ntropy"},{"note":"Error classes are exported directly from ntropy_sdk since v4","wrong":"from ntropy_sdk.errors import NtropyError","symbol":"NtropyError","correct":"from ntropy_sdk import NtropyError"}],"quickstart":{"code":"from ntropy_sdk import Ntropy\nimport os\n\napi_key = os.environ.get('NTROPY_API_KEY', '')\nsdk = Ntropy(api_key)\ntry:\n    account_holder = sdk.account_holders.create(type='business', business_name='Test Inc')\n    print(account_holder.id)\nexcept Exception as e:\n    print(e)","lang":"python","description":"Initialize SDK with API key and create an account holder (requires NTROPY_API_KEY environment variable)."},"warnings":[{"fix":"Use 'async with ntropy_sdk.Ntropy(api_key) as sdk:' pattern for async operations, or rely on default sync mode in v5.3.","message":"The SDK v4.x deprecated synchronous client initialization; ntropy_sdk.Ntropy now requires async context manager in newer versions.","severity":"deprecated","affected_versions":">=5.0.0"},{"fix":"Ensure all transaction creates include 'description' and 'amount'.","message":"In v5, the 'Transaction' model fields 'description' and 'amount' are mandatory; previously they were optional.","severity":"breaking","affected_versions":"5.0.0 - 5.3.0"},{"fix":"Set NTROPY_API_KEY environment variable before using SDK.","message":"API key is required but can be set via environment variable NTROPY_API_KEY. The SDK reads this automatically if no argument is passed to Ntropy().","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Set NTROPY_API_KEY environment variable or pass api_key='your_key_here'.","cause":"Ntropy() called without API key argument and NTROPY_API_KEY not set in environment.","error":"TypeError: __init__() missing 1 required positional argument: 'api_key'"},{"fix":"Verify your API key at https://dashboard.ntropy.com/ and pass the correct one.","cause":"Invalid or expired API key.","error":"ntropy_sdk.exceptions.NtropyError: 401 - Unauthorized"},{"fix":"Change import to 'from ntropy_sdk import Ntropy'.","cause":"Importing from old package name 'ntropy' (pre-v3) instead of 'ntropy_sdk'.","error":"AttributeError: module 'ntropy_sdk' has no attribute 'Ntropy'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}