crypticorn 2.4.0__tar.gz → 2.4.2__tar.gz

{crypticorn-2.4.0 → crypticorn-2.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crypticorn
-Version: 2.4.0
+Version: 2.4.2
 Summary: Maximise Your Crypto Trading Profits with AI Predictions
 Author-email: Crypticorn <timon@crypticorn.com>
 Project-URL: Homepage, https://crypticorn.com
@@ -56,11 +56,6 @@ You can install the latest stable version from PyPi:
 pip install crypticorn
 ```
 
-If you want a specific version, run:
-```bash
-pip install crypticorn==2.0.0
-```
-
 If you want the latest version, which could be a pre release, run:
 ```bash
 pip install --pre crypticorn
@@ -72,6 +67,20 @@ Our API is available as an asynchronous Python SDK. The main entry point you nee
 ```python
 from crypticorn import ApiClient
 ```
+The ApiClient serves as the central interface for API operations. It instantiates multiple API wrappers corresponding to our microservices.
+
+Specific imports, such as request models, should be accessed through the appropriate submodules.
+
+Note: All symbols are re-exported at the first submodule layer for convenience.
+
+```python
+from crypticorn.trade import BotStatus
+```
+
+The `common` submodule contains shared classes not bound to a specific API.
+```python
+from crypticorn.common import Scope, Exchange
+```
 
 ## Usage
 
@@ -122,7 +131,7 @@ On top of that you get some information about the request:
 print(res.status_code)
 print(res.raw_data)
 print(res.headers)
-
+```
 
 ### JSON Response
 You can receive a classical JSON response by suffixing the function name with `_without_preload_content`

{crypticorn-2.4.0 → crypticorn-2.4.2}/README.md

@@ -17,11 +17,6 @@ You can install the latest stable version from PyPi:
 pip install crypticorn
 ```
 
-If you want a specific version, run:
-```bash
-pip install crypticorn==2.0.0
-```
-
 If you want the latest version, which could be a pre release, run:
 ```bash
 pip install --pre crypticorn
@@ -33,6 +28,20 @@ Our API is available as an asynchronous Python SDK. The main entry point you nee
 ```python
 from crypticorn import ApiClient
 ```
+The ApiClient serves as the central interface for API operations. It instantiates multiple API wrappers corresponding to our microservices.
+
+Specific imports, such as request models, should be accessed through the appropriate submodules.
+
+Note: All symbols are re-exported at the first submodule layer for convenience.
+
+```python
+from crypticorn.trade import BotStatus
+```
+
+The `common` submodule contains shared classes not bound to a specific API.
+```python
+from crypticorn.common import Scope, Exchange
+```
 
 ## Usage
 
@@ -83,7 +92,7 @@ On top of that you get some information about the request:
 print(res.status_code)
 print(res.raw_data)
 print(res.headers)
-
+```
 
 ### JSON Response
 You can receive a classical JSON response by suffixing the function name with `_without_preload_content`

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/auth/client/models/create_api_key_request.py

@@ -49,6 +49,7 @@ class CreateApiKeyRequest(BaseModel):
         for i in value:
             if i not in set(
                 [
+                    "read:predictions",
                     "read:hive:model",
                     "read:hive:data",
                     "write:hive:model",
@@ -71,11 +72,15 @@ class CreateApiKeyRequest(BaseModel):
                     "write:pay:products",
                     "read:pay:now",
                     "write:pay:now",
-                    "read:predictions",
+                    "read:metrics:marketcap",
+                    "read:metrics:indicators",
+                    "read:metrics:exchanges",
+                    "read:metrics:tokens",
+                    "read:metrics:markets",
                 ]
             ):
                 raise ValueError(
-                    "each list item must be one of ('read:hive:model', 'read:hive:data', 'write:hive:model', 'read:trade:bots', 'write:trade:bots', 'read:trade:exchangekeys', 'write:trade:exchangekeys', 'read:trade:orders', 'read:trade:actions', 'write:trade:actions', 'read:trade:exchanges', 'read:trade:futures', 'write:trade:futures', 'read:trade:notifications', 'write:trade:notifications', 'read:trade:strategies', 'write:trade:strategies', 'read:pay:payments', 'read:pay:products', 'write:pay:products', 'read:pay:now', 'write:pay:now', 'read:predictions')"
+                    "each list item must be one of ('read:predictions', 'read:hive:model', 'read:hive:data', 'write:hive:model', 'read:trade:bots', 'write:trade:bots', 'read:trade:exchangekeys', 'write:trade:exchangekeys', 'read:trade:orders', 'read:trade:actions', 'write:trade:actions', 'read:trade:exchanges', 'read:trade:futures', 'write:trade:futures', 'read:trade:notifications', 'write:trade:notifications', 'read:trade:strategies', 'write:trade:strategies', 'read:pay:payments', 'read:pay:products', 'write:pay:products', 'read:pay:now', 'write:pay:now', 'read:metrics:marketcap', 'read:metrics:indicators', 'read:metrics:exchanges', 'read:metrics:tokens', 'read:metrics:markets')"
                 )
         return value
 

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/auth/client/models/get_api_keys200_response_inner.py

@@ -57,6 +57,7 @@ class GetApiKeys200ResponseInner(BaseModel):
         for i in value:
             if i not in set(
                 [
+                    "read:predictions",
                     "read:hive:model",
                     "read:hive:data",
                     "write:hive:model",
@@ -79,11 +80,15 @@ class GetApiKeys200ResponseInner(BaseModel):
                     "write:pay:products",
                     "read:pay:now",
                     "write:pay:now",
-                    "read:predictions",
+                    "read:metrics:marketcap",
+                    "read:metrics:indicators",
+                    "read:metrics:exchanges",
+                    "read:metrics:tokens",
+                    "read:metrics:markets",
                 ]
             ):
                 raise ValueError(
-                    "each list item must be one of ('read:hive:model', 'read:hive:data', 'write:hive:model', 'read:trade:bots', 'write:trade:bots', 'read:trade:exchangekeys', 'write:trade:exchangekeys', 'read:trade:orders', 'read:trade:actions', 'write:trade:actions', 'read:trade:exchanges', 'read:trade:futures', 'write:trade:futures', 'read:trade:notifications', 'write:trade:notifications', 'read:trade:strategies', 'write:trade:strategies', 'read:pay:payments', 'read:pay:products', 'write:pay:products', 'read:pay:now', 'write:pay:now', 'read:predictions')"
+                    "each list item must be one of ('read:predictions', 'read:hive:model', 'read:hive:data', 'write:hive:model', 'read:trade:bots', 'write:trade:bots', 'read:trade:exchangekeys', 'write:trade:exchangekeys', 'read:trade:orders', 'read:trade:actions', 'write:trade:actions', 'read:trade:exchanges', 'read:trade:futures', 'write:trade:futures', 'read:trade:notifications', 'write:trade:notifications', 'read:trade:strategies', 'write:trade:strategies', 'read:pay:payments', 'read:pay:products', 'write:pay:products', 'read:pay:now', 'write:pay:now', 'read:metrics:marketcap', 'read:metrics:indicators', 'read:metrics:exchanges', 'read:metrics:tokens', 'read:metrics:markets')"
                 )
         return value
 

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/cli/__init__.py

@@ -1,3 +1,3 @@
 from crypticorn.cli.init import init_group
 
-__all__ = ["init_group"]
+__all__ = ["init_group"]

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/cli/__main__.py

@@ -3,12 +3,14 @@
 import click
 from crypticorn.cli import init_group
 
+
 @click.group()
 def cli():
     """🧙 Crypticorn CLI — magic for our microservices."""
     pass
 
+
 cli.add_command(init_group, name="init")
 
 if __name__ == "__main__":
-    cli()
+    cli()

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/cli/init.py

@@ -4,16 +4,24 @@ import subprocess
 import importlib.resources as pkg_resources
 import crypticorn.cli.templates as templates
 
+
 def get_git_root() -> Path:
-    '''Get the root directory of the git repository.'''
+    """Get the root directory of the git repository."""
     try:
-        return Path(subprocess.check_output(["git", "rev-parse", "--show-toplevel"], text=True).strip())
+        return Path(
+            subprocess.check_output(
+                ["git", "rev-parse", "--show-toplevel"], text=True
+            ).strip()
+        )
     except Exception:
         return Path.cwd()
 
+
 def copy_template(template_name: str, target_path: Path):
-    '''Copy a template file to the target path.'''
-    with pkg_resources.files(templates).joinpath(template_name).open("r") as template_file:
+    """Copy a template file to the target path."""
+    with pkg_resources.files(templates).joinpath(template_name).open(
+        "r"
+    ) as template_file:
         content = template_file.read()
 
     target_path.parent.mkdir(parents=True, exist_ok=True)
@@ -22,13 +30,15 @@ def copy_template(template_name: str, target_path: Path):
 
     click.secho(f"✅ Created: {target_path}", fg="green")
 
+
 @click.group()
 def init_group():
     """Initialize files like CI configs, linters, etc."""
     pass
 
+
 @init_group.command("ruff")
-@click.option('-f', '--force', is_flag=True, help='Force overwrite the ruff.yml')
+@click.option("-f", "--force", is_flag=True, help="Force overwrite the ruff.yml")
 def init_ruff(force):
     """Add .github/workflows/ruff.yml"""
     root = get_git_root()
@@ -38,9 +48,12 @@ def init_ruff(force):
         return
     copy_template("ruff.yml", target)
 
+
 @init_group.command("docker")
-@click.option('-o', '--output', type=click.Path(), help='Custom output path for the Dockerfile')
-@click.option('-f', '--force', is_flag=True, help='Force overwrite the Dockerfile')
+@click.option(
+    "-o", "--output", type=click.Path(), help="Custom output path for the Dockerfile"
+)
+@click.option("-f", "--force", is_flag=True, help="Force overwrite the Dockerfile")
 def init_docker(output, force):
     """Add Dockerfile"""
     root = get_git_root()
@@ -51,9 +64,12 @@ def init_docker(output, force):
     copy_template("Dockerfile", target)
     click.secho("Make sure to update the Dockerfile", fg="yellow")
 
+
 @init_group.command("auth")
-@click.option('-o', '--output', type=click.Path(), help='Custom output path for the auth handler')
-@click.option('-f', '--force', is_flag=True, help='Force overwrite the auth handler')
+@click.option(
+    "-o", "--output", type=click.Path(), help="Custom output path for the auth handler"
+)
+@click.option("-f", "--force", is_flag=True, help="Force overwrite the auth handler")
 def init_auth(output, force):
     """Add auth.py with auth handler. Everything you need to start using the auth service."""
     root = get_git_root()
@@ -65,17 +81,21 @@ def init_auth(output, force):
         click.secho("File already exists, use --force / -f to overwrite", fg="red")
         return
     copy_template("auth.py", target)
-    click.secho('''
+    click.secho(
+        """
     Make sure to update the .env file with:
         IS_DOCKER=0
         API_ENV=local
     and the docker-compose.yml file with:
         environment:
             - IS_DOCKER=1
-    ''', fg="yellow")
+    """,
+        fg="yellow",
+    )
+
 
 @init_group.command("dependabot")
-@click.option('-f', '--force', is_flag=True, help='Force overwrite the dependabot.yml')
+@click.option("-f", "--force", is_flag=True, help="Force overwrite the dependabot.yml")
 def init_dependabot(force):
     """Add dependabot.yml"""
     root = get_git_root()

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/cli/templates/auth.py

@@ -18,10 +18,14 @@ DOCKER_ENV = os.getenv("IS_DOCKER")
 API_ENV = os.getenv("API_ENV")
 
 if not DOCKER_ENV:
-    raise ValueError("IS_DOCKER is not set. Please set it to '0' in .env and '1' in the docker-compose.yml file.")
+    raise ValueError(
+        "IS_DOCKER is not set. Please set it to '0' in .env and '1' in the docker-compose.yml file."
+    )
 
 if not API_ENV:
-    raise ValueError("API_ENV is not set. Please set it to 'prod', 'dev' or 'local' in .env (of type ApiEnv).")
+    raise ValueError(
+        "API_ENV is not set. Please set it to 'prod', 'dev' or 'local' in .env (of type ApiEnv)."
+    )
 
 if DOCKER_ENV == "0":
     logger.info(f"Using {API_ENV} environment")
@@ -31,4 +35,4 @@ else:
     logger.info("Using docker environment")
 
 auth_handler = AuthHandler(base_url=base_url)
-logger.info(f"Auth URL: {auth_handler.client.config.host}")
+logger.info(f"Auth URL: {auth_handler.client.config.host}")

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/common/enums.py

@@ -1,5 +1,6 @@
 from enum import StrEnum
 
+
 class ValidateEnumMixin:
     """
     Mixin for validating enum values manually.
@@ -18,6 +19,7 @@ class ValidateEnumMixin:
 
     Order of inheritance matters — the mixin must come first.
     """
+
     @classmethod
     def validate(cls, value) -> bool:
         try:
@@ -26,13 +28,17 @@ class ValidateEnumMixin:
         except ValueError:
             return False
 
+
 class Exchange(ValidateEnumMixin, StrEnum):
     """Supported exchanges for trading"""
+
     KUCOIN = "kucoin"
     BINGX = "bingx"
 
+
 class InternalExchange(ValidateEnumMixin, StrEnum):
     """All exchanges we are using, including public (Exchange)"""
+
     KUCOIN = "kucoin"
     BINGX = "bingx"
     BINANCE = "binance"
@@ -40,9 +46,11 @@ class InternalExchange(ValidateEnumMixin, StrEnum):
     HYPERLIQUID = "hyperliquid"
     BITGET = "bitget"
 
+
 class MarketType(ValidateEnumMixin, StrEnum):
     """
     Market types
     """
+
     SPOT = "spot"
     FUTURES = "futures"

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/common/errors.py

@@ -1,5 +1,6 @@
 from enum import Enum, EnumMeta
 import logging
+from fastapi import status
 
 logger = logging.getLogger(__name__)
 
@@ -58,7 +59,7 @@ class ApiErrorIdentifier(str, Enum):
     INSUFFICIENT_SCOPES = "insufficient_scopes"
     INVALID_API_KEY = "invalid_api_key"
     INVALID_BEARER = "invalid_bearer"
-    INVALID_EXCHANGE_API_KEY = "invalid_exchange_api_key"
+    INVALID_EXCHANGE_KEY = "invalid_exchange_key"
     INVALID_MARGIN_MODE = "invalid_margin_mode"
     INVALID_PARAMETER = "invalid_parameter_provided"
     JWT_EXPIRED = "jwt_expired"
@@ -67,6 +68,7 @@ class ApiErrorIdentifier(str, Enum):
     NO_CREDENTIALS = "no_credentials"
     NOW_API_DOWN = "now_api_down"
     OBJECT_NOT_FOUND = "object_not_found"
+    OBJECT_ALREADY_EXISTS = "object_already_exists"
     ORDER_ALREADY_FILLED = "order_is_already_filled"
     ORDER_IN_PROCESS = "order_is_being_processed"
     ORDER_LIMIT_EXCEEDED = "order_quantity_limit_exceeded"
@@ -105,7 +107,7 @@ class ApiErrorLevel(str, Enum):
 
 
 class ApiError(Enum, metaclass=Fallback):
-    """API error codes"""
+    """API error codes. Fallback to UNKNOWN_ERROR for error codes not yet published to PyPI."""
 
     ALLOCATION_BELOW_EXPOSURE = (
         ApiErrorIdentifier.ALLOCATION_BELOW_EXPOSURE,
@@ -252,8 +254,8 @@ class ApiError(Enum, metaclass=Fallback):
         ApiErrorType.USER_ERROR,
         ApiErrorLevel.ERROR,
     )
-    INVALID_EXCHANGE_API_KEY = (
-        ApiErrorIdentifier.INVALID_EXCHANGE_API_KEY,
+    INVALID_EXCHANGE_KEY = (
+        ApiErrorIdentifier.INVALID_EXCHANGE_KEY,
         ApiErrorType.SERVER_ERROR,
         ApiErrorLevel.ERROR,
     )
@@ -297,6 +299,11 @@ class ApiError(Enum, metaclass=Fallback):
         ApiErrorType.SERVER_ERROR,
         ApiErrorLevel.ERROR,
     )
+    OBJECT_ALREADY_EXISTS = (
+        ApiErrorIdentifier.OBJECT_ALREADY_EXISTS,
+        ApiErrorType.SERVER_ERROR,
+        ApiErrorLevel.ERROR,
+    )
     ORDER_ALREADY_FILLED = (
         ApiErrorIdentifier.ORDER_ALREADY_FILLED,
         ApiErrorType.SERVER_ERROR,
@@ -426,17 +433,115 @@ class ApiError(Enum, metaclass=Fallback):
 
     @property
     def identifier(self) -> str:
+        """Identifier of the error."""
         return self.value[0]
 
     @property
     def type(self) -> ApiErrorType:
+        """Type of the error."""
         return self.value[1]
 
     @property
     def level(self) -> ApiErrorLevel:
+        """Level of the error."""
         return self.value[2]
+    
+    @property
+    def status_code(self) -> int:
+        """HTTP status code for the error."""
+        return HttpStatusMapper.get_status_code(self)
+
+
+class HttpStatusMapper:
+    """Map API errors to HTTP status codes."""
+    # TODO: decide if we need all of these mappings, since most errors are not exposed to the client via HTTP
+    # in case we remove some, update the pytest length check
+    _mapping = {
+        # Authentication/Authorization
+        ApiError.JWT_EXPIRED: status.HTTP_401_UNAUTHORIZED,
+        ApiError.INVALID_BEARER: status.HTTP_401_UNAUTHORIZED,
+        ApiError.INVALID_API_KEY: status.HTTP_401_UNAUTHORIZED,
+        ApiError.NO_CREDENTIALS: status.HTTP_401_UNAUTHORIZED,
+        ApiError.INSUFFICIENT_SCOPES: status.HTTP_403_FORBIDDEN,
+        ApiError.EXCHANGE_PERMISSION_DENIED: status.HTTP_403_FORBIDDEN,
+        ApiError.EXCHANGE_USER_FROZEN: status.HTTP_403_FORBIDDEN,
+        ApiError.TRADING_LOCKED: status.HTTP_403_FORBIDDEN,
+
+        # Not Found
+        ApiError.URL_NOT_FOUND: status.HTTP_404_NOT_FOUND,
+        ApiError.OBJECT_NOT_FOUND: status.HTTP_404_NOT_FOUND,
+        ApiError.ORDER_NOT_FOUND: status.HTTP_404_NOT_FOUND,
+        ApiError.POSITION_NOT_FOUND: status.HTTP_404_NOT_FOUND,
+        ApiError.SYMBOL_NOT_FOUND: status.HTTP_404_NOT_FOUND,
+
+        # Conflicts/Duplicates
+        ApiError.CLIENT_ORDER_ID_REPEATED: status.HTTP_409_CONFLICT,
+        ApiError.OBJECT_ALREADY_EXISTS: status.HTTP_409_CONFLICT,
+        ApiError.EXCHANGE_KEY_ALREADY_EXISTS: status.HTTP_409_CONFLICT,
+        ApiError.BOT_ALREADY_DELETED: status.HTTP_409_CONFLICT,
+
+        # Invalid Content
+        ApiError.CONTENT_TYPE_ERROR: status.HTTP_415_UNSUPPORTED_MEDIA_TYPE,
+
+        # Rate Limits
+        ApiError.EXCHANGE_RATE_LIMIT: status.HTTP_429_TOO_MANY_REQUESTS,
+        ApiError.REQUEST_SCOPE_EXCEEDED: status.HTTP_429_TOO_MANY_REQUESTS,
+
+        # Server Errors
+        ApiError.UNKNOWN_ERROR: status.HTTP_500_INTERNAL_SERVER_ERROR,
+        ApiError.EXCHANGE_SYSTEM_ERROR: status.HTTP_500_INTERNAL_SERVER_ERROR,
+        ApiError.NOW_API_DOWN: status.HTTP_500_INTERNAL_SERVER_ERROR,
+        ApiError.RPC_TIMEOUT: status.HTTP_500_INTERNAL_SERVER_ERROR,
+
+        # Service Unavailable
+        ApiError.EXCHANGE_SERVICE_UNAVAILABLE: status.HTTP_503_SERVICE_UNAVAILABLE,
+        ApiError.EXCHANGE_MAINTENANCE: status.HTTP_503_SERVICE_UNAVAILABLE,
+        ApiError.EXCHANGE_SYSTEM_BUSY: status.HTTP_503_SERVICE_UNAVAILABLE,
+        ApiError.SETTLEMENT_IN_PROGRESS: status.HTTP_503_SERVICE_UNAVAILABLE,
+        ApiError.POSITION_SUSPENDED: status.HTTP_503_SERVICE_UNAVAILABLE,
+        ApiError.TRADING_SUSPENDED: status.HTTP_503_SERVICE_UNAVAILABLE,
+
+        # Bad Requests (400) - Invalid parameters or states
+        ApiError.ALLOCATION_BELOW_EXPOSURE: status.HTTP_400_BAD_REQUEST,
+        ApiError.ALLOCATION_BELOW_MINIMUM: status.HTTP_400_BAD_REQUEST,
+        ApiError.BLACK_SWAN: status.HTTP_400_BAD_REQUEST,
+        ApiError.BOT_DISABLED: status.HTTP_400_BAD_REQUEST,
+        ApiError.DELETE_BOT_ERROR: status.HTTP_400_BAD_REQUEST,
+        ApiError.EXCHANGE_INVALID_SIGNATURE: status.HTTP_400_BAD_REQUEST,
+        ApiError.EXCHANGE_INVALID_TIMESTAMP: status.HTTP_400_BAD_REQUEST,
+        ApiError.EXCHANGE_IP_RESTRICTED: status.HTTP_400_BAD_REQUEST,
+        ApiError.EXCHANGE_KEY_IN_USE: status.HTTP_400_BAD_REQUEST,
+        ApiError.EXCHANGE_SYSTEM_CONFIG_ERROR: status.HTTP_400_BAD_REQUEST,
+        ApiError.HEDGE_MODE_NOT_ACTIVE: status.HTTP_400_BAD_REQUEST,
+        ApiError.HTTP_ERROR: status.HTTP_400_BAD_REQUEST,
+        ApiError.INSUFFICIENT_BALANCE: status.HTTP_400_BAD_REQUEST,
+        ApiError.INSUFFICIENT_MARGIN: status.HTTP_400_BAD_REQUEST,
+        ApiError.INVALID_EXCHANGE_KEY: status.HTTP_400_BAD_REQUEST,
+        ApiError.INVALID_MARGIN_MODE: status.HTTP_400_BAD_REQUEST,
+        ApiError.INVALID_PARAMETER: status.HTTP_400_BAD_REQUEST,
+        ApiError.LEVERAGE_EXCEEDED: status.HTTP_400_BAD_REQUEST,
+        ApiError.LIQUIDATION_PRICE_VIOLATION: status.HTTP_400_BAD_REQUEST,
+        ApiError.ORDER_ALREADY_FILLED: status.HTTP_400_BAD_REQUEST,
+        ApiError.ORDER_IN_PROCESS: status.HTTP_400_BAD_REQUEST,
+        ApiError.ORDER_LIMIT_EXCEEDED: status.HTTP_400_BAD_REQUEST,
+        ApiError.ORDER_PRICE_INVALID: status.HTTP_400_BAD_REQUEST,
+        ApiError.ORDER_SIZE_TOO_LARGE: status.HTTP_400_BAD_REQUEST,
+        ApiError.ORDER_SIZE_TOO_SMALL: status.HTTP_400_BAD_REQUEST,
+        ApiError.POSITION_LIMIT_EXCEEDED: status.HTTP_400_BAD_REQUEST,
+        ApiError.POST_ONLY_REJECTED: status.HTTP_400_BAD_REQUEST,
+        ApiError.RISK_LIMIT_EXCEEDED: status.HTTP_400_BAD_REQUEST,
+        ApiError.STRATEGY_DISABLED: status.HTTP_400_BAD_REQUEST,
+        ApiError.STRATEGY_LEVERAGE_MISMATCH: status.HTTP_400_BAD_REQUEST,
+        ApiError.STRATEGY_NOT_SUPPORTING_EXCHANGE: status.HTTP_400_BAD_REQUEST,
+        ApiError.TRADING_ACTION_EXPIRED: status.HTTP_400_BAD_REQUEST,
+        ApiError.TRADING_ACTION_SKIPPED: status.HTTP_400_BAD_REQUEST,
 
+        # Success cases
+        ApiError.SUCCESS: status.HTTP_200_OK,
+        ApiError.BOT_STOPPING_COMPLETED: status.HTTP_200_OK,
+    }
 
-assert len(list(ApiErrorIdentifier)) == len(
-    list(ApiError)
-), f"{len(list(ApiErrorIdentifier))} != {len(list(ApiError))}"
+    @classmethod
+    def get_status_code(cls, error: ApiError) -> int:
+        """Get the HTTP status code for the error. If the error is not in the mapping, return 500."""
+        return cls._mapping.get(error, status.HTTP_500_INTERNAL_SERVER_ERROR)

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/common/scopes.py

@@ -1,16 +1,19 @@
 from enum import StrEnum, EnumMeta
 import logging
 
-logger = logging.getLogger('uvicorn')
+logger = logging.getLogger("uvicorn")
+
 
 class Fallback(EnumMeta):
     """Fallback to no scope for unknown scopes."""
+
     def __getattr__(cls, name):
         logger.warning(
             f"Unknown scope '{name}' - falling back to no scope - update crypticorn package or check for typos"
         )
         return None
 
+
 class Scope(StrEnum, metaclass=Fallback):
     """
     The permission scopes for the API.
@@ -22,6 +25,9 @@ class Scope(StrEnum, metaclass=Fallback):
     def from_str(cls, value: str) -> "Scope":
         return cls(value)
 
+    # Scopes that can be purchased - these actually exist in the jwt token
+    READ_PREDICTIONS = "read:predictions"
+
     # Hive scopes
     READ_HIVE_MODEL = "read:hive:model"
     READ_HIVE_DATA = "read:hive:data"
@@ -50,5 +56,9 @@ class Scope(StrEnum, metaclass=Fallback):
     READ_PAY_NOW = "read:pay:now"
     WRITE_PAY_NOW = "write:pay:now"
 
-    # Scopes that can be purchased - these actually exist in the jwt token
-    READ_PREDICTIONS = "read:predictions"
+    # Metrics scopes
+    READ_METRICS_MARKETCAP = "read:metrics:marketcap"
+    READ_METRICS_INDICATORS = "read:metrics:indicators"
+    READ_METRICS_EXCHANGES = "read:metrics:exchanges"
+    READ_METRICS_TOKENS = "read:metrics:tokens"
+    READ_METRICS_MARKETS = "read:metrics:markets"

crypticorn-2.4.2/crypticorn/common/utils.py

@@ -0,0 +1,50 @@
+from typing import Any
+from decimal import Decimal
+import string
+import random
+
+from fastapi import HTTPException
+from fastapi import status
+
+from crypticorn.common import ApiError
+
+
+def throw_if_none(value: Any, message: ApiError) -> None:
+    """Throws an FastAPI HTTPException if the value is None."""
+    if value is None:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND, detail=message.identifier
+        )
+
+def throw_if_falsy(value: Any, message: ApiError) -> None:
+    """Throws an FastAPI HTTPException if the value is False."""
+    if not value:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST, detail=message.identifier
+        )
+    
+def gen_random_id(length: int = 20) -> str:
+    """Generate a random base62 string (a-zA-Z0-9) of specified length.
+    Kucoin max 40, bingx max 40"""
+    charset = string.ascii_letters + string.digits
+    return "".join(random.choice(charset) for _ in range(length))
+
+
+def is_equal(
+    a: float | Decimal,
+    b: float | Decimal,
+    rel_tol: float = 1e-9,
+    abs_tol: float = 0.0,
+) -> bool:
+    """
+    Compare two Decimal numbers for approximate equality.
+    """
+    if not isinstance(a, Decimal):
+        a = Decimal(str(a))
+    if not isinstance(b, Decimal):
+        b = Decimal(str(b))
+
+    # Convert tolerances to Decimal
+    return Decimal(abs(a - b)) <= max(
+        Decimal(str(rel_tol)) * max(abs(a), abs(b)), Decimal(str(abs_tol))
+    )

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn/trade/client/models/api_error_identifier.py

@@ -59,7 +59,7 @@ class ApiErrorIdentifier(str, Enum):
     INSUFFICIENT_SCOPES = "insufficient_scopes"
     INVALID_API_KEY = "invalid_api_key"
     INVALID_BEARER = "invalid_bearer"
-    INVALID_EXCHANGE_API_KEY = "invalid_exchange_api_key"
+    INVALID_EXCHANGE_KEY = "invalid_exchange_api_key"
     INVALID_MARGIN_MODE = "invalid_margin_mode"
     INVALID_PARAMETER_PROVIDED = "invalid_parameter_provided"
     JWT_EXPIRED = "jwt_expired"

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crypticorn
-Version: 2.4.0
+Version: 2.4.2
 Summary: Maximise Your Crypto Trading Profits with AI Predictions
 Author-email: Crypticorn <timon@crypticorn.com>
 Project-URL: Homepage, https://crypticorn.com
@@ -56,11 +56,6 @@ You can install the latest stable version from PyPi:
 pip install crypticorn
 ```
 
-If you want a specific version, run:
-```bash
-pip install crypticorn==2.0.0
-```
-
 If you want the latest version, which could be a pre release, run:
 ```bash
 pip install --pre crypticorn
@@ -72,6 +67,20 @@ Our API is available as an asynchronous Python SDK. The main entry point you nee
 ```python
 from crypticorn import ApiClient
 ```
+The ApiClient serves as the central interface for API operations. It instantiates multiple API wrappers corresponding to our microservices.
+
+Specific imports, such as request models, should be accessed through the appropriate submodules.
+
+Note: All symbols are re-exported at the first submodule layer for convenience.
+
+```python
+from crypticorn.trade import BotStatus
+```
+
+The `common` submodule contains shared classes not bound to a specific API.
+```python
+from crypticorn.common import Scope, Exchange
+```
 
 ## Usage
 
@@ -122,7 +131,7 @@ On top of that you get some information about the request:
 print(res.status_code)
 print(res.raw_data)
 print(res.headers)
-
+```
 
 ### JSON Response
 You can receive a classical JSON response by suffixing the function name with `_without_preload_content`

{crypticorn-2.4.0 → crypticorn-2.4.2}/crypticorn.egg-info/SOURCES.txt

@@ -75,6 +75,7 @@ crypticorn/common/pydantic.py
 crypticorn/common/scopes.py
 crypticorn/common/sorter.py
 crypticorn/common/urls.py
+crypticorn/common/utils.py
 crypticorn/hive/__init__.py
 crypticorn/hive/main.py
 crypticorn/hive/client/__init__.py